tiptop-editor 1.3.0 → 1.5.0

package/dist/helpers.d.ts

@@ -1,6 +1,6 @@
 import { Editor } from '@tiptap/core';
 import { EditorState } from '@tiptap/pm/state';
-import { SlashCommandGroupCommandsProps } from './types';
+import { DocumentMap, SlashCommandGroupCommandsProps, TargetedUpdate } from './types';
 import { Node } from '@tiptap/pm/model';
 export declare const isTextSelected: (editor: Editor) => boolean;
 export declare const hasTextNodeInSelection: (editor: Editor) => boolean;
@@ -38,3 +38,31 @@ export declare const getUploaderAtPos: (state: Editor["state"], pos: number) =>
     depth: number;
     node: Node;
 } | undefined;
+/**
+ * Returns a structured snapshot of every top-level block in the editor.
+ * Send this to your AI model so it can reference nodes and words by index.
+ */
+export declare const getDocumentMap: (editor: Editor) => DocumentMap;
+/**
+ * Applies a single targeted content update.
+ *
+ * @example
+ * // Translate the first word of the second paragraph
+ * applyTargetedUpdate(editor, { nodeIndex: 1, wordIndex: 0, replacement: 'Bonjour' })
+ */
+export declare const applyTargetedUpdate: (editor: Editor, update: TargetedUpdate) => boolean;
+/**
+ * Applies multiple targeted updates in a single atomic ProseMirror transaction.
+ *
+ * All positions are resolved against the document state *before* any mutations,
+ * then applied from the bottom of the document upward so that earlier replacements
+ * never shift the absolute positions of later ones.
+ *
+ * @example
+ * // Bold-ify two specific words in one go
+ * applyTargetedUpdates(editor, [
+ *   { nodeIndex: 0, wordIndex: 2, replacement: [{ type: 'text', text: 'foo', marks: [{ type: 'bold' }] }] },
+ *   { nodeIndex: 2, wordRange: [0, 1], replacement: 'Hello world' },
+ * ])
+ */
+export declare const applyTargetedUpdates: (editor: Editor, updates: TargetedUpdate[]) => boolean;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { default as TiptopEditor } from './components/editor/TiptopEditor';
 export { TiptopEditorContext, useTiptopEditor } from './components/editor/TiptopEditorContext';
+export { getDocumentMap, applyTargetedUpdate, applyTargetedUpdates } from './helpers';
 export * from './types';