@stll/folio-core 0.15.0 → 0.15.2

package/dist/ai-edits/apply.d.ts

@@ -1,6 +1,5 @@
 import { FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditSnapshot } from "./types.js";
 import { EditorState, Transaction } from "prosemirror-state";
-
 //#region src/ai-edits/apply.d.ts
 /**
  * The only editor surface the apply logic touches: a current `state`
@@ -20,7 +19,8 @@ type ApplyFolioAIEditOperationsOptions = {
   snapshot: FolioAIEditSnapshot;
   operations: FolioAIEditOperation[];
   mode?: FolioAIEditApplyMode;
-  author?: string; /** Optional author initials (w:initials) stamped alongside the author. */
+  author?: string;
+  /** Optional author initials (w:initials) stamped alongside the author. */
   initials?: string;
   createCommentId?: (text: string) => number;
 };

package/dist/ai-edits/blockRange.d.ts

@@ -1,6 +1,5 @@
 import { FolioAIEditSnapshot, FolioAITextRangeHandle } from "./types.js";
 import { Node } from "prosemirror-model";
-
 //#region src/ai-edits/blockRange.d.ts
 type DocPositionRange = {
   from: number;
@@ -11,22 +10,14 @@ type ResolveFolioAIBlockRangeOptions = {
   doc: Node;
   snapshot?: FolioAIEditSnapshot | null | undefined;
 };
-declare const resolveFolioAIBlockRange: ({
-  blockId,
-  doc,
-  snapshot
-}: ResolveFolioAIBlockRangeOptions) => DocPositionRange | null;
+declare const resolveFolioAIBlockRange: ({ blockId, doc, snapshot }: ResolveFolioAIBlockRangeOptions) => DocPositionRange | null;
 type ResolveFolioAITextRangeOptions = {
   range: FolioAITextRangeHandle;
   doc: Node;
   snapshot?: FolioAIEditSnapshot | null | undefined;
 };
 /** Resolve and validate a stable text-range handle against the live document. */
-declare const resolveFolioAITextRange: ({
-  range,
-  doc,
-  snapshot
-}: ResolveFolioAITextRangeOptions) => DocPositionRange | null;
+declare const resolveFolioAITextRange: ({ range, doc, snapshot }: ResolveFolioAITextRangeOptions) => DocPositionRange | null;
 type ResolvePassageRangeOptions = {
   blockId: string;
   text: string;
@@ -48,12 +39,7 @@ type ResolvePassageRangeOptions = {
  * match wins. Returns null when the block does not resolve, is not a textblock,
  * the needle is empty, or the text does not occur in the block.
  */
-declare const resolvePassageRange: ({
-  blockId,
-  text,
-  doc,
-  snapshot
-}: ResolvePassageRangeOptions) => DocPositionRange | null;
+declare const resolvePassageRange: ({ blockId, text, doc, snapshot }: ResolvePassageRangeOptions) => DocPositionRange | null;
 /**
  * Clamp a `{from, to}` pair so both endpoints fit inside a document of
  * `docSize` (in PM content positions). Block-boundary snapshots and stale

package/dist/ai-edits/clean-text.d.ts

@@ -1,5 +1,4 @@
 import { Node } from "prosemirror-model";
-
 //#region src/ai-edits/clean-text.d.ts
 /**
  * "Post-tracked-changes" view of a textblock: the string the user

package/dist/ai-edits/headless.d.ts

@@ -2,16 +2,18 @@ import { FolioAIBlock, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEdit
 import { document_d_exports } from "../types/document.js";
 import { FolioDocumentOperationBatch, FolioDocumentOperationResult, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult } from "../document-operations.js";
 import { FolioReviewChange, FolioReviewChangeKind } from "./read.js";
-
 //#region src/ai-edits/headless.d.ts
 /** Options for {@link FolioDocxReviewer.fromBuffer}. */
 type FolioDocxReviewerOptions = {
-  /** Default author for tracked changes and comments. (default: `"AI"`) */author?: string; /** Password for Agile-encrypted .docx files (Office 2010+). */
+  /** Default author for tracked changes and comments. (default: `"AI"`) */
+  author?: string;
+  /** Password for Agile-encrypted .docx files (Office 2010+). */
   password?: string | undefined;
 };
 /** Options for {@link FolioDocxReviewer.applyOperations}. */
 type FolioApplyOperationsOptions = {
-  /** `"tracked-changes"` (default) produces ins/del redlines; `"direct"` edits in place. */mode?: FolioAIEditApplyMode;
+  /** `"tracked-changes"` (default) produces ins/del redlines; `"direct"` edits in place. */
+  mode?: FolioAIEditApplyMode;
   /**
    * The snapshot the `operations`' block ids were built against. Omit to
    * snapshot the reviewer's current state — correct for the common flow of
@@ -98,7 +100,9 @@ type FolioReviewCommentReply = {
 };
 /** Input for {@link FolioDocxReviewer.replyTo}. */
 type FolioReviewReplyInput = {
-  /** Reply body text. */text: string; /** Reply author; defaults to the reviewer's author. */
+  /** Reply body text. */
+  text: string;
+  /** Reply author; defaults to the reviewer's author. */
   author?: string;
   initials?: string;
 };
@@ -106,11 +110,15 @@ type FolioReviewReplyInput = {
 type FolioReviewComment = {
   id: number;
   author: string;
-  date: string | null; /** The comment body text, its paragraphs joined by newlines. */
-  text: string; /** The document text the comment is anchored to, or `""` when unanchored. */
-  anchoredText: string; /** Stable id of the anchored body block, or `null` when the anchor is absent. */
+  date: string | null;
+  /** The comment body text, its paragraphs joined by newlines. */
+  text: string;
+  /** The document text the comment is anchored to, or `""` when unanchored. */
+  anchoredText: string;
+  /** Stable id of the anchored body block, or `null` when the anchor is absent. */
   blockId: string | null;
-  replies: FolioReviewCommentReply[]; /** Whether the comment is marked resolved / done. */
+  replies: FolioReviewCommentReply[];
+  /** Whether the comment is marked resolved / done. */
   done: boolean;
 };
 /** Filter for {@link FolioDocxReviewer.getComments}. */
@@ -166,10 +174,7 @@ declare class FolioDocxReviewer {
   /** Read one story through an immutable reviewed-view projection. */
   readReviewedStory(options?: FolioReadReviewedStoryOptions): FolioReviewedStory | null;
   /** Resolve one editable story to its original or final state. */
-  resolveReviewedStory({
-    story,
-    view
-  }: FolioResolveReviewedStoryOptions): boolean;
+  resolveReviewedStory({ story, view }: FolioResolveReviewedStoryOptions): boolean;
   /**
    * Apply operations against the current state. Reuses the live-editor applier
    * verbatim via a headless `{ state, dispatch }` seam; the resulting state
@@ -184,11 +189,7 @@ declare class FolioDocxReviewer {
    */
   applyDocumentOperations(batch: FolioDocumentOperationBatch, options?: FolioApplyDocumentOperationsOptions): FolioDocumentOperationResult;
   /** Apply a versioned operation batch to one editable document story. */
-  applyDocumentOperationsToStory({
-    story,
-    batch,
-    snapshot
-  }: FolioApplyDocumentOperationsToStoryOptions): FolioDocumentOperationResult;
+  applyDocumentOperationsToStory({ story, batch, snapshot }: FolioApplyDocumentOperationsToStoryOptions): FolioDocumentOperationResult;
   private applyDocumentOperationsInternal;
   /** Undo the latest unchanged document-operation batch and its created comments. */
   undoDocumentOperations(undoHandle: FolioDocumentOperationUndoHandle): FolioDocumentOperationUndoResult;
@@ -328,7 +329,9 @@ declare class FolioDocxReviewer {
 }
 /** Options for {@link applyFolioAIEditsToBuffer}. */
 type ApplyFolioAIEditsToBufferOptions = {
-  /** Default author for tracked changes and comments. (default: `"AI"`) */author?: string; /** `"tracked-changes"` (default) produces ins/del redlines; `"direct"` edits in place. */
+  /** Default author for tracked changes and comments. (default: `"AI"`) */
+  author?: string;
+  /** `"tracked-changes"` (default) produces ins/del redlines; `"direct"` edits in place. */
   mode?: FolioAIEditApplyMode;
   /**
    * The snapshot the `operations`' block ids were built against. Omit to
@@ -340,7 +343,8 @@ type ApplyFolioAIEditsToBufferOptions = {
 };
 /** Result of {@link applyFolioAIEditsToBuffer}. */
 type ApplyFolioAIEditsToBufferResult = FolioAIEditApplyResult & {
-  /** The reviewed `.docx` as a new buffer. */buffer: ArrayBuffer;
+  /** The reviewed `.docx` as a new buffer. */
+  buffer: ArrayBuffer;
 };
 /**
  * One-shot headless review: parse `buffer`, apply `operations`, and return the

package/dist/ai-edits/read.d.ts

@@ -1,5 +1,4 @@
 import { Node } from "prosemirror-model";
-
 //#region src/ai-edits/read.d.ts
 type FolioReviewChangeKind = "insertion" | "deletion" | "formatting" | "rowInserted" | "rowDeleted" | "cellInserted" | "cellDeleted" | "cellMerged";
 /** A tracked change discovered in the document body. */
@@ -11,8 +10,10 @@ type FolioReviewChange = {
    */
   id: number;
   type: FolioReviewChangeKind;
-  author: string; /** ISO date the change was authored, or `null` when the source omitted it. */
-  date: string | null; /** Affected text, including row or cell content for structural revisions. */
+  author: string;
+  /** ISO date the change was authored, or `null` when the source omitted it. */
+  date: string | null;
+  /** Affected text, including row or cell content for structural revisions. */
   text: string;
   /**
    * Stable id of the containing body block (Word `w14:paraId` or `seq-NNNN`).
@@ -23,8 +24,10 @@ type FolioReviewChange = {
 };
 /** A comment anchor (the ranged text a comment marks) discovered in the body. */
 type FolioCommentAnchor = {
-  commentId: number; /** Stable id of the anchored body block, or `null` when the anchor is absent. */
-  blockId: string | null; /** The document text the comment is anchored to. */
+  commentId: number;
+  /** Stable id of the anchored body block, or `null` when the anchor is absent. */
+  blockId: string | null;
+  /** The document text the comment is anchored to. */
   quote: string;
 };
 /**

package/dist/ai-edits/scoped-reading.d.ts

@@ -1,5 +1,4 @@
 import { FolioAIEditSnapshot, FolioDocumentOutline, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./types.js";
-
 //#region src/ai-edits/scoped-reading.d.ts
 /** Build a flat, ordered outline with stable handles and explicit parents. */
 declare const getFolioDocumentOutline: (snapshot: FolioAIEditSnapshot) => FolioDocumentOutline;

package/dist/ai-edits/snapshot.d.ts

@@ -1,6 +1,5 @@
 import { FolioAIEditSnapshot, FolioAITextRangeHandle } from "./types.js";
 import { Node } from "prosemirror-model";
-
 //#region src/ai-edits/snapshot.d.ts
 declare const normalizeFolioAIBlockText: (text: string) => string;
 declare const hashFolioAIBlockText: (text: string) => string;
@@ -10,12 +9,7 @@ type CreateFolioAITextRangeHandleOptions = {
   startOffset: number;
   endOffset: number;
 };
-declare const createFolioAITextRangeHandle: ({
-  blockId,
-  text,
-  startOffset,
-  endOffset
-}: CreateFolioAITextRangeHandleOptions) => FolioAITextRangeHandle | null;
+declare const createFolioAITextRangeHandle: ({ blockId, text, startOffset, endOffset }: CreateFolioAITextRangeHandleOptions) => FolioAITextRangeHandle | null;
 declare const createFolioAIEditSnapshot: (doc: Node) => FolioAIEditSnapshot;
 //#endregion
 export { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText };

package/dist/ai-edits/table-cell-mutations.d.ts

@@ -1,7 +1,6 @@
 import { TableRectangle } from "./table-mutation-plan.js";
 import { Transaction } from "prosemirror-state";
 import { Node } from "prosemirror-model";
-
 //#region src/ai-edits/table-cell-mutations.d.ts
 type TableCellRectangleMutationOptions = {
   tr: Transaction;
@@ -14,35 +13,9 @@ type TrackedTableCellRectangleMutationOptions = TableCellRectangleMutationOption
   author: string;
   date: string;
 };
-declare const mergeTableRectangle: ({
-  tr,
-  tablePosition,
-  table,
-  rectangle
-}: TableCellRectangleMutationOptions) => Transaction | null;
-declare const mergeTrackedVerticalTableCells: ({
-  tr,
-  tablePosition,
-  table,
-  rectangle,
-  revisionId,
-  author,
-  date
-}: TrackedTableCellRectangleMutationOptions) => Transaction | null;
-declare const splitTableRectangle: ({
-  tr,
-  tablePosition,
-  table,
-  rectangle
-}: TableCellRectangleMutationOptions) => Transaction | null;
-declare const splitTrackedVerticalTableCell: ({
-  tr,
-  tablePosition,
-  table,
-  rectangle,
-  revisionId,
-  author,
-  date
-}: TrackedTableCellRectangleMutationOptions) => Transaction | null;
+declare const mergeTableRectangle: ({ tr, tablePosition, table, rectangle }: TableCellRectangleMutationOptions) => Transaction | null;
+declare const mergeTrackedVerticalTableCells: ({ tr, tablePosition, table, rectangle, revisionId, author, date }: TrackedTableCellRectangleMutationOptions) => Transaction | null;
+declare const splitTableRectangle: ({ tr, tablePosition, table, rectangle }: TableCellRectangleMutationOptions) => Transaction | null;
+declare const splitTrackedVerticalTableCell: ({ tr, tablePosition, table, rectangle, revisionId, author, date }: TrackedTableCellRectangleMutationOptions) => Transaction | null;
 //#endregion
 export { mergeTableRectangle, mergeTrackedVerticalTableCells, splitTableRectangle, splitTrackedVerticalTableCell };

package/dist/ai-edits/table-row-column-mutations.d.ts

@@ -2,7 +2,6 @@ import { TrackedChangeProvenance } from "../prosemirror/schema/marks.js";
 import { TableRowTarget } from "./table-targets.js";
 import { Transaction } from "prosemirror-state";
 import { Node } from "prosemirror-model";
-
 //#region src/ai-edits/table-row-column-mutations.d.ts
 type TableRowInsertion = {
   tableStart: number;
@@ -20,7 +19,8 @@ type TableColumnDeletion = TableColumnInsertion;
 type TableStructureRevision = {
   revisionId: number;
   author: string;
-  date: string; /** Optional author initials (w:initials), carried for round-trip. */
+  date: string;
+  /** Optional author initials (w:initials), carried for round-trip. */
   initials?: string;
   /**
    * `"suggested"` marks the produced `trIns`/`trDel`/`cellMarker` as an AI
@@ -36,73 +36,43 @@ type TableRowColumnMutationResult = {
 } | {
   type: "unsupported";
 };
-declare const getTableColumnCoordinateKey: ({
-  tablePosition,
-  columnIndex
-}: TableColumnInsertion) => string;
+declare const getTableColumnCoordinateKey: ({ tablePosition, columnIndex }: TableColumnInsertion) => string;
 type FindTableColumnInsertionOptions = {
   doc: Node;
   blockFrom: number;
   position: "after" | "before";
 };
-declare const findTableColumnInsertion: ({
-  doc,
-  blockFrom,
-  position
-}: FindTableColumnInsertionOptions) => (TableColumnInsertion & {
+declare const findTableColumnInsertion: ({ doc, blockFrom, position }: FindTableColumnInsertionOptions) => (TableColumnInsertion & {
   boundaryPosition: number;
 }) | null;
 type FindTableRowInsertionOptions = FindTableColumnInsertionOptions;
-declare const findTableRowInsertion: ({
-  doc,
-  blockFrom,
-  position
-}: FindTableRowInsertionOptions) => TableRowInsertion | null;
+declare const findTableRowInsertion: ({ doc, blockFrom, position }: FindTableRowInsertionOptions) => TableRowInsertion | null;
 type ApplyTableRowInsertionOptions = {
   tr: Transaction;
   insertion: TableRowInsertion;
   cellTexts: readonly string[] | undefined;
   revision: TableStructureRevision | null;
 };
-declare const applyTableRowInsertion: ({
-  tr,
-  insertion,
-  cellTexts,
-  revision
-}: ApplyTableRowInsertionOptions) => TableRowColumnMutationResult;
+declare const applyTableRowInsertion: ({ tr, insertion, cellTexts, revision }: ApplyTableRowInsertionOptions) => TableRowColumnMutationResult;
 type ApplyTableColumnInsertionOptions = {
   tr: Transaction;
   insertion: TableColumnInsertion;
   cellTexts: readonly string[] | undefined;
   revision: TableStructureRevision | null;
 };
-declare const applyTableColumnInsertion: ({
-  tr,
-  insertion,
-  cellTexts,
-  revision
-}: ApplyTableColumnInsertionOptions) => TableRowColumnMutationResult;
+declare const applyTableColumnInsertion: ({ tr, insertion, cellTexts, revision }: ApplyTableColumnInsertionOptions) => TableRowColumnMutationResult;
 type ApplyTableColumnDeletionOptions = {
   tr: Transaction;
   deletion: TableColumnDeletion;
   insertedColumnCount: number;
   revision: TableStructureRevision | null;
 };
-declare const applyTableColumnDeletion: ({
-  tr,
-  deletion,
-  insertedColumnCount,
-  revision
-}: ApplyTableColumnDeletionOptions) => TableRowColumnMutationResult;
+declare const applyTableColumnDeletion: ({ tr, deletion, insertedColumnCount, revision }: ApplyTableColumnDeletionOptions) => TableRowColumnMutationResult;
 type ApplyTableRowDeletionOptions = {
   tr: Transaction;
   deletion: TableRowDeletion;
   revision: TableStructureRevision | null;
 };
-declare const applyTableRowDeletion: ({
-  tr,
-  deletion,
-  revision
-}: ApplyTableRowDeletionOptions) => TableRowColumnMutationResult;
+declare const applyTableRowDeletion: ({ tr, deletion, revision }: ApplyTableRowDeletionOptions) => TableRowColumnMutationResult;
 //#endregion
 export { TableColumnDeletion, TableColumnInsertion, TableRowDeletion, TableRowInsertion, TableStructureRevision, applyTableColumnDeletion, applyTableColumnInsertion, applyTableRowDeletion, applyTableRowInsertion, findTableColumnInsertion, findTableRowInsertion, getTableColumnCoordinateKey };

package/dist/ai-edits/table-targets.d.ts

@@ -1,7 +1,6 @@
 import { TableRectangle } from "./table-mutation-plan.js";
 import { Node } from "prosemirror-model";
 import { TableMap } from "prosemirror-tables";
-
 //#region src/ai-edits/table-targets.d.ts
 type TableBoundary = {
   before: number;

package/dist/ai-edits/types.d.ts

@@ -13,7 +13,8 @@ type FolioAIBlockPreviewRun = {
 type FolioAIBlock = {
   id: string;
   kind: FolioAIBlockKind;
-  text: string; /** One-based heading depth when the block has outline semantics. */
+  text: string;
+  /** One-based heading depth when the block has outline semantics. */
   headingLevel?: number;
   displayLabel?: string;
   styleId?: string;
@@ -21,7 +22,8 @@ type FolioAIBlock = {
 };
 type FolioAIEditSnapshot = {
   blocks: FolioAIBlock[];
-  anchors: Record<string, FolioAIBlockAnchor>; /** Hidden empty paragraph used to anchor insertions when `blocks` is empty. */
+  anchors: Record<string, FolioAIBlockAnchor>;
+  /** Hidden empty paragraph used to anchor insertions when `blocks` is empty. */
   emptyDocumentAnchorId?: string;
 };
 type FolioAIBlockAnchor = {
@@ -73,13 +75,15 @@ type FolioDocumentSectionHandle = {
   type: "headingSection";
   story: "main";
   headingBlockId: string;
-  headingTextHash: string; /** One-based depth used to detect structural section-boundary changes. */
+  headingTextHash: string;
+  /** One-based depth used to detect structural section-boundary changes. */
   headingLevel: number;
 };
 type FolioDocumentOutlineEntry = {
   handle: FolioDocumentSectionHandle;
   headingBlockId: string;
-  text: string; /** One-based heading depth. */
+  text: string;
+  /** One-based heading depth. */
   level: number;
   parentHandle?: FolioDocumentSectionHandle;
 };
@@ -88,7 +92,8 @@ type FolioDocumentOutline = {
 };
 type FolioDocumentSection = {
   handle: FolioDocumentSectionHandle;
-  heading: FolioDocumentOutlineEntry; /** Heading block followed by every block in its logical section. */
+  heading: FolioDocumentOutlineEntry;
+  /** Heading block followed by every block in its logical section. */
   blocks: FolioAIBlock[];
 };
 type FolioDocumentSectionReadResult = {
@@ -205,37 +210,47 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
   comment?: FolioAIComment;
 } | {
   id: string;
-  type: "insertTableRow"; /** Stable paragraph anchor inside the row that receives the new sibling. */
+  type: "insertTableRow";
+  /** Stable paragraph anchor inside the row that receives the new sibling. */
   blockId: string;
-  position?: "after" | "before"; /** Initial text for each physical cell in source order; omitted cells stay empty. */
+  position?: "after" | "before";
+  /** Initial text for each physical cell in source order; omitted cells stay empty. */
   cellTexts?: string[];
 } | {
   id: string;
-  type: "deleteTableRow"; /** Stable paragraph anchor inside the row to delete. */
+  type: "deleteTableRow";
+  /** Stable paragraph anchor inside the row to delete. */
   blockId: string;
 } | {
   id: string;
-  type: "insertTableColumn"; /** Stable paragraph anchor inside the cell that receives the new sibling column. */
+  type: "insertTableColumn";
+  /** Stable paragraph anchor inside the cell that receives the new sibling column. */
   blockId: string;
-  position?: "after" | "before"; /** Initial text for newly created physical cells in row order. */
+  position?: "after" | "before";
+  /** Initial text for newly created physical cells in row order. */
   cellTexts?: string[];
 } | {
   id: string;
-  type: "deleteTableColumn"; /** Stable paragraph anchor inside the column to delete. */
+  type: "deleteTableColumn";
+  /** Stable paragraph anchor inside the column to delete. */
   blockId: string;
 } | ({
   id: string;
-  type: "mergeTableCells"; /** Stable paragraph anchor inside the first cell. */
+  type: "mergeTableCells";
+  /** Stable paragraph anchor inside the first cell. */
   blockId: string;
 } & ({
-  /** Stable paragraph anchor inside the opposite corner cell. */endBlockId: string;
+  /** Stable paragraph anchor inside the opposite corner cell. */
+  endBlockId: string;
   rowCount?: never;
 } | {
-  /** Number of grid rows to merge downward from the anchored cell. */rowCount: number;
+  /** Number of grid rows to merge downward from the anchored cell. */
+  rowCount: number;
   endBlockId?: never;
 })) | {
   id: string;
-  type: "splitTableCell"; /** Stable paragraph anchor inside the cell to split. */
+  type: "splitTableCell";
+  /** Stable paragraph anchor inside the cell to split. */
   blockId: string;
 });
 /**
@@ -253,13 +268,13 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
  *   `unsupportedMode`.
  */
 type FolioAIEditApplyMode = "direct" | "tracked-changes" | "suggested";
-type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" | "missingFind" | "unsupportedBlock" | "unsupportedMode" | "atomicBatchRejected" | "preconditionFailed" | "staleRange" | "emptyOperation"
+type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" | "missingFind" | "unsupportedBlock" | "unsupportedMode" | "atomicBatchRejected" | "preconditionFailed" | "staleRange" | "emptyOperation" |
 /**
  * The operation would not change the document — find equals
  * replace, or replaceBlock's `text` matches the live block.
  * Filtered out so the reviewer doesn't see "X → X" cards.
  */
-| "noopOperation";
+"noopOperation";
 type FolioAIEditAppliedOperation = {
   id: string;
   commentId?: number;

package/dist/ai-suggestions/apply.d.ts

@@ -1,6 +1,5 @@
 import { AISuggestion, AISuggestionApplyMode } from "./types.js";
 import { EditorView } from "prosemirror-view";
-
 //#region src/ai-suggestions/apply.d.ts
 type ApplyResult = {
   applied: string[];

package/dist/ai-suggestions/conflict.d.ts

@@ -1,6 +1,5 @@
 import { AISuggestion } from "./types.js";
 import { Node } from "prosemirror-model";
-
 //#region src/ai-suggestions/conflict.d.ts
 type ResolvedAnchor = {
   from: number;

package/dist/ai-suggestions/text-positions.d.ts

@@ -1,8 +1,8 @@
 import { Node } from "prosemirror-model";
-
 //#region src/ai-suggestions/text-positions.d.ts
 type PositionalText = {
-  /** Concatenated text content, with `\n` between block nodes. */text: string;
+  /** Concatenated text content, with `\n` between block nodes. */
+  text: string;
   /**
    * For each character at index `i` in `text`, returns the PM position
    * of that character (i.e., the position just before it). Block

package/dist/ai-suggestions/types.d.ts

@@ -29,7 +29,8 @@ type AISuggestion = {
   suggestedText: string;
   contextBefore: string;
   contextAfter: string;
-  rationale: string; /** 0..1 model confidence. Optional — not displayed prominently. */
+  rationale: string;
+  /** 0..1 model confidence. Optional — not displayed prominently. */
   confidence?: number;
   status: AISuggestionStatus;
   /**
@@ -40,7 +41,8 @@ type AISuggestion = {
    * its own registry; unknown values simply render no badge.
    */
   display?: {
-    valueKind?: string; /** `personAi`: a person writes a stub and AI adapts it in place. */
+    valueKind?: string;
+    /** `personAi`: a person writes a stub and AI adapts it in place. */
     filledBy?: "person" | "ai" | "personAi";
   };
 };
@@ -65,8 +67,10 @@ type AIGenerateInput = {
    * - "ask": no edit suggestions; pure answer.
    * - "edit": text + suggestions allowed, accept UI rendered.
    */
-  mode: AIChatMode; /** Selected text, if any. Empty string when no selection. */
-  selectionText: string; /** PM range of the selection, or null when there is no selection. */
+  mode: AIChatMode;
+  /** Selected text, if any. Empty string when no selection. */
+  selectionText: string;
+  /** PM range of the selection, or null when there is no selection. */
   selectionRange: {
     from: number;
     to: number;
@@ -79,7 +83,8 @@ type AIGenerateInput = {
   cursorPosition: {
     from: number;
     to: number;
-  } | null; /** Plain-text snapshot of the document body. */
+  } | null;
+  /** Plain-text snapshot of the document body. */
   documentText: string;
   /**
    * Subset of `documentText` currently visible in the viewport. Lets
@@ -108,9 +113,12 @@ type AIGenerateInput = {
  * conversation mode the prompt is naturally meant for.
  */
 type AISuggestionPreset = {
-  id: string; /** Short label shown in the dropdown (e.g., "Catch typos"). */
-  label: string; /** Optional one-line description shown beneath the label. */
-  description?: string; /** Prompt text sent to the generator when the preset is picked. */
+  id: string;
+  /** Short label shown in the dropdown (e.g., "Catch typos"). */
+  label: string;
+  /** Optional one-line description shown beneath the label. */
+  description?: string;
+  /** Prompt text sent to the generator when the preset is picked. */
   prompt: string;
   /**
    * Mode the preset is naturally meant for. Picking it switches the
@@ -132,7 +140,8 @@ type AISuggestionPreset = {
  * for what is universally a PDF bbox shape.
  */
 type AICitationSource = {
-  kind: "folio-range"; /** ProseMirror positions in the live document. */
+  kind: "folio-range";
+  /** ProseMirror positions in the live document. */
   from: number;
   to: number;
 } | {
@@ -144,9 +153,13 @@ type AICitationSource = {
   yMax: number;
 };
 type AICitation = {
-  /** Stable id within the message (e.g., used as `[1]` reference). */id: string; /** Short label rendered in the inline chip ("1", "§3.2", etc.). */
-  label: string; /** Verbatim quoted text from the source — surfaces on hover/expand. */
-  quote: string; /** Where the cited text lives in the source document. */
+  /** Stable id within the message (e.g., used as `[1]` reference). */
+  id: string;
+  /** Short label rendered in the inline chip ("1", "§3.2", etc.). */
+  label: string;
+  /** Verbatim quoted text from the source — surfaces on hover/expand. */
+  quote: string;
+  /** Where the cited text lives in the source document. */
   source: AICitationSource;
 };
 /**
@@ -177,7 +190,8 @@ type AISuggestionsConfig = {
    * Default apply mode. The user can toggle in the panel.
    * Defaults to "direct".
    */
-  defaultApplyMode?: AISuggestionApplyMode; /** Author label used when applying as tracked changes. */
+  defaultApplyMode?: AISuggestionApplyMode;
+  /** Author label used when applying as tracked changes. */
   applyAuthor?: string;
   /**
    * Called when the user accepts a suggestion while the editor is

package/dist/content-controls/errors.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/content-controls/errors.d.ts
 declare const ContentControlLockedError_base: import("better-result").TaggedErrorClass<"ContentControlLockedError", {
   message: string;

package/dist/content-controls/findContentControls.d.ts

@@ -1,9 +1,9 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/content-controls/findContentControls.d.ts
 type ContentControlFilter = {
   tag?: string;
-  alias?: string; /** OOXML numeric `w:id`. */
+  alias?: string;
+  /** OOXML numeric `w:id`. */
   id?: number;
   sdtType?: document_d_exports.SdtProperties["sdtType"];
   /**
@@ -34,8 +34,10 @@ type ContentControlLocation = {
   noteId: number;
 };
 type ContentControlMatch = {
-  control: document_d_exports.BlockSdt; /** Outer→inner stack of enclosing controls (empty when at the body root). */
-  ancestry: document_d_exports.BlockSdt[]; /** Indices to walk back into the doc, outer→inner. */
+  control: document_d_exports.BlockSdt;
+  /** Outer→inner stack of enclosing controls (empty when at the body root). */
+  ancestry: document_d_exports.BlockSdt[];
+  /** Indices to walk back into the doc, outer→inner. */
   path: number[];
   /**
    * Where in the document this match was found. Defaults to the main