superdoc-macros 0.5.0 → 0.7.0

package/dist/types.d.ts

@@ -38,6 +38,15 @@ export type TextInputEvent = {
     kind: 'delete-backward';
 } | {
     kind: 'delete-forward';
+}
+/**
+ * The caret moved by pointer or navigation keys. Not an edit — the
+ * recorder records no step — but both consumers depend on it: auto-text
+ * resets its typed-word buffer (the buffer no longer describes what sits
+ * before the caret), and the recorder stops coalescing across it.
+ */
+ | {
+    kind: 'caret-moved';
 };
 /**
  * What the toolkit needs from the editor. The SuperDoc v2 implementation is
@@ -62,6 +71,20 @@ export interface MacroHost {
     getSelection(options?: {
         includeText?: boolean;
     }): Promise<SelectionSnapshot>;
+    /**
+     * The `count` characters immediately before the caret, or `null` when the
+     * host cannot tell. Auto-text verifies the document actually holds the
+     * trigger word before deleting it — the buffer alone can lie after a
+     * caret move the host failed to report.
+     */
+    getTextBefore?(count: number): Promise<string | null>;
+    /**
+     * Atomically replaces the `expected.length` characters before the caret
+     * with `replacement` — verifying they equal `expected` first, all inside
+     * one engine transaction. Auto-text prefers this over delete+insert: two
+     * operations leave the trigger deleted when the second fails.
+     */
+    replaceTextBefore?(expected: string, replacement: string): Promise<MacroOutcome>;
     /** Replaces every occurrence of `query` with `replacement`. Returns how many were replaced. */
     replaceAll(query: string, replacement: string): Promise<{
         ok: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superdoc-macros",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Macro toolkit for SuperDoc-based editors: sandboxed scripted macros, a Word-style macro recorder, and snippets with auto-text expansion.",
   "license": "MIT",
   "type": "module",