@stll/folio-core 0.62.0 → 0.63.1

package/dist/docx/paragraphPropertySource.d.ts

@@ -2,6 +2,7 @@ import { document_d_exports } from "../types/document.js";
 import { ModeledParagraphFormattingEmission } from "../internal/paragraphFormattingSerialization.js";
 import { Fragment, Mark, Node, NodeType } from "prosemirror-model";
 import { Transaction } from "prosemirror-state";
+import { TaggedErrorClass } from "better-result";
 //#region src/docx/paragraphPropertySource.d.ts
 declare const paragraphPropertySourceEmissionFingerprint: unique symbol;
 declare const paragraphPropertySourceIndentationBaseline: unique symbol;
@@ -17,61 +18,61 @@ type SameParagraphIndentationProjectionOptions = {
   right: document_d_exports.Paragraph;
 };
 /** Fixed points retain both authored indentation and its effective baseline. */
-declare const sameParagraphIndentationProjection: ({ left, right }: SameParagraphIndentationProjectionOptions) => boolean;
+export declare const sameParagraphIndentationProjection: ({ left, right }: SameParagraphIndentationProjectionOptions) => boolean;
 type CopyParagraphIndentationProjectionOptions = {
   target: document_d_exports.Paragraph;
   source: document_d_exports.Paragraph;
 };
 /** Retain effective-value provenance without copying a durable source identity. */
-declare const copyParagraphIndentationProjection: ({ target, source }: CopyParagraphIndentationProjectionOptions) => void;
+export declare const copyParagraphIndentationProjection: ({ target, source }: CopyParagraphIndentationProjectionOptions) => void;
 /** History restores its captured authored/effective baseline before normalization. */
-declare const restoreParagraphIndentationProjection: ({ target, source }: CopyParagraphIndentationProjectionOptions) => void;
+export declare const restoreParagraphIndentationProjection: ({ target, source }: CopyParagraphIndentationProjectionOptions) => void;
 type AssignParagraphIndentationProjectionOptions = {
   paragraph: document_d_exports.Paragraph;
   authored: document_d_exports.ParagraphFormatting | undefined;
   inherited: IndentationFormatting;
 };
 /** Keep the model's effective indentation without making inherited values authored. */
-declare const assignParagraphIndentationProjection: ({ paragraph, authored, inherited }: AssignParagraphIndentationProjectionOptions) => void;
-declare const PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR = "_docxParagraphSourceToken";
-declare const PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR = "_docxParagraphSourceContract";
+export declare const assignParagraphIndentationProjection: ({ paragraph, authored, inherited }: AssignParagraphIndentationProjectionOptions) => void;
+export declare const PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR = "_docxParagraphSourceToken";
+export declare const PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR = "_docxParagraphSourceContract";
 /** Durable identity nested inside opaque collapsed-cell ProseMirror attrs; stripped on restore. */
-declare const TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR = "_docxParagraphSourceBinding";
-declare const PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES: readonly ["contract_mismatch", "duplicate_token", "invalid_token", "unknown_token"];
-type ParagraphPropertySourceValidationCode = (typeof PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES)[number];
-declare const TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS: readonly ["complexity_limit", "cyclic_or_aliased_graph", "depth_limit", "expected_array", "expected_block", "expected_cell", "expected_inline_content", "expected_paragraph", "expected_record", "expected_row", "invalid_binding", "invalid_block_type", "invalid_cell_type", "invalid_graph_value", "invalid_inline_content_type", "invalid_paragraph_type", "invalid_row_type", "malformed_source_token"];
-type TableCellParagraphSourcePayloadErrorClassification = (typeof TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS)[number];
-declare const ParagraphPropertySourceValidationError_base: import("better-result").TaggedErrorClass<"ParagraphPropertySourceValidationError">;
-declare class ParagraphPropertySourceValidationError extends ParagraphPropertySourceValidationError_base<{
+export declare const TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR = "_docxParagraphSourceBinding";
+export declare const PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES: readonly ["contract_mismatch", "duplicate_token", "invalid_token", "unknown_token"];
+export type ParagraphPropertySourceValidationCode = (typeof PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES)[number];
+export declare const TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS: readonly ["complexity_limit", "cyclic_or_aliased_graph", "depth_limit", "expected_array", "expected_block", "expected_cell", "expected_inline_content", "expected_paragraph", "expected_record", "expected_row", "invalid_binding", "invalid_block_type", "invalid_cell_type", "invalid_graph_value", "invalid_inline_content_type", "invalid_paragraph_type", "invalid_row_type", "malformed_source_token"];
+export type TableCellParagraphSourcePayloadErrorClassification = (typeof TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS)[number];
+declare const ParagraphPropertySourceValidationErrorBase: TaggedErrorClass<"ParagraphPropertySourceValidationError">;
+export declare class ParagraphPropertySourceValidationError extends ParagraphPropertySourceValidationErrorBase<{
   code: ParagraphPropertySourceValidationCode;
   classification?: TableCellParagraphSourcePayloadErrorClassification;
   message: string;
   path?: string;
 }> {}
-declare const isParagraphPropertySourceToken: (token: unknown) => token is string;
+export declare const isParagraphPropertySourceToken: (token: unknown) => token is string;
 /** True only for a body-story token derived from the exact source contract. */
-declare const paragraphPropertySourceTokenMatchesContract: (token: unknown, contract: string) => token is string;
+export declare const paragraphPropertySourceTokenMatchesContract: (token: unknown, contract: string) => token is string;
 /** Visit the v1 provenance scope in canonical OOXML body-story order. */
-declare const visitDocumentStoryParagraphs: (content: document_d_exports.Document["package"]["document"]["content"], visit: (paragraph: document_d_exports.Paragraph) => void) => void;
-declare const assignParagraphPropertySource: (paragraph: document_d_exports.Paragraph, xml: string) => void;
-declare const getParagraphPropertySource: (paragraph: document_d_exports.Paragraph) => ParagraphPropertySource | undefined;
+export declare const visitDocumentStoryParagraphs: (content: document_d_exports.Document["package"]["document"]["content"], visit: (paragraph: document_d_exports.Paragraph) => void) => void;
+export declare const assignParagraphPropertySource: (paragraph: document_d_exports.Paragraph, xml: string) => void;
+export declare const getParagraphPropertySource: (paragraph: document_d_exports.Paragraph) => ParagraphPropertySource | undefined;
 /** Read authored indentation while preserving edits to the parsed effective values. */
-declare const paragraphFormattingWithAuthoredIndentation: (paragraph: document_d_exports.Paragraph) => document_d_exports.ParagraphFormatting | undefined;
+export declare const paragraphFormattingWithAuthoredIndentation: (paragraph: document_d_exports.Paragraph) => document_d_exports.ParagraphFormatting | undefined;
 /** Equal effective values must not replay a capture that lacks newly authored indentation. */
-declare const paragraphPropertySourceMatchesAuthoredIndentation: (paragraph: document_d_exports.Paragraph) => boolean;
-declare const paragraphPropertySourceMatchesEmission: (source: ParagraphPropertySource, emission: ModeledParagraphFormattingEmission) => boolean;
+export declare const paragraphPropertySourceMatchesAuthoredIndentation: (paragraph: document_d_exports.Paragraph) => boolean;
+export declare const paragraphPropertySourceMatchesEmission: (source: ParagraphPropertySource, emission: ModeledParagraphFormattingEmission) => boolean;
 /** Copy the captured `w:pPr` without claiming the source paragraph's durable identity. */
-declare const copyParagraphPropertyCapture: (target: document_d_exports.Paragraph, source: document_d_exports.Paragraph) => void;
-declare const copyParagraphPropertySource: (target: document_d_exports.Paragraph, source: document_d_exports.Paragraph) => void;
+export declare const copyParagraphPropertyCapture: (target: document_d_exports.Paragraph, source: document_d_exports.Paragraph) => void;
+export declare const copyParagraphPropertySource: (target: document_d_exports.Paragraph, source: document_d_exports.Paragraph) => void;
 /** Bind parsed body paragraphs to one exact source package. */
-declare const assignDocumentParagraphPropertySourceContract: (document: document_d_exports.Document, sourceDigest: string) => void;
-declare const getDocumentParagraphPropertySourceContract: (document: document_d_exports.Document) => string | undefined;
-declare const copyDocumentParagraphPropertySources: (document: document_d_exports.Document) => Map<string, document_d_exports.Paragraph> | undefined;
-declare const paragraphPropertySourceBelongsToDocument: (paragraph: document_d_exports.Paragraph, document: document_d_exports.Document) => boolean;
-declare const getProseDocumentParagraphPropertySourceContract: (document: Node) => string | null;
-declare const getProseParagraphPropertySourceToken: (paragraph: Node) => unknown;
-declare const copyDocumentParagraphPropertySourceContract: (target: document_d_exports.Document, source: document_d_exports.Document) => void;
-declare const getParagraphPropertySourceToken: (paragraph: document_d_exports.Paragraph) => string | undefined;
+export declare const assignDocumentParagraphPropertySourceContract: (document: document_d_exports.Document, sourceDigest: string) => void;
+export declare const getDocumentParagraphPropertySourceContract: (document: document_d_exports.Document) => string | undefined;
+export declare const copyDocumentParagraphPropertySources: (document: document_d_exports.Document) => Map<string, document_d_exports.Paragraph> | undefined;
+export declare const paragraphPropertySourceBelongsToDocument: (paragraph: document_d_exports.Paragraph, document: document_d_exports.Document) => boolean;
+export declare const getProseDocumentParagraphPropertySourceContract: (document: Node) => string | null;
+export declare const getProseParagraphPropertySourceToken: (paragraph: Node) => unknown;
+export declare const copyDocumentParagraphPropertySourceContract: (target: document_d_exports.Document, source: document_d_exports.Document) => void;
+export declare const getParagraphPropertySourceToken: (paragraph: document_d_exports.Paragraph) => string | undefined;
 type ParagraphSourceIdentity = {
   type: "durable";
   token: string;
@@ -85,51 +86,51 @@ type ParagraphSourceIdentity = {
   type: "invalid";
 };
 /** Byte captures can follow derivations; only explicit copies carry durable tokens. */
-declare const inspectParagraphSourceIdentity: (paragraph: document_d_exports.Paragraph, document: document_d_exports.Document) => ParagraphSourceIdentity;
+export declare const inspectParagraphSourceIdentity: (paragraph: document_d_exports.Paragraph, document: document_d_exports.Document) => ParagraphSourceIdentity;
 type ParagraphCloneOverrides = Omit<Partial<document_d_exports.Paragraph>, "type">;
 /** Clone a paragraph while deliberately retaining its parsed `w:pPr` owner. */
-declare const cloneParagraphWithPropertySource: (paragraph: document_d_exports.Paragraph, overrides: ParagraphCloneOverrides) => document_d_exports.Paragraph;
+export declare const cloneParagraphWithPropertySource: (paragraph: document_d_exports.Paragraph, overrides: ParagraphCloneOverrides) => document_d_exports.Paragraph;
 /** Clone a paragraph whose formatting provenance is deliberately no longer applicable. */
-declare const cloneParagraphWithoutPropertySource: (paragraph: document_d_exports.Paragraph, overrides: ParagraphCloneOverrides) => document_d_exports.Paragraph;
+export declare const cloneParagraphWithoutPropertySource: (paragraph: document_d_exports.Paragraph, overrides: ParagraphCloneOverrides) => document_d_exports.Paragraph;
 /**
  * Deep-clone a document and transfer each private paragraph capture across the
  * exact graph clone. `structuredClone` preserves graph topology, so any count
  * mismatch is an internal invariant failure rather than a position heuristic.
  */
-declare const cloneDocumentWithParagraphPropertySources: (document: document_d_exports.Document) => document_d_exports.Document;
-type TableCellParagraphPropertySourceBinding = Readonly<{
+export declare const cloneDocumentWithParagraphPropertySources: (document: document_d_exports.Document) => document_d_exports.Document;
+export type TableCellParagraphPropertySourceBinding = Readonly<{
   type: "authored";
 }> | Readonly<{
   token: string;
   type: "source";
 }>;
 declare const decodedTableCellParagraphSourcePayloadBrand: unique symbol;
-type DecodedTableCellParagraphSourcePayload = Readonly<{
+export type DecodedTableCellParagraphSourcePayload = Readonly<{
   [decodedTableCellParagraphSourcePayloadBrand]: true;
   cells: readonly document_d_exports.TableCell[];
 }>;
 /** Decode and freeze the opaque collapsed-cell wire payload before typed use. */
-declare const decodeTableCellParagraphSourcePayload: (value: unknown) => DecodedTableCellParagraphSourcePayload;
+export declare const decodeTableCellParagraphSourcePayload: (value: unknown) => DecodedTableCellParagraphSourcePayload;
 /** Prepare opaque continuation cells for ProseMirror and Yjs transport. */
-declare const transportTableCellsWithParagraphPropertySources: (cells: document_d_exports.TableCell[]) => document_d_exports.TableCell[];
+export declare const transportTableCellsWithParagraphPropertySources: (cells: document_d_exports.TableCell[]) => document_d_exports.TableCell[];
 /** Restore decoded identities privately and remove them from the document model. */
-declare const restoreTableCellsWithParagraphPropertySources: (payload: DecodedTableCellParagraphSourcePayload) => document_d_exports.TableCell[];
+export declare const restoreTableCellsWithParagraphPropertySources: (payload: DecodedTableCellParagraphSourcePayload) => document_d_exports.TableCell[];
 /** Visit every transported hidden paragraph in canonical cell-story order. */
-declare const visitTableCellParagraphPropertySourceBindings: (payload: DecodedTableCellParagraphSourcePayload, visit: (binding: TableCellParagraphPropertySourceBinding, path: string) => void) => void;
+export declare const visitTableCellParagraphPropertySourceBindings: (payload: DecodedTableCellParagraphSourcePayload, visit: (binding: TableCellParagraphPropertySourceBinding, path: string) => void) => void;
 /**
  * Clone package-crossing vertical-merge payloads with their captured `w:pPr`,
  * but without the durable paragraph tokens owned by the source package.
  */
-declare const cloneTableCellsWithParagraphPropertyCaptures: (payload: DecodedTableCellParagraphSourcePayload) => document_d_exports.TableCell[];
-declare const linkProseParagraphPropertySource: (proseParagraph: Node, sourceParagraph: document_d_exports.Paragraph) => void;
+export declare const cloneTableCellsWithParagraphPropertyCaptures: (payload: DecodedTableCellParagraphSourcePayload) => document_d_exports.TableCell[];
+export declare const linkProseParagraphPropertySource: (proseParagraph: Node, sourceParagraph: document_d_exports.Paragraph) => void;
 type CreateProseParagraphOptions = {
   attrs?: Node["attrs"];
   content?: Fragment | Node | readonly Node[] | null;
   marks?: readonly Mark[];
 };
 /** Create a parsed paragraph with both its same-process owner and durable body token. */
-declare const createProseParagraphWithPropertySource: (nodeType: NodeType | undefined, sourceParagraph: document_d_exports.Paragraph, options?: CreateProseParagraphOptions) => Node;
-type ParagraphPropertySourceTransfer = {
+export declare const createProseParagraphWithPropertySource: (nodeType: NodeType | undefined, sourceParagraph: document_d_exports.Paragraph, options?: CreateProseParagraphOptions) => Node;
+export type ParagraphPropertySourceTransfer = {
   displacedToken: string | null;
   selectedToken: string | null;
 };
@@ -139,28 +140,28 @@ type JoinProseParagraphsWithRightPropertySourceOptions = {
   transaction: Transaction;
 };
 /** Join adjacent paragraphs when revision semantics deliberately select the right owner. */
-declare const joinProseParagraphsWithRightPropertySource: ({ attrs, pos, transaction }: JoinProseParagraphsWithRightPropertySourceOptions) => Transaction;
+export declare const joinProseParagraphsWithRightPropertySource: ({ attrs, pos, transaction }: JoinProseParagraphsWithRightPropertySourceOptions) => Transaction;
 /** Record the property owners deliberately selected by a batch of paragraph joins. */
-declare const markParagraphPropertySourceTransfers: (transaction: Transaction, transfers: readonly ParagraphPropertySourceTransfer[]) => void;
-declare const getExplicitParagraphPropertySourceTransfers: (transaction: Transaction) => readonly ParagraphPropertySourceTransfer[];
+export declare const markParagraphPropertySourceTransfers: (transaction: Transaction, transfers: readonly ParagraphPropertySourceTransfer[]) => void;
+export declare const getExplicitParagraphPropertySourceTransfers: (transaction: Transaction) => readonly ParagraphPropertySourceTransfer[];
 type RecreateProseNodeOptions = {
   attrs?: Node["attrs"];
   content?: Fragment | Node | readonly Node[] | null;
   marks?: readonly Mark[];
 };
 /** Rebuild a PM node and retain paragraph provenance when the node is one. */
-declare const recreateProseNodeWithParagraphPropertySource: (source: Node, options?: RecreateProseNodeOptions) => Node;
+export declare const recreateProseNodeWithParagraphPropertySource: (source: Node, options?: RecreateProseNodeOptions) => Node;
 /**
  * Rebuild a PM node that is crossing from another package: retain its
  * same-process paragraph-property capture, but detach the durable token that
  * can only name a paragraph in the package it came from.
  */
-declare const recreateProseNodeWithDetachedParagraphPropertySource: (source: Node, options?: RecreateProseNodeOptions) => Node;
+export declare const recreateProseNodeWithDetachedParagraphPropertySource: (source: Node, options?: RecreateProseNodeOptions) => Node;
 /**
  * A paragraph's attributes without its durable source token, for a copy of
  * them that is carried by another node and must not claim the paragraph.
  */
-declare const proseParagraphAttrsWithoutPropertySource: (attrs: Node["attrs"]) => Node["attrs"];
+export declare const proseParagraphAttrsWithoutPropertySource: (attrs: Node["attrs"]) => Node["attrs"];
 type SetProseParagraphMarkupOptions = {
   attrs: Node["attrs"];
   ownership: "preserve" | "transfer-allocated-id";
@@ -168,15 +169,15 @@ type SetProseParagraphMarkupOptions = {
   transaction: Transaction;
 };
 /** Replace paragraph markup without losing its private parser-owner link. */
-declare const setProseParagraphMarkupWithPropertySource: ({ attrs, ownership, pos, transaction }: SetProseParagraphMarkupOptions) => void;
+export declare const setProseParagraphMarkupWithPropertySource: ({ attrs, ownership, pos, transaction }: SetProseParagraphMarkupOptions) => void;
 /**
  * Carry the parser-owned source identity across load-time paraId allocation.
  * The generated id is safe to use later because it was assigned while the
  * ProseMirror node still had an unambiguous source paragraph owner.
  */
-declare const transferProseParagraphPropertySource: (target: Node, source: Node, paraId: string) => void;
-declare const linkParagraphPropertySourceCandidate: (target: document_d_exports.Paragraph, source: Node) => void;
-declare const getParagraphPropertySourceCandidate: (paragraph: document_d_exports.Paragraph) => document_d_exports.Paragraph | undefined;
-declare const getParagraphPropertySourceTransferId: (paragraph: document_d_exports.Paragraph) => string | undefined;
+export declare const transferProseParagraphPropertySource: (target: Node, source: Node, paraId: string) => void;
+export declare const linkParagraphPropertySourceCandidate: (target: document_d_exports.Paragraph, source: Node) => void;
+export declare const getParagraphPropertySourceCandidate: (paragraph: document_d_exports.Paragraph) => document_d_exports.Paragraph | undefined;
+export declare const getParagraphPropertySourceTransferId: (paragraph: document_d_exports.Paragraph) => string | undefined;
 //#endregion
-export { DecodedTableCellParagraphSourcePayload, PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES, PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, ParagraphPropertySourceTransfer, ParagraphPropertySourceValidationCode, ParagraphPropertySourceValidationError, TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR, TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS, TableCellParagraphPropertySourceBinding, TableCellParagraphSourcePayloadErrorClassification, assignDocumentParagraphPropertySourceContract, assignParagraphIndentationProjection, assignParagraphPropertySource, cloneDocumentWithParagraphPropertySources, cloneParagraphWithPropertySource, cloneParagraphWithoutPropertySource, cloneTableCellsWithParagraphPropertyCaptures, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphIndentationProjection, copyParagraphPropertyCapture, copyParagraphPropertySource, createProseParagraphWithPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getExplicitParagraphPropertySourceTransfers, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, inspectParagraphSourceIdentity, isParagraphPropertySourceToken, joinProseParagraphsWithRightPropertySource, linkParagraphPropertySourceCandidate, linkProseParagraphPropertySource, markParagraphPropertySourceTransfers, paragraphFormattingWithAuthoredIndentation, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceMatchesAuthoredIndentation, paragraphPropertySourceMatchesEmission, paragraphPropertySourceTokenMatchesContract, proseParagraphAttrsWithoutPropertySource, recreateProseNodeWithDetachedParagraphPropertySource, recreateProseNodeWithParagraphPropertySource, restoreParagraphIndentationProjection, restoreTableCellsWithParagraphPropertySources, sameParagraphIndentationProjection, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource, transportTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings };
+export {};

package/dist/docx/paragraphPropertySource.js

@@ -153,7 +153,8 @@ const TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS = [
 	"invalid_row_type",
 	"malformed_source_token"
 ];
-var ParagraphPropertySourceValidationError = class extends TaggedError("ParagraphPropertySourceValidationError") {};
+const ParagraphPropertySourceValidationErrorBase = TaggedError("ParagraphPropertySourceValidationError");
+var ParagraphPropertySourceValidationError = class extends ParagraphPropertySourceValidationErrorBase {};
 const contractForDigest = (sourceDigest) => {
 	if (!SHA256_HEX.test(sourceDigest)) panic("Paragraph-property source digest must be lowercase SHA-256 hex");
 	return `${PARAGRAPH_SOURCE_TOKEN_VERSION}:${sourceDigest}`;
@@ -440,6 +441,10 @@ const tableCellBlockTraversalByType = {
 	blockCustomXml: "blockSdt",
 	bookmarkEnd: "leaf",
 	bookmarkStart: "leaf",
+	moveFromRangeEnd: "leaf",
+	moveFromRangeStart: "leaf",
+	moveToRangeEnd: "leaf",
+	moveToRangeStart: "leaf",
 	paragraph: "paragraph",
 	preservedBlock: "leaf",
 	table: "table"
@@ -636,10 +641,42 @@ function visitDecodedTableCellBlock(value, path, context) {
 			for (const [index, child] of content.entries()) visitDecodedTableCellBlock(child, `${path}.content[${index}]`, context);
 			return;
 		}
-		case "leaf": return;
+		case "leaf":
+			visitDecodedTableCellLeafBlock(block, blockType, path);
+			return;
 		default: return traversal;
 	}
 }
+/**
+* The fields each leaf block needs before the serializer can write it. A
+* payload is untrusted: a marker short of one is refused here, not met by
+* the writer.
+*/
+const TABLE_CELL_LEAF_BLOCK_FIELDS = {
+	bookmarkStart: {
+		id: "number",
+		name: "string"
+	},
+	bookmarkEnd: { id: "number" },
+	moveFromRangeStart: {
+		id: "number",
+		name: "string",
+		author: "string"
+	},
+	moveFromRangeEnd: { id: "number" },
+	moveToRangeStart: {
+		id: "number",
+		name: "string",
+		author: "string"
+	},
+	moveToRangeEnd: { id: "number" },
+	preservedBlock: { xml: "string" }
+};
+const isTableCellLeafBlockType = (type) => Object.hasOwn(TABLE_CELL_LEAF_BLOCK_FIELDS, type);
+function visitDecodedTableCellLeafBlock(block, blockType, path) {
+	if (!isTableCellLeafBlockType(blockType)) return invalidTableCellParagraphSourcePayload("invalid_block_type", path);
+	for (const [field, kind] of Object.entries(TABLE_CELL_LEAF_BLOCK_FIELDS[blockType])) if (typeof block[field] !== kind) return invalidTableCellParagraphSourcePayload("expected_block", path);
+}
 const decodedTableCellParagraphSourcePayloadBrand = Symbol("decodedTableCellParagraphSourcePayload");
 const decodedTableCellParagraphSourcePayloadStates = /* @__PURE__ */ new WeakMap();
 const decodedTableCellParagraphSourcePayloads = /* @__PURE__ */ new WeakMap();

package/dist/docx/paragraphTextBoxEnrichment.d.ts

@@ -6,6 +6,5 @@ import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 import { TableParserFn } from "./textBoxParser.js";
 //#region src/docx/paragraphTextBoxEnrichment.d.ts
-declare const enrichParagraphTextBoxes: (paragraph: document_d_exports.Paragraph, paraXml: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, parseTable: TableParserFn, previews: PreviewLedger, context?: ParseContext) => void;
-//#endregion
-export { enrichParagraphTextBoxes };
+export declare const enrichParagraphTextBoxes: (paragraph: document_d_exports.Paragraph, paraXml: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, parseTable: TableParserFn, previews: PreviewLedger, context?: ParseContext) => void;
+//#endregion

package/dist/docx/paragraphTextBoxEnrichment.js

@@ -6,7 +6,7 @@ import { consolidateParagraphContent } from "./runConsolidator.js";
 import { captureShapeAlternateContent } from "./shapeAlternateContent.js";
 import { getTextBoxContentElement, parseTextBox, parseTextBoxContent, parseTextBoxFromShape, scanRunForTextBoxDrawings } from "./textBoxParser.js";
 import { isVmlPictParsedByRunParser } from "./vmlImageParser.js";
-import { findChildByLocalName, findDeep, findWordprocessingChild, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, findChildByLocalName, findChildByNamespaceUri, findDeep, findWordprocessingChild, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
 //#region src/docx/paragraphTextBoxEnrichment.ts
 const VML_HORIZONTAL_RELATIVES = /* @__PURE__ */ new Set([
 	"character",
@@ -111,6 +111,22 @@ const parseVmlInsets = (textBoxEl) => {
 	};
 };
 const parseVmlFill = (shapeEl) => getAttribute(shapeEl, null, "filled")?.toLowerCase() === "f" ? { type: "none" } : void 0;
+const parseVmlOutline = (shapeEl) => {
+	if ([
+		"0",
+		"f",
+		"false"
+	].includes(getAttribute(shapeEl, null, "stroked")?.trim().toLowerCase() ?? "")) return;
+	const color = (getAttribute(shapeEl, null, "strokecolor")?.match(/^#?([0-9a-f]{6})$/i))?.at(1)?.toUpperCase();
+	const rawWidth = getAttribute(shapeEl, null, "strokeweight");
+	const widthPixels = rawWidth === null || rawWidth === void 0 ? void 0 : vmlLengthToPixels(rawWidth);
+	const positiveWidthPixels = widthPixels !== void 0 && widthPixels > 0 ? widthPixels : void 0;
+	if (color === void 0 && positiveWidthPixels === void 0) return;
+	return {
+		...color === void 0 ? {} : { color: { rgb: color } },
+		...positiveWidthPixels === void 0 ? {} : { width: pixelsToEmu(positiveWidthPixels) }
+	};
+};
 const parseVmlTextAnchor = (value) => {
 	switch (value?.toLowerCase()) {
 		case "top": return "top";
@@ -171,10 +187,7 @@ const liftGroupTextBoxes = (content, parsers) => {
 		case "insertion":
 		case "deletion":
 		case "moveFrom":
-		case "moveTo":
-			liftGroupTextBoxes(item.content, parsers);
-			break;
-		default: break;
+		case "moveTo": liftGroupTextBoxes(item.content, parsers);
 	}
 };
 const liftGroupTextBoxesInRun = (run, parsers) => {
@@ -402,7 +415,7 @@ const enrichTextBoxRuns = ({ content, xmlChildren, styles, theme, numbering, rel
 const parseVmlTextBoxShape = (pictEl, { styles, theme, numbering, rels, media, parseTable, previews }) => {
 	const shapeEl = findDeep(pictEl, "v", "shape");
 	const textBoxEl = shapeEl ? findDeep(shapeEl, "v", "textbox") : null;
-	const contentEl = textBoxEl ? findDeep(textBoxEl, "w", "txbxContent") : null;
+	const contentEl = findChildByNamespaceUri(textBoxEl, WORDPROCESSINGML_NAMESPACE_URIS, "txbxContent");
 	if (!shapeEl || !textBoxEl || !contentEl) return null;
 	const style = parseVmlStyle(getAttribute(shapeEl, null, "style"));
 	const textBoxStyle = parseVmlStyle(getAttribute(textBoxEl, null, "style"));
@@ -416,6 +429,7 @@ const parseVmlTextBoxShape = (pictEl, { styles, theme, numbering, rels, media, p
 	const margins = parseVmlInsets(textBoxEl);
 	const anchor = parseVmlTextAnchor(textBoxStyle["v-text-anchor"]);
 	const fill = parseVmlFill(shapeEl);
+	const outline = parseVmlOutline(shapeEl);
 	const shape = {
 		type: "shape",
 		shapeType: "textBox",
@@ -424,6 +438,7 @@ const parseVmlTextBoxShape = (pictEl, { styles, theme, numbering, rels, media, p
 			height: pixelsToEmu(height)
 		},
 		...fill === void 0 ? {} : { fill },
+		...outline === void 0 ? {} : { outline },
 		wrap: { type: vmlWrapType(positioned, zIndex) },
 		textBody: {
 			content: parseTextBoxContent(contentEl, parseParagraph, parseTable, styles, theme, numbering, rels, media, previews),

package/dist/docx/paragraphTraversal.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/paragraphTraversal.d.ts
-type DocxParagraphSurfaces = {
+export type DocxParagraphSurfaces = {
   documentBody: document_d_exports.DocumentBody;
   headers?: Map<string, document_d_exports.HeaderFooter> | undefined;
   footers?: Map<string, document_d_exports.HeaderFooter> | undefined;
@@ -8,13 +8,13 @@ type DocxParagraphSurfaces = {
   endnotes?: readonly document_d_exports.Endnote[] | undefined;
 };
 /** Visit every run directly owned by a paragraph's inline-content tree. */
-declare const visitParagraphRuns: (paragraph: document_d_exports.Paragraph, visit: (run: document_d_exports.Run) => void) => void;
+export declare const visitParagraphRuns: (paragraph: document_d_exports.Paragraph, visit: (run: document_d_exports.Run) => void) => void;
 /**
  * One position in an inline-content array: the array itself, the index, and
  * what sits there. A normaliser that drops or rewrites a marker needs the
  * array and the index, not only the value.
  */
-type InlineContentSlot = {
+export type InlineContentSlot = {
   content: document_d_exports.ParagraphContent[];
   index: number;
   item: document_d_exports.ParagraphContent;
@@ -32,13 +32,14 @@ type InlineContentSlot = {
  * A complex field's runs are skipped: `fieldCode` and `fieldResult` hold runs
  * only, and a run is not a marker position.
  */
-declare const visitInlineContentSlots: (paragraph: document_d_exports.Paragraph, visit: (slot: InlineContentSlot) => void) => void;
+export declare const visitInlineContentSlots: (paragraph: document_d_exports.Paragraph, visit: (slot: InlineContentSlot) => void) => void;
+export declare const visitInlineContentSlotsInContent: (content: document_d_exports.ParagraphContent[], visit: (slot: InlineContentSlot) => void) => void;
 /** What the walk does below a record it has just visited. */
-declare const BLOCK_TREE_DESCENT: {
+export declare const BLOCK_TREE_DESCENT: {
   readonly descend: "descend";
   readonly prune: "prune";
 };
-type BlockTreeDescent = (typeof BLOCK_TREE_DESCENT)[keyof typeof BLOCK_TREE_DESCENT];
+export type BlockTreeDescent = (typeof BLOCK_TREE_DESCENT)[keyof typeof BLOCK_TREE_DESCENT];
 /**
  * Every record a block tree owns in document order: a paragraph, table, and
  * table row. These are the records that carry authored state by identity.
@@ -48,7 +49,15 @@ type BlockTreeDescent = (typeof BLOCK_TREE_DESCENT)[keyof typeof BLOCK_TREE_DESC
  * alone enters the body, a cell and an `w:sdt` and never enters a text box:
  * every record inside one is then invisible to whatever the walk is deciding.
  */
-declare const visitBlockTreeRecords: (blocks: readonly document_d_exports.BlockContent[], visit: (record: document_d_exports.Paragraph | document_d_exports.Table | document_d_exports.TableRow) => BlockTreeDescent) => void;
-declare const visitDocxParagraphs: ({ documentBody, headers, footers, footnotes, endnotes }: DocxParagraphSurfaces, visit: (paragraph: document_d_exports.Paragraph) => void) => void;
-//#endregion
-export { BLOCK_TREE_DESCENT, BlockTreeDescent, DocxParagraphSurfaces, InlineContentSlot, visitBlockTreeRecords, visitDocxParagraphs, visitInlineContentSlots, visitParagraphRuns };
+export declare const visitBlockTreeRecords: (blocks: readonly document_d_exports.BlockContent[], visit: (record: document_d_exports.Paragraph | document_d_exports.Table | document_d_exports.TableRow) => BlockTreeDescent) => void;
+export declare const visitDocxParagraphs: (surfaces: DocxParagraphSurfaces, visit: (paragraph: document_d_exports.Paragraph) => void) => void;
+export type DocxContentSlot = {
+  type: "block";
+  content: document_d_exports.BlockContent[];
+  index: number;
+  item: document_d_exports.BlockContent;
+} | ({
+  type: "inline";
+} & InlineContentSlot);
+export declare const visitDocxContentSlots: (surfaces: DocxParagraphSurfaces, visit: (slot: DocxContentSlot) => void) => void;
+//#endregion