js.documents 1.92.9 → 1.93.1

package/dist/clock-C7SUuYN0.d.cts

@@ -0,0 +1,8 @@
+//#region src/ports/clock.d.ts
+interface ClockPort {
+  now(): Date;
+}
+declare const systemClock: ClockPort;
+declare function fixedClock(date: Date): ClockPort;
+//#endregion
+export { fixedClock as n, systemClock as r, ClockPort as t };

package/dist/clock-C7SUuYN0.d.ts

@@ -0,0 +1,8 @@
+//#region src/ports/clock.d.ts
+interface ClockPort {
+  now(): Date;
+}
+declare const systemClock: ClockPort;
+declare function fixedClock(date: Date): ClockPort;
+//#endregion
+export { fixedClock as n, systemClock as r, ClockPort as t };

package/dist/convert/capability.cjs

@@ -240,25 +240,22 @@ const DIRECT_EDGES = [
 		convert: require_convert_convert.odpToOdt
 	}
 ];
+var UnsupportedConversionError = class extends Error {
+	source;
+	target;
+	constructor(source, target) {
+		super(`unsupported conversion: ${source} -> ${target}`);
+		this.name = "UnsupportedConversionError";
+		this.source = source;
+		this.target = target;
+	}
+};
 function resolveConversionPath(source, target, edges = DIRECT_EDGES) {
 	if (source === target) return;
-	const direct = edges.find((edge) => edge.source === source && edge.target === target);
-	if (direct !== void 0) return {
-		kind: "direct",
-		edge: direct
-	};
-	for (const first of edges) {
-		if (first.source !== source) continue;
-		const second = edges.find((edge) => edge.source === first.target && edge.target === target);
-		if (second !== void 0) return {
-			kind: "composed",
-			via: first.target,
-			first,
-			second
-		};
-	}
+	return edges.find((edge) => edge.source === source && edge.target === target);
 }
 //#endregion
 exports.DIRECT_EDGES = DIRECT_EDGES;
 exports.FORMAT_CAPABILITIES = FORMAT_CAPABILITIES;
+exports.UnsupportedConversionError = UnsupportedConversionError;
 exports.resolveConversionPath = resolveConversionPath;

package/dist/convert/capability.d.cts

@@ -28,15 +28,11 @@ interface BridgeEdge {
 }
 type ConversionEdge = ToPdfEdge | FromPdfEdge | BridgeEdge;
 declare const DIRECT_EDGES: readonly ConversionEdge[];
-type ConversionStrategy = {
-  readonly kind: 'direct';
-  readonly edge: ConversionEdge;
-} | {
-  readonly kind: 'composed';
-  readonly via: DocumentFormat;
-  readonly first: ConversionEdge;
-  readonly second: ConversionEdge;
-};
-declare function resolveConversionPath(source: DocumentFormat, target: DocumentFormat, edges?: readonly ConversionEdge[]): ConversionStrategy | undefined;
+declare class UnsupportedConversionError extends Error {
+  readonly source: DocumentFormat;
+  readonly target: DocumentFormat;
+  constructor(source: DocumentFormat, target: DocumentFormat);
+}
+declare function resolveConversionPath(source: DocumentFormat, target: DocumentFormat, edges?: readonly ConversionEdge[]): ConversionEdge | undefined;
 //#endregion
-export { BridgeEdge, ContentVariant, ConversionEdge, ConversionStrategy, DIRECT_EDGES, FORMAT_CAPABILITIES, FormatCapability, FromPdfEdge, ToPdfEdge, resolveConversionPath };
+export { BridgeEdge, ContentVariant, ConversionEdge, DIRECT_EDGES, FORMAT_CAPABILITIES, FormatCapability, FromPdfEdge, ToPdfEdge, UnsupportedConversionError, resolveConversionPath };

package/dist/convert/capability.d.ts

@@ -28,15 +28,11 @@ interface BridgeEdge {
 }
 type ConversionEdge = ToPdfEdge | FromPdfEdge | BridgeEdge;
 declare const DIRECT_EDGES: readonly ConversionEdge[];
-type ConversionStrategy = {
-  readonly kind: 'direct';
-  readonly edge: ConversionEdge;
-} | {
-  readonly kind: 'composed';
-  readonly via: DocumentFormat;
-  readonly first: ConversionEdge;
-  readonly second: ConversionEdge;
-};
-declare function resolveConversionPath(source: DocumentFormat, target: DocumentFormat, edges?: readonly ConversionEdge[]): ConversionStrategy | undefined;
+declare class UnsupportedConversionError extends Error {
+  readonly source: DocumentFormat;
+  readonly target: DocumentFormat;
+  constructor(source: DocumentFormat, target: DocumentFormat);
+}
+declare function resolveConversionPath(source: DocumentFormat, target: DocumentFormat, edges?: readonly ConversionEdge[]): ConversionEdge | undefined;
 //#endregion
-export { BridgeEdge, ContentVariant, ConversionEdge, ConversionStrategy, DIRECT_EDGES, FORMAT_CAPABILITIES, FormatCapability, FromPdfEdge, ToPdfEdge, resolveConversionPath };
+export { BridgeEdge, ContentVariant, ConversionEdge, DIRECT_EDGES, FORMAT_CAPABILITIES, FormatCapability, FromPdfEdge, ToPdfEdge, UnsupportedConversionError, resolveConversionPath };

package/dist/convert/capability.js

@@ -239,23 +239,19 @@ const DIRECT_EDGES = [
 		convert: odpToOdt
 	}
 ];
+var UnsupportedConversionError = class extends Error {
+	source;
+	target;
+	constructor(source, target) {
+		super(`unsupported conversion: ${source} -> ${target}`);
+		this.name = "UnsupportedConversionError";
+		this.source = source;
+		this.target = target;
+	}
+};
 function resolveConversionPath(source, target, edges = DIRECT_EDGES) {
 	if (source === target) return;
-	const direct = edges.find((edge) => edge.source === source && edge.target === target);
-	if (direct !== void 0) return {
-		kind: "direct",
-		edge: direct
-	};
-	for (const first of edges) {
-		if (first.source !== source) continue;
-		const second = edges.find((edge) => edge.source === first.target && edge.target === target);
-		if (second !== void 0) return {
-			kind: "composed",
-			via: first.target,
-			first,
-			second
-		};
-	}
+	return edges.find((edge) => edge.source === source && edge.target === target);
 }
 //#endregion
-export { DIRECT_EDGES, FORMAT_CAPABILITIES, resolveConversionPath };
+export { DIRECT_EDGES, FORMAT_CAPABILITIES, UnsupportedConversionError, resolveConversionPath };

package/dist/convert/convert.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_geometry = require("../model/geometry.cjs");
+const require_model_metadata = require("../model/metadata.cjs");
 const require_edit_docx_editor = require("../edit/docx/editor.cjs");
 const require_edit_docx_content = require("../edit/docx/content.cjs");
 const require_edit_pptx_editor = require("../edit/pptx/editor.cjs");
@@ -38,8 +39,12 @@ let pdf_codec = require("pdf-codec");
 const mathMetricsAt = (sizePt) => (0, pdf_codec.loadMathFont)().metricsAt(sizePt);
 function docxToPdf(bytes, options) {
 	const pkg = require_edit_docx_editor.openDocx(bytes).toPackage();
-	const content = require_ooxml_docx_read.readDocxContent(pkg, { onMathDiagnostic: options?.onMathDiagnostic });
-	if (content.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
+	const read = require_ooxml_docx_read.readDocxContent(pkg, { onMathDiagnostic: options?.onMathDiagnostic });
+	if (read.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
+	const content = {
+		...read,
+		metadata: require_model_metadata.resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = require_fonts_registry.createDocumentFontRegistry({
 		kind: "docx",
 		package: pkg
@@ -62,8 +67,12 @@ function docxToPdf(bytes, options) {
 }
 function odtToPdf(bytes, options) {
 	const pkg = (0, odf_js.decodePackage)(bytes);
-	const content = require_odf_odt_read.readOdtContent(pkg);
-	if (content.kind !== "wordprocessing") throw new Error("readOdtContent returned a non-wordprocessing ContentDocument");
+	const read = require_odf_odt_read.readOdtContent(pkg);
+	if (read.kind !== "wordprocessing") throw new Error("readOdtContent returned a non-wordprocessing ContentDocument");
+	const content = {
+		...read,
+		metadata: require_model_metadata.resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = require_fonts_registry.createDocumentFontRegistry({
 		kind: "odf",
 		package: pkg
@@ -86,8 +95,12 @@ function odtToPdf(bytes, options) {
 }
 function pptxToPdf(bytes, options) {
 	const pkg = require_edit_pptx_editor.openPptx(bytes).toPackage();
-	const content = require_ooxml_pptx_read.readPptxContent(pkg);
-	if (content.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
+	const read = require_ooxml_pptx_read.readPptxContent(pkg);
+	if (read.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
+	const content = {
+		...read,
+		metadata: require_model_metadata.resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = require_fonts_registry.createDocumentFontRegistry({
 		kind: "pptx",
 		package: pkg
@@ -110,8 +123,12 @@ function pptxToPdf(bytes, options) {
 }
 function odpToPdf(bytes, options) {
 	const pkg = (0, odf_js.decodePackage)(bytes);
-	const content = require_odf_odp_read.readOdpContent(pkg);
-	if (content.kind !== "presentation") throw new Error("readOdpContent returned a non-presentation ContentDocument");
+	const read = require_odf_odp_read.readOdpContent(pkg);
+	if (read.kind !== "presentation") throw new Error("readOdpContent returned a non-presentation ContentDocument");
+	const content = {
+		...read,
+		metadata: require_model_metadata.resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = require_fonts_registry.createDocumentFontRegistry({
 		kind: "odf",
 		package: pkg
@@ -134,8 +151,12 @@ function odpToPdf(bytes, options) {
 }
 function odsToPdf(bytes, options) {
 	const pkg = (0, odf_js.decodePackage)(bytes);
-	const content = require_odf_ods_read.readOdsContent(pkg);
-	if (content.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
+	const read = require_odf_ods_read.readOdsContent(pkg);
+	if (read.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
+	const content = {
+		...read,
+		metadata: require_model_metadata.resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = require_fonts_registry.createDocumentFontRegistry({
 		kind: "odf",
 		package: pkg
@@ -159,8 +180,12 @@ function odsToPdf(bytes, options) {
 }
 function odgToPdf(bytes, options) {
 	const pkg = (0, odf_js.decodePackage)(bytes);
-	const content = require_odf_odg_read.readOdgContent(pkg);
-	if (content.kind !== "drawing") throw new Error("readOdgContent returned a non-drawing ContentDocument");
+	const read = require_odf_odg_read.readOdgContent(pkg);
+	if (read.kind !== "drawing") throw new Error("readOdgContent returned a non-drawing ContentDocument");
+	const content = {
+		...read,
+		metadata: require_model_metadata.resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = require_fonts_registry.createDocumentFontRegistry({
 		kind: "odf",
 		package: pkg
@@ -180,11 +205,15 @@ function odgToPdf(bytes, options) {
 function markdownToPdf(bytes, options) {
 	require_ports_abort.throwIfAborted(options?.signal);
 	const text = require_markdown_text.decodeMarkdownText(bytes);
-	const content = require_markdown_read.readMarkdownContent(text, {
+	const read = require_markdown_read.readMarkdownContent(text, {
 		signal: options?.signal,
 		images: options?.images
 	});
-	if (content.kind !== "wordprocessing") throw new Error("readMarkdownContent returned a non-wordprocessing ContentDocument");
+	if (read.kind !== "wordprocessing") throw new Error("readMarkdownContent returned a non-wordprocessing ContentDocument");
+	const content = {
+		...read,
+		metadata: require_model_metadata.resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = (0, pdf_codec.createFontRegistry)({
 		fonts: options?.fonts,
 		onSubstitution: options?.onFontSubstitution
@@ -210,8 +239,12 @@ const STANDALONE_FORMULA_MARGIN_PT = 72;
 function odfToPdf(bytes, options) {
 	require_ports_abort.throwIfAborted(options?.signal);
 	const pkg = (0, odf_js.decodePackage)(bytes);
-	const content = require_odf_formula_read.readOdfFormulaContent(pkg);
-	if (content.kind !== "formula") throw new Error("readOdfFormulaContent returned a non-formula ContentDocument");
+	const read = require_odf_formula_read.readOdfFormulaContent(pkg);
+	if (read.kind !== "formula") throw new Error("readOdfFormulaContent returned a non-formula ContentDocument");
+	const content = {
+		...read,
+		metadata: require_model_metadata.resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const metrics = (0, pdf_codec.loadMathFont)().metricsAt(STANDALONE_FORMULA_SIZE_PT);
 	const { box } = require_mathml_layout.layoutFormula(content.formula.mathml, {
 		metrics,
@@ -529,7 +562,8 @@ function xlsxToPdf(bytes, options) {
 		onSubstitution: options?.onSubstitution,
 		onDocument: options?.onDocument,
 		fonts: options?.fonts,
-		onFontSubstitution: options?.onFontSubstitution
+		onFontSubstitution: options?.onFontSubstitution,
+		clock: options?.clock
 	});
 }
 function pdfToXlsx(bytes, options) {
@@ -622,7 +656,7 @@ function odmToPdf(bytes, options) {
 	const content = {
 		kind: "wordprocessing",
 		formatVersion: document_schema_js.CONTENT_FORMAT_VERSION,
-		metadata: (0, odf_js.readOdfMetadata)(pkg),
+		metadata: require_model_metadata.resolveMetadataTimestamps((0, odf_js.readOdfMetadata)(pkg), options?.clock),
 		sections: combinedSections
 	};
 	const fonts = (0, pdf_codec.createFontRegistry)({

package/dist/convert/convert.d.cts

@@ -1,3 +1,4 @@
+import { t as ClockPort } from "../clock-C7SUuYN0.cjs";
 import { n as HsqldbDecodeOptions } from "../rowformat-Cl2exlEh.cjs";
 import { t as OmmlDiagnostic } from "../shared-DLZ3IQUl.cjs";
 import { t as DocumentFontRegistryOptions } from "../registry-ZAWlWHqJ.cjs";
@@ -16,6 +17,7 @@ interface DocumentToPdfOptions extends DocumentFontRegistryOptions {
     readonly sourcePath?: string;
   }) => void;
   readonly images?: MarkdownImageResolver;
+  readonly clock?: ClockPort;
 }
 declare function docxToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPdfOptions): Uint8Array<ArrayBuffer>;
 declare function odtToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPdfOptions): Uint8Array<ArrayBuffer>;

package/dist/convert/convert.d.ts

@@ -1,3 +1,4 @@
+import { t as ClockPort } from "../clock-C7SUuYN0.js";
 import { n as HsqldbDecodeOptions } from "../rowformat-Cl2exlEh.js";
 import { t as OmmlDiagnostic } from "../shared-DUOzjwcL.js";
 import { t as DocumentFontRegistryOptions } from "../registry-DpF4A9EM.js";
@@ -16,6 +17,7 @@ interface DocumentToPdfOptions extends DocumentFontRegistryOptions {
     readonly sourcePath?: string;
   }) => void;
   readonly images?: MarkdownImageResolver;
+  readonly clock?: ClockPort;
 }
 declare function docxToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPdfOptions): Uint8Array<ArrayBuffer>;
 declare function odtToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPdfOptions): Uint8Array<ArrayBuffer>;

package/dist/convert/convert.js

@@ -1,4 +1,5 @@
 import { PAGE_SIZE_A4 as PAGE_SIZE_A4$1, flipY } from "../model/geometry.js";
+import { resolveMetadataTimestamps } from "../model/metadata.js";
 import { openDocx } from "../edit/docx/editor.js";
 import { buildDocxPackage } from "../edit/docx/content.js";
 import { openPptx } from "../edit/pptx/editor.js";
@@ -37,8 +38,12 @@ import { createFontMeasurer, createFontRegistry, loadMathFont, readPdf, writePdf
 const mathMetricsAt = (sizePt) => loadMathFont().metricsAt(sizePt);
 function docxToPdf(bytes, options) {
 	const pkg = openDocx(bytes).toPackage();
-	const content = readDocxContent(pkg, { onMathDiagnostic: options?.onMathDiagnostic });
-	if (content.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
+	const read = readDocxContent(pkg, { onMathDiagnostic: options?.onMathDiagnostic });
+	if (read.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
+	const content = {
+		...read,
+		metadata: resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = createDocumentFontRegistry({
 		kind: "docx",
 		package: pkg
@@ -61,8 +66,12 @@ function docxToPdf(bytes, options) {
 }
 function odtToPdf(bytes, options) {
 	const pkg = decodePackage$1(bytes);
-	const content = readOdtContent(pkg);
-	if (content.kind !== "wordprocessing") throw new Error("readOdtContent returned a non-wordprocessing ContentDocument");
+	const read = readOdtContent(pkg);
+	if (read.kind !== "wordprocessing") throw new Error("readOdtContent returned a non-wordprocessing ContentDocument");
+	const content = {
+		...read,
+		metadata: resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = createDocumentFontRegistry({
 		kind: "odf",
 		package: pkg
@@ -85,8 +94,12 @@ function odtToPdf(bytes, options) {
 }
 function pptxToPdf(bytes, options) {
 	const pkg = openPptx(bytes).toPackage();
-	const content = readPptxContent(pkg);
-	if (content.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
+	const read = readPptxContent(pkg);
+	if (read.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
+	const content = {
+		...read,
+		metadata: resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = createDocumentFontRegistry({
 		kind: "pptx",
 		package: pkg
@@ -109,8 +122,12 @@ function pptxToPdf(bytes, options) {
 }
 function odpToPdf(bytes, options) {
 	const pkg = decodePackage$1(bytes);
-	const content = readOdpContent(pkg);
-	if (content.kind !== "presentation") throw new Error("readOdpContent returned a non-presentation ContentDocument");
+	const read = readOdpContent(pkg);
+	if (read.kind !== "presentation") throw new Error("readOdpContent returned a non-presentation ContentDocument");
+	const content = {
+		...read,
+		metadata: resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = createDocumentFontRegistry({
 		kind: "odf",
 		package: pkg
@@ -133,8 +150,12 @@ function odpToPdf(bytes, options) {
 }
 function odsToPdf(bytes, options) {
 	const pkg = decodePackage$1(bytes);
-	const content = readOdsContent(pkg);
-	if (content.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
+	const read = readOdsContent(pkg);
+	if (read.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
+	const content = {
+		...read,
+		metadata: resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = createDocumentFontRegistry({
 		kind: "odf",
 		package: pkg
@@ -158,8 +179,12 @@ function odsToPdf(bytes, options) {
 }
 function odgToPdf(bytes, options) {
 	const pkg = decodePackage$1(bytes);
-	const content = readOdgContent(pkg);
-	if (content.kind !== "drawing") throw new Error("readOdgContent returned a non-drawing ContentDocument");
+	const read = readOdgContent(pkg);
+	if (read.kind !== "drawing") throw new Error("readOdgContent returned a non-drawing ContentDocument");
+	const content = {
+		...read,
+		metadata: resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = createDocumentFontRegistry({
 		kind: "odf",
 		package: pkg
@@ -179,11 +204,15 @@ function odgToPdf(bytes, options) {
 function markdownToPdf(bytes, options) {
 	throwIfAborted(options?.signal);
 	const text = decodeMarkdownText(bytes);
-	const content = readMarkdownContent(text, {
+	const read = readMarkdownContent(text, {
 		signal: options?.signal,
 		images: options?.images
 	});
-	if (content.kind !== "wordprocessing") throw new Error("readMarkdownContent returned a non-wordprocessing ContentDocument");
+	if (read.kind !== "wordprocessing") throw new Error("readMarkdownContent returned a non-wordprocessing ContentDocument");
+	const content = {
+		...read,
+		metadata: resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const fonts = createFontRegistry({
 		fonts: options?.fonts,
 		onSubstitution: options?.onFontSubstitution
@@ -209,8 +238,12 @@ const STANDALONE_FORMULA_MARGIN_PT = 72;
 function odfToPdf(bytes, options) {
 	throwIfAborted(options?.signal);
 	const pkg = decodePackage$1(bytes);
-	const content = readOdfFormulaContent(pkg);
-	if (content.kind !== "formula") throw new Error("readOdfFormulaContent returned a non-formula ContentDocument");
+	const read = readOdfFormulaContent(pkg);
+	if (read.kind !== "formula") throw new Error("readOdfFormulaContent returned a non-formula ContentDocument");
+	const content = {
+		...read,
+		metadata: resolveMetadataTimestamps(read.metadata, options?.clock)
+	};
 	const metrics = loadMathFont().metricsAt(STANDALONE_FORMULA_SIZE_PT);
 	const { box } = layoutFormula(content.formula.mathml, {
 		metrics,
@@ -528,7 +561,8 @@ function xlsxToPdf(bytes, options) {
 		onSubstitution: options?.onSubstitution,
 		onDocument: options?.onDocument,
 		fonts: options?.fonts,
-		onFontSubstitution: options?.onFontSubstitution
+		onFontSubstitution: options?.onFontSubstitution,
+		clock: options?.clock
 	});
 }
 function pdfToXlsx(bytes, options) {
@@ -621,7 +655,7 @@ function odmToPdf(bytes, options) {
 	const content = {
 		kind: "wordprocessing",
 		formatVersion: CONTENT_FORMAT_VERSION,
-		metadata: readOdfMetadata(pkg),
+		metadata: resolveMetadataTimestamps(readOdfMetadata(pkg), options?.clock),
 		sections: combinedSections
 	};
 	const fonts = createFontRegistry({

package/dist/convert/local.cjs

@@ -30,7 +30,7 @@ function fromPdfDiagnostic(diagnostic) {
 }
 function createLocalDocumentConverter() {
 	return {
-		contractVersion: 4,
+		contractVersion: 5,
 		conversions: SUPPORTED_CONVERSIONS,
 		convert(request, options) {
 			const { source, targetFormat } = request;
@@ -43,9 +43,8 @@ function createLocalDocumentConverter() {
 				diagnostics.push(fontSubstitutionDiagnostic(substitution));
 				options.onFontSubstitution?.(substitution);
 			};
-			const strategy = require_convert_capability.resolveConversionPath(source.format, targetFormat);
-			if (strategy?.kind !== "direct") return Promise.reject(/* @__PURE__ */ new Error(`unsupported conversion: ${source.format} -> ${targetFormat}`));
-			const edge = strategy.edge;
+			const edge = require_convert_capability.resolveConversionPath(source.format, targetFormat);
+			if (edge === void 0) return Promise.reject(new require_convert_capability.UnsupportedConversionError(source.format, targetFormat));
 			if (edge.kind === "toPdf") {
 				const bytes = edge.convert(source.bytes, {
 					signal: options.signal,
@@ -53,7 +52,8 @@ function createLocalDocumentConverter() {
 					onDocument,
 					fonts: options.fonts,
 					onFontSubstitution,
-					images: options.images
+					images: options.images,
+					clock: options.clock
 				});
 				return Promise.resolve({
 					document: {

package/dist/convert/local.js

@@ -1,4 +1,4 @@
-import { DIRECT_EDGES, resolveConversionPath } from "./capability.js";
+import { DIRECT_EDGES, UnsupportedConversionError, resolveConversionPath } from "./capability.js";
 //#region src/convert/local.ts
 const SUPPORTED_CONVERSIONS = DIRECT_EDGES.map((edge) => ({
 	source: edge.source,
@@ -29,7 +29,7 @@ function fromPdfDiagnostic(diagnostic) {
 }
 function createLocalDocumentConverter() {
 	return {
-		contractVersion: 4,
+		contractVersion: 5,
 		conversions: SUPPORTED_CONVERSIONS,
 		convert(request, options) {
 			const { source, targetFormat } = request;
@@ -42,9 +42,8 @@ function createLocalDocumentConverter() {
 				diagnostics.push(fontSubstitutionDiagnostic(substitution));
 				options.onFontSubstitution?.(substitution);
 			};
-			const strategy = resolveConversionPath(source.format, targetFormat);
-			if (strategy?.kind !== "direct") return Promise.reject(/* @__PURE__ */ new Error(`unsupported conversion: ${source.format} -> ${targetFormat}`));
-			const edge = strategy.edge;
+			const edge = resolveConversionPath(source.format, targetFormat);
+			if (edge === void 0) return Promise.reject(new UnsupportedConversionError(source.format, targetFormat));
 			if (edge.kind === "toPdf") {
 				const bytes = edge.convert(source.bytes, {
 					signal: options.signal,
@@ -52,7 +51,8 @@ function createLocalDocumentConverter() {
 					onDocument,
 					fonts: options.fonts,
 					onFontSubstitution,
-					images: options.images
+					images: options.images,
+					clock: options.clock
 				});
 				return Promise.resolve({
 					document: {

package/dist/convert/port.d.cts

@@ -1,3 +1,4 @@
+import { t as ClockPort } from "../clock-C7SUuYN0.cjs";
 import { DocumentPackage, FontSubstitution, ProvidedFont } from "document-schema.js";
 import { MarkdownImageResolver } from "markdown-codec";
 import { z } from "zod";
@@ -40,6 +41,7 @@ interface ConversionOptions {
   readonly fonts?: readonly ProvidedFont[];
   readonly onFontSubstitution?: (substitution: FontSubstitution) => void;
   readonly images?: MarkdownImageResolver;
+  readonly clock?: ClockPort;
 }
 interface DocumentConverter {
   readonly contractVersion: number;

package/dist/convert/port.d.ts

@@ -1,3 +1,4 @@
+import { t as ClockPort } from "../clock-C7SUuYN0.js";
 import { DocumentPackage, FontSubstitution, ProvidedFont } from "document-schema.js";
 import { z } from "zod";
 import { MarkdownImageResolver } from "markdown-codec";
@@ -40,6 +41,7 @@ interface ConversionOptions {
   readonly fonts?: readonly ProvidedFont[];
   readonly onFontSubstitution?: (substitution: FontSubstitution) => void;
   readonly images?: MarkdownImageResolver;
+  readonly clock?: ClockPort;
 }
 interface DocumentConverter {
   readonly contractVersion: number;

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

@@ -1,5 +1,5 @@
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 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

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

@@ -1,5 +1,5 @@
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 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

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { DocxParagraph, ParagraphInit } from "./paragraph.cjs";
 import { DocxTable, TableInit } from "./table.cjs";
 import { Package } from "ooxml.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { DocxParagraph, ParagraphInit } from "./paragraph.js";
 import { DocxTable, TableInit } from "./table.js";
 import { Package } from "ooxml.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { r as Margins, s as PageSize$1 } from "../../geometry-DUF273hM.cjs";
 import { MarkdownParagraph, ParagraphInit } from "./paragraph.cjs";
 import { MarkdownList, MarkdownListInit } from "./list.cjs";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { r as Margins, s as PageSize$1 } from "../../geometry-BG4fX9Rw.js";
 import { MarkdownParagraph, ParagraphInit } from "./paragraph.js";
 import { MarkdownList, MarkdownListInit } from "./list.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odg/content.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odg/content.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { s as PageSize } from "../../geometry-DUF273hM.cjs";
 import { OdgPage } from "./page.cjs";
 import { Package } from "odf.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { s as PageSize } from "../../geometry-BG4fX9Rw.js";
 import { OdgPage } from "./page.js";
 import { Package } from "odf.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odp/content.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odp/content.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { s as PageSize } from "../../geometry-DUF273hM.cjs";
 import { OdpSlide } from "./slide.cjs";
 import { Package } from "odf.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { s as PageSize } from "../../geometry-BG4fX9Rw.js";
 import { OdpSlide } from "./slide.js";
 import { Package } from "odf.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/ods/content.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/ods/content.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { OdsSheet } from "./sheet.cjs";
 import { Package } from "odf.js";
 //#region src/edit/ods/editor.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { OdsSheet } from "./sheet.js";
 import { Package } from "odf.js";
 //#region src/edit/ods/editor.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { t as OdtParagraph } from "../../paragraph-D7324S0j.cjs";
 import { n as OdtTable } from "../../table-u6fXNuDO.cjs";
 import { ContentDocument, ContentParagraph, ContentTable } from "document-schema.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { t as OdtParagraph } from "../../paragraph-DZyHl2e4.js";
 import { n as OdtTable } from "../../table-qaDB5iJO.js";
 import { ContentDocument, ContentParagraph, ContentTable } from "document-schema.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { t as Box$1 } from "../../geometry-DUF273hM.cjs";
 import { n as ParagraphInit, t as OdtParagraph } from "../../paragraph-D7324S0j.cjs";
 import { t as OdtList } from "../../list-MCxkKpI7.cjs";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { t as Box$1 } from "../../geometry-BG4fX9Rw.js";
 import { n as ParagraphInit, t as OdtParagraph } from "../../paragraph-DZyHl2e4.js";
 import { t as OdtList } from "../../list-BrAIR4Sv.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { PageInit, PdfPage } from "./page.cjs";
 import { LayoutDocument, LayoutMetadata } from "document-schema.js";
 import { ReadPdfOptions, WritePdfOptions } from "pdf-codec";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { PageInit, PdfPage } from "./page.js";
 import { LayoutDocument, LayoutMetadata } from "document-schema.js";
 import { ReadPdfOptions, WritePdfOptions } from "pdf-codec";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { ContentDocument } from "document-schema.js";
 import { Package } from "ooxml.js";
 //#region src/edit/pptx/content.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { Package } from "ooxml.js";
 import { ContentDocument } from "document-schema.js";
 //#region src/edit/pptx/content.d.ts

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.cjs";
+import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { s as PageSize } from "../../geometry-DUF273hM.cjs";
 import { PptxSlide } from "./slide.cjs";
 import { Package } from "ooxml.js";

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

@@ -1,4 +1,4 @@
-import { ClockPort } from "../../ports/clock.js";
+import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { s as PageSize } from "../../geometry-BG4fX9Rw.js";
 import { PptxSlide } from "./slide.js";
 import { Package } from "ooxml.js";

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { n as fixedClock, r as systemClock, t as ClockPort } from "./clock-C7SUuYN0.cjs";
 import { ConversionOptions, ConversionRequest, ConversionResult, DOCUMENT_FORMATS, Diagnostic, DocumentConverter, DocumentFormat, DocumentFormatSchema, DocumentPayload } from "./convert/port.cjs";
 import { n as HsqldbDecodeOptions, r as HsqldbRowFormatError } from "./rowformat-Cl2exlEh.cjs";
 import { i as mapMathVariant, n as applyMathVariant, r as isMathVariant, t as MathVariant } from "./variant-BMrebjMw.cjs";
@@ -8,7 +9,6 @@ import { docxPdfCodec, markdownDocxCodec, markdownOdtCodec, markdownPdfCodec, od
 import { UnsupportedFontSourceFormatError, extractSourceFontsForFormat } from "./convert/document-fonts.cjs";
 import { buildDocumentBytes } from "./convert/from-package.cjs";
 import { createLocalDocumentConverter } from "./convert/local.cjs";
-import { ClockPort, fixedClock, systemClock } from "./ports/clock.cjs";
 import { BuildDocxPackageOptions, buildDocxPackage } from "./edit/docx/content.cjs";
 import { c as firstChildByLocalName, d as textContent, i as MathMlText, l as isMathMlElement, n as MathMlElement, o as elementChildren, r as MathMlNode, s as elementLocalName, t as MathMlAttribute, u as localName } from "./nodes-pArN9ilm.cjs";
 import { n as buildOfficeMath, r as buildOfficeMathParagraph, t as OmmlWriteResult } from "./write-BQ6SK8r8.cjs";

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { n as fixedClock, r as systemClock, t as ClockPort } from "./clock-C7SUuYN0.js";
 import { ConversionOptions, ConversionRequest, ConversionResult, DOCUMENT_FORMATS, Diagnostic, DocumentConverter, DocumentFormat, DocumentFormatSchema, DocumentPayload } from "./convert/port.js";
 import { n as HsqldbDecodeOptions, r as HsqldbRowFormatError } from "./rowformat-Cl2exlEh.js";
 import { i as mapMathVariant, n as applyMathVariant, r as isMathVariant, t as MathVariant } from "./variant-BMrebjMw.js";
@@ -8,7 +9,6 @@ import { docxPdfCodec, markdownDocxCodec, markdownOdtCodec, markdownPdfCodec, od
 import { UnsupportedFontSourceFormatError, extractSourceFontsForFormat } from "./convert/document-fonts.js";
 import { buildDocumentBytes } from "./convert/from-package.js";
 import { createLocalDocumentConverter } from "./convert/local.js";
-import { ClockPort, fixedClock, systemClock } from "./ports/clock.js";
 import { BuildDocxPackageOptions, buildDocxPackage } from "./edit/docx/content.js";
 import { c as firstChildByLocalName, d as textContent, i as MathMlText, l as isMathMlElement, n as MathMlElement, o as elementChildren, r as MathMlNode, s as elementLocalName, t as MathMlAttribute, u as localName } from "./nodes-pArN9ilm.js";
 import { n as buildOfficeMath, r as buildOfficeMathParagraph, t as OmmlWriteResult } from "./write-THs7ipBq.js";

package/dist/model/metadata.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/model/metadata.ts
 function resolveMetadataTimestamps(metadata, clock) {
+	if (clock === void 0) return metadata;
 	if (metadata.createdIso !== void 0 && metadata.modifiedIso !== void 0) return metadata;
 	const now = clock.now().toISOString();
 	return {

package/dist/model/metadata.d.cts

@@ -1,6 +1,6 @@
-import { ClockPort } from "../ports/clock.cjs";
+import { t as ClockPort } from "../clock-C7SUuYN0.cjs";
 import { LayoutMetadata } from "document-schema.js";
 //#region src/model/metadata.d.ts
-declare function resolveMetadataTimestamps(metadata: LayoutMetadata, clock: ClockPort): LayoutMetadata;
+declare function resolveMetadataTimestamps(metadata: LayoutMetadata, clock?: ClockPort): LayoutMetadata;
 //#endregion
 export { resolveMetadataTimestamps };

package/dist/model/metadata.d.ts

@@ -1,6 +1,6 @@
-import { ClockPort } from "../ports/clock.js";
+import { t as ClockPort } from "../clock-C7SUuYN0.js";
 import { LayoutMetadata } from "document-schema.js";
 //#region src/model/metadata.d.ts
-declare function resolveMetadataTimestamps(metadata: LayoutMetadata, clock: ClockPort): LayoutMetadata;
+declare function resolveMetadataTimestamps(metadata: LayoutMetadata, clock?: ClockPort): LayoutMetadata;
 //#endregion
 export { resolveMetadataTimestamps };

package/dist/model/metadata.js

@@ -1,5 +1,6 @@
 //#region src/model/metadata.ts
 function resolveMetadataTimestamps(metadata, clock) {
+	if (clock === void 0) return metadata;
 	if (metadata.createdIso !== void 0 && metadata.modifiedIso !== void 0) return metadata;
 	const now = clock.now().toISOString();
 	return {

package/dist/ports/clock.d.cts

@@ -1,8 +1,2 @@
-//#region src/ports/clock.d.ts
-interface ClockPort {
-  now(): Date;
-}
-declare const systemClock: ClockPort;
-declare function fixedClock(date: Date): ClockPort;
-//#endregion
+import { n as fixedClock, r as systemClock, t as ClockPort } from "../clock-C7SUuYN0.cjs";
 export { ClockPort, fixedClock, systemClock };

package/dist/ports/clock.d.ts

@@ -1,8 +1,2 @@
-//#region src/ports/clock.d.ts
-interface ClockPort {
-  now(): Date;
-}
-declare const systemClock: ClockPort;
-declare function fixedClock(date: Date): ClockPort;
-//#endregion
+import { n as fixedClock, r as systemClock, t as ClockPort } from "../clock-C7SUuYN0.js";
 export { ClockPort, fixedClock, systemClock };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "1.92.9",
+  "version": "1.93.1",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -58,7 +58,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "byte-codec": "^1.0.2",
+    "byte-codec": "^1.0.4",
     "document-schema.js": "^2.4.3",
     "fflate": "^0.8.3",
     "markdown-codec": "^1.1.14",