@stll/folio-core 0.62.0 → 0.63.0

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

@@ -4,7 +4,7 @@ import { TableRowTarget } from "./table-targets.js";
 import { Node } from "prosemirror-model";
 import { Transaction } from "prosemirror-state";
 //#region src/ai-edits/table-row-column-mutations.d.ts
-type TableRowInsertion = {
+export type TableRowInsertion = {
   tableStart: number;
   rowPosition: number;
   rowType: Node["type"];
@@ -21,12 +21,12 @@ type TableRowInsertion = {
    */
   columnCount: number;
 };
-type TableRowDeletion = Omit<TableRowTarget, "table">;
-type TableColumnInsertion = {
+export type TableRowDeletion = Omit<TableRowTarget, "table">;
+export type TableColumnInsertion = {
   tablePosition: number;
   columnIndex: number;
 };
-type TableColumnDeletion = TableColumnInsertion;
+export type TableColumnDeletion = TableColumnInsertion;
 type TableRowColumnMutationResult = {
   type: "applied";
   transaction: Transaction;
@@ -56,18 +56,18 @@ type DescribeUnplacedCellTextsOptions = {
  * against the cells that are really built. Anything past the last one would
  * be dropped by an operation reported as applied.
  */
-declare const describeUnplacedCellTexts: ({ cellTexts, capacity, target }: DescribeUnplacedCellTextsOptions) => string | null;
-declare const getTableColumnCoordinateKey: ({ tablePosition, columnIndex }: TableColumnInsertion) => string;
+export declare const describeUnplacedCellTexts: ({ cellTexts, capacity, target }: DescribeUnplacedCellTextsOptions) => string | null;
+export declare const getTableColumnCoordinateKey: ({ tablePosition, columnIndex }: TableColumnInsertion) => string;
 type FindTableColumnInsertionOptions = {
   doc: Node;
   blockFrom: number;
   position: "after" | "before";
 };
-declare const findTableColumnInsertion: ({ doc, blockFrom, position }: FindTableColumnInsertionOptions) => (TableColumnInsertion & {
+export declare const findTableColumnInsertion: ({ doc, blockFrom, position }: FindTableColumnInsertionOptions) => (TableColumnInsertion & {
   boundaryPosition: number;
 }) | null;
 type FindTableRowInsertionOptions = FindTableColumnInsertionOptions;
-declare const findTableRowInsertion: ({ doc, blockFrom, position }: FindTableRowInsertionOptions) => TableRowInsertion | null;
+export declare const findTableRowInsertion: ({ doc, blockFrom, position }: FindTableRowInsertionOptions) => TableRowInsertion | null;
 type ApplyTableRowInsertionOptions = {
   tr: Transaction;
   insertion: TableRowInsertion;
@@ -81,8 +81,8 @@ type ApplyTableRowInsertionOptions = {
    */
   template?: Node;
 };
-declare const applyTableRowInsertion: ({ tr, insertion, cellTexts, revision, template }: ApplyTableRowInsertionOptions) => TableRowColumnMutationResult;
-type MarkTableRowContentOptions = {
+export declare const applyTableRowInsertion: ({ tr, insertion, cellTexts, revision, template }: ApplyTableRowInsertionOptions) => TableRowColumnMutationResult;
+export type MarkTableRowContentOptions = {
   tr: Transaction;
   rowPosition: number;
   kind: "insertion" | "deletion";
@@ -107,14 +107,14 @@ type MarkTableRowContentOptions = {
  * shortens its span — so marking its text would delete content the accepted
  * document must still hold.
  */
-declare const markTableRowContent: ({ tr, rowPosition, kind, revision }: MarkTableRowContentOptions) => void;
+export declare const markTableRowContent: ({ tr, rowPosition, kind, revision }: MarkTableRowContentOptions) => void;
 type ApplyTableColumnInsertionOptions = {
   tr: Transaction;
   insertion: TableColumnInsertion;
   cellTexts: readonly string[] | undefined;
   revision: TableStructureRevision | null;
 };
-declare const applyTableColumnInsertion: ({ tr, insertion, cellTexts, revision }: ApplyTableColumnInsertionOptions) => TableColumnInsertionResult;
+export declare const applyTableColumnInsertion: ({ tr, insertion, cellTexts, revision }: ApplyTableColumnInsertionOptions) => TableColumnInsertionResult;
 type ApplyTableColumnDeletionOptions = {
   tr: Transaction;
   deletion: TableColumnDeletion;
@@ -123,13 +123,13 @@ type ApplyTableColumnDeletionOptions = {
   /** Where to defer closing rows the deletion leaves without cells, when it runs in a batch. */
   emptiedRows?: RowsEmptiedInBatch;
 };
-declare const applyTableColumnDeletion: ({ tr, deletion, insertedColumnCount, revision, emptiedRows }: ApplyTableColumnDeletionOptions) => TableRowColumnMutationResult;
+export declare const applyTableColumnDeletion: ({ tr, deletion, insertedColumnCount, revision, emptiedRows }: ApplyTableColumnDeletionOptions) => TableRowColumnMutationResult;
 type ApplyTableRowDeletionOptions = {
   tr: Transaction;
   deletion: TableRowDeletion;
   revision: TableStructureRevision | null;
 };
-declare const applyTableRowDeletion: ({ tr, deletion, revision }: ApplyTableRowDeletionOptions) => TableRowColumnMutationResult;
+export declare const applyTableRowDeletion: ({ tr, deletion, revision }: ApplyTableRowDeletionOptions) => TableRowColumnMutationResult;
 /**
  * Split one cell's text into the paragraphs it describes, one string each.
  *
@@ -141,6 +141,6 @@ declare const applyTableRowDeletion: ({ tr, deletion, revision }: ApplyTableRowD
  * dropped. A cell's text is read off a cell that HAS those paragraphs, so
  * dropping one would lose a block that was there.
  */
-declare const splitCellParagraphTexts: (text: string) => string[];
+export declare const splitCellParagraphTexts: (text: string) => string[];
 //#endregion
-export { MarkTableRowContentOptions, TableColumnDeletion, TableColumnInsertion, TableRowDeletion, TableRowInsertion, applyTableColumnDeletion, applyTableColumnInsertion, applyTableRowDeletion, applyTableRowInsertion, describeUnplacedCellTexts, findTableColumnInsertion, findTableRowInsertion, getTableColumnCoordinateKey, markTableRowContent, splitCellParagraphTexts };
+export {};

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

@@ -2,18 +2,18 @@ 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 = {
+export type TableBoundary = {
   before: number;
   after: number;
 };
-type TableRowTarget = {
+export type TableRowTarget = {
   table: Node;
   tableStart: number;
   tablePosition: number;
   rowIndex: number;
   rowPosition: number;
 };
-type TableCellTarget = {
+export type TableCellTarget = {
   tablePosition: number;
   cellPosition: number;
   cellEndPosition: number;
@@ -32,9 +32,8 @@ type TableCellTarget = {
  * which is still "inside a table" and is never what a block-level insertion
  * meant.
  */
-declare const findOutermostTableBoundary: (doc: Node, blockFrom: number) => TableBoundary | null;
-declare const findEnclosingTableRow: (doc: Node, blockFrom: number) => TableRowTarget | null;
-declare const findEnclosingTableCell: (doc: Node, blockFrom: number) => TableCellTarget | null;
-declare const tableRectangleCutsMergedCell: (map: TableMap, rectangle: TableRectangle) => boolean;
-//#endregion
-export { TableBoundary, TableCellTarget, TableRowTarget, findEnclosingTableCell, findEnclosingTableRow, findOutermostTableBoundary, tableRectangleCutsMergedCell };
+export declare const findOutermostTableBoundary: (doc: Node, blockFrom: number) => TableBoundary | null;
+export declare const findEnclosingTableRow: (doc: Node, blockFrom: number) => TableRowTarget | null;
+export declare const findEnclosingTableCell: (doc: Node, blockFrom: number) => TableCellTarget | null;
+export declare const tableRectangleCutsMergedCell: (map: TableMap, rectangle: TableRectangle) => boolean;
+//#endregion

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

@@ -2,7 +2,7 @@ import { TrackedChangeProvenance } from "../prosemirror/schema/marks.js";
 import { Node, Schema } from "prosemirror-model";
 //#region src/ai-edits/table-template.d.ts
 /** The node an operation should place, by the id of the operation placing it. */
-type FolioTableTemplates = ReadonlyMap<string, Node>;
+export type FolioTableTemplates = ReadonlyMap<string, Node>;
 type HyperlinkPortability = "strict" | "rebind-external";
 /**
  * Whether a target table can cross into the base package without semantic
@@ -13,7 +13,7 @@ type HyperlinkPortability = "strict" | "rebind-external";
  * bookmarks and unresolved revision metadata are not portable and therefore
  * make a replacement unsafe. Callers can retain their granular plan instead.
  */
-declare const tableTemplateCanCrossPackageLosslessly: (template: Node, hyperlinkPortability?: HyperlinkPortability) => boolean;
+export declare const tableTemplateCanCrossPackageLosslessly: (template: Node, hyperlinkPortability?: HyperlinkPortability) => boolean;
 /**
  * A structural tracked change on a table row.
  *
@@ -23,7 +23,7 @@ declare const tableTemplateCanCrossPackageLosslessly: (template: Node, hyperlink
  * insertion when the row marker stands alone, so the two are always written
  * together.
  */
-type TableStructureRevision = {
+export type TableStructureRevision = {
   revisionId: number;
   author: string;
   date: string;
@@ -51,7 +51,7 @@ type TableFromTemplateOptions = {
  * fall back to the operation's own cell texts rather than place something that
  * is not one.
  */
-declare const tableFromTemplate: ({ schema, template, revision }: TableFromTemplateOptions) => Node | null;
+export declare const tableFromTemplate: ({ schema, template, revision }: TableFromTemplateOptions) => Node | null;
 type TableRowFromTemplateOptions = {
   template: Node;
   /** Grid columns the row has to occupy, from the table receiving it. */
@@ -66,6 +66,6 @@ type TableRowFromTemplateOptions = {
  * grid. A cell that merged vertically in the document it came from is placed
  * unmerged, because the rows it reached into are not this table's.
  */
-declare const tableRowFromTemplate: ({ template, columnCount }: TableRowFromTemplateOptions) => Node | null;
+export declare const tableRowFromTemplate: ({ template, columnCount }: TableRowFromTemplateOptions) => Node | null;
 //#endregion
-export { FolioTableTemplates, TableStructureRevision, tableFromTemplate, tableRowFromTemplate, tableTemplateCanCrossPackageLosslessly };
+export {};

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

@@ -1,18 +1,18 @@
 import { document_d_exports } from "../types/document.js";
-import { CanonicalGap } from "../types/canonicalCapabilities.js";
 import { FolioContentBlock, FolioContentBlockIdentity, FolioContentInlineBooleanProperty, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentListReference, FolioContentParagraphIndentation, FolioContentParagraphKind, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentStatedNumbering, FolioContentTableLocation } from "../compare/content-types.js";
 import { ListKind } from "../docx/listNumberingInstances.js";
+import { CanonicalGap } from "../types/canonicalCapabilities.js";
 //#region src/ai-edits/types.d.ts
-type FolioAIBlockKind = FolioContentParagraphKind | "diagnostic";
+export type FolioAIBlockKind = FolioContentParagraphKind | "diagnostic";
 /** Boolean run properties supported by snapshots and range-formatting mutations. */
-type FolioAIInlineBooleanProperty = FolioContentInlineBooleanProperty;
-type FolioAIInlineFormatting = FolioContentInlineFormatting;
+export type FolioAIInlineBooleanProperty = FolioContentInlineBooleanProperty;
+export type FolioAIInlineFormatting = FolioContentInlineFormatting;
 /**
  * A run-formatting mutation: `false` authors an explicit off value, while
  * `null` removes the direct property so its inherited value becomes effective.
  */
-type FolioAIInlineFormattingPatch = FolioContentInlineFormattingPatch;
-type FolioAIBlockPreviewRun = FolioContentRun;
+export type FolioAIInlineFormattingPatch = FolioContentInlineFormattingPatch;
+export type FolioAIBlockPreviewRun = FolioContentRun;
 /**
  * Inline structure inside a block's clean text.
  *
@@ -27,7 +27,7 @@ type FolioAIBlockPreviewRun = FolioContentRun;
  * and a text edit that would rewrite or remove it is refused
  * (`protectedReference`).
  */
-type FolioAIBlockStructuralBoundary = {
+export type FolioAIBlockStructuralBoundary = {
   type: "pageBreak";
   offset: number;
   clear?: document_d_exports.BreakContent["clear"];
@@ -45,29 +45,29 @@ type FolioAIBlockStructuralBoundary = {
  * not a grid column), and `paragraphIndex` orders the block among the cell's
  * own blocks. Absent on a block that is not inside a table.
  */
-type FolioAIBlockTableLocation = FolioContentTableLocation;
-type FolioAIParagraphBlock = FolioContentBlock<FolioContentParagraphKind> & {
+export type FolioAIBlockTableLocation = FolioContentTableLocation;
+export type FolioAIParagraphBlock = FolioContentBlock<FolioContentParagraphKind> & {
   structuralBoundaries?: readonly FolioAIBlockStructuralBoundary[];
 };
-type FolioAIDiagnosticBlock = FolioContentBlockIdentity<"diagnostic"> & {
+export type FolioAIDiagnosticBlock = FolioContentBlockIdentity<"diagnostic"> & {
   /** Present on a read-only block that reports preserved content Folio cannot interpret. */
   diagnostic: {
     type: "opaqueCarrier";
     carrier: string;
   };
 };
-type FolioAIBlock = FolioAIParagraphBlock | FolioAIDiagnosticBlock;
+export type FolioAIBlock = FolioAIParagraphBlock | FolioAIDiagnosticBlock;
 /**
  * The complete modeled attribute set of one direct `w:pPr/w:spacing` child.
  * Optional fields preserve the distinction between an absent attribute and
  * an explicit zero or false value.
  */
-type FolioAIParagraphSpacing = FolioContentParagraphSpacing;
+export type FolioAIParagraphSpacing = FolioContentParagraphSpacing;
 /** The complete modeled attribute set of one direct `w:pPr/w:ind` child. */
-type FolioAIParagraphIndentation = FolioContentParagraphIndentation;
-type FolioAIListReference = FolioContentListReference;
+export type FolioAIParagraphIndentation = FolioContentParagraphIndentation;
+export type FolioAIListReference = FolioContentListReference;
 /** The kinds of list an operation can start. */
-type FolioAIListKind = ListKind;
+export type FolioAIListKind = ListKind;
 /**
  * Start a new list: a numbering instance of `format`, defined for the
  * operation, with its paragraphs at `level` (zero-based, default 0). Every
@@ -75,21 +75,21 @@ type FolioAIListKind = ListKind;
  * operations start separate lists. A package without a numbering part gets
  * one.
  */
-type FolioAINewListReference = {
+export type FolioAINewListReference = {
   kind: "newList";
   format: FolioAIListKind;
   level?: number;
 };
 /** An existing numbering instance and level, or a new list. */
-type FolioAIListNumbering = FolioContentStatedNumbering | FolioAINewListReference;
+export type FolioAIListNumbering = FolioContentStatedNumbering | FolioAINewListReference;
 /** Which paragraphs split from one insertion's `text` receive its paragraph formatting. */
-type FolioAIInsertFormattingScope = "firstParagraph" | "allParagraphs";
+export type FolioAIInsertFormattingScope = "firstParagraph" | "allParagraphs";
 /**
  * The paragraph properties an operation may set. A subset of `w:pPrChange`'s
  * scope: properties a comparison can see in a block projection and an agent
  * has a reason to change.
  */
-type FolioAIBlockParagraphProperties<Numbering = FolioAIListNumbering> = {
+export type FolioAIBlockParagraphProperties<Numbering = FolioAIListNumbering> = {
   /** `w:pStyle`. `null` clears the style back to the default. */
   styleId?: string | null;
   /** Direct `w:outlineLvl`. `null` restores style inheritance. */
@@ -112,10 +112,10 @@ type FolioAIBlockParagraphProperties<Numbering = FolioAIListNumbering> = {
  * document for a person or a model wants only the paragraphs that carry text,
  * and says so with `isFolioAIContentBlock`.
  */
-type FolioAIEditSnapshot = FolioContentSnapshot<FolioAIBlock> & {
+export type FolioAIEditSnapshot = FolioContentSnapshot<FolioAIBlock> & {
   anchors: Record<string, FolioAIBlockAnchor>;
 };
-type FolioAIBlockAnchor = {
+export type FolioAIBlockAnchor = {
   id: string;
   from: number;
   to: number;
@@ -126,21 +126,21 @@ type FolioAIBlockAnchor = {
   structuralBoundaryHash: string;
   hashOccurrenceCount: number;
 };
-type FolioAIComment = {
+export type FolioAIComment = {
   text: string;
 };
-type FolioAIEditSeverity = "low" | "medium" | "high";
+export type FolioAIEditSeverity = "low" | "medium" | "high";
 /**
  * Optional review metadata attached to an AI-authored operation.
  * Set by the model when performing a structured review (e.g.
  * `severity: "high"`, `area: "Penalty"`); absent for direct edits.
  * Both fields are independent — either or both may be set.
  */
-type FolioAIEditReviewMeta = {
+export type FolioAIEditReviewMeta = {
   severity?: FolioAIEditSeverity;
   area?: string;
 };
-type FolioAIEditPrecondition = {
+export type FolioAIEditPrecondition = {
   blockTextHash: string;
 };
 /**
@@ -148,7 +148,7 @@ type FolioAIEditPrecondition = {
  * block. Offsets are zero-based UTF-16 boundaries, matching JavaScript string
  * slicing; `selectedTextHash` makes a shifted or changed selection fail stale.
  */
-type FolioAITextRangeHandle = {
+export type FolioAITextRangeHandle = {
   type: "textRange";
   story: "main";
   blockId: string;
@@ -162,7 +162,7 @@ type FolioAITextRangeHandle = {
  * `headingTextHash` makes a renamed heading fail stale instead of silently
  * resolving to content whose meaning may have changed.
  */
-type FolioDocumentSectionHandle = {
+export type FolioDocumentSectionHandle = {
   type: "headingSection";
   story: "main";
   headingBlockId: string;
@@ -170,7 +170,7 @@ type FolioDocumentSectionHandle = {
   /** One-based depth used to detect structural section-boundary changes. */
   headingLevel: number;
 };
-type FolioDocumentOutlineEntry = {
+export type FolioDocumentOutlineEntry = {
   handle: FolioDocumentSectionHandle;
   headingBlockId: string;
   text: string;
@@ -178,16 +178,16 @@ type FolioDocumentOutlineEntry = {
   level: number;
   parentHandle?: FolioDocumentSectionHandle;
 };
-type FolioDocumentOutline = {
+export type FolioDocumentOutline = {
   sections: FolioDocumentOutlineEntry[];
 };
-type FolioDocumentSection = {
+export type FolioDocumentSection = {
   handle: FolioDocumentSectionHandle;
   heading: FolioDocumentOutlineEntry;
   /** Heading block followed by every block in its logical section. */
   blocks: FolioAIBlock[];
 };
-type FolioDocumentSectionReadResult = {
+export type FolioDocumentSectionReadResult = {
   status: "found";
   section: FolioDocumentSection;
 } | {
@@ -195,7 +195,7 @@ type FolioDocumentSectionReadResult = {
 } | {
   status: "stale";
 };
-type FolioDocumentNavigationTarget = {
+export type FolioDocumentNavigationTarget = {
   type: "block";
   story: "main";
   blockId: string;
@@ -206,12 +206,12 @@ type FolioDocumentNavigationTarget = {
  * name is rendered bold; `signatory` and `title` are optional
  * lines under the signature rule (title in italics).
  */
-type FolioAISignatureParty = {
+export type FolioAISignatureParty = {
   name: string;
   signatory?: string;
   title?: string;
 };
-type FolioAIEditOperation<Numbering = FolioAIListNumbering> = FolioAIEditReviewMeta & {
+export type FolioAIEditOperation<Numbering = FolioAIListNumbering> = FolioAIEditReviewMeta & {
   precondition?: FolioAIEditPrecondition;
   /**
    * Groups this operation's produced marks under one logical suggestion so the
@@ -402,6 +402,11 @@ type FolioAIEditOperation<Numbering = FolioAIListNumbering> = FolioAIEditReviewM
 {
   id: string;
   type: "insertTable";
+  /**
+   * The anchor block. An anchor inside a table cell places the new
+   * table beside the outermost table holding that cell, never inside
+   * the cell.
+   */
   blockId: string;
   /** Place the table after the anchor (default) or before it. */
   position?: "after" | "before";
@@ -544,7 +549,7 @@ type FolioAIEditOperation<Numbering = FolioAIListNumbering> = FolioAIEditReviewM
   blockId: string;
 });
 /** Operations after the numbering allocator has resolved every request. */
-type FolioAIResolvedEditOperation = FolioAIEditOperation<FolioContentStatedNumbering>;
+export type FolioAIResolvedEditOperation = FolioAIEditOperation<FolioContentStatedNumbering>;
 /**
  * How AI-authored operations are applied:
  * - `"direct"` — edits are written straight into the document.
@@ -559,8 +564,8 @@ type FolioAIResolvedEditOperation = FolioAIEditOperation<FolioContentStatedNumbe
  *   deleteTableColumn). Only comment operations and cell merge/split report
  *   `unsupportedMode`.
  */
-type FolioAIEditApplyMode = "direct" | "tracked-changes" | "suggested";
-type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" | "missingFind" | "unsupportedBlock" | "unsupportedMode" | "atomicBatchRejected" | "preconditionFailed" | "staleRange" | "emptyOperation" |
+export type FolioAIEditApplyMode = "direct" | "tracked-changes" | "suggested";
+export type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" | "missingFind" | "unsupportedBlock" | "unsupportedMode" | "atomicBatchRejected" | "preconditionFailed" | "staleRange" | "emptyOperation" |
 /** The paragraph already owns the one `w:pPrChange` OOXML permits. */
 "pendingParagraphPropertyChange" |
 /** The affected run already owns the one `w:rPrChange` OOXML permits. */
@@ -652,7 +657,7 @@ type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" |
 "pendingDeletion" |
 /** Resolve the removed paragraph mark before editing its properties separately. */
 "pendingParagraphMarkDeletion";
-type FolioAIEditAppliedOperation = {
+export type FolioAIEditAppliedOperation = {
   id: string;
   commentId?: number;
   /**
@@ -681,7 +686,7 @@ type FolioAIEditAppliedOperation = {
    */
   suggestionId?: string;
 };
-type FolioAIEditSkippedOperation = {
+export type FolioAIEditSkippedOperation = {
   id: string;
   reason: FolioAIEditSkipReason;
   canonicalRefusal?: {
@@ -703,7 +708,7 @@ type FolioAIEditSkippedOperation = {
  * caller asked for something the document could not hold, and gets told what
  * it got instead.
  */
-type FolioAIEditNormalization =
+export type FolioAIEditNormalization =
 /**
  * A line-break in paragraph-mode `insertAfterBlock` /
  * `insertBeforeBlock` text was split into one paragraph per non-blank line.
@@ -738,12 +743,11 @@ type FolioAIEditNormalization =
   id: string;
   code: "uniformReplacementFormatting";
 };
-type FolioAIEditNormalizationCode = FolioAIEditNormalization["code"];
-type FolioAIEditApplyResult = {
+export type FolioAIEditNormalizationCode = FolioAIEditNormalization["code"];
+export type FolioAIEditApplyResult = {
   applied: FolioAIEditAppliedOperation[];
   skipped: FolioAIEditSkippedOperation[];
   /** Present only when at least one operation triggered a normalization. */
   normalizations?: FolioAIEditNormalization[];
 };
-//#endregion
-export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockParagraphProperties, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIDiagnosticBlock, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIInsertFormattingScope, FolioAIListKind, FolioAIListNumbering, FolioAIListReference, FolioAINewListReference, FolioAIParagraphBlock, FolioAIParagraphIndentation, FolioAIParagraphSpacing, FolioAIResolvedEditOperation, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult };
+//#endregion

package/dist/ai-edits/word-diff.d.ts

@@ -45,7 +45,7 @@
  * is spent, a gap is a single `del` + `ins` pair. A standalone call owns one
  * fresh scope.
  */
-type WordDiffSegment = {
+export type WordDiffSegment = {
   type: "equal" | "del" | "ins";
   text: string;
 };
@@ -55,8 +55,8 @@ type WordDiffSegment = {
  * word, which reads well for a reference number or a date and badly for a
  * sentence.
  */
-declare const WORD_DIFF_GRANULARITIES: readonly ["word", "character"];
-type WordDiffGranularity = (typeof WORD_DIFF_GRANULARITIES)[number];
+export declare const WORD_DIFF_GRANULARITIES: readonly ["word", "character"];
+export type WordDiffGranularity = (typeof WORD_DIFF_GRANULARITIES)[number];
 /**
  * Differences the caller does not want marked.
  *
@@ -65,33 +65,32 @@ type WordDiffGranularity = (typeof WORD_DIFF_GRANULARITIES)[number];
  * reconstructs only up to the normalization. A caller that must reproduce the
  * after string — anything generating tracked changes — leaves both off.
  */
-type WordDiffNormalization = {
+export type WordDiffNormalization = {
   /** `"Shall"` and `"shall"` are the same token. */
   case?: boolean;
   /** Whitespace around and inside a token does not distinguish it. */
   whitespace?: boolean;
 };
-type WordDiffOptions = {
+export type WordDiffOptions = {
   /** Default `"word"`. */
   granularity?: WordDiffGranularity;
   /** Default: nothing normalized, so both strings reconstruct exactly. */
   normalization?: WordDiffNormalization;
 };
 /** Keep token storage bounded when a run has an unusually long punctuation edge. */
-declare const MAX_EDGE_PUNCTUATION_TOKENS = 64;
-declare const tokenizeWords: (value: string) => string[];
+export declare const MAX_EDGE_PUNCTUATION_TOKENS = 64;
+export declare const tokenizeWords: (value: string) => string[];
 /**
  * One internal comparison/apply scope. Every diff shares the same quadratic
  * allowance; public standalone calls below still receive a fresh allowance.
  * Not re-exported from a package entry point.
  */
-declare const createWordDiffSession: (options?: WordDiffOptions) => {
+export declare const createWordDiffSession: (options?: WordDiffOptions) => {
   diff: (before: string, after: string) => WordDiffSegment[];
 };
 /** Attach one internal work scope without widening a caller-facing option type. */
-declare const createScopedWordDiffOptions: <Options extends WordDiffOptions>(options: Options) => Options;
+export declare const createScopedWordDiffOptions: <Options extends WordDiffOptions>(options: Options) => Options;
 /** Reuse an internal scope when present; ordinary public callers get a fresh one. */
-declare const wordDiffSessionFromOptions: (options: WordDiffOptions | undefined) => ReturnType<typeof createWordDiffSession>;
-declare const diffWordSegments: (before: string, after: string, options?: WordDiffOptions) => WordDiffSegment[];
-//#endregion
-export { MAX_EDGE_PUNCTUATION_TOKENS, WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, createScopedWordDiffOptions, createWordDiffSession, diffWordSegments, tokenizeWords, wordDiffSessionFromOptions };
+export declare const wordDiffSessionFromOptions: (options: WordDiffOptions | undefined) => ReturnType<typeof createWordDiffSession>;
+export declare const diffWordSegments: (before: string, after: string, options?: WordDiffOptions) => WordDiffSegment[];
+//#endregion

package/dist/ai-edits/word-diff.js

@@ -1007,27 +1007,29 @@ const diffWordSegmentsWithBudget = (before, after, options, budget) => {
 	});
 	let surviving = demoteRejectedMatches(aligned.runs);
 	const monotoneDirection = aligned.monotoneDirection;
-	if (monotoneDirection !== null && hasOppositeChange(surviving, monotoneDirection)) if (beforeTokens.length + afterTokens.length <= MAX_WORD_DIFF_ANCHOR_TOKENS && before.length + after.length <= MAX_WORD_DIFF_COMPARISON_KEY_CODE_UNITS && fitsCellBudget(beforeTokens.length, afterTokens.length, budget)) {
-		const unanchored = [];
-		alignDenseGap({
-			before: beforeTokens,
-			after: afterTokens,
-			beforeKeys: beforeTokens.map((token) => comparisonKey(token, normalization)),
-			afterKeys: afterTokens.map((token) => comparisonKey(token, normalization)),
-			beforeRange: {
-				start: 0,
-				end: beforeTokens.length
-			},
-			afterRange: {
-				start: 0,
-				end: afterTokens.length
-			},
-			runs: unanchored,
-			budget,
-			weighting
-		});
-		surviving = hasOppositeChange(unanchored, monotoneDirection) ? alignMonotoneChange(before, after, beforeTokens, afterTokens, normalization, monotoneDirection) : unanchored;
-	} else surviving = hasOppositeChange(aligned.runs, monotoneDirection) ? alignMonotoneChange(before, after, beforeTokens, afterTokens, normalization, monotoneDirection) : aligned.runs;
+	if (monotoneDirection !== null && hasOppositeChange(surviving, monotoneDirection)) {
+		if (beforeTokens.length + afterTokens.length <= MAX_WORD_DIFF_ANCHOR_TOKENS && before.length + after.length <= MAX_WORD_DIFF_COMPARISON_KEY_CODE_UNITS && fitsCellBudget(beforeTokens.length, afterTokens.length, budget)) {
+			const unanchored = [];
+			alignDenseGap({
+				before: beforeTokens,
+				after: afterTokens,
+				beforeKeys: beforeTokens.map((token) => comparisonKey(token, normalization)),
+				afterKeys: afterTokens.map((token) => comparisonKey(token, normalization)),
+				beforeRange: {
+					start: 0,
+					end: beforeTokens.length
+				},
+				afterRange: {
+					start: 0,
+					end: afterTokens.length
+				},
+				runs: unanchored,
+				budget,
+				weighting
+			});
+			surviving = hasOppositeChange(unanchored, monotoneDirection) ? alignMonotoneChange(before, after, beforeTokens, afterTokens, normalization, monotoneDirection) : unanchored;
+		} else surviving = hasOppositeChange(aligned.runs, monotoneDirection) ? alignMonotoneChange(before, after, beforeTokens, afterTokens, normalization, monotoneDirection) : aligned.runs;
+	}
 	if (aligned.monotoneDirection === null && surviving.some(isContentChange) && isTooFragmented(surviving, (before.length + after.length) / 2)) return wholeStringReplacement(before, after);
 	let marked = whitespaceIsSignificant ? separateWhitespaceChanges(surviving) : surviving;
 	if (monotoneDirection !== null && hasOppositeChange(marked, monotoneDirection)) {

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

@@ -1,7 +1,7 @@
 import { AISuggestion, AISuggestionApplyMode } from "./types.js";
 import { EditorView } from "prosemirror-view";
 //#region src/ai-suggestions/apply.d.ts
-type ApplyResult = {
+export type ApplyResult = {
   applied: string[];
   stale: string[];
 };
@@ -11,6 +11,6 @@ type ApplyOptions = {
   mode: AISuggestionApplyMode;
   author: string;
 };
-declare function applySuggestions(options: ApplyOptions): ApplyResult;
+export declare function applySuggestions(options: ApplyOptions): ApplyResult;
 //#endregion
-export { ApplyResult, applySuggestions };
+export {};

package/dist/ai-suggestions/apply.js

@@ -2,18 +2,6 @@ import { addTrackedDeletionMark } from "../prosemirror/addTrackedDeletionMark.js
 import { mintRevisionId, seedRevisionIdsFromDoc } from "../prosemirror/plugins/revisionIds.js";
 import { resolveSuggestionAnchor } from "./conflict.js";
 //#region src/ai-suggestions/apply.ts
-/**
-* Apply AI suggestions to the document.
-*
-* Two modes:
-*  - "direct": replace text in place.
-*  - "tracked-changes": insertion + deletion marks, attributed to the
-*    configured author. Reuses the editor's existing tracked-change
-*    schema and resolution commands.
-*
-* Apply is always preceded by anchor resolution; stale suggestions are
-* skipped and reported back to the caller.
-*/
 function applySuggestions(options) {
 	const { view, suggestions, mode, author } = options;
 	const applied = [];

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

@@ -1,7 +1,7 @@
 import { AISuggestion } from "./types.js";
 import { Node } from "prosemirror-model";
 //#region src/ai-suggestions/conflict.d.ts
-type ResolvedAnchor = {
+export type ResolvedAnchor = {
   from: number;
   to: number;
 };
@@ -15,7 +15,6 @@ type ResolvedAnchor = {
  * 3. If the match is missing or ambiguous, return null — the caller
  *    treats null as a stale suggestion.
  */
-declare function resolveSuggestionAnchor(doc: Node, suggestion: AISuggestion): ResolvedAnchor | null;
-declare function isSuggestionStale(doc: Node, suggestion: AISuggestion): boolean;
-//#endregion
-export { ResolvedAnchor, isSuggestionStale, resolveSuggestionAnchor };
+export declare function resolveSuggestionAnchor(doc: Node, suggestion: AISuggestion): ResolvedAnchor | null;
+export declare function isSuggestionStale(doc: Node, suggestion: AISuggestion): boolean;
+//#endregion

package/dist/ai-suggestions/conflict.js

@@ -20,7 +20,9 @@ function resolveSuggestionAnchor(doc, suggestion) {
 			to
 		};
 	}
-	const positional = buildPositionalText(doc, Math.max(0, from - ANCHOR_SEARCH_WINDOW_PM), Math.min(docSize, to + ANCHOR_SEARCH_WINDOW_PM));
+	const windowStart = Math.max(0, from - ANCHOR_SEARCH_WINDOW_PM);
+	const windowEnd = Math.min(docSize, to + ANCHOR_SEARCH_WINDOW_PM);
+	const positional = buildPositionalText(doc, windowStart, windowEnd);
 	const needles = [
 		{
 			needle: suggestion.contextBefore + suggestion.originalText + suggestion.contextAfter,