@stll/folio-core 0.62.0 → 0.63.1

package/dist/compare/compare.d.ts

@@ -13,9 +13,9 @@ import { Result } from "better-result";
  * Cap on operations one comparison generates. Both inputs are untrusted
  * documents, and each operation costs a document walk plus revision ids.
  */
-declare const MAX_COMPARE_OPERATIONS = 10000;
+export declare const MAX_COMPARE_OPERATIONS = 10000;
 /** Two stories the comparison will align against one another. */
-type ComparedStoryPair = {
+export type ComparedStoryPair = {
   baseStory: FolioDocumentStoryHandle;
   targetStory: FolioDocumentStoryHandle;
   baseSnapshot: FolioAIEditSnapshot;
@@ -34,7 +34,7 @@ type FinalSectionComparison = {
   detail: string;
 };
 /** Everything the later stages need, and nothing they have to re-derive. */
-type ParsedComparison = {
+export type ParsedComparison = {
   /** Token size a changed paragraph's redline is cut at. */
   granularity: WordDiffGranularity;
   revisionFormat: "word" | "folio-exact";
@@ -58,9 +58,9 @@ type ParsedComparison = {
   unsupported: readonly CompareUnsupportedPart[];
 };
 /** Stage 1: both packages to editor models, paired story by story. */
-declare const parseComparison: (base: ArrayBuffer, target: ArrayBuffer, options: CompareDocxOptions) => Promise<Result<ParsedComparison, CompareDocxParseError | InvalidCompareDocxOptionsError>>;
+export declare const parseComparison: (base: ArrayBuffer, target: ArrayBuffer, options: CompareDocxOptions) => Promise<Result<ParsedComparison, CompareDocxParseError | InvalidCompareDocxOptionsError>>;
 /** One story's plan, kept with the pair it belongs to. */
-type PlannedStoryComparison = {
+export type PlannedStoryComparison = {
   pair: ComparedStoryPair;
   plan: CompareStoryPlan;
 };
@@ -68,10 +68,10 @@ type PlannedStoryComparison = {
  * Stage 2: align every paired story and derive its operations. Pure — no
  * parsing, no serialization, no clock.
  */
-declare const planComparison: ({ pairs }: ParsedComparison) => Result<readonly PlannedStoryComparison[], CompareDocxOperationLimitError>;
-declare const getCompareSkipDisposition: (reason: FolioAIEditSkipReason) => "fatal" | "unwritable";
+export declare const planComparison: ({ pairs }: ParsedComparison) => Result<readonly PlannedStoryComparison[], CompareDocxOperationLimitError>;
+export declare const getCompareSkipDisposition: (reason: FolioAIEditSkipReason) => "fatal" | "unwritable";
 /** What stage 3 produced: the change list, whether it was proven, and whether it wrote anything. */
-type AppliedComparison = {
+export type AppliedComparison = {
   compatibility: CompareCompatibility;
   changes: readonly CompareChange[];
   verification: CompareVerification;
@@ -96,7 +96,7 @@ type AppliedComparison = {
  * what you could not represent" and "give me nothing unless you can prove it"
  * are both legitimate asks and only the caller knows which one it is making.
  */
-declare const applyComparison: ({ reviewer, revisionStamp, granularity, revisionFormat, terminalTableCarrierStaged, numberingChanges, numberingStage, finalSectionComparison, styleImportFailure, pairs, unsupported }: ParsedComparison, planned: readonly PlannedStoryComparison[]) => Result<AppliedComparison, CompareDocxApplyError | CompareDocxOperationLimitError>;
+export declare const applyComparison: ({ reviewer, revisionStamp, granularity, revisionFormat, terminalTableCarrierStaged, numberingChanges, numberingStage, finalSectionComparison, styleImportFailure, pairs, unsupported }: ParsedComparison, planned: readonly PlannedStoryComparison[]) => Result<AppliedComparison, CompareDocxApplyError | CompareDocxOperationLimitError>;
 /**
  * Stage 4: the result package, with every ZIP entry date pinned.
  *
@@ -116,7 +116,7 @@ declare const applyComparison: ({ reviewer, revisionStamp, granularity, revision
  * composition let the benchmark's own composition disagree with the shipped
  * one within a single run.
  */
-declare const serializeComparison: ({ baseBuffer, baseCarriedRevisions, reviewer, packageDate, revisionStamp }: ParsedComparison, { documentChanged }: AppliedComparison) => Promise<Result<ArrayBuffer, CompareDocxSerializeError | CompareDocxFinalParagraphMarkError>>;
+export declare const serializeComparison: ({ baseBuffer, baseCarriedRevisions, reviewer, packageDate, revisionStamp }: ParsedComparison, { documentChanged }: AppliedComparison) => Promise<Result<ArrayBuffer, CompareDocxSerializeError | CompareDocxFinalParagraphMarkError>>;
 /**
  * Compare `base` against `target` and return `base` carrying the tracked
  * changes that turn it into `target`, alongside the change list describing
@@ -129,6 +129,6 @@ declare const serializeComparison: ({ baseBuffer, baseCarriedRevisions, reviewer
  * represented — for a caller that would rather show something and say what is
  * missing.
  */
-declare const compareDocx: (base: ArrayBuffer, target: ArrayBuffer, options: CompareDocxOptions) => Promise<Result<CompareResult, CompareDocxError>>;
+export declare const compareDocx: (base: ArrayBuffer, target: ArrayBuffer, options: CompareDocxOptions) => Promise<Result<CompareResult, CompareDocxError>>;
 //#endregion
-export { AppliedComparison, ComparedStoryPair, MAX_COMPARE_OPERATIONS, ParsedComparison, PlannedStoryComparison, applyComparison, compareDocx, getCompareSkipDisposition, parseComparison, planComparison, serializeComparison };
+export {};

package/dist/compare/compare.js

@@ -944,7 +944,8 @@ const applyComparison = ({ reviewer, revisionStamp, granularity, revisionFormat,
 */
 const serializeComparison = async ({ baseBuffer, baseCarriedRevisions, reviewer, packageDate, revisionStamp }, { documentChanged }) => {
 	if (!baseCarriedRevisions && !documentChanged) return Result.ok(baseBuffer);
-	const revisions = revisedFinalParagraphMarks(reviewer.toDocument(), { since: revisionStamp.idSeed });
+	const document = reviewer.toDocument();
+	const revisions = revisedFinalParagraphMarks(document, { since: revisionStamp.idSeed });
 	const [first] = revisions;
 	if (first !== void 0) return Result.err(new CompareDocxFinalParagraphMarkError({
 		message: `A container's final paragraph mark carries a ${first.kind}, which no consumer can resolve: ${first.container} paragraph ${String(first.paragraphIndex)}.`,

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

@@ -1,19 +1,19 @@
 import { FolioContentBlock, FolioContentBlockIdentity, FolioContentIdStability, FolioContentTableLocation } from "./content-types.js";
 import { TableColumnAlignmentStep } from "./column-alignment.js";
 //#region src/compare/content-alignment.d.ts
-type FolioContentAlignmentWorkSession = {
+export type FolioContentAlignmentWorkSession = {
   remainingLcsCells: number;
   remainingStructuralTokenLookups: number;
 };
-type CreateFolioContentAlignmentWorkSessionOptions = {
+export type CreateFolioContentAlignmentWorkSessionOptions = {
   /** @internal A lower allowance used by focused boundary tests. */
   lcsCells?: number;
   /** @internal A lower allowance used by focused boundary tests. */
   structuralTokenLookups?: number;
 };
-declare const createFolioContentAlignmentWorkSession: (options?: CreateFolioContentAlignmentWorkSessionOptions) => FolioContentAlignmentWorkSession;
-declare const exceedsFolioContentLcsBudget: (baseCount: number, revisedCount: number) => boolean;
-type FolioContentBlockPair = {
+export declare const createFolioContentAlignmentWorkSession: (options?: CreateFolioContentAlignmentWorkSessionOptions) => FolioContentAlignmentWorkSession;
+export declare const exceedsFolioContentLcsBudget: (baseCount: number, revisedCount: number) => boolean;
+export type FolioContentBlockPair = {
   baseIndex: number;
   revisedIndex: number;
 };
@@ -28,8 +28,8 @@ type IncreasingPairOptions = {
  * preserving the historical deterministic tie break while reducing the
  * stable-anchor pass from quadratic to O(n log n).
  */
-declare const longestIncreasingFolioContentPairs: (pairs: readonly FolioContentBlockPair[], options?: IncreasingPairOptions) => FolioContentBlockPair[];
-type FolioContentAlignedBlockEvent<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
+export declare const longestIncreasingFolioContentPairs: (pairs: readonly FolioContentBlockPair[], options?: IncreasingPairOptions) => FolioContentBlockPair[];
+export type FolioContentAlignedBlockEvent<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
   type: "pair";
   baseBlock: Block;
   revisedBlock: Block;
@@ -40,15 +40,15 @@ type FolioContentAlignedBlockEvent<Block extends FolioContentBlockIdentity = Fol
   type: "revisedOnly";
   block: Block;
 };
-type AlignFolioContentBlocksOptions<Block extends FolioContentBlockIdentity> = {
+export type AlignFolioContentBlocksOptions<Block extends FolioContentBlockIdentity> = {
   workSession?: FolioContentAlignmentWorkSession;
   /** Let an already-aligned structural slot outrank differing authored IDs. */
   stableIdMismatch?: "pair" | "separate";
   /** @internal Compatibility hook for adapters whose source model predates `idStability`. */
   idStability?: ((block: Block) => FolioContentIdStability) | undefined;
 };
-declare const alignFolioContentBlocks: <Block extends FolioContentBlockIdentity>(baseBlocks: readonly Block[], revisedBlocks: readonly Block[], options?: AlignFolioContentBlocksOptions<Block>) => FolioContentAlignedBlockEvent<Block>[];
-type FolioContentAlignmentStep<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
+export declare const alignFolioContentBlocks: <Block extends FolioContentBlockIdentity>(baseBlocks: readonly Block[], revisedBlocks: readonly Block[], options?: AlignFolioContentBlocksOptions<Block>) => FolioContentAlignedBlockEvent<Block>[];
+export type FolioContentAlignmentStep<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
   type: "pair";
   baseBlock: Block;
   revisedBlock: Block;
@@ -78,12 +78,12 @@ type FolioContentAlignmentStep<Block extends FolioContentBlockIdentity = FolioCo
   location: FolioContentTableLocation;
 } | TableColumnAlignmentStep<Block>;
 /** @internal Legal move bucket and alignment gap for one unpaired block. */
-type FolioContentMoveScope = {
+export type FolioContentMoveScope = {
   readonly bucket: number;
   readonly gap: number;
 };
-declare const groupFolioContentTableRows: <Block extends FolioContentBlockIdentity>(blocks: readonly Block[]) => Block[][];
-type AlignFolioContentStructureOptions<Block extends FolioContentBlockIdentity> = {
+export declare const groupFolioContentTableRows: <Block extends FolioContentBlockIdentity>(blocks: readonly Block[]) => Block[][];
+export type AlignFolioContentStructureOptions<Block extends FolioContentBlockIdentity> = {
   baseBlocks: readonly Block[];
   revisedBlocks: readonly Block[];
   workSession?: FolioContentAlignmentWorkSession;
@@ -93,7 +93,7 @@ type AlignFolioContentStructureOptions<Block extends FolioContentBlockIdentity>
   /** @internal Compatibility hook for adapters whose source model predates `idStability`. */
   idStability?: ((block: Block) => FolioContentIdStability) | undefined;
 };
-declare const alignFolioContentStructure: <Block extends FolioContentBlockIdentity>({ baseBlocks, revisedBlocks, workSession, wholeTableReplacement, stableIdMismatch, idStability }: AlignFolioContentStructureOptions<Block>) => FolioContentAlignmentStep<Block>[];
-declare const contentBlocksShareContainer: (left: FolioContentBlockIdentity, right: FolioContentBlockIdentity) => boolean;
+export declare const alignFolioContentStructure: <Block extends FolioContentBlockIdentity>({ baseBlocks, revisedBlocks, workSession, wholeTableReplacement, stableIdMismatch, idStability }: AlignFolioContentStructureOptions<Block>) => FolioContentAlignmentStep<Block>[];
+export declare const contentBlocksShareContainer: (left: FolioContentBlockIdentity, right: FolioContentBlockIdentity) => boolean;
 //#endregion
-export { AlignFolioContentBlocksOptions, AlignFolioContentStructureOptions, CreateFolioContentAlignmentWorkSessionOptions, FolioContentAlignedBlockEvent, FolioContentAlignmentStep, FolioContentAlignmentWorkSession, FolioContentBlockPair, FolioContentMoveScope, alignFolioContentBlocks, alignFolioContentStructure, contentBlocksShareContainer, createFolioContentAlignmentWorkSession, exceedsFolioContentLcsBudget, groupFolioContentTableRows, longestIncreasingFolioContentPairs };
+export {};

package/dist/compare/content-alignment.js

@@ -533,20 +533,22 @@ const alignFolioContentBlocksInScope = (baseBlocks, revisedBlocks, options) => {
 		for (let offset = 0; offset < pairedCount; offset++) {
 			const baseBlock = prepared.base[baseFrom + offset];
 			const revisedBlock = prepared.revised[revisedFrom + offset];
-			if (baseBlock && revisedBlock) if (fusesACrossing(baseBlock, revisedBlock) || !canPair(baseBlock, revisedBlock)) {
-				events.push({
-					type: "baseOnly",
-					block: baseBlock.block
-				});
-				events.push({
-					type: "revisedOnly",
-					block: revisedBlock.block
+			if (baseBlock && revisedBlock) {
+				if (fusesACrossing(baseBlock, revisedBlock) || !canPair(baseBlock, revisedBlock)) {
+					events.push({
+						type: "baseOnly",
+						block: baseBlock.block
+					});
+					events.push({
+						type: "revisedOnly",
+						block: revisedBlock.block
+					});
+				} else events.push({
+					type: "pair",
+					baseBlock: baseBlock.block,
+					revisedBlock: revisedBlock.block
 				});
-			} else events.push({
-				type: "pair",
-				baseBlock: baseBlock.block,
-				revisedBlock: revisedBlock.block
-			});
+			}
 		}
 		for (let index = baseFrom + pairedCount; index < baseTo; index++) {
 			const block = prepared.base[index]?.block;
@@ -776,19 +778,21 @@ const foldContentDigest = (lanes, text) => {
 const renderContentDigest = (lanes, blockCount) => `${String(blockCount)}:${[...lanes].map((lane) => (lane >>> 0).toString(36)).join(":")}`;
 const createContentStructureProfile = ({ blocks, blockStructure, idStability, physicalCellCount, retainContainerIdentity = false }) => {
 	let containerIdentity = null;
-	if (retainContainerIdentity) if (blocks.length > MAX_CONTENT_STRUCTURE_PROFILE_BLOCKS) containerIdentity = { status: "unavailable" };
-	else {
-		const blockIds = [];
-		const idStabilities = [];
-		for (const block of blocks) {
-			blockIds.push(block.id);
-			idStabilities.push(idStability(block));
+	if (retainContainerIdentity) {
+		if (blocks.length > MAX_CONTENT_STRUCTURE_PROFILE_BLOCKS) containerIdentity = { status: "unavailable" };
+		else {
+			const blockIds = [];
+			const idStabilities = [];
+			for (const block of blocks) {
+				blockIds.push(block.id);
+				idStabilities.push(idStability(block));
+			}
+			containerIdentity = {
+				status: "available",
+				blockIds,
+				idStabilities
+			};
 		}
-		containerIdentity = {
-			status: "available",
-			blockIds,
-			idStabilities
-		};
 	}
 	const profiledBlockCount = Math.min(blocks.length, MAX_CONTENT_STRUCTURE_PROFILE_BLOCKS);
 	const blockIds = [];

package/dist/compare/content-types.d.ts

@@ -2,17 +2,17 @@ import { document_d_exports } from "../types/document.js";
 import { ParagraphNumberingOverride } from "@stll/docx-core/model";
 //#region src/compare/content-types.d.ts
 /** How callers expect a block identifier to behave across document revisions. */
-type FolioContentIdStability = "stable" | "positional";
+export type FolioContentIdStability = "stable" | "positional";
 /** Text-bearing block kinds that share one editable paragraph-mark structure. */
-type FolioContentParagraphKind = "heading" | "listItem" | "paragraph";
+export type FolioContentParagraphKind = "heading" | "listItem" | "paragraph";
 /** One enclosing structural container, ordered outermost to innermost in a block path. */
-type FolioContentContainerPathEntry = {
+export type FolioContentContainerPathEntry = {
   kind: string;
   id: string;
 };
 /** Boolean inline properties represented by content snapshots. */
-type FolioContentInlineBooleanProperty = "bold" | "italic" | "underline" | "strike";
-type FolioContentInlineFormatting = Partial<Record<FolioContentInlineBooleanProperty, boolean>> & {
+export type FolioContentInlineBooleanProperty = "bold" | "italic" | "underline" | "strike";
+export type FolioContentInlineFormatting = Partial<Record<FolioContentInlineBooleanProperty, boolean>> & {
   fontFamily?: string | null;
   fontSizePt?: number | null;
   color?: string | null;
@@ -21,15 +21,15 @@ type FolioContentInlineFormatting = Partial<Record<FolioContentInlineBooleanProp
  * An inline-formatting mutation: `false` is an explicit off value, while
  * `null` removes the direct property so its inherited value becomes effective.
  */
-type FolioContentInlineFormattingPatch = { [Property in keyof FolioContentInlineFormatting]?: FolioContentInlineFormatting[Property] | null; };
+export type FolioContentInlineFormattingPatch = { [Property in keyof FolioContentInlineFormatting]?: FolioContentInlineFormatting[Property] | null; };
 /** Presentation differences for one UTF-16 range in a text-aligned block pair. */
-type FolioContentFormatRange = {
+export type FolioContentFormatRange = {
   startOffset: number;
   endOffset: number;
   formatting: FolioContentInlineFormattingPatch;
 };
 /** A trusted inline projection or an explicit reason no ranges can be used. */
-type FolioContentInlineComparisonResult = {
+export type FolioContentInlineComparisonResult = {
   status: "compared";
   segments: readonly FolioContentFormatRange[];
 } | {
@@ -39,7 +39,7 @@ type FolioContentInlineComparisonResult = {
   status: "budget-exceeded";
   maximum: number;
 };
-type FolioContentRun = {
+export type FolioContentRun = {
   text: string;
   bold?: boolean;
   italic?: boolean;
@@ -59,7 +59,7 @@ type FolioContentRun = {
  * 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 FolioContentTableLocation = {
+export type FolioContentTableLocation = {
   /**
    * Document-order index of the outermost table the block sits in. This equals
    * `tableIndex` unless tables nest.
@@ -82,31 +82,31 @@ type FolioContentTableLocation = {
  * The model's own `ST_Jc` union: a copy spelled here would refuse an alignment
  * a parsed document carries.
  */
-type FolioContentParagraphAlignment = document_d_exports.ParagraphAlignment;
+export type FolioContentParagraphAlignment = document_d_exports.ParagraphAlignment;
 /** Line-height interpretation understood by the neutral comparison model. */
-type FolioContentLineSpacingRule = NonNullable<document_d_exports.ParagraphFormatting["lineSpacingRule"]>;
+export type FolioContentLineSpacingRule = NonNullable<document_d_exports.ParagraphFormatting["lineSpacingRule"]>;
 /** The complete modeled attribute set of direct paragraph indentation. */
-type FolioContentParagraphIndentation = Pick<document_d_exports.ParagraphFormatting, "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent">;
+export type FolioContentParagraphIndentation = Pick<document_d_exports.ParagraphFormatting, "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent">;
 /** A concrete numbering instance and its zero-based level. */
-type FolioContentListReference = {
+export type FolioContentListReference = {
   numId: number;
   level: number;
 };
 /** Authored paragraph numbering state, separate from effective list membership. */
-type FolioContentStatedNumbering = ParagraphNumberingOverride | {
+export type FolioContentStatedNumbering = ParagraphNumberingOverride | {
   readonly kind: "inherit";
 };
-declare const INHERITED_PARAGRAPH_NUMBERING: {
+export declare const INHERITED_PARAGRAPH_NUMBERING: {
   readonly kind: "inherit";
 };
-declare const sameFolioContentStatedNumbering: (left: FolioContentStatedNumbering, right: FolioContentStatedNumbering) => boolean;
+export declare const sameFolioContentStatedNumbering: (left: FolioContentStatedNumbering, right: FolioContentStatedNumbering) => boolean;
 /**
  * The complete modeled attribute set of direct paragraph spacing. Optional
  * fields distinguish an absent attribute from an explicit zero or false value.
  */
-type FolioContentParagraphSpacing = Pick<document_d_exports.ParagraphFormatting, "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "beforeAutospacing" | "afterAutospacing">;
+export type FolioContentParagraphSpacing = Pick<document_d_exports.ParagraphFormatting, "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "beforeAutospacing" | "afterAutospacing">;
 /** Identity and shared projection fields for any block in one ordered story. */
-type FolioContentBlockIdentity<Kind extends string = string> = {
+export type FolioContentBlockIdentity<Kind extends string = string> = {
   id: string;
   kind: Kind;
   text: string;
@@ -126,7 +126,7 @@ type FolioContentBlockIdentity<Kind extends string = string> = {
   containerPath?: readonly FolioContentContainerPathEntry[];
 };
 /** A paragraph block with authored paragraph numbering state. */
-type FolioContentBlock<Kind extends FolioContentParagraphKind = FolioContentParagraphKind> = FolioContentBlockIdentity<Kind> & {
+export type FolioContentBlock<Kind extends FolioContentParagraphKind = FolioContentParagraphKind> = FolioContentBlockIdentity<Kind> & {
   /** Authored `w:outlineLvl`; absent when heading depth comes only from a style. */
   directOutlineLevel?: document_d_exports.OutlineLevel;
   /** Direct paragraph alignment; absent when alignment comes only from a style. */
@@ -135,14 +135,13 @@ type FolioContentBlock<Kind extends FolioContentParagraphKind = FolioContentPara
   directSpacing?: FolioContentParagraphSpacing;
   /** Direct paragraph indentation; absent when every indentation value is inherited. */
   directIndentation?: FolioContentParagraphIndentation;
-  /** Effective list membership resolved from authored and inherited numbering. */
+  /** The list the shown label is counted in, from authored and inherited numbering. */
   listReference?: FolioContentListReference;
   /** Authored paragraph numbering override; `inherit` means no direct override. */
   statedNumbering: FolioContentStatedNumbering;
 };
 /** Every block of one story, in document order. */
-type FolioContentSnapshot<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
+export type FolioContentSnapshot<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
   blocks: readonly Block[];
 };
-//#endregion
-export { FolioContentBlock, FolioContentBlockIdentity, FolioContentContainerPathEntry, FolioContentFormatRange, FolioContentIdStability, FolioContentInlineBooleanProperty, FolioContentInlineComparisonResult, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentLineSpacingRule, FolioContentListReference, FolioContentParagraphAlignment, FolioContentParagraphIndentation, FolioContentParagraphKind, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentStatedNumbering, FolioContentTableLocation, INHERITED_PARAGRAPH_NUMBERING, sameFolioContentStatedNumbering };
+//#endregion

package/dist/compare/content.d.ts

@@ -1,10 +1,10 @@
 import { FolioContentBlock, FolioContentBlockIdentity, FolioContentFormatRange, FolioContentIdStability, FolioContentParagraphIndentation, FolioContentParagraphSpacing, FolioContentSnapshot, FolioContentStatedNumbering } from "./content-types.js";
 import { WordDiffGranularity, createWordDiffSession } from "../ai-edits/word-diff.js";
 import { FolioContentAlignmentStep, FolioContentAlignmentWorkSession } from "./content-alignment.js";
-import { Result } from "better-result";
+import { Result, TaggedErrorClass } from "better-result";
 //#region src/compare/content.d.ts
 /** Hard resource ceilings for one representation-neutral comparison. */
-declare const FOLIO_CONTENT_COMPARISON_LIMITS: Readonly<{
+export declare const FOLIO_CONTENT_COMPARISON_LIMITS: Readonly<{
   readonly blocksPerSnapshot: 100000;
   readonly changes: 10000;
   readonly blockCodeUnits: 1048576;
@@ -16,16 +16,16 @@ declare const FOLIO_CONTENT_COMPARISON_LIMITS: Readonly<{
   readonly attributeCodeUnits: 16384;
   readonly attributeCodeUnitsPerSnapshot: 8000000;
 }>;
-type FolioContentComparisonLimit = keyof typeof FOLIO_CONTENT_COMPARISON_LIMITS;
-declare const InvalidFolioContentComparisonError_base: import("better-result").TaggedErrorClass<"InvalidFolioContentComparisonError">;
-declare class InvalidFolioContentComparisonError extends InvalidFolioContentComparisonError_base<{
+export type FolioContentComparisonLimit = keyof typeof FOLIO_CONTENT_COMPARISON_LIMITS;
+declare const InvalidFolioContentComparisonErrorBase: TaggedErrorClass<"InvalidFolioContentComparisonError">;
+export declare class InvalidFolioContentComparisonError extends InvalidFolioContentComparisonErrorBase<{
   message: string;
   input: "options" | "base" | "revised";
   blockIndex?: number;
   field: string;
 }> {}
-declare const FolioContentComparisonLimitError_base: import("better-result").TaggedErrorClass<"FolioContentComparisonLimitError">;
-declare class FolioContentComparisonLimitError extends FolioContentComparisonLimitError_base<{
+declare const FolioContentComparisonLimitErrorBase: TaggedErrorClass<"FolioContentComparisonLimitError">;
+export declare class FolioContentComparisonLimitError extends FolioContentComparisonLimitErrorBase<{
   message: string;
   input: "base" | "revised" | "result";
   limit: FolioContentComparisonLimit;
@@ -34,17 +34,17 @@ declare class FolioContentComparisonLimitError extends FolioContentComparisonLim
   blockIndex?: number;
   field?: string;
 }> {}
-declare const FolioContentInlinePresentationProjectionError_base: import("better-result").TaggedErrorClass<"FolioContentInlinePresentationProjectionError">;
-declare class FolioContentInlinePresentationProjectionError extends FolioContentInlinePresentationProjectionError_base<{
+declare const FolioContentInlinePresentationProjectionErrorBase: TaggedErrorClass<"FolioContentInlinePresentationProjectionError">;
+export declare class FolioContentInlinePresentationProjectionError extends FolioContentInlinePresentationProjectionErrorBase<{
   message: string;
   side: "base" | "revised" | "both";
   baseBlockId: string;
   revisedBlockId: string;
 }> {}
 /** Errors returned by {@link compareContent}. */
-type FolioContentComparisonError = InvalidFolioContentComparisonError | FolioContentComparisonLimitError | FolioContentInlinePresentationProjectionError;
+export type FolioContentComparisonError = InvalidFolioContentComparisonError | FolioContentComparisonLimitError | FolioContentInlinePresentationProjectionError;
 /** One Folio word-diff segment with JavaScript-slice-compatible offsets. */
-type FolioContentTextSegment = {
+export type FolioContentTextSegment = {
   type: "equal" | "del" | "ins";
   text: string;
   baseStart: number;
@@ -53,7 +53,7 @@ type FolioContentTextSegment = {
   revisedEnd: number;
 };
 /** Target-side paragraph properties that differ from the base block. */
-type FolioContentParagraphFormattingPatch = {
+export type FolioContentParagraphFormattingPatch = {
   styleId?: string | null;
   outlineLevel?: FolioContentBlock["directOutlineLevel"] | null;
   numbering?: FolioContentStatedNumbering;
@@ -62,14 +62,14 @@ type FolioContentParagraphFormattingPatch = {
   indentation?: FolioContentParagraphIndentation | null;
 };
 /** Authored outline identity, including the distinction between heading and body text. */
-declare const sameFolioContentOutlineLevel: (left: FolioContentBlock["directOutlineLevel"], right: FolioContentBlock["directOutlineLevel"]) => boolean;
+export declare const sameFolioContentOutlineLevel: (left: FolioContentBlock["directOutlineLevel"], right: FolioContentBlock["directOutlineLevel"]) => boolean;
 /** Presentation differences for one text-aligned block pair. */
-type FolioContentFormattingChange = {
+export type FolioContentFormattingChange = {
   paragraph?: FolioContentParagraphFormattingPatch;
   ranges: readonly FolioContentFormatRange[];
 };
 /** Non-presentation block fields that changed on a paired block. */
-type FolioContentBlockProperty = "kind" | "headingLevel" | "displayLabel";
+export type FolioContentBlockProperty = "kind" | "headingLevel" | "displayLabel";
 type PairedEvent<Block extends FolioContentBlockIdentity> = {
   baseBlocks: readonly [Block];
   revisedBlocks: readonly [Block];
@@ -86,7 +86,7 @@ type RevisedOnlyEvent<Block extends FolioContentBlockIdentity> = {
  * One item in the complete comparison stream. Tuple cardinality is fixed by
  * the discriminator, making both document projections mechanically exact.
  */
-type FolioContentComparisonEvent<Block extends FolioContentBlockIdentity = FolioContentBlock> = ({
+export type FolioContentComparisonEvent<Block extends FolioContentBlockIdentity = FolioContentBlock> = ({
   type: "unchanged";
 } & PairedEvent<Block>) | ({
   type: "modified";
@@ -133,7 +133,7 @@ type RevisedStructuralChange = {
   revisedBlockIds: readonly string[];
 };
 /** A grouped table operation referenced by its block-granular stream events. */
-type FolioContentStructuralChange = ({
+export type FolioContentStructuralChange = ({
   type: "table-delete";
   tableIndex: number;
 } & BaseStructuralChange) | ({
@@ -157,25 +157,25 @@ type FolioContentStructuralChange = ({
   columnIndex: number;
 } & RevisedStructuralChange);
 /** Result of one representation-neutral story comparison. */
-type FolioContentComparison<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
+export type FolioContentComparison<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
   events: readonly FolioContentComparisonEvent<Block>[];
   structuralChanges: readonly FolioContentStructuralChange[];
 };
 /** Inputs to {@link compareContent}. */
-type CompareContentOptions<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
+export type CompareContentOptions<Block extends FolioContentBlockIdentity = FolioContentBlock> = {
   base: FolioContentSnapshot<Block>;
   revised: FolioContentSnapshot<Block>;
   /** Token size for modified-block segments; defaults to `"word"`. */
   granularity?: WordDiffGranularity;
 };
-type FolioContentComparisonWorkSession = {
+export type FolioContentComparisonWorkSession = {
   alignment: FolioContentAlignmentWorkSession;
   remainingMoveComparisons: number;
   remainingMoveTokenLookups: number;
   diffText: ReturnType<typeof createWordDiffSession>["diff"];
 };
-declare const createContentComparisonWorkSession: (granularity?: WordDiffGranularity) => FolioContentComparisonWorkSession;
-declare const changedFolioContentParagraphFormatting: (base: FolioContentBlockIdentity, revised: FolioContentBlockIdentity) => FolioContentParagraphFormattingPatch | null;
+export declare const createContentComparisonWorkSession: (granularity?: WordDiffGranularity) => FolioContentComparisonWorkSession;
+export declare const changedFolioContentParagraphFormatting: (base: FolioContentBlockIdentity, revised: FolioContentBlockIdentity) => FolioContentParagraphFormattingPatch | null;
 type ParagraphMarkPlan<Block extends FolioContentBlockIdentity> = {
   type: "split";
   baseBlock: Block;
@@ -189,12 +189,12 @@ type ParagraphMarkPlan<Block extends FolioContentBlockIdentity> = {
   separator: string;
 };
 /** Plans keyed by their first step; each consumes the step after it. */
-declare const detectFolioContentParagraphMarkPlans: <Block extends FolioContentBlockIdentity>(steps: readonly FolioContentAlignmentStep<Block>[]) => ReadonlyMap<number, ParagraphMarkPlan<Block>>;
+export declare const detectFolioContentParagraphMarkPlans: <Block extends FolioContentBlockIdentity>(steps: readonly FolioContentAlignmentStep<Block>[]) => ReadonlyMap<number, ParagraphMarkPlan<Block>>;
 type MovePair<Block extends FolioContentBlockIdentity> = {
   baseBlock: Block;
   revisedBlock: Block;
 };
-declare const detectFolioContentMoves: <Block extends FolioContentBlockIdentity>({ steps, consumedStepIndexes, workSession, idStability }: {
+export declare const detectFolioContentMoves: <Block extends FolioContentBlockIdentity>({ steps, consumedStepIndexes, workSession, idStability }: {
   steps: readonly FolioContentAlignmentStep<Block>[];
   consumedStepIndexes: ReadonlySet<number>;
   workSession: FolioContentComparisonWorkSession;
@@ -208,8 +208,8 @@ type CompareAlignedContentOptions<Block extends FolioContentBlockIdentity> = {
   maxChanges: number;
   idStability?: (block: Block) => FolioContentIdStability;
 };
-declare const compareAlignedFolioContent: <Block extends FolioContentBlockIdentity>({ baseBlocks, revisedBlocks, steps, workSession, maxChanges, idStability }: CompareAlignedContentOptions<Block>) => Result<FolioContentComparison<Block>, FolioContentComparisonLimitError | FolioContentInlinePresentationProjectionError>;
+export declare const compareAlignedFolioContent: <Block extends FolioContentBlockIdentity>({ baseBlocks, revisedBlocks, steps, workSession, maxChanges, idStability }: CompareAlignedContentOptions<Block>) => Result<FolioContentComparison<Block>, FolioContentComparisonLimitError | FolioContentInlinePresentationProjectionError>;
 /** Compare two representation-neutral ordered content snapshots. */
-declare const compareContent: <Block extends FolioContentBlockIdentity = FolioContentBlock>(options: CompareContentOptions<Block>) => Result<FolioContentComparison<Block>, FolioContentComparisonError>;
+export declare const compareContent: <Block extends FolioContentBlockIdentity = FolioContentBlock>(options: CompareContentOptions<Block>) => Result<FolioContentComparison<Block>, FolioContentComparisonError>;
 //#endregion
-export { CompareContentOptions, FOLIO_CONTENT_COMPARISON_LIMITS, FolioContentBlockProperty, FolioContentComparison, FolioContentComparisonError, FolioContentComparisonEvent, FolioContentComparisonLimit, FolioContentComparisonLimitError, FolioContentComparisonWorkSession, type FolioContentFormatRange, FolioContentFormattingChange, FolioContentInlinePresentationProjectionError, FolioContentParagraphFormattingPatch, FolioContentStructuralChange, FolioContentTextSegment, InvalidFolioContentComparisonError, changedFolioContentParagraphFormatting, compareAlignedFolioContent, compareContent, createContentComparisonWorkSession, detectFolioContentMoves, detectFolioContentParagraphMarkPlans, sameFolioContentOutlineLevel };
+export type { FolioContentFormatRange };

package/dist/compare/content.js

@@ -43,9 +43,12 @@ const MOVE_SIMILARITY_THRESHOLD = .8;
 const MAX_MOVE_PROFILE_TOKENS = 16384;
 /** Bound source code units copied into one edited-move token profile. */
 const MAX_MOVE_PROFILE_CODE_UNITS = 1048576;
-var InvalidFolioContentComparisonError = class extends TaggedError("InvalidFolioContentComparisonError") {};
-var FolioContentComparisonLimitError = class extends TaggedError("FolioContentComparisonLimitError") {};
-var FolioContentInlinePresentationProjectionError = class extends TaggedError("FolioContentInlinePresentationProjectionError") {};
+const InvalidFolioContentComparisonErrorBase = TaggedError("InvalidFolioContentComparisonError");
+var InvalidFolioContentComparisonError = class extends InvalidFolioContentComparisonErrorBase {};
+const FolioContentComparisonLimitErrorBase = TaggedError("FolioContentComparisonLimitError");
+var FolioContentComparisonLimitError = class extends FolioContentComparisonLimitErrorBase {};
+const FolioContentInlinePresentationProjectionErrorBase = TaggedError("FolioContentInlinePresentationProjectionError");
+var FolioContentInlinePresentationProjectionError = class extends FolioContentInlinePresentationProjectionErrorBase {};
 /** Authored outline identity, including the distinction between heading and body text. */
 const sameFolioContentOutlineLevel = (left, right) => left?.kind === right?.kind && (left?.kind !== "heading" || right?.kind === "heading" && left.level === right.level);
 const createContentComparisonWorkSession = (granularity) => ({

package/dist/compare/formatting.d.ts

@@ -6,6 +6,6 @@ type InlineFormattingSegmentsOptions = {
   maxSegments: number;
 };
 /** Malformed run streams take precedence over the output budget. */
-declare const inlineFormattingSegments: ({ baseBlock, targetBlock, maxSegments }: InlineFormattingSegmentsOptions) => FolioContentInlineComparisonResult;
+export declare const inlineFormattingSegments: ({ baseBlock, targetBlock, maxSegments }: InlineFormattingSegmentsOptions) => FolioContentInlineComparisonResult;
 //#endregion
-export { inlineFormattingSegments };
+export {};

package/dist/compare/import-style-closure.d.ts

@@ -13,10 +13,10 @@ type ImportStyleClosureWithNumberingOptions = {
   }[];
 };
 /** Import numbering before styles bind to it, then rebind the source snapshots once. */
-declare const importStyleClosureWithNumbering: ({ destination, source, snapshots, importedHeaderFooterSnapshots, numberingReferences }: ImportStyleClosureWithNumberingOptions) => {
+export declare const importStyleClosureWithNumbering: ({ destination, source, snapshots, importedHeaderFooterSnapshots, numberingReferences }: ImportStyleClosureWithNumberingOptions) => {
   styleImport: ImportReferencedStyleDefinitionsResult;
   numberingStage: "unchanged" | "staged" | "conflict";
   snapshots: FolioAIEditSnapshot[];
 };
 //#endregion
-export { importStyleClosureWithNumbering };
+export {};

package/dist/compare/inline-atom-resources.d.ts

@@ -1,6 +1,5 @@
 import { Node } from "prosemirror-model";
 //#region src/compare/inline-atom-resources.d.ts
 /** Detach supported atoms from the source package; save allocates the receiving media relationship. */
-declare const prepareTargetInlineAtom: (node: Node) => Node | null;
-//#endregion
-export { prepareTargetInlineAtom };
+export declare const prepareTargetInlineAtom: (node: Node) => Node | null;
+//#endregion

package/dist/compare/inline-atoms.d.ts

@@ -4,7 +4,7 @@ import { NoteReferenceLabels } from "../ai-edits/note-references.js";
 import { Node } from "prosemirror-model";
 import { EditorState, Transaction } from "prosemirror-state";
 //#region src/compare/inline-atoms.d.ts
-type MatchInlineAtomsOptions = {
+export type MatchInlineAtomsOptions = {
   state: EditorState;
   targetSnapshot: FolioAIEditSnapshot;
   revisionStamp: FolioRevisionStamp;
@@ -24,7 +24,7 @@ type MatchInlineAtomsOptions = {
    */
   baseNotes?: ReadonlySet<string>;
 };
-type MatchInlineAtomsResult = {
+export type MatchInlineAtomsResult = {
   status: "matched";
   transaction: Transaction;
   nextRevisionId: number;
@@ -38,15 +38,14 @@ type MatchInlineAtomsResult = {
   status: "budget-exceeded";
 };
 /** A revised reference names a note the redline's package does not have. */
-declare const MISSING_NOTE_DETAIL = "a note reference names a footnote or endnote the base document does not have";
+export declare const MISSING_NOTE_DETAIL = "a note reference names a footnote or endnote the base document does not have";
 /**
  * Restore field, image, and page-break atoms omitted by text-only comparison
  * operations, and the note references whose markers they wrote as text.
  * Positions come from the legacy review resolver's mapping, never a guessed
  * paragraph correspondence: paragraph-mark deletions can merge paragraphs.
  */
-declare const matchInlineAtoms: ({ state, targetSnapshot, revisionStamp, originalRevisionIdSeed, author, maxRanges, noteReferenceLabels, baseNotes }: MatchInlineAtomsOptions) => MatchInlineAtomsResult;
+export declare const matchInlineAtoms: ({ state, targetSnapshot, revisionStamp, originalRevisionIdSeed, author, maxRanges, noteReferenceLabels, baseNotes }: MatchInlineAtomsOptions) => MatchInlineAtomsResult;
 /** Compare supported inline atom identity after accept or reject projection. */
-declare const sameInlineAtoms: (leftDocument: Node, rightDocument: Node) => boolean;
-//#endregion
-export { MISSING_NOTE_DETAIL, MatchInlineAtomsOptions, MatchInlineAtomsResult, matchInlineAtoms, sameInlineAtoms };
+export declare const sameInlineAtoms: (leftDocument: Node, rightDocument: Node) => boolean;
+//#endregion