@stll/folio-core 0.62.0 → 0.63.1

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,

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

@@ -1,6 +1,6 @@
 import { Node } from "prosemirror-model";
 //#region src/ai-suggestions/text-positions.d.ts
-type PositionalText = {
+export type PositionalText = {
   /** Concatenated text content, with `\n` between block nodes. */
   text: string;
   /**
@@ -24,6 +24,5 @@ type PositionalText = {
  * lookup. The walk skips past block boundaries, inserting a
  * separator character so consumers can identify line breaks.
  */
-declare function buildPositionalText(doc: Node, from?: number, to?: number): PositionalText;
-//#endregion
-export { PositionalText, buildPositionalText };
+export declare function buildPositionalText(doc: Node, from?: number, to?: number): PositionalText;
+//#endregion

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

@@ -6,9 +6,9 @@
  * They sit in a separate queue, render as non-mutating decorations,
  * and only become document changes when the user accepts them.
  */
-type AISuggestionSeverity = "typo" | "style" | "substantive";
-type AISuggestionStatus = "pending" | "accepted" | "rejected" | "stale";
-type AISuggestionApplyMode = "direct" | "tracked-changes";
+export type AISuggestionSeverity = "typo" | "style" | "substantive";
+export type AISuggestionStatus = "pending" | "accepted" | "rejected" | "stale";
+export type AISuggestionApplyMode = "direct" | "tracked-changes";
 /**
  * A single AI suggestion sitting in the review queue.
  *
@@ -17,7 +17,7 @@ type AISuggestionApplyMode = "direct" | "tracked-changes";
  * used to detect staleness if the document is edited between generation
  * and apply.
  */
-type AISuggestion = {
+export type AISuggestion = {
   id: string;
   topic: string;
   severity: AISuggestionSeverity;
@@ -51,11 +51,11 @@ type AISuggestion = {
  * generator. The model decides what to do; mode just tells it
  * what kind of response the user wants.
  */
-type AIChatMode = "ask" | "edit";
+export type AIChatMode = "ask" | "edit";
 /**
  * Input passed to the host's generate function.
  */
-type AIGenerateInput = {
+export type AIGenerateInput = {
   /**
    * Free-form instruction the user typed into the bar (or the prompt
    * text of the preset they picked). Empty string means "general
@@ -112,7 +112,7 @@ type AIGenerateInput = {
  * the prompt text that will be sent to the generator, and the
  * conversation mode the prompt is naturally meant for.
  */
-type AISuggestionPreset = {
+export type AISuggestionPreset = {
   id: string;
   /** Short label shown in the dropdown (e.g., "Catch typos"). */
   label: string;
@@ -139,7 +139,7 @@ type AISuggestionPreset = {
  * import the API type directly to avoid a folio→api package edge
  * for what is universally a PDF bbox shape.
  */
-type AICitationSource = {
+export type AICitationSource = {
   kind: "folio-range";
   /** ProseMirror positions in the live document. */
   from: number;
@@ -152,7 +152,7 @@ type AICitationSource = {
   xMax: number;
   yMax: number;
 };
-type AICitation = {
+export 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.). */
@@ -165,11 +165,11 @@ type AICitation = {
 /**
  * Bar status, surfaced by Folio to the user.
  */
-type AIBarStatus = "idle" | "generating" | "review-ready" | "applying" | "error";
+export type AIBarStatus = "idle" | "generating" | "review-ready" | "applying" | "error";
 /**
  * Configuration for the AI suggestions feature.
  */
-type AISuggestionsConfig = {
+export type AISuggestionsConfig = {
   /**
    * Called when the user requests new suggestions. Returns the suggestions
    * to be queued for review. Folio handles all UI state, conflict
@@ -208,6 +208,5 @@ type AISuggestionsConfig = {
  * with the mode it's naturally meant for; picking the preset flips
  * the bar to that mode.
  */
-declare const DEFAULT_AI_SUGGESTION_PRESETS: AISuggestionPreset[];
-//#endregion
-export { AIBarStatus, AIChatMode, AICitation, AICitationSource, AIGenerateInput, AISuggestion, AISuggestionApplyMode, AISuggestionPreset, AISuggestionSeverity, AISuggestionStatus, AISuggestionsConfig, DEFAULT_AI_SUGGESTION_PRESETS };
+export declare const DEFAULT_AI_SUGGESTION_PRESETS: AISuggestionPreset[];
+//#endregion

package/dist/compare/column-alignment.d.ts

@@ -1,6 +1,6 @@
 import { FolioContentBlock, FolioContentBlockIdentity, FolioContentTableLocation } from "./content-types.js";
 //#region src/compare/column-alignment.d.ts
-type TableColumnAlignmentStep<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
+export type TableColumnAlignmentStep<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
   type: "baseColumn";
   blocks: readonly Block[];
   location: FolioContentTableLocation;
@@ -15,13 +15,12 @@ type TableColumnAlignmentStep<Block extends FolioContentBlockIdentity = FolioCon
     position: "after" | "before";
   };
 };
-type TableColumnAlignment<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
+export type TableColumnAlignment<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
   steps: TableColumnAlignmentStep<Block>[];
   baseBlocks: Block[];
   revisedBlocks: Block[];
   baseColumnKeys: ReadonlyMap<number, number>;
   revisedColumnKeys: ReadonlyMap<number, number>;
 };
-declare const alignTableColumns: <Block extends FolioContentBlockIdentity>(baseBlocks: readonly Block[], revisedBlocks: readonly Block[]) => TableColumnAlignment<Block> | null;
-//#endregion
-export { TableColumnAlignment, TableColumnAlignmentStep, alignTableColumns };
+export declare const alignTableColumns: <Block extends FolioContentBlockIdentity>(baseBlocks: readonly Block[], revisedBlocks: readonly Block[]) => TableColumnAlignment<Block> | null;
+//#endregion