@stll/folio-core 0.45.0 → 0.47.0

package/dist/utils/tableOperations.js

@@ -1,4 +1,17 @@
+import { TABLE_JUSTIFICATION_VALUES } from "../types/documentEnumValues.js";
 //#region src/utils/tableOperations.ts
+const TABLE_PROPERTY_JUSTIFICATION_ORDER = {
+	left: 0,
+	center: 1,
+	right: 2,
+	start: 3,
+	end: 4
+};
+const TABLE_PROPERTY_JUSTIFICATIONS = Object.freeze(TABLE_JUSTIFICATION_VALUES.toSorted((left, right) => TABLE_PROPERTY_JUSTIFICATION_ORDER[left] - TABLE_PROPERTY_JUSTIFICATION_ORDER[right]));
+const toTablePropertyJustification = (value) => {
+	for (const justification of TABLE_PROPERTY_JUSTIFICATIONS) if (value === justification) return justification;
+	return "left";
+};
 const getColumnCount = (table) => {
 	let maxCols = 0;
 	for (const row of table.rows) {
@@ -256,4 +269,4 @@ const splitCell = (table, rowIndex, columnIndex) => {
 	};
 };
 //#endregion
-export { addColumn, addRow, createTableContext, deleteColumn, deleteRow, getCellAt, getColumnCount, mergeCells, splitCell };
+export { TABLE_PROPERTY_JUSTIFICATIONS, addColumn, addRow, createTableContext, deleteColumn, deleteRow, getCellAt, getColumnCount, mergeCells, splitCell, toTablePropertyJustification };

package/dist/utils/tablePlacement.d.ts

@@ -0,0 +1,7 @@
+import { TableAlignment } from "../types/formatting.js";
+//#region src/utils/tablePlacement.d.ts
+type PhysicalTableAlignment = "left" | "center" | "right";
+/** Resolve an OOXML table placement to a physical inline alignment. */
+declare const resolveTablePlacementAlignment: (placement: TableAlignment, rightToLeft: boolean) => PhysicalTableAlignment;
+//#endregion
+export { PhysicalTableAlignment, resolveTablePlacementAlignment };

package/dist/utils/tablePlacement.js

@@ -0,0 +1,14 @@
+//#region src/utils/tablePlacement.ts
+/** Resolve an OOXML table placement to a physical inline alignment. */
+const resolveTablePlacementAlignment = (placement, rightToLeft) => {
+	switch (placement) {
+		case "center": return "center";
+		case "left":
+		case "start": return rightToLeft ? "right" : "left";
+		case "right":
+		case "end": return rightToLeft ? "left" : "right";
+		default: return placement;
+	}
+};
+//#endregion
+export { resolveTablePlacementAlignment };

package/dist/utils/textDirectionFlow.d.ts

@@ -0,0 +1,15 @@
+import { TextDirection } from "@stll/docx-core/model";
+//#region src/utils/textDirectionFlow.d.ts
+type TextFlowCss = {
+  /** `horizontal-tb` needs no declaration; the others are written out. */
+  writingMode: "horizontal-tb" | "vertical-lr" | "vertical-rl";
+  /**
+   * CSS has no writing mode for a bottom-to-top flow, so the nearest one is
+   * turned upside down.
+   */
+  rotateDegrees?: 180;
+};
+/** The CSS a `w:textDirection` token renders as, through the flow it names. */
+declare const textFlowCss: (direction: TextDirection) => TextFlowCss;
+//#endregion
+export { TextFlowCss, textFlowCss };

package/dist/utils/textDirectionFlow.js

@@ -0,0 +1,38 @@
+import { TEXT_DIRECTION_FLOW_BY_TOKEN } from "@stll/docx-core/model";
+//#region src/utils/textDirectionFlow.ts
+/**
+* The CSS one `w:textDirection` flow renders as.
+*
+* `ST_TextDirection` spells each of its six flows twice — a Strict spelling
+* and a Transitional one — so rendering is decided per flow and read through
+* `TEXT_DIRECTION_FLOW_BY_TOKEN`. Both CSS projections, the editor's inline
+* style and `tableCellToStyle`, read this one map: a cell written `tbRl` and
+* its Strict twin written `rl` cannot render differently in one and the same
+* in the other.
+*/
+/**
+* Each text flow, and the CSS that renders it.
+*
+* `tb` and `tbV` are the horizontal flows. `rl` and `rlV` run their lines
+* right to left, `lrV` runs them left to right, and `lr` runs them left to
+* right with its characters bottom-to-top, which CSS cannot express: it takes
+* the nearest writing mode turned over.
+*
+* Total over the flows on purpose: a flow nobody mapped would otherwise render
+* as horizontal text with nothing to say it had been dropped.
+*/
+const TEXT_FLOW_CSS = {
+	tb: { writingMode: "horizontal-tb" },
+	tbV: { writingMode: "horizontal-tb" },
+	rl: { writingMode: "vertical-rl" },
+	rlV: { writingMode: "vertical-rl" },
+	lrV: { writingMode: "vertical-lr" },
+	lr: {
+		writingMode: "vertical-lr",
+		rotateDegrees: 180
+	}
+};
+/** The CSS a `w:textDirection` token renders as, through the flow it names. */
+const textFlowCss = (direction) => TEXT_FLOW_CSS[TEXT_DIRECTION_FLOW_BY_TOKEN[direction]];
+//#endregion
+export { textFlowCss };

package/dist/utils/textFormattingMerge.js

@@ -31,14 +31,26 @@ function mergeStyleTextFormatting(target, source) {
 	}
 	return result;
 }
+/**
+* A merge answers "what does this text look like once the style, the paragraph
+* mark and the run have all had their say". `preserved` is not a value: it is
+* the bytes one specific `w:rPr` held, and carrying it across a merge would
+* write a style's or a paragraph mark's markup into every run that inherits
+* from it. So no merged formatting has one, on any path out of the function.
+*/
+const withoutPreserved = (formatting) => {
+	if (formatting.preserved === void 0) return formatting;
+	const { preserved: _preserved, ...values } = formatting;
+	return values;
+};
 function mergeTextFormatting(target, source) {
 	if (!source && !target) return;
-	if (!source) return target;
-	if (!target) return { ...source };
-	const result = { ...target };
+	if (!source) return target && withoutPreserved(target);
+	if (!target) return withoutPreserved({ ...source });
+	const result = { ...withoutPreserved(target) };
 	for (const key of Object.keys(source)) {
 		const value = source[key];
-		if (value === void 0) continue;
+		if (value === void 0 || key === "preserved") continue;
 		if (key === "fontFamily" && typeof value === "object") {
 			result["fontFamily"] = mergeFontFamily(target.fontFamily, value);
 			continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -24,6 +24,13 @@
     "url": "https://github.com/stella/folio.git",
     "directory": "packages/core"
   },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE",
+    "NOTICE.md"
+  ],
   "type": "module",
   "sideEffects": false,
   "exports": {
@@ -121,7 +128,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.23.0",
+    "@stll/docx-core": "^0.25.0",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": ">=0.4.0 <1.0.0",
     "better-result": "3.0.1",
@@ -152,12 +159,5 @@
     "@types/hyphen": "1.14.0"
   },
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist",
-    "skills",
-    "README.md",
-    "LICENSE",
-    "NOTICE.md"
-  ]
+  "types": "./dist/index.d.ts"
 }

package/dist/ai-edits/__fixtures__/paragraphs.d.ts

@@ -1,17 +0,0 @@
-//#region src/ai-edits/__fixtures__/paragraphs.d.ts
-/**
- * The smallest `.docx` that carries a list of paragraphs, generated rather
- * than committed as bytes so a test's input is legible in its own diff.
- */
-type ParagraphsDocxOptions = {
-  /**
-   * Wrap the paragraphs in a single table cell, followed by one body
-   * paragraph. The cell's last paragraph then has a sibling in the document
-   * and none in its own container, which is the case a paragraph-mark
-   * deletion must refuse.
-   */
-  inTableCell?: boolean;
-};
-declare const buildParagraphsDocx: (paragraphs: readonly string[], { inTableCell }?: ParagraphsDocxOptions) => Promise<ArrayBuffer>;
-//#endregion
-export { ParagraphsDocxOptions, buildParagraphsDocx };

package/dist/ai-edits/__fixtures__/paragraphs.js

@@ -1,33 +0,0 @@
-import { escapeXmlText } from "@stll/docx-core";
-import JSZip from "jszip";
-//#region src/ai-edits/__fixtures__/paragraphs.ts
-/**
-* The smallest `.docx` that carries a list of paragraphs, generated rather
-* than committed as bytes so a test's input is legible in its own diff.
-*/
-const NAMESPACE = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
-const RELATIONSHIPS = "http://schemas.openxmlformats.org/package/2006/relationships";
-const OFFICE_RELATIONSHIPS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
-const WORDPROCESSING = "application/vnd.openxmlformats-officedocument.wordprocessingml";
-/** Pinned, with no folder entries, so two builds produce identical bytes. */
-const ZIP_ENTRY_OPTIONS = {
-	date: new Date(Date.UTC(2e3, 0, 1)),
-	createFolders: false
-};
-const paragraphXml = (text) => `<w:p><w:r><w:t xml:space="preserve">${escapeXmlText(text)}</w:t></w:r></w:p>`;
-const buildParagraphsDocx = async (paragraphs, { inTableCell } = {}) => {
-	const paragraphsXml = paragraphs.map(paragraphXml).join("");
-	const body = inTableCell ? `<w:tbl><w:tblPr><w:tblW w:w="0" w:type="auto"/></w:tblPr><w:tblGrid><w:gridCol w:w="9360"/></w:tblGrid><w:tr><w:tc><w:tcPr><w:tcW w:w="9360" w:type="dxa"/></w:tcPr>${paragraphsXml}</w:tc></w:tr></w:tbl>` + paragraphXml("After the table.") : paragraphsXml;
-	const parts = {
-		"[Content_Types].xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/word/document.xml" ContentType="${WORDPROCESSING}.document.main+xml"/><Override PartName="/word/styles.xml" ContentType="${WORDPROCESSING}.styles+xml"/></Types>`,
-		"_rels/.rels": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="${RELATIONSHIPS}"><Relationship Id="rId1" Type="${OFFICE_RELATIONSHIPS}/officeDocument" Target="word/document.xml"/></Relationships>`,
-		"word/_rels/document.xml.rels": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="${RELATIONSHIPS}"><Relationship Id="rId1" Type="${OFFICE_RELATIONSHIPS}/styles" Target="styles.xml"/></Relationships>`,
-		"word/styles.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:styles xmlns:w="${NAMESPACE}"><w:style w:type="paragraph" w:default="1" w:styleId="Normal"><w:name w:val="Normal"/></w:style></w:styles>`,
-		"word/document.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:document xmlns:w="${NAMESPACE}"><w:body>${body}<w:sectPr><w:pgSz w:w="12240" w:h="15840"/></w:sectPr></w:body></w:document>`
-	};
-	const zip = new JSZip();
-	for (const name of Object.keys(parts).toSorted()) zip.file(name, parts[name] ?? "", ZIP_ENTRY_OPTIONS);
-	return await zip.generateAsync({ type: "arraybuffer" });
-};
-//#endregion
-export { buildParagraphsDocx };

package/dist/compare/__fixtures__/body-sequence.d.ts

@@ -1,119 +0,0 @@
-//#region src/compare/__fixtures__/body-sequence.d.ts
-/**
- * A document body written from a sequence of paragraphs and tables.
- *
- * The edit-script DSL can move words and rows but cannot append a table, so a
- * pair whose difference is "a paragraph AND a table were added after the last
- * one" has to be authored as two packages. Generating both from one description
- * keeps the difference visible in the diff instead of hidden in bytes.
- */
-/**
- * One cell's content: a line of text, or a sequence of its own — which is how
- * a nested table, a blank line inside a cell, or a cell that ends with a table
- * gets written.
- */
-type CellContent = string | readonly BodyItem[];
-/** `w:tcPr` children a fixture can author, each named after the element. */
-type CellProperties = {
-  /** `w:gridSpan`: grid columns this cell occupies. */
-  gridSpan?: number;
-  /** `w:vMerge`: the cell starts a vertical merge, or continues one. */
-  verticalMerge?: "restart" | "continue";
-  /** `w:tcW` in twips. */
-  width?: number;
-  /** `w:shd` fill colour, as six hex digits. */
-  shadingFill?: string;
-  /** `w:vAlign`. */
-  verticalAlign?: "top" | "center" | "bottom";
-  /** `w:tcBorders`, single style on all four sides, in eighths of a point. */
-  borderSize?: number;
-  /** `w:tcMar`, the same margin on all four sides, in twips. */
-  margin?: number;
-};
-/** A cell: its content alone, or its content and its own `w:tcPr`. */
-type Cell = CellContent | ({
-  content: CellContent;
-} & CellProperties);
-/** A row: its cells alone, or its cells and its own `w:trPr`. */
-type TableRow = readonly Cell[] | {
-  cells: readonly Cell[];
-  /** `w:trHeight` in twips. */
-  height?: number;
-  /** `w:tblHeader`: the row repeats at the top of every page. */
-  header?: boolean;
-  /** `w:jc` on the row. */
-  justification?: "left" | "center" | "right";
-};
-/** `w:tblPr` children a fixture can author, each named after the element. */
-type TableProperties = {
-  /** `w:tblStyle`. */
-  styleId?: string;
-  /** `w:tblW`. */
-  width?: {
-    value: number;
-    type: "auto" | "dxa" | "pct";
-  };
-  /** `w:bidiVisual`. */
-  bidi?: boolean;
-  /** `w:jc` on the table. */
-  justification?: "left" | "center" | "right";
-  /** `w:tblInd` in twips. */
-  indent?: number;
-  /** `w:tblCellSpacing` in twips. */
-  cellSpacing?: number;
-  /** `w:tblBorders`, single style on every side, in eighths of a point. */
-  borderSize?: number;
-  /** `w:shd` fill colour on the table, as six hex digits. */
-  shadingFill?: string;
-  /** `w:tblLayout`. */
-  layout?: "fixed" | "autofit";
-  /** `w:tblCellMar`, the same margin on all four sides, in twips. */
-  cellMargin?: number;
-  /** `w:tblLook` value, as four hex digits. */
-  look?: string;
-};
-/**
- * One inline of a paragraph: plain text, or text carrying an external
- * hyperlink. A link is the case where a revision wrapper and the linked runs
- * have to nest one inside the other, so the fixture has to be able to author
- * one.
- */
-type ParagraphInline = string | {
-  text: string;
-  href: string;
-};
-/** One body-level item: a paragraph, or a table given row by row. */
-type BodyItem = {
-  kind: "paragraph";
-  text: string | readonly ParagraphInline[];
-  styleId?: string;
-  /**
-   * An authored `w14:paraId`, for a package whose ids a producer wrote
-   * without respecting the 31-bit bound the schema puts on them.
-   */
-  paraId?: string;
-} | {
-  kind: "table";
-  rows: readonly TableRow[];
-  /** `w:tblPr` children, written in the order the schema requires. */
-  properties?: TableProperties;
-  /** `w:tblGrid` column widths, in twips. One per grid column. */
-  columnWidths?: readonly number[];
-  /**
-   * Rows a package hides with `w:hidden`. The snapshot skips their whole
-   * subtree, so a document that has one is the case where the snapshot
-   * walk and the live walk could disagree.
-   */
-  hiddenRows?: readonly number[];
-};
-type BodySequenceOptions = {
-  /**
-   * A default header part, written as its own sequence. A header is a story of
-   * its own: it ends with its own paragraph, and a comparison writes it with
-   * its own revision ids.
-   */
-  header?: readonly BodyItem[];
-};
-declare const buildBodySequenceDocx: (items: readonly BodyItem[], { header }?: BodySequenceOptions) => Promise<ArrayBuffer>;
-//#endregion
-export { BodyItem, BodySequenceOptions, Cell, CellContent, CellProperties, ParagraphInline, TableProperties, TableRow, buildBodySequenceDocx };

package/dist/compare/__fixtures__/body-sequence.js

@@ -1,225 +0,0 @@
-import JSZip from "jszip";
-//#region src/compare/__fixtures__/body-sequence.ts
-/**
-* A document body written from a sequence of paragraphs and tables.
-*
-* The edit-script DSL can move words and rows but cannot append a table, so a
-* pair whose difference is "a paragraph AND a table were added after the last
-* one" has to be authored as two packages. Generating both from one description
-* keeps the difference visible in the diff instead of hidden in bytes.
-*/
-const NAMESPACE = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
-const RELATIONSHIPS = "http://schemas.openxmlformats.org/package/2006/relationships";
-const OFFICE_RELATIONSHIPS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
-const WORDPROCESSING = "application/vnd.openxmlformats-officedocument.wordprocessingml";
-const MARKUP_COMPATIBILITY = "http://schemas.openxmlformats.org/markup-compatibility/2006";
-const PACKAGE_RELATIONSHIPS = "http://schemas.openxmlformats.org/package/2006";
-const CORE_PROPERTIES_TYPE = "application/vnd.openxmlformats-package.core-properties+xml";
-const EXTENDED_PROPERTIES = "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties";
-const EXTENDED_PROPERTIES_TYPE = "application/vnd.openxmlformats-officedocument.extended-properties+xml";
-const WORDML_2010 = "http://schemas.microsoft.com/office/word/2010/wordml";
-/**
-* `createFolders: false` because JSZip stamps the folder entries it
-* synthesizes with `new Date()`, which the fixed date above does not reach.
-*/
-const ZIP_ENTRY_OPTIONS = {
-	date: new Date(Date.UTC(2e3, 0, 1)),
-	createFolders: false
-};
-const isRowOptions = (row) => "cells" in row;
-const isCellSpec = (cell) => typeof cell === "object" && "content" in cell;
-const rowCells = (row) => isRowOptions(row) ? row.cells : row;
-const rowOptions = (row) => isRowOptions(row) ? row : {};
-const cellContent = (cell) => isCellSpec(cell) ? cell.content : cell;
-const cellProperties = (cell) => isCellSpec(cell) ? cell : {};
-/**
-* A paragraph's id is derived from its own content, not from its position.
-*
-* Two packages authored from two descriptions are a base and a target, and a
-* paragraph that appears in both is the same paragraph. Numbering the ids in
-* document order would instead give the same id to the paragraph that happens
-* to sit at the same index, which is how the fixture would tell a comparison
-* that a removed paragraph was a rewrite of the one after it.
-*/
-const createParaIdAllocator = () => {
-	const taken = /* @__PURE__ */ new Set();
-	return (content) => {
-		let hash = 2166136261;
-		for (let index = 0; index < content.length; index += 1) hash = Math.imul(hash ^ content.charCodeAt(index), 16777619) >>> 0;
-		let candidate = hash % 2147483646;
-		while (taken.has((candidate + 1).toString(16).toUpperCase().padStart(8, "0"))) candidate = (candidate + 1) % 2147483646;
-		const paraId = (candidate + 1).toString(16).toUpperCase().padStart(8, "0");
-		taken.add(paraId);
-		return paraId;
-	};
-};
-const run = (text) => `<w:r><w:t xml:space="preserve">${text}</w:t></w:r>`;
-const inlineXml = (inline, { links }) => typeof inline === "string" ? run(inline) : `<w:hyperlink r:id="${links.get(inline.href) ?? ""}">${run(inline.text)}</w:hyperlink>`;
-/**
-* An empty paragraph is a `w:p` with no run at all, which is what a package
-* holds for a blank line or an empty cell. It is not the same thing as a
-* paragraph whose run carries an empty string, and both shapes occur.
-*/
-/** A blank line carries no run at all, so an empty string is no inline. */
-const nonEmptyInlines = (text) => text.length === 0 ? [] : [text];
-const paragraph = (text, context, { styleId, paraId } = {}) => {
-	const properties = styleId === void 0 ? "" : `<w:pPr><w:pStyle w:val="${styleId}"/></w:pPr>`;
-	const inlines = typeof text === "string" ? nonEmptyInlines(text) : text;
-	const content = inlines.map((inline) => typeof inline === "string" ? inline : inline.text).join("");
-	const id = paraId ?? context.paraId(`${styleId ?? ""}|${content}`);
-	return `<w:p w14:paraId="${id}" w14:textId="${id}">${properties}${inlines.map((inline) => inlineXml(inline, context)).join("")}</w:p>`;
-};
-/** Every href the body carries, in document order, so the ids are stable. */
-const collectHrefs = (items, hrefs) => {
-	for (const item of items) {
-		if (item.kind === "paragraph") {
-			if (typeof item.text === "string") continue;
-			for (const inline of item.text) if (typeof inline !== "string" && !hrefs.includes(inline.href)) hrefs.push(inline.href);
-			continue;
-		}
-		for (const row of item.rows) for (const cell of rowCells(row)) {
-			const content = cellContent(cell);
-			if (typeof content !== "string") collectHrefs(content, hrefs);
-		}
-	}
-};
-const EMPTY_PARAGRAPH = {
-	kind: "paragraph",
-	text: ""
-};
-/**
-* Most fixtures add a paragraph after a table so later paragraph insertions
-* have an explicit anchor. Tests for a schema-valid terminal table remove that
-* convenience paragraph deliberately.
-*/
-const closedSequence = (items) => {
-	const last = items.at(-1);
-	return last === void 0 || last.kind === "table" ? [...items, EMPTY_PARAGRAPH] : items;
-};
-/** A cell must also contain a paragraph, which the empty sequence supplies. */
-const cellXml = (content, context) => typeof content === "string" ? paragraph(content, context) : itemsXml(closedSequence(content), context);
-/** `w:tbl` is `w:tblPr, w:tblGrid, rows`: a fixture without the grid is not one. */
-const tableGrid = (item) => {
-	if (item.columnWidths) return `<w:tblGrid>${item.columnWidths.map((width) => `<w:gridCol w:w="${String(width)}"/>`).join("")}</w:tblGrid>`;
-	let columns = 0;
-	for (const row of item.rows) {
-		let spanned = 0;
-		for (const cell of rowCells(row)) spanned += cellProperties(cell).gridSpan ?? 1;
-		columns = Math.max(columns, spanned);
-	}
-	return `<w:tblGrid>${`<w:gridCol w:w="2000"/>`.repeat(columns)}</w:tblGrid>`;
-};
-const BORDER_SIDES = [
-	"top",
-	"left",
-	"bottom",
-	"right",
-	"insideH",
-	"insideV"
-];
-const CELL_BORDER_SIDES = [
-	"top",
-	"left",
-	"bottom",
-	"right"
-];
-const MARGIN_SIDES = [
-	"top",
-	"left",
-	"bottom",
-	"right"
-];
-const borders = (element, sides, size) => `<w:${element}>${sides.map((side) => `<w:${side} w:val="single" w:sz="${String(size)}" w:space="0" w:color="000000"/>`).join("")}</w:${element}>`;
-const margins = (element, value) => `<w:${element}>${MARGIN_SIDES.map((side) => `<w:${side} w:w="${String(value)}" w:type="dxa"/>`).join("")}</w:${element}>`;
-/**
-* `w:tblPr` children in the order CT_TblPrBase declares: tblStyle, bidiVisual,
-* tblW, jc, tblCellSpacing, tblInd, tblBorders, shd, tblLayout, tblCellMar,
-* tblLook. `w:tblW` is always written.
-*/
-const tableProperties = ({ properties }) => {
-	const width = properties?.width ?? {
-		value: 0,
-		type: "auto"
-	};
-	return `<w:tblPr>${[
-		...properties?.styleId === void 0 ? [] : [`<w:tblStyle w:val="${properties.styleId}"/>`],
-		...properties?.bidi === void 0 ? [] : [properties.bidi ? "<w:bidiVisual/>" : "<w:bidiVisual w:val=\"0\"/>"],
-		`<w:tblW w:w="${String(width.value)}" w:type="${width.type}"/>`,
-		...properties?.justification === void 0 ? [] : [`<w:jc w:val="${properties.justification}"/>`],
-		...properties?.cellSpacing === void 0 ? [] : [`<w:tblCellSpacing w:w="${String(properties.cellSpacing)}" w:type="dxa"/>`],
-		...properties?.indent === void 0 ? [] : [`<w:tblInd w:w="${String(properties.indent)}" w:type="dxa"/>`],
-		...properties?.borderSize === void 0 ? [] : [borders("tblBorders", BORDER_SIDES, properties.borderSize)],
-		...properties?.shadingFill === void 0 ? [] : [`<w:shd w:val="clear" w:color="auto" w:fill="${properties.shadingFill}"/>`],
-		...properties?.layout === void 0 ? [] : [`<w:tblLayout w:type="${properties.layout}"/>`],
-		...properties?.cellMargin === void 0 ? [] : [margins("tblCellMar", properties.cellMargin)],
-		...properties?.look === void 0 ? [] : [`<w:tblLook w:val="${properties.look}"/>`]
-	].join("")}</w:tblPr>`;
-};
-/**
-* `w:trPr` children. `CT_TrPrBase` is a repeated choice rather than a
-* sequence, so the order here is the readable one rather than a required one.
-*/
-const rowProperties = (row, hidden) => {
-	const { header, height, justification } = rowOptions(row);
-	const parts = [
-		...height === void 0 ? [] : [`<w:trHeight w:val="${String(height)}"/>`],
-		...header === true ? ["<w:tblHeader/>"] : [],
-		...justification === void 0 ? [] : [`<w:jc w:val="${justification}"/>`],
-		...hidden ? ["<w:hidden/>"] : []
-	];
-	return parts.length === 0 ? "" : `<w:trPr>${parts.join("")}</w:trPr>`;
-};
-/** `w:tcPr` children in schema order; `w:tcW` is always written. */
-const cellPropertiesXml = (cell) => {
-	const properties = cellProperties(cell);
-	return `<w:tcPr>${[
-		`<w:tcW w:w="${String(properties.width ?? 2e3)}" w:type="dxa"/>`,
-		...properties.gridSpan === void 0 ? [] : [`<w:gridSpan w:val="${String(properties.gridSpan)}"/>`],
-		...properties.verticalMerge === void 0 ? [] : [properties.verticalMerge === "restart" ? `<w:vMerge w:val="restart"/>` : `<w:vMerge/>`],
-		...properties.borderSize === void 0 ? [] : [borders("tcBorders", CELL_BORDER_SIDES, properties.borderSize)],
-		...properties.shadingFill === void 0 ? [] : [`<w:shd w:val="clear" w:color="auto" w:fill="${properties.shadingFill}"/>`],
-		...properties.margin === void 0 ? [] : [margins("tcMar", properties.margin)],
-		...properties.verticalAlign === void 0 ? [] : [`<w:vAlign w:val="${properties.verticalAlign}"/>`]
-	].join("")}</w:tcPr>`;
-};
-const table = (item, context) => {
-	const hidden = new Set(item.hiddenRows ?? []);
-	return `<w:tbl>${tableProperties(item)}` + tableGrid(item) + item.rows.map((row, rowIndex) => `<w:tr>${rowProperties(row, hidden.has(rowIndex))}${rowCells(row).map((cell) => `<w:tc>${cellPropertiesXml(cell)}${cellXml(cellContent(cell), context)}</w:tc>`).join("")}</w:tr>`).join("") + `</w:tbl>`;
-};
-const itemsXml = (items, context) => items.map((item) => item.kind === "paragraph" ? paragraph(item.text, context, {
-	...item.styleId === void 0 ? {} : { styleId: item.styleId },
-	...item.paraId === void 0 ? {} : { paraId: item.paraId }
-}) : table(item, context)).join("");
-const bodyXml = (items, context) => itemsXml(closedSequence(items), context);
-/** The relationship id the default header takes when a fixture asks for one. */
-const HEADER_RELATIONSHIP_ID = "rId2";
-const buildBodySequenceDocx = async (items, { header } = {}) => {
-	const hrefs = [];
-	collectHrefs(closedSequence(items), hrefs);
-	collectHrefs(closedSequence(header ?? []), hrefs);
-	const firstLinkRelationship = header ? 3 : 2;
-	const links = new Map(hrefs.map((href, index) => [href, `rId${index + firstLinkRelationship}`]));
-	const linkRelationships = hrefs.map((href, index) => `<Relationship Id="rId${index + firstLinkRelationship}" Type="${OFFICE_RELATIONSHIPS}/hyperlink" Target="${href}" TargetMode="External"/>`).join("");
-	const paraId = createParaIdAllocator();
-	const parts = {
-		"[Content_Types].xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/word/document.xml" ContentType="${WORDPROCESSING}.document.main+xml"/><Override PartName="/word/styles.xml" ContentType="${WORDPROCESSING}.styles+xml"/>` + (header ? `<Override PartName="/word/header1.xml" ContentType="${WORDPROCESSING}.header+xml"/>` : "") + `<Override PartName="/docProps/core.xml" ContentType="${CORE_PROPERTIES_TYPE}"/><Override PartName="/docProps/app.xml" ContentType="${EXTENDED_PROPERTIES_TYPE}"/></Types>`,
-		"_rels/.rels": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="${RELATIONSHIPS}"><Relationship Id="rId1" Type="${OFFICE_RELATIONSHIPS}/officeDocument" Target="word/document.xml"/><Relationship Id="rId2" Type="${PACKAGE_RELATIONSHIPS}/metadata/core-properties" Target="docProps/core.xml"/><Relationship Id="rId3" Type="${OFFICE_RELATIONSHIPS}/extended-properties" Target="docProps/app.xml"/></Relationships>`,
-		"docProps/core.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><cp:coreProperties xmlns:cp="${PACKAGE_RELATIONSHIPS}/metadata/core-properties" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><dcterms:created xsi:type="dcterms:W3CDTF">2000-01-01T00:00:00Z</dcterms:created><dcterms:modified xsi:type="dcterms:W3CDTF">2000-01-01T00:00:00Z</dcterms:modified></cp:coreProperties>`,
-		"docProps/app.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Properties xmlns="${EXTENDED_PROPERTIES}"><AppVersion>1.0.0</AppVersion></Properties>`,
-		"word/_rels/document.xml.rels": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="${RELATIONSHIPS}"><Relationship Id="rId1" Type="${OFFICE_RELATIONSHIPS}/styles" Target="styles.xml"/>` + (header ? `<Relationship Id="${HEADER_RELATIONSHIP_ID}" Type="${OFFICE_RELATIONSHIPS}/header" Target="header1.xml"/>` : "") + linkRelationships + `</Relationships>`,
-		"word/styles.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:styles xmlns:w="${NAMESPACE}"><w:style w:type="paragraph" w:default="1" w:styleId="Normal"><w:name w:val="Normal"/></w:style><w:style w:type="paragraph" w:styleId="Heading1"><w:name w:val="heading 1"/></w:style></w:styles>`,
-		"word/document.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:document xmlns:w="${NAMESPACE}" xmlns:r="${OFFICE_RELATIONSHIPS}" xmlns:mc="${MARKUP_COMPATIBILITY}" xmlns:w14="${WORDML_2010}" mc:Ignorable="w14"><w:body>` + bodyXml(items, {
-			links,
-			paraId
-		}) + `<w:sectPr>` + (header ? `<w:headerReference w:type="default" r:id="${HEADER_RELATIONSHIP_ID}"/>` : "") + "<w:pgSz w:w=\"12240\" w:h=\"15840\"/><w:pgMar w:top=\"1440\" w:right=\"1440\" w:bottom=\"1440\" w:left=\"1440\"/></w:sectPr></w:body></w:document>",
-		...header ? { "word/header1.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:hdr xmlns:w="${NAMESPACE}" xmlns:r="${OFFICE_RELATIONSHIPS}" xmlns:mc="${MARKUP_COMPATIBILITY}" xmlns:w14="${WORDML_2010}" mc:Ignorable="w14">${itemsXml(closedSequence(header), {
-			links,
-			paraId
-		})}</w:hdr>` } : {}
-	};
-	const zip = new JSZip();
-	for (const name of Object.keys(parts).toSorted()) zip.file(name, parts[name] ?? "", ZIP_ENTRY_OPTIONS);
-	return await zip.generateAsync({ type: "arraybuffer" });
-};
-//#endregion
-export { buildBodySequenceDocx };

package/dist/compare/__fixtures__/nested-table.d.ts

@@ -1,16 +0,0 @@
-//#region src/compare/__fixtures__/nested-table.d.ts
-/**
- * A document that ends with a table whose last cell holds another table.
- *
- * The shape matters because the story's last block is then two levels deep,
- * and a paragraph appended after the whole table has no block to anchor to
- * that is not inside a cell. Authored here rather than committed as bytes so
- * the structure under test is legible in the diff.
- */
-type NestedTableDocxOptions = {
-  /** Appended after the outer table, at body level, when set. */
-  trailingParagraph?: string;
-};
-declare const buildNestedTableDocx: ({ trailingParagraph }?: NestedTableDocxOptions) => Promise<ArrayBuffer>;
-//#endregion
-export { NestedTableDocxOptions, buildNestedTableDocx };