svedit 0.8.0 → 0.9.0

package/README.md

@@ -259,6 +259,16 @@ const doc = {
 
 Documents need a config object that tells Svedit how to render and manipulate your content. See the full example in [`src/routes/create_demo_session.js`](src/routes/create_demo_session.js).
 
+Two optional hooks are especially useful when integrating custom media workflows:
+
+- `handle_media_paste(session, pasted_media)`  
+  Called when media is pasted. You can upload/process files, replace an existing media property, or return a node payload to insert new content.  
+  See example implementation in [`src/routes/create_demo_session.js`](src/routes/create_demo_session.js).
+
+- `handle_property_deletion(session, path)`  
+  Called when deleting/cutting a property selection. Use it to define app-specific reset behavior (for example clearing an image property or resetting a referenced media node).  
+  See example implementation in [`src/routes/create_demo_session.js`](src/routes/create_demo_session.js).
+
 ```js
 const session_config = {
   // ID generator for creating new nodes
@@ -345,6 +355,20 @@ tr.insert_nodes(['new_node_id']);
 session.apply(tr);                      // Apply the transaction
 ```
 
+#### Batching history entries
+
+By default, every `session.apply(tr)` creates a new undo/redo entry. Pass `{ batch: true }` to merge the transaction into the previous history entry instead — useful for continuous interactions like dragging, where you want the entire gesture to undo as one step.
+
+```js
+session.apply(tr, { batch: true });
+```
+
+Batched transactions merge into the current history entry as long as they arrive within a 2-second window of the batch start. After 2 seconds of inactivity, the next `apply` starts a fresh entry. To force a new entry immediately (e.g. on pointer up), reset the batch timer:
+
+```js
+session.last_batch_started = undefined;
+```
+
 ### History
 
 ```js

package/dist/Svedit.svelte

@@ -145,14 +145,14 @@
 		if (
 			['deleteContentBackward', 'deleteWordBackward', 'deleteContent'].includes(event.inputType)
 		) {
-			session.apply(session.tr.delete_selection('backward'));
+			delete_at_selection('backward');
 			event.preventDefault();
 			event.stopPropagation();
 			return;
 		}
 
 		if (['deleteContentForward', 'deleteWordForward'].includes(event.inputType)) {
-			session.apply(session.tr.delete_selection('forward'));
+			delete_at_selection('forward');
 			event.preventDefault();
 			event.stopPropagation();
 			return;
@@ -494,7 +494,24 @@ ${fallback_html}`;
 		}
 
 		if (delete_selection) {
-			session.apply(session.tr.delete_selection());
+			delete_at_selection();
+		}
+	}
+
+	/**
+	 * Shared delete logic for cut, backspace, and forward-delete.
+	 * For property selections, delegates to the config's handle_property_deletion hook.
+	 * For text/node selections, uses the standard transaction delete_selection.
+	 *
+	 * @param {'backward' | 'forward'} [direction]
+	 */
+	function delete_at_selection(direction = 'backward') {
+		if (session.selection?.type === 'property') {
+			if (session.config.handle_property_deletion) {
+				session.config.handle_property_deletion(session, session.selection.path);
+			}
+		} else {
+			session.apply(session.tr.delete_selection(direction));
 		}
 	}
 
@@ -871,6 +888,11 @@ ${fallback_html}`;
 		// (e.g. selecting between nav and page body). The resulting path would be empty.
 		if (anchor_root_path.length <= 1) return null;
 
+		const parent_array_path = anchor_root_path.slice(0, -1);
+		// A node selection is only valid inside a node_array property.
+		const parent_property = session.inspect(parent_array_path);
+		if (!parent_property || parent_property.type !== 'node_array') return null;
+
 		let anchor_offset = parseInt(anchor_root_path.at(-1));
 		let focus_offset = parseInt(focus_root_path.at(-1));
 
@@ -910,7 +932,7 @@ ${fallback_html}`;
 
 		return {
 			type: 'node',
-			path: anchor_root_path.slice(0, -1),
+			path: parent_array_path,
 			anchor_offset: anchor_offset,
 			focus_offset: focus_offset
 		};

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

@@ -1 +1 @@
-{"version":3,"file":"Svedit.svelte.d.ts","sourceRoot":"","sources":["../src/lib/Svedit.svelte.js"],"names":[],"mappings":";;;;;;;AA60CA;;eAAqD;iCAhzC1C,cAAc"}
+{"version":3,"file":"Svedit.svelte.d.ts","sourceRoot":"","sources":["../src/lib/Svedit.svelte.js"],"names":[],"mappings":";;;;;;;AAm2CA;;eAAqD;iCAt0C1C,cAAc"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "svedit",
-	"version": "0.8.0",
+	"version": "0.9.0",
 	"license": "MIT",
 	"scripts": {
 		"dev": "vite dev",

package/src/lib/Svedit.svelte

@@ -145,14 +145,14 @@
 		if (
 			['deleteContentBackward', 'deleteWordBackward', 'deleteContent'].includes(event.inputType)
 		) {
-			session.apply(session.tr.delete_selection('backward'));
+			delete_at_selection('backward');
 			event.preventDefault();
 			event.stopPropagation();
 			return;
 		}
 
 		if (['deleteContentForward', 'deleteWordForward'].includes(event.inputType)) {
-			session.apply(session.tr.delete_selection('forward'));
+			delete_at_selection('forward');
 			event.preventDefault();
 			event.stopPropagation();
 			return;
@@ -494,7 +494,24 @@ ${fallback_html}`;
 		}
 
 		if (delete_selection) {
-			session.apply(session.tr.delete_selection());
+			delete_at_selection();
+		}
+	}
+
+	/**
+	 * Shared delete logic for cut, backspace, and forward-delete.
+	 * For property selections, delegates to the config's handle_property_deletion hook.
+	 * For text/node selections, uses the standard transaction delete_selection.
+	 *
+	 * @param {'backward' | 'forward'} [direction]
+	 */
+	function delete_at_selection(direction = 'backward') {
+		if (session.selection?.type === 'property') {
+			if (session.config.handle_property_deletion) {
+				session.config.handle_property_deletion(session, session.selection.path);
+			}
+		} else {
+			session.apply(session.tr.delete_selection(direction));
 		}
 	}
 
@@ -871,6 +888,11 @@ ${fallback_html}`;
 		// (e.g. selecting between nav and page body). The resulting path would be empty.
 		if (anchor_root_path.length <= 1) return null;
 
+		const parent_array_path = anchor_root_path.slice(0, -1);
+		// A node selection is only valid inside a node_array property.
+		const parent_property = session.inspect(parent_array_path);
+		if (!parent_property || parent_property.type !== 'node_array') return null;
+
 		let anchor_offset = parseInt(anchor_root_path.at(-1));
 		let focus_offset = parseInt(focus_root_path.at(-1));
 
@@ -910,7 +932,7 @@ ${fallback_html}`;
 
 		return {
 			type: 'node',
-			path: anchor_root_path.slice(0, -1),
+			path: parent_array_path,
 			anchor_offset: anchor_offset,
 			focus_offset: focus_offset
 		};