@worm-vue3-print/core 1.2.2 → 1.3.0

package/dist/node/index.d.cts

@@ -0,0 +1,6 @@
+import { Z as ExecutorBundle } from '../driver-CsWkGK4a.cjs';
+
+/** 读取 core 自带的 DOM 执行器 IIFE 产物；宿主把它注入页面后即可调用 __wormDom */
+declare function loadExecutorBundle(): ExecutorBundle;
+
+export { loadExecutorBundle };

package/dist/node/index.d.ts

@@ -0,0 +1,6 @@
+import { Z as ExecutorBundle } from '../driver-CsWkGK4a.js';
+
+/** 读取 core 自带的 DOM 执行器 IIFE 产物；宿主把它注入页面后即可调用 __wormDom */
+declare function loadExecutorBundle(): ExecutorBundle;
+
+export { loadExecutorBundle };

package/dist/node/index.js

@@ -0,0 +1,10 @@
+// src/node/index.ts
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+var EXECUTOR_FILE = new URL("../dom-executor.iife.global.js", import.meta.url);
+function loadExecutorBundle() {
+  return { source: readFileSync(fileURLToPath(EXECUTOR_FILE), "utf8"), version: "2" };
+}
+export {
+  loadExecutorBundle
+};

package/dist/ports-B63x7kCX.d.ts

@@ -0,0 +1,102 @@
+import { G as TextFit, a as CodeSpec, L as ViewportPx, R as RawMeasurement, Q as PdfTargetSpec, X as ScreenshotTargetSpec } from './driver-CsWkGK4a.js';
+
+/** 自动缩小的默认下限字号（pt） */
+declare const DEFAULT_SHRINK_MIN_FONT_SIZE_PT = 6;
+/** 自动缩小的绝对下限（pt）：低于此值已不可读，直接退化为截断 */
+declare const MIN_SHRINK_FONT_SIZE_PT = 1;
+/** 元素级显示形式：未配置时按元素类型取默认（text=截断、longText=自适应行高） */
+declare function resolveElementTextFit(type: string, opts?: {
+    textFit?: TextFit;
+} | undefined): TextFit;
+/** 单元格级显示形式：未配置时「不换行→截断，否则自适应行高」（与既有行为一致） */
+declare function resolveCellTextFit(cell?: {
+    textFit?: string;
+    wordWrap?: boolean;
+} | undefined): TextFit;
+/** 自动缩小的下限字号（pt）；非法值或缺省回落到默认值 */
+declare function resolveShrinkMinFontSize(pt?: number | undefined): number;
+/** 字号保留两位小数（渲染与回写统一口径，避免长浮点写进模板） */
+declare function roundFontSize(pt: number): number;
+/**
+ * 字号向下取到两位小数：自动缩小只能取「已确认放得下」的字号，
+ * 四舍五入可能把字号放大到溢出，故一律向下取整。
+ */
+declare function floorFontSize(pt: number): number;
+/** 自动缩小结果：key = 元素 id，或 `元素id#行类别#行:列` */
+interface FitFontSize {
+    key: string;
+    fontSizePt: number;
+}
+/** 单元格自动缩小的行类别：b=正文渲染行 / st=当前页小计行 / sm=整表汇总行 */
+type CellFitRowKind = 'b' | 'st' | 'sm';
+/** 单元格自动缩小结果的 key（元素级 key 不含 '#'） */
+declare function cellFitKey(elementId: string, kind: CellFitRowKind, rowIndex: number, colIndex: number): string;
+/** 解析单元格自动缩小结果的 key；元素级 key 返回 undefined */
+declare function parseCellFitKey(key: string): {
+    elementId: string;
+    kind: CellFitRowKind;
+    rowIndex: number;
+    colIndex: number;
+} | undefined;
+/** 边框宽度（pt，可缺省）；结构上兼容 RenderCellBorders 与 TableCellBorders */
+type BorderLike = {
+    width?: number;
+} | undefined;
+interface FitCellLike {
+    rowspan?: number;
+    colspan?: number;
+    padding?: number;
+    borders?: {
+        top?: BorderLike;
+        right?: BorderLike;
+        bottom?: BorderLike;
+        left?: BorderLike;
+    } | undefined;
+}
+/**
+ * 单元格「可用内容宽度」（mm）：所跨列宽之和，扣除左右内边距与塌陷边框占位。
+ * 与 `cellFitCapMm`（高度）同一口径：table-layout:fixed + border-collapse:collapse。
+ * 条形码点对齐需要单元格的真实可用宽度，设计器画布复用同一函数。
+ * 列宽缺失（表格未配置 tableColWidths）时返回 0，调用方据此不启用点对齐。
+ */
+declare function cellFitWidthMm(colWidths: number[], colIndex: number, cell: FitCellLike | undefined, defaultPadding?: number): number;
+/**
+ * 单元格「可用内容高度」（mm）：所跨行高之和，扣除上下内边距与塌陷边框占位。
+ * 截断形式据此设 max-height，自动缩小据此判定是否放得下。
+ * 与渲染端（tbody 行高）保持同一口径，设计器画布复用同一函数。
+ */
+declare function cellFitCapMm(rows: Array<{
+    height?: number;
+}>, rowIndex: number, cell: FitCellLike | undefined, defaultPadding?: number): number;
+
+/** 会话预算：PrintJob 天然满足本结构；print.submitHtml 这类无模板直出图场景也可直接传入 */
+interface SessionBudget {
+    timeoutMs?: number;
+    readinessMs?: number;
+}
+/** 测量结果：原始几何 + 自动缩小算出的最终字号（需回写模板后再出最终 HTML） */
+interface MeasureResult {
+    measurements: RawMeasurement[];
+    fits: FitFontSize[];
+}
+/** 一次任务内的文档槽位会话；方法内部已完成超时与错误归一化 */
+interface PrintSession {
+    /** 码值 → SVG 映射；specs 为空时直接返回空 Map，不触碰宿主 */
+    renderCodes(specs: CodeSpec[]): Promise<Map<string, string>>;
+    /**
+     * 测量：载入测量趟 HTML → 自动缩小（data-fit="shrink"）→ 读取元素/行高。
+     * 自动缩小结果随测量一并返回，供调用方回写模板使最终趟与测量同口径。
+     */
+    measure(html: string, viewport: ViewportPx): Promise<MeasureResult>;
+    probeContentBottom(html: string, viewport: ViewportPx): Promise<number>;
+    toPdf(html: string, spec: PdfTargetSpec, viewport: ViewportPx): Promise<Uint8Array>;
+    toScreenshot(html: string, spec: ScreenshotTargetSpec, viewport: ViewportPx): Promise<Uint8Array>;
+}
+interface PrintRuntime {
+    /** 借用一个槽位跑完整个任务；退出时无论成败都释放 */
+    withSession<T>(budget: SessionBudget, fn: (session: PrintSession) => Promise<T>): Promise<T>;
+}
+declare const DEFAULT_TIMEOUT_MS = 30000;
+declare const DEFAULT_READINESS_MS = 5000;
+
+export { type CellFitRowKind as C, DEFAULT_SHRINK_MIN_FONT_SIZE_PT as D, type FitFontSize as F, MIN_SHRINK_FONT_SIZE_PT as M, type PrintRuntime as P, type SessionBudget as S, cellFitKey as a, cellFitWidthMm as b, cellFitCapMm as c, resolveElementTextFit as d, resolveShrinkMinFontSize as e, floorFontSize as f, roundFontSize as g, DEFAULT_READINESS_MS as h, DEFAULT_TIMEOUT_MS as i, type MeasureResult as j, type PrintSession as k, parseCellFitKey as p, resolveCellTextFit as r };

package/dist/ports-q934kIC7.d.cts

@@ -0,0 +1,102 @@
+import { G as TextFit, a as CodeSpec, L as ViewportPx, R as RawMeasurement, Q as PdfTargetSpec, X as ScreenshotTargetSpec } from './driver-CsWkGK4a.cjs';
+
+/** 自动缩小的默认下限字号（pt） */
+declare const DEFAULT_SHRINK_MIN_FONT_SIZE_PT = 6;
+/** 自动缩小的绝对下限（pt）：低于此值已不可读，直接退化为截断 */
+declare const MIN_SHRINK_FONT_SIZE_PT = 1;
+/** 元素级显示形式：未配置时按元素类型取默认（text=截断、longText=自适应行高） */
+declare function resolveElementTextFit(type: string, opts?: {
+    textFit?: TextFit;
+} | undefined): TextFit;
+/** 单元格级显示形式：未配置时「不换行→截断，否则自适应行高」（与既有行为一致） */
+declare function resolveCellTextFit(cell?: {
+    textFit?: string;
+    wordWrap?: boolean;
+} | undefined): TextFit;
+/** 自动缩小的下限字号（pt）；非法值或缺省回落到默认值 */
+declare function resolveShrinkMinFontSize(pt?: number | undefined): number;
+/** 字号保留两位小数（渲染与回写统一口径，避免长浮点写进模板） */
+declare function roundFontSize(pt: number): number;
+/**
+ * 字号向下取到两位小数：自动缩小只能取「已确认放得下」的字号，
+ * 四舍五入可能把字号放大到溢出，故一律向下取整。
+ */
+declare function floorFontSize(pt: number): number;
+/** 自动缩小结果：key = 元素 id，或 `元素id#行类别#行:列` */
+interface FitFontSize {
+    key: string;
+    fontSizePt: number;
+}
+/** 单元格自动缩小的行类别：b=正文渲染行 / st=当前页小计行 / sm=整表汇总行 */
+type CellFitRowKind = 'b' | 'st' | 'sm';
+/** 单元格自动缩小结果的 key（元素级 key 不含 '#'） */
+declare function cellFitKey(elementId: string, kind: CellFitRowKind, rowIndex: number, colIndex: number): string;
+/** 解析单元格自动缩小结果的 key；元素级 key 返回 undefined */
+declare function parseCellFitKey(key: string): {
+    elementId: string;
+    kind: CellFitRowKind;
+    rowIndex: number;
+    colIndex: number;
+} | undefined;
+/** 边框宽度（pt，可缺省）；结构上兼容 RenderCellBorders 与 TableCellBorders */
+type BorderLike = {
+    width?: number;
+} | undefined;
+interface FitCellLike {
+    rowspan?: number;
+    colspan?: number;
+    padding?: number;
+    borders?: {
+        top?: BorderLike;
+        right?: BorderLike;
+        bottom?: BorderLike;
+        left?: BorderLike;
+    } | undefined;
+}
+/**
+ * 单元格「可用内容宽度」（mm）：所跨列宽之和，扣除左右内边距与塌陷边框占位。
+ * 与 `cellFitCapMm`（高度）同一口径：table-layout:fixed + border-collapse:collapse。
+ * 条形码点对齐需要单元格的真实可用宽度，设计器画布复用同一函数。
+ * 列宽缺失（表格未配置 tableColWidths）时返回 0，调用方据此不启用点对齐。
+ */
+declare function cellFitWidthMm(colWidths: number[], colIndex: number, cell: FitCellLike | undefined, defaultPadding?: number): number;
+/**
+ * 单元格「可用内容高度」（mm）：所跨行高之和，扣除上下内边距与塌陷边框占位。
+ * 截断形式据此设 max-height，自动缩小据此判定是否放得下。
+ * 与渲染端（tbody 行高）保持同一口径，设计器画布复用同一函数。
+ */
+declare function cellFitCapMm(rows: Array<{
+    height?: number;
+}>, rowIndex: number, cell: FitCellLike | undefined, defaultPadding?: number): number;
+
+/** 会话预算：PrintJob 天然满足本结构；print.submitHtml 这类无模板直出图场景也可直接传入 */
+interface SessionBudget {
+    timeoutMs?: number;
+    readinessMs?: number;
+}
+/** 测量结果：原始几何 + 自动缩小算出的最终字号（需回写模板后再出最终 HTML） */
+interface MeasureResult {
+    measurements: RawMeasurement[];
+    fits: FitFontSize[];
+}
+/** 一次任务内的文档槽位会话；方法内部已完成超时与错误归一化 */
+interface PrintSession {
+    /** 码值 → SVG 映射；specs 为空时直接返回空 Map，不触碰宿主 */
+    renderCodes(specs: CodeSpec[]): Promise<Map<string, string>>;
+    /**
+     * 测量：载入测量趟 HTML → 自动缩小（data-fit="shrink"）→ 读取元素/行高。
+     * 自动缩小结果随测量一并返回，供调用方回写模板使最终趟与测量同口径。
+     */
+    measure(html: string, viewport: ViewportPx): Promise<MeasureResult>;
+    probeContentBottom(html: string, viewport: ViewportPx): Promise<number>;
+    toPdf(html: string, spec: PdfTargetSpec, viewport: ViewportPx): Promise<Uint8Array>;
+    toScreenshot(html: string, spec: ScreenshotTargetSpec, viewport: ViewportPx): Promise<Uint8Array>;
+}
+interface PrintRuntime {
+    /** 借用一个槽位跑完整个任务；退出时无论成败都释放 */
+    withSession<T>(budget: SessionBudget, fn: (session: PrintSession) => Promise<T>): Promise<T>;
+}
+declare const DEFAULT_TIMEOUT_MS = 30000;
+declare const DEFAULT_READINESS_MS = 5000;
+
+export { type CellFitRowKind as C, DEFAULT_SHRINK_MIN_FONT_SIZE_PT as D, type FitFontSize as F, MIN_SHRINK_FONT_SIZE_PT as M, type PrintRuntime as P, type SessionBudget as S, cellFitKey as a, cellFitWidthMm as b, cellFitCapMm as c, resolveElementTextFit as d, resolveShrinkMinFontSize as e, floorFontSize as f, roundFontSize as g, DEFAULT_READINESS_MS as h, DEFAULT_TIMEOUT_MS as i, type MeasureResult as j, type PrintSession as k, parseCellFitKey as p, resolveCellTextFit as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worm-vue3-print/core",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "type": "module",
   "description": "打印模板表达式引擎、同构渲染管线与框架无关的设计器内核（HTML 生成/分页/数据绑定/设计器模型与工具），无 Vue/React 依赖",
   "main": "dist/index.cjs",
@@ -21,6 +21,12 @@
       "types": "./dist/browser/index.d.ts",
       "import": "./dist/browser/index.js",
       "require": "./dist/browser/index.cjs"
+    },
+    "./browser/dom-executor.iife": "./dist/dom-executor.iife.global.js",
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js",
+      "require": "./dist/node/index.cjs"
     }
   },
   "files": [
@@ -51,4 +57,4 @@
     "jsbarcode": "^3.12.3",
     "qrcode": "^1.5.4"
   }
-}
+}