@pilotiq/tiptap 3.20.0 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @pilotiq/tiptap
 
+## 4.0.0
+
+### Major Changes
+
+- 58794c1: Rename the AI suggestion/diff primitives to provider-neutral names. These are generic inline-diff machinery the package exposes — they contain no AI logic and can be driven by any producer (the actual AI lives in `@pilotiq-pro/ai`), so the `Ai*` prefix oversold them.
+
+  **Renamed exports** (no aliases — direct importers must update):
+
+  | Old                                                                    | New                                                              |
+  | ---------------------------------------------------------------------- | ---------------------------------------------------------------- |
+  | `AiSuggestionExtension`                                                | `SuggestionChipExtension`                                        |
+  | `AiSuggestion`                                                         | `InlineSuggestion`                                               |
+  | `AiSuggestionExtensionOptions`                                         | `SuggestionChipExtensionOptions`                                 |
+  | `aiSuggestionPluginKey`                                                | `suggestionChipPluginKey`                                        |
+  | `useAiSuggestionBridge`                                                | `useSuggestionBridge`                                            |
+  | `AiInlineDiffExtension`                                                | `InlineDiffExtension`                                            |
+  | `AiInlineDiffExtensionOptions`                                         | `InlineDiffExtensionOptions`                                     |
+  | `aiInlineDiffPluginKey`                                                | `inlineDiffPluginKey`                                            |
+  | `getAiInlineDiffState`                                                 | `getInlineDiffState`                                             |
+  | `AiDiffDisplayMode`                                                    | `DiffDisplayMode`                                                |
+  | `useAiInlineDiff` / `useIsAiInlineDiffActive` / `readAiDiffViewMarker` | `useInlineDiff` / `useIsInlineDiffActive` / `readDiffViewMarker` |
+  | `AiSuggestionBanner` / `useAiSuggestionBanner`                         | `SuggestionBanner` / `useSuggestionBanner`                       |
+
+  **Renamed editor commands**: `addAiSuggestion` → `addSuggestion`, `approveAiSuggestion` → `approveSuggestion`, `rejectAiSuggestion` → `rejectSuggestion`, `approveAllAiSuggestions` → `approveAllSuggestions`, `rejectAllAiSuggestions` → `rejectAllSuggestions`, `clearAiSuggestions` → `clearSuggestions`; `startAiInlineDiff` → `startInlineDiff`, `applySurgicalAiInlineDiff` → `applySurgicalInlineDiff`, `acceptAiInlineDiff` → `acceptInlineDiff`, `rejectAiInlineDiff` → `rejectInlineDiff`.
+
+  **Renamed CSS classes / DOM markers** (consumers with custom stylesheets must update; the injected defaults follow the new names automatically): `pilotiq-ai-suggestion-*` → `pilotiq-suggestion-*`, `pilotiq-ai-banner-*` → `pilotiq-suggestion-banner-*`, `pilotiq-ai-diff-*` → `pilotiq-diff-*`, and the matching `data-pilotiq-ai-*` attributes → `data-pilotiq-*`.
+
+  **Deliberately unchanged**: the cross-package field-config markers `data-ai-suggestions-mode` / `data-ai-diff-view` (written by `@pilotiq-pro/ai`'s `.aiSuggestionsMode()` / `.aiDiffView()` field API) stay `ai`-prefixed — they configure genuinely AI-specific behavior, not provider-neutral primitives.
+
+### Minor Changes
+
+- 0096a7f: Add an in-block text find→replace surgical op — `planReplaceText` plus a `replace_text` case in the inline-diff dispatch.
+
+  It swaps the first occurrence of a `search` string with `replace`, preserving the surrounding node structure. This lets a producer (e.g. `@pilotiq-pro/ai`) fix a word, number, or typo **inside** a custom block (alert / prosCons / faq / keyTakeaways) or a table cell without rebuilding the block as HTML — which `replace_block` would force, flattening the block. The op is index-free: the match position resolves at apply time, so it composes safely after the index-based block ops in a batch. Returns `null` when `search` isn't present, so a stale or guessed search string changes nothing rather than corrupting the doc.
+
+  New export: `planReplaceText`. Surgical meta op: `{ op: 'replace_text', search, replace }`.
+
 ## 3.20.0
 
 ### Minor Changes

package/dist/extensions/{AiInlineDiffExtension.d.ts → InlineDiffExtension.d.ts}

@@ -1,15 +1,15 @@
 /**
  * Inline-diff visualization for whole-field AI suggestions.
  *
- * Sibling to `AiSuggestionExtension`, which handles producer-supplied
+ * Sibling to `SuggestionChipExtension`, which handles producer-supplied
  * range suggestions (surgical edits with `meta.editorRange`) via the
  * inline chip widget. This extension handles the *whole-field* case:
  * the AI proposes a new document and the user reviews the structural
  * delta (added paragraphs, deleted text, mark changes, etc.) before
- * accepting or rejecting via the host-mounted `<AiSuggestionBanner>`.
+ * accepting or rejecting via the host-mounted `<SuggestionBanner>`.
  *
  * Architecture:
- *   1. `startAiInlineDiff(id, newDoc)` captures the current doc as the
+ *   1. `startInlineDiff(id, newDoc)` captures the current doc as the
  *      baseline, replaces the doc body with `newDoc`'s content (so the
  *      editor surface IS the proposed state), and initializes a
  *      `prosemirror-changeset` tracking the original-to-current
@@ -24,9 +24,9 @@
  *          through next to the insert point (the deleted content
  *          isn't in the current doc, so a widget is the only way to
  *          surface it)
- *   4. `acceptAiInlineDiff()` clears the plugin state — the current
+ *   4. `acceptInlineDiff()` clears the plugin state — the current
  *      doc is the accepted state.
- *   5. `rejectAiInlineDiff()` replaces the doc back to the baseline
+ *   5. `rejectInlineDiff()` replaces the doc back to the baseline
  *      via a single transaction and clears state.
  *
  * For Tiptap Pro parity. See `[[project_pilotiq_text_field_tiptap_rules]]`.
@@ -38,7 +38,7 @@ import type { Node as ProseMirrorNode, Slice } from '@tiptap/pm/model';
 import { ChangeSet } from 'prosemirror-changeset';
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
-        aiInlineDiff: {
+        inlineDiff: {
             /**
              * Start the inline-diff review session. Snapshots the current
              * doc as the baseline, replaces the doc with `newDocSlice`'s
@@ -48,7 +48,7 @@ declare module '@tiptap/core' {
              * banner / approve handlers can correlate the editor state with
              * the queue entry.
              */
-            startAiInlineDiff: (id: string, newDocSlice: Slice, displayMode?: AiDiffDisplayMode) => ReturnType;
+            startInlineDiff: (id: string, newDocSlice: Slice, displayMode?: DiffDisplayMode) => ReturnType;
             /**
              * Start the inline-diff review session for a surgical edit.
              * Snapshots the current doc as the baseline, then runs
@@ -62,11 +62,11 @@ declare module '@tiptap/core' {
              * `delete_block` / `update_block_mark` AI ops. Returns false (no
              * dispatch) when `applyFn` produced no doc change.
              */
-            applySurgicalAiInlineDiff: (id: string, applyFn: (tr: Transaction) => void, displayMode?: AiDiffDisplayMode) => ReturnType;
+            applySurgicalInlineDiff: (id: string, applyFn: (tr: Transaction) => void, displayMode?: DiffDisplayMode) => ReturnType;
             /** Clear diff state. Current doc IS the accepted state. */
-            acceptAiInlineDiff: () => ReturnType;
+            acceptInlineDiff: () => ReturnType;
             /** Revert doc to the captured baseline and clear diff state. */
-            rejectAiInlineDiff: () => ReturnType;
+            rejectInlineDiff: () => ReturnType;
         };
     }
 }
@@ -79,30 +79,30 @@ declare module '@tiptap/core' {
  *     full-width red row (`−` gutter) above the change. Suits markdown
  *     sources / structured text where lines are the meaningful unit.
  */
-export type AiDiffDisplayMode = 'inline' | 'lines';
+export type DiffDisplayMode = 'inline' | 'lines';
 interface DiffState {
     id: string;
-    /** Original doc captured at `startAiInlineDiff` time — used for revert. */
+    /** Original doc captured at `startInlineDiff` time — used for revert. */
     baseline: ProseMirrorNode;
     /** ChangeSet accumulating diffs since baseline. */
     changeset: ChangeSet;
-    /** Rendering mode for the decorations — see `AiDiffDisplayMode`. */
-    displayMode: AiDiffDisplayMode;
+    /** Rendering mode for the decorations — see `DiffDisplayMode`. */
+    displayMode: DiffDisplayMode;
 }
-export declare const aiInlineDiffPluginKey: PluginKey<DiffState | null>;
+export declare const inlineDiffPluginKey: PluginKey<DiffState | null>;
 /** Read the active diff state, if any. Public for hosts that want to
  *  branch their banner UI on "diff active" vs "diff inactive". */
-export declare function getAiInlineDiffState(state: EditorState): DiffState | null;
-export interface AiInlineDiffExtensionOptions {
+export declare function getInlineDiffState(state: EditorState): DiffState | null;
+export interface InlineDiffExtensionOptions {
     /**
      * Class prefix for inline-diff decorations. Defaults to
-     * `'pilotiq-ai-diff'`, producing:
-     *   - `pilotiq-ai-diff-inserted`  (green-background span on new ranges)
-     *   - `pilotiq-ai-diff-deleted`   (widget DOM root for deleted text)
-     *   - `pilotiq-ai-diff-deleted-text`  (the strikethrough span inside)
+     * `'pilotiq-diff'`, producing:
+     *   - `pilotiq-diff-inserted`  (green-background span on new ranges)
+     *   - `pilotiq-diff-deleted`   (widget DOM root for deleted text)
+     *   - `pilotiq-diff-deleted-text`  (the strikethrough span inside)
      */
     classPrefix?: string;
 }
-export declare const AiInlineDiffExtension: Extension<AiInlineDiffExtensionOptions, any>;
+export declare const InlineDiffExtension: Extension<InlineDiffExtensionOptions, any>;
 export {};
-//# sourceMappingURL=AiInlineDiffExtension.d.ts.map
+//# sourceMappingURL=InlineDiffExtension.d.ts.map

package/dist/extensions/{AiInlineDiffExtension.js → InlineDiffExtension.js}

@@ -1,15 +1,15 @@
 /**
  * Inline-diff visualization for whole-field AI suggestions.
  *
- * Sibling to `AiSuggestionExtension`, which handles producer-supplied
+ * Sibling to `SuggestionChipExtension`, which handles producer-supplied
  * range suggestions (surgical edits with `meta.editorRange`) via the
  * inline chip widget. This extension handles the *whole-field* case:
  * the AI proposes a new document and the user reviews the structural
  * delta (added paragraphs, deleted text, mark changes, etc.) before
- * accepting or rejecting via the host-mounted `<AiSuggestionBanner>`.
+ * accepting or rejecting via the host-mounted `<SuggestionBanner>`.
  *
  * Architecture:
- *   1. `startAiInlineDiff(id, newDoc)` captures the current doc as the
+ *   1. `startInlineDiff(id, newDoc)` captures the current doc as the
  *      baseline, replaces the doc body with `newDoc`'s content (so the
  *      editor surface IS the proposed state), and initializes a
  *      `prosemirror-changeset` tracking the original-to-current
@@ -24,9 +24,9 @@
  *          through next to the insert point (the deleted content
  *          isn't in the current doc, so a widget is the only way to
  *          surface it)
- *   4. `acceptAiInlineDiff()` clears the plugin state — the current
+ *   4. `acceptInlineDiff()` clears the plugin state — the current
  *      doc is the accepted state.
- *   5. `rejectAiInlineDiff()` replaces the doc back to the baseline
+ *   5. `rejectInlineDiff()` replaces the doc back to the baseline
  *      via a single transaction and clears state.
  *
  * For Tiptap Pro parity. See `[[project_pilotiq_text_field_tiptap_rules]]`.
@@ -36,22 +36,22 @@ import { Plugin, PluginKey } from '@tiptap/pm/state';
 import { Decoration, DecorationSet } from '@tiptap/pm/view';
 import { DOMSerializer, Fragment } from '@tiptap/pm/model';
 import { ChangeSet } from 'prosemirror-changeset';
-export const aiInlineDiffPluginKey = new PluginKey('pilotiqAiInlineDiff');
+export const inlineDiffPluginKey = new PluginKey('pilotiqInlineDiff');
 /** Read the active diff state, if any. Public for hosts that want to
  *  branch their banner UI on "diff active" vs "diff inactive". */
-export function getAiInlineDiffState(state) {
-    return aiInlineDiffPluginKey.getState(state) ?? null;
+export function getInlineDiffState(state) {
+    return inlineDiffPluginKey.getState(state) ?? null;
 }
-export const AiInlineDiffExtension = Extension.create({
-    name: 'pilotiqAiInlineDiff',
+export const InlineDiffExtension = Extension.create({
+    name: 'pilotiqInlineDiff',
     addOptions() {
-        return { classPrefix: 'pilotiq-ai-diff' };
+        return { classPrefix: 'pilotiq-diff' };
     },
     onCreate() {
         // Mirror the chip CSS injection pattern. Idempotent via sentinel.
         if (typeof document === 'undefined')
             return;
-        const SENTINEL = 'data-pilotiq-ai-diff-styles';
+        const SENTINEL = 'data-pilotiq-diff-styles';
         if (document.head.querySelector(`style[${SENTINEL}]`))
             return;
         const prefix = this.options.classPrefix;
@@ -129,7 +129,7 @@ export const AiInlineDiffExtension = Extension.create({
     },
     addCommands() {
         return {
-            startAiInlineDiff: (id, newDocSlice, displayMode) => ({ tr, state, dispatch }) => {
+            startInlineDiff: (id, newDocSlice, displayMode) => ({ tr, state, dispatch }) => {
                 const baseline = state.doc;
                 const docEnd = state.doc.content.size;
                 // Replace the whole doc body with the proposed content. The
@@ -137,31 +137,31 @@ export const AiInlineDiffExtension = Extension.create({
                 // throws (callers should pre-validate via `editor.schema`).
                 tr.replaceRange(0, docEnd, newDocSlice);
                 const meta = { type: 'start', id, baseline, ...(displayMode ? { displayMode } : {}) };
-                tr.setMeta(aiInlineDiffPluginKey, meta);
+                tr.setMeta(inlineDiffPluginKey, meta);
                 if (dispatch)
                     dispatch(tr);
                 return true;
             },
-            applySurgicalAiInlineDiff: (id, applyFn, displayMode) => ({ tr, state, dispatch }) => {
+            applySurgicalInlineDiff: (id, applyFn, displayMode) => ({ tr, state, dispatch }) => {
                 const baseline = state.doc;
                 applyFn(tr);
                 if (!tr.docChanged)
                     return false;
                 const meta = { type: 'start', id, baseline, ...(displayMode ? { displayMode } : {}) };
-                tr.setMeta(aiInlineDiffPluginKey, meta);
+                tr.setMeta(inlineDiffPluginKey, meta);
                 if (dispatch)
                     dispatch(tr);
                 return true;
             },
-            acceptAiInlineDiff: () => ({ tr, dispatch }) => {
+            acceptInlineDiff: () => ({ tr, dispatch }) => {
                 const meta = { type: 'clear' };
-                tr.setMeta(aiInlineDiffPluginKey, meta);
+                tr.setMeta(inlineDiffPluginKey, meta);
                 if (dispatch)
                     dispatch(tr);
                 return true;
             },
-            rejectAiInlineDiff: () => ({ tr, state, dispatch }) => {
-                const ds = aiInlineDiffPluginKey.getState(state);
+            rejectInlineDiff: () => ({ tr, state, dispatch }) => {
+                const ds = inlineDiffPluginKey.getState(state);
                 if (!ds)
                     return false;
                 const docEnd = state.doc.content.size;
@@ -170,7 +170,7 @@ export const AiInlineDiffExtension = Extension.create({
                 // doc replace).
                 tr.replaceWith(0, docEnd, ds.baseline.content);
                 const meta = { type: 'clear' };
-                tr.setMeta(aiInlineDiffPluginKey, meta);
+                tr.setMeta(inlineDiffPluginKey, meta);
                 if (dispatch)
                     dispatch(tr);
                 return true;
@@ -181,11 +181,11 @@ export const AiInlineDiffExtension = Extension.create({
         const ext = this;
         return [
             new Plugin({
-                key: aiInlineDiffPluginKey,
+                key: inlineDiffPluginKey,
                 state: {
                     init() { return null; },
                     apply(tr, value) {
-                        const meta = tr.getMeta(aiInlineDiffPluginKey);
+                        const meta = tr.getMeta(inlineDiffPluginKey);
                         if (meta?.type === 'start') {
                             // Baseline captured BEFORE the replaceRange step in this
                             // same transaction. The changeset's `addSteps` consumes
@@ -210,10 +210,10 @@ export const AiInlineDiffExtension = Extension.create({
                 },
                 props: {
                     decorations(state) {
-                        const ds = aiInlineDiffPluginKey.getState(state);
+                        const ds = inlineDiffPluginKey.getState(state);
                         if (!ds)
                             return DecorationSet.empty;
-                        return buildDiffDecorations(state, ds, ext.options.classPrefix ?? 'pilotiq-ai-diff');
+                        return buildDiffDecorations(state, ds, ext.options.classPrefix ?? 'pilotiq-diff');
                     },
                     // While a LINES-mode diff is active, force the editor root to
                     // block layout. Some text surfaces style the root as a flex row
@@ -221,9 +221,9 @@ export const AiInlineDiffExtension = Extension.create({
                     // rows lay out as overflowing columns. Drops automatically on
                     // accept / reject.
                     attributes(state) {
-                        const ds = aiInlineDiffPluginKey.getState(state);
+                        const ds = inlineDiffPluginKey.getState(state);
                         return ds?.displayMode === 'lines'
-                            ? { class: `${ext.options.classPrefix ?? 'pilotiq-ai-diff'}-lines-active` }
+                            ? { class: `${ext.options.classPrefix ?? 'pilotiq-diff'}-lines-active` }
                             : {};
                     },
                 },
@@ -246,7 +246,7 @@ function buildDiffDecorations(state, ds, prefix) {
         if (toB > fromB) {
             decos.push(Decoration.inline(fromB, toB, {
                 class: `${prefix}-inserted`,
-                'data-pilotiq-ai-diff-id': ds.id,
+                'data-pilotiq-diff-id': ds.id,
             }));
         }
         // Deleted content — pull from the baseline using the `fromA..toA`
@@ -257,7 +257,7 @@ function buildDiffDecorations(state, ds, prefix) {
             decos.push(Decoration.widget(fromB, () => buildDeletedWidget(ds.baseline, change.fromA, change.toA, prefix, ds.id), {
                 side: -1,
                 ignoreSelection: true,
-                key: `pilotiq-ai-diff:deleted:${change.fromA}:${change.toA}`,
+                key: `pilotiq-diff:deleted:${change.fromA}:${change.toA}`,
             }));
         }
     }
@@ -281,7 +281,7 @@ function buildDiffDecorations(state, ds, prefix) {
 function buildDeletedWidget(baseline, fromA, toA, prefix, id) {
     const root = document.createElement('span');
     root.className = `${prefix}-deleted`;
-    root.setAttribute('data-pilotiq-ai-diff-id', id);
+    root.setAttribute('data-pilotiq-diff-id', id);
     root.contentEditable = 'false';
     // Walk the baseline's top-level blocks; for each one the deleted range
     // touches, keep the whole node when fully covered, else cut it to the
@@ -356,7 +356,7 @@ function buildLineDiffDecorations(state, ds, prefix) {
         decos.push(Decoration.widget(anchor, () => buildDeletedLinesWidget(nodes, schema, prefix, ds.id), {
             side: -1,
             ignoreSelection: true,
-            key: `pilotiq-ai-diff:deleted-lines:${anchor}:${nodes.length}`,
+            key: `pilotiq-diff:deleted-lines:${anchor}:${nodes.length}`,
         }));
     };
     for (const tok of lcsBlockDiffTokens(baseBlocks.map(b => b.text), current.map(c => c.text))) {
@@ -370,7 +370,7 @@ function buildLineDiffDecorations(state, ds, prefix) {
             flushRemoved(current[j].pos);
             decos.push(Decoration.node(current[j].pos, current[j].pos + current[j].nodeSize, {
                 class: `${prefix}-inserted-line`,
-                'data-pilotiq-ai-diff-id': ds.id,
+                'data-pilotiq-diff-id': ds.id,
             }));
             j++;
             continue;
@@ -435,7 +435,7 @@ function lcsBlockDiffTokens(a, b) {
 function buildDeletedLinesWidget(nodes, schema, prefix, id) {
     const root = document.createElement('div');
     root.className = `${prefix}-deleted-lines`;
-    root.setAttribute('data-pilotiq-ai-diff-id', id);
+    root.setAttribute('data-pilotiq-diff-id', id);
     root.contentEditable = 'false';
     const serializer = DOMSerializer.fromSchema(schema);
     for (const node of nodes) {

package/dist/extensions/{AiSuggestionExtension.d.ts → SuggestionChipExtension.d.ts}

@@ -8,7 +8,7 @@ import { PluginKey } from '@tiptap/pm/state';
  * editor as-is when the suggestion is approved (the original range's marks
  * are preserved on the inserted text node by ProseMirror).
  */
-export interface AiSuggestion {
+export interface InlineSuggestion {
     /** Stable id; consumer-provided. Re-adding with the same id replaces the prior entry. */
     id: string;
     /** Inclusive document position the original range starts at. */
@@ -23,16 +23,16 @@ export interface AiSuggestion {
         agentLabel?: string;
     };
 }
-export interface AiSuggestionExtensionOptions {
+export interface SuggestionChipExtensionOptions {
     /**
      * Class prefix for both decoration spans and chip widgets. The package
      * stays CSS-free — consumers ship the matching styles. Default
-     * `'pilotiq-ai-suggestion'` produces classes:
-     *   - `pilotiq-ai-suggestion-original`     (strikethrough on the original range)
-     *   - `pilotiq-ai-suggestion-chip`         (root of the inline widget)
-     *   - `pilotiq-ai-suggestion-replacement`  (the suggested-text preview span)
-     *   - `pilotiq-ai-suggestion-accept`       (Approve button)
-     *   - `pilotiq-ai-suggestion-reject`       (Reject button)
+     * `'pilotiq-suggestion'` produces classes:
+     *   - `pilotiq-suggestion-original`     (strikethrough on the original range)
+     *   - `pilotiq-suggestion-chip`         (root of the inline widget)
+     *   - `pilotiq-suggestion-replacement`  (the suggested-text preview span)
+     *   - `pilotiq-suggestion-accept`       (Approve button)
+     *   - `pilotiq-suggestion-reject`       (Reject button)
      */
     classPrefix: string;
     /**
@@ -40,52 +40,52 @@ export interface AiSuggestionExtensionOptions {
      * `reject*`, `clear*`, or after a doc edit collapses a range. Lets the host
      * mirror state into a React context (e.g. `PendingSuggestionsApi`).
      */
-    onChange?: (suggestions: AiSuggestion[]) => void;
+    onChange?: (suggestions: InlineSuggestion[]) => void;
 }
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
-        aiSuggestion: {
+        suggestionChip: {
             /** Add or replace a suggestion (matched by id). */
-            addAiSuggestion: (suggestion: AiSuggestion) => ReturnType;
+            addSuggestion: (suggestion: InlineSuggestion) => ReturnType;
             /** Add or replace many suggestions in one transaction. */
-            addAiSuggestions: (suggestions: AiSuggestion[]) => ReturnType;
+            addSuggestions: (suggestions: InlineSuggestion[]) => ReturnType;
             /** Apply the replacement to the doc and drop the suggestion. */
-            approveAiSuggestion: (id: string) => ReturnType;
+            approveSuggestion: (id: string) => ReturnType;
             /** Drop the suggestion without touching the doc. */
-            rejectAiSuggestion: (id: string) => ReturnType;
+            rejectSuggestion: (id: string) => ReturnType;
             /** Apply every replacement in highest-`from`-first order. */
-            approveAllAiSuggestions: () => ReturnType;
+            approveAllSuggestions: () => ReturnType;
             /** Drop every suggestion. */
-            rejectAllAiSuggestions: () => ReturnType;
-            /** Alias for `rejectAllAiSuggestions`. */
-            clearAiSuggestions: () => ReturnType;
+            rejectAllSuggestions: () => ReturnType;
+            /** Alias for `rejectAllSuggestions`. */
+            clearSuggestions: () => ReturnType;
         };
     }
 }
 interface PluginState {
-    suggestions: readonly AiSuggestion[];
+    suggestions: readonly InlineSuggestion[];
 }
-export declare const aiSuggestionPluginKey: PluginKey<PluginState>;
+export declare const suggestionChipPluginKey: PluginKey<PluginState>;
 /**
  * Append or replace by id. Pure — exported for tests and so the same dedupe
  * shape can drive consumer-side mirror state.
  */
-export declare function upsertSuggestion(current: readonly AiSuggestion[], next: AiSuggestion): AiSuggestion[];
+export declare function upsertSuggestion(current: readonly InlineSuggestion[], next: InlineSuggestion): InlineSuggestion[];
 /** Append or replace many — semantically equivalent to a fold over `upsertSuggestion`. */
-export declare function upsertSuggestions(current: readonly AiSuggestion[], nexts: readonly AiSuggestion[]): AiSuggestion[];
+export declare function upsertSuggestions(current: readonly InlineSuggestion[], nexts: readonly InlineSuggestion[]): InlineSuggestion[];
 /** Remove by id. */
-export declare function removeSuggestion(current: readonly AiSuggestion[], id: string): AiSuggestion[];
+export declare function removeSuggestion(current: readonly InlineSuggestion[], id: string): InlineSuggestion[];
 /**
  * Remap survivors through a PM mapping; drop ranges that collapsed past
  * each other (`to < from` after remap). Pure — exported for tests.
  */
-export declare function remapSuggestions(suggestions: readonly AiSuggestion[], map: (pos: number, side: -1 | 1) => number): AiSuggestion[];
+export declare function remapSuggestions(suggestions: readonly InlineSuggestion[], map: (pos: number, side: -1 | 1) => number): InlineSuggestion[];
 /**
  * Order suggestions for `approveAll` so the highest-`from` runs first;
  * earlier-in-doc replacements then can't shift positions of later ones.
  * Pure — exported for tests.
  */
-export declare function sortForApproveAll(suggestions: readonly AiSuggestion[]): AiSuggestion[];
+export declare function sortForApproveAll(suggestions: readonly InlineSuggestion[]): InlineSuggestion[];
 /**
  * Editor extension that tracks AI-suggested edits as inline decorations with
  * per-hunk Approve/Reject chips. The package is CSS-free — consumers wire
@@ -93,7 +93,7 @@ export declare function sortForApproveAll(suggestions: readonly AiSuggestion[]):
  *
  * Usage:
  * ```ts
- * editor.commands.addAiSuggestion({
+ * editor.commands.addSuggestion({
  *   id:          'seo-1',
  *   from:        12,
  *   to:          18,
@@ -101,14 +101,14 @@ export declare function sortForApproveAll(suggestions: readonly AiSuggestion[]):
  *   source:      { agentLabel: 'SEO' },
  * })
  * // …user clicks ✓ on the chip, or:
- * editor.commands.approveAiSuggestion('seo-1')
+ * editor.commands.approveSuggestion('seo-1')
  * ```
  *
  * Mounted by default inside `TiptapEditor`; consumer code reaches it through
  * the editor's command surface.
  */
-export declare const AiSuggestionExtension: Extension<AiSuggestionExtensionOptions, any>;
+export declare const SuggestionChipExtension: Extension<SuggestionChipExtensionOptions, any>;
 /** Bound `pos` into `[0, max]`; non-finite or negative input collapses to 0. */
 export declare function clampPos(pos: number, max: number): number;
 export {};
-//# sourceMappingURL=AiSuggestionExtension.d.ts.map
+//# sourceMappingURL=SuggestionChipExtension.d.ts.map