@stll/folio-core 0.14.1 → 0.15.1

package/dist/docx/xmlParser.d.ts

@@ -79,7 +79,7 @@ declare function parseXmlDocument(xml: string): XmlElement | null;
  * Get local name from a prefixed element name
  * e.g., "w:p" -> "p", "a:graphic" -> "graphic"
  */
-declare function getLocalName(name: string): string;
+declare function getLocalName(name: string | undefined): string;
 /**
  * Get namespace prefix from an element name
  * e.g., "w:p" -> "w", "a:graphic" -> "a"
@@ -92,7 +92,7 @@ declare function getNamespacePrefix(name: string): string | null;
  * @param namespace - Namespace prefix (e.g., "w", "a")
  * @param localName - Local element name (e.g., "p", "r")
  */
-declare function matchesName(element: XmlElement, namespace: string, localName: string): boolean;
+declare function matchesName(element: XmlElement, _namespace: string, localName: string): boolean;
 /**
  * Find first child element matching the given namespaced name
  *
@@ -101,7 +101,7 @@ declare function matchesName(element: XmlElement, namespace: string, localName:
  * @param localName - Local element name (e.g., "p")
  * @returns First matching child or null
  */
-declare function findChild(parent: XmlElement | null | undefined, namespace: string, localName: string): XmlElement | null;
+declare function findChild(parent: XmlElement | null | undefined, _namespace: string, localName: string): XmlElement | null;
 /**
  * Find all child elements matching the given namespaced name
  *
@@ -110,7 +110,7 @@ declare function findChild(parent: XmlElement | null | undefined, namespace: str
  * @param localName - Local element name
  * @returns Array of matching children
  */
-declare function findChildren(parent: XmlElement | null | undefined, namespace: string, localName: string): XmlElement[];
+declare function findChildren(parent: XmlElement | null | undefined, _namespace: string, localName: string): XmlElement[];
 /**
  * Find first child element by local name only (ignoring namespace)
  *
@@ -237,6 +237,14 @@ declare function parseColorElement(element: XmlElement | null | undefined): {
  * @returns Parsed number or undefined
  */
 declare function parseNumericAttribute(element: XmlElement | null | undefined, namespace: string | null, name: string, scale?: number): number | undefined;
+/**
+ * Parse a zero-based numbering level reference.
+ *
+ * OOXML numbering levels cannot be negative. Some producers emit negative
+ * sentinel values alongside `w:numId="0"` to disable numbering; treat those
+ * as an omitted level instead of leaking an invalid value into the model.
+ */
+declare function parseNumberingLevelAttribute(element: XmlElement | null | undefined): number | undefined;
 /**
  * Parse `w:w` on a table width/height element. For `w:type="pct"`, producers
  * sometimes emit human-readable percentages (`100%`) instead of 50ths-of-percent
@@ -294,10 +302,15 @@ declare function collectXmlnsDeclarations(element: XmlElement): Record<string, s
  */
 declare function mergeXmlnsDeclarations(inherited: Record<string, string>, element: XmlElement): Record<string, string>;
 /**
- * Return a shallow clone of `element` whose attributes carry every declaration
- * in `xmlnsDecls`. Existing attributes (including any namespace declarations the
- * element already carries) win over the injected ones.
+ * Return a shallow clone of `element` carrying the inherited namespace
+ * declarations needed by its raw subtree.
+ *
+ * Existing declarations retain their authored order. Only missing, referenced
+ * bindings are appended, which makes repeated detach/replay cycles idempotent
+ * even when the surrounding document declares a different namespace superset.
+ * If a producer omitted a binding for a standard OOXML prefix, use its
+ * canonical binding so the detached subtree is valid on its first replay.
  */
 declare function cloneWithXmlnsDeclarations(element: XmlElement, xmlnsDecls: Record<string, string>): XmlElement;
 //#endregion
-export { NAMESPACES, XmlElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };
+export { NAMESPACES, XmlElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };

package/dist/docx/xmlParser.js

@@ -53,6 +53,8 @@ const fxpBuilder = new XMLBuilder(fxpBuilderOptions);
 const TEXT_KEY = "#text";
 /** Attribute group key used by fast-xml-parser in preserveOrder mode. */
 const ATTR_KEY = ":@";
+/** Character reference required to keep carriage returns through XML end-of-line normalization. */
+const XML_CARRIAGE_RETURN_REFERENCE = "
";
 /**
 * Convert a fast-xml-parser preserveOrder node into an XmlElement.
 *
@@ -75,9 +77,8 @@ function fxpNodeToElement(node) {
 		};
 		if (attrs) element.attributes = attrs;
 		if (children.length > 0) {
-			const elements = [];
-			for (const child of children) elements.push(fxpNodeToElement(child));
-			element.elements = elements;
+			for (let index = 0; index < children.length; index += 1) children[index] = fxpNodeToElement(children[index]);
+			element.elements = children;
 		}
 		return element;
 	}
@@ -89,9 +90,8 @@ function fxpNodeToElement(node) {
 * `{ elements: [...] }`.
 */
 function fxpToRootElement(nodes) {
-	const elements = [];
-	for (const node of nodes) elements.push(fxpNodeToElement(node));
-	return { elements };
+	for (let index = 0; index < nodes.length; index += 1) nodes[index] = fxpNodeToElement(nodes[index]);
+	return { elements: nodes };
 }
 /**
 * Convert an XmlElement back into the fast-xml-parser preserveOrder format
@@ -123,7 +123,7 @@ function parseXml(xml) {
 */
 function elementToXml(element) {
 	const fxpNode = elementToFxpNode(element);
-	return fxpBuilder.build([fxpNode]);
+	return fxpBuilder.build([fxpNode]).replaceAll("\r", XML_CARRIAGE_RETURN_REFERENCE);
 }
 /**
 * Parse XML string to a more convenient format
@@ -131,7 +131,10 @@ function elementToXml(element) {
 function parseXmlDocument(xml) {
 	try {
 		const parsed = parseXml(xml);
-		if (parsed.elements && parsed.elements.length > 0) return parsed.elements.find((e) => e.type === "element") ?? null;
+		if (parsed.elements && parsed.elements.length > 0) {
+			for (const element of parsed.elements) if (element.type === "element") return element;
+			return null;
+		}
 		return parsed;
 	} catch {
 		return null;
@@ -142,6 +145,8 @@ function parseXmlDocument(xml) {
 * e.g., "w:p" -> "p", "a:graphic" -> "graphic"
 */
 function getLocalName(name) {
+	if (!name) return "";
+	if (name[1] === ":") return name.slice(2);
 	const colonIndex = name.indexOf(":");
 	return colonIndex !== -1 ? name.slice(colonIndex + 1) : name;
 }
@@ -150,9 +155,16 @@ function getLocalName(name) {
 * e.g., "w:p" -> "w", "a:graphic" -> "a"
 */
 function getNamespacePrefix(name) {
+	if (name[1] === ":") return name[0] ?? null;
 	const colonIndex = name.indexOf(":");
 	return colonIndex !== -1 ? name.slice(0, colonIndex) : null;
 }
+function hasLocalName(name, localName) {
+	if (!name) return false;
+	if (name === localName) return true;
+	const localNameOffset = name.length - localName.length;
+	return localNameOffset > 0 && name[localNameOffset - 1] === ":" && name.endsWith(localName);
+}
 /**
 * Check if an element matches a given namespaced name
 *
@@ -160,12 +172,9 @@ function getNamespacePrefix(name) {
 * @param namespace - Namespace prefix (e.g., "w", "a")
 * @param localName - Local element name (e.g., "p", "r")
 */
-function matchesName(element, namespace, localName) {
+function matchesName(element, _namespace, localName) {
 	if (!element.name) return false;
-	const fullName = `${namespace}:${localName}`;
-	if (element.name === fullName) return true;
-	if (getLocalName(element.name) === localName) return true;
-	return false;
+	return hasLocalName(element.name, localName);
 }
 /**
 * Find first child element matching the given namespaced name
@@ -175,13 +184,11 @@ function matchesName(element, namespace, localName) {
 * @param localName - Local element name (e.g., "p")
 * @returns First matching child or null
 */
-function findChild(parent, namespace, localName) {
+function findChild(parent, _namespace, localName) {
 	if (!parent || !parent.elements) return null;
-	const fullName = `${namespace}:${localName}`;
 	for (const child of parent.elements) {
 		if (child.type !== "element") continue;
-		if (child.name === fullName) return child;
-		if (getLocalName(child.name || "") === localName) return child;
+		if (hasLocalName(child.name, localName)) return child;
 	}
 	return null;
 }
@@ -193,13 +200,12 @@ function findChild(parent, namespace, localName) {
 * @param localName - Local element name
 * @returns Array of matching children
 */
-function findChildren(parent, namespace, localName) {
+function findChildren(parent, _namespace, localName) {
 	if (!parent || !parent.elements) return [];
-	const fullName = `${namespace}:${localName}`;
 	const results = [];
 	for (const child of parent.elements) {
 		if (child.type !== "element") continue;
-		if (child.name === fullName || getLocalName(child.name || "") === localName) results.push(child);
+		if (hasLocalName(child.name, localName)) results.push(child);
 	}
 	return results;
 }
@@ -214,7 +220,7 @@ function findChildByLocalName(parent, localName) {
 	if (!parent || !parent.elements) return null;
 	for (const child of parent.elements) {
 		if (child.type !== "element") continue;
-		if (getLocalName(child.name || "") === localName) return child;
+		if (hasLocalName(child.name, localName)) return child;
 	}
 	return null;
 }
@@ -227,7 +233,9 @@ function findChildByLocalName(parent, localName) {
 */
 function findChildrenByLocalName(parent, localName) {
 	if (!parent || !parent.elements) return [];
-	return parent.elements.filter((child) => child.type === "element" && getLocalName(child.name || "") === localName);
+	const results = [];
+	for (const child of parent.elements) if (child.type === "element" && hasLocalName(child.name, localName)) results.push(child);
+	return results;
 }
 /**
 * Find first child element by full name (including namespace prefix)
@@ -252,7 +260,9 @@ function findByFullName(parent, fullName) {
 */
 function getChildElements(parent) {
 	if (!parent || !parent.elements) return [];
-	return parent.elements.filter((child) => child.type === "element");
+	const results = [];
+	for (const child of parent.elements) if (child.type === "element") results.push(child);
+	return results;
 }
 /**
 * Get an attribute value from an element
@@ -277,13 +287,13 @@ function getAttribute(element, namespace, name) {
 	if (!element || !element.attributes) return null;
 	const attrs = element.attributes;
 	if (namespace) {
-		const prefixedName = `${namespace}:${name}`;
-		if (prefixedName in attrs) return attrs[prefixedName] ?? null;
+		const prefixedValue = attrs[`${namespace}:${name}`];
+		if (prefixedValue !== void 0) return prefixedValue;
 	}
-	if (name in attrs) return attrs[name] ?? null;
+	const unprefixedValue = attrs[name];
+	if (unprefixedValue !== void 0) return unprefixedValue;
 	if (namespace) {
-		const suffix = `:${name}`;
-		for (const key of Object.keys(attrs)) if (key.endsWith(suffix)) return attrs[key] ?? null;
+		for (const key in attrs) if (hasLocalName(key, name)) return attrs[key] ?? null;
 	}
 	return null;
 }
@@ -312,8 +322,11 @@ function getAttributeAnyPrefix(element, localName) {
 	if (canonical !== null) return canonical;
 	const attrs = element.attributes;
 	if (attrs) {
-		const suffix = `:${localName}`;
-		for (const [key, value] of Object.entries(attrs)) if (key === localName || key.endsWith(suffix)) return value;
+		for (const key in attrs) if (hasLocalName(key, localName)) {
+			const value = attrs[key];
+			if (value === void 0) return null;
+			return typeof value === "string" ? value : String(value);
+		}
 	}
 	return null;
 }
@@ -416,6 +429,17 @@ function parseNumericAttribute(element, namespace, name, scale = 1) {
 	return num * scale;
 }
 /**
+* Parse a zero-based numbering level reference.
+*
+* OOXML numbering levels cannot be negative. Some producers emit negative
+* sentinel values alongside `w:numId="0"` to disable numbering; treat those
+* as an omitted level instead of leaking an invalid value into the model.
+*/
+function parseNumberingLevelAttribute(element) {
+	const level = parseNumericAttribute(element, "w", "val");
+	return level !== void 0 && level >= 0 ? level : void 0;
+}
+/**
 * Parse `w:w` on a table width/height element. For `w:type="pct"`, producers
 * sometimes emit human-readable percentages (`100%`) instead of 50ths-of-percent
 * (`5000`); normalize those to the ECMA-376 unit the layout engine expects.
@@ -519,9 +543,14 @@ function collectXmlnsDeclarations(element) {
 	const out = {};
 	const attrs = element.attributes;
 	if (!attrs) return out;
-	for (const [key, value] of Object.entries(attrs)) {
-		if (Object.keys(out).length >= MAX_XMLNS_DECLARATIONS_PER_ELEMENT) break;
-		if ((key === "xmlns" || key.startsWith("xmlns:")) && value !== void 0) out[key] = String(value);
+	let declarationCount = 0;
+	for (const key in attrs) {
+		if (declarationCount >= MAX_XMLNS_DECLARATIONS_PER_ELEMENT) break;
+		const value = attrs[key];
+		if ((key === "xmlns" || key.startsWith("xmlns:")) && value !== void 0) {
+			out[key] = String(value);
+			declarationCount += 1;
+		}
 	}
 	return out;
 }
@@ -535,26 +564,80 @@ function collectXmlnsDeclarations(element) {
 */
 function mergeXmlnsDeclarations(inherited, element) {
 	const own = collectXmlnsDeclarations(element);
-	if (Object.keys(own).length === 0) return inherited;
-	return {
+	for (const _key in own) return {
 		...inherited,
 		...own
 	};
+	return inherited;
 }
+const QNAME_VALUE_ATTRIBUTES = /* @__PURE__ */ new Set([
+	"Ignorable",
+	"PreserveAttributes",
+	"PreserveElements",
+	"ProcessContent",
+	"Requires"
+]);
+const addPrefix = (name, prefixes) => {
+	const separatorIndex = name.indexOf(":");
+	if (separatorIndex > 0) prefixes.add(name.slice(0, separatorIndex));
+};
+/**
+* Collect namespace prefixes whose bindings a detached raw subtree needs.
+*
+* Element and attribute names use prefixes directly. Markup-compatibility and
+* QName-valued attributes can also refer to prefixes in their values, so keep
+* those bindings even when no descendant name uses them.
+*/
+const collectUsedNamespacePrefixes = (element, prefixes = /* @__PURE__ */ new Set()) => {
+	if (element.name) if (element.name.includes(":")) addPrefix(element.name, prefixes);
+	else prefixes.add("");
+	if (element.attributes) for (const [name, value] of Object.entries(element.attributes)) {
+		if (name === "xmlns" || name.startsWith("xmlns:")) continue;
+		addPrefix(name, prefixes);
+		const localName = name.slice(name.indexOf(":") + 1);
+		if (name !== "xsi:type" && !QNAME_VALUE_ATTRIBUTES.has(localName)) continue;
+		for (const token of String(value).split(/\s+/u)) {
+			const separatorIndex = token.indexOf(":");
+			prefixes.add(separatorIndex > 0 ? token.slice(0, separatorIndex) : token);
+		}
+	}
+	if (element.elements) {
+		for (const child of element.elements) if (child.type === "element") collectUsedNamespacePrefixes(child, prefixes);
+	}
+	return prefixes;
+};
+const isCanonicalNamespacePrefix = (prefix) => Object.hasOwn(NAMESPACES, prefix);
 /**
-* Return a shallow clone of `element` whose attributes carry every declaration
-* in `xmlnsDecls`. Existing attributes (including any namespace declarations the
-* element already carries) win over the injected ones.
+* Return a shallow clone of `element` carrying the inherited namespace
+* declarations needed by its raw subtree.
+*
+* Existing declarations retain their authored order. Only missing, referenced
+* bindings are appended, which makes repeated detach/replay cycles idempotent
+* even when the surrounding document declares a different namespace superset.
+* If a producer omitted a binding for a standard OOXML prefix, use its
+* canonical binding so the detached subtree is valid on its first replay.
 */
 function cloneWithXmlnsDeclarations(element, xmlnsDecls) {
-	if (Object.keys(xmlnsDecls).length === 0) return element;
-	return {
+	const prefixes = collectUsedNamespacePrefixes(element);
+	const additions = {};
+	const attributes = element.attributes ?? {};
+	for (const [name, value] of Object.entries(xmlnsDecls)) {
+		const prefix = name === "xmlns" ? "" : name.slice(6);
+		if (prefixes.has(prefix) && attributes[name] === void 0) additions[name] = value;
+	}
+	for (const prefix of prefixes) {
+		const name = `xmlns:${prefix}`;
+		if (!prefix || attributes[name] !== void 0 || additions[name] !== void 0 || !isCanonicalNamespacePrefix(prefix)) continue;
+		additions[name] = NAMESPACES[prefix];
+	}
+	for (const _key in additions) return {
 		...element,
 		attributes: {
-			...xmlnsDecls,
-			...element.attributes
+			...attributes,
+			...additions
 		}
 	};
+	return element;
 }
 //#endregion
-export { NAMESPACES, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };
+export { NAMESPACES, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };

package/dist/fields/bookmarkPages.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock, Page } from "../layout-engine/types.js";
-
 //#region src/fields/bookmarkPages.d.ts
 /**
  * Map each bookmark name to the 1-indexed page its anchoring paragraph lands on,

package/dist/fields/bookmarkText.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock } from "../layout-engine/types.js";
-
 //#region src/fields/bookmarkText.d.ts
 type BookmarkTextInputs = {
   fieldValues?: ReadonlyMap<number, string>;

package/dist/fields/evaluateField.d.ts

@@ -1,10 +1,12 @@
 import { ParsedFieldInstruction } from "../docx/fieldParser.js";
 import { FieldContext } from "./fieldContext.js";
-
 //#region src/fields/evaluateField.d.ts
 type EvaluateFieldOptions = {
-  /** Shown for unsupported field types and unresolved references. */fallback?: string; /** Run identity (`pmStart`) used to look up a precomputed SEQ value. */
-  instanceId?: number; /** Locked fields preserve their cached result instead of recalculating. */
+  /** Shown for unsupported field types and unresolved references. */
+  fallback?: string;
+  /** Run identity (`pmStart`) used to look up a precomputed SEQ value. */
+  instanceId?: number;
+  /** Locked fields preserve their cached result instead of recalculating. */
   locked?: boolean;
 };
 /**

package/dist/fields/fieldContext.d.ts

@@ -7,14 +7,20 @@
  * layout so a field paints the same value its width was measured against.
  */
 type FieldContext = {
-  /** 1-indexed page the field is on (PAGE). */pageNumber: number; /** Total pages in the document (NUMPAGES). */
+  /** 1-indexed page the field is on (PAGE). */
+  pageNumber: number;
+  /** Total pages in the document (NUMPAGES). */
   totalPages: number;
   /** Pages in the field's current section (SECTIONPAGES); omit until the
    *  per-section page counts are available, in which case the field falls back. */
-  sectionPages?: number; /** Bookmark name -> 1-indexed page it lands on (PAGEREF). */
-  bookmarkPages: ReadonlyMap<string, number>; /** Bookmark name -> resolved display text (REF). */
-  bookmarkText: ReadonlyMap<string, string>; /** Field instance id (the run's `pmStart`) -> precomputed SEQ value. */
-  seqValues: ReadonlyMap<number, number>; /** Clock for DATE/TIME-family fields; passed in so evaluation stays pure. */
+  sectionPages?: number;
+  /** Bookmark name -> 1-indexed page it lands on (PAGEREF). */
+  bookmarkPages: ReadonlyMap<string, number>;
+  /** Bookmark name -> resolved display text (REF). */
+  bookmarkText: ReadonlyMap<string, string>;
+  /** Field instance id (the run's `pmStart`) -> precomputed SEQ value. */
+  seqValues: ReadonlyMap<number, number>;
+  /** Clock for DATE/TIME-family fields; passed in so evaluation stays pure. */
   now: Date;
 };
 //#endregion

package/dist/fields/resolveFieldValues.d.ts

@@ -1,18 +1,19 @@
 import { FlowBlock, Page } from "../layout-engine/types.js";
-
 //#region src/fields/resolveFieldValues.d.ts
 /** Layout-derived inputs shared by every field, regardless of its position. */
 type SharedFieldInputs = {
   totalPages: number;
   bookmarkPages: ReadonlyMap<string, number>;
   bookmarkText: ReadonlyMap<string, string>;
-  seqValues: ReadonlyMap<number, number>; /** Section index -> page count, for SECTIONPAGES. */
+  seqValues: ReadonlyMap<number, number>;
+  /** Section index -> page count, for SECTIONPAGES. */
   sectionPageCounts: ReadonlyMap<number, number>;
   now: Date;
 };
 type HeaderFooterFieldInputs = Pick<SharedFieldInputs, "bookmarkPages" | "bookmarkText" | "seqValues" | "sectionPageCounts">;
 type ResolvedFieldValues = {
-  /** Field run `pmStart` -> resolved display text. */values: Map<number, string>;
+  /** Field run `pmStart` -> resolved display text. */
+  values: Map<number, string>;
   /**
    * True when at least one field resolved to a string that differs from the
    * text it was measured at (`fallback || "1"`), i.e. a re-measure would change

package/dist/fields/sectionPageCounts.d.ts

@@ -1,5 +1,4 @@
 import { Page } from "../layout-engine/types.js";
-
 //#region src/fields/sectionPageCounts.d.ts
 /**
  * Count how many pages belong to each section (by `Page.sectionIndex`, defaulting

package/dist/fields/seqValues.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock } from "../layout-engine/types.js";
-
 //#region src/fields/seqValues.d.ts
 /**
  * Assign each SEQ field instance its sequence number in document order, keyed by

package/dist/fonts/embeddedFontTable.d.ts

@@ -20,8 +20,11 @@
  */
 /** A single embedded face referenced from a `w:embed*` element. */
 type EmbeddedFontFaceRef = {
-  /** Relationship id (`r:id`) resolved via `word/_rels/fontTable.xml.rels`. */relId: string; /** Obfuscation key GUID (`w:fontKey`), e.g. `{XXXXXXXX-...}`. */
-  fontKey?: string; /** Whether the embedded face is subsetted (`w:subsetted`). */
+  /** Relationship id (`r:id`) resolved via `word/_rels/fontTable.xml.rels`. */
+  relId: string;
+  /** Obfuscation key GUID (`w:fontKey`), e.g. `{XXXXXXXX-...}`. */
+  fontKey?: string;
+  /** Whether the embedded face is subsetted (`w:subsetted`). */
   subsetted?: boolean;
 };
 /** One `<w:font>` entry with whichever of the four embed faces it declares. */

package/dist/fonts/embeddedFonts.d.ts

@@ -31,17 +31,25 @@ type EmbeddedFont = {
    * {@link buildEmbeddedFontFamilyMap}) to resolve document runs, which
    * still reference the font by its original DOCX name, to this family.
    */
-  family: string; /** Original Word font name (`w:font w:name`), before scoping. */
-  originalFamily: string; /** CSS `font-style` the face maps to (`embed*Italic` → `italic`). */
-  style: "normal" | "italic"; /** CSS `font-weight` the face maps to (`embedBold*` → `700`). */
-  weight: 400 | 700; /** De-obfuscated OpenType/TrueType bytes (backed by a fresh, non-shared buffer). */
-  bytes: Uint8Array<ArrayBuffer>; /** Whether the source face was subsetted (`w:subsetted`). */
+  family: string;
+  /** Original Word font name (`w:font w:name`), before scoping. */
+  originalFamily: string;
+  /** CSS `font-style` the face maps to (`embed*Italic` → `italic`). */
+  style: "normal" | "italic";
+  /** CSS `font-weight` the face maps to (`embedBold*` → `700`). */
+  weight: 400 | 700;
+  /** De-obfuscated OpenType/TrueType bytes (backed by a fresh, non-shared buffer). */
+  bytes: Uint8Array<ArrayBuffer>;
+  /** Whether the source face was subsetted (`w:subsetted`). */
   subsetted: boolean;
 };
 /** Already-unzipped package parts the pure extractor needs. */
 type EmbeddedFontParts = {
-  /** Raw `word/fontTable.xml`. */fontTableXml: string | null | undefined; /** Raw `word/_rels/fontTable.xml.rels`. */
-  fontTableRelsXml: string | null | undefined; /** Unzipped font binaries keyed by package path (e.g. `word/fonts/font1.odttf`). */
+  /** Raw `word/fontTable.xml`. */
+  fontTableXml: string | null | undefined;
+  /** Raw `word/_rels/fontTable.xml.rels`. */
+  fontTableRelsXml: string | null | undefined;
+  /** Unzipped font binaries keyed by package path (e.g. `word/fonts/font1.odttf`). */
   fonts: ReadonlyMap<string, ArrayBuffer>;
 };
 /**

package/dist/index.d.ts

@@ -5,12 +5,14 @@ import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MOD
 import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
 import { DeriveBlockIdInput, FolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { WordDiffSegment, diffWordSegments } from "./ai-edits/word-diff.js";
+import "./ai-edits/index.js";
 import { AIBarStatus, AIChatMode, AICitation, AICitationSource, AIGenerateInput, AISuggestion, AISuggestionApplyMode, AISuggestionPreset, AISuggestionSeverity, AISuggestionStatus, DEFAULT_AI_SUGGESTION_PRESETS } from "./ai-suggestions/types.js";
 import { ApplyResult, applySuggestions } from "./ai-suggestions/apply.js";
 import { ResolvedAnchor, isSuggestionStale, resolveSuggestionAnchor } from "./ai-suggestions/conflict.js";
 import { PositionalText, buildPositionalText } from "./ai-suggestions/text-positions.js";
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocumentPreset, DocumentStyleSet } from "./style-sets/types.js";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "./utils/createDocument.js";
+import { mergeDocumentContent } from "./utils/mergeDocumentContent.js";
 import { DocumentStyleCatalog, DocumentStyleCatalogEntry, ExtractDocumentStyleSetOptions, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "./style-sets/extract.js";
 import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "./style-sets/stellaStyle.js";
 import { createDocx } from "./docx/rezip.js";
@@ -32,4 +34,4 @@ import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/index.js

@@ -6,6 +6,7 @@ import { applyFolioAIEditOperations } from "./ai-edits/apply.js";
 import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "./style-sets/types.js";
 import { createEmptyDocument } from "./utils/createDocument.js";
+import { mergeDocumentContent } from "./utils/mergeDocumentContent.js";
 import { extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "./style-sets/extract.js";
 import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "./style-sets/stellaStyle.js";
 import { createDocx } from "./docx/rezip.js";
@@ -27,4 +28,4 @@ import { fromMarkdown } from "./markdown/fromMarkdown.js";
 import { toMarkdown, toMarkdownResult } from "./markdown/index.js";
 import { buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "./fonts/embeddedFonts.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
-export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/layout-bridge/cellSelectionHighlight.d.ts

@@ -1,5 +1,4 @@
 import { EditorState } from "prosemirror-state";
-
 //#region src/layout-bridge/cellSelectionHighlight.d.ts
 /**
  * Apply the `.layout-table-cell-selected` class to painted layout cells

package/dist/layout-bridge/convert/footnoteLayout.d.ts

@@ -1,13 +1,13 @@
 import { document_d_exports } from "../../types/document.js";
 import { FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FlowBlock, FootnoteContent, Measure, Page } from "../../layout-engine/types.js";
 import { ToFlowBlocksOptions } from "./toFlowBlocks.js";
-
 //#region src/layout-bridge/convert/footnoteLayout.d.ts
 type MeasureBlocksFn = (blocks: FlowBlock[], contentWidth: number) => Measure[];
 type ConvertFootnoteOptions = {
   styles?: document_d_exports.StyleDefinitions | null;
   theme?: document_d_exports.Theme | null;
-  measureBlocks?: MeasureBlocksFn; /** Document-wide `w:defaultTabStop` in twips — forwarded to toFlowBlocks. */
+  measureBlocks?: MeasureBlocksFn;
+  /** Document-wide `w:defaultTabStop` in twips — forwarded to toFlowBlocks. */
   defaultTabStopTwips?: number;
   lineBreakRules?: ToFlowBlocksOptions["lineBreakRules"];
   justificationCompatibility?: ToFlowBlocksOptions["justificationCompatibility"];
@@ -48,7 +48,9 @@ type NumberableNote = {
  */
 declare function computeNoteDisplayNumbers(notes: readonly NumberableNote[], refNoteIds: readonly number[]): Map<number, number>;
 type NoteDisplayNumberMaps = {
-  /** footnote `w:id` → sequential display number */footnoteNumbers?: ReadonlyMap<number, number>; /** endnote `w:id` → sequential display number */
+  /** footnote `w:id` → sequential display number */
+  footnoteNumbers?: ReadonlyMap<number, number>;
+  /** endnote `w:id` → sequential display number */
   endnoteNumbers?: ReadonlyMap<number, number>;
 };
 /**