@stll/folio-core 0.46.0 → 0.47.0

package/dist/docx/textBoxParser.d.ts

@@ -1,5 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
+import { ParseContext } from "./parseContext.js";
 import { XmlElement } from "./xmlParser.js";
 import { StyleMap } from "./styleParser.js";
 //#region src/docx/textBoxParser.d.ts
@@ -42,9 +43,10 @@ declare function isShapeTextBox(wsp: XmlElement): boolean;
  * parseTextBoxContent() separately with the required parsers.
  *
  * @param drawingEl - The w:drawing XML element
+ * @param context - Where an outline dash outside `ST_PresetLineDashVal` is reported
  * @returns TextBox object with placeholder content, or null if not a text box
  */
-declare function parseTextBox(drawingEl: XmlElement): document_d_exports.TextBox | null;
+declare function parseTextBox(drawingEl: XmlElement, context?: ParseContext): document_d_exports.TextBox | null;
 /**
  * Parse text box content XML element
  * @param wsp - The wps:wsp element containing the text box

package/dist/docx/textBoxParser.js

@@ -1,5 +1,6 @@
 import { emuToPixels } from "../utils/units.js";
-import { parseAnchorPosition, parseAnchorWrap, parseFill, parseOutline, resolveColorValueToHex } from "./drawingUtils.js";
+import { WORDPROCESSING_DRAWING_NAMESPACE_URIS, parseDrawingAnchor } from "./drawingAnchor.js";
+import { parseAnchorPosition, parseAnchorWrap, parseFill, parseInlineWrap, parseOutline, resolveColorValueToHex } from "./drawingUtils.js";
 import { parseNonVisualDrawingNames } from "./nonVisualDrawingProps.js";
 import { findByFullName, findChildByLocalName, findChildByNamespaceUri, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getChildElements, getLocalName, parseNumericAttribute, parseOnOffAttribute } from "./xmlParser.js";
 //#region src/docx/textBoxParser.ts
@@ -98,11 +99,17 @@ function parseTextBoxContent(txbxContent, parseParagraph, parseTable, styles, th
 	return blocks;
 }
 /**
+* The `wp:inline` or `wp:anchor` a drawing hangs off, resolved by namespace:
+* the `wp` prefix is the producer's choice and a package free to bind the
+* namespace elsewhere writes the same text box.
+*/
+const findDrawingContainer = (drawingEl) => findChildByNamespaceUri(drawingEl, WORDPROCESSING_DRAWING_NAMESPACE_URIS, "inline") ?? findChildByNamespaceUri(drawingEl, WORDPROCESSING_DRAWING_NAMESPACE_URIS, "anchor");
+/**
 * Check if a drawing element contains a text box
 * Text boxes are shapes with wps:txbx content
 */
 function isTextBoxDrawing(drawingEl) {
-	const container = getChildElements(drawingEl).find((el) => el.name === "wp:inline" || el.name === "wp:anchor");
+	const container = findDrawingContainer(drawingEl);
 	if (!container) return false;
 	const graphic = findByFullName(container, "a:graphic");
 	if (!graphic) return false;
@@ -127,12 +134,13 @@ function isShapeTextBox(wsp) {
 * parseTextBoxContent() separately with the required parsers.
 *
 * @param drawingEl - The w:drawing XML element
+* @param context - Where an outline dash outside `ST_PresetLineDashVal` is reported
 * @returns TextBox object with placeholder content, or null if not a text box
 */
-function parseTextBox(drawingEl) {
-	const container = getChildElements(drawingEl).find((el) => el.name === "wp:inline" || el.name === "wp:anchor");
+function parseTextBox(drawingEl, context) {
+	const container = findDrawingContainer(drawingEl);
 	if (!container) return null;
-	const isAnchor = container.name === "wp:anchor";
+	const isAnchor = getLocalName(container.name) === "anchor";
 	const graphic = findByFullName(container, "a:graphic");
 	if (!graphic) return null;
 	const graphicData = findByFullName(graphic, "a:graphicData");
@@ -151,7 +159,7 @@ function parseTextBox(drawingEl) {
 	const id = docPr ? getAttribute(docPr, null, "id") ?? void 0 : void 0;
 	const names = parseNonVisualDrawingNames(docPr);
 	const fill = parseFill(spPr ?? null);
-	const outline = parseOutline(spPr ?? null);
+	const outline = parseOutline(spPr ?? null, context);
 	const bodyProps = parseBodyProperties(bodyPr ?? null);
 	const textBox = {
 		type: "textBox",
@@ -172,7 +180,9 @@ function parseTextBox(drawingEl) {
 		if (position) textBox.position = position;
 		const wrap = parseAnchorWrap(container);
 		if (wrap) textBox.wrap = wrap;
-	} else textBox.wrap = { type: "inline" };
+		const anchor = parseDrawingAnchor(container);
+		if (anchor) textBox.anchor = anchor;
+	} else textBox.wrap = parseInlineWrap(container);
 	return textBox;
 }
 /**
@@ -290,7 +300,7 @@ const getTextBoxBlockText = (block) => {
 		return runTexts.join("");
 	}
 	if (block.type === "table") return block.rows.map((row) => row.cells.map((cell) => cell.content.map(getTextBoxBlockText).join("\n")).join("	")).join("\n");
-	if (block.type === "preservedBlock") return "";
+	if (block.type !== "blockSdt") return "";
 	return block.content.map(getTextBoxBlockText).join("\n");
 };
 /**

package/dist/docx/themeColorAttribute.d.ts

@@ -0,0 +1,13 @@
+import { ParseContext } from "./parseContext.js";
+import { ThemeColorValue } from "@stll/docx-core/model";
+//#region src/docx/themeColorAttribute.d.ts
+type ThemeColorAttributeOptions = {
+  /** The attribute as written, or `null` when the element does not carry it. */
+  raw: string | null | undefined;
+  /** The element the attribute sits on, for the warning's location. */
+  element?: string | undefined;
+  context?: ParseContext | undefined;
+};
+declare const parseThemeColorAttribute: ({ raw, element, context }: ThemeColorAttributeOptions) => ThemeColorValue | undefined;
+//#endregion
+export { ThemeColorAttributeOptions, parseThemeColorAttribute };

package/dist/docx/themeColorAttribute.js

@@ -0,0 +1,24 @@
+import { PARSE_WARNING_CODES, readThemeColor } from "@stll/docx-core/model";
+//#region src/docx/themeColorAttribute.ts
+/**
+* The one reader for a theme-colour attribute.
+*
+* `w:themeColor`, `w:themeFill` and the `w:clrSchemeMapping` values are all
+* `ST_ThemeColor`. Before this the attribute was narrowed against a union that
+* carried DrawingML slot names instead, so `hyperlink` — the token Word writes
+* for a hyperlink's colour — failed to narrow and the attribute was dropped at
+* parse time, taking it out of the next save. The enumeration is now generated
+* from the schema, and a token outside it is captured rather than refused, the
+* way `CT_Border/@w:val` already keeps a style outside `ST_Border`.
+*/
+const parseThemeColorAttribute = ({ raw, element, context }) => {
+	const value = readThemeColor(raw);
+	if (value !== void 0 && typeof value !== "string") context?.warn({
+		code: PARSE_WARNING_CODES.unrecognisedThemeColor,
+		value: value.raw,
+		...element === void 0 ? {} : { element }
+	});
+	return value;
+};
+//#endregion
+export { parseThemeColorAttribute };

package/dist/docx/trackedMoveRangeNormalization.js

@@ -1,4 +1,5 @@
-import { InlineContentRemovals, visitDocxParagraphs, visitInlineContentSlots } from "./paragraphTraversal.js";
+import { InlineContentRemovals } from "./inlineContentRemovals.js";
+import { visitDocxParagraphs, visitInlineContentSlots } from "./paragraphTraversal.js";
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
 //#region src/docx/trackedMoveRangeNormalization.ts
 /** The code this normalisation is reported under, owned here, not at the caller. */

package/dist/docx/vmlImageParser.d.ts

@@ -5,10 +5,19 @@ import { XmlElement } from "./xmlParser.js";
  * Whether a `w:pict` that resolved to no image must still be kept verbatim.
  *
  * VML has no serializer of its own, so an unresolved `w:pict` is only ever
- * preserved or lost. Two owners are excluded: a `v:textbox` belongs to the
- * text-box enrichment pass, which rebuilds it as an editable shape, and a
- * watermark shape belongs to watermarkParser; preserving either would emit the
- * same artwork twice.
+ * preserved or lost. One owner is excluded: a `v:textbox` belongs to the
+ * text-box enrichment pass, which rebuilds it as an editable shape, and
+ * preserving it here as well would emit the same artwork twice.
+ *
+ * A watermark shape is not a second exclusion. Declining for one was a guess
+ * about another module, and `watermarkParser` claims by a far narrower rule
+ * than `isWatermarkShape` states: a direct `v:shape` child of a `w:pict`,
+ * carrying a non-empty `v:textpath` or a `v:imagedata`, alone in its paragraph,
+ * in a header. A `v:oval`, a shape nested in a `v:group`, a shape sharing its
+ * paragraph with text, and every `w:pict` in a footer or in the body fall
+ * outside it, so their artwork was declined here and claimed by no one. The
+ * watermark owner removes its own artwork from the model instead, by emptying
+ * the paragraph it detached, so this predicate need not guess who claimed what.
  */
 declare function shouldPreserveRawVmlPict(pictElement: XmlElement): boolean;
 /**

package/dist/docx/vmlImageParser.js

@@ -1,12 +1,45 @@
 import { sanitizeImageSrc } from "../utils/sanitizeImageSrc.js";
 import { pixelsToEmu } from "../utils/units.js";
 import { resolveImageData } from "./imageParser.js";
+import { imageRawXmlFingerprint } from "./imageRawXml.js";
 import { PREVIEW_KINDS } from "./previewBudget.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { isValidVmlPreviewDimension, parseVmlNumber, parseVmlStyle, renderStandaloneVmlPreview, renderVmlGroupPreview, vmlCssLengthToPx, vmlSvgDataUrl } from "./vmlPreview.js";
 import { isWatermarkShape } from "./watermarkParser.js";
 import { cloneWithXmlnsDeclarations, findAllDeep, findChild, findDeep, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
+import { DRAWING_RAW_XML_MODES, relationshipIdOf } from "@stll/docx-core/model";
 //#region src/docx/vmlImageParser.ts
+/**
+* VML image parser — legacy `w:pict` inline pictures.
+*
+* Older Word documents (and some exporters) embed inline pictures such as
+* header logos as VML instead of DrawingML:
+*
+*   <w:r><w:pict>
+*     <v:shape id="Picture 1" type="#_x0000_t75" style="width:120pt;height:40pt">
+*       <v:imagedata r:id="rId7" o:title="logo"/>
+*     </v:shape>
+*   </w:pict></w:r>
+*
+* The run parser used to drop `w:pict` entirely, so these pictures never
+* rendered. This resolves `<v:imagedata r:id>` to the same media part a
+* DrawingML image uses and produces the identical `DrawingContent` / `Image`
+* node, so the rest of the pipeline (ProseMirror conversion, layout, painter)
+* renders it through the existing inline-image path.
+*
+* The original VML is preserved verbatim on the returned drawing's `rawXml`:
+* the serializer has no VML synthesis path (it only emits DrawingML), so
+* without this a `w:pict` would round-trip as a `<w:drawing>`. Emitting the
+* captured XML keeps save byte-for-byte for these runs.
+*
+* A watermark `watermarkParser` claimed is detached from its hosting
+* paragraph, so modelling it here as well would paint it twice; the
+* `isWatermarkShape` guard below keeps this reader off that shape. It does not
+* decide whether the markup survives: what nothing claims is preserved
+* verbatim by `shouldPreserveRawVmlPict`.
+*
+* Ported from eigenpal/docx-editor `vmlImageParser.ts`.
+*/
 const VML_POSITION_ABSOLUTE = "absolute";
 const IMAGE_WRAP_INLINE = "inline";
 const IMAGE_WRAP_BEHIND = "behind";
@@ -68,31 +101,33 @@ const previewImage = (pictElement, svg, widthPx, heightPx, style, rootXmlns) =>
 	const horizontalRelative = style["mso-position-horizontal-relative"] === "page";
 	const verticalRelative = style["mso-position-vertical-relative"] === "page";
 	const zIndex = parseVmlNumber(style["z-index"]);
-	return {
-		type: "drawing",
-		image: {
-			type: "image",
-			rId: "",
-			src,
-			mimeType: PREVIEW_KINDS.vmlShape.mimeType,
-			filename: PREVIEW_KINDS.vmlShape.filename,
-			size: {
-				width: pixelsToEmu(widthPx),
-				height: pixelsToEmu(heightPx)
+	const image = {
+		type: "image",
+		src,
+		mimeType: PREVIEW_KINDS.vmlShape.mimeType,
+		filename: PREVIEW_KINDS.vmlShape.filename,
+		size: {
+			width: pixelsToEmu(widthPx),
+			height: pixelsToEmu(heightPx)
+		},
+		wrap: { type: zIndex !== void 0 && zIndex >= 0 ? "inFront" : "behind" },
+		position: {
+			horizontal: {
+				relativeTo: horizontalRelative ? "page" : "character",
+				posOffset: pixelsToSafeEmu(leftPx) ?? 0
 			},
-			wrap: { type: zIndex !== void 0 && zIndex >= 0 ? "inFront" : "behind" },
-			position: {
-				horizontal: {
-					relativeTo: horizontalRelative ? "page" : "character",
-					posOffset: pixelsToSafeEmu(leftPx) ?? 0
-				},
-				vertical: {
-					relativeTo: verticalRelative ? "page" : "paragraph",
-					posOffset: pixelsToSafeEmu(topPx) ?? 0
-				}
+			vertical: {
+				relativeTo: verticalRelative ? "page" : "paragraph",
+				posOffset: pixelsToSafeEmu(topPx) ?? 0
 			}
-		},
-		rawXml: captureVerbatimXml(cloneWithXmlnsDeclarations(pictElement, rootXmlns))
+		}
+	};
+	return {
+		type: "drawing",
+		image,
+		rawXml: captureVerbatimXml(cloneWithXmlnsDeclarations(pictElement, rootXmlns)),
+		rawImageFingerprint: imageRawXmlFingerprint(image),
+		rawXmlMode: DRAWING_RAW_XML_MODES.PREVIEW_ONLY
 	};
 };
 const previewDrawing = (pictElement, preview, rootXmlns) => {
@@ -120,15 +155,23 @@ const VML_DRAWABLE_SHAPES = [
 * Whether a `w:pict` that resolved to no image must still be kept verbatim.
 *
 * VML has no serializer of its own, so an unresolved `w:pict` is only ever
-* preserved or lost. Two owners are excluded: a `v:textbox` belongs to the
-* text-box enrichment pass, which rebuilds it as an editable shape, and a
-* watermark shape belongs to watermarkParser; preserving either would emit the
-* same artwork twice.
+* preserved or lost. One owner is excluded: a `v:textbox` belongs to the
+* text-box enrichment pass, which rebuilds it as an editable shape, and
+* preserving it here as well would emit the same artwork twice.
+*
+* A watermark shape is not a second exclusion. Declining for one was a guess
+* about another module, and `watermarkParser` claims by a far narrower rule
+* than `isWatermarkShape` states: a direct `v:shape` child of a `w:pict`,
+* carrying a non-empty `v:textpath` or a `v:imagedata`, alone in its paragraph,
+* in a header. A `v:oval`, a shape nested in a `v:group`, a shape sharing its
+* paragraph with text, and every `w:pict` in a footer or in the body fall
+* outside it, so their artwork was declined here and claimed by no one. The
+* watermark owner removes its own artwork from the model instead, by emptying
+* the paragraph it detached, so this predicate need not guess who claimed what.
 */
 function shouldPreserveRawVmlPict(pictElement) {
 	if (findDeep(pictElement, "v", "textbox")) return false;
-	const shapes = VML_DRAWABLE_SHAPES.flatMap((localName) => findAllDeep(pictElement, "v", localName));
-	return shapes.length > 0 && !shapes.some((shape) => isWatermarkShape(shape));
+	return VML_DRAWABLE_SHAPES.some((localName) => findDeep(pictElement, "v", localName) !== null);
 }
 /**
 * Whether the run parser turns this `w:pict` into run content of its own.
@@ -173,8 +216,8 @@ function parseVmlImageContent(pictElement, rels, media, rootXmlns = {}) {
 	for (const shape of shapes) {
 		const imagedata = findChild(shape, "v", "imagedata");
 		if (!imagedata) continue;
-		const rId = readImageDataRId(imagedata);
-		if (rId === void 0 || rId.length === 0) continue;
+		const rId = relationshipIdOf(readImageDataRId(imagedata));
+		if (rId === void 0) continue;
 		if (isWatermarkShape(shape)) continue;
 		const { src, mimeType, filename } = resolveImageData(rId, rels ?? void 0, media ?? void 0);
 		const shapeStyle = parseVmlStyle(getAttribute(shape, null, "style"));

package/dist/docx/vmlPreview.js

@@ -1,4 +1,4 @@
-import { VML_PREVIEW_DATA_URL_PREFIX } from "./previewBudget.js";
+import { PREVIEW_KINDS } from "./previewBudget.js";
 import { findChild, findDeep, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
 //#region src/docx/vmlPreview.ts
 const MAX_VML_PREVIEW_DEPTH = 16;
@@ -84,7 +84,7 @@ const parseVmlNumber = (raw) => {
 /** Check a physical preview dimension against the retained SVG layout bound. */
 const isValidVmlPreviewDimension = (value) => value !== void 0 && value > 0 && value <= MAX_VML_PREVIEW_DIMENSION_PX;
 /** Encode a generated, already-sanitized SVG without exceeding its output cap. */
-const vmlSvgDataUrl = (svg) => svg.length <= MAX_VML_SVG_CHARACTERS ? `${VML_PREVIEW_DATA_URL_PREFIX}${encodeURIComponent(svg)}` : void 0;
+const vmlSvgDataUrl = (svg) => svg.length <= MAX_VML_SVG_CHARACTERS ? `${PREVIEW_KINDS.vmlShape.srcPrefix}${encodeURIComponent(svg)}` : void 0;
 const validCoordinate = (value) => value !== void 0 && Math.abs(value) <= MAX_VML_PREVIEW_COORDINATE;
 const validExtent = (value) => value !== void 0 && value > 0 && value <= MAX_VML_PREVIEW_COORDINATE;
 const coordinatePair = (raw) => {

package/dist/docx/wrapPolygon.d.ts

@@ -0,0 +1,30 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/wrapPolygon.d.ts
+/**
+ * The polygon a `wp:wrapTight` or `wp:wrapThrough` states: the authored one, or
+ * the rectangle when the model holds none.
+ *
+ * An authored path is written back as it stands, including one shorter than
+ * `CT_WrapPath`'s two `wp:lineTo`. folio is not the validator of its input, and
+ * replacing a short outline with the full extent of the drawing would move text
+ * that the source flows through the object — the same silent substitution this
+ * module exists to end. The rectangle is minted only where the alternative is
+ * omitting a child the type requires.
+ */
+declare const requiredWrapPolygon: (authored: document_d_exports.ImageWrapPolygon | undefined) => document_d_exports.ImageWrapPolygon;
+/**
+ * The polygon a wrap of `type` has to state, or undefined when its type
+ * declares none.
+ *
+ * The editor command that changes a wrap type calls this, so a drawing that
+ * becomes tight or through is minted its rectangle once — at the edit, as a
+ * fact of the document the author can see and undo — and every save after that
+ * writes back what the model then holds.
+ */
+declare const wrapPolygonFor: (type: document_d_exports.ImageWrap["type"], authored: document_d_exports.ImageWrapPolygon | undefined) => document_d_exports.ImageWrapPolygon | undefined;
+/** A copy, deep enough that a ProseMirror attr cannot share a point with the model. */
+declare const copiedWrapPolygon: (polygon: document_d_exports.ImageWrapPolygon | undefined) => document_d_exports.ImageWrapPolygon | undefined;
+/** `wp:wrapPolygon`, written from a polygon {@link wrapPolygonFor} has approved. */
+declare const serializeWrapPolygon: (polygon: document_d_exports.ImageWrapPolygon) => string;
+//#endregion
+export { copiedWrapPolygon, requiredWrapPolygon, serializeWrapPolygon, wrapPolygonFor };

package/dist/docx/wrapPolygon.js

@@ -0,0 +1,70 @@
+import { intAttr } from "./serializer/xmlUtils.js";
+//#region src/docx/wrapPolygon.ts
+/** `CT_WrapPath` coordinates are relative to a box of this many units. */
+const WRAP_PATH_EXTENT = 21600;
+/**
+* The whole drawing, as a closed rectangle in the path's relative space: the
+* polygon that leaves text flowing exactly as the wrap's bounding box would.
+* The only wrap outline folio invents.
+*/
+const DEFAULT_WRAP_POLYGON = {
+	edited: false,
+	start: {
+		x: 0,
+		y: 0
+	},
+	lineTo: [
+		{
+			x: 0,
+			y: WRAP_PATH_EXTENT
+		},
+		{
+			x: WRAP_PATH_EXTENT,
+			y: WRAP_PATH_EXTENT
+		},
+		{
+			x: WRAP_PATH_EXTENT,
+			y: 0
+		},
+		{
+			x: 0,
+			y: 0
+		}
+	]
+};
+/**
+* The polygon a `wp:wrapTight` or `wp:wrapThrough` states: the authored one, or
+* the rectangle when the model holds none.
+*
+* An authored path is written back as it stands, including one shorter than
+* `CT_WrapPath`'s two `wp:lineTo`. folio is not the validator of its input, and
+* replacing a short outline with the full extent of the drawing would move text
+* that the source flows through the object — the same silent substitution this
+* module exists to end. The rectangle is minted only where the alternative is
+* omitting a child the type requires.
+*/
+const requiredWrapPolygon = (authored) => authored ?? DEFAULT_WRAP_POLYGON;
+/**
+* The polygon a wrap of `type` has to state, or undefined when its type
+* declares none.
+*
+* The editor command that changes a wrap type calls this, so a drawing that
+* becomes tight or through is minted its rectangle once — at the edit, as a
+* fact of the document the author can see and undo — and every save after that
+* writes back what the model then holds.
+*/
+const wrapPolygonFor = (type, authored) => type === "tight" || type === "through" ? requiredWrapPolygon(authored) : void 0;
+/** A copy, deep enough that a ProseMirror attr cannot share a point with the model. */
+const copiedWrapPolygon = (polygon) => polygon === void 0 ? void 0 : {
+	...polygon,
+	start: { ...polygon.start },
+	lineTo: polygon.lineTo.map((point) => ({ ...point }))
+};
+/** `wp:wrapPolygon`, written from a polygon {@link wrapPolygonFor} has approved. */
+const serializeWrapPolygon = (polygon) => {
+	const edited = polygon.edited === void 0 ? "" : ` edited="${polygon.edited ? "1" : "0"}"`;
+	const lineTo = polygon.lineTo.map((point) => `<wp:lineTo x="${intAttr(point.x)}" y="${intAttr(point.y)}"/>`).join("");
+	return `<wp:wrapPolygon${edited}><wp:start x="${intAttr(polygon.start.x)}" y="${intAttr(polygon.start.y)}"/>${lineTo}</wp:wrapPolygon>`;
+};
+//#endregion
+export { copiedWrapPolygon, requiredWrapPolygon, serializeWrapPolygon, wrapPolygonFor };

package/dist/docx/xmlParser.d.ts

@@ -124,6 +124,8 @@ declare const OFFICE_RELATIONSHIP_NAMESPACE_URIS: ReadonlySet<string>;
  * from a foreign namespace is not accepted.
  */
 declare function findChildByNamespaceUri(parent: XmlElement | null | undefined, namespaceUris: ReadonlySet<string>, localName: string): XmlElement | null;
+/** First direct child in either supported WordprocessingML namespace. */
+declare const findWordprocessingChild: (parent: XmlElement | null | undefined, localName: string) => XmlElement | null;
 /** All direct children whose local name and resolved namespace both match. */
 declare function findChildrenByNamespaceUri(parent: XmlElement | null | undefined, namespaceUris: ReadonlySet<string>, localName: string): XmlElement[];
 type XmlAttributeMatch = {
@@ -333,6 +335,17 @@ declare function parseOnOffValue(value: string | null | undefined, context?: Par
  * @returns boolean value
  */
 declare function parseBooleanElement(element: XmlElement | null | undefined, namespace?: string, context?: ParseContext): boolean;
+/**
+ * Read a `CT_OnOff` child as the three states it has.
+ *
+ * `parseBooleanElement` answers a two-state question, so it folds an absent
+ * element into the same `false` as an explicit `w:val="0"`. They are not the
+ * same thing: absent inherits the style hierarchy, and an explicit off is the
+ * only thing that cancels an inherited on. A property set that has to survive
+ * a save reads its toggles through here, and writes what it gets back —
+ * `undefined` included — so the element it did not carry stays uncarried.
+ */
+declare function parseOnOffChild(parent: XmlElement | null | undefined, namespace: string, localName: string, context?: ParseContext): boolean | undefined;
 /**
  * Deep find - search recursively for an element
  *
@@ -392,4 +405,4 @@ declare function cloneWithXmlnsDeclarations(element: XmlElement, xmlnsDecls: Rec
  */
 declare function cloneElement(element: XmlElement, overrides: Partial<XmlElement>): XmlElement;
 //#endregion
-export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, XmlAttributeMatch, XmlElement, XmlNamespaceScope, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, resolveAttributeNamespaceUri, selectAlternateContentBranch };
+export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, XmlAttributeMatch, XmlElement, XmlNamespaceScope, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, findWordprocessingChild, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffAttribute, parseOnOffChild, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, resolveAttributeNamespaceUri, selectAlternateContentBranch };

package/dist/docx/xmlParser.js

@@ -1,9 +1,9 @@
 import { NUMBERS_PER_PERCENT, percentageSpelling, transitionalSlotEncoding } from "./transitionalSpelling.js";
 import { universalMeasureAs } from "./universalMeasure.js";
 import { escapeXmlAttribute, escapeXmlText } from "@stll/docx-core";
+import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
 import { XMLParser } from "fast-xml-parser";
 import { OOXML_NS } from "@stll/docx-utils";
-import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
 //#region src/docx/xmlParser.ts
 /**
 * XML Parser Utilities for OOXML
@@ -273,6 +273,8 @@ function findChildByNamespaceUri(parent, namespaceUris, localName) {
 	for (const child of parent.elements) if (child.type === "element" && hasLocalName(child.name, localName) && namespaceUris.has(child.namespaceUri ?? "")) return child;
 	return null;
 }
+/** First direct child in either supported WordprocessingML namespace. */
+const findWordprocessingChild = (parent, localName) => findChildByNamespaceUri(parent, WORDPROCESSINGML_NAMESPACE_URIS, localName);
 /** All direct children whose local name and resolved namespace both match. */
 function findChildrenByNamespaceUri(parent, namespaceUris, localName) {
 	if (!parent?.elements) return [];
@@ -674,6 +676,20 @@ function parseBooleanElement(element, namespace = "w", context) {
 	return parseOnOffValue(val, context, elementName) ?? false;
 }
 /**
+* Read a `CT_OnOff` child as the three states it has.
+*
+* `parseBooleanElement` answers a two-state question, so it folds an absent
+* element into the same `false` as an explicit `w:val="0"`. They are not the
+* same thing: absent inherits the style hierarchy, and an explicit off is the
+* only thing that cancels an inherited on. A property set that has to survive
+* a save reads its toggles through here, and writes what it gets back —
+* `undefined` included — so the element it did not carry stays uncarried.
+*/
+function parseOnOffChild(parent, namespace, localName, context) {
+	const element = findChildren(parent, namespace, localName).at(-1);
+	return element === void 0 ? void 0 : parseBooleanElement(element, namespace, context);
+}
+/**
 * Deep find - search recursively for an element
 *
 * @param root - Root element to search from
@@ -868,4 +884,4 @@ function cloneElement(element, overrides) {
 	return clone;
 }
 //#endregion
-export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, resolveAttributeNamespaceUri, selectAlternateContentBranch };
+export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, findWordprocessingChild, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffAttribute, parseOnOffChild, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, resolveAttributeNamespaceUri, selectAlternateContentBranch };

package/dist/fonts/embeddedFonts.js

@@ -1,7 +1,7 @@
+import { parseFontTable } from "../docx/fontTableParser.js";
 import { parseRelationships, resolveRelativePath } from "../docx/relsParser.js";
 import { unzipDocx } from "../docx/unzip.js";
 import { generateHexId } from "../utils/hexId.js";
-import { parseEmbeddedFontTable } from "./embeddedFontTable.js";
 import { deobfuscateFont, isValidFontKey } from "./fontDeobfuscation.js";
 //#region src/fonts/embeddedFonts.ts
 /**
@@ -69,7 +69,7 @@ function lookupFontData(resolvedPath, fonts) {
 	for (const [path, data] of fonts) if (normalizePackagePath(path) === wanted) return data;
 }
 function resolveFace(originalFamily, ref, kind, fonts, rels, docNonce) {
-	const target = rels.get(ref.relId)?.target;
+	const target = rels.get(ref.id)?.target;
 	if (!target) return null;
 	const raw = lookupFontData(resolveRelativePath(FONTTABLE_RELS_BASE_PATH, target), fonts);
 	if (!raw) return null;
@@ -95,7 +95,7 @@ function resolveFace(originalFamily, ref, kind, fonts, rels, docNonce) {
 * an explicit value for deterministic tests.
 */
 function getEmbeddedFontFaces(parts, docNonce = generateHexId()) {
-	const entries = parseEmbeddedFontTable(parts.fontTableXml);
+	const entries = parseFontTable(parts.fontTableXml)?.fonts ?? [];
 	if (entries.length === 0) return [];
 	if (!parts.fontTableRelsXml || parts.fonts.size === 0) return [];
 	const rels = parseRelationships(parts.fontTableRelsXml);

package/dist/headless-layout.js

@@ -90,6 +90,7 @@ const buildFlowOptions = (document, pageContentHeight) => {
 	const settings = document.package.settings;
 	const options = {
 		pageContentHeight,
+		defaultSize: 10,
 		fontAlternates: buildFontAlternates(document.package.fontTable),
 		...document.package.styles ? { styles: document.package.styles } : {}
 	};
@@ -116,6 +117,7 @@ const buildBlockLookup = (blocks, measures) => new Map(blocks.flatMap((block, in
 	}]];
 }));
 const buildStoryOptions = (flowOptions) => ({
+	...flowOptions.defaultSize === void 0 ? {} : { defaultSize: flowOptions.defaultSize },
 	...flowOptions.styles === void 0 ? {} : { styles: flowOptions.styles },
 	...flowOptions.theme === void 0 ? {} : { theme: flowOptions.theme },
 	...flowOptions.fontAlternates === void 0 ? {} : { fontAlternates: flowOptions.fontAlternates },