@stll/folio-core 0.62.0 → 0.63.0

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

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