@ym-print/core 0.1.0-rc.1 → 0.1.0-rc.3

package/README.md

@@ -47,7 +47,7 @@ Web 页面可使用 `@ym-print/renderer-dom` 的 `BrowserFont` 作为测量器
 | --- | --- |
 | 字段路径 | JSON Pointer，例如 `/supplier/name` |
 | 表格数据 | 列值使用行作用域，数组来源由模板指定 |
-| 金额 | 使用十进制字符串，例如 `"12.35"` |
+| 金额 | 内部使用十进制字符串，例如 `"12.35"`；业务输入中的小数 `number` 在入口自动转换，安全整数保持不变 |
 | 坐标与尺寸 | 微米，`1000 μm = 1 mm` |
 | 字号 | 毫点，`1000 mpt = 1 pt` |
 | 旋转 | 毫度，`1000 mdeg = 1°` |

package/THIRD_PARTY_NOTICES.md

@@ -1,6 +1,6 @@
 # Third-party notices
 
-@ym-print/core 0.1.0-rc.1 — original code: UNLICENSED.
+@ym-print/core 0.1.0-rc.3 — original code: UNLICENSED.
 
 Bundled code and external packages keep their original licenses. Optional peers are loaded through their documented opt-in entry.
 
@@ -16,4 +16,5 @@ Bundled code and external packages keep their original licenses. Optional peers
 | 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) |
+| re2js@2.9.1 | MIT | external | [LICENSE](third-party-licenses/re2js@2.9.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

@@ -1,6 +1,6 @@
 {
   "package": "@ym-print/core",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.0-rc.3",
   "license": "UNLICENSED",
   "licenseScope": "original YmPrintUnit code only",
   "dependencies": [
@@ -132,6 +132,18 @@
         }
       ]
     },
+    {
+      "name": "re2js",
+      "version": "2.9.1",
+      "license": "MIT",
+      "kind": "external",
+      "notices": [
+        {
+          "path": "third-party-licenses/re2js@2.9.1/LICENSE",
+          "sha256": "b80a94f2c3c0b8bd6af849511cef624ad9feecbc0151d08bacad86ebab4cb46e"
+        }
+      ]
+    },
     {
       "name": "require-from-string",
       "version": "2.0.2",

package/dist/advanced-elements.d.ts

@@ -3,4 +3,4 @@ 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];
+export declare const advancedElements: readonly [ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin];

package/dist/data.d.ts

@@ -2,6 +2,7 @@ import type { Template, RuntimeInputs, EvalContext, NamedDataSources } from './p
 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;
+/** Runtime inputs normalize fractional numbers to plain decimal strings in a private snapshot. */
 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;

package/dist/font-file.js

@@ -1,4 +1,4 @@
-import { a as e, g as t, p as n } from "./font-ToGNY599.js";
+import { a as e, h as t, v as n } from "./font-hkKjjlzV.js";
 import r from "@pdf-lib/fontkit";
 // src/font-file.ts
 var i = class {
@@ -10,31 +10,31 @@ var i = class {
 	ascent;
 	descent;
 	font;
-	constructor(e, t) {
-		if (this.bytes = e, this.sha256 = t, e.length < 12) throw new n("FONT_INVALID", "字体文件头不完整");
+	constructor(e, n) {
+		if (this.bytes = e, this.sha256 = n, e.length < 12) throw new t("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 字体，不支持字体集合");
+		if (a !== "OTTO" && a !== "true" && i.getUint32(0) !== 65536) throw new t("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", "字体表越界");
+		if (12 + o * 16 > e.length) throw new t("FONT_INVALID", "字体目录不完整");
+		for (let n = 0; n < o; n++) {
+			let r = 12 + n * 16, a = String.fromCharCode(...e.subarray(r, r + 4));
+			if (a === "fvar" || a === "CFF2") throw new t("FONT_UNSUPPORTED", "可变字体和 CFF2 留待后续 profile 实现");
+			if (i.getUint32(r + 8) + i.getUint32(r + 12) > e.length) throw new t("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);
+		let n = e.codePointAt(0);
+		if (!this.font.hasGlyphForCodePoint(n)) throw new t("FONT_GLYPH_MISSING", `字体缺字：${e} U+${n.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 t("W0_UNSUPPORTED_SHAPING", `W0 不支持该字符的 shaping：U+${n.toString(16).toUpperCase()}`);
+		let r = this.font.glyphForCodePoint(n);
 		return {
 			id: r.id,
 			advance: r.advanceWidth
 		};
 	}
-	toUm(e, n) {
-		return t(BigInt(e) * BigInt(n) * 25400n, BigInt(this.unitsPerEm) * 72000n);
+	toUm(e, t) {
+		return n(BigInt(e) * BigInt(t) * 25400n, BigInt(this.unitsPerEm) * 72000n);
 	}
 	measure(t, n, r = 0) {
 		let i = 0;

package/dist/font-hkKjjlzV.js

@@ -0,0 +1,153 @@
+// 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, o = {
+	valueChars: 1e5,
+	layoutChars: 2e6,
+	measureChars: 5e6,
+	lines: 1e4
+};
+function s(t) {
+	if (t.length > o.valueChars) throw new e("EXPR_LIMIT", "单段文字超过 10 万字符");
+	return t;
+}
+// src/font.ts
+function c(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 l(t, n, r, i, a, o) {
+	if (s(t), !o) {
+		let e = C(t, n, i.sizeMpt, d(a, i), i.letterSpacingUm);
+		return {
+			lines: e,
+			style: y(i, a, e)
+		};
+	}
+	if (!Number.isSafeInteger(n) || !Number.isSafeInteger(r) || n < 1 || r < 1) throw new e("TEXT_FIT_INVALID", "文字自适应区域需为正整数");
+	c(o, i);
+	let l = o.stepMpt ?? 500, u = Math.floor((i.sizeMpt - o.minSizeMpt) / l), f = i.sizeMpt, p = (s) => {
+		let c = {
+			...i,
+			sizeMpt: s,
+			lineHeightMpt: Math.max(1e3, Math.round(i.lineHeightMpt * s / f))
+		}, l = d(a, c);
+		try {
+			let e = o.mode === "single-line" ? t.includes("\n") ? void 0 : [t] : C(t, n, s, l, c.letterSpacingUm);
+			return !e || e.some((e) => l.measure(e, s, c.letterSpacingUm) > n) || e.length * _(c, a, e.join("")).heightUm > r ? void 0 : {
+				lines: e,
+				style: y(c, a, e)
+			};
+		} catch (t) {
+			if (t instanceof e && t.code === "LAYOUT_OVERFLOW") return;
+			throw t;
+		}
+	}, m = p(f);
+	if (m) return m;
+	let h = 0, g = u, v;
+	for (; h <= g;) {
+		let e = Math.floor((h + g) / 2), t = p(o.minSizeMpt + e * l);
+		t ? (v = t, h = e + 1) : g = e - 1;
+	}
+	if (!v) throw new e("TEXT_FIT_FAILED", "缩到最小字号仍无法放入文字框，请增大尺寸或调整最小字号");
+	return v;
+}
+var u = "\"Microsoft YaHei\", \"PingFang SC\", \"Noto Sans CJK SC\", Arial, sans-serif", d = (e, t) => e.forStyle?.(t) ?? e;
+function f(t) {
+	if (!Number.isSafeInteger(t) || t < -5e3 || t > 2e4) throw new e("TEXT_SPACING_INVALID", "字距需为 -5–20 mm 的整数微米值");
+}
+var p = new Intl.Segmenter("und", { granularity: "grapheme" }), m = new Intl.Segmenter("und", { granularity: "word" }), h = (e) => Array.from(p.segment(s(e)), (e) => e.segment), g = (e) => Array.from(m.segment(s(e)), (e) => e.segment);
+function _(e, t, n = "") {
+	let r = d(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, l = i && i.descentUm > s + 2 ? i.descentUm : s, u = Math.round(e.lineHeightMpt * 25400 / 72e3), f = r.system ? Math.max(u, c + l) : u;
+	return {
+		heightUm: f,
+		baselineUm: Math.round((f - c - l) / 2) + c
+	};
+}
+function v(e, t) {
+	return _(e, t).heightUm;
+}
+function y(e, t, n) {
+	let r = _(e, t, n.join("")).heightUm;
+	return r > v(e, t) ? {
+		...e,
+		lineHeightMpt: Math.ceil(r * 72e3 / 25400)
+	} : e;
+}
+function b(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 x = /^[，。！？：；、）》】」』,.!?;:)]$/u, S = /[（《【「『(\[]$/u;
+function C(t, n, r, i, a = 0) {
+	s(t);
+	let c = o.measureChars, l = (t) => {
+		if ((c -= t.length) < 0) throw new e("TEXT_LIMIT", "文字测量工作量超过限制，请缩短内容或减小文字框宽度");
+		return i.measure(t, r, a);
+	};
+	if (f(a), n <= 0) throw new e("LAYOUT_OVERFLOW", "文字可用宽度必须大于零");
+	let u = [], d = (t) => {
+		if (u.length >= o.lines) throw new e("TEXT_LIMIT", "单段文字超过 10000 行");
+		u.push(t);
+	};
+	for (let r of t.normalize("NFC").replace(/\r\n?/g, "\n").split("\n")) {
+		if (r === "") {
+			d("");
+			continue;
+		}
+		let t = "", i = g(r);
+		for (let r of i) if (!t && l(r) <= n) t = r;
+		else if (t && l(t + r) <= n) t += r;
+		else {
+			if (t && l(r) <= n && !x.test(r)) {
+				let e = "";
+				if (S.test(t)) {
+					let n = h(t);
+					e = n.pop(), t = n.join("");
+				}
+				t && d(t.replace(/[ \t]+$/u, "")), t = e;
+			}
+			for (let i of h(r)) {
+				if (l(i) > n) throw new e("LAYOUT_OVERFLOW", `单字宽度超过文字框：${i}`);
+				if (t && l(t + i) > n) {
+					let r = "";
+					if (x.test(i) || S.test(t)) {
+						let e = h(t);
+						r = e.pop(), t = e.join("");
+					}
+					if (t && d(t.replace(/[ \t]+$/u, "")), t = r, l(t + i) > n) throw new e("LAYOUT_OVERFLOW", "标点禁则需要更宽的文字框");
+				}
+				t += i;
+			}
+		}
+		t && d(t.replace(/[ \t]+$/u, ""));
+	}
+	return u;
+}
+export { r as _, h as a, i as b, g as c, f as d, C as f, t as g, e as h, y as i, c as l, s as m, l as n, _ as o, o as p, d as r, v as s, u as t, b as u, n as v, a as y };

package/dist/geometry.d.ts

@@ -0,0 +1,14 @@
+import type { PrintNode } from './protocol.js';
+export interface FrameBounds {
+    xUm: number;
+    yUm: number;
+    widthUm: number;
+    heightUm: number;
+}
+/** Axis-aligned extent after rotating a box around the renderer's pivot. */
+export declare function rotateBounds(bounds: FrameBounds, rotationMdeg?: number, pivot?: {
+    xUm: number;
+    yUm: number;
+}): FrameBounds;
+/** Content can grow below the frame, while rotation still uses the original frame center. */
+export declare function nodeFrameBounds(node: PrintNode, heightUm?: number): FrameBounds;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './protocol.js';
+export * from './geometry.js';
 export * from './expression.js';
 export * from './font.js';
 export * from './plugins.js';
@@ -18,6 +19,8 @@ export * from './vector.js';
 export * from './advanced-elements.js';
 export * from './imposition.js';
 export * from './stamp.js';
+export * from './print-time.js';
 export * from './functions.js';
 export * from './html.js';
 export * from './composite-cell.js';
+export { TEXT_LIMITS } from './text-limits.js';