svedit 0.11.1 → 0.13.0

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

@@ -1 +1 @@
-{"version":3,"file":"NodeCaret.svelte.d.ts","sourceRoot":"","sources":["../src/lib/NodeCaret.svelte.js"],"names":[],"mappings":";;;;;;;;AA4BA;;;;mBAAqH;6CATxE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,OAAO,OAAO,QAAQ;IAC3L,cAAc,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,WAAW,OAAO,SAAS;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"NodeCaret.svelte.d.ts","sourceRoot":"","sources":["../src/lib/NodeCaret.svelte.ts"],"names":[],"mappings":"AAmBA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,SAAS;;kBAA+E,CAAC;AAC7E,KAAK,SAAS,GAAG,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC;AAClD,eAAe,SAAS,CAAC"}

package/dist/NodeGap.svelte

@@ -1,6 +1,6 @@
-<script module>
-	function cycle_z_index(/** @type {MouseEvent} */ e) {
-		const el = /** @type {HTMLElement} */ (e.currentTarget);
+<script module lang="ts">
+	function cycle_z_index(e: MouseEvent) {
+		const el = e.currentTarget as HTMLElement;
 		if (el.hasAttribute('data-sent-to-back')) {
 			document.querySelectorAll('.svedit-selectable[data-sent-to-back]').forEach((prev) => {
 				prev.removeAttribute('data-sent-to-back');
@@ -10,9 +10,11 @@
 	}
 </script>
 
-<script>
+<script lang="ts">
 	import { serialize_path } from './utils.js';
 	import { getContext } from 'svelte';
+	import { should_position_gap } from './node_visibility.svelte.js';
+	import type { DocumentPath, SveditRenderContext } from './types.js';
 
 	/**
 	 * ┌─────────────────────────────────────────────────────────────────┐
@@ -37,10 +39,13 @@
 	 *
 	 * Always present in the DOM when editable (stable structure for
 	 * selection anchoring, scrollTo, etc.). Anchor positioning is
-	 * activated lazily via the `.positioned` class, toggled imperatively
-	 * by the IO callback / MO / bootstrap in node_visibility — keeps
-	 * NodeGap allocation-free of per-instance Svelte signals, which
-	 * matters at 1000+ NodeGaps per scroll frame.
+	 * activated lazily via the `.positioned` class, derived reactively
+	 * from the visibility registry's array_indices / edge_map. Svelte's
+	 * reactive collections track reads at per-key granularity, so a
+	 * registry write only
+	 * re-evaluates the adjacent gaps. Applying the class declaratively
+	 * (instead of imperative classList toggles) means it survives DOM
+	 * recreation without a document change (e.g. dev-mode HMR).
 	 *
 	 * `position-visibility: anchors-visible` does NOT skip anchor
 	 * resolution — the browser resolves all anchor() then hides the
@@ -54,14 +59,35 @@
 	 * sure your custom component also handles read-only mode by rendering a
 	 * plain `.node-gap` placeholder without editable internals.
 	 */
-	const svedit = getContext('svedit');
-	let { array_path, offset, count, empty = false } = $props();
+	const svedit = getContext<SveditRenderContext>('svedit');
+	let {
+		array_path,
+		offset,
+		count,
+		empty = false
+	}: { array_path: DocumentPath; offset: number; count: number; empty?: boolean } = $props();
 	let is_editable = $derived(svedit.editable);
 
 	let is_first = $derived(offset === 0);
 	let is_last = $derived(offset === count);
 	let type = $derived(is_first ? 'gap-before' : 'gap-after');
 
+	let path_str = $derived(serialize_path(array_path));
+	// Two-derived split is load-bearing: get_array_indices lazily
+	// creates the set, and Svelte doesn't track deps on state created
+	// inside the reading derived — so acquire here, read in `positioned`.
+	let near_indices = $derived(svedit.visibility_registry.get_array_indices(path_str));
+	let positioned = $derived(
+		is_editable &&
+			should_position_gap(
+				near_indices,
+				svedit.visibility_registry.edge_map.get(path_str),
+				offset,
+				is_last,
+				empty
+			)
+	);
+
 	let gap_style = $derived.by(() => {
 		if (!is_editable) return '';
 		const prev_idx = offset - 1;
@@ -87,8 +113,9 @@
 		class:gap-after={!is_first}
 		class:empty
 		class:last={is_last}
+		class:positioned
 		data-type={type}
-		data-gap-array-path={serialize_path(array_path)}
+		data-gap-array-path={path_str}
 		data-gap-offset={offset}
 		style={gap_style}
 	>
@@ -111,9 +138,30 @@
 	}
 
 	/* ------------------------------------------------------------------ */
-	/* Un-positioned: minimal in-DOM presence, no anchor resolution        */
+	/* Un-positioned: no layout box at all                                 */
 	/* ------------------------------------------------------------------ */
 
+	/*
+	 * display: none is load-bearing for large documents. A zero-size
+	 * absolutely-positioned selectable still belongs to the containing
+	 * block's out-of-flow list, and the browser lays out EVERY such box
+	 * on EVERY layout pass — measured ~430ms per pass at 2000 nodes
+	 * (~3500 gaps) in Chrome vs ~23ms with the boxes removed. That cost
+	 * hits every keystroke (the per-change reconcile reads a rect for
+	 * every node, and selection rendering forces layout), every window
+	 * resize frame, and every scroll-triggered layout.
+	 *
+	 * Off-screen gaps therefore contribute no layout box. DOM structure
+	 * stays stable (the .node-gap wrapper and selectable elements remain),
+	 * and DOM Ranges may still point into display:none elements, so
+	 * programmatic node selections targeting off-screen gaps keep working.
+	 * Empty-array gaps are excluded: they must stay clickable/visible even
+	 * before reconcile positions them.
+	 */
+	:global(.node-gap:not(.positioned):not(.empty) .svedit-selectable) {
+		display: none;
+	}
+
 	:global(.node-gap:not(.positioned) .svedit-selectable) {
 		position: absolute;
 		pointer-events: none;

package/dist/NodeGap.svelte.d.ts

@@ -1,18 +1,11 @@
-export default NodeGap;
-type NodeGap = {
-    $on?(type: string, callback: (e: any) => void): () => void;
-    $set?(props: Partial<$$ComponentProps>): void;
-};
-declare const NodeGap: import("svelte").Component<{
-    array_path: any;
-    offset: any;
-    count: any;
-    empty?: boolean;
-}, {}, "">;
+import type { DocumentPath } from './types.js';
 type $$ComponentProps = {
-    array_path: any;
-    offset: any;
-    count: any;
+    array_path: DocumentPath;
+    offset: number;
+    count: number;
     empty?: boolean;
 };
+declare const NodeGap: import("svelte").Component<$$ComponentProps, {}, "">;
+type NodeGap = ReturnType<typeof NodeGap>;
+export default NodeGap;
 //# sourceMappingURL=NodeGap.svelte.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"NodeGap.svelte.d.ts","sourceRoot":"","sources":["../src/lib/NodeGap.svelte.js"],"names":[],"mappings":";;;;;AAwGA;gBA1CgC,GAAG;YAAU,GAAG;WAAS,GAAG;YAAU,OAAO;WA0CvB;wBA1CpC;IAAE,UAAU,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE"}
+{"version":3,"file":"NodeGap.svelte.d.ts","sourceRoot":"","sources":["../src/lib/NodeGap.svelte.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AAEnE,KAAK,gBAAgB,GAAI;IAAE,UAAU,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAkHvG,QAAA,MAAM,OAAO,sDAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/NodeGapMarkers.svelte

@@ -1,7 +1,8 @@
-<script>
+<script lang="ts">
 	import { getContext } from 'svelte';
 	import NodeCaret from './NodeCaret.svelte';
 	import { PATH_SEPARATOR, serialize_path } from './utils.js';
+	import type { DocumentPath, SveditRenderContext } from './types.js';
 
 	/**
 	 * ┌─────────────────────────────────────────────────────────────────┐
@@ -28,9 +29,9 @@
 	 * re-evaluates when THIS array's visible-index set changes.
 	 */
 
-	let { path, count } = $props();
+	let { path, count }: { path: DocumentPath; count: number } = $props();
 
-	const svedit = getContext('svedit');
+	const svedit = getContext<SveditRenderContext>('svedit');
 	let path_str = $derived(serialize_path(path));
 	let visible = $derived(svedit.visibility_registry.get_array_indices(path_str));
 
@@ -51,8 +52,16 @@
 			? `;--_f:${anchor_prefix}${PATH_SEPARATOR}0;--_s:${anchor_prefix}${PATH_SEPARATOR}1`
 			: '';
 
-		/** @type {Array<{key:string,offset:number,type:string,vars:string,is_first:boolean,is_last:boolean,has_pair:boolean}>} */
-		const result = [];
+		type GapMarker = {
+			key: string;
+			offset: number;
+			type: string;
+			vars: string;
+			is_first: boolean;
+			is_last: boolean;
+			has_pair: boolean;
+		};
+		const result: GapMarker[] = [];
 
 		if (count === 0) {
 			if (visible.has(0)) {
@@ -73,15 +82,15 @@
 		// 1000 nodes with ~30 visible, this drops 1001 SvelteSet/SvelteMap
 		// reads per re-derivation to ~30. Filter stale indices >= count
 		// that may briefly remain after a node delete (until MO fires).
-		const sorted = [];
+		const sorted: number[] = [];
 		for (const i of visible) {
 			if (i >= 0 && i < count) sorted.push(i);
 		}
 		sorted.sort((a, b) => a - b);
 		if (sorted.length === 0) return result;
 
-		const offsets = [];
-		function add_offset(offset) {
+		const offsets: number[] = [];
+		function add_offset(offset: number) {
 			if (!offsets.includes(offset)) offsets.push(offset);
 		}
 
@@ -112,7 +121,7 @@
 				? `${g_prefix}${PATH_SEPARATOR}0-gap-before`
 				: `${g_prefix}${PATH_SEPARATOR}${offset - 1}-gap-after`;
 
-			let type, vars;
+			let type: string, vars: string;
 			if (is_first || is_last) {
 				type = 'gap-edge';
 				const adjacent = is_first
@@ -646,4 +655,4 @@
 		outline: 1px solid blue;
 		outline-offset: 0.5px;
 	} */
-</style>
+</style>

package/dist/NodeGapMarkers.svelte.d.ts

@@ -1,14 +1,9 @@
-export default NodeGapMarkers;
-type NodeGapMarkers = {
-    $on?(type: string, callback: (e: any) => void): () => void;
-    $set?(props: Partial<$$ComponentProps>): void;
-};
-declare const NodeGapMarkers: import("svelte").Component<{
-    path: any;
-    count: any;
-}, {}, "">;
+import type { DocumentPath } from './types.js';
 type $$ComponentProps = {
-    path: any;
-    count: any;
+    path: DocumentPath;
+    count: number;
 };
+declare const NodeGapMarkers: import("svelte").Component<$$ComponentProps, {}, "">;
+type NodeGapMarkers = ReturnType<typeof NodeGapMarkers>;
+export default NodeGapMarkers;
 //# sourceMappingURL=NodeGapMarkers.svelte.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"NodeGapMarkers.svelte.d.ts","sourceRoot":"","sources":["../src/lib/NodeGapMarkers.svelte.js"],"names":[],"mappings":";;;;;AAgKA;UA3H0B,GAAG;WAAS,GAAG;WA2HoB;wBA3H3C;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE"}
+{"version":3,"file":"NodeGapMarkers.svelte.d.ts","sourceRoot":"","sources":["../src/lib/NodeGapMarkers.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AAEnE,KAAK,gBAAgB,GAAI;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAoKhE,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/NodeSelectionMarkers.svelte

@@ -1,12 +1,13 @@
-<script>
+<script lang="ts">
 	import { getContext } from 'svelte';
 	import { serialize_path } from './utils.js';
+	import type { DocumentPath, SveditContext } from './types.js';
 
-	const svedit = getContext('svedit');
+	const svedit = getContext<SveditContext>('svedit');
 	let selected_node_paths = $derived(get_selected_node_paths());
 
-	function get_selected_node_paths() {
-		const paths = [];
+	function get_selected_node_paths(): DocumentPath[] | undefined {
+		const paths: DocumentPath[] = [];
 		const selection = svedit.session.selection;
 		if (!selection) return;
 		if (selection.type !== 'node' || selection.anchor_offset === selection.focus_offset) return;
@@ -36,10 +37,23 @@
 <style>
 	.selected-node-overlay,
 	.selected-property-overlay {
+		/* Selection frame: a single 1px outline, offset -0.5px so the
+		   hairline centers on the node's edge and neighboring frames merge
+		   into one shared line. Alternatives tried and rejected:
+		   - Plain 1px border: adjacent selected nodes stack their borders
+		     into a 2px seam between them, which looks ugly.
+		   - Thick translucent frame (8px border) plus an inner hairline
+		     outline: multiple nested lines take more cognitive effort to
+		     parse than a single line.
+		   - Inset box-shadow rings (1px stroke + 8px translucent): same
+		     layered-frame look, same objection.
+		   Performance note: outlines don't participate in layout, so
+		   selection changes can't trigger reflows. */
 		position: absolute;
 		background: var(--svedit-editing-fill);
-		border: 1px solid var(--svedit-editing-stroke);
-		border-radius: 2px;
+		outline: 1px solid var(--svedit-editing-stroke);
+		outline-offset: -0.5px;
+		border-radius: 1px;
 		top: anchor(top);
 		left: anchor(left);
 		bottom: anchor(bottom);

package/dist/NodeSelectionMarkers.svelte.d.ts

@@ -1,7 +1,4 @@
-export default NodeSelectionMarkers;
-type NodeSelectionMarkers = {
-    $on?(type: string, callback: (e: any) => void): () => void;
-    $set?(props: Partial<Record<string, never>>): void;
-};
 declare const NodeSelectionMarkers: import("svelte").Component<Record<string, never>, {}, "">;
+type NodeSelectionMarkers = ReturnType<typeof NodeSelectionMarkers>;
+export default NodeSelectionMarkers;
 //# sourceMappingURL=NodeSelectionMarkers.svelte.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"NodeSelectionMarkers.svelte.d.ts","sourceRoot":"","sources":["../src/lib/NodeSelectionMarkers.svelte.js"],"names":[],"mappings":";;;;;AA0CA,8FAAmE"}
+{"version":3,"file":"NodeSelectionMarkers.svelte.d.ts","sourceRoot":"","sources":["../src/lib/NodeSelectionMarkers.svelte.ts"],"names":[],"mappings":"AA4CA,QAAA,MAAM,oBAAoB,2DAAwC,CAAC;AACnE,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,eAAe,oBAAoB,CAAC"}

package/dist/Session.svelte.d.ts

@@ -1,55 +1,58 @@
-/**
- * @typedef {Object} SessionOptions
- * @property {Selection} [selection] - Initial selection state
- */
-export default class Session {
-    /**
-     * @param {DocumentSchema} schema - The document schema
-     * @param {Document} doc - The document
-     * @param {object} config - configuration object
-     * @param {Object} [options]
-     * @param {Selection} [options.selection] - Initial selection state
-     */
-    constructor(schema: DocumentSchema, doc: Document, config: object, options?: {
-        selection?: Selection;
-    });
-    /** @type {DocumentSchema} */
-    schema: DocumentSchema;
-    /** @type {Document} */
+import Transaction from './Transaction.svelte.js';
+import type { SelectedAttachment } from './doc_utils.js';
+import type { NodeId, DocumentPath, Selection, Attachment, NodeKind, DocumentSchema, DocumentNode, Document, AnyNode, Text, CommandRegistry, Inspection, SessionConfig, SveditContext } from './types.js';
+import type { Keymap } from './KeyMapper.svelte.js';
+type HistoryEntry = {
+    ops: Transaction['ops'];
+    inverse_ops: Transaction['inverse_ops'];
+    selection_before: Selection | null;
+    selection_after: Selection | null;
+};
+export default class Session<S extends DocumentSchema = DocumentSchema> {
+    #private;
+    schema: S;
     doc: Document;
-    /** @type {any} */
-    config: any;
-    history: any[];
+    config: SessionConfig;
+    history: HistoryEntry[];
     history_index: number;
-    last_batch_started: any;
-    commands: {};
-    keymap: {};
+    last_batch_started: number | undefined;
+    commands: CommandRegistry;
+    keymap: Keymap;
     can_undo: boolean;
     can_redo: boolean;
-    selected_node: any;
-    available_annotation_types: any;
+    selected_node: AnyNode<S> | null;
+    available_mark_types: string[];
+    available_annotation_types: string[];
+    selected_marks: SelectedAttachment[];
+    active_mark: SelectedAttachment | null;
+    selected_annotations: SelectedAttachment[];
+    active_annotation: SelectedAttachment | null;
+    /**
+     * @param schema - The document schema
+     * @param doc - The document
+     * @param config - configuration object
+     * @param options - Optional settings (e.g. initial selection state)
+     */
+    constructor(schema: S, doc: Document, config: SessionConfig, options?: {
+        selection?: Selection | null;
+    });
+    /**
+     * Gets the current selection
+     */
+    get selection(): Selection | null;
     /**
      * Sets the selection with validation
-     * @param {Selection | null} value - The new selection
      * @throws {Error} Throws if the selection is invalid
      */
     set selection(value: Selection | null);
-    /**
-     * Gets the current selection
-     * @returns {Selection | null}
-     */
-    get selection(): Selection | null;
     /**
      * Validates that a selection is within bounds and refers to valid paths.
      *
-     * @param {Selection} selection - The selection to validate
      * @throws {Error} Throws if the selection is invalid
-     * @private
      */
     private _validate_selection;
     /**
      * Gets the document_id from the doc
-     * @returns {string}
      */
     get document_id(): string;
     /**
@@ -60,11 +63,10 @@ export default class Session {
      * deleted nodes. That catches local node invariants and dangling references left
      * behind by deletes without scanning every node on every apply.
      *
-     * @param {Transaction} transaction - The transaction result to validate
      * @throws {Error} Throws if the transaction result is invalid
      */
     validate_transaction_result(transaction: Transaction): void;
-    generate_id(): any;
+    generate_id(): string;
     /**
      * Initialize commands and keymap for this session.
      * Called by Svedit component when it has the necessary context.
@@ -73,34 +75,34 @@ export default class Session {
      * For multiple editors on the same document, this architecture would need
      * to be refactored to support multiple sessions per document.
      *
-     * @param {object} context - The svedit context with session, editable, canvas, etc.
+     * @param context - The svedit context with session, editable, canvas, etc.
      */
-    initialize_commands(context: object): void;
-    get_available_annotation_types(): any;
-    get_selected_node(): any;
+    initialize_commands(context: SveditContext<S>): void;
+    get_available_mark_types(): string[];
+    get_available_annotation_types(): string[];
+    get_selected_node(): AnyNode<S> | null;
     /**
      * Creates a new transaction for making atomic changes to the document.
-     *
-     * @returns {Transaction} A new transaction instance
      */
     get tr(): Transaction;
     /**
      * Applies a transaction to the document.
-     * Auto-batches history entries with debounced behavior (max one entry per 2 seconds) when batch is true.
+     * Auto-batches history entries with debounced behavior (max one entry per second) when batch is true.
      *
-     * @param {Transaction} transaction - The transaction to apply
-     * @param {object} [options] - Optional configuration
-     * @param {boolean} [options.batch=false] - Whether to allow batching with previous transaction
+     * @param transaction - The transaction to apply
+     * @param options - Optional configuration (batch: whether to allow batching with previous transaction)
      */
     apply(transaction: Transaction, { batch }?: {
         batch?: boolean;
     }): this;
-    undo(): this;
-    redo(): this;
+    undo(): this | undefined;
+    redo(): this | undefined;
     /**
      * Gets a node instance or property value at the specified path.
-     * @param {DocumentPath|string} path - Path to the node or property
-     * @returns {any} Either a node instance object or the value of a property
+     *
+     * The result type defaults to `any` because a path can address a node or
+     * any property value. Annotate the target to type the result.
+     *
      * @example
      * // Get a node by ID
      * session.get('list_1') // => { type: 'list', id: 'list_1', ... }
@@ -114,10 +116,10 @@ export default class Session {
      * session.get(['page_1', 'body', 3, 'list_items', 0]) // => { type: 'list_item', id: 'list_item_1', ... }
      *
      * @example
-     * // Get an annotated text property
-     * session.get(['page_1', 'cover', 'title']) // => {text: 'Hello world', annotations: []}
+     * // Get a text property
+     * session.get(['page_1', 'cover', 'title']) // => {content: 'Hello world', marks: [], annotations: []}
      */
-    get(path: DocumentPath | string): any;
+    get<T = any>(path: DocumentPath | string): T;
     /**
      * While .get gives you the value of a path, inspect gives you
      * the type info of that value.
@@ -140,50 +142,40 @@ export default class Session {
      *   type: 'paragraph',
      *   properties: {...}
      * }
-     *
-     * @param {DocumentPath} path
-     * @returns {{kind: 'property'|'node', [key: string]: any}}
      */
-    inspect(path: DocumentPath): {
-        kind: "property" | "node";
-        [key: string]: any;
-    };
+    inspect(path: DocumentPath): Inspection;
     /**
-     * Determines the kind of a node ('block' for structured blocks, 'text' for pure
-     * text nodes or 'annotation' for annotation nodes.
-     * @param {any} node
-     * @returns {NodeKind}
+     * Determines the kind of a node ('document' for root nodes, 'block' for
+     * structured blocks, 'text' for pure text nodes, 'mark' for mark nodes or
+     * 'annotation' for annotation nodes).
      */
-    kind(node: any): NodeKind;
+    kind(node: DocumentNode): NodeKind;
     /**
      * Determines whether a node type can be inserted at a given selection.
-     * @param {string} node_type - The type of node to insert.
-     * @param {Selection} [selection] - The selection at which to insert the node.
-     * @returns {boolean} True if the node type can be inserted, false otherwise.
-     */
-    can_insert(node_type: string, selection?: Selection): boolean;
-    /**
-     * Compute next possible insert position from a given selection
      *
-     * @param {Selection} [selection] - Reference selection
-     * @returns {Selection|null} The next node insert caret selection, or null if none is available
+     * @param node_type - The type of node to insert.
+     * @param selection - The selection at which to insert the node.
+     * @returns True if the node type can be inserted, false otherwise.
      */
-    get_next_node_insert_caret(selection?: Selection): Selection | null;
+    can_insert(node_type: string, selection?: Selection | null): boolean;
     /**
-     * Returns the annotation object that is currently "under the cursor".
-     * NOTE: Annotations in Svedit are exclusive, so there can only be one active_annotation
+     * Compute next possible insert position from a given selection
      *
-     * @param {string} [annotation_type] Optional annotation type to filter by
-     * @returns {Annotation|null}
-     */
-    active_annotation(annotation_type?: string): Annotation | null;
-    get_selected_annotated_text(): {
-        text: string;
-        annotations: any;
-        nodes: {};
-    };
-    get_selected_plain_text(): string;
-    get_selected_nodes(): any;
+     * @param selection - Reference selection
+     * @returns The next node insert caret selection, or null if none is available
+     */
+    get_next_node_insert_caret(selection?: Selection | null): Selection | null;
+    get_selected_text(): (Text & {
+        nodes: Record<string, DocumentNode>;
+    }) | null;
+    get_selected_annotated_nodes(): {
+        nodes: Record<string, DocumentNode>;
+        main_nodes: NodeId[];
+        marks: Attachment[];
+        annotations: Attachment[];
+    } | null;
+    get_selected_plain_text(): string | null;
+    get_selected_nodes(): NodeId[] | null;
     select_parent(): void;
     /**
      * Traverses the document and returns a list of nodes in depth-first order.
@@ -193,9 +185,7 @@ export default class Session {
      * 2. Branch nodes second
      * 3. Root node (entry point) last
      *
-     * @param {string} node_id - The ID of the node to start traversing from
-     * @returns {Array<DocumentNode>} Array of nodes in depth-first order
-     * @note Nodes that are not reachable from the entry point node will not be included
+     * Nodes that are not reachable from the entry point node will not be included.
      */
     traverse(node_id: string): Array<DocumentNode>;
     /**
@@ -203,32 +193,11 @@ export default class Session {
      *
      * We make a traversal to ensure that orphaned nodes are not included,
      * and that leaf nodes go first, followed by branches and the root node at last.
-     *
-     * @returns {Document} The document
      */
     to_json(): Document;
-    property_type(type: any, property: any): string;
-    count_references(node_id: any): number;
-    /**
-     * @param {NodeId} node_id
-     * @returns {NodeId[]}
-     */
+    property_type(type: string, property: string): string;
+    count_references(node_id: NodeId): number;
     get_referenced_nodes(node_id: NodeId): NodeId[];
-    #private;
 }
-export type SessionOptions = {
-    /**
-     * - Initial selection state
-     */
-    selection?: Selection;
-};
-import type { DocumentSchema } from './types.d.ts';
-import type { Document } from './types.d.ts';
-import type { Selection } from './types.d.ts';
-import Transaction from './Transaction.svelte.js';
-import type { DocumentPath } from './types.d.ts';
-import type { NodeKind } from './types.d.ts';
-import type { Annotation } from './types.d.ts';
-import type { DocumentNode } from './types.d.ts';
-import type { NodeId } from './types.d.ts';
+export {};
 //# sourceMappingURL=Session.svelte.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Session.svelte.d.ts","sourceRoot":"","sources":["../src/lib/Session.svelte.js"],"names":[],"mappings":"AAgCA;;;GAGG;AAEH;IA+BC;;;;;;OAMG;IACH,oBANW,cAAc,OACd,QAAQ,UACR,MAAM,YAEd;QAA4B,SAAS,GAA7B,SAAS;KACnB,EAYA;IA7CD,6BAA6B;IAC7B,QADW,cAAc,CACH;IAEtB,uBAAuB;IACvB,KADW,QAAQ,CACA;IAEnB,kBAAkB;IAClB,QADW,GAAG,CACQ;IAEtB,eAAyB;IACzB,sBAA+B;IAC/B,wBAA2C;IAI3C,aAA0B;IAC1B,WAAwB;IAGxB,kBAA6C;IAC7C,kBAAkE;IAGlE,mBAAmD;IACnD,gCAA6E;IA+B7E;;;;OAIG;IACH,qBAHW,SAAS,GAAG,IAAI,EAM1B;IAhBD;;;OAGG;IACH,iBAFa,SAAS,GAAG,IAAI,CAI5B;IAYD;;;;;;OAMG;IACH,4BAEC;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;;;;;;;;OAUG;IACH,yCAHW,WAAW,QA4BrB;IAED,mBAMC;IAED;;;;;;;;;OASG;IACH,6BAFW,MAAM,QAQhB;IAED,sCAKC;IAGD,yBAkBC;IAED;;;;OAIG;IACH,UAFa,WAAW,CAKvB;IAED;;;;;;;OAOG;IACH,mBAJW,WAAW,cAEnB;QAA0B,KAAK,GAAvB,OAAO;KACjB,QA6CA;IAED,aAgBC;IAED,aAaC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAlBW,YAAY,GAAC,MAAM,GACjB,GAAG,CAmBf;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,cAHW,YAAY,GACV;QAAC,IAAI,EAAE,UAAU,GAAC,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC,CAIzD;IAED;;;;;OAKG;IACH,WAHW,GAAG,GACD,QAAQ,CAIpB;IAED;;;;;OAKG;IACH,sBAJW,MAAM,cACN,SAAS,GACP,OAAO,CAcnB;IAED;;;;;OAKG;IACH,uCAHW,SAAS,GACP,SAAS,GAAC,IAAI,CAe1B;IAED;;;;;;OAMG;IACH,oCAHW,MAAM,GACJ,UAAU,GAAC,IAAI,CAI3B;IAED;;;;MA6BC;IAGD,kCAOC;IAED,0BAOC;IAED,sBAmCC;IAED;;;;;;;;;;;OAWG;IACH,kBAJW,MAAM,GACJ,KAAK,CAAC,YAAY,CAAC,CAK/B;IAED;;;;;;;OAOG;IACH,WAFa,QAAQ,CAWpB;IAID,gDAEC;IAGD,uCAEC;IAGD;;;OAGG;IACH,8BAHW,MAAM,GACJ,MAAM,EAAE,CAOpB;;CACD;;;;;gBA5hBa,SAAS;;oCAPb,cAAc;8BAAd,cAAc;+BAAd,cAAc;wBA3BA,yBAAyB;kCA2BvC,cAAc;8BAAd,cAAc;gCAAd,cAAc;kCAAd,cAAc;4BAAd,cAAc"}
+{"version":3,"file":"Session.svelte.d.ts","sourceRoot":"","sources":["../src/lib/Session.svelte.ts"],"names":[],"mappings":"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"}