@stll/folio-core 0.63.1 → 0.64.1

package/dist/_virtual/_rolldown/runtime.js

@@ -1,4 +1,4 @@
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -9,5 +9,4 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
-//#endregion
 export { __exportAll };

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

@@ -3,7 +3,6 @@ import { FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, Fol
 import { WordDiffGranularity } from "./word-diff.js";
 import { Node } from "prosemirror-model";
 import { EditorState, Transaction } from "prosemirror-state";
-//#region src/ai-edits/apply.d.ts
 /**
  * The only editor surface the apply logic touches: a current `state`
  * and a `dispatch` that swaps in the next one. A live `EditorView`
@@ -157,5 +156,4 @@ type InsertedCleanText = {
   end: number;
 };
 export declare const insertCleanText: ({ tr, from, to, text, standsInFor, keepsReplacedText }: InsertCleanTextOptions) => InsertedCleanText;
-//#endregion
 export {};

package/dist/ai-edits/apply.js

@@ -60,7 +60,7 @@ import { Fragment, Mark } from "prosemirror-model";
 import { TableMap } from "prosemirror-tables";
 import { canSplit } from "prosemirror-transform";
 import { contentRank, groupInsertionRuns, orderBatchOperations } from "@stll/docx-core/ops";
-//#region src/ai-edits/apply.ts
+// src/ai-edits/apply.ts
 const coarseWordDiff = (before, after) => {
 	if (before === after) return before.length === 0 ? [] : [{
 		type: "equal",
@@ -5925,5 +5925,4 @@ const getOperationQuote = (operation) => {
 	if (operation.type === "replaceInBlock") return operation.find;
 	if (operation.type === "commentOnBlock") return operation.quote;
 };
-//#endregion
 export { applyFolioAIEditOperations, insertCleanText, previewFolioAIEditOperations, previewFolioAIEditOperationsWithResult };

package/dist/ai-edits/batch-claims.d.ts

@@ -1,4 +1,3 @@
-//#region src/ai-edits/batch-claims.d.ts
 /**
  * Which operations of one batch may not share their targets.
  *
@@ -152,5 +151,4 @@ export declare class BatchClaims {
   private claimedInside;
   add(operationId: string, claim: BatchClaim): void;
 }
-//#endregion
 export {};

package/dist/ai-edits/batch-claims.js

@@ -1,4 +1,4 @@
-//#region src/ai-edits/batch-claims.ts
+// src/ai-edits/batch-claims.ts
 /**
 * Which operations of one batch may not share their targets.
 *
@@ -295,5 +295,4 @@ var BatchClaims = class {
 		}
 	}
 };
-//#endregion
 export { BatchClaims, compareBatchTieOrder };

package/dist/ai-edits/block-identity.d.ts

@@ -1,6 +1,4 @@
 import { FolioAIBlock } from "./types.js";
-//#region src/ai-edits/block-identity.d.ts
 /** Resolve explicit snapshot provenance, falling back to the legacy id-shape convention. */
 export declare const folioAIBlockIdStability: ({ id, idStability }: FolioAIBlock) => "stable" | "positional";
-export declare const stripBlockIdentityAttrs: (attrs: Record<string, unknown>) => Record<string, unknown>;
-//#endregion
+export declare const stripBlockIdentityAttrs: (attrs: Record<string, unknown>) => Record<string, unknown>;

package/dist/ai-edits/block-identity.js

@@ -1,5 +1,5 @@
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
-//#region src/ai-edits/block-identity.ts
+// src/ai-edits/block-identity.ts
 /**
 * What a paragraph's copy must not claim: its ids, what its source authored
 * once (the editing sessions its `w:rsid*` attributes name, its bookmark
@@ -22,5 +22,4 @@ const stripBlockIdentityAttrs = (attrs) => {
 	for (const [key, value] of Object.entries(attrs)) next[key] = IDENTITY_BLOCK_ATTRS.has(key) ? null : value;
 	return next;
 };
-//#endregion
 export { folioAIBlockIdStability, stripBlockIdentityAttrs };

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

@@ -1,6 +1,5 @@
 import { FolioAIBlockAnchor, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./types.js";
 import { Node } from "prosemirror-model";
-//#region src/ai-edits/blockRange.d.ts
 export type DocPositionRange = {
   from: number;
   to: number;
@@ -72,5 +71,4 @@ export declare const resolveSequentialBlockAnchor: (blockId: string, snapshot: F
  * `from` may equal `to`, yielding a cursor selection at the doc end.
  */
 export declare function clampRangeToDocSize(docSize: number, range: DocPositionRange): DocPositionRange;
-//#endregion
 export {};

package/dist/ai-edits/blockRange.js

@@ -2,7 +2,7 @@ import { findParagraphByParaId } from "../prosemirror/utils/findParagraphByParaI
 import { getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex } from "../types/block-id.js";
 import { buildCleanBlockText, resolveCleanTextRange } from "./clean-text.js";
 import { collectNoteReferenceLabels, createFolioAIEditSnapshot, hashFolioAIBlockText, isFolioAIContentBlock } from "./snapshot.js";
-//#region src/ai-edits/blockRange.ts
+// src/ai-edits/blockRange.ts
 const resolveFolioAIBlockRange = ({ blockId, doc, snapshot }) => {
 	const paraId = getFolioParaIdFromBlockId(blockId);
 	if (paraId !== null) {
@@ -156,5 +156,4 @@ function clampRangeToDocSize(docSize, range) {
 		to: Math.min(Math.max(range.to, 0), docSize)
 	};
 }
-//#endregion
 export { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange, resolveSequentialBlockAnchor };

package/dist/ai-edits/character-boundaries.d.ts

@@ -1,4 +1,3 @@
-//#region src/ai-edits/character-boundaries.d.ts
 /**
  * Where an offset into a block's clean text may fall.
  *
@@ -38,5 +37,4 @@ export type CharacterBoundaryStrictness =
  * Why `offsets` do not all stand on a character boundary of `text`, naming
  * the first that does not and the character it cuts; `null` when they all do.
  */
-export declare const describeCharacterSplit: (text: string, offsets: readonly number[], strictness: CharacterBoundaryStrictness) => string | null;
-//#endregion
+export declare const describeCharacterSplit: (text: string, offsets: readonly number[], strictness: CharacterBoundaryStrictness) => string | null;

package/dist/ai-edits/character-boundaries.js

@@ -1,4 +1,4 @@
-//#region src/ai-edits/character-boundaries.ts
+// src/ai-edits/character-boundaries.ts
 /**
 * Where an offset into a block's clean text may fall.
 *
@@ -91,5 +91,4 @@ const describeCharacterSplit = (text, offsets, strictness) => {
 	const { start, end } = enclosingCharacter(text, offset);
 	return `offset ${String(offset)} falls inside ${JSON.stringify(text.slice(start, end))}, which spans offsets ${String(start)} to ${String(end)}; use ${String(start)} or ${String(end)}.`;
 };
-//#endregion
 export { describeCharacterSplit, splitsGraphemeCluster, splitsSurrogatePair };

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

@@ -2,7 +2,6 @@ import { PageBreakRunAttrs } from "../prosemirror/schema/nodes.js";
 import { NoteReferenceKind } from "../utils/noteReferenceLabels.js";
 import { NoteReferenceLabels } from "./note-references.js";
 import { Node } from "prosemirror-model";
-//#region src/ai-edits/clean-text.d.ts
 /**
  * "Post-tracked-changes" view of a textblock: the string the user
  * would see if every existing tracked change were accepted.
@@ -134,5 +133,4 @@ export declare const buildAnnotatedBlockText: (blockNode: Node) => string;
  * reference reads as the marker every other reader of the story shows.
  */
 export declare const buildAnnotatedBlockTextWithNoteReferences: (blockNode: Node, noteReferences: NoteReferenceLabels | undefined) => string;
-//#endregion
 export {};

package/dist/ai-edits/clean-text.js

@@ -2,7 +2,7 @@ import { expectPageBreakRunAttrs } from "../prosemirror/attrs/index.js";
 import { runFormattingInlineAtomCleanText, runFormattingInlineControlCharacter } from "../prosemirror/runFormattingInlineCarriers.js";
 import { createNoteReferenceNumbering, noteReferenceMarker } from "../utils/noteReferenceLabels.js";
 import { noteReferenceOf } from "./note-references.js";
-//#region src/ai-edits/clean-text.ts
+// src/ai-edits/clean-text.ts
 const EMPTY_CLEAN_TEXT_STRUCTURAL_BOUNDARIES = Object.freeze([]);
 const cutsIntoSpan = ({ offset, length }, boundaryOffset) => boundaryOffset > offset && boundaryOffset < offset + length;
 /**
@@ -210,5 +210,4 @@ const renderAnnotatedSegment = ({ annotation, text }) => {
 	if (annotation.commentId !== null) inner = `<comment id="${annotation.commentId}">${inner}</comment>`;
 	return inner;
 };
-//#endregion
 export { buildAnnotatedBlockText, buildAnnotatedBlockTextWithNoteReferences, buildCleanBlockText, resolveCleanTextRange };

package/dist/ai-edits/comment-lifecycle.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { Node } from "prosemirror-model";
-//#region src/ai-edits/comment-lifecycle.d.ts
 /** Comment ids anchored by one editor node, regardless of anchor representation. */
 export declare const commentAnchorIdsForNode: (node: Node) => readonly number[];
 /** Whether an inline node only locates a comment rather than being covered content. */
@@ -23,5 +22,4 @@ export declare const anchoredCommentIdsInBlocks: (blocks: readonly document_d_ex
 export declare const withoutLostCommentThreads: (comments: readonly document_d_exports.Comment[], { anchoredBefore, anchoredNow }: {
   anchoredBefore: ReadonlySet<number>;
   anchoredNow: ReadonlySet<number>;
-}) => document_d_exports.Comment[];
-//#endregion
+}) => document_d_exports.Comment[];

package/dist/ai-edits/comment-lifecycle.js

@@ -6,7 +6,7 @@ import "../prosemirror/extensions/nodes/CommentRangeBoundaryExtension.js";
 import "../prosemirror/extensions/nodes/RangeAnchorExtension.js";
 import { readRangeAnchorAttrs } from "../prosemirror/rangeAnchorAttrs.js";
 import { isCommentAnchorCarrierType, withoutCommentThreads } from "@stll/docx-core/ops";
-//#region src/ai-edits/comment-lifecycle.ts
+// src/ai-edits/comment-lifecycle.ts
 /** Comment ids anchored by one editor node, regardless of anchor representation. */
 const commentAnchorIdsForNode = (node) => {
 	const ids = [];
@@ -99,5 +99,4 @@ const withoutLostCommentThreads = (comments, { anchoredBefore, anchoredNow }) =>
 	for (const comment of comments) if (comment.parentId === void 0 && anchoredBefore.has(comment.id) && !anchoredNow.has(comment.id)) droppedRootIds.add(comment.id);
 	return withoutCommentThreads(comments, droppedRootIds);
 };
-//#endregion
 export { anchoredCommentIdsInBlocks, anchoredCommentIdsInProseDoc, commentAnchorIdsForNode, coveredCommentIdsInProseDoc, isCommentAnchorCarrier, withoutLostCommentThreads };

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

@@ -12,7 +12,6 @@ import { FolioStoryTable } from "./snapshot.js";
 import { TableGeometryPairing } from "./table-geometry.js";
 import { Node } from "prosemirror-model";
 import { TaggedErrorClass } from "better-result";
-//#region src/ai-edits/headless.d.ts
 /** Options for {@link FolioDocxReviewer.fromBuffer}. */
 export type FolioDocxReviewerOptions = {
   /** Default author for tracked changes and comments. (default: `"AI"`) */
@@ -706,5 +705,4 @@ export type ApplyFolioAIEditsToBufferResult = FolioAIEditApplyResult & {
  * operations to run.
  */
 export declare const applyFolioAIEditsToBuffer: (buffer: ArrayBuffer, operations: FolioAIEditOperation[], options?: ApplyFolioAIEditsToBufferOptions) => Promise<ApplyFolioAIEditsToBufferResult>;
-//#endregion
 export type { FolioReviewChange, FolioReviewChangeKind, FolioRevisionStamp };

package/dist/ai-edits/headless.js

@@ -57,7 +57,7 @@ import { REVIEW_CARRIERS, finalizeParagraphFormatting, numberingLevelEntries, se
 import { reconcileDocumentPartRelationships } from "@stll/docx-core/ops";
 import { EditorState } from "prosemirror-state";
 import JSZip from "jszip";
-//#region src/ai-edits/headless.ts
+// src/ai-edits/headless.ts
 /**
 * Headless `.docx` review path: buffer -> apply AI edits -> buffer, with
 * no `EditorView` and no DOM. A queue worker or agent can read a document,
@@ -2288,5 +2288,4 @@ const applyFolioAIEditsToBuffer = async (buffer, operations, options = {}) => {
 		skipped
 	};
 };
-//#endregion
 export { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, FolioDocxReviewer, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, getFolioDocxComparisonAccess, isFolioResolvedReviewedView, isFolioReviewedView };

package/dist/ai-edits/inline-emphasis.d.ts

@@ -1,4 +1,3 @@
-//#region src/ai-edits/inline-emphasis.d.ts
 /**
  * Turn the bold / bold-italic markdown the chat model sometimes emits inside
  * inserted or replaced block text ("**Date:**", "***Term***") into structured
@@ -33,5 +32,4 @@ export declare const hasInlineEmphasis: (input: string) => boolean;
  * input verbatim when no real span is present, so plain prose (and stray
  * single `*` / escaped `\*`) is never reshaped.
  */
-export declare const stripInlineEmphasisMarkers: (input: string) => string;
-//#endregion
+export declare const stripInlineEmphasisMarkers: (input: string) => string;

package/dist/ai-edits/inline-emphasis.js

@@ -1,4 +1,4 @@
-//#region src/ai-edits/inline-emphasis.ts
+// src/ai-edits/inline-emphasis.ts
 const MARKERS = [{
 	marker: "***",
 	bold: true,
@@ -74,5 +74,4 @@ const stripInlineEmphasisMarkers = (input) => {
 	if (!hasEmphasis(runs)) return input;
 	return runs.map((run) => run.text).join("");
 };
-//#endregion
 export { hasInlineEmphasis, parseInlineEmphasisRuns, stripInlineEmphasisMarkers };

package/dist/ai-edits/minimal-replacement.d.ts

@@ -1,5 +1,4 @@
 import { WordDiffSegment } from "./word-diff.js";
-//#region src/ai-edits/minimal-replacement.d.ts
 /** Replace `source.slice(start, end)` with `text`; offsets index the source span. */
 export type TextChange = {
   start: number;
@@ -74,5 +73,4 @@ export declare const widenChangesToAtomicSpans: (source: string, changes: readon
  */
 export declare const keepAtomicSpans: (source: string, replacement: string, changes: readonly TextChange[], kept: readonly TextChange[], spans: readonly AtomicTextSpan[]) => TextChange[];
 /** `source` with `changes` applied; the invariant the planner owes. */
-export declare const applyTextChanges: (source: string, changes: readonly TextChange[]) => string;
-//#endregion
+export declare const applyTextChanges: (source: string, changes: readonly TextChange[]) => string;

package/dist/ai-edits/minimal-replacement.js

@@ -1,5 +1,5 @@
 import { tokenizeWords } from "./word-diff.js";
-//#region src/ai-edits/minimal-replacement.ts
+// src/ai-edits/minimal-replacement.ts
 /**
 * The smallest set of text changes that turns one clean-text span into another.
 *
@@ -397,5 +397,4 @@ const applyTextChanges = (source, changes) => {
 	}
 	return result + source.slice(cursor);
 };
-//#endregion
 export { MAX_TOKEN_EDITS, applyTextChanges, changesFromSegments, commonPrefixLength, commonSuffixLength, keepAtomicSpans, planTextChanges, shortestTokenDiff, widenChangesToAtomicSpans };

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

@@ -2,7 +2,6 @@ import { FolioContentStatedNumbering } from "../compare/content-types.js";
 import { ListKind } from "../docx/listNumberingInstances.js";
 import { FolioAIEditOperation, FolioAIListNumbering, FolioAINewListReference, FolioAIResolvedEditOperation } from "./types.js";
 import { NumberingMap } from "../docx/numberingParser.js";
-//#region src/ai-edits/newListNumbering.d.ts
 /** Whether `numbering` asks for a new list rather than naming an instance. */
 export declare const isFolioAINewListReference: (numbering: FolioAIListNumbering) => numbering is FolioAINewListReference;
 type ResolvedNewLists = {
@@ -26,5 +25,4 @@ export declare const stageNewListOperations: (operations: readonly FolioAIEditOp
  * the batch applies against; the result's map adds the minted instances.
  */
 export declare const resolveNewListOperations: (operations: readonly FolioAIStagedEditOperation[], numbering: NumberingMap | null) => ResolvedNewLists;
-//#endregion
 export {};

package/dist/ai-edits/newListNumbering.js

@@ -2,7 +2,7 @@ import { mintListInstance } from "../docx/listNumberingInstances.js";
 import { createNumberingMap } from "../docx/numberingParser.js";
 import { paragraphNumberingReference } from "../docx/numberingReference.js";
 import { panic } from "better-result";
-//#region src/ai-edits/newListNumbering.ts
+// src/ai-edits/newListNumbering.ts
 /** Whether `numbering` asks for a new list rather than naming an instance. */
 const isFolioAINewListReference = (numbering) => numbering.kind === "newList";
 const operationNumbering = (operation) => {
@@ -148,5 +148,4 @@ const resolveNewListOperations = (operations, numbering) => {
 		numbering: minted && definitions ? createNumberingMap(definitions) : numbering
 	};
 };
-//#endregion
 export { assertNewListsAllocated, isFolioAINewListReference, resolveNewListOperations, stageNewListOperations };

package/dist/ai-edits/note-references.d.ts

@@ -2,7 +2,6 @@ import { NoteReferenceKind } from "../utils/noteReferenceLabels.js";
 import { TextChange } from "./minimal-replacement.js";
 import { CleanBlockText } from "./clean-text.js";
 import { Node } from "prosemirror-model";
-//#region src/ai-edits/note-references.d.ts
 /** Which note a reference names: its kind and its package id. */
 export type NoteReferenceIdentity = {
   noteType: NoteReferenceKind;
@@ -92,5 +91,4 @@ export declare const segmentsAroundNoteReferences: (source: string, replacement:
  * keep them (see {@link segmentsAroundNoteReferences}).
  */
 export declare const planChangesAroundNoteReferences: (source: string, replacement: string, spans: readonly NoteReferenceSpan[], planChanges: (source: string, replacement: string) => readonly TextChange[]) => TextChange[] | null;
-//#endregion
 export {};

package/dist/ai-edits/note-references.js

@@ -1,5 +1,5 @@
 import { createNoteReferenceNumbering, noteReferenceMarker } from "../utils/noteReferenceLabels.js";
-//#region src/ai-edits/note-references.ts
+// src/ai-edits/note-references.ts
 const NOTE_REFERENCE_MARK = "footnoteRef";
 const DELETION_MARK = "deletion";
 const HIDDEN_MARK = "hidden";
@@ -135,5 +135,4 @@ const planChangesAroundNoteReferences = (source, replacement, spans, planChanges
 		text: change.text
 	})));
 };
-//#endregion
 export { createNoteReferenceLabeler, cutsIntoNoteReference, noteReferenceEditsAllowed, noteReferenceOf, noteReferenceSpansWithin, planChangesAroundNoteReferences, readerTextOf, segmentsAroundNoteReferences, withComparisonNoteReferenceEdits };

package/dist/ai-edits/note-story-inventory.d.ts

@@ -1,7 +1,5 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/ai-edits/note-story-inventory.d.ts
 type NoteStories = Pick<document_d_exports.Document["package"], "footnotes" | "endnotes">;
 /** The note collections visible to a reviewer or its captured save state. */
 export declare const noteStoryInventory: (source: NoteStories, removed: Pick<ReadonlySet<string>, "has" | "size">) => NoteStories;
-//#endregion
 export {};

package/dist/ai-edits/note-story-inventory.js

@@ -1,4 +1,4 @@
-//#region src/ai-edits/note-story-inventory.ts
+// src/ai-edits/note-story-inventory.ts
 /** The note collections visible to a reviewer or its captured save state. */
 const noteStoryInventory = (source, removed) => {
 	if (removed.size === 0) return source;
@@ -7,5 +7,4 @@ const noteStoryInventory = (source, removed) => {
 		...source.endnotes && { endnotes: source.endnotes.filter((note) => !removed.has(`endnote:${note.id}`)) }
 	};
 };
-//#endregion
 export { noteStoryInventory };

package/dist/ai-edits/pending-suggestions.d.ts

@@ -1,7 +1,6 @@
 import { FolioAIEditAppliedOperation, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditSnapshot } from "./types.js";
 import { FolioDocumentStoryHandle } from "./headless.js";
 import { EditorState } from "prosemirror-state";
-//#region src/ai-edits/pending-suggestions.d.ts
 export declare const FOLIO_PENDING_SUGGESTION_VERSION: 1;
 /** A host-owned, JSON-serializable proposal. It is never written into the DOCX. */
 export type FolioPendingSuggestionRecord = {
@@ -75,5 +74,4 @@ export declare class FolioPendingSuggestionRegistry {
   exportPendingSuggestions({ activeSuggestionIds, snapshotForStory }: ExportPendingSuggestionsOptions): FolioPendingSuggestionRecord[];
   loadPendingSuggestions({ records, snapshotForStory, sourceSnapshotForStory, apply, activeSuggestionIds }: LoadPendingSuggestionsOptions): FolioPendingSuggestionLoadResult[];
 }
-//#endregion
 export {};

package/dist/ai-edits/pending-suggestions.js

@@ -4,7 +4,7 @@ import { getDocumentStyleResolver } from "../prosemirror/plugins/documentStyleSt
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
 import { createFolioAIEditSnapshotWithStyleResolver, hashFolioAIBlockText, sourceDocumentOf } from "./snapshot.js";
-//#region src/ai-edits/pending-suggestions.ts
+// src/ai-edits/pending-suggestions.ts
 const FOLIO_PENDING_SUGGESTION_VERSION = 1;
 /** Drop only comments attached to proposals that have not been accepted. */
 const withoutPendingSuggestionCommentMarks = (state, commentIds) => {
@@ -306,5 +306,4 @@ var FolioPendingSuggestionRegistry = class {
 		});
 	}
 };
-//#endregion
 export { FOLIO_PENDING_SUGGESTION_VERSION, FolioPendingSuggestionRegistry, createPendingSuggestionSourceSnapshot, withoutPendingSuggestionCommentMarks };

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

@@ -1,7 +1,6 @@
 import { FolioAIEditSnapshot } from "./types.js";
 import { FolioNodeRevisionKind } from "../prosemirror/revisionCarriers.js";
 import { Node } from "prosemirror-model";
-//#region src/ai-edits/read.d.ts
 export type FolioReviewChangeKind = "insertion" | "deletion" | "formatting" | "rowInserted" | "rowDeleted" | "cellInserted" | "cellDeleted" | "cellMerged" | FolioNodeRevisionKind;
 /**
  * Runtime census of every tracked-change discriminator the reviewer exposes.
@@ -83,5 +82,4 @@ export declare const getTrackedChangeStatsFromDoc: (doc: Node) => {
  * editor renders. Each entry carries the anchored text and containing block id;
  * ranges for one comment id within the body fold into a single anchor.
  */
-export declare const getCommentAnchorsFromDoc: (doc: Node) => FolioCommentAnchor[];
-//#endregion
+export declare const getCommentAnchorsFromDoc: (doc: Node) => FolioCommentAnchor[];

package/dist/ai-edits/read.js

@@ -6,7 +6,7 @@ import { enclosingInsertionAncestors, trackedRevisionLayerOf } from "../prosemir
 import { commentAnchorIdsForNode } from "./comment-lifecycle.js";
 import { readerTextOf } from "./note-references.js";
 import { collectNoteReferenceLabels, createFolioAIEditSnapshot, sourceDocumentOf } from "./snapshot.js";
-//#region src/ai-edits/read.ts
+// src/ai-edits/read.ts
 /**
 * Runtime census of every tracked-change discriminator the reviewer exposes.
 *
@@ -380,5 +380,4 @@ const getCommentAnchorsFromDoc = (doc) => {
 		quote: bodyText.slice(start, end)
 	}));
 };
-//#endregion
 export { FOLIO_REVIEW_CHANGE_KINDS, getCommentAnchorsFromDoc, getTrackedChangeGroupIdsFromDoc, getTrackedChangeStatsFromDoc, getTrackedChangesFromDoc, getTrackedChangesFromSnapshot };

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

@@ -1,4 +1,3 @@
-//#region src/ai-edits/referenceClassification.d.ts
 type ResourceReferenceClassificationOptions = {
   kind: "style";
   id: string;
@@ -18,5 +17,4 @@ declare const REFERENCE_DISPOSITIONS: {
 type ReferenceDisposition = (typeof REFERENCE_DISPOSITIONS)[keyof typeof REFERENCE_DISPOSITIONS];
 /** A missing source reference may stay dangling, but cannot acquire destination meaning. */
 export declare const classifyResourceReference: (reference: ResourceReferenceClassificationOptions) => ReferenceDisposition;
-//#endregion
 export {};

package/dist/ai-edits/referenceClassification.js

@@ -1,5 +1,5 @@
 import { panic } from "better-result";
-//#region src/ai-edits/referenceClassification.ts
+// src/ai-edits/referenceClassification.ts
 const REFERENCE_DISPOSITIONS = {
 	sourceDefined: "sourceDefined",
 	destinationCollision: "destinationCollision",
@@ -17,5 +17,4 @@ const classifyResourceReference = (reference) => {
 		default: return panic("Unhandled resource reference kind", { reference });
 	}
 };
-//#endregion
 export { classifyResourceReference };

package/dist/ai-edits/removed-blocks.d.ts

@@ -1,6 +1,5 @@
 import { FolioAIBlock } from "./types.js";
 import { FolioDocumentOperation } from "../document-operations.js";
-//#region src/ai-edits/removed-blocks.d.ts
 type BlockIdentity = Pick<FolioAIBlock, "id"> & {
   table?: FolioAIBlock["table"];
 };
@@ -16,5 +15,4 @@ export declare const getTrackedFolioDocumentOperationRemovedBlockIds: (blocks: r
 export declare const getTrackedFolioDocumentOperationCarrierBlockId: (blocks: readonly BlockIdentity[], operation: FolioDocumentOperation, previouslyRemovedBlockIds: {
   has(blockId: string): boolean;
 }) => string | undefined;
-//#endregion
 export {};

package/dist/ai-edits/removed-blocks.js

@@ -1,4 +1,4 @@
-//#region src/ai-edits/removed-blocks.ts
+// src/ai-edits/removed-blocks.ts
 const blockContainerKey = ({ table }) => table === void 0 ? "body" : `${String(table.tableIndex)}:${String(table.rowIndex)}:${String(table.cellIndex)}`;
 const isContainerCarrier = (blocks, anchorIndex) => {
 	const anchor = blocks[anchorIndex];
@@ -65,5 +65,4 @@ const getTrackedFolioDocumentOperationCarrierBlockId = (blocks, operation, previ
 	if (carrier === void 0 || !isContainerCarrier(blocks, carrierIndex)) return void 0;
 	return blocks.slice(anchorIndex + 1, carrierIndex + 1).every(({ id }) => previouslyRemovedBlockIds.has(id)) ? carrier.id : void 0;
 };
-//#endregion
 export { getFolioDocumentOperationRemovedBlockIds, getTrackedFolioDocumentOperationCarrierBlockId, getTrackedFolioDocumentOperationRemovedBlockIds };

package/dist/ai-edits/result-validation.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { Node } from "prosemirror-model";
 import { ValidateDocumentModelIssue } from "@stll/docx-core";
-//#region src/ai-edits/result-validation.d.ts
 /** What the story's package knows that the story itself does not. */
 export type FolioOperationResultValidationContext = {
   /**
@@ -24,5 +23,4 @@ export type FolioOperationResultValidationContext = {
  * when the result is as saveable as the story it started from.
  */
 export declare const findIntroducedModelErrors: (before: Node, after: Node, context: FolioOperationResultValidationContext) => ValidateDocumentModelIssue[];
-export declare const describeModelError: ({ path, message }: ValidateDocumentModelIssue) => string;
-//#endregion
+export declare const describeModelError: ({ path, message }: ValidateDocumentModelIssue) => string;

package/dist/ai-edits/result-validation.js

@@ -3,7 +3,7 @@ import { sectionPropertiesOf } from "../prosemirror/sectionCarrier.js";
 import { anchoredCommentIdsInProseDoc } from "./comment-lifecycle.js";
 import { validateDocumentModel } from "@stll/docx-core";
 import { Fragment } from "prosemirror-model";
-//#region src/ai-edits/result-validation.ts
+// src/ai-edits/result-validation.ts
 /**
 * The check an operation batch's result passes before it is committed.
 *
@@ -161,5 +161,4 @@ const findIntroducedModelErrors = (before, after, context) => {
 	});
 };
 const describeModelError = ({ path, message }) => `The result would not save: ${path}: ${message}`;
-//#endregion
 export { describeModelError, findIntroducedModelErrors };

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

@@ -1,5 +1,4 @@
 import { Transaction } from "prosemirror-state";
-//#region src/ai-edits/revisionStretches.d.ts
 type SeparateRevisionStretchesOptions = {
   tr: Transaction;
   revisionSeed: number;
@@ -13,5 +12,4 @@ export type SeparatedRevisionStretches = {
   }[];
 };
 export declare const separateRevisionStretches: ({ tr, revisionSeed }: SeparateRevisionStretchesOptions) => SeparatedRevisionStretches;
-//#endregion
 export {};

package/dist/ai-edits/revisionStretches.js

@@ -1,7 +1,7 @@
 import { expectRunPropertyChangeMarkAttrs, expectTrackedChangeMarkAttrs } from "../prosemirror/attrs/index.js";
 import { applyMarksToRunFormattingRepresentation, expandRunFormattingCarrier } from "../prosemirror/runFormattingInlineCarriers.js";
 import { panic } from "better-result";
-//#region src/ai-edits/revisionStretches.ts
+// src/ai-edits/revisionStretches.ts
 /**
 * One id per stretch of an inline revision.
 *
@@ -144,5 +144,4 @@ const separateRevisionStretches = ({ tr, revisionSeed }) => {
 		minted
 	};
 };
-//#endregion
 export { separateRevisionStretches };

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

@@ -1,7 +1,5 @@
 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. */
 export declare const getFolioDocumentOutline: (snapshot: FolioAIEditSnapshot) => FolioDocumentOutline;
 /** Resolve one heading section against a fresh snapshot without guessing. */
-export declare const readFolioDocumentSection: (snapshot: FolioAIEditSnapshot, handle: FolioDocumentSectionHandle) => FolioDocumentSectionReadResult;
-//#endregion
+export declare const readFolioDocumentSection: (snapshot: FolioAIEditSnapshot, handle: FolioDocumentSectionHandle) => FolioDocumentSectionReadResult;

package/dist/ai-edits/scoped-reading.js

@@ -1,5 +1,5 @@
 import { isFolioAIContentBlock } from "./snapshot.js";
-//#region src/ai-edits/scoped-reading.ts
+// src/ai-edits/scoped-reading.ts
 const toSectionHandle = (snapshot, headingBlockId, headingLevel) => {
 	const headingTextHash = snapshot.anchors[headingBlockId]?.textHash;
 	if (headingTextHash === void 0) return null;
@@ -57,5 +57,4 @@ const readFolioDocumentSection = (snapshot, handle) => {
 		}
 	};
 };
-//#endregion
 export { getFolioDocumentOutline, readFolioDocumentSection };

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

@@ -4,7 +4,6 @@ import { CleanBlockText } from "./clean-text.js";
 import { NumberingMap } from "../docx/numberingParser.js";
 import { RunStyleResolver } from "../prosemirror/runStyleFormatting.js";
 import { Node } from "prosemirror-model";
-//#region src/ai-edits/snapshot.d.ts
 /** @internal Numbering references collected during the snapshot's document walk. */
 export declare const numberingReferenceKeysOf: (snapshot: FolioAIEditSnapshot) => readonly string[];
 /** @internal Tables collected during the snapshot's document walk. */
@@ -143,5 +142,4 @@ export declare const folioStoryTables: (doc: Node) => FolioStoryTable[];
 export declare const createFolioAIEditSnapshot: (doc: Node) => FolioAIEditSnapshot;
 /** @internal Use for an EditorState that owns the document's style resolver. */
 export declare const createFolioAIEditSnapshotWithStyleResolver: (doc: Node, styleResolver: RunStyleResolver | null, numbering?: NumberingMap | null) => FolioAIEditSnapshot;
-//#endregion
 export {};

package/dist/ai-edits/snapshot.js

@@ -22,7 +22,7 @@ import { createNoteReferenceLabeler } from "./note-references.js";
 import { panic } from "better-result";
 import { Fragment } from "prosemirror-model";
 import { TableMap } from "prosemirror-tables";
-//#region src/ai-edits/snapshot.ts
+// src/ai-edits/snapshot.ts
 const metadataBySnapshot = /* @__PURE__ */ new WeakMap();
 const metadataOf = (snapshot) => metadataBySnapshot.get(snapshot) ?? panic("Metadata was requested for a snapshot that did not record it");
 /** @internal Numbering references collected during the snapshot's document walk. */
@@ -884,5 +884,4 @@ const samePreviewRunStyle = (run, style) => run.bold === style.bold && run.itali
 const isEmptyPreviewRunStyle = ({ bold, italic, underline, strike, fontFamily, fontSizePt, color }) => bold === void 0 && italic === void 0 && underline === void 0 && strike === void 0 && fontFamily === void 0 && fontSizePt === void 0 && color === void 0;
 const sameDirectFormatting = (left, right) => left === void 0 && isEmptyPreviewRunStyle(right) || left !== void 0 && left.bold === right.bold && left.italic === right.italic && left.underline === right.underline && left.strike === right.strike && left.fontFamily === right.fontFamily && left.fontSizePt === right.fontSizePt && left.color === right.color;
 const isUnstyledPreviewRun = ({ directFormatting, ...style }) => isEmptyPreviewRunStyle(style) && (directFormatting === void 0 || isEmptyPreviewRunStyle(directFormatting));
-//#endregion
 export { alignedNoteReferenceLabels, collectNoteReferenceLabels, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, detachFolioAIEditSnapshotExternalHyperlinks, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, relabelFolioAIEditSnapshotNoteReferences, remapFolioAIEditSnapshotNumberingReferences, remapFolioAIEditSnapshotStyleReferences, sourceDocumentOf, storyTablesOf, styleResolverOf, trailingBodyBlockId };

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

@@ -1,7 +1,6 @@
 import { TableRectangle } from "./table-mutation-plan.js";
 import { Node } from "prosemirror-model";
 import { Transaction } from "prosemirror-state";
-//#region src/ai-edits/table-cell-mutations.d.ts
 type TableCellRectangleMutationOptions = {
   tr: Transaction;
   tablePosition: number;
@@ -19,5 +18,4 @@ export declare const splitTableRectangle: ({ tr, tablePosition, table, rectangle
 export declare const splitTrackedVerticalTableCell: ({ tr, tablePosition, table, rectangle, revisionId, author, date }: TrackedTableCellRectangleMutationOptions) => Transaction | null;
 /** A cell holding one empty paragraph: all a tracked merge may fold away. */
 export declare const isEmptyTableCell: (cell: Node) => boolean;
-//#endregion
 export {};