@stll/folio-core 0.46.0 → 0.47.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.46.0",
+  "version": "0.47.1",
   "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.24.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 };

package/dist/compare/__fixtures__/nested-table.js

@@ -1,50 +0,0 @@
-import JSZip from "jszip";
-//#region src/compare/__fixtures__/nested-table.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.
-*/
-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";
-/**
-* `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 paragraph = (text) => text.length === 0 ? `<w:p/>` : `<w:p><w:r><w:t xml:space="preserve">${text}</w:t></w:r></w:p>`;
-/**
-* A table may not be the last child of a body or a cell, so every container
-* that ends with one is closed by a paragraph. Word writes that paragraph and
-* usually leaves it empty; a fixture that omits it is malformed, and the
-* comparison should be exercised against the shape real packages have.
-*/
-const closingParagraph = paragraph("");
-const cell = (inner) => `<w:tc><w:tcPr><w:tcW w:w="4680" w:type="dxa"/></w:tcPr>${inner}</w:tc>`;
-const table = (rows) => `<w:tbl><w:tblPr><w:tblW w:w="0" w:type="auto"/></w:tblPr><w:tblGrid><w:gridCol w:w="4680"/><w:gridCol w:w="4680"/></w:tblGrid>${rows.join("")}</w:tbl>`;
-/** The nested table sits in the outer table's last cell, deep in the story. */
-const NESTED_TABLE = table([`<w:tr>${cell(`${paragraph("The nested schedule lists the delivery dates.")}${closingParagraph}`)}</w:tr>`]);
-const OUTER_TABLE = table([`<w:tr>${cell(paragraph("Obligations of the supplier."))}${cell(paragraph("Obligations of the buyer."))}</w:tr>`, `<w:tr>${cell(paragraph("Deliver the goods to the named place."))}${cell(`${paragraph("See the schedule below.")}${NESTED_TABLE}${closingParagraph}`)}</w:tr>`]);
-const buildNestedTableDocx = async ({ trailingParagraph } = {}) => {
-	const body = paragraph("This agreement is made between the parties named below.") + OUTER_TABLE + (trailingParagraph === void 0 ? closingParagraph : `${paragraph(trailingParagraph)}${closingParagraph}`);
-	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:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440"/></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 { buildNestedTableDocx };

package/dist/compare/__fixtures__/numbered-list.d.ts

@@ -1,34 +0,0 @@
-//#region src/compare/__fixtures__/numbered-list.d.ts
-/**
- * A small multi-level numbered list, authored here rather than committed as
- * bytes.
- *
- * The corpus fixtures carry no numbering at all, so a probe that says "an added
- * list item" while editing an unnumbered paragraph is testing something else
- * and saying it is testing numbering. Generating the package keeps its content
- * legible in the diff and keeps the provenance trivial.
- */
-/**
- * One item: its indent level and its text. `null` is a paragraph that keeps
- * the list style and carries no numbering.
- */
-type NumberedListItem = {
-  level: number | null;
-  text: string;
-};
-declare const NUMBERED_LIST_ITEMS: readonly NumberedListItem[];
-/** The same list with one item demoted one level: a level change and no text change. */
-declare const withItemDemoted: (items: readonly NumberedListItem[], index: number) => NumberedListItem[];
-/**
- * The same list with one item no longer numbered: the paragraph keeps every
- * word and stops being a list item, which is the edit a level change cannot
- * express.
- */
-declare const withItemUnnumbered: (items: readonly NumberedListItem[], index: number) => NumberedListItem[];
-type NumberedListDocxOptions = {
-  /** `w:numFmt` for the top level. Default `"decimal"`. */
-  format?: string;
-};
-declare const buildNumberedListDocx: (items?: readonly NumberedListItem[], { format }?: NumberedListDocxOptions) => Promise<ArrayBuffer>;
-//#endregion
-export { NUMBERED_LIST_ITEMS, NumberedListDocxOptions, NumberedListItem, buildNumberedListDocx, withItemDemoted, withItemUnnumbered };

package/dist/compare/__fixtures__/numbered-list.js

@@ -1,85 +0,0 @@
-import JSZip from "jszip";
-//#region src/compare/__fixtures__/numbered-list.ts
-/**
-* A small multi-level numbered list, authored here rather than committed as
-* bytes.
-*
-* The corpus fixtures carry no numbering at all, so a probe that says "an added
-* list item" while editing an unnumbered paragraph is testing something else
-* and saying it is testing numbering. Generating the package keeps its content
-* legible in the diff and keeps the provenance trivial.
-*/
-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";
-/**
-* `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 LIST_LEVELS = 3;
-const abstractLevels = (topLevelFormat) => Array.from({ length: LIST_LEVELS }, (_unused, level) => {
-	return `<w:lvl w:ilvl="${String(level)}"><w:start w:val="1"/><w:numFmt w:val="${level === 0 ? topLevelFormat : "lowerLetter"}"/><w:lvlText w:val="%${String(level + 1)}."/><w:lvlJc w:val="left"/></w:lvl>`;
-}).join("");
-const listParagraph = (level, text) => {
-	return `<w:p><w:pPr><w:pStyle w:val="ListParagraph"/>${level === null ? "" : `<w:numPr><w:ilvl w:val="${String(level)}"/><w:numId w:val="1"/></w:numPr>`}</w:pPr><w:r><w:t xml:space="preserve">${text}</w:t></w:r></w:p>`;
-};
-const NUMBERED_LIST_ITEMS = Object.freeze([
-	{
-		level: 0,
-		text: "The supplier shall deliver the goods to the named place."
-	},
-	{
-		level: 1,
-		text: "Delivery is complete on unloading at that place."
-	},
-	{
-		level: 1,
-		text: "Risk passes to the buyer on completion of delivery."
-	},
-	{
-		level: 0,
-		text: "The buyer shall pay within thirty days of the invoice date."
-	},
-	{
-		level: 1,
-		text: "Late payment carries interest at the statutory rate."
-	},
-	{
-		level: 0,
-		text: "Either party may terminate for material breach."
-	}
-]);
-/** The same list with one item demoted one level: a level change and no text change. */
-const withItemDemoted = (items, index) => items.map((item, at) => at === index ? {
-	level: Math.min(LIST_LEVELS - 1, (item.level ?? 0) + 1),
-	text: item.text
-} : item);
-/**
-* The same list with one item no longer numbered: the paragraph keeps every
-* word and stops being a list item, which is the edit a level change cannot
-* express.
-*/
-const withItemUnnumbered = (items, index) => items.map((item, at) => at === index ? {
-	level: null,
-	text: item.text
-} : item);
-const buildNumberedListDocx = async (items = NUMBERED_LIST_ITEMS, { format = "decimal" } = {}) => {
-	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"/><Override PartName="/word/numbering.xml" ContentType="${WORDPROCESSING}.numbering+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"/><Relationship Id="rId2" Type="${OFFICE_RELATIONSHIPS}/numbering" Target="numbering.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:style w:type="paragraph" w:styleId="ListParagraph"><w:name w:val="List Paragraph"/></w:style></w:styles>`,
-		"word/numbering.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:numbering xmlns:w="${NAMESPACE}"><w:abstractNum w:abstractNumId="0">${abstractLevels(format)}</w:abstractNum><w:num w:numId="1"><w:abstractNumId w:val="0"/></w:num></w:numbering>`,
-		"word/document.xml": `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:document xmlns:w="${NAMESPACE}"><w:body>` + items.map(({ level, text }) => listParagraph(level, text)).join("") + "<w:sectPr><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>"
-	};
-	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 { NUMBERED_LIST_ITEMS, buildNumberedListDocx, withItemDemoted, withItemUnnumbered };