feat(VB-2055): add isVisualEditorEditing helper

[karancs06]

Summary

Adds isVisualEditorEditing(element), a small helper that tells a site whether a field is currently being edited in Visual Editor. Sites can use it to pause self-updating content (CSS animations, carousels, polled or streamed data) while an author edits, then resume afterwards. Without it, such content keeps mutating the DOM under the editor and the edit form resyncs to a moving target.

Changes

• src/visualBuilder/utils/editingState.ts — new isVisualEditorEditing(element?). Returns true while element (or a descendant) carries the existing data-cslp-field-type marker the SDK already sets on the focused field; false otherwise. Pass an element to scope the check, or omit it to check the whole document.
• src/index.ts — export the helper from the package entry.
• Unit tests for the helper (element scoping, document-wide, SSR).

Screen.Recording.2026-07-28.at.4.16.12.PM.mov

Notes:

• Side-effect-free: a plain check with no observer or subscription to manage. The consumer decides how to read it (interval, animation loop, framework effect, on demand).
• SSR-safe: returns false when there is no DOM.
• Purely additive and backward compatible: a new named export with no runtime side effects, so it tree-shakes out for consumers that do not use it. It relies only on the pre-existing attribute, so it also works for sites on older SDK versions.

Test plan

• New editingState unit tests pass (6): false when idle, true for a descendant edit, true when the element itself is the marker, scoped-to-element, document-wide, and SSR no-op.
• tsc --noEmit clean; lint clean.
• Verified in a sample app: a 3s slideshow and a continuously scrolling feed pause while their fields are edited in Visual Editor and resume on blur, with no effect outside Visual Editor.

---

🤖 Generated with Claude Code

[github-actions]

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type	Count (with fixes)	Without fixes	Threshold	Result
🔴 Critical Severity	0	0	10	✅ Passed
🟠 High Severity	0	0	25	✅ Passed
🟡 Medium Severity	0	0	500	✅ Passed
🔵 Low Severity	1	0	1000	✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity	Breaches (with fixes)	Breaches (no fixes)	SLA Threshold (with/no fixes)	Status
🔴 Critical	0	0	15 / 30 days	✅ Passed
🟠 High	0	0	30 / 120 days	✅ Passed
🟡 Medium	0	0	90 / 365 days	✅ Passed
🔵 Low	0	0	180 / 365 days	✅ Passed

✅ BUILD PASSED - All security checks passed

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🔵	Lines	67.36%	2524 / 3747
🔵	Statements	66.22%	2563 / 3870
🔵	Functions	64.56%	450 / 697
🔵	Branches	61.9%	1529 / 2470

File Coverage

File	Stmts	Branches	Functions	Lines	Uncovered Lines
Changed Files
src/index.ts	100%	100%	100%	100%
src/visualBuilder/utils/editingState.ts	100%	100%	100%	100%

Generated in workflow #873 for commit 23dcbe4 by the Vitest Coverage Report Action

[github-actions]

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type	Count (with fixes)	Without fixes	Threshold	Result
🔴 Critical Severity	0	0	10	✅ Passed
🟠 High Severity	0	0	25	✅ Passed
🟡 Medium Severity	0	0	500	✅ Passed
🔵 Low Severity	1	0	1000	✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity	Breaches (with fixes)	Breaches (no fixes)	SLA Threshold (with/no fixes)	Status
🔴 Critical	0	0	15 / 30 days	✅ Passed
🟠 High	0	0	30 / 120 days	✅ Passed
🟡 Medium	0	0	90 / 365 days	✅ Passed
🔵 Low	0	0	180 / 365 days	✅ Passed

✅ BUILD PASSED - All security checks passed

[hitesh-shetty-cstk]

LGTM!!