svedit 0.12.0 → 0.14.0

package/dist/index.d.ts

@@ -1,18 +1,21 @@
-export { default as Svedit } from "./Svedit.svelte";
-export { default as TextProperty } from "./TextProperty.svelte";
-export { default as CustomProperty } from "./CustomProperty.svelte";
-export { default as Node } from "./Node.svelte";
-export { default as NodeArrayProperty } from "./NodeArrayProperty.svelte";
-export { default as NodeGap } from "./NodeGap.svelte";
-export { default as NodeGapMarkers } from "./NodeGapMarkers.svelte";
-export { default as NodeCaret } from "./NodeCaret.svelte";
-export { default as NodeSelectionMarkers } from "./NodeSelectionMarkers.svelte";
-export { default as Session } from "./Session.svelte.js";
-export { default as Transaction } from "./Transaction.svelte.js";
-export { default as Command } from "./Command.svelte.js";
-export * from "./Command.svelte.js";
-export * from "./transforms.svelte.js";
-export * from "./utils.js";
-export { define_document_schema, is_primitive_type, get_default_node_type, get_property_default, fill_node_defaults, fill_document_defaults, validate_document_schema, validate_document, validate_node, get_referencing_node_ids } from "./doc_utils.js";
-export { KeyMapper, define_keymap } from "./KeyMapper.svelte.js";
+export { default as Svedit } from './Svedit.svelte';
+export { default as TextProperty } from './TextProperty.svelte';
+export { default as CustomProperty } from './CustomProperty.svelte';
+export { default as Node } from './Node.svelte';
+export { default as NodeArrayProperty } from './NodeArrayProperty.svelte';
+export { default as NodeGap } from './NodeGap.svelte';
+export { default as NodeGapMarkers } from './NodeGapMarkers.svelte';
+export { default as NodeCaret } from './NodeCaret.svelte';
+export { default as NodeSelectionMarkers } from './NodeSelectionMarkers.svelte';
+export { default as Session } from './Session.svelte.js';
+export { default as Transaction } from './Transaction.svelte.js';
+export type { DocumentSchema, NodeSchema, NodeKind, PropertyDefinition, PropertyType, PropertyValue, NodeOfType, AnyNode, NodeMap, DynamicRecord, SessionConfig, CommandRegistry, DocumentOperation, Inspection, Document, DocumentNode, DocumentPath, NodeId, Text, NodeArray, Attachment, Mark, Annotation, Selection, TextSelection, NodeSelection, PropertySelection, SelectionRange, SveditProps, SveditContext, TextPropertyProps, CustomPropertyProps, NodeArrayPropertyProps, NodeGapToolsProps, NodeProps, NodeArrayAttachmentContext } from './types.js';
+export type { SelectedAttachment } from './doc_utils.js';
+export type { Keymap } from './KeyMapper.svelte.js';
+export { define_document_schema, is_primitive_type, get_default_node_type, get_property_default, fill_node_defaults, fill_document_defaults, validate_document_schema, validate_document, validate_node, get_referencing_node_ids } from './doc_utils.js';
+export { default as Command } from './Command.svelte.js';
+export * from './Command.svelte.js';
+export { KeyMapper, define_keymap } from './KeyMapper.svelte.js';
+export * from './transforms.svelte.js';
+export * from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.js"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGhF,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGjE,YAAY,EAEX,cAAc,EACd,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,YAAY,EAEZ,aAAa,EACb,UAAU,EACV,OAAO,EACP,OAAO,EACP,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,UAAU,EAEV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,MAAM,EAEN,IAAI,EACJ,SAAS,EACT,UAAU,EACV,IAAI,EACJ,UAAU,EAEV,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EAEd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,SAAS,EACT,0BAA0B,EAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EACN,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzD,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGjE,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -8,32 +8,16 @@ export { default as NodeGap } from './NodeGap.svelte';
 export { default as NodeGapMarkers } from './NodeGapMarkers.svelte';
 export { default as NodeCaret } from './NodeCaret.svelte';
 export { default as NodeSelectionMarkers } from './NodeSelectionMarkers.svelte';
-
 // Core classes and utilities
 export { default as Session } from './Session.svelte.js';
 export { default as Transaction } from './Transaction.svelte.js';
-
 // Document utilities
-export {
-	define_document_schema,
-	is_primitive_type,
-	get_default_node_type,
-	get_property_default,
-	fill_node_defaults,
-	fill_document_defaults,
-	validate_document_schema,
-	validate_document,
-	validate_node,
-	get_referencing_node_ids
-} from './doc_utils.js';
-
+export { define_document_schema, is_primitive_type, get_default_node_type, get_property_default, fill_node_defaults, fill_document_defaults, validate_document_schema, validate_document, validate_node, get_referencing_node_ids } from './doc_utils.js';
 // Command system
 export { default as Command } from './Command.svelte.js';
 export * from './Command.svelte.js';
-
 // Keyboard handling
 export { KeyMapper, define_keymap } from './KeyMapper.svelte.js';
-
 // Transforms and utilities
 export * from './transforms.svelte.js';
 export * from './utils.js';

package/dist/node_visibility.svelte.d.ts

@@ -1,3 +1,90 @@
+/**
+ * Dual-observer viewport visibility tracking for node arrays.
+ *
+ * ## Why this exists
+ *
+ * CSS anchor positioning is O(N) — the browser must resolve anchor()
+ * functions for every positioned element on every layout pass. Gap
+ * markers (NodeGapMarkers) also grow at O(N). At ~200+ nodes this
+ * causes frame drops during scroll/resize; at 500+ it's unusable.
+ *
+ * ## Design principle: structurally stable DOM
+ *
+ * NodeGap elements are always present in the DOM when editable. The
+ * `.positioned` class (which activates anchor() resolution) is gated
+ * by viewport visibility. Off-screen NodeGaps remain as zero-size
+ * absolute elements with no anchor cost.
+ *
+ * ## Element registration via attachments
+ *
+ * Node elements (Node.svelte and the empty-array placeholder) register
+ * themselves with `{@attach registry.track_node(path)}`; node-array
+ * containers use `{@attach registry.track_array(path)}`. Attachments
+ * re-run whenever Svelte recreates the element or its path changes, so
+ * observation and per-path state follow the DOM's actual lifecycle —
+ * including DOM recreation without a document change (e.g. dev-mode
+ * HMR component swaps), which a document-driven reconciliation pass
+ * would miss.
+ *
+ * During keyed updates several elements can change paths at once
+ * (e.g. 0→1 while a new element claims 0), and Svelte doesn't
+ * guarantee attachment ordering across elements. Per-path ownership
+ * maps make unregistration collision-safe: a teardown only clears a
+ * path's state if that element still owns the path.
+ *
+ * ## Two observers
+ *
+ * **Overscan IO** (`rootMargin: 500px`, threshold `0`) — fills the
+ * per-array `array_indices` sets. NodeGap derives its `.positioned`
+ * class reactively from them. Registration seeds
+ * the state synchronously from one getBoundingClientRect (so there's
+ * no unpositioned flash on mount); the IO owns subsequent viewport
+ * transitions, including layout-shift-induced ones.
+ *
+ * **Viewport IO** (`rootMargin: 0`, threshold `[0, 1]`) — toggles
+ * view classes (`.in-view`, `.fully-in-view`, …) on node elements.
+ * OPT-IN via `session.config.view_classes`. A separate observer is
+ * required because the overscan IO fires its thresholds while nodes
+ * are still 500px outside the real viewport.
+ *
+ * **Document scroll listener** (capture, passive) — fills `edge_map`,
+ * a per-array `{first, last}` flag indicating whether the leading/
+ * trailing node has reached the matching container edge within
+ * EDGE_TOLERANCE_PX. IntersectionObserver doesn't re-fire on scrolls
+ * inside non-root scroll containers (the intersection ratio doesn't
+ * cross any threshold), so this is the only reliable way to track
+ * horizontal-overflow scroll position. The handler is hot but cheap:
+ * a single `.closest()` early-out (page scroll → null → returns
+ * immediately) and a RAF flush that reads only scrollLeft / scrollWidth /
+ * clientWidth on the dirty array.
+ *
+ * **Document changes** — content changes alter an array's scroll
+ * extent without recreating the array element, so after Svelte
+ * updates the DOM all registered arrays re-sync their edge state in
+ * one batch.
+ *
+ * **Array ResizeObserver** — box-size changes (window resize, sidebar
+ * toggle, responsive breakpoint) can flip an array between fitting
+ * and overflowing without a scroll event or document change; a shared
+ * ResizeObserver on registered arrays re-syncs their edge state.
+ *
+ * ## Reactivity
+ *
+ * State lives in per-array SvelteSets (array_indices, the single
+ * source of truth for node nearness) and a SvelteMap (edge_map).
+ * Consumers (NodeGap and NodeGapMarkers, both via
+ * $derived) read via .has()/.get() — Svelte's runtime tracks at
+ * per-key granularity, so only consumers whose specific dependencies
+ * changed re-evaluate. Because the `.positioned` class is applied
+ * declaratively by NodeGap, it survives DOM recreation that happens
+ * without a document change (e.g. dev-mode HMR component swaps).
+ *
+ * View classes are toggled imperatively (no Svelte consumers — they're
+ * pure CSS hooks for app code).
+ *
+ * @module
+ */
+import { SvelteMap, SvelteSet } from 'svelte/reactivity';
 /**
  * Install the visibility registry on the svedit context.
  *
@@ -6,9 +93,28 @@
  * The IntersectionObservers own viewport changes; document changes
  * only trigger an edge-state re-sync over the registered arrays.
  *
- * @param {object} svedit - Svedit context (session, editable)
+ * @param svedit - Svedit context (session, editable)
  */
-export function create_node_visibility(svedit: object): void;
+export declare function create_node_visibility(svedit: {
+    session: {
+        config?: {
+            view_classes?: boolean;
+            visibility_culling?: boolean;
+        };
+        doc: unknown;
+    };
+    editable: boolean;
+    visibility_registry?: VisibilityRegistryApi;
+}): void;
+export type VisibilityRegistryApi = {
+    edge_map: SvelteMap<string, {
+        first: boolean;
+        last: boolean;
+    }>;
+    get_array_indices(array_path_str: string): SvelteSet<number>;
+    track_node(path: string): (el: HTMLElement) => () => void;
+    track_array(path: string): (el: Element) => () => void;
+};
 /**
  * Pure visibility check for a gap's `.positioned` class. NodeGap calls
  * this from a $derived, so the `near.has()` reads are tracked at
@@ -21,15 +127,10 @@ export function create_node_visibility(svedit: object): void;
  * $derived (see the note there): membership reads on a set created
  * within the same derived are not tracked by Svelte.
  *
- * @param {SvelteSet<number>} near - near child indices of the array
- * @param {{ first: boolean, last: boolean } | undefined} edge_state
- * @param {number} offset
- * @param {boolean} is_last
- * @param {boolean} empty
+ * @param near - near child indices of the array
  */
-export function should_position_gap(near: SvelteSet<number>, edge_state: {
+export declare function should_position_gap(near: SvelteSet<number>, edge_state: {
     first: boolean;
     last: boolean;
 } | undefined, offset: number, is_last: boolean, empty: boolean): boolean;
-import { SvelteSet } from 'svelte/reactivity';
 //# sourceMappingURL=node_visibility.svelte.d.ts.map

package/dist/node_visibility.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node_visibility.svelte.d.ts","sourceRoot":"","sources":["../src/lib/node_visibility.svelte.js"],"names":[],"mappings":"AA8iBA;;;;;;;;;GASG;AACH,+CAFW,MAAM,QAsEhB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,0CANW,SAAS,CAAC,MAAM,CAAC,cACjB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,UAC7C,MAAM,WACN,OAAO,SACP,OAAO,WA2BjB;0BAllBoC,mBAAmB"}
+{"version":3,"file":"node_visibility.svelte.d.ts","sourceRoot":"","sources":["../src/lib/node_visibility.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAibzD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE;QACR,MAAM,CAAC,EAAE;YAAE,YAAY,CAAC,EAAE,OAAO,CAAC;YAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAClE,GAAG,EAAE,OAAO,CAAC;KACb,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,CAAC,EAAE,qBAAqB,CAAC;CAC5C,GAAG,IAAI,CAkEP;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/D,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,WAAW,KAAK,MAAM,IAAI,CAAC;IAC1D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EACvB,UAAU,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EACzD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,GACZ,OAAO,CAyBT"}