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

package/dist/plugins.d.ts

@@ -16,11 +16,19 @@ export interface PluginFragment {
     spacing?: boolean;
 }
 export interface ElementPlugin {
+    /** Rewrite only declared static image references when a copied resource id collides. */
+    remapResources?: (payload: Record<string, unknown>, ids: Readonly<Record<string, string>>) => Record<string, unknown>;
+    /** True when resource ids can depend on runtime data rather than resources(payload). */
+    dynamicResources?: (payload: Record<string, unknown>) => boolean;
     paginate?: (payload: Record<string, unknown>, context: PluginLayoutContext) => PluginFragment[];
+    /** Page coordinates of the first placement, with per-page origins for repeated bands and fragments. */
     finalize?: (payload: Record<string, unknown>, context: PluginLayoutContext & {
-        pages: readonly Pick<LayoutPage, 'id' | 'widthUm' | 'heightUm'>[];
         xUm: number;
         yUm: number;
+        pages: ReadonlyArray<Pick<LayoutPage, 'id' | 'widthUm' | 'heightUm'> & {
+            xUm?: number;
+            yUm?: number;
+        }>;
     }) => {
         pageId: string;
         commands: DrawCommand[];
@@ -53,7 +61,7 @@ export declare class PrintRegistry {
     payload(id: string, value: Record<string, unknown>): Record<string, unknown>;
     capabilities(): string[];
 }
-export declare const builtinElements: readonly [ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin];
+export declare const builtinElements: readonly [ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin, ElementPlugin];
 export declare const defaultRegistry: PrintRegistry;
 export declare const createPrintRegistry: (elements?: readonly ElementPlugin[], functions?: readonly PrintFunction[]) => PrintRegistry;
 export declare function pluginContext(nodeId: string, data: EvalContext, font: TextFont, widthUm: number, heightUm: number): PluginLayoutContext;

package/dist/print-time.d.ts

@@ -0,0 +1,21 @@
+import type { TextStyle } from './protocol.js';
+import type { TextFont } from './font.js';
+import type { ElementPlugin } from './plugins.js';
+export interface PrintTimePayload {
+    prefix: string;
+    format: string;
+    style: TextStyle;
+}
+export declare const DEFAULT_PRINT_TIME_FORMAT = "yyyy-MM-dd HH-mm-ss";
+export declare const PRINT_TIME_FORMATS: readonly ["yyyy-MM-dd HH-mm-ss", "yyyy-MM-dd HH:mm:ss", "yyyy/MM/dd HH:mm:ss", "yyyy年MM月dd日 HH时mm分ss秒", "yyyyMMdd_HHmmss", "yyyy-MM-dd", "HH:mm:ss"];
+export declare const defaultPrintTime: PrintTimePayload;
+/** System-local wall time. Quoted literals allow formats such as yyyy-MM-dd'T'HH:mm:ss. */
+export declare function formatPrintTime(timestamp: number, format?: string): string;
+export declare function printTimeText(payload: PrintTimePayload, timestamp: number): string;
+export declare function measurePrintTime(payload: PrintTimePayload, baseFont: TextFont, widthUm: number, timestamp?: number): {
+    value: string;
+    style: TextStyle;
+    top: number;
+    height: number;
+};
+export declare const printTimePlugin: ElementPlugin;

package/dist/protocol.d.ts

@@ -410,6 +410,10 @@ export interface EvalContext {
     functionBudget?: {
         remaining: number;
     };
+    textBudget?: {
+        remaining: number;
+    };
+    printTime?: number;
 }
 export interface Transform {
     rotationMdeg: number;

package/dist/text-limits.d.ts

@@ -0,0 +1,8 @@
+export declare const TEXT_LIMITS: {
+    readonly valueChars: 100000;
+    readonly layoutChars: 2000000;
+    readonly measureChars: 5000000;
+    readonly lines: 10000;
+};
+/** Check before Unicode segmentation, normalization or font measurement allocates work. */
+export declare function boundedText(value: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ym-print/core",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.0-rc.3",
   "private": false,
   "type": "module",
   "exports": {
@@ -25,7 +25,8 @@
     "ajv": "8.20.0",
     "bwip-js": "4.11.4",
     "decimal.js": "10.6.0",
-    "parse5": "8.0.1"
+    "parse5": "8.0.1",
+    "re2js": "2.9.1"
   },
   "license": "UNLICENSED",
   "description": "Web print template protocol, data binding and deterministic layout engine",

package/third-party-licenses/re2js@2.9.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Oleksii Vasyliev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/font-ToGNY599.js

@@ -1,136 +0,0 @@
-// 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 };