svedit 0.6.3 → 0.7.0

package/src/lib/doc_utils.js

@@ -7,7 +7,7 @@
  * @import { NodeId, DocumentPath, PrimitiveType, NodeProperty, NodeArrayProperty, NodeSchema, DocumentSchema, Selection, Annotation, Document } from './types'
  */
 
-import { get_selection_range } from './utils.js';
+import { get_selection_range, get_char_length } from './utils.js';
 
 /**
  * Identity function — keeps schema at runtime & makes IDE infer types.
@@ -119,7 +119,7 @@ function validate_primitive_value(type, value) {
 }
 
 /**
- * @param {String} id
+ * @param {string} id
  * @returns {boolean}
  */
 function is_id_valid(id) {
@@ -480,3 +480,62 @@ export function count_references_excluding_deleted(schema, doc, target_node_id,
 
 	return count;
 }
+
+/**
+ * Validates a selection against the current document state.
+ * Works with any object that implements get() and inspect() (Session or Transaction).
+ *
+ * @param {Selection} selection - The selection to validate
+ * @param {{ get: Function, inspect: Function }} session_or_transaction - A Session or Transaction instance
+ * @throws {Error} Throws if the selection is invalid
+ */
+export function validate_selection(selection, session_or_transaction) {
+	if (!selection) return;
+
+	const selection_type = selection.type;
+	if (!['node', 'text', 'property'].includes(selection_type)) {
+		throw new Error(`Invalid selection type: ${selection_type}`);
+	}
+
+	if (selection_type === 'node') {
+		const node_array = session_or_transaction.get(selection.path);
+
+		if (!Array.isArray(node_array)) {
+			throw new Error('Node selection path must point to a node_array');
+		}
+
+		const max_offset = node_array.length;
+		if (selection.anchor_offset < 0 || selection.anchor_offset > max_offset) {
+			throw new Error(
+				`Node selection anchor_offset (${selection.anchor_offset}) is out of bounds. Max is ${max_offset}.`
+			);
+		}
+		if (selection.focus_offset < 0 || selection.focus_offset > max_offset) {
+			throw new Error(
+				`Node selection focus_offset (${selection.focus_offset}) is out of bounds. Max is ${max_offset}.`
+			);
+		}
+	} else if (selection_type === 'text') {
+		const annotated_text = session_or_transaction.get(selection.path);
+
+		if (!annotated_text || typeof annotated_text.text !== 'string') {
+			throw new Error('Text selection path must point to annotated_text');
+		}
+
+		const char_length = get_char_length(annotated_text.text);
+		if (selection.anchor_offset < 0 || selection.anchor_offset > char_length) {
+			throw new Error(
+				`Text selection anchor_offset (${selection.anchor_offset}) is out of bounds. Max is ${char_length}.`
+			);
+		}
+		if (selection.focus_offset < 0 || selection.focus_offset > char_length) {
+			throw new Error(
+				`Text selection focus_offset (${selection.focus_offset}) is out of bounds. Max is ${char_length}.`
+			);
+		}
+	} else if (selection_type === 'property') {
+		if (!session_or_transaction.inspect(selection.path)) {
+			throw new Error(`Property selection path not found: ${selection.path.join('.')}`);
+		}
+	}
+}

package/src/lib/index.js

@@ -4,6 +4,10 @@ export { default as AnnotatedTextProperty } from './AnnotatedTextProperty.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';
 
 // Core classes and utilities
 export { default as Session } from './Session.svelte.js';