@stll/folio-core 0.64.0 → 0.65.0

package/dist/compare/inserted-resource-snapshot.d.ts

@@ -1,5 +1,4 @@
 import { FolioAIBlock, FolioAIEditSnapshot } from "../ai-edits/types.js";
-//#region src/compare/inserted-resource-snapshot.d.ts
 type CreateInsertedResourceProjectionOptions = {
   base: FolioAIEditSnapshot;
   revised: FolioAIEditSnapshot;
@@ -11,5 +10,4 @@ export declare const createInsertedResourceProjection: ({ base, revised }: Creat
 };
 /** Subset projection IDs never participate in rebinding the full revised snapshot. */
 export declare const rebindInsertedResourceBlocks: (projection: ReturnType<typeof createInsertedResourceProjection>, rebound: FolioAIEditSnapshot) => Map<string, FolioAIBlock>;
-//#endregion
 export {};

package/dist/compare/inserted-resource-snapshot.js

@@ -2,7 +2,7 @@ import { createFolioAIEditSnapshotWithStyleResolver, sourceDocumentOf, styleReso
 import { alignFolioBlocks } from "../version-comparison.js";
 import { panic } from "better-result";
 import { Fragment } from "prosemirror-model";
-//#region src/compare/inserted-resource-snapshot.ts
+// src/compare/inserted-resource-snapshot.ts
 /** Select resource nodes with their identities from the full revised snapshot. */
 const createInsertedResourceProjection = ({ base, revised }) => {
 	const document = sourceDocumentOf(revised);
@@ -59,5 +59,4 @@ const rebindInsertedResourceBlocks = (projection, rebound) => {
 	}
 	return blocks;
 };
-//#endregion
 export { createInsertedResourceProjection, rebindInsertedResourceBlocks };

package/dist/compare/plan.d.ts

@@ -4,7 +4,6 @@ import { FolioDocumentStoryHandle } from "../ai-edits/headless.js";
 import { CompareVerificationFailure } from "./verification.js";
 import { CompareChange } from "./types.js";
 import { FolioContentComparisonWorkSession } from "./content.js";
-//#region src/compare/plan.d.ts
 /**
  * A table the target document already holds, which the operation naming it
  * should place verbatim instead of rebuilding from its cell texts.
@@ -55,5 +54,4 @@ export type PlanStoryCompareOptions = {
  * Plan one story's comparison, or `null` when it needs more operations than
  * `maxOperations`.
  */
-export declare const planStoryCompare: ({ story, baseSnapshot, targetSnapshot, maxOperations, wholeTableReplacement, workSession }: PlanStoryCompareOptions) => CompareStoryPlan | null;
-//#endregion
+export declare const planStoryCompare: ({ story, baseSnapshot, targetSnapshot, maxOperations, wholeTableReplacement, workSession }: PlanStoryCompareOptions) => CompareStoryPlan | null;

package/dist/compare/plan.js

@@ -4,7 +4,7 @@ import { alignFolioContentStructure, contentBlocksShareContainer, createFolioCon
 import { changedFolioContentParagraphFormatting, createContentComparisonWorkSession, detectFolioContentMoves, detectFolioContentParagraphMarkPlans } from "./content.js";
 import { inlineFormattingSegments } from "./formatting.js";
 import { panic } from "better-result";
-//#region src/compare/plan.ts
+// src/compare/plan.ts
 /**
 * Turn two block snapshots of one story into the change list a caller reads
 * and the {@link FolioAIEditOperation}s that reproduce the target when every
@@ -981,5 +981,4 @@ const planStoryCompare = ({ story, baseSnapshot, targetSnapshot, maxOperations,
 		tableGeometryPairings: tableGeometryPairingsOf(steps)
 	};
 };
-//#endregion
 export { planStoryCompare };

package/dist/compare/reproducible-package.d.ts

@@ -1,3 +1,6 @@
-//#region src/compare/reproducible-package.d.ts
-export declare const withFixedPackageDates: (buffer: ArrayBuffer, date: Date) => Promise<ArrayBuffer>;
-//#endregion
+/**
+ * Date comparison output from the comparison's timestamp. Imported entries
+ * retain source dates, and saves can stamp `dcterms:modified` from the wall
+ * clock; restamping both makes repeated comparisons reproducible.
+ */
+export declare const withFixedPackageDates: (buffer: ArrayBuffer, date: Date) => Promise<ArrayBuffer>;

package/dist/compare/reproducible-package.js

@@ -1,13 +1,12 @@
-import { decodeText, encodeUtf8 } from "../utils/textEncoding.js";
-import JSZip from "jszip";
-import { writeZipPart } from "@stll/docx-core/zip";
-//#region src/compare/reproducible-package.ts
+import { decodeText } from "../utils/textEncoding.js";
+import { ZipArchive } from "@stll/docx-core/zip";
+// src/compare/reproducible-package.ts
 /**
 * Date comparison output from the comparison's timestamp. Imported entries
 * retain source dates, and saves can stamp `dcterms:modified` from the wall
 * clock; restamping both makes repeated comparisons reproducible.
 */
-/** JSZip deflate level `repackDocx` writes DOCX parts at. */
+/** ZipArchive deflate level `repackDocx` writes DOCX parts at. */
 const DOCX_COMPRESSION_LEVEL = 6;
 const CORE_PROPERTIES_PATH = "docProps/core.xml";
 const MODIFIED_ELEMENT = /<dcterms:modified[^<>]*>[^<]*<\/dcterms:modified>/u;
@@ -18,25 +17,12 @@ const MODIFIED_ELEMENT = /<dcterms:modified[^<>]*>[^<]*<\/dcterms:modified>/u;
 */
 const withFixedModifiedDate = (corePropsXml, date) => corePropsXml.replace(MODIFIED_ELEMENT, `<dcterms:modified xsi:type="dcterms:W3CDTF">${date.toISOString()}</dcterms:modified>`);
 const withFixedPackageDates = async (buffer, date) => {
-	const zip = await JSZip.loadAsync(buffer);
-	const coreProps = zip.file(CORE_PROPERTIES_PATH);
-	if (coreProps) writeZipPart({
-		zip,
-		path: CORE_PROPERTIES_PATH,
-		data: encodeUtf8(withFixedModifiedDate(await coreProps.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })), date)),
-		options: {
-			compression: "DEFLATE",
-			compressionOptions: { level: DOCX_COMPRESSION_LEVEL }
-		}
-	});
-	zip.forEach((_path, file) => {
-		file.date = date;
-	});
-	return await zip.generateAsync({
-		type: "arraybuffer",
-		compression: "DEFLATE",
-		compressionOptions: { level: DOCX_COMPRESSION_LEVEL }
-	});
+	const zip = await ZipArchive.read(buffer);
+	const coreProps = zip.entry(CORE_PROPERTIES_PATH);
+	if (coreProps) zip.set(CORE_PROPERTIES_PATH, withFixedModifiedDate(decodeText(await coreProps.bytes(), { ignoreBOM: true }), date));
+	return (await zip.generate({
+		level: DOCX_COMPRESSION_LEVEL,
+		modified: date
+	})).buffer;
 };
-//#endregion
 export { withFixedPackageDates };

package/dist/compare/scenario.d.ts

@@ -2,7 +2,6 @@ import { FolioContentFormatRange } from "./content-types.js";
 import { FolioAIEditOperation } from "../ai-edits/types.js";
 import { CompareDocxParseError, CompareDocxSerializeError } from "./types.js";
 import { Result } from "better-result";
-//#region src/compare/scenario.d.ts
 type InsertTableRowOperation = Extract<FolioAIEditOperation, {
   type: "insertTableRow";
 }>;
@@ -80,5 +79,4 @@ export type EditScriptResult = {
  * Apply `script` to `base` directly and return the resulting target document.
  */
 export declare const applyEditScript: (base: ArrayBuffer, script: EditScript) => Promise<Result<EditScriptResult, CompareDocxParseError | CompareDocxSerializeError>>;
-//#endregion
 export {};

package/dist/compare/scenario.js

@@ -3,7 +3,7 @@ import { createFolioAITextRangeHandle } from "../ai-edits/snapshot.js";
 import "../document-operations.js";
 import { CompareDocxParseError, compareDocxSerializeError } from "./types.js";
 import { Result, panic } from "better-result";
-//#region src/compare/scenario.ts
+// src/compare/scenario.ts
 /**
 * Edit scripts: ground truth for the compare engine, by construction.
 *
@@ -281,5 +281,4 @@ const applyEditScript = async (base, script) => {
 		unresolved
 	});
 };
-//#endregion
 export { EDIT_SCRIPT_TABLE_ROW_POSITION, EDIT_SCRIPT_UNRESOLVED_REASONS, applyEditScript };

package/dist/compare/section-boundary-properties.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { Node } from "prosemirror-model";
-//#region src/compare/section-boundary-properties.d.ts
 export type SectionBoundaryPropertyChange = {
   position: number;
   current: document_d_exports.SectionProperties;
@@ -59,5 +58,4 @@ export declare const stageSectionBoundaryProperties: ({ state, target, originalR
     target: document_d_exports.SectionProperties;
   }) => MappedSectionBoundaryProperties | null;
 }) => StageSectionBoundaryPropertiesResult;
-//#endregion
 export {};

package/dist/compare/section-boundary-properties.js

@@ -2,7 +2,7 @@ import { sectionReferenceHistory } from "../docx/sectionReferenceHistory.js";
 import { expectParagraphAttrs } from "../prosemirror/attrs/index.js";
 import { resolveAllChangesInHeadlessStateWithMapping } from "../prosemirror/commands/comments.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
-//#region src/compare/section-boundary-properties.ts
+// src/compare/section-boundary-properties.ts
 const withoutChangeHistory = (properties) => {
 	const { propertyChanges: _propertyChanges, ...result } = properties;
 	return result;
@@ -244,5 +244,4 @@ const stageSectionBoundaryProperties = ({ state, target, originalRevisionIdSeed,
 		rangeCount: updates.length
 	};
 };
-//#endregion
 export { compareSectionBoundaryProperties, stageSectionBoundaryProperties };

package/dist/compare/style-resources.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/compare/style-resources.d.ts
 export type ImportReferencedStyleDefinitionsOptions = {
   sourceStyles: document_d_exports.StyleDefinitions | undefined;
   destinationStyles: document_d_exports.StyleDefinitions | undefined;
@@ -31,5 +30,4 @@ export declare const styleClosureNumberingReferences: (styles: document_d_export
  * packages have the same document defaults and theme: those resources take
  * part in OOXML style resolution even when a style definition itself is new.
  */
-export declare const importReferencedStyleDefinitions: ({ sourceStyles: originalSourceStyles, destinationStyles, sourceTheme, destinationTheme, referencedStyleIds, reservedStyleIds, materializeDefaultParagraphStyle, numberingReferenceMap }: ImportReferencedStyleDefinitionsOptions) => ImportReferencedStyleDefinitionsResult;
-//#endregion
+export declare const importReferencedStyleDefinitions: ({ sourceStyles: originalSourceStyles, destinationStyles, sourceTheme, destinationTheme, referencedStyleIds, reservedStyleIds, materializeDefaultParagraphStyle, numberingReferenceMap }: ImportReferencedStyleDefinitionsOptions) => ImportReferencedStyleDefinitionsResult;

package/dist/compare/style-resources.js

@@ -3,7 +3,7 @@ import { canonicalJson } from "../utils/canonicalJson.js";
 import { resolveColorToHex } from "../utils/colorResolver.js";
 import { resolveThemeFont } from "../utils/fontResolver.js";
 import { paragraphNumberingReference } from "@stll/docx-core/model";
-//#region src/compare/style-resources.ts
+// src/compare/style-resources.ts
 const styleDependencies = ({ basedOn, link, next }) => [
 	basedOn,
 	link,
@@ -455,5 +455,4 @@ const importReferencedStyleDefinitions = ({ sourceStyles: originalSourceStyles,
 		...defaultParagraphStyleId !== void 0 && { defaultParagraphStyleId }
 	};
 };
-//#endregion
 export { importReferencedStyleDefinitions, styleClosureNumberingReferences };

package/dist/compare/types.d.ts

@@ -4,7 +4,6 @@ import { WordDiffGranularity } from "../ai-edits/word-diff.js";
 import { FolioDocumentStoryHandle, FolioNumberingLevel } from "../ai-edits/headless.js";
 import { CompareVerification, CompareVerificationCause, CompareVerificationFailure, CompareVerificationInvariant, FinalParagraphMarkRevision } from "./verification.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/compare/types.d.ts
 declare const CompareDocxFinalParagraphMarkErrorBase: TaggedErrorClass<"CompareDocxFinalParagraphMarkError">;
 declare const CompareDocxOperationLimitErrorBase: TaggedErrorClass<"CompareDocxOperationLimitError">;
 declare const CompareDocxRoundTripErrorBase: TaggedErrorClass<"CompareDocxRoundTripError">;
@@ -345,5 +344,4 @@ export declare class CompareDocxFinalParagraphMarkError extends CompareDocxFinal
   revisions: readonly FinalParagraphMarkRevision[];
 }> {}
 export type CompareDocxError = CompareDocxApplyError | CompareDocxFinalParagraphMarkError | CompareDocxOperationLimitError | CompareDocxParseError | CompareDocxRoundTripError | CompareDocxSerializeError | InvalidCompareDocxOptionsError;
-//#endregion
 export {};

package/dist/compare/types.js

@@ -1,5 +1,5 @@
 import { TaggedError } from "better-result";
-//#region src/compare/types.ts
+// src/compare/types.ts
 /**
 * Public vocabulary of {@link ./compare.compareDocx}: the change list, the
 * options that pin its output, and the failures it reports.
@@ -61,5 +61,4 @@ const compareDocxSerializeError = (context, cause) => new CompareDocxSerializeEr
 * consumer refuses the file.
 */
 var CompareDocxFinalParagraphMarkError = class extends CompareDocxFinalParagraphMarkErrorBase {};
-//#endregion
 export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, InvalidCompareDocxOptionsError, compareDocxSerializeError };

package/dist/compare/verification.d.ts

@@ -1,7 +1,6 @@
 import { FolioAIDiagnosticBlock, FolioAIParagraphBlock } from "../ai-edits/types.js";
 import { FolioDocumentStoryHandle } from "../ai-edits/headless.js";
 import { ParagraphMarkChangeKind } from "@stll/docx-core/model";
-//#region src/compare/verification.d.ts
 /** The two directions of the round trip, each an invariant of its own. */
 export declare const COMPARE_VERIFICATION_INVARIANTS: readonly ["accept-reproduces-target", "reject-reproduces-base"];
 export type CompareVerificationInvariant = (typeof COMPARE_VERIFICATION_INVARIANTS)[number];
@@ -107,5 +106,4 @@ export type FinalParagraphMarkRevision = {
 export declare const revisedFinalParagraphMarks: (packageModel: unknown, { since }?: {
   since?: number;
 }) => FinalParagraphMarkRevision[];
-//#endregion
 export {};

package/dist/compare/verification.js

@@ -4,7 +4,7 @@ import { sameFolioContentStatedNumbering } from "./content-types.js";
 import { sameFolioContentOutlineLevel } from "./content.js";
 import { panic } from "better-result";
 import { PARAGRAPH_MARK_CHANGE_KINDS } from "@stll/docx-core/model";
-//#region src/compare/verification.ts
+// src/compare/verification.ts
 /**
 * What the round-trip self-check found, and how to say it safely.
 *
@@ -316,5 +316,4 @@ const revisedFinalParagraphMarks = (packageModel, { since = 0 } = {}) => {
 	visit(packageModel, false);
 	return found;
 };
-//#endregion
 export { COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, classifyGeometryMismatch, classifyProjectionMismatch, revisedFinalParagraphMarks };

package/dist/content-controls/checkboxDisplay.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/content-controls/checkboxDisplay.d.ts
 type CheckboxDisplayContent = Extract<document_d_exports.RunContent, {
   type: "symbol";
 } | {
@@ -13,5 +12,4 @@ type CheckboxDisplayContent = Extract<document_d_exports.RunContent, {
  *   code, or one whose author wrote no glyphs — gets Word's own defaults.
  */
 export declare const checkboxDisplayContent: (checkboxXml: string | undefined, checked: boolean) => CheckboxDisplayContent;
-//#endregion
 export {};

package/dist/content-controls/checkboxDisplay.js

@@ -1,5 +1,5 @@
 import { NAMESPACES, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, findChildByNamespaceUri, getAttributeByNamespaceUri, parseXml } from "../docx/xmlParser.js";
-//#region src/content-controls/checkboxDisplay.ts
+// src/content-controls/checkboxDisplay.ts
 const CHECKBOX_NAMESPACE_URIS = /* @__PURE__ */ new Set([NAMESPACES.w14, ...WORDPROCESSINGML_NAMESPACE_URIS]);
 const DEFAULT_CHECKED_CHARACTER = "2612";
 const DEFAULT_UNCHECKED_CHARACTER = "2610";
@@ -43,5 +43,4 @@ const checkboxDisplayContent = (checkboxXml, checked) => {
 		text: String.fromCodePoint(codePoint)
 	};
 };
-//#endregion
 export { checkboxDisplayContent };

package/dist/content-controls/errors.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/content-controls/errors.d.ts
 declare const ContentControlTypeErrorBase: TaggedErrorClass<"ContentControlTypeError">;
 declare const ContentControlBoundErrorBase: TaggedErrorClass<"ContentControlBoundError">;
 declare const ContentControlLockedErrorBase: TaggedErrorClass<"ContentControlLockedError">;
@@ -48,5 +47,4 @@ export declare class ContentControlTypeError extends ContentControlTypeErrorBase
   tag?: string;
   alias?: string;
 }> {}
-//#endregion
 export {};

package/dist/content-controls/errors.js

@@ -1,5 +1,5 @@
 import { TaggedError } from "better-result";
-//#region src/content-controls/errors.ts
+// src/content-controls/errors.ts
 /**
 * Tagged errors for the content-controls API. Every write helper that
 * refuses a mutation throws one of these; consumers can either bubble the
@@ -35,5 +35,4 @@ var ContentControlBoundError = class extends ContentControlBoundErrorBase {};
 * `w15:repeatingSection` (which would orphan its row items).
 */
 var ContentControlTypeError = class extends ContentControlTypeErrorBase {};
-//#endregion
 export { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError };

package/dist/content-controls/findContentControls.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/content-controls/findContentControls.d.ts
 export type ContentControlFilter = {
   tag?: string;
   alias?: string;
@@ -52,5 +51,4 @@ export declare function findContentControl(doc: document_d_exports.Document, fil
  * Concatenated plain text of every paragraph descendant inside a control,
  * separated by newlines. Useful for template/agent read paths.
  */
-export declare function getContentControlText(control: document_d_exports.BlockSdt): string;
-//#endregion
+export declare function getContentControlText(control: document_d_exports.BlockSdt): string;

package/dist/content-controls/findContentControls.js

@@ -1,5 +1,5 @@
 import { decodeOoxmlSymbolCharacter } from "../utils/ooxmlSymbol.js";
-//#region src/content-controls/findContentControls.ts
+// src/content-controls/findContentControls.ts
 function matches(control, filter) {
 	if (filter.pmPos !== void 0) return false;
 	if (filter.tag !== void 0 && control.properties.tag !== filter.tag) return false;
@@ -73,5 +73,4 @@ function getContentControlText(control) {
 	visit(control.content);
 	return parts.join("\n");
 }
-//#endregion
 export { findContentControl, findContentControls, getContentControlText };

package/dist/content-controls/mutateContentControls.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { ContentControlFilter } from "./findContentControls.js";
-//#region src/content-controls/mutateContentControls.d.ts
 type ForceOption = {
   force?: boolean;
 };
@@ -57,5 +56,4 @@ export declare function setContentControlValue(doc: document_d_exports.Document,
 export declare function removeContentControl(doc: document_d_exports.Document, filter: ContentControlFilter, options?: ForceOption & {
   keepContent?: boolean;
 }): document_d_exports.Document;
-//#endregion
 export {};

package/dist/content-controls/mutateContentControls.js

@@ -4,7 +4,7 @@ import { preservedSdtChild, withoutPreservedSdtChild } from "../docx/sdtProperti
 import { checkboxDisplayContent } from "./checkboxDisplay.js";
 import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "./errors.js";
 import { sanitizeXmlCharacters } from "@stll/docx-core";
-//#region src/content-controls/mutateContentControls.ts
+// src/content-controls/mutateContentControls.ts
 /**
 * Pure (immutable) write helpers for block-level content controls.
 *
@@ -388,5 +388,4 @@ function removeContentControl(doc, filter, options = {}) {
 	if (nextContent.length === 0) nextContent.push(makeParagraphFromText(""));
 	return withUpdatedBodyAndNotes(doc, nextContent, applyMatchToNotes(doc, match));
 }
-//#endregion
 export { isContentLocked, removeContentControl, setContentControlContent, setContentControlValue };

package/dist/controller/activeEditorStory.d.ts

@@ -1,5 +1,4 @@
 import { EditorView } from "prosemirror-view";
-//#region src/controller/activeEditorStory.d.ts
 export type ActiveEditorStoryTarget = {
   type: "note";
   view: EditorView;
@@ -26,5 +25,4 @@ export type ActiveEditorStoryCandidates = {
  * adapters from sending formatting, focus, or history commands to a story
  * hidden behind another active editor surface during an async UI transition.
  */
-export declare const resolveActiveEditorStory: ({ bodyView, headerFooterView, noteView }: ActiveEditorStoryCandidates) => ActiveEditorStoryTarget;
-//#endregion
+export declare const resolveActiveEditorStory: ({ bodyView, headerFooterView, noteView }: ActiveEditorStoryCandidates) => ActiveEditorStoryTarget;

package/dist/controller/activeEditorStory.js

@@ -1,4 +1,4 @@
-//#region src/controller/activeEditorStory.ts
+// src/controller/activeEditorStory.ts
 const NO_ACTIVE_STORY = {
 	type: "none",
 	view: null
@@ -26,5 +26,4 @@ const resolveActiveEditorStory = ({ bodyView, headerFooterView, noteView }) => {
 	};
 	return NO_ACTIVE_STORY;
 };
-//#endregion
 export { resolveActiveEditorStory };

package/dist/controller/canonicalClipboard.d.ts

@@ -3,7 +3,6 @@ import { CanonicalCommit, CanonicalSession, CanonicalSessionError } from "./cano
 import { Slice } from "prosemirror-model";
 import { EditorState } from "prosemirror-state";
 import { Result } from "better-result";
-//#region src/controller/canonicalClipboard.d.ts
 /** Imported comments and notes require copying their source story parts. */
 export declare const canonicalClipboardStoryPartRefusal: (paragraph: document_d_exports.Paragraph) => CanonicalSessionError | undefined;
 /** Clipboard slices are input payloads; their paragraph identities and private captures are not owners. */
@@ -21,5 +20,4 @@ type PrepareCanonicalPasteOptions = {
   };
 };
 export declare const prepareCanonicalPaste: ({ session, state, slice, plain, moveTarget, pasteTarget, sourceDocument, moveSource }: PrepareCanonicalPasteOptions) => Result<CanonicalCommit, CanonicalSessionError>;
-//#endregion
 export {};

package/dist/controller/canonicalClipboard.js

@@ -17,7 +17,7 @@ import { NUMBER_FORMATS, paragraphNumberingReference, relationshipIdOf } from "@
 import { Fragment, Slice } from "prosemirror-model";
 import { CellSelection } from "prosemirror-tables";
 import { packageResourcesOpOf } from "@stll/docx-core/ops";
-//#region src/controller/canonicalClipboard.ts
+// src/controller/canonicalClipboard.ts
 const refuse = (message) => Result.err(new CanonicalSessionError({
 	gap: CANONICAL_GAP.dispatch,
 	message,
@@ -493,5 +493,4 @@ const prepareCanonicalPaste = ({ session, state, slice, plain = false, moveTarge
 		semantic: "paste"
 	});
 };
-//#endregion
 export { canonicalClipboardStoryPartRefusal, prepareCanonicalPaste };

package/dist/controller/canonicalClipboardResources.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { Result } from "better-result";
 import { DocumentOpRefusal } from "@stll/docx-core/ops";
-//#region src/controller/canonicalClipboardResources.d.ts
 /** Normalized HTML states effective CSS; foreign style names carry no package ownership. */
 export declare const flattenClipboardStyleReferences: (paragraphs: readonly document_d_exports.Paragraph[]) => void;
 type ImportClipboardStylesOptions = {
@@ -17,5 +16,4 @@ type ImportedClipboardStyles = {
 };
 /** Import the transitive style/numbering dependencies of the clipboard, retaining destination defaults. */
 export declare const importClipboardStyles: ({ destination, source, paragraphs }: ImportClipboardStylesOptions) => Result<ImportedClipboardStyles, DocumentOpRefusal>;
-//#endregion
 export {};

package/dist/controller/canonicalClipboardResources.js

@@ -10,7 +10,7 @@ import { mergeParagraphFormatting } from "../utils/paragraphFormattingMerge.js";
 import { Result, panic } from "better-result";
 import { BODY_TEXT_OUTLINE_LEVEL, NO_PARAGRAPH_NUMBERING, isThemeColor, themeColorSlot } from "@stll/docx-core/model";
 import { DOCUMENT_OP_REFUSAL_REASONS, DOCUMENT_OP_TYPES, DocumentOpRefusal } from "@stll/docx-core/ops";
-//#region src/controller/canonicalClipboardResources.ts
+// src/controller/canonicalClipboardResources.ts
 const STYLE_REFERENCE_FIELDS = /* @__PURE__ */ new Set([
 	"styleId",
 	"basedOn",
@@ -379,5 +379,4 @@ const importClipboardStyles = ({ destination, source, paragraphs }) => {
 		numberingIds
 	});
 };
-//#endregion
 export { flattenClipboardStyleReferences, importClipboardStyles };

package/dist/controller/canonicalComments.d.ts

@@ -3,7 +3,6 @@ import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 import { Comment } from "../types/content.js";
 import { Err, Ok, TaggedErrorClass } from "better-result";
 import { CreateCommentOp, DocumentOp } from "@stll/docx-core/ops";
-//#region src/controller/canonicalComments.d.ts
 declare const CanonicalCommentErrorBase: TaggedErrorClass<"CanonicalCommentError">;
 export declare class CanonicalCommentError extends CanonicalCommentErrorBase<{
   message: string;
@@ -38,5 +37,4 @@ export declare const compileCanonicalComments: ({ document, command }: CompileCa
   commentId: number | undefined;
 }, never>;
 export declare const canonicalCommentBody: (document: document_d_exports.Document, text: string) => Comment["content"];
-//#endregion
 export {};

package/dist/controller/canonicalComments.js

@@ -2,7 +2,7 @@ import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
 import { Result, TaggedError } from "better-result";
 import { DOCUMENT_OP_TYPES, allocateCommentAnchorIds, applyDocumentOps, packageParagraphIds } from "@stll/docx-core/ops";
-//#region src/controller/canonicalComments.ts
+// src/controller/canonicalComments.ts
 /** The one semantic compiler for canonical sidebar, controlled and public comments. */
 const CanonicalCommentErrorBase = TaggedError("CanonicalCommentError");
 var CanonicalCommentError = class extends CanonicalCommentErrorBase {};
@@ -149,5 +149,4 @@ const canonicalCommentBody = (document, text) => {
 		}]
 	}];
 };
-//#endregion
 export { CanonicalCommentError, canonicalCommentBody, compileCanonicalComments };

package/dist/controller/canonicalComposition.d.ts

@@ -1,6 +1,5 @@
 import { EditorState, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
-//#region src/controller/canonicalComposition.d.ts
 type CompositionOptions = {
   begin: () => boolean;
   end: () => void;
@@ -62,5 +61,4 @@ export declare const createCanonicalComposition: (options: CompositionOptions) =
   reset: () => void;
   accept: (view: EditorView, transaction: Transaction) => boolean;
 };
-//#endregion
 export {};

package/dist/controller/canonicalComposition.js

@@ -5,7 +5,7 @@ import { setCanonicalInputTimer } from "./canonicalInputTimer.js";
 import { CanonicalSessionError } from "./canonicalSession.js";
 import { Result } from "better-result";
 import { EditorState, TextSelection } from "prosemirror-state";
-//#region src/controller/canonicalComposition.ts
+// src/controller/canonicalComposition.ts
 const matchesNativeReplacement = ({ baseline, proposed, from, to, text }) => {
 	const expected = baseline.tr.insertText(text, from, to);
 	if (expected.doc.eq(proposed.doc)) return true;
@@ -394,5 +394,4 @@ const createCanonicalComposition = (options) => {
 		}
 	};
 };
-//#endregion
 export { createCanonicalComposition };

package/dist/controller/canonicalInlineProjection.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { Node } from "prosemirror-model";
 import { Result, TaggedErrorClass } from "better-result";
-//#region src/controller/canonicalInlineProjection.d.ts
 export declare const CANONICAL_SOURCE_INLINE_POLICIES: {
   readonly run: "container";
   readonly hyperlink: "container";
@@ -115,5 +114,4 @@ type CanonicalInlineProjectionArgs = {
 };
 /** Bind rendered gaps to the operation owner's source leaf ordinals, including collapsed pairs. */
 export declare const projectCanonicalInline: ({ source, paragraph, pairedBookmarkIds, commentContext }: CanonicalInlineProjectionArgs) => Result<InlineProjection, InlineProjectionError>;
-//#endregion
 export {};

package/dist/controller/canonicalInlineProjection.js

@@ -10,7 +10,7 @@ import { PRESERVED_XML_LEVELS } from "../prosemirror/schema/nodes.js";
 import { Result, TaggedError, panic } from "better-result";
 import { hasIllegalXmlCharacters } from "@stll/docx-core";
 import { inlineLeafSpans, paragraphLogicalText } from "@stll/docx-core/ops";
-//#region src/controller/canonicalInlineProjection.ts
+// src/controller/canonicalInlineProjection.ts
 const CANONICAL_SOURCE_INLINE_POLICIES = {
 	run: "container",
 	hyperlink: "container",
@@ -504,5 +504,4 @@ const projectCanonicalInline = ({ source, paragraph, pairedBookmarkIds, commentC
 		boundaries
 	});
 };
-//#endregion
 export { CANONICAL_NATIVE_INLINE_POLICIES, CANONICAL_SOURCE_INLINE_POLICIES, canonicalInlineSourceIssue, canonicalNativeCells, projectCanonicalInline };

package/dist/controller/canonicalInput.d.ts

@@ -1,6 +1,5 @@
 import { EditorState, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
-//#region src/controller/canonicalInput.d.ts
 export declare const CANONICAL_COMPOSITION_INPUT_TYPES: readonly ["insertCompositionText", "insertFromComposition", "deleteCompositionText", "deleteByComposition"];
 type ReplaceTextInput = {
   from: number;
@@ -50,5 +49,4 @@ export declare const createCanonicalInputBoundary: (options: CanonicalInputOptio
   refuseNativeMutation: (view: EditorView) => void;
   commitNativeProposal: (view: EditorView, transaction: Transaction) => boolean;
 };
-//#endregion
 export {};

package/dist/controller/canonicalInput.js

@@ -3,7 +3,7 @@ import { createCanonicalComposition } from "./canonicalComposition.js";
 import { deletionRange, isCanonicalJoinBoundary } from "./canonicalSession.js";
 import { ReplaceStep } from "prosemirror-transform";
 import { Selection, TextSelection } from "prosemirror-state";
-//#region src/controller/canonicalInput.ts
+// src/controller/canonicalInput.ts
 const CANONICAL_COMPOSITION_INPUT_TYPES = [
 	"insertCompositionText",
 	"insertFromComposition",
@@ -381,5 +381,4 @@ const createCanonicalInputBoundary = (options) => {
 		}
 	};
 };
-//#endregion
 export { CANONICAL_COMPOSITION_INPUT_TYPES, createCanonicalInputBoundary };

package/dist/controller/canonicalInputTimer.d.ts

@@ -1,5 +1,4 @@
 import { EditorView } from "prosemirror-view";
-//#region src/controller/canonicalInputTimer.d.ts
 /** Shared by timer producers and browser diagnostics, regardless of bundling. */
 export declare const CANONICAL_INPUT_TIMER_OWNER = "folio.canonical-input-timer";
 /** Delay after native composition end before the canonical session settles it. */
@@ -11,5 +10,4 @@ export declare const setCanonicalInputTimer: (callback: () => void, delay: numbe
  * settles on an equal-delay timer armed at native composition end, so a retry
  * armed at or after that point runs after it. Returns a disposer.
  */
-export declare const afterCanonicalCompositionSettles: (view: EditorView, retry: () => void) => (() => void);
-//#endregion
+export declare const afterCanonicalCompositionSettles: (view: EditorView, retry: () => void) => (() => void);

package/dist/controller/canonicalInputTimer.js

@@ -1,4 +1,4 @@
-//#region src/controller/canonicalInputTimer.ts
+// src/controller/canonicalInputTimer.ts
 /** Shared by timer producers and browser diagnostics, regardless of bundling. */
 const CANONICAL_INPUT_TIMER_OWNER = "folio.canonical-input-timer";
 /** Delay after native composition end before the canonical session settles it. */
@@ -30,5 +30,4 @@ const afterCanonicalCompositionSettles = (view, retry) => {
 		if (timer !== void 0) clearTimeout(timer);
 	};
 };
-//#endregion
 export { CANONICAL_COMPOSITION_FLUSH_DELAY_MS, CANONICAL_INPUT_TIMER_OWNER, afterCanonicalCompositionSettles, setCanonicalInputTimer };

package/dist/controller/canonicalListRendering.d.ts

@@ -1,9 +1,7 @@
 import { DocumentOp } from "./canonicalOperations.js";
 import { Document } from "@stll/docx-core";
-//#region src/controller/canonicalListRendering.d.ts
 /** Canonical edits share list model normalization with the headless projection. */
 export declare const normalizeCanonicalListRendering: (document: Document) => {
   document: Document;
   inverse: DocumentOp[];
-};
-//#endregion
+};