@stll/folio-core 0.62.0 → 0.63.0

package/dist/compare/types.d.ts

@@ -5,10 +5,10 @@ import { FolioDocumentStoryHandle, FolioNumberingLevel } from "../ai-edits/headl
 import { CompareVerification, CompareVerificationCause, CompareVerificationFailure, CompareVerificationInvariant, FinalParagraphMarkRevision } from "./verification.js";
 //#region src/compare/types.d.ts
 /** Revision encoding requested for the generated package. */
-declare const COMPARE_REVISION_FORMATS: readonly ["word", "folio-exact"];
-type CompareRevisionFormat = (typeof COMPARE_REVISION_FORMATS)[number];
+export declare const COMPARE_REVISION_FORMATS: readonly ["word", "folio-exact"];
+export type CompareRevisionFormat = (typeof COMPARE_REVISION_FORMATS)[number];
 /** Everything {@link compareDocx} needs; nothing it reads from the ambient clock. */
-type CompareDocxOptions = {
+export type CompareDocxOptions = {
   /** Author recorded on every generated tracked change. */
   author: string;
   /**
@@ -48,7 +48,7 @@ type CompareDocxOptions = {
   revisionFormat?: CompareRevisionFormat;
 };
 /** Where one change sits in the base or target document. */
-type CompareChangeLocation = {
+export type CompareChangeLocation = {
   story: FolioDocumentStoryHandle;
   /** Innermost table cell, when the change is inside a table. */
   cell?: FolioAIBlockTableLocation;
@@ -63,7 +63,7 @@ type CompareChangeLocation = {
  * carries a deletion at the source and an insertion at the destination while
  * the change list keeps the relocation visible.
  */
-type CompareChange = {
+export type CompareChange = {
   kind: "insert";
   location: CompareChangeLocation;
   /** Id of the inserted block in the target document. */
@@ -224,13 +224,13 @@ type CompareChange = {
   baseBlockIds: readonly string[];
 };
 /** Why a part of the package is absent from `changes`. */
-declare const COMPARE_UNSUPPORTED_REASONS: readonly ["story-missing-in-base", "story-missing-in-target", "story-not-editable", "unsupported-content"];
-type CompareUnsupportedReason = (typeof COMPARE_UNSUPPORTED_REASONS)[number];
+export declare const COMPARE_UNSUPPORTED_REASONS: readonly ["story-missing-in-base", "story-missing-in-target", "story-not-editable", "unsupported-content"];
+export type CompareUnsupportedReason = (typeof COMPARE_UNSUPPORTED_REASONS)[number];
 /**
  * A package part the comparison did not cover. Reported rather than dropped so
  * a caller can tell "no differences" from "not looked at".
  */
-type CompareUnsupportedPart = {
+export type CompareUnsupportedPart = {
   reason: CompareUnsupportedReason;
   baseStory: FolioDocumentStoryHandle | null;
   targetStory: FolioDocumentStoryHandle | null;
@@ -243,14 +243,14 @@ type CompareUnsupportedPart = {
  * in Folio before handing a `requires-folio` package to Word when exactness
  * matters.
  */
-type CompareCompatibility = {
+export type CompareCompatibility = {
   status: "standard-ooxml";
 } | {
   status: "requires-folio";
   reasons: readonly [CompareFolioRequirement, ...CompareFolioRequirement[]];
 };
-type CompareFolioRequirement = "section-reference-history" | "terminal-table-carrier";
-type CompareResult = {
+export type CompareFolioRequirement = "section-reference-history" | "terminal-table-carrier";
+export type CompareResult = {
   /** The base package carrying the generated tracked changes. */
   buffer: ArrayBuffer;
   changes: readonly CompareChange[];
@@ -265,13 +265,13 @@ type CompareResult = {
   unsupported: readonly CompareUnsupportedPart[];
 };
 declare const InvalidCompareDocxOptionsError_base: import("better-result").TaggedErrorClass<"InvalidCompareDocxOptionsError">;
-declare class InvalidCompareDocxOptionsError extends InvalidCompareDocxOptionsError_base<{
+export declare class InvalidCompareDocxOptionsError extends InvalidCompareDocxOptionsError_base<{
   message: string;
   option: "timestamp" | "revisionFormat";
   receivedValue: unknown;
 }> {}
 declare const CompareDocxParseError_base: import("better-result").TaggedErrorClass<"CompareDocxParseError">;
-declare class CompareDocxParseError extends CompareDocxParseError_base<{
+export declare class CompareDocxParseError extends CompareDocxParseError_base<{
   message: string;
   side: "base" | "target";
   cause: unknown;
@@ -282,7 +282,7 @@ declare const CompareDocxApplyError_base: import("better-result").TaggedErrorCla
  * would not reproduce the target. Reported instead of returning a package that
  * silently under-represents the difference.
  */
-declare class CompareDocxApplyError extends CompareDocxApplyError_base<{
+export declare class CompareDocxApplyError extends CompareDocxApplyError_base<{
   message: string;
   skipped: readonly FolioAIEditSkippedOperation[];
 }> {}
@@ -293,7 +293,7 @@ declare const CompareDocxRoundTripError_base: import("better-result").TaggedErro
  * quietly loses part of the difference is worse than no redline, so the
  * mismatch is surfaced instead of the document.
  */
-declare class CompareDocxRoundTripError extends CompareDocxRoundTripError_base<{
+export declare class CompareDocxRoundTripError extends CompareDocxRoundTripError_base<{
   message: string;
   story: FolioDocumentStoryHandle;
   /** The invariant that did not hold, and what diverged under it. */
@@ -309,12 +309,12 @@ declare class CompareDocxRoundTripError extends CompareDocxRoundTripError_base<{
 }> {}
 declare const CompareDocxOperationLimitError_base: import("better-result").TaggedErrorClass<"CompareDocxOperationLimitError">;
 /** The difference needs more operations than the engine will generate. */
-declare class CompareDocxOperationLimitError extends CompareDocxOperationLimitError_base<{
+export declare class CompareDocxOperationLimitError extends CompareDocxOperationLimitError_base<{
   message: string;
   limit: number;
 }> {}
 declare const CompareDocxSerializeError_base: import("better-result").TaggedErrorClass<"CompareDocxSerializeError">;
-declare class CompareDocxSerializeError extends CompareDocxSerializeError_base<{
+export declare class CompareDocxSerializeError extends CompareDocxSerializeError_base<{
   message: string;
   cause: unknown;
 }> {}
@@ -325,7 +325,7 @@ declare class CompareDocxSerializeError extends CompareDocxSerializeError_base<{
  * report and the corpus census read the message, and a constant one collapses
  * every distinct save failure into a single undiagnosable row.
  */
-declare const compareDocxSerializeError: (context: string, cause: unknown) => CompareDocxSerializeError;
+export declare const compareDocxSerializeError: (context: string, cause: unknown) => CompareDocxSerializeError;
 declare const CompareDocxFinalParagraphMarkError_base: import("better-result").TaggedErrorClass<"CompareDocxFinalParagraphMarkError">;
 /**
  * A container's final paragraph mark carries a revision, so the package would
@@ -338,11 +338,11 @@ declare const CompareDocxFinalParagraphMarkError_base: import("better-result").T
  * under either `onUnverified` setting: there is no redline to emit when a
  * consumer refuses the file.
  */
-declare class CompareDocxFinalParagraphMarkError extends CompareDocxFinalParagraphMarkError_base<{
+export declare class CompareDocxFinalParagraphMarkError extends CompareDocxFinalParagraphMarkError_base<{
   message: string;
   /** Every container that carries one, each named structurally. */
   revisions: readonly FinalParagraphMarkRevision[];
 }> {}
-type CompareDocxError = CompareDocxApplyError | CompareDocxFinalParagraphMarkError | CompareDocxOperationLimitError | CompareDocxParseError | CompareDocxRoundTripError | CompareDocxSerializeError | InvalidCompareDocxOptionsError;
+export type CompareDocxError = CompareDocxApplyError | CompareDocxFinalParagraphMarkError | CompareDocxOperationLimitError | CompareDocxParseError | CompareDocxRoundTripError | CompareDocxSerializeError | InvalidCompareDocxOptionsError;
 //#endregion
-export { COMPARE_REVISION_FORMATS, COMPARE_UNSUPPORTED_REASONS, CompareChange, CompareChangeLocation, CompareCompatibility, CompareDocxApplyError, CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, CompareFolioRequirement, CompareResult, CompareRevisionFormat, CompareUnsupportedPart, CompareUnsupportedReason, InvalidCompareDocxOptionsError, compareDocxSerializeError };
+export {};

package/dist/compare/verification.d.ts

@@ -3,17 +3,17 @@ 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. */
-declare const COMPARE_VERIFICATION_INVARIANTS: readonly ["accept-reproduces-target", "reject-reproduces-base"];
-type CompareVerificationInvariant = (typeof COMPARE_VERIFICATION_INVARIANTS)[number];
+export declare const COMPARE_VERIFICATION_INVARIANTS: readonly ["accept-reproduces-target", "reject-reproduces-base"];
+export type CompareVerificationInvariant = (typeof COMPARE_VERIFICATION_INVARIANTS)[number];
 /**
  * What diverged. Ordered from the structural to the textual: the first cause
  * that fits is the one reported, because a block in the wrong container is a
  * different finding from a block whose words are wrong even when both are true.
  */
-declare const COMPARE_VERIFICATION_CAUSES: readonly ["invisible-structure", "block-count", "container", "inline-structure", "table-geometry", "section-properties", "style", "list-level", "numbering-source", "alignment", "spacing", "indentation", "inline-formatting", "whitespace", "text"];
-type CompareVerificationCause = (typeof COMPARE_VERIFICATION_CAUSES)[number];
+export declare const COMPARE_VERIFICATION_CAUSES: readonly ["invisible-structure", "block-count", "container", "inline-structure", "table-geometry", "section-properties", "style", "list-level", "numbering-source", "alignment", "spacing", "indentation", "inline-formatting", "whitespace", "text"];
+export type CompareVerificationCause = (typeof COMPARE_VERIFICATION_CAUSES)[number];
 /** One invariant that did not hold, in one story. */
-type CompareVerificationFailure = {
+export type CompareVerificationFailure = {
   invariant: CompareVerificationInvariant;
   cause: CompareVerificationCause;
   story: FolioDocumentStoryHandle;
@@ -27,7 +27,7 @@ type CompareVerificationFailure = {
  * `onUnverified: "emit"`; the default refuses instead, because a redline that
  * reads plausibly and is wrong is worse than no redline.
  */
-type CompareVerification = {
+export type CompareVerification = {
   status: "verified";
 } | {
   status: "unverified";
@@ -60,21 +60,21 @@ type ClassifyOptions<T> = {
  * whether the count itself did — never a property value, which could carry a
  * style name either document chose.
  */
-declare const classifyGeometryMismatch: ({ invariant, story, actual, expected }: ClassifyOptions<string>) => CompareVerificationFailure | null;
+export declare const classifyGeometryMismatch: ({ invariant, story, actual, expected }: ClassifyOptions<string>) => CompareVerificationFailure | null;
 /**
  * The failure two projections describe, or `null` when they agree.
  *
  * Total over the causes by construction: the last branch is unconditional, so
  * a divergence always produces a failure rather than being dropped.
  */
-declare const classifyProjectionMismatch: ({ invariant, story, actual, expected }: ClassifyOptions<ProjectedBlock>) => CompareVerificationFailure | null;
+export declare const classifyProjectionMismatch: ({ invariant, story, actual, expected }: ClassifyOptions<ProjectedBlock>) => CompareVerificationFailure | null;
 /**
  * A container whose last paragraph carries a revision on its mark.
  *
  * Structural facts only — a path through the package model and an index — so
  * the finding is safe to log, report or quote.
  */
-type FinalParagraphMarkRevision = {
+export type FinalParagraphMarkRevision = {
   /** Where the container sits in the package model, e.g. `package.document.content`. */
   container: string;
   /** The paragraph's index among its container's children. */
@@ -104,8 +104,8 @@ type FinalParagraphMarkRevision = {
  * preserves the way it preserves everything else it parses. What this proves
  * is that the comparison writes none of its own.
  */
-declare const revisedFinalParagraphMarks: (packageModel: unknown, { since }?: {
+export declare const revisedFinalParagraphMarks: (packageModel: unknown, { since }?: {
   since?: number;
 }) => FinalParagraphMarkRevision[];
 //#endregion
-export { COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareVerification, CompareVerificationCause, CompareVerificationFailure, CompareVerificationInvariant, FinalParagraphMarkRevision, classifyGeometryMismatch, classifyProjectionMismatch, revisedFinalParagraphMarks };
+export {};

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

@@ -12,6 +12,6 @@ type CheckboxDisplayContent = Extract<document_d_exports.RunContent, {
  *   `SdtProperties.preserved`. A control that carries none — one built in
  *   code, or one whose author wrote no glyphs — gets Word's own defaults.
  */
-declare const checkboxDisplayContent: (checkboxXml: string | undefined, checked: boolean) => CheckboxDisplayContent;
+export declare const checkboxDisplayContent: (checkboxXml: string | undefined, checked: boolean) => CheckboxDisplayContent;
 //#endregion
-export { checkboxDisplayContent };
+export {};

package/dist/content-controls/checkboxDisplay.js

@@ -26,7 +26,8 @@ const checkboxDisplayContent = (checkboxXml, checked) => {
 	} catch {
 		return defaultDisplay(checked);
 	}
-	const state = findChildByNamespaceUri(findChildByNamespaceUri(root, CHECKBOX_NAMESPACE_URIS, "checkbox"), CHECKBOX_NAMESPACE_URIS, checked ? "checkedState" : "uncheckedState");
+	const checkbox = findChildByNamespaceUri(root, CHECKBOX_NAMESPACE_URIS, "checkbox");
+	const state = findChildByNamespaceUri(checkbox, CHECKBOX_NAMESPACE_URIS, checked ? "checkedState" : "uncheckedState");
 	const rawCharacter = getAttributeByNamespaceUri(state, CHECKBOX_NAMESPACE_URIS, "val");
 	if (!rawCharacter || !HEX_CODE_POINT.test(rawCharacter)) return defaultDisplay(checked);
 	const codePoint = Number.parseInt(rawCharacter, 16);

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

@@ -6,7 +6,7 @@ declare const ContentControlLockedError_base: import("better-result").TaggedErro
  * mutation. Caller can override with `{ force: true }` if they understand
  * the consequences (overrides apply per call, not per document).
  */
-declare class ContentControlLockedError extends ContentControlLockedError_base<{
+export declare class ContentControlLockedError extends ContentControlLockedError_base<{
   message: string;
   lock: NonNullable<document_d_exports.SdtProperties["lock"]>;
   tag?: string;
@@ -27,7 +27,7 @@ declare const ContentControlBoundError_base: import("better-result").TaggedError
  * Reference: python-docx #965, Aspose forum thread on removing custom
  * XML mapping before content updates.
  */
-declare class ContentControlBoundError extends ContentControlBoundError_base<{
+export declare class ContentControlBoundError extends ContentControlBoundError_base<{
   message: string;
   xpath: string;
   storeItemID?: string;
@@ -40,7 +40,7 @@ declare const ContentControlTypeError_base: import("better-result").TaggedErrorC
  * control's type — e.g. setting free text on a checkbox, or unwrapping a
  * `w15:repeatingSection` (which would orphan its row items).
  */
-declare class ContentControlTypeError extends ContentControlTypeError_base<{
+export declare class ContentControlTypeError extends ContentControlTypeError_base<{
   message: string;
   sdtType: document_d_exports.SdtProperties["sdtType"];
   reason: string;
@@ -48,4 +48,4 @@ declare class ContentControlTypeError extends ContentControlTypeError_base<{
   alias?: string;
 }> {}
 //#endregion
-export { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError };
+export {};

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

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/content-controls/findContentControls.d.ts
-type ContentControlFilter = {
+export type ContentControlFilter = {
   tag?: string;
   alias?: string;
   /** OOXML numeric `w:id`. */
@@ -24,7 +24,7 @@ type ContentControlFilter = {
  * the silent default; matches inside a footnote or endnote carry the
  * note's numeric id so callers can route the right mutate API at it.
  */
-type ContentControlLocation = {
+export type ContentControlLocation = {
   kind: "body";
 } | {
   kind: "footnote";
@@ -33,7 +33,7 @@ type ContentControlLocation = {
   kind: "endnote";
   noteId: number;
 };
-type ContentControlMatch = {
+export type ContentControlMatch = {
   control: document_d_exports.BlockSdt;
   /** Outer→inner stack of enclosing controls (empty when at the body root). */
   ancestry: document_d_exports.BlockSdt[];
@@ -46,12 +46,11 @@ type ContentControlMatch = {
    */
   location: ContentControlLocation;
 };
-declare function findContentControls(doc: document_d_exports.Document, filter?: ContentControlFilter): ContentControlMatch[];
-declare function findContentControl(doc: document_d_exports.Document, filter: ContentControlFilter): ContentControlMatch | null;
+export declare function findContentControls(doc: document_d_exports.Document, filter?: ContentControlFilter): ContentControlMatch[];
+export declare function findContentControl(doc: document_d_exports.Document, filter: ContentControlFilter): ContentControlMatch | null;
 /**
  * Concatenated plain text of every paragraph descendant inside a control,
  * separated by newlines. Useful for template/agent read paths.
  */
-declare function getContentControlText(control: document_d_exports.BlockSdt): string;
-//#endregion
-export { ContentControlFilter, ContentControlLocation, ContentControlMatch, findContentControl, findContentControls, getContentControlText };
+export declare function getContentControlText(control: document_d_exports.BlockSdt): string;
+//#endregion

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

@@ -4,8 +4,8 @@ import { ContentControlFilter } from "./findContentControls.js";
 type ForceOption = {
   force?: boolean;
 };
-type SetContentControlContentInput = string | document_d_exports.BlockContent[];
-type SetContentControlValueInput = {
+export type SetContentControlContentInput = string | document_d_exports.BlockContent[];
+export type SetContentControlValueInput = {
   kind: "dropdown";
   value: string;
 } | {
@@ -15,6 +15,17 @@ type SetContentControlValueInput = {
   kind: "date";
   date: string;
 };
+/**
+ * Refuse content mutations (setContentControlContent /
+ * setContentControlValue) when `w:lock` forbids them.
+ *
+ * Per OOXML §17.5.2.16:
+ * - `contentLocked` blocks content edits but allows the container to be
+ *   removed.
+ * - `sdtContentLocked` blocks both.
+ * - `sdtLocked` blocks only container removal, NOT content edits.
+ */
+export declare const isContentLocked: (lock: document_d_exports.SdtProperties["lock"]) => lock is "contentLocked" | "sdtContentLocked";
 /**
  * Replace a control's inner content. Plain text becomes one paragraph; an
  * explicit `BlockContent[]` is deep-cloned to preserve immutability. The
@@ -31,20 +42,20 @@ type SetContentControlValueInput = {
  * same session; persisting requires extending the selective-save layer
  * to re-serialize note parts.
  */
-declare function setContentControlContent(doc: document_d_exports.Document, filter: ContentControlFilter, input: SetContentControlContentInput, options?: ForceOption): document_d_exports.Document;
+export declare function setContentControlContent(doc: document_d_exports.Document, filter: ContentControlFilter, input: SetContentControlContentInput, options?: ForceOption): document_d_exports.Document;
 /**
  * Set a structured value on a typed control. Dropdown / checkbox / date
  * each get their own input shape so the input is type-checked at the
  * call site.
  */
-declare function setContentControlValue(doc: document_d_exports.Document, filter: ContentControlFilter, input: SetContentControlValueInput, options?: ForceOption): document_d_exports.Document;
+export declare function setContentControlValue(doc: document_d_exports.Document, filter: ContentControlFilter, input: SetContentControlValueInput, options?: ForceOption): document_d_exports.Document;
 /**
  * Remove a control. With `{ keepContent: true }` the inner blocks survive
  * in-place; otherwise the control and its children are dropped. Refuses to
  * unwrap a `w15:repeatingSection` (would orphan w15 row items).
  */
-declare function removeContentControl(doc: document_d_exports.Document, filter: ContentControlFilter, options?: ForceOption & {
+export declare function removeContentControl(doc: document_d_exports.Document, filter: ContentControlFilter, options?: ForceOption & {
   keepContent?: boolean;
 }): document_d_exports.Document;
 //#endregion
-export { SetContentControlContentInput, SetContentControlValueInput, removeContentControl, setContentControlContent, setContentControlValue };
+export {};

package/dist/content-controls/mutateContentControls.js

@@ -78,10 +78,11 @@ function throwLocked(control, lock) {
 * - `sdtContentLocked` blocks both.
 * - `sdtLocked` blocks only container removal, NOT content edits.
 */
+const isContentLocked = (lock) => lock === "contentLocked" || lock === "sdtContentLocked";
 function ensureContentNotLocked(control, force) {
 	if (force) return;
 	const lock = control.properties.lock;
-	if (lock === "contentLocked" || lock === "sdtContentLocked") throwLocked(control, lock);
+	if (isContentLocked(lock)) throwLocked(control, lock);
 }
 /**
 * Refuse container removal (removeContentControl) when `w:lock` forbids it.
@@ -388,4 +389,4 @@ function removeContentControl(doc, filter, options = {}) {
 	return withUpdatedBodyAndNotes(doc, nextContent, applyMatchToNotes(doc, match));
 }
 //#endregion
-export { removeContentControl, setContentControlContent, setContentControlValue };
+export { isContentLocked, removeContentControl, setContentControlContent, setContentControlValue };

package/dist/controller/activeEditorStory.d.ts

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

package/dist/controller/canonicalClipboard.d.ts

@@ -5,7 +5,7 @@ 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. */
-declare const canonicalClipboardStoryPartRefusal: (paragraph: document_d_exports.Paragraph) => CanonicalSessionError | undefined;
+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. */
 type PrepareCanonicalPasteOptions = {
   session: CanonicalSession;
@@ -20,6 +20,6 @@ type PrepareCanonicalPasteOptions = {
     to: number;
   };
 };
-declare const prepareCanonicalPaste: ({ session, state, slice, plain, moveTarget, pasteTarget, sourceDocument, moveSource }: PrepareCanonicalPasteOptions) => Result<CanonicalCommit, CanonicalSessionError>;
+export declare const prepareCanonicalPaste: ({ session, state, slice, plain, moveTarget, pasteTarget, sourceDocument, moveSource }: PrepareCanonicalPasteOptions) => Result<CanonicalCommit, CanonicalSessionError>;
 //#endregion
-export { canonicalClipboardStoryPartRefusal, prepareCanonicalPaste };
+export {};

package/dist/controller/canonicalClipboard.js

@@ -15,6 +15,7 @@ import { CanonicalSessionError } from "./canonicalSession.js";
 import { Result } from "better-result";
 import { NUMBER_FORMATS, paragraphNumberingReference, relationshipIdOf } from "@stll/docx-core/model";
 import { Fragment, Slice } from "prosemirror-model";
+import { CellSelection } from "prosemirror-tables";
 import { packageResourcesOpOf } from "@stll/docx-core/ops";
 //#region src/controller/canonicalClipboard.ts
 const refuse = (message) => Result.err(new CanonicalSessionError({
@@ -24,7 +25,7 @@ const refuse = (message) => Result.err(new CanonicalSessionError({
 }));
 const IMAGE_RELATIONSHIP = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
 const HYPERLINK_RELATIONSHIP = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
-const MAX_CLIPBOARD_IMAGE_BYTES = 16 * 1024 * 1024;
+const MAX_CLIPBOARD_IMAGE_BYTES = 16777216;
 const isNumberFormat = (format) => NUMBER_FORMATS.some((value) => value === format);
 const numberFormatFields = (format) => {
 	if (isNumberFormat(format)) return { numFmt: format };
@@ -230,6 +231,7 @@ const prepareCanonicalPaste = ({ session, state, slice, plain = false, moveTarge
 		paragraphs.push(paragraph);
 	}
 	if (moveTarget === void 0 && (plain || sourceDocument === void 0)) flattenClipboardStyleReferences(paragraphs);
+	if (state.selection instanceof CellSelection) return refuse("Pasting over selected cells requires a per-cell paste operation.");
 	const selectionRange = canonicalSelectionRange(state);
 	const from = session.projection.addressAt(pasteTarget ?? moveSource?.from ?? selectionRange.from);
 	if (from.isErr()) return from;

package/dist/controller/canonicalClipboardResources.d.ts

@@ -3,7 +3,7 @@ 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. */
-declare const flattenClipboardStyleReferences: (paragraphs: readonly document_d_exports.Paragraph[]) => void;
+export declare const flattenClipboardStyleReferences: (paragraphs: readonly document_d_exports.Paragraph[]) => void;
 type ImportClipboardStylesOptions = {
   destination: document_d_exports.Document;
   source: document_d_exports.Document;
@@ -16,6 +16,6 @@ type ImportedClipboardStyles = {
   numberingIds: ReadonlySet<number>;
 };
 /** Import the transitive style/numbering dependencies of the clipboard, retaining destination defaults. */
-declare const importClipboardStyles: ({ destination, source, paragraphs }: ImportClipboardStylesOptions) => Result<ImportedClipboardStyles, DocumentOpRefusal>;
+export declare const importClipboardStyles: ({ destination, source, paragraphs }: ImportClipboardStylesOptions) => Result<ImportedClipboardStyles, DocumentOpRefusal>;
 //#endregion
-export { flattenClipboardStyleReferences, importClipboardStyles };
+export {};

package/dist/controller/canonicalClipboardResources.js

@@ -93,12 +93,13 @@ const lowerSourceTheme = ({ value, source }) => {
 			unavailable = `The source package does not resolve theme colour ${item}.`;
 			return;
 		}
-		const resolved = resolveColorToHex({
+		const color = {
 			themeColor: item,
 			...typeof rgb === "string" ? { rgb } : {},
 			...typeof tint === "string" ? { themeTint: tint } : {},
 			...typeof shade === "string" ? { themeShade: shade } : {}
-		}, source.package.theme);
+		};
+		const resolved = resolveColorToHex(color, source.package.theme);
 		if (resolved === void 0) {
 			unavailable = `The source package does not resolve theme colour ${item}.`;
 			return;

package/dist/controller/canonicalComments.d.ts

@@ -4,11 +4,11 @@ import { Comment } from "../types/content.js";
 import { CreateCommentOp, DocumentOp } from "@stll/docx-core/ops";
 //#region src/controller/canonicalComments.d.ts
 declare const CanonicalCommentError_base: import("better-result").TaggedErrorClass<"CanonicalCommentError">;
-declare class CanonicalCommentError extends CanonicalCommentError_base<{
+export declare class CanonicalCommentError extends CanonicalCommentError_base<{
   message: string;
   gap: typeof CANONICAL_GAP.comments;
 }> {}
-type CanonicalCommentCommand = {
+export type CanonicalCommentCommand = {
   type: "create";
   comment: CreateCommentOp["comment"];
   anchor: CreateCommentOp["anchor"];
@@ -31,11 +31,11 @@ type CompileCanonicalCommentsOptions = {
   document: document_d_exports.Document;
   command: CanonicalCommentCommand;
 };
-declare const compileCanonicalComments: ({ document, command }: CompileCanonicalCommentsOptions) => import("better-result").Err<never, CanonicalCommentError> | import("better-result").Ok<{
+export declare const compileCanonicalComments: ({ document, command }: CompileCanonicalCommentsOptions) => import("better-result").Err<never, CanonicalCommentError> | import("better-result").Ok<{
   ops: DocumentOp[];
   document: document_d_exports.Document;
   commentId: number | undefined;
 }, never>;
-declare const canonicalCommentBody: (document: document_d_exports.Document, text: string) => Comment["content"];
+export declare const canonicalCommentBody: (document: document_d_exports.Document, text: string) => Comment["content"];
 //#endregion
-export { CanonicalCommentCommand, CanonicalCommentError, canonicalCommentBody, compileCanonicalComments };
+export {};

package/dist/controller/canonicalComposition.d.ts

@@ -43,7 +43,7 @@ type CompositionFinish = {
   text: string | null;
 };
 /** Native IME owns the provisional view; the captured canonical projection stays unchanged. */
-declare const createCanonicalComposition: (options: CompositionOptions) => {
+export declare const createCanonicalComposition: (options: CompositionOptions) => {
   readonly status: CompositionState["type"];
   readonly active: boolean;
   matchesCancellationRange: (view: EditorView, range: {
@@ -63,4 +63,4 @@ declare const createCanonicalComposition: (options: CompositionOptions) => {
   accept: (view: EditorView, transaction: Transaction) => boolean;
 };
 //#endregion
-export { createCanonicalComposition };
+export {};

package/dist/controller/canonicalComposition.js

@@ -253,20 +253,17 @@ const createCanonicalComposition = (options) => {
 						}
 					};
 					break;
-				case "refused":
-					state = {
-						type: "refused",
-						baseline: state.baseline,
-						view: state.view,
-						phase: {
-							type: "ended",
-							data,
-							completion: state.phase.completion
-						},
-						text: state.text
-					};
-					break;
-				default:
+				case "refused": state = {
+					type: "refused",
+					baseline: state.baseline,
+					view: state.view,
+					phase: {
+						type: "ended",
+						data,
+						completion: state.phase.completion
+					},
+					text: state.text
+				};
 			}
 			schedule(view);
 		},

package/dist/controller/canonicalInlineProjection.d.ts

@@ -2,7 +2,7 @@ import { document_d_exports } from "../types/document.js";
 import { Node } from "prosemirror-model";
 import { Result } from "better-result";
 //#region src/controller/canonicalInlineProjection.d.ts
-declare const CANONICAL_SOURCE_INLINE_POLICIES: {
+export declare const CANONICAL_SOURCE_INLINE_POLICIES: {
   readonly run: "container";
   readonly hyperlink: "container";
   readonly insertion: "container";
@@ -40,9 +40,10 @@ declare const CANONICAL_SOURCE_INLINE_POLICIES: {
   readonly drawing: "leaf";
   readonly shape: "leaf";
 };
-declare const CANONICAL_NATIVE_INLINE_POLICIES: {
+export declare const CANONICAL_NATIVE_INLINE_POLICIES: {
   readonly text: "text";
   readonly bookmarkBoundary: "markers";
+  readonly commentRangeBoundary: "markers";
   readonly moveRangeBoundary: "markers";
   readonly rangeAnchor: "markers";
   readonly noteMarker: "noteMarker";
@@ -66,7 +67,7 @@ declare class InlineProjectionError extends InlineProjectionError_base<{
   message: string;
 }> {}
 /** Every source variant makes a decision before conversion can discard its positions. */
-declare const canonicalInlineSourceIssue: (items: readonly (document_d_exports.ParagraphContent | document_d_exports.RunContent)[], context?: "paragraph" | "fieldPayload") => string | null;
+export declare const canonicalInlineSourceIssue: (items: readonly (document_d_exports.ParagraphContent | document_d_exports.RunContent)[], context?: "paragraph" | "fieldPayload") => string | null;
 type NativeCell = {
   type: "text";
   text: string;
@@ -93,8 +94,8 @@ type NativeCell = {
   node: Node;
 };
 /** Native positions and deletion geometry read the same inline-cell classification. */
-declare const canonicalNativeCells: (paragraph: Node) => Result<NativeCell[], InlineProjectionError>;
-type CanonicalInlineGap = {
+export declare const canonicalNativeCells: (paragraph: Node) => Result<NativeCell[], InlineProjectionError>;
+export type CanonicalInlineGap = {
   position: number;
   zeroWidthBefore: number;
 };
@@ -113,6 +114,6 @@ type CanonicalInlineProjectionArgs = {
   };
 };
 /** Bind rendered gaps to the operation owner's source leaf ordinals, including collapsed pairs. */
-declare const projectCanonicalInline: ({ source, paragraph, pairedBookmarkIds, commentContext }: CanonicalInlineProjectionArgs) => Result<InlineProjection, InlineProjectionError>;
+export declare const projectCanonicalInline: ({ source, paragraph, pairedBookmarkIds, commentContext }: CanonicalInlineProjectionArgs) => Result<InlineProjection, InlineProjectionError>;
 //#endregion
-export { CANONICAL_NATIVE_INLINE_POLICIES, CANONICAL_SOURCE_INLINE_POLICIES, CanonicalInlineGap, canonicalInlineSourceIssue, canonicalNativeCells, projectCanonicalInline };
+export {};