@ym-print/core 0.0.0-stage → 0.1.0-rc.2

package/LICENSE

@@ -0,0 +1,8 @@
+UNLICENSED
+
+Copyright (c) 2026 YmPrintUnit contributors. All rights reserved.
+
+No open-source license is granted for the original YmPrintUnit code.
+
+Third-party components retain their own licenses. See THIRD_PARTY_NOTICES.md
+and dependency-licenses.json; this notice does not change those licenses.

package/README.md

@@ -1,3 +1,55 @@
-# Temporary Holding Version
+# @ym-print/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+YmPrintUnit 的模板类型、数据表达式和排版内核。根据模板、业务数据及字体测量器生成 `LayoutDocument`，供页面渲染、打印和文件输出使用。
+
+## npm 安装
+
+首次 npm 发布完成后安装预发布版：
+
+```sh
+pnpm add @ym-print/core@next
+```
+
+正式版发布后将 `@next` 改为 `@latest`。原始代码保持 `UNLICENSED`，详见随包附带的 `LICENSE`；第三方许可见 `THIRD_PARTY_NOTICES.md`。
+
+## 项目内容
+
+- 纸张、分节、页眉页脚、流式与绝对定位。
+- 长文字、表格、分组统计、组合单元格与标签拼版。
+- JSON Pointer 字段引用、十进制计算、格式化和条件规则。
+- 元素插件、业务函数注册和资源检查。
+
+## 使用方法
+
+包使用 ESM，并提供 TypeScript 类型。将模板、业务数据和实现 `TextFont` 的字体测量器传入排版函数：
+
+```ts
+import {createPrintRegistry, layoutTemplate} from '@ym-print/core';
+import type {Template, TextFont} from '@ym-print/core';
+
+export function createLayout(
+  template: Template,
+  data: Record<string, unknown>,
+  font: TextFont,
+) {
+  const registry = createPrintRegistry();
+  return layoutTemplate(template, data, font, {registry, mode:'w2'});
+}
+```
+
+`LayoutDocument.pages` 包含分页后的物理尺寸和绘制命令。调用方可把它传给 `@ym-print/renderer-dom` 渲染或打印，或者交给 `@ym-print/renderer-pdf` 导出。
+
+Web 页面可使用 `@ym-print/renderer-dom` 的 `BrowserFont` 作为测量器。自定义元素或业务函数通过 `createPrintRegistry` 注册，再将同一注册表传入排版与输出流程。
+
+## 数据与单位
+
+| 内容 | 用法 |
+| --- | --- |
+| 字段路径 | JSON Pointer，例如 `/supplier/name` |
+| 表格数据 | 列值使用行作用域，数组来源由模板指定 |
+| 金额 | 使用十进制字符串，例如 `"12.35"` |
+| 坐标与尺寸 | 微米，`1000 μm = 1 mm` |
+| 字号 | 毫点，`1000 mpt = 1 pt` |
+| 旋转 | 毫度，`1000 mdeg = 1°` |
+
+模板、业务数据、图片资源和字体测量器由调用方提供。排版结果用于预览和输出，保存模板时使用原设计内容。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,19 @@
+# Third-party notices
+
+@ym-print/core 0.1.0-rc.2 — original code: UNLICENSED.
+
+Bundled code and external packages keep their original licenses. Optional peers are loaded through their documented opt-in entry.
+
+| Package | License | Delivery | Notices |
+| --- | --- | --- | --- |
+| @pdf-lib/fontkit@1.1.1 | MIT | optional-peer | License declared upstream; not bundled here |
+| ajv@8.20.0 | MIT | external | [LICENSE](third-party-licenses/ajv@8.20.0/LICENSE) |
+| bwip-js@4.11.4 | MIT | external | [LICENSE](third-party-licenses/bwip-js@4.11.4/LICENSE), [LICENSE.CANVASTOBLOB](third-party-licenses/bwip-js@4.11.4/LICENSE.CANVASTOBLOB), [LICENSE.FILESAVER](third-party-licenses/bwip-js@4.11.4/LICENSE.FILESAVER), [LICENSE.INCONSOLATA](third-party-licenses/bwip-js@4.11.4/LICENSE.INCONSOLATA) |
+| decimal.js@10.6.0 | MIT | external | [LICENCE.md](third-party-licenses/decimal.js@10.6.0/LICENCE.md) |
+| entities@8.1.0 | BSD-2-Clause | external | [LICENSE](third-party-licenses/entities@8.1.0/LICENSE) |
+| fast-deep-equal@3.1.3 | MIT | external | [LICENSE](third-party-licenses/fast-deep-equal@3.1.3/LICENSE) |
+| fast-uri@3.1.9 | BSD-3-Clause | external | [LICENSE](third-party-licenses/fast-uri@3.1.9/LICENSE) |
+| json-schema-traverse@1.0.0 | MIT | external | [LICENSE](third-party-licenses/json-schema-traverse@1.0.0/LICENSE) |
+| pako@1.0.11 | (MIT AND Zlib) | external | [LICENSE](third-party-licenses/pako@1.0.11/LICENSE) |
+| parse5@8.0.1 | MIT | external | [LICENSE](third-party-licenses/parse5@8.0.1/LICENSE) |
+| require-from-string@2.0.2 | MIT | external | [license](third-party-licenses/require-from-string@2.0.2/license) |

package/dependency-licenses.json

@@ -0,0 +1,149 @@
+{
+  "package": "@ym-print/core",
+  "version": "0.1.0-rc.2",
+  "license": "UNLICENSED",
+  "licenseScope": "original YmPrintUnit code only",
+  "dependencies": [
+    {
+      "name": "@pdf-lib/fontkit",
+      "version": "1.1.1",
+      "license": "MIT",
+      "kind": "optional-peer",
+      "notices": [],
+      "noticeStatus": "upstream declares license but ships no license-named file; external code is not copied"
+    },
+    {
+      "name": "ajv",
+      "version": "8.20.0",
+      "license": "MIT",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/ajv@8.20.0/LICENSE",
+          "sha256": "a05350a88e318e4f5f2c2a1ff1e2e88daa4dd38e6e78b71cccae422bdc762cc3"
+        }
+      ]
+    },
+    {
+      "name": "bwip-js",
+      "version": "4.11.4",
+      "license": "MIT",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/bwip-js@4.11.4/LICENSE",
+          "sha256": "cc393d55aa77ec8e5aa27065244596b5ed8b2c6a1bc5c014045e11f91f343492"
+        },
+        {
+          "path": "third-party-licenses/bwip-js@4.11.4/LICENSE.CANVASTOBLOB",
+          "sha256": "4ad7a94085f65777827e9cd3b87c37aefebfc963029320a3054b84e234c3ae18"
+        },
+        {
+          "path": "third-party-licenses/bwip-js@4.11.4/LICENSE.FILESAVER",
+          "sha256": "dfb1a94504fac1c72b69b9f89a3b95f7f6643de79e5efb1fc4ba350766402188"
+        },
+        {
+          "path": "third-party-licenses/bwip-js@4.11.4/LICENSE.INCONSOLATA",
+          "sha256": "1a7adaa2c86cedfd6c7f5c0c7c72fd6d3e02cd0c9593f21fdb53c89bb2b130ec"
+        }
+      ]
+    },
+    {
+      "name": "decimal.js",
+      "version": "10.6.0",
+      "license": "MIT",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/decimal.js@10.6.0/LICENCE.md",
+          "sha256": "3108b546bcff5d346923a82f48b2d252ca722f9088076db6d145f6b67757ad6c"
+        }
+      ]
+    },
+    {
+      "name": "entities",
+      "version": "8.1.0",
+      "license": "BSD-2-Clause",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/entities@8.1.0/LICENSE",
+          "sha256": "cb992345949ccd6e8394b2cd6c465f7b897c864f845937dbf64e8997f389e164"
+        }
+      ]
+    },
+    {
+      "name": "fast-deep-equal",
+      "version": "3.1.3",
+      "license": "MIT",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/fast-deep-equal@3.1.3/LICENSE",
+          "sha256": "7bf9b2de73a6b356761c948d0e9eeb4be6c1270bd04c79cd489c1e400ffdfc1a"
+        }
+      ]
+    },
+    {
+      "name": "fast-uri",
+      "version": "3.1.9",
+      "license": "BSD-3-Clause",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/fast-uri@3.1.9/LICENSE",
+          "sha256": "b010b0dfdfdb23d7396e03b82cd4621fc9bb8f95d6b0aea70b9c24e12074c786"
+        }
+      ]
+    },
+    {
+      "name": "json-schema-traverse",
+      "version": "1.0.0",
+      "license": "MIT",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/json-schema-traverse@1.0.0/LICENSE",
+          "sha256": "7bf9b2de73a6b356761c948d0e9eeb4be6c1270bd04c79cd489c1e400ffdfc1a"
+        }
+      ]
+    },
+    {
+      "name": "pako",
+      "version": "1.0.11",
+      "license": "(MIT AND Zlib)",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/pako@1.0.11/LICENSE",
+          "sha256": "a04665b3b2de56c66730c1f720f528175739e4104f79073614aa611da1e85539"
+        }
+      ]
+    },
+    {
+      "name": "parse5",
+      "version": "8.0.1",
+      "license": "MIT",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/parse5@8.0.1/LICENSE",
+          "sha256": "8c535800331e1e4439835555b3f9edc7fe9dee2fab0d8bbbd5a982e8b8343d4d"
+        }
+      ]
+    },
+    {
+      "name": "require-from-string",
+      "version": "2.0.2",
+      "license": "MIT",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/require-from-string@2.0.2/license",
+          "sha256": "6ee0feb1f6ef996ff5a68600f8cf98909cf412d39ef3cdceaefd87d636fa1b7f"
+        }
+      ]
+    }
+  ],
+  "resourceLicenses": []
+}

package/dist/advanced-elements.d.ts

@@ -0,0 +1,6 @@
+import type { ElementPlugin } from './plugins.js';
+export declare const richTextPlugin: ElementPlugin;
+export declare const svgPlugin: ElementPlugin;
+export declare const pdfPagePlugin: ElementPlugin;
+export declare const seamSealPlugin: ElementPlugin;
+export declare const advancedElements: readonly [ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin];

package/dist/barcode.d.ts

@@ -0,0 +1,22 @@
+export declare const isMatrixSymbol: (s: string) => boolean;
+export declare function barcodeRects(value: string, symbology: string, moduleUm: number, quietUm: number, widthUm: number, heightUm: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}[];
+/** Whole integer modules and quiet zones are preserved when the editing frame changes. */
+export declare function barcodeSizing(value: string, symbology: string, moduleUm: number, quietZoneUm: number): {
+    columns: number;
+    rows: number;
+    quietModules: number;
+    minModuleUm: number;
+    minWidthUm: number;
+    minHeightUm: number;
+};
+export declare function fittedBarcodeRects(value: string, symbology: string, referenceModuleUm: number, referenceQuietUm: number, widthUm: number, heightUm: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}[];

package/dist/capabilities.d.ts

@@ -0,0 +1,22 @@
+import { type PrintRegistry } from './plugins.js';
+import type { Template } from './protocol.js';
+export declare const CAPABILITY_LABELS: Readonly<Record<string, string>>;
+export declare const WEB_CAPABILITIES: readonly string[];
+export interface PreflightIssue {
+    code: string;
+    message: string;
+    path?: string;
+    nodeId?: string;
+    dataPath?: string;
+    scope?: string;
+}
+export interface CapabilityReport {
+    valid: boolean;
+    requiredCapabilities: string[];
+    declaredCapabilities: string[];
+    errors: PreflightIssue[];
+    warnings: PreflightIssue[];
+}
+/** Derive requirements from actual content; declarations cannot conceal unsupported elements or expressions. */
+export declare function inspectTemplateCapabilities(template: Template, registry?: PrintRegistry): CapabilityReport;
+export declare function assertTemplateCapabilities(template: Template, registry?: PrintRegistry): CapabilityReport;

package/dist/cell-plugins.d.ts

@@ -0,0 +1,3 @@
+import type { ElementPlugin } from './plugins.js';
+export declare const imageCellPlugin: ElementPlugin;
+export declare const barcodeCellPlugin: ElementPlugin, qrcodeCellPlugin: ElementPlugin;

package/dist/composite-cell.d.ts

@@ -0,0 +1,27 @@
+import type { CellElement, CompositeCell, DrawCommand, EvalContext, Expr, TextStyle } from './protocol.js';
+import type { TextFont } from './font.js';
+import type { PrintRegistry } from './plugins.js';
+export declare const COMPOSITE_CELL_LIMITS: {
+    readonly depth: 8;
+    readonly elements: 64;
+    readonly fragments: 4096;
+    readonly commands: 20000;
+    readonly heightUm: 2000000;
+};
+export interface CellFragment {
+    heightUm: number;
+    commands: DrawCommand[];
+}
+/** A bounded layout tree belongs to one cell. It never contains dynamic tables, repetitions or templates. */
+export declare function visitCompositeCell(cell: CompositeCell, visit?: (element: CellElement, path: string) => void): void;
+export declare function compositeBindings(cell: CompositeCell, registry?: PrintRegistry): {
+    expr: Expr;
+    path: string;
+    image?: boolean;
+}[];
+/** Measure first, partition only where no text line/image/code/plugin/keep-together group crosses the cut. */
+export declare function measureCompositeCell(cell: CompositeCell, ctx: EvalContext, font: TextFont, widthUm: number, style: TextStyle, nodeId: string): {
+    heightUm: number;
+    fragments: CellFragment[];
+    commands: DrawCommand[];
+};

package/dist/data.d.ts

@@ -0,0 +1,14 @@
+import type { Template, RuntimeInputs, EvalContext, NamedDataSources } from './protocol.js';
+export declare const pointerSegment: (value: string) => string;
+/** Copy JSON without coercing dates, non-finite numbers, accessors, cycles or undefined to other values. */
+export declare function snapshotJson<T>(input: T): T;
+export declare function jsonObject(input: unknown, scope?: string): Record<string, unknown>;
+export declare function validateInputSchema(schema: unknown): void;
+export declare function validateData(schema: Record<string, unknown> | undefined, data: Record<string, unknown>, scope: 'root' | 'params'): void;
+/** Defaults apply to a private print snapshot; null remains distinct from a missing property. */
+/** Named JSON snapshots are supplied by the host; this module never fetches data. */
+export declare function snapshotSources(input?: NamedDataSources): NamedDataSources;
+export declare function preparePrintInputs(template: Template, data: unknown, options?: RuntimeInputs): EvalContext & {
+    params: Record<string, unknown>;
+    context: Record<string, unknown>;
+};

package/dist/expression.d.ts

@@ -0,0 +1,16 @@
+import type { EvalContext, Expr } from './protocol.js';
+export { decimalInput, formatDate, formatMoneyUpper, DATE_PATTERNS } from './formatting.js';
+interface FunctionSpec {
+    min: number;
+    max: number;
+    capability: string;
+}
+export declare const FUNCTION_SIGNATURES: Readonly<Record<string, FunctionSpec>>;
+export declare function expressionLocation(expression: Expr, context: EvalContext): {
+    scope: string;
+    path: string;
+} | undefined;
+export declare function tableRowContext(context: EvalContext, source: Expr, row: Record<string, unknown>, index: number): EvalContext;
+export declare function evaluate(expression: Expr, context: EvalContext, depth?: number): unknown;
+export declare function evaluateRequired(expression: Expr, context: EvalContext): unknown;
+export declare function evaluateText(expression: Expr, context: EvalContext): string;

package/dist/font-ToGNY599.js

@@ -0,0 +1,136 @@
+// src/protocol.ts
+var e = class extends Error {
+	code;
+	nodeId;
+	path;
+	details;
+	dataPath;
+	scope;
+	issues;
+	constructor(e, t, n, r, i) {
+		super(t), this.code = e, this.nodeId = n, this.path = r, this.details = i, this.name = "PrintError", this.dataPath = i?.dataPath, this.scope = i?.scope, this.issues = i?.issues;
+	}
+};
+function t(t, n) {
+	if (!Number.isSafeInteger(t)) throw new e("INVALID_GEOMETRY", `${n} 必须为安全整数`);
+}
+function n(n, r) {
+	if (r <= 0n) throw new e("INVALID_GEOMETRY", "分母必须大于零");
+	let i = n < 0n ? -1n : 1n, a = n * i, o = Number(i * ((a + r / 2n) / r));
+	return t(o, "换算结果"), o;
+}
+var r = (e) => n(BigInt(e) * 25400n, 72000n), i = (e) => e * 72 / 25400, a = (e) => e / 1e3;
+// src/font.ts
+function o(t, n) {
+	if (!t || typeof t != "object" || Object.keys(t).some((e) => ![
+		"minSizeMpt",
+		"stepMpt",
+		"mode"
+	].includes(e)) || !Number.isSafeInteger(t.minSizeMpt) || t.minSizeMpt < 1e3 || t.minSizeMpt > 72e3 || t.stepMpt !== void 0 && (!Number.isSafeInteger(t.stepMpt) || t.stepMpt < 100 || t.stepMpt > 1e4) || t.mode !== void 0 && !["wrap", "single-line"].includes(t.mode) || n && t.minSizeMpt > n.sizeMpt) throw new e("TEXT_FIT_INVALID", "自适应最小字号需为 1–72 pt 且不大于初始字号，步长为 0.1–10 pt");
+}
+function s(t, n, r, i, a, s) {
+	if (!s) {
+		let e = x(t, n, i.sizeMpt, l(a, i), i.letterSpacingUm);
+		return {
+			lines: e,
+			style: _(i, a, e)
+		};
+	}
+	if (!Number.isSafeInteger(n) || !Number.isSafeInteger(r) || n < 1 || r < 1) throw new e("TEXT_FIT_INVALID", "文字自适应区域需为正整数");
+	o(s, i);
+	let c = s.stepMpt ?? 500, u = Math.floor((i.sizeMpt - s.minSizeMpt) / c), d = i.sizeMpt, f = (o) => {
+		let c = {
+			...i,
+			sizeMpt: o,
+			lineHeightMpt: Math.max(1e3, Math.round(i.lineHeightMpt * o / d))
+		}, u = l(a, c);
+		try {
+			let e = s.mode === "single-line" ? t.includes("\n") ? void 0 : [t] : x(t, n, o, u, c.letterSpacingUm);
+			return !e || e.some((e) => u.measure(e, o, c.letterSpacingUm) > n) || e.length * h(c, a, e.join("")).heightUm > r ? void 0 : {
+				lines: e,
+				style: _(c, a, e)
+			};
+		} catch (t) {
+			if (t instanceof e && t.code === "LAYOUT_OVERFLOW") return;
+			throw t;
+		}
+	}, p = f(d);
+	if (p) return p;
+	let m = 0, g = u, v;
+	for (; m <= g;) {
+		let e = Math.floor((m + g) / 2), t = f(s.minSizeMpt + e * c);
+		t ? (v = t, m = e + 1) : g = e - 1;
+	}
+	if (!v) throw new e("TEXT_FIT_FAILED", "缩到最小字号仍无法放入文字框，请增大尺寸或调整最小字号");
+	return v;
+}
+var c = "\"Microsoft YaHei\", \"PingFang SC\", \"Noto Sans CJK SC\", Arial, sans-serif", l = (e, t) => e.forStyle?.(t) ?? e;
+function u(t) {
+	if (!Number.isSafeInteger(t) || t < -5e3 || t > 2e4) throw new e("TEXT_SPACING_INVALID", "字距需为 -5–20 mm 的整数微米值");
+}
+var d = new Intl.Segmenter("und", { granularity: "grapheme" }), f = new Intl.Segmenter("und", { granularity: "word" }), p = (e) => Array.from(d.segment(e), (e) => e.segment), m = (e) => Array.from(f.segment(e), (e) => e.segment);
+function h(e, t, n = "") {
+	let r = l(t, e), i = n ? r.metrics?.(n, e.sizeMpt) : void 0, a = r.toUm(r.ascent - r.descent, e.sizeMpt), o = r.toUm(r.ascent, e.sizeMpt), s = a - o, c = i && i.ascentUm > o + 2 ? i.ascentUm : o, u = i && i.descentUm > s + 2 ? i.descentUm : s, d = Math.round(e.lineHeightMpt * 25400 / 72e3), f = r.system ? Math.max(d, c + u) : d;
+	return {
+		heightUm: f,
+		baselineUm: Math.round((f - c - u) / 2) + c
+	};
+}
+function g(e, t) {
+	return h(e, t).heightUm;
+}
+function _(e, t, n) {
+	let r = h(e, t, n.join("")).heightUm;
+	return r > g(e, t) ? {
+		...e,
+		lineHeightMpt: Math.ceil(r * 72e3 / 25400)
+	} : e;
+}
+function v(t) {
+	if (typeof t != "string" || !t.trim() || t.length > 256 || /[;{}<>\\()@:\u0000-\u001f]/u.test(t) || [
+		"inherit",
+		"initial",
+		"unset",
+		"revert",
+		"revert-layer"
+	].includes(t.trim().toLowerCase())) throw new e("FONT_FAMILY_INVALID", "字体名称需要 1–256 字，不能包含样式代码或控制字符；继承字体请留空");
+}
+var y = /^[，。！？：；、）》】」』,.!?;:)]$/u, b = /[（《【「『(\[]$/u;
+function x(t, n, r, i, a = 0) {
+	if (u(a), n <= 0) throw new e("LAYOUT_OVERFLOW", "文字可用宽度必须大于零");
+	let o = [];
+	for (let s of t.normalize("NFC").replace(/\r\n?/g, "\n").split("\n")) {
+		if (s === "") {
+			o.push("");
+			continue;
+		}
+		let t = "", c = m(s);
+		for (let s of c) if (!t && i.measure(s, r, a) <= n) t = s;
+		else if (t && i.measure(t + s, r, a) <= n) t += s;
+		else {
+			if (t && i.measure(s, r, a) <= n && !y.test(s)) {
+				let e = "";
+				if (b.test(t)) {
+					let n = p(t);
+					e = n.pop(), t = n.join("");
+				}
+				t && o.push(t.replace(/[ \t]+$/u, "")), t = e;
+			}
+			for (let c of p(s)) {
+				if (i.measure(c, r, a) > n) throw new e("LAYOUT_OVERFLOW", `单字宽度超过文字框：${c}`);
+				if (t && i.measure(t + c, r, a) > n) {
+					let s = "";
+					if (y.test(c) || b.test(t)) {
+						let e = p(t);
+						s = e.pop(), t = e.join("");
+					}
+					if (t && o.push(t.replace(/[ \t]+$/u, "")), t = s, i.measure(t + c, r, a) > n) throw new e("LAYOUT_OVERFLOW", "标点禁则需要更宽的文字框");
+				}
+				t += c;
+			}
+		}
+		t && o.push(t.replace(/[ \t]+$/u, ""));
+	}
+	return o;
+}
+export { a as _, p as a, m as c, u as d, x as f, n as g, r as h, _ as i, o as l, t as m, s as n, h as o, e as p, l as r, g as s, c as t, v as u, i as v };

package/dist/font-file.d.ts

@@ -0,0 +1,18 @@
+/** Opt-in historical file-font adapter. Web uses BrowserFont instead. */
+export declare class PrintFont {
+    readonly bytes: Uint8Array;
+    readonly sha256: string;
+    readonly id = "font.body";
+    readonly family: string;
+    readonly unitsPerEm: number;
+    readonly ascent: number;
+    readonly descent: number;
+    private readonly font;
+    constructor(bytes: Uint8Array, sha256: string);
+    glyph(char: string): {
+        id: number;
+        advance: number;
+    };
+    toUm(fontUnits: number, sizeMpt: number): number;
+    measure(text: string, sizeMpt: number, letterSpacingUm?: number): number;
+}

package/dist/font-file.js

@@ -0,0 +1,45 @@
+import { a as e, g as t, p as n } from "./font-ToGNY599.js";
+import r from "@pdf-lib/fontkit";
+// src/font-file.ts
+var i = class {
+	bytes;
+	sha256;
+	id = "font.body";
+	family;
+	unitsPerEm;
+	ascent;
+	descent;
+	font;
+	constructor(e, t) {
+		if (this.bytes = e, this.sha256 = t, e.length < 12) throw new n("FONT_INVALID", "字体文件头不完整");
+		let i = new DataView(e.buffer, e.byteOffset, e.byteLength), a = String.fromCharCode(...e.subarray(0, 4));
+		if (a !== "OTTO" && a !== "true" && i.getUint32(0) !== 65536) throw new n("FONT_INVALID", "W2 支持独立 OTF/CFF1 和 TTF 字体，不支持字体集合");
+		let o = i.getUint16(4);
+		if (12 + o * 16 > e.length) throw new n("FONT_INVALID", "字体目录不完整");
+		for (let t = 0; t < o; t++) {
+			let r = 12 + t * 16, a = String.fromCharCode(...e.subarray(r, r + 4));
+			if (a === "fvar" || a === "CFF2") throw new n("FONT_UNSUPPORTED", "可变字体和 CFF2 留待后续 profile 实现");
+			if (i.getUint32(r + 8) + i.getUint32(r + 12) > e.length) throw new n("FONT_INVALID", "字体表越界");
+		}
+		this.font = r.create(e), this.family = this.font.familyName ?? "Noto Sans CJK SC", this.unitsPerEm = this.font.unitsPerEm, this.ascent = this.font.ascent, this.descent = this.font.descent;
+	}
+	glyph(e) {
+		let t = e.codePointAt(0);
+		if (!this.font.hasGlyphForCodePoint(t)) throw new n("FONT_GLYPH_MISSING", `字体缺字：${e} U+${t.toString(16).toUpperCase()}`);
+		if (!/^[\p{Script=Latin}\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Number}\p{Punctuation}\p{Symbol} ]$/u.test(e)) throw new n("W0_UNSUPPORTED_SHAPING", `W0 不支持该字符的 shaping：U+${t.toString(16).toUpperCase()}`);
+		let r = this.font.glyphForCodePoint(t);
+		return {
+			id: r.id,
+			advance: r.advanceWidth
+		};
+	}
+	toUm(e, n) {
+		return t(BigInt(e) * BigInt(n) * 25400n, BigInt(this.unitsPerEm) * 72000n);
+	}
+	measure(t, n, r = 0) {
+		let i = 0;
+		for (let e of t.normalize("NFC")) i += this.glyph(e).advance;
+		return Math.max(0, this.toUm(i, n) + e(t.normalize("NFC")).length * r);
+	}
+};
+export { i as PrintFont };

package/dist/font.d.ts

@@ -0,0 +1,44 @@
+import type { TextStyle, TextAutoFit } from './protocol.js';
+export declare function validateAutoFit(policy: TextAutoFit, style?: TextStyle): void;
+/** Bounded, quantized binary search; a failed minimum size never truncates content. */
+export declare function fitText(text: string, widthUm: number, heightUm: number, style: TextStyle, font: TextFont, policy?: TextAutoFit): {
+    lines: string[];
+    style: TextStyle;
+};
+export declare const DEFAULT_FONT_FAMILY = "\"Microsoft YaHei\", \"PingFang SC\", \"Noto Sans CJK SC\", Arial, sans-serif";
+/** Layout consumes measurements; Web implementations resolve installed browser fonts. */
+export interface TextFont {
+    readonly id: string;
+    readonly family: string;
+    readonly sha256: string;
+    readonly unitsPerEm: number;
+    readonly ascent: number;
+    readonly descent: number;
+    readonly system?: boolean;
+    glyph(char: string): {
+        id: number;
+        advance: number;
+    };
+    toUm(units: number, sizeMpt: number): number;
+    measure(text: string, sizeMpt: number, letterSpacingUm?: number): number;
+    metrics?(text: string, sizeMpt: number): {
+        ascentUm: number;
+        descentUm: number;
+    };
+    forStyle?(style: Partial<TextStyle>): TextFont;
+}
+export declare const fontForStyle: (font: TextFont, style: Partial<TextStyle>) => TextFont;
+export declare function validateLetterSpacing(value: unknown): asserts value is number;
+/** Extended grapheme clusters keep combining marks, emoji ZWJ and Indic conjuncts intact. */
+export declare const textGraphemes: (text: string) => string[];
+export declare const textWords: (text: string) => string[];
+export declare function textLineBox(style: TextStyle, font: TextFont, text?: string): {
+    heightUm: number;
+    baselineUm: number;
+};
+export declare function textLineHeight(style: TextStyle, font: TextFont): number;
+/** Freeze the measured fallback-font line box before pagination or a row is split. */
+export declare function measuredTextStyle(style: TextStyle, font: TextFont, lines: readonly string[]): TextStyle;
+export declare function validateFontFamily(value: unknown): asserts value is string;
+/** Word boundaries use the runtime Unicode dictionary; emergency wrapping never splits a grapheme. */
+export declare function wrapText(text: string, widthUm: number, sizeMpt: number, font: TextFont, letterSpacingUm?: number): string[];

package/dist/formatting.d.ts

@@ -0,0 +1,8 @@
+import { Decimal } from 'decimal.js';
+export declare function decimalInput(value: unknown): Decimal;
+export declare function decimalScale(value: unknown): number;
+export declare function roundMode(value: unknown): void;
+export declare const DATE_PATTERNS: readonly ["yyyy-MM-dd", "yyyy/MM/dd", "yyyy年MM月dd日", "yyyy-MM-dd HH:mm", "yyyy-MM-dd HH:mm:ss", "HH:mm", "HH:mm:ss"];
+export declare function formatDate(value: unknown, pattern: unknown): string;
+/** RMB, rounded to cents away from zero at a tie; up to 999999999999.99 after rounding. */
+export declare function formatMoneyUpper(value: unknown): string;

package/dist/functions.d.ts

@@ -0,0 +1,22 @@
+import type { PrintRegistry } from './plugins.js';
+export declare const FUNCTION_NAME_PATTERN: RegExp;
+export interface PrintFunction {
+    id: string;
+    label: string;
+    capability: string;
+    minArgs: number;
+    maxArgs: number;
+    /** JSON Schema for the argument array, validated before executing host code. */
+    argsSchema?: Record<string, unknown>;
+    maxInputChars?: number;
+    maxOutputChars?: number;
+    /** Synchronous host code. Arguments are private, recursively frozen JSON copies. */
+    execute: (args: readonly unknown[]) => unknown;
+}
+export interface FunctionSignature {
+    min: number;
+    max: number;
+    capability: string;
+}
+export declare function executePrintFunction(def: PrintFunction, args: unknown[]): unknown;
+export declare function customFunctionSignature(id: string, registry?: PrintRegistry): FunctionSignature | undefined;

package/dist/html.d.ts

@@ -0,0 +1,19 @@
+import type { TextStyle, ImageResource, PathShape } from './protocol.js';
+import type { RichTextContent } from './rich-text.js';
+export interface ConversionIssue {
+    code: string;
+    message: string;
+}
+export declare function parseColor(value: string): string | null;
+export declare function htmlToRichText(html: string, options?: {
+    style?: TextStyle;
+    images?: readonly ImageResource[];
+}): {
+    content: RichTextContent;
+    images: ImageResource[];
+    issues: ConversionIssue[];
+};
+export declare function svgToPaths(svg: string): {
+    viewBox: [number, number, number, number];
+    paths: PathShape[];
+};

package/dist/imposition.d.ts

@@ -0,0 +1,4 @@
+import type { LabelImposition, LayoutDocument, Media } from './protocol.js';
+export declare function validateImposition(c: LabelImposition, media?: readonly Media[]): void;
+/** Translate whole logical label pages without scaling modules or their quiet zones. */
+export declare function imposeLabels(layout: LayoutDocument, c?: LabelImposition): LayoutDocument;