svedit 0.11.1 → 0.12.0

package/dist/Transaction.svelte.d.ts

@@ -40,6 +40,7 @@ export default class Transaction {
     modified_node_ids: NodeId[];
     /** @type {NodeId[]} */
     deleted_node_ids: NodeId[];
+    changed_node_types: boolean;
     /**
      * Gets a value from the document at the specified path.
      *
@@ -56,12 +57,12 @@ export default class Transaction {
      */
     property_type(type: string, property: string): string;
     /**
-     * Determines the kind of a node ('block', 'text', or 'annotation').
+     * Determines the kind of a node ('block', 'text', 'mark', or 'annotation').
      *
      * @param {any} node - The node to check
-     * @returns {'block'|'text'|'annotation'} The node kind
+     * @returns {'block'|'text'|'mark'|'annotation'} The node kind
      */
-    kind(node: any): "block" | "text" | "annotation";
+    kind(node: any): "block" | "text" | "mark" | "annotation";
     /**
      * Inspects a path to get metadata about the value at that location.
      *
@@ -92,6 +93,12 @@ export default class Transaction {
      * @returns {NodeId[]} Array of referenced node IDs
      */
     get_referenced_nodes(node_id: NodeId): NodeId[];
+    /**
+     * Gets the available mark types for the current selection.
+     *
+     * @returns {string[]} Array of available mark type names
+     */
+    get available_mark_types(): string[];
     /**
      * Gets the available annotation types for the current selection.
      *
@@ -99,13 +106,31 @@ export default class Transaction {
      */
     get available_annotation_types(): string[];
     /**
-     * Returns the annotation object that is currently "under the caret".
-     * NOTE: Annotations in Svedit are exclusive, so there can only be one active_annotation
+     * Returns marks touched by the current selection.
      *
-     * @param {string} [annotation_type] Optional annotation type to filter by
-     * @returns {Annotation|null}
+     * @returns {Array<Mark & { index: number, node: any }>}
      */
-    active_annotation(annotation_type?: string): Annotation | null;
+    get selected_marks(): Array<Mark & {
+        index: number;
+        node: any;
+    }>;
+    get active_mark(): Attachment & {
+        index: number;
+        node: any;
+    };
+    /**
+     * Returns annotations touched by the current selection.
+     *
+     * @returns {Array<Annotation & { index: number, node: any }>}
+     */
+    get selected_annotations(): Array<Annotation & {
+        index: number;
+        node: any;
+    }>;
+    get active_annotation(): Attachment & {
+        index: number;
+        node: any;
+    };
     /**
      * Applies an operation to the document (internal).
      *
@@ -132,7 +157,7 @@ export default class Transaction {
      * @example
      * ```js
      * tr.set(["list_1", "list_items"], [1, 2, 3]);
-     * tr.set(["page_1", "body", "0", "description"], {text: "Hello world", annotations: []});
+     * tr.set(["page_1", "body", "0", "description"], {content: "Hello world", marks: [], annotations: []});
      * ```
      */
     set(path: DocumentPath, value: any): Transaction;
@@ -164,7 +189,7 @@ export default class Transaction {
      *
      * NOTE: This is a force-delete and intentionally does NOT check whether
      * the node is still referenced from elsewhere — callers (e.g.
-     * `annotate_text`) sometimes need to remove a node while a stale
+     * `toggle_mark`) sometimes need to remove a node while a stale
      * reference to it still exists in the property they are about to update.
      * For ref-count-aware cleanup, see how `set` calls
      * `_cascade_delete_unreferenced_nodes`.
@@ -195,26 +220,45 @@ export default class Transaction {
      */
     private _validate_selection;
     /**
-     * Adds, updates, or removes text annotations in the current selection.
+     * Toggles a mark on the current text or node selection.
      *
-     * Handles various annotation scenarios including adding new annotations,
-     * updating existing ones (especially for links), and removing annotations
-     * when conflicting types are applied.
+     * Marks are mutually exclusive. Whole marks are toggled, removed, or
+     * switched; ranges are never truncated or expanded by this command.
      *
-     * @param {any} annotation_type - The type of annotation (e.g., 'link', 'bold', 'italic')
-     * @param {any} annotation_properties - Additional data for the annotation (e.g., href for links)
+     * @param {any} mark_type - The type of mark (e.g., 'link', 'strong', 'emphasis')
+     * @param {any} mark_properties - Additional data for the mark (e.g., href for links)
      * @returns {Transaction} This transaction instance for method chaining
      *
      * @example
      * ```js
-     * // Add a link annotation
-     * tr.annotate_text('link', { href: 'https://example.com' });
+     * // Add a link mark
+     * tr.toggle_mark('link', { href: 'https://example.com' });
      *
      * // Add emphasis
-     * tr.annotate_text('emphasis', {});
+     * tr.toggle_mark('emphasis', {});
+     * ```
+     */
+    toggle_mark(mark_type: any, mark_properties: any): Transaction;
+    /**
+     * Toggles an annotation on the current text or node selection.
+     *
+     * Annotations only compete with touched annotations of the same type:
+     * touched same-type annotations are removed, otherwise a new annotation is
+     * created. Marks and other annotation types never block a toggle, and
+     * same-type annotations may still overlap when created through lower-level
+     * APIs.
+     *
+     * @param {any} annotation_type - The type of annotation (e.g., 'comment', 'marker')
+     * @param {any} annotation_properties - Additional data for the annotation
+     * @returns {Transaction} This transaction instance for method chaining
+     *
+     * @example
+     * ```js
+     * // Add a comment annotation
+     * tr.toggle_annotation('comment', { text: 'Please review' });
      * ```
      */
-    annotate_text(annotation_type: any, annotation_properties: any): Transaction;
+    toggle_annotation(annotation_type: any, annotation_properties: any): Transaction;
     /**
      * Deletes the currently selected text, node, or property.
      *
@@ -235,23 +279,27 @@ export default class Transaction {
      * before inserting the new ones.
      *
      * @param {NodeId[]} node_ids - Array of node IDs to insert
+     * @param {Array<Mark>} [marks] - Selection-relative marks to restore
+     * @param {Array<Annotation>} [annotations] - Selection-relative annotations to restore
+     * @param {Record<NodeId, any>} [nodes] - Node graph for restored marks and annotations
      * @returns {Transaction} This transaction instance for method chaining
      */
-    insert_nodes(node_ids: NodeId[]): Transaction;
+    insert_nodes(node_ids: NodeId[], marks?: Array<Mark>, annotations?: Array<Annotation>, nodes?: Record<NodeId, any>): Transaction;
     /**
      * Inserts text at the current text selection position.
      *
-     * Handles annotation adjustments when text is inserted, including:
-     * - Expanding annotations that contain the insertion point
-     * - Shifting annotations that come after the insertion point
-     * - Optionally applying new annotations to the inserted text
+     * Handles mark and annotation adjustments when text is inserted, including:
+     * - Expanding ranges that contain the insertion point
+     * - Shifting ranges that come after the insertion point
+     * - Optionally applying new marks and annotations to the inserted text
      *
      * @param {string} replaced_text - The text to insert
-     * @param {Array} [annotations] - Optional annotations to apply to the inserted text
-     * @param {object} [nodes] - Optional node definitions for annotation nodes
+     * @param {Array<Mark>} [marks] - Optional marks to apply to the inserted text
+     * @param {Array<Annotation>} [annotations] - Optional annotations to apply to the inserted text
+     * @param {object} [nodes] - Optional node definitions for mark and annotation nodes
      * @returns {Transaction} This transaction instance for method chaining
      */
-    insert_text(replaced_text: string, annotations?: any[], nodes?: object): Transaction;
+    insert_text(replaced_text: string, marks?: Array<Mark>, annotations?: Array<Annotation>, nodes?: object): Transaction;
     /**
      * Recursively deletes nodes that are no longer referenced in the document.
      *
@@ -263,23 +311,13 @@ export default class Transaction {
      * @private
      */
     private _cascade_delete_unreferenced_nodes;
-    /**
-     * Counts references to a node, excluding nodes that have been marked for deletion.
-     *
-     * This is used during cascade deletion to accurately count remaining references
-     * as nodes are being deleted.
-     *
-     * @param {NodeId} target_node_id - The node ID to count references for
-     * @param {Record<NodeId, boolean>} nodes_to_delete - Nodes already marked for deletion
-     * @returns {number} The number of references to the target node
-     * @private
-     */
-    private _count_references_excluding_deleted;
 }
 import type { DocumentSchema } from './types.d.js';
 import type { Selection } from './types.d.js';
 import type { NodeId } from './types.d.js';
 import type { DocumentPath } from './types.d.js';
+import type { Mark } from './types.d.js';
+import type { Attachment } from './types.d.js';
 import type { Annotation } from './types.d.js';
 import type { Document } from './types.d.js';
 //# sourceMappingURL=Transaction.svelte.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Transaction.svelte.d.ts","sourceRoot":"","sources":["../src/lib/Transaction.svelte.js"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;;;GAcG;AACH;IACC;;;;;;;OAOG;IACH,oBALW,cAAc,OACd,QAAQ,aACR,SAAS,GAAG,IAAI,UAChB,MAAM,EAuBhB;IApBA,uBAAoB;IACpB,qBAAqB;IACrB,KADW,MAAM,CACH;IACd,wBAAwB;IACxB,WADW,SAAS,CACM;IAC1B,YAAoB;IAEpB,oCAAoC;IACpC,KADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CACnB;IACb,oCAAoC;IACpC,aADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CACX;IAErB,4BAAiC;IAEjC,uBAAuB;IACvB,kBADW,MAAM,EAAE,CACO;IAC1B,uBAAuB;IACvB,mBADW,MAAM,EAAE,CACQ;IAC3B,uBAAuB;IACvB,kBADW,MAAM,EAAE,CACO;IAG3B;;;;;OAKG;IACH,UAHW,YAAY,GAAC,MAAM,GACjB,GAAG,CAIf;IAED;;;;;;OAMG;IACH,oBAJW,MAAM,YACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;OAKG;IACH,WAHW,GAAG,GACD,OAAO,GAAC,MAAM,GAAC,YAAY,CAIvC;IAED;;;;;OAKG;IACH,cAHW,YAAY,GACV;QAAC,IAAI,EAAE,UAAU,GAAC,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC,CAIzD;IAED;;;;OAIG;IACH,eAFa,MAAM,CAIlB;IAED;;;;;OAKG;IACH,oBAHW,GAAG,QAKb;IAGD;;;;;OAKG;IACH,8BAHW,MAAM,GACJ,MAAM,EAAE,CAKpB;IAED;;;;OAIG;IACH,kCAFa,MAAM,EAAE,CAOpB;IAED;;;;;;OAMG;IACH,oCAHW,MAAM,GACJ,UAAU,GAAC,IAAI,CAI3B;IAED;;;;;OAKG;IACH,kBAEC;IAED;;;;OAIG;IACH,uBAEC;IAED;;;;;;;;;;;;;;;OAeG;IACH,UAVW,YAAY,SACZ,GAAG,GACD,WAAW,CA8DvB;IAKD,qCAkCC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAbW,GAAG,GACD,WAAW,CA4BvB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WARW,GAAG,GACD,WAAW,CAuBvB;IAED;;;;;;OAMG;IACH,yBAJW,SAAS,GACP,WAAW,CAOvB;IAED;;;;;;OAMG;IACH,4BAEC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,+BAbW,GAAG,yBACH,GAAG,GACD,WAAW,CA+EvB;IAED;;;;;;;;;;;OAWG;IACH,6BAHW,UAAU,GAAG,SAAS,GACpB,WAAW,CA8IvB;IAED;;;;;;;;OAQG;IACH,uBAHW,MAAM,EAAE,GACN,WAAW,CA2BvB;IAED;;;;;;;;;;;;OAYG;IACH,2BALW,MAAM,+BAEN,MAAM,GACJ,WAAW,CA2FvB;IAED;;;;;;;;;OASG;IACH,2CAiCC;IAED;;;;;;;;;;OAUG;IACH,4CAOC;CACD;oCA50ByF,cAAc;+BAAd,cAAc;4BAAd,cAAc;kCAAd,cAAc;gCAAd,cAAc;8BAAd,cAAc"}
+{"version":3,"file":"Transaction.svelte.d.ts","sourceRoot":"","sources":["../src/lib/Transaction.svelte.js"],"names":[],"mappings":"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"}