@stll/folio-core 0.62.0 → 0.63.0

package/dist/docx/paragraphParser.d.ts

@@ -4,7 +4,7 @@ import { XmlElement } from "./xmlParser.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 //#region src/docx/paragraphParser.d.ts
-declare function parseParagraphPropertyChanges(pPr: XmlElement | null, theme: document_d_exports.Theme | null, currentFormatting: document_d_exports.ParagraphFormatting | undefined): document_d_exports.ParagraphPropertyChange[] | undefined;
+export declare function parseParagraphPropertyChanges(pPr: XmlElement | null, theme: document_d_exports.Theme | null, currentFormatting: document_d_exports.ParagraphFormatting | undefined): document_d_exports.ParagraphPropertyChange[] | undefined;
 type ParseParagraphOptions = {
   inHeaderFooter?: boolean;
   rootXmlns?: Record<string, string>;
@@ -26,35 +26,35 @@ type ParseParagraphOptions = {
  *   paragraph read without them charges its previews to no package
  * @returns Parsed Paragraph object
  */
-declare function parseParagraph(node: 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, options?: ParseParagraphOptions): document_d_exports.Paragraph;
+export declare function parseParagraph(node: 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, options?: ParseParagraphOptions): document_d_exports.Paragraph;
 /**
  * Get plain text from a paragraph
  *
  * @param paragraph - Parsed Paragraph object
  * @returns Concatenated text content
  */
-declare function getParagraphText(paragraph: document_d_exports.Paragraph): string;
+export declare function getParagraphText(paragraph: document_d_exports.Paragraph): string;
 /**
  * Check if a paragraph is empty (no visible content)
  *
  * @param paragraph - Parsed Paragraph object
  * @returns true if paragraph has no visible content
  */
-declare function isEmptyParagraph(paragraph: document_d_exports.Paragraph): boolean;
+export declare function isEmptyParagraph(paragraph: document_d_exports.Paragraph): boolean;
 /**
  * Check if a paragraph is a list item
  *
  * @param paragraph - Parsed Paragraph object
  * @returns true if paragraph has numbering properties
  */
-declare function isListItem(paragraph: document_d_exports.Paragraph): boolean;
+export declare function isListItem(paragraph: document_d_exports.Paragraph): boolean;
 /**
  * Get the list level of a paragraph (0-8)
  *
  * @param paragraph - Parsed Paragraph object
  * @returns List level or undefined if not a list item
  */
-declare function getListLevel(paragraph: document_d_exports.Paragraph): number | undefined;
+export declare function getListLevel(paragraph: document_d_exports.Paragraph): number | undefined;
 /**
  * Check if paragraph has a specific style
  *
@@ -62,13 +62,13 @@ declare function getListLevel(paragraph: document_d_exports.Paragraph): number |
  * @param styleId - Style ID to check for
  * @returns true if paragraph has the specified style
  */
-declare function hasStyle(paragraph: document_d_exports.Paragraph, styleId: string): boolean;
+export declare function hasStyle(paragraph: document_d_exports.Paragraph, styleId: string): boolean;
 /**
  * Check if paragraph starts with a template variable {{...}}
  *
  * @param paragraph - Parsed Paragraph object
  * @returns The variable name or null
  */
-declare function getTemplateVariable(paragraph: document_d_exports.Paragraph): string | null;
+export declare function getTemplateVariable(paragraph: document_d_exports.Paragraph): string | null;
 //#endregion
-export { getListLevel, getParagraphText, getTemplateVariable, hasStyle, isEmptyParagraph, isListItem, parseParagraph, parseParagraphPropertyChanges };
+export {};

package/dist/docx/paragraphParser.js

@@ -10,8 +10,8 @@ import { HYPERLINK_CHILD_HANDLERS, parseHyperlink as parseHyperlink$1, parseHype
 import { isHyperlinkContent, isInlineSdtContent, isSimpleFieldContent, isTrackedChangeWrapperChild } from "./inlineWrapperContent.js";
 import { inlineWrapperOf } from "./inlineWrapperParser.js";
 import { preserveLinkedSdt } from "./linkedSdtPreservation.js";
-import { parseMarkupRangeMarker, parseMoveBookmarkMarker } from "./markupRangeMarker.js";
-import { counterFormatOf, markerAlignmentForLevel, markerFormattingFromLevel, numberingLevelHasMarkerSlot } from "./numberingParser.js";
+import { parseCopyOriginMarker, parseMarkupRangeMarker, parseMoveBookmarkMarker } from "./markupRangeMarker.js";
+import { counterFormatOf, markerAlignmentForLevel, markerFormattingFromLevel, numberingLevelHasMarkerSlot as numberingLevelHasMarkerSlot$1 } from "./numberingParser.js";
 import { mergeParagraphNumbering as mergeParagraphNumbering$1, paragraphNumberingReferenceId, resolveParagraphNumbering as resolveParagraphNumbering$1 } from "./numberingReference.js";
 import { paraIdAttribute, textIdAttribute } from "./paraIdAttribute.js";
 import { paraIdInRange } from "./paraIdRangeNormalization.js";
@@ -36,6 +36,17 @@ import { WORDPROCESSINGML_NAMESPACE_URIS, cloneElement, findChild, findChildByNa
 import { panic } from "better-result";
 import { PARAGRAPH_MARK_CHANGE_KINDS, REVIEW_CARRIERS } from "@stll/docx-core/model";
 //#region src/docx/paragraphParser.ts
+/**
+* Paragraph Parser - Parse paragraphs (w:p) with complete formatting
+*
+* A paragraph is the fundamental block-level element containing text runs,
+* hyperlinks, bookmarks, and fields.
+*
+* OOXML Reference:
+* - Paragraph: w:p
+* - Paragraph properties: w:pPr
+* - Content: runs, hyperlinks, bookmarks, fields
+*/
 const FOLIO_REVIEW_HISTORY_NAMESPACES = /* @__PURE__ */ new Set([FOLIO_REVIEW_HISTORY_NAMESPACE]);
 /**
 * Extract plain text from a math element (recursive text content extraction)
@@ -177,7 +188,8 @@ function normalizeDeletionContentElement(node) {
 function parseParagraphPropertyChanges(pPr, theme, currentFormatting) {
 	if (!pPr) return;
 	const changes = findChildrenByNamespaceUri(pPr, WORDPROCESSINGML_NAMESPACE_URIS, "pPrChange").map((changeElement) => {
-		const previousFormatting = parseParagraphProperties(findChildByNamespaceUri(changeElement, WORDPROCESSINGML_NAMESPACE_URIS, "pPr"), theme);
+		const previousPPr = findChildByNamespaceUri(changeElement, WORDPROCESSINGML_NAMESPACE_URIS, "pPr");
+		const previousFormatting = parseParagraphProperties(previousPPr, theme);
 		const change = {
 			type: "paragraphPropertyChange",
 			info: parsePropertyChangeInfo(changeElement)
@@ -386,9 +398,7 @@ const linkedRevisionContent = (wrapped, linkOver) => {
 				});
 				break;
 			case "inlineSdt": return panic("An SDT under a hyperlink must retain its opaque source span");
-			default:
-				if (isTrackedChangeWrapperChild(item)) content.push(item);
-				break;
+			default: if (isTrackedChangeWrapperChild(item)) content.push(item);
 		}
 	}
 	flushLinked();
@@ -501,7 +511,7 @@ function parseSimpleField(node, styles, theme, rels, media, rootXmlns, previews)
 	};
 	const inScopeXmlns = mergeXmlnsDeclarations(rootXmlns, node);
 	const content = [];
-	field.content = withPreservedChildren(content, dispatchChildrenWithContext({
+	const preserved = dispatchChildrenWithContext({
 		element: node,
 		container: "w:fldSimple",
 		capturePosition: () => content.length,
@@ -517,7 +527,8 @@ function parseSimpleField(node, styles, theme, rels, media, rootXmlns, previews)
 			previews,
 			inScopeXmlns
 		}
-	}), preservedInlineCapture);
+	});
+	field.content = withPreservedChildren(content, preserved, preservedInlineCapture);
 	return field;
 }
 /** A transparent wrapper the field holds, read as the wrapper it is. */
@@ -608,7 +619,7 @@ const SIMPLE_FIELD_CHILD_HANDLERS = {
 const parseFieldInlineWrapper = (element, node, context) => {
 	const inScopeXmlns = mergeXmlnsDeclarations(context.inScopeXmlns, node);
 	const content = [];
-	return inlineWrapperOf(element, node, withPreservedChildren(content, dispatchChildrenWithContext({
+	const preserved = dispatchChildrenWithContext({
 		element: node,
 		container: "run-level-content",
 		capturePosition: () => content.length,
@@ -620,7 +631,8 @@ const parseFieldInlineWrapper = (element, node, context) => {
 				content.push(child);
 			}
 		}
-	}), preservedInlineCapture));
+	});
+	return inlineWrapperOf(element, node, withPreservedChildren(content, preserved, preservedInlineCapture));
 };
 const hasRunPayload = ({ run, runElement, rels, media }) => {
 	if (runHoldsPayload(run)) return true;
@@ -911,15 +923,16 @@ const PARAGRAPH_CONTENT_HANDLERS = {
 		let hasFieldEnd = false;
 		let endOriginalValue;
 		let instrText = "";
-		for (const content of run.content) if (content.type === "fieldChar") if (content.charType === "begin") {
-			hasFieldBegin = true;
-			beginFieldState = fieldStateOf(content);
-		} else if (content.charType === "separate") hasFieldSeparate = true;
-		else {
-			hasFieldEnd = true;
-			if (content.originalValue !== void 0) endOriginalValue = content.originalValue;
-		}
-		else if (content.type === "instrText") instrText += content.text;
+		for (const content of run.content) if (content.type === "fieldChar") {
+			if (content.charType === "begin") {
+				hasFieldBegin = true;
+				beginFieldState = fieldStateOf(content);
+			} else if (content.charType === "separate") hasFieldSeparate = true;
+			else {
+				hasFieldEnd = true;
+				if (content.originalValue !== void 0) endOriginalValue = content.originalValue;
+			}
+		} else if (content.type === "instrText") instrText += content.text;
 		if (hasFieldBegin) scan.codeDepthStack.push(false);
 		if (hasFieldSeparate && scan.codeDepthStack.length > 0) scan.codeDepthStack[scan.codeDepthStack.length - 1] = true;
 		if (hasFieldBegin) {
@@ -1107,7 +1120,8 @@ const PARAGRAPH_CONTENT_HANDLERS = {
 	moveFromRangeEnd: (child, { contents }) => {
 		contents.push({
 			type: "moveFromRangeEnd",
-			...parseMarkupRangeMarker(child)
+			...parseMarkupRangeMarker(child),
+			...parseCopyOriginMarker(child)
 		});
 	},
 	moveToRangeStart: (child, { contents }) => {
@@ -1119,7 +1133,8 @@ const PARAGRAPH_CONTENT_HANDLERS = {
 	moveToRangeEnd: (child, { contents }) => {
 		contents.push({
 			type: "moveToRangeEnd",
-			...parseMarkupRangeMarker(child)
+			...parseMarkupRangeMarker(child),
+			...parseCopyOriginMarker(child)
 		});
 	},
 	commentRangeStart: (child, { contents }) => {
@@ -1322,7 +1337,7 @@ function parseParagraph(node, styles, theme, numbering, rels = null, media = nul
 					const hasDirectLeft = hasAttributeAnySpelling(directInd, "CT_Ind @left");
 					const hasDirectFirstLineOrHanging = parseNumericAttribute(directInd, "w", "firstLine") !== void 0 || parseNumericAttribute(directInd, "w", "hanging") !== void 0;
 					if (!hasDirectLeft && !chainInd.left && level.pPr.indentLeft !== void 0 && (level.pPr.indentLeft !== 0 || styleInd.left)) paragraph.formatting.indentLeft = level.pPr.indentLeft;
-					if (!hasDirectFirstLineOrHanging && !chainInd.firstLine && numberingLevelHasMarkerSlot(level) && (level.pPr.indentFirstLine !== 0 || styleInd.firstLine)) {
+					if (!hasDirectFirstLineOrHanging && !chainInd.firstLine && numberingLevelHasMarkerSlot$1(level) && (level.pPr.indentFirstLine !== 0 || styleInd.firstLine)) {
 						if (level.pPr.indentFirstLine !== void 0) paragraph.formatting.indentFirstLine = level.pPr.indentFirstLine;
 						if (level.pPr.hangingIndent !== void 0) paragraph.formatting.hangingIndent = level.pPr.hangingIndent;
 					}
@@ -1388,7 +1403,14 @@ const getHyperlinkText = (hyperlink) => hyperlink.children.map((child) => {
 	switch (child.type) {
 		case "run": return getRunText(child);
 		case "bookmarkStart":
-		case "bookmarkEnd": return "";
+		case "bookmarkEnd":
+		case "commentRangeStart":
+		case "commentRangeEnd":
+		case "commentReference":
+		case "moveFromRangeStart":
+		case "moveFromRangeEnd":
+		case "moveToRangeStart":
+		case "moveToRangeEnd": return "";
 		case "preservedInline": return child.text;
 		case "inlineWrapper": return child.content.map(getParagraphContentText).join("");
 		default: return panic(`Unsupported hyperlink child in plain-text extraction: ${JSON.stringify(child)}`);

package/dist/docx/paragraphProperties.d.ts

@@ -18,6 +18,5 @@ import { XmlElement } from "./xmlParser.js";
  * set, read below off the element for the same reason a run's is read off the
  * run.
  */
-declare function parseParagraphProperties(pPr: XmlElement | null, theme: document_d_exports.Theme | null): document_d_exports.ParagraphFormatting | undefined;
-//#endregion
-export { parseParagraphProperties };
+export declare function parseParagraphProperties(pPr: XmlElement | null, theme: document_d_exports.Theme | null): document_d_exports.ParagraphFormatting | undefined;
+//#endregion

package/dist/docx/paragraphProperties.js

@@ -12,6 +12,19 @@ import { findChild, findChildren, getAttribute, parseBooleanElement, parseNumeri
 import { outlineLevelFromStatedValue } from "@stll/docx-core/model";
 //#region src/docx/paragraphProperties.ts
 /**
+* The one reader for a paragraph property set (`w:pPr`).
+*
+* Four owners produce the element — a paragraph, the `CT_PPrGeneral` a style
+* carries, a numbering level's, and the `CT_PPrBase` snapshot inside
+* `w:pPrChange` — and the writer they share is
+* `serializeParagraphPropertySet`. The reader lives here rather than beside
+* one of them because `paragraphParser` and `numberingParser` already depend
+* on each other: a reader inside either is one the other cannot import, and a
+* numbering level kept a third private copy — indent and tabs, no sink — for
+* exactly that reason. Nothing in this module imports either of them, so both
+* import it.
+*/
+/**
 * Parse tab stops (w:tabs)
 */
 function parseTabStops(tabs) {
@@ -146,8 +159,8 @@ const PARAGRAPH_PROPERTY_HANDLERS = {
 	wordWrap: CAPTURE,
 	overflowPunct: readToggle("overflowPunct", "overflowPunctuation"),
 	topLinePunct: CAPTURE,
-	autoSpaceDE: CAPTURE,
-	autoSpaceDN: CAPTURE,
+	autoSpaceDE: readToggle("autoSpaceDE", "autoSpaceDE"),
+	autoSpaceDN: readToggle("autoSpaceDN", "autoSpaceDN"),
 	bidi: readToggle("bidi", "bidi"),
 	adjustRightInd: CAPTURE,
 	snapToGrid: readToggle("snapToGrid", "snapToGrid"),

package/dist/docx/paragraphPropertySource.d.ts

@@ -17,61 +17,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];
+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 ParagraphPropertySourceValidationError_base: import("better-result").TaggedErrorClass<"ParagraphPropertySourceValidationError">;
-declare class ParagraphPropertySourceValidationError extends ParagraphPropertySourceValidationError_base<{
+export declare class ParagraphPropertySourceValidationError extends ParagraphPropertySourceValidationError_base<{
   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 +85,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 +139,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 +168,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

@@ -440,6 +440,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 +640,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),