js.documents 1.68.0 → 1.70.1

package/README.md

@@ -599,10 +599,10 @@ To run a single test file: `pnpm vitest run src/path/to/file.test.ts`.
 - **Headless LibreOffice command-line macro dispatch (`soffice {file} {macro:///Library.Module.Name}`) needed two real, non-obvious environment fixes to run at all in this sandbox, beyond the ones already documented for HSQLDB/odm fixture generation.** (1) A prior session's forcefully-killed `soffice` process leaves macOS's own native "reopen windows after a crash" alert showing on every subsequent launch — invisible in headless/`--invisible` mode (no window to click), so `soffice` hangs indefinitely in `-[NSAlert runModal]` waiting for a response that can never arrive; `defaults write org.libreoffice.script ApplePersistenceIgnoreState -bool true` (plus removing `~/Library/Saved Application State/org.libreoffice.script.savedState`) disables it. (2) `soffice "macro:///Library.Module.Name"` with no document argument silently does nothing at all — per `soffice --help`'s own usage text, the `{file}` argument is not optional (`{file} {macro:///Library.Module.MacroName}`); a session invoking a macro with no real work to do on a document still needs a real (even trivial) file argument for the macro to actually dispatch.
 - **A Firebird gbak backup stream's own wire format mixes two genuinely different byte-level encodings, confirmed only by testing against real bytes, not solely from reading the engine's source.** Every `rec_*`/`att_*` tag-and-attribute structure is little-endian ("VAX order", `isc_vax_integer`), one length-prefix byte per value; a row's own field-value sequence (once any RLE compression is peeled off) is standard RFC 1832 XDR — big-endian, every value (even a nominally 16-bit `SSHORT`) widened to a 4-byte-aligned unit, opaque byte runs zero-padded to the next 4-byte boundary. A genuine 64-bit-integer word-order bug (high 32 bits transmitted first, not low-first as `xdr_hyper`'s own in-memory `temp_long` array layout suggests on first reading) was caught exactly this way: a `DECIMAL(10,2)` column decoded to a nonsense value on the first real-fixture test run, not from a source-reading mistake that was obvious in advance.
 - **STIX Two Math is embedded as a whole, unmodified `CFF ` table rather than glyph-subsetted — pdf-codec's own font-embedding scope decision, not this package's.** See pdf-codec's own README for the full CFF-embedding scope statement.
-- **A stretchy fence in an `mrow` now genuinely stretches to its content, via the font's own `MathVariants` data — but only on the VERTICAL axis, and only for an `mo` the operator dictionary calls stretchy.** `layoutRowChildren` (`src/mathml/layout.ts`) targets twice the larger of the row's own non-stretchy children's half-extents about the maths axis (MathML's default `symmetric` behaviour for a fence), asks the `MathFontMetrics.stretch` port for a construction reaching it, and emits a `MathAssembledGlyphs` item: one or more glyph IDs at explicitly computed positions, rather than the Unicode text a `MathGlyphRun` carries. It has to be glyph IDs — every pre-built larger variant in this font is unencoded, as are the radical's and the over-brace's assembly pieces, with only the bracket family's own pieces given code points (the U+239B–U+23AD block). What genuinely stretches today: parentheses, square brackets, curly braces, floor/ceiling, angle brackets, and the vertical-bar/norm pair, each drawn either from a larger pre-built variant or from a real multi-part assembly sized to the content. What does not, and why:
+- **A stretchy fence in an `mrow` genuinely stretches to its content on the VERTICAL axis, via the font's own `MathVariants` data, for any `mo` the operator dictionary calls stretchy — matched now by a genuine HORIZONTAL stretch for an over/under-brace spanning its own base in `munder`/`mover`/`munderover` (see the next bullet).** `layoutRowChildren` (`src/mathml/layout.ts`) targets twice the larger of the row's own non-stretchy children's half-extents about the maths axis (MathML's default `symmetric` behaviour for a fence), asks the `MathFontMetrics.stretch` port for a construction reaching it, and emits a `MathAssembledGlyphs` item: one or more glyph IDs at explicitly computed positions, rather than the Unicode text a `MathGlyphRun` carries. It has to be glyph IDs — every pre-built larger variant in this font is unencoded, as are the radical's and the over-brace's assembly pieces, with only the bracket family's own pieces given code points (the U+239B–U+23AD block). What genuinely stretches today: parentheses, square brackets, curly braces, floor/ceiling, angle brackets, and the vertical-bar/norm pair, each drawn either from a larger pre-built variant or from a real multi-part assembly sized to the content. What does not, and why:
   - **`msqrt`/`mroot` radical signs** keep the hand-drawn hooked sign + vinculum `src/mathml/radical.ts` builds. This is not a `MathVariants` gap — the font's own radical construction stretches perfectly well, and a bare stretchy `<mo>√</mo>` in an `mrow` does now use it — but a radical *construct* needs a vinculum spanning its radicand's width, which no vertical glyph construction supplies, so switching it over means replacing the whole hand-built sign, not just its stem.
-  - **Horizontal stretching** (an over/under-brace, `U+23DE`/`U+23DF`, spanning its base in `munder`/`mover`) is not wired up. Everything below the layout engine already handles it — the port takes an `axis`, pdf-codec measures a horizontal construction correctly, and the item kind is axis-agnostic — but `layoutUnderOver` would need to derive its target from a box's *width* rather than from a row's height, and nothing in this module calls `stretch` with `'horizontal'` today.
   - **A multi-character `mo`** (`"||"`, an operator with combining marks) is never stretched: the font's `MathVariants` data is keyed per glyph, so there is no single construction to look up.
+- **An over/under-brace (`U+23DE`/`U+23DF`) spanning its own `munder`/`mover`/`munderover` base now genuinely stretches horizontally, via the identical `MathFontMetrics.stretch` port used for a vertical fence, just called with `axis: 'horizontal'` and a width target instead of a height one.** `layoutUnderOverChild` (`src/mathml/layout.ts`) is the call site: for each over/under script that `isStretchyOperator` accepts, it asks `stretchHorizontalOperator` to stretch to the base's own `widthPt`, computed independently for the over and under script (no shared or synchronised target — real `\overbrace{content}^{label}` semantics needs none), and falls back to the ordinary glyph run wherever the font declines (no horizontal `MathVariants` construction for that glyph, or the base is already wide enough that the construction's own base form already reaches it). `horizontallyStretchedBox` is `stretchedBox`'s horizontal-axis sibling, not a shared axis-branching function: its box width is the construction's own achieved `sizePt` (never `advanceWidthPt`, which for a horizontal assembly is only the widest individual glyph's own natural advance, far short of the whole span), and its ascent/descent come directly and unclamped from the construction's own real ink — one of the two is genuinely negative for both the over-brace and the under-brace, since each glyph's ink sits almost entirely on one side of its own drawing origin, and `layoutUnderOver` already stacks over/under content against the base's own edges using exactly that ascent/descent, with no further change needed on its part.
 - **A stretched fence's own glyphs have no ToUnicode mapping, so pdf-codec wraps them in an `/ActualText` span carrying the operator's real text.** Text extraction, search, and copy/paste still recover `(` from a six-piece assembled bracket. A fence the base glyph already covers is left as an ordinary `MathGlyphRun` rather than converted to glyph IDs, so a plain inline `(x + 1)` renders and extracts exactly as it did before any of this existed.
 - **The operator dictionary calls `∑`/`∏`/`⋃` and the rest of the big-operator family NOT stretchy, matching MathML3's own dictionary.** This became load-bearing once a stretchy operator genuinely stretches: STIX Two Math *does* declare vertical `MathVariants` for a summation sign, so a wrong `stretchy: true` there would visibly deform a `∑` standing next to a tall fraction. A big operator grows by selecting a larger designed size in display style — the `largeop` mechanism — never by stretching to its row.
 - **A token element's (`mi`/`mn`/`mo`/`mtext`) own box height is the union of its characters' real per-glyph ink bounds, falling back to the font's nominal design ascent/descent only for a glyph that carries none.** `src/mathml/` still parses no glyph outlines itself — the bounds arrive through `MathFontMetrics.glyph`'s own `inkAscentPt`/`inkDescentPt`, which pdf-codec computes by walking the embedded font's Type 2 charstrings (see its README's own `cff-bounds.ts` note). The fallback is not dead code: a glyph that draws nothing (a space) or whose charstring that reader declines to walk reports neither bound, and takes the font-wide nominal extent instead, which is also what a `MathFontMetrics` implementation with no outline parsing at all would supply for every glyph.
@@ -643,7 +643,7 @@ To run a single test file: `pnpm vitest run src/path/to/file.test.ts`.
 
 **docx/pptx/odt/odp/ods/odg → PDF** is a genuine layout render: the docx/odt flow/pagination engine and the pptx/odp direct-placement engine both produce real positioned text, images, tables, and (for docx/odt) numbered/bulleted lists, styled through the full cascade (theme fonts/colours, `basedOn` chains, placeholder inheritance for docx/pptx; `style:default-style`/`style:parent-style-name` chains for odt/odp). `odg` renders its vector primitives (rect/ellipse/line/path, the last emitted as real PDF `m`/`l`/`c`/`h` content-stream operators, not a polygon approximation of any curve) and reuses the pptx/odp direct-placement engine's own shape conversion for whatever text it also carries. It is a faithful **visual approximation**, not a pixel- or line-identical reproduction of what Word/PowerPoint/Writer/Impress/Draw would themselves render — how close depends on which typeface the document asks for and whether it embedded one, see the font-resolution gotcha above.
 
-**odf → PDF (`odfToPdf`), and a formula embedded inside odt/odp/ods,** render **faithful mathematical typesetting**, not a static image or a plain-text placeholder: real box-model layout (script/limit positioning, fraction/radical geometry with correct rule thickness, table column alignment, `mathvariant` → Mathematical Alphanumeric Symbols mapping) through the embedded STIX Two Math font, with genuine per-glyph metrics (advance width, italic correction, top-accent attachment) and font-wide layout constants (axis height, fraction/radical rule thickness and gaps, script shift amounts) parsed directly from that font's own `MATH` table — not approximated or hand-tuned. A vertical fence around a tall construct genuinely stretches too, assembled from the font's own `MathVariants` pieces and sized to what it wraps, rather than drawn at a fixed base size. The honest limits: only vertical stretching is wired up, so an over/under-brace still renders at its base width, and `msqrt`/`mroot` still draw a hand-built radical sign rather than the font's own stretched one (both for structural reasons, not because the font data is unavailable — see the Gotchas entries above); `mover`/`munder` centre geometrically rather than at the font's own declared accent-attachment point; and the operator dictionary and Greek `mathvariant` mapping each cover a deliberately bounded, common-case set rather than the full specification. For a formula anchored to a spreadsheet **cell**, position is genuinely resolved against that sheet's real column/row geometry (verified end to end against a real LibreOffice-authored `.ods`), but the rendered **size** comes from the same frame-height heuristic every engine uses, which over-estimates for a stacked formula — see the Gotchas entry on `formulaSizePtFromFrame`. **`pdfToOdf` (PDF → structured MathML) is not attempted, on either direction** — recovering a semantic operator tree (is this pair of glyphs a fraction, or a coincidentally stacked pair of ordinary characters? is a raised glyph a superscript, or just a smaller font size used for emphasis?) from nothing but positioned glyphs and paths is a categorically different, OCR-adjacent problem, with no geometry-reconstruction analogue anywhere else in this package: `reconstructWordprocessing`/`reconstructPresentation` recover paragraph/shape *structure* from geometry, never semantic *meaning* the way recognising a fraction would require.
+**odf → PDF (`odfToPdf`), and a formula embedded inside odt/odp/ods,** render **faithful mathematical typesetting**, not a static image or a plain-text placeholder: real box-model layout (script/limit positioning, fraction/radical geometry with correct rule thickness, table column alignment, `mathvariant` → Mathematical Alphanumeric Symbols mapping) through the embedded STIX Two Math font, with genuine per-glyph metrics (advance width, italic correction, top-accent attachment) and font-wide layout constants (axis height, fraction/radical rule thickness and gaps, script shift amounts) parsed directly from that font's own `MATH` table — not approximated or hand-tuned. A vertical fence around a tall construct genuinely stretches too, assembled from the font's own `MathVariants` pieces and sized to what it wraps, rather than drawn at a fixed base size — and an over/under-brace spanning its own `munder`/`mover`/`munderover` base stretches horizontally on the identical basis, sized to that base's own width. The honest limits: `msqrt`/`mroot` still draw a hand-built radical sign rather than the font's own stretched one (a structural reason, not because the font data is unavailable — see the Gotchas entries above); `mover`/`munder` centre geometrically rather than at the font's own declared accent-attachment point; and the operator dictionary and Greek `mathvariant` mapping each cover a deliberately bounded, common-case set rather than the full specification. For a formula anchored to a spreadsheet **cell**, position is genuinely resolved against that sheet's real column/row geometry (verified end to end against a real LibreOffice-authored `.ods`), but the rendered **size** comes from the same frame-height heuristic every engine uses, which over-estimates for a stacked formula — see the Gotchas entry on `formulaSizePtFromFrame`. **`pdfToOdf` (PDF → structured MathML) is not attempted, on either direction** — recovering a semantic operator tree (is this pair of glyphs a fraction, or a coincidentally stacked pair of ordinary characters? is a raised glyph a superscript, or just a smaller font size used for emphasis?) from nothing but positioned glyphs and paths is a categorically different, OCR-adjacent problem, with no geometry-reconstruction analogue anywhere else in this package: `reconstructWordprocessing`/`reconstructPresentation` recover paragraph/shape *structure* from geometry, never semantic *meaning* the way recognising a fraction would require.
 
 **PDF → docx/pptx/odt/odp** is necessarily a **best-effort reconstruction** from geometry: a PDF page is just positioned glyphs and images, with no semantic paragraph or shape structure to recover. Reading order, bold/italic/colour/font-size, and page/slide count are preserved; paragraph and text-block boundaries are inferred from baseline spacing and left-margin indentation, not recovered exactly. Two further kinds of content are recovered on top of that text, each on its own explicit terms: a real `ContentTable`, but **only** where a genuine drawn gridline lattice is detected, never from text alignment (which would be inventing structure, not recovering it); and a page's vector primitives, into a nested drawing document that currently reaches the `ContentDocument` pivot but not the output bytes. Both are covered in full by their own [Gotchas](#gotchas-and-quirks) entries.
 

package/dist/edit/docx/content.cjs

@@ -1,5 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_metadata = require("../../model/metadata.cjs");
+const require_ports_clock = require("../../ports/clock.cjs");
 const require_model_units = require("../../model/units.cjs");
+const require_edit_docx_scaffold = require("./scaffold.cjs");
 const require_edit_docx_editor = require("./editor.cjs");
 const require_model_embedded_drawing = require("../../model/embedded-drawing.cjs");
 const require_model_formula = require("../../model/formula.cjs");
@@ -7,7 +10,9 @@ let ooxml_js = require("ooxml.js");
 //#region src/edit/docx/content.ts
 function buildDocxPackage(content, options) {
 	if (content.kind !== "wordprocessing") throw new Error("buildDocxPackage requires a wordprocessing ContentDocument");
-	const editor = require_edit_docx_editor.createDocx();
+	const clock = options?.clock ?? require_ports_clock.systemClock;
+	const metadata = require_model_metadata.resolveMetadataTimestamps(content.metadata, clock);
+	const editor = new require_edit_docx_editor.DocxEditor(require_edit_docx_scaffold.createEmptyDocxPackage({ metadata }));
 	content.sections.forEach((section, sectionIndex) => {
 		if (sectionIndex > 0) editor.body.appendPageBreak();
 		appendBlocks(editor.body, section.blocks, options);

package/dist/edit/docx/content.d.cts

@@ -1,4 +1,5 @@
 import { t as OmmlDiagnostic } from "../../shared-DLZ3IQUl.cjs";
+import { ClockPort } from "../../ports/clock.cjs";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "ooxml.js";
 //#region src/edit/docx/content.d.ts
@@ -6,6 +7,7 @@ interface BuildDocxPackageOptions {
   readonly onMathDiagnostic?: (diagnostic: OmmlDiagnostic, context: {
     readonly sourcePath?: string;
   }) => void;
+  readonly clock?: ClockPort;
 }
 declare function buildDocxPackage(content: ContentDocument, options?: BuildDocxPackageOptions): Package;
 //#endregion

package/dist/edit/docx/content.d.ts

@@ -1,4 +1,5 @@
 import { t as OmmlDiagnostic } from "../../shared-DUOzjwcL.js";
+import { ClockPort } from "../../ports/clock.js";
 import { Package } from "ooxml.js";
 import { ContentDocument } from "document-schema.js";
 //#region src/edit/docx/content.d.ts
@@ -6,6 +7,7 @@ interface BuildDocxPackageOptions {
   readonly onMathDiagnostic?: (diagnostic: OmmlDiagnostic, context: {
     readonly sourcePath?: string;
   }) => void;
+  readonly clock?: ClockPort;
 }
 declare function buildDocxPackage(content: ContentDocument, options?: BuildDocxPackageOptions): Package;
 //#endregion

package/dist/edit/docx/content.js

@@ -1,12 +1,17 @@
+import { resolveMetadataTimestamps } from "../../model/metadata.js";
+import { systemClock } from "../../ports/clock.js";
 import { ptToTwips } from "../../model/units.js";
-import { createDocx } from "./editor.js";
+import { createEmptyDocxPackage } from "./scaffold.js";
+import { DocxEditor } from "./editor.js";
 import { FLOW_CONTAINER_ORIGIN, drawingOfBlock, embeddedDrawingVectors } from "../../model/embedded-drawing.js";
 import { formulaOfBlock, formulaPlaceholderText } from "../../model/formula.js";
 import { base64ToBytes } from "ooxml.js";
 //#region src/edit/docx/content.ts
 function buildDocxPackage(content, options) {
 	if (content.kind !== "wordprocessing") throw new Error("buildDocxPackage requires a wordprocessing ContentDocument");
-	const editor = createDocx();
+	const clock = options?.clock ?? systemClock;
+	const metadata = resolveMetadataTimestamps(content.metadata, clock);
+	const editor = new DocxEditor(createEmptyDocxPackage({ metadata }));
 	content.sections.forEach((section, sectionIndex) => {
 		if (sectionIndex > 0) editor.body.appendPageBreak();
 		appendBlocks(editor.body, section.blocks, options);

package/dist/edit/docx/editor.cjs

@@ -1,4 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_metadata = require("../../model/metadata.cjs");
+const require_ports_clock = require("../../ports/clock.cjs");
 const require_xml_fragment = require("../../xml/fragment.cjs");
 const require_edit_docx_paragraph = require("./paragraph.cjs");
 const require_edit_docx_scaffold = require("./scaffold.cjs");
@@ -107,8 +109,10 @@ var DocxEditor = class {
 function openDocx(bytes) {
 	return new DocxEditor((0, ooxml_js.decodePackage)(bytes));
 }
-function createDocx() {
-	return new DocxEditor(require_edit_docx_scaffold.createEmptyDocxPackage());
+function createDocx(options) {
+	const clock = options?.clock ?? require_ports_clock.systemClock;
+	const metadata = require_model_metadata.resolveMetadataTimestamps({}, clock);
+	return new DocxEditor(require_edit_docx_scaffold.createEmptyDocxPackage({ metadata }));
 }
 //#endregion
 exports.DocxEditor = DocxEditor;

package/dist/edit/docx/editor.d.cts

@@ -1,3 +1,4 @@
+import { ClockPort } from "../../ports/clock.cjs";
 import { DocxParagraph, ParagraphInit } from "./paragraph.cjs";
 import { DocxTable, TableInit } from "./table.cjs";
 import { Package } from "ooxml.js";
@@ -18,6 +19,9 @@ declare class DocxEditor {
   toBytes(): Uint8Array<ArrayBuffer>;
 }
 declare function openDocx(bytes: Uint8Array<ArrayBuffer>): DocxEditor;
-declare function createDocx(): DocxEditor;
+interface CreateDocxOptions {
+  readonly clock?: ClockPort;
+}
+declare function createDocx(options?: CreateDocxOptions): DocxEditor;
 //#endregion
-export { DocxBody, DocxEditor, createDocx, openDocx };
+export { CreateDocxOptions, DocxBody, DocxEditor, createDocx, openDocx };

package/dist/edit/docx/editor.d.ts

@@ -1,3 +1,4 @@
+import { ClockPort } from "../../ports/clock.js";
 import { DocxParagraph, ParagraphInit } from "./paragraph.js";
 import { DocxTable, TableInit } from "./table.js";
 import { Package } from "ooxml.js";
@@ -18,6 +19,9 @@ declare class DocxEditor {
   toBytes(): Uint8Array<ArrayBuffer>;
 }
 declare function openDocx(bytes: Uint8Array<ArrayBuffer>): DocxEditor;
-declare function createDocx(): DocxEditor;
+interface CreateDocxOptions {
+  readonly clock?: ClockPort;
+}
+declare function createDocx(options?: CreateDocxOptions): DocxEditor;
 //#endregion
-export { DocxBody, DocxEditor, createDocx, openDocx };
+export { CreateDocxOptions, DocxBody, DocxEditor, createDocx, openDocx };

package/dist/edit/docx/editor.js

@@ -1,3 +1,5 @@
+import { resolveMetadataTimestamps } from "../../model/metadata.js";
+import { systemClock } from "../../ports/clock.js";
 import { el } from "../../xml/fragment.js";
 import { DocxParagraph, buildParagraph } from "./paragraph.js";
 import { createEmptyDocxPackage } from "./scaffold.js";
@@ -106,8 +108,10 @@ var DocxEditor = class {
 function openDocx(bytes) {
 	return new DocxEditor(decodePackage(bytes));
 }
-function createDocx() {
-	return new DocxEditor(createEmptyDocxPackage());
+function createDocx(options) {
+	const clock = options?.clock ?? systemClock;
+	const metadata = resolveMetadataTimestamps({}, clock);
+	return new DocxEditor(createEmptyDocxPackage({ metadata }));
 }
 //#endregion
 export { DocxEditor, createDocx, openDocx };

package/dist/edit/docx/scaffold.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_opc_core_properties = require("../../opc/core-properties.cjs");
 //#region src/edit/docx/scaffold.ts
 const CONTENT_TYPES_NS = "http://schemas.openxmlformats.org/package/2006/content-types";
 const RELS_NS = "http://schemas.openxmlformats.org/package/2006/relationships";
@@ -23,7 +24,7 @@ function declaration() {
 		]
 	};
 }
-function createEmptyDocxPackage() {
+function createEmptyDocxPackage(options) {
 	const contentTypes = require_xml_fragment.el("Types", { xmlns: CONTENT_TYPES_NS }, [
 		require_xml_fragment.el("Default", {
 			Extension: "rels",
@@ -70,7 +71,7 @@ function createEmptyDocxPackage() {
 		"w:default": "1",
 		"w:styleId": "Normal"
 	}, [require_xml_fragment.el("w:name", { "w:val": "Normal" })])]);
-	return { parts: {
+	const pkg = { parts: {
 		"[Content_Types].xml": {
 			kind: "xml",
 			nodes: [declaration(), contentTypes]
@@ -92,6 +93,8 @@ function createEmptyDocxPackage() {
 			nodes: [declaration(), styles]
 		}
 	} };
+	if (options?.metadata !== void 0) require_opc_core_properties.addCoreProperties(pkg, options.metadata);
+	return pkg;
 }
 //#endregion
 exports.createEmptyDocxPackage = createEmptyDocxPackage;

package/dist/edit/docx/scaffold.d.cts

@@ -1,5 +1,9 @@
+import { LayoutMetadata } from "document-schema.js";
 import { Package } from "ooxml.js";
 //#region src/edit/docx/scaffold.d.ts
-declare function createEmptyDocxPackage(): Package;
+interface CreateEmptyDocxPackageOptions {
+  readonly metadata?: LayoutMetadata;
+}
+declare function createEmptyDocxPackage(options?: CreateEmptyDocxPackageOptions): Package;
 //#endregion
-export { createEmptyDocxPackage };
+export { CreateEmptyDocxPackageOptions, createEmptyDocxPackage };

package/dist/edit/docx/scaffold.d.ts

@@ -1,5 +1,9 @@
 import { Package } from "ooxml.js";
+import { LayoutMetadata } from "document-schema.js";
 //#region src/edit/docx/scaffold.d.ts
-declare function createEmptyDocxPackage(): Package;
+interface CreateEmptyDocxPackageOptions {
+  readonly metadata?: LayoutMetadata;
+}
+declare function createEmptyDocxPackage(options?: CreateEmptyDocxPackageOptions): Package;
 //#endregion
-export { createEmptyDocxPackage };
+export { CreateEmptyDocxPackageOptions, createEmptyDocxPackage };

package/dist/edit/docx/scaffold.js

@@ -1,4 +1,5 @@
 import { el } from "../../xml/fragment.js";
+import { addCoreProperties } from "../../opc/core-properties.js";
 //#region src/edit/docx/scaffold.ts
 const CONTENT_TYPES_NS = "http://schemas.openxmlformats.org/package/2006/content-types";
 const RELS_NS = "http://schemas.openxmlformats.org/package/2006/relationships";
@@ -22,7 +23,7 @@ function declaration() {
 		]
 	};
 }
-function createEmptyDocxPackage() {
+function createEmptyDocxPackage(options) {
 	const contentTypes = el("Types", { xmlns: CONTENT_TYPES_NS }, [
 		el("Default", {
 			Extension: "rels",
@@ -69,7 +70,7 @@ function createEmptyDocxPackage() {
 		"w:default": "1",
 		"w:styleId": "Normal"
 	}, [el("w:name", { "w:val": "Normal" })])]);
-	return { parts: {
+	const pkg = { parts: {
 		"[Content_Types].xml": {
 			kind: "xml",
 			nodes: [declaration(), contentTypes]
@@ -91,6 +92,8 @@ function createEmptyDocxPackage() {
 			nodes: [declaration(), styles]
 		}
 	} };
+	if (options?.metadata !== void 0) addCoreProperties(pkg, options.metadata);
+	return pkg;
 }
 //#endregion
 export { createEmptyDocxPackage };

package/dist/edit/odg/content.cjs

@@ -1,12 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_metadata = require("../../model/metadata.cjs");
+const require_ports_clock = require("../../ports/clock.cjs");
 const require_edit_odt_content = require("../odt/content.cjs");
+const require_edit_odg_scaffold = require("./scaffold.cjs");
 const require_edit_odg_editor = require("./editor.cjs");
 const require_model_paint_order = require("../../model/paint-order.cjs");
 let odf_js = require("odf.js");
 //#region src/edit/odg/content.ts
-function buildOdgPackage(content) {
+function buildOdgPackage(content, options) {
 	if (content.kind !== "drawing") throw new Error("buildOdgPackage requires a drawing ContentDocument");
-	const editor = require_edit_odg_editor.createOdg();
+	const clock = options?.clock ?? require_ports_clock.systemClock;
+	const metadata = require_model_metadata.resolveMetadataTimestamps(content.metadata, clock);
+	const editor = new require_edit_odg_editor.OdgEditor(require_edit_odg_scaffold.createEmptyOdgPackage({ metadata }));
 	const firstPage = content.pages[0];
 	if (firstPage !== void 0) editor.pageSize = firstPage.size;
 	for (const page of content.pages) {

package/dist/edit/odg/content.d.cts

@@ -1,6 +1,10 @@
+import { ClockPort } from "../../ports/clock.cjs";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odg/content.d.ts
-declare function buildOdgPackage(content: ContentDocument): Package;
+interface BuildOdgPackageOptions {
+  readonly clock?: ClockPort;
+}
+declare function buildOdgPackage(content: ContentDocument, options?: BuildOdgPackageOptions): Package;
 //#endregion
-export { buildOdgPackage };
+export { BuildOdgPackageOptions, buildOdgPackage };

package/dist/edit/odg/content.d.ts

@@ -1,6 +1,10 @@
+import { ClockPort } from "../../ports/clock.js";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odg/content.d.ts
-declare function buildOdgPackage(content: ContentDocument): Package;
+interface BuildOdgPackageOptions {
+  readonly clock?: ClockPort;
+}
+declare function buildOdgPackage(content: ContentDocument, options?: BuildOdgPackageOptions): Package;
 //#endregion
-export { buildOdgPackage };
+export { BuildOdgPackageOptions, buildOdgPackage };

package/dist/edit/odg/content.js

@@ -1,11 +1,16 @@
+import { resolveMetadataTimestamps } from "../../model/metadata.js";
+import { systemClock } from "../../ports/clock.js";
 import { populateParagraph } from "../odt/content.js";
-import { createOdg } from "./editor.js";
+import { createEmptyOdgPackage } from "./scaffold.js";
+import { OdgEditor } from "./editor.js";
 import { mergeByPaintOrder } from "../../model/paint-order.js";
 import { base64ToBytes } from "odf.js";
 //#region src/edit/odg/content.ts
-function buildOdgPackage(content) {
+function buildOdgPackage(content, options) {
 	if (content.kind !== "drawing") throw new Error("buildOdgPackage requires a drawing ContentDocument");
-	const editor = createOdg();
+	const clock = options?.clock ?? systemClock;
+	const metadata = resolveMetadataTimestamps(content.metadata, clock);
+	const editor = new OdgEditor(createEmptyOdgPackage({ metadata }));
 	const firstPage = content.pages[0];
 	if (firstPage !== void 0) editor.pageSize = firstPage.size;
 	for (const page of content.pages) {

package/dist/edit/odg/editor.cjs

@@ -1,4 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_metadata = require("../../model/metadata.cjs");
+const require_ports_clock = require("../../ports/clock.cjs");
 const require_xml_fragment = require("../../xml/fragment.cjs");
 const require_edit_odg_scaffold = require("./scaffold.cjs");
 const require_edit_odg_page = require("./page.cjs");
@@ -87,8 +89,10 @@ var OdgEditor = class {
 function openOdg(bytes) {
 	return new OdgEditor((0, odf_js.decodePackage)(bytes));
 }
-function createOdg() {
-	return new OdgEditor(require_edit_odg_scaffold.createEmptyOdgPackage());
+function createOdg(options) {
+	const clock = options?.clock ?? require_ports_clock.systemClock;
+	const metadata = require_model_metadata.resolveMetadataTimestamps({}, clock);
+	return new OdgEditor(require_edit_odg_scaffold.createEmptyOdgPackage({ metadata }));
 }
 //#endregion
 exports.OdgEditor = OdgEditor;

package/dist/edit/odg/editor.d.cts

@@ -1,3 +1,4 @@
+import { ClockPort } from "../../ports/clock.cjs";
 import { s as PageSize } from "../../geometry-DaJr8yQW.cjs";
 import { OdgPage } from "./page.cjs";
 import { Package } from "odf.js";
@@ -14,6 +15,9 @@ declare class OdgEditor {
   toBytes(): Uint8Array<ArrayBuffer>;
 }
 declare function openOdg(bytes: Uint8Array<ArrayBuffer>): OdgEditor;
-declare function createOdg(): OdgEditor;
+interface CreateOdgOptions {
+  readonly clock?: ClockPort;
+}
+declare function createOdg(options?: CreateOdgOptions): OdgEditor;
 //#endregion
-export { OdgEditor, createOdg, openOdg };
+export { CreateOdgOptions, OdgEditor, createOdg, openOdg };

package/dist/edit/odg/editor.d.ts

@@ -1,3 +1,4 @@
+import { ClockPort } from "../../ports/clock.js";
 import { s as PageSize } from "../../geometry-DaJr8yQW.js";
 import { OdgPage } from "./page.js";
 import { Package } from "odf.js";
@@ -14,6 +15,9 @@ declare class OdgEditor {
   toBytes(): Uint8Array<ArrayBuffer>;
 }
 declare function openOdg(bytes: Uint8Array<ArrayBuffer>): OdgEditor;
-declare function createOdg(): OdgEditor;
+interface CreateOdgOptions {
+  readonly clock?: ClockPort;
+}
+declare function createOdg(options?: CreateOdgOptions): OdgEditor;
 //#endregion
-export { OdgEditor, createOdg, openOdg };
+export { CreateOdgOptions, OdgEditor, createOdg, openOdg };

package/dist/edit/odg/editor.js

@@ -1,3 +1,5 @@
+import { resolveMetadataTimestamps } from "../../model/metadata.js";
+import { systemClock } from "../../ports/clock.js";
 import { el } from "../../xml/fragment.js";
 import { MASTER_PAGE_NAME, createEmptyOdgPackage } from "./scaffold.js";
 import { OdgPage } from "./page.js";
@@ -86,8 +88,10 @@ var OdgEditor = class {
 function openOdg(bytes) {
 	return new OdgEditor(decodePackage$1(bytes));
 }
-function createOdg() {
-	return new OdgEditor(createEmptyOdgPackage());
+function createOdg(options) {
+	const clock = options?.clock ?? systemClock;
+	const metadata = resolveMetadataTimestamps({}, clock);
+	return new OdgEditor(createEmptyOdgPackage({ metadata }));
 }
 //#endregion
 export { OdgEditor, createOdg, openOdg };

package/dist/edit/odg/scaffold.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_xml_entities = require("../../xml/entities.cjs");
 let odf_js = require("odf.js");
 let document_schema_js = require("document-schema.js");
 //#region src/edit/odg/scaffold.ts
@@ -75,13 +76,25 @@ function buildContentXml() {
 		"office:version": ODF_VERSION
 	}, [require_xml_fragment.el("office:automatic-styles"), require_xml_fragment.el("office:body", {}, [require_xml_fragment.el("office:drawing")])]);
 }
-function buildMetaXml() {
+function buildOfficeMeta(metadata) {
+	if (metadata === void 0) return [];
+	const children = [];
+	if (metadata.title !== void 0) children.push(require_xml_fragment.el("dc:title", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(metadata.title))]));
+	if (metadata.author !== void 0) children.push(require_xml_fragment.el("meta:initial-creator", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(metadata.author))]));
+	if (metadata.subject !== void 0) children.push(require_xml_fragment.el("dc:subject", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(metadata.subject))]));
+	for (const keyword of metadata.keywords ?? []) children.push(require_xml_fragment.el("meta:keyword", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(keyword))]));
+	if (metadata.creator !== void 0) children.push(require_xml_fragment.el("meta:generator", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(metadata.creator))]));
+	if (metadata.createdIso !== void 0) children.push(require_xml_fragment.el("meta:creation-date", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(metadata.createdIso))]));
+	if (metadata.modifiedIso !== void 0) children.push(require_xml_fragment.el("dc:date", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(metadata.modifiedIso))]));
+	return children;
+}
+function buildMetaXml(metadata) {
 	return require_xml_fragment.el("office:document-meta", {
 		...(0, odf_js.xmlnsAttributes)([...META_NS_PREFIXES]),
 		"office:version": ODF_VERSION
-	}, [require_xml_fragment.el("office:meta")]);
+	}, [require_xml_fragment.el("office:meta", {}, buildOfficeMeta(metadata))]);
 }
-function createEmptyOdgPackage() {
+function createEmptyOdgPackage(options) {
 	const pkg = { parts: {
 		"content.xml": {
 			kind: "xml",
@@ -93,7 +106,7 @@ function createEmptyOdgPackage() {
 		},
 		"meta.xml": {
 			kind: "xml",
-			nodes: [declaration(), buildMetaXml()]
+			nodes: [declaration(), buildMetaXml(options?.metadata)]
 		}
 	} };
 	(0, odf_js.setDocumentMediaType)(pkg, odf_js.ODF_MEDIA_TYPES.odg);

package/dist/edit/odg/scaffold.d.cts

@@ -1,7 +1,11 @@
+import { LayoutMetadata } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odg/scaffold.d.ts
 declare const PAGE_LAYOUT_NAME = "PM1";
 declare const MASTER_PAGE_NAME = "Standard";
-declare function createEmptyOdgPackage(): Package;
+interface CreateEmptyOdgPackageOptions {
+  readonly metadata?: LayoutMetadata;
+}
+declare function createEmptyOdgPackage(options?: CreateEmptyOdgPackageOptions): Package;
 //#endregion
-export { MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, createEmptyOdgPackage };
+export { CreateEmptyOdgPackageOptions, MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, createEmptyOdgPackage };

package/dist/edit/odg/scaffold.d.ts

@@ -1,7 +1,11 @@
+import { LayoutMetadata } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odg/scaffold.d.ts
 declare const PAGE_LAYOUT_NAME = "PM1";
 declare const MASTER_PAGE_NAME = "Standard";
-declare function createEmptyOdgPackage(): Package;
+interface CreateEmptyOdgPackageOptions {
+  readonly metadata?: LayoutMetadata;
+}
+declare function createEmptyOdgPackage(options?: CreateEmptyOdgPackageOptions): Package;
 //#endregion
-export { MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, createEmptyOdgPackage };
+export { CreateEmptyOdgPackageOptions, MASTER_PAGE_NAME, PAGE_LAYOUT_NAME, createEmptyOdgPackage };

package/dist/edit/odg/scaffold.js

@@ -1,5 +1,6 @@
 import { PAGE_SIZE_A4 } from "../../model/geometry.js";
-import { el } from "../../xml/fragment.js";
+import { el, txt } from "../../xml/fragment.js";
+import { encodeXmlText } from "../../xml/entities.js";
 import { ODF_MEDIA_TYPES, setDocumentMediaType, syncManifest, xmlnsAttributes } from "odf.js";
 //#region src/edit/odg/scaffold.ts
 const CONTENT_NS_PREFIXES = [
@@ -74,13 +75,25 @@ function buildContentXml() {
 		"office:version": ODF_VERSION
 	}, [el("office:automatic-styles"), el("office:body", {}, [el("office:drawing")])]);
 }
-function buildMetaXml() {
+function buildOfficeMeta(metadata) {
+	if (metadata === void 0) return [];
+	const children = [];
+	if (metadata.title !== void 0) children.push(el("dc:title", {}, [txt(encodeXmlText(metadata.title))]));
+	if (metadata.author !== void 0) children.push(el("meta:initial-creator", {}, [txt(encodeXmlText(metadata.author))]));
+	if (metadata.subject !== void 0) children.push(el("dc:subject", {}, [txt(encodeXmlText(metadata.subject))]));
+	for (const keyword of metadata.keywords ?? []) children.push(el("meta:keyword", {}, [txt(encodeXmlText(keyword))]));
+	if (metadata.creator !== void 0) children.push(el("meta:generator", {}, [txt(encodeXmlText(metadata.creator))]));
+	if (metadata.createdIso !== void 0) children.push(el("meta:creation-date", {}, [txt(encodeXmlText(metadata.createdIso))]));
+	if (metadata.modifiedIso !== void 0) children.push(el("dc:date", {}, [txt(encodeXmlText(metadata.modifiedIso))]));
+	return children;
+}
+function buildMetaXml(metadata) {
 	return el("office:document-meta", {
 		...xmlnsAttributes([...META_NS_PREFIXES]),
 		"office:version": ODF_VERSION
-	}, [el("office:meta")]);
+	}, [el("office:meta", {}, buildOfficeMeta(metadata))]);
 }
-function createEmptyOdgPackage() {
+function createEmptyOdgPackage(options) {
 	const pkg = { parts: {
 		"content.xml": {
 			kind: "xml",
@@ -92,7 +105,7 @@ function createEmptyOdgPackage() {
 		},
 		"meta.xml": {
 			kind: "xml",
-			nodes: [declaration(), buildMetaXml()]
+			nodes: [declaration(), buildMetaXml(options?.metadata)]
 		}
 	} };
 	setDocumentMediaType(pkg, ODF_MEDIA_TYPES.odg);

package/dist/edit/odp/content.cjs

@@ -1,12 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_metadata = require("../../model/metadata.cjs");
+const require_ports_clock = require("../../ports/clock.cjs");
 const require_model_embedded_drawing = require("../../model/embedded-drawing.cjs");
 const require_edit_odt_content = require("../odt/content.cjs");
+const require_edit_odp_scaffold = require("./scaffold.cjs");
 const require_edit_odp_editor = require("./editor.cjs");
 let odf_js = require("odf.js");
 //#region src/edit/odp/content.ts
-function buildOdpPackage(content) {
+function buildOdpPackage(content, options) {
 	if (content.kind !== "presentation") throw new Error("buildOdpPackage requires a presentation ContentDocument");
-	const editor = require_edit_odp_editor.createOdp();
+	const clock = options?.clock ?? require_ports_clock.systemClock;
+	const metadata = require_model_metadata.resolveMetadataTimestamps(content.metadata, clock);
+	const editor = new require_edit_odp_editor.OdpEditor(require_edit_odp_scaffold.createEmptyOdpPackage({ metadata }));
 	const firstSlide = content.slides[0];
 	if (firstSlide !== void 0) editor.slideSize = firstSlide.size;
 	for (const slide of content.slides) {

package/dist/edit/odp/content.d.cts

@@ -1,6 +1,10 @@
+import { ClockPort } from "../../ports/clock.cjs";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odp/content.d.ts
-declare function buildOdpPackage(content: ContentDocument): Package;
+interface BuildOdpPackageOptions {
+  readonly clock?: ClockPort;
+}
+declare function buildOdpPackage(content: ContentDocument, options?: BuildOdpPackageOptions): Package;
 //#endregion
-export { buildOdpPackage };
+export { BuildOdpPackageOptions, buildOdpPackage };

package/dist/edit/odp/content.d.ts

@@ -1,6 +1,10 @@
+import { ClockPort } from "../../ports/clock.js";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odp/content.d.ts
-declare function buildOdpPackage(content: ContentDocument): Package;
+interface BuildOdpPackageOptions {
+  readonly clock?: ClockPort;
+}
+declare function buildOdpPackage(content: ContentDocument, options?: BuildOdpPackageOptions): Package;
 //#endregion
-export { buildOdpPackage };
+export { BuildOdpPackageOptions, buildOdpPackage };