@printstack/print-studio 0.0.0-stage → 0.1.1

package/locales/translations/zh-CN/elements.json.d.ts

@@ -0,0 +1,287 @@
+declare const _default: {
+  "barcodeElement": {
+    "code128Format": "CODE128（通用）",
+    "ean13Format": "EAN-13（商品码）",
+    "itf14Format": "ITF-14（物流码）",
+    "contentLabel": "编码内容",
+    "contentPlaceholder": "如 6901234567892，可绑定数据字段",
+    "formatLabel": "码制",
+    "displayValueLabel": "显示数值",
+    "valueFontSizeLabel": "数值字号",
+    "fontSizeUnit": "pt",
+    "quietZoneLabel": "静默区",
+    "distanceUnit": "mm",
+    "barcodeSection": "条形码",
+    "barColorLabel": "条形码颜色",
+    "transparentBackgroundHint": "清除颜色后背景透明",
+    "backgroundColorLabel": "背景色",
+    "colorSection": "颜色",
+    "invalidBarcode": "条形码内容无效",
+    "code39Format": "CODE39",
+    "ean8Format": "EAN-8",
+    "upcFormat": "UPC",
+    "itfFormat": "ITF",
+    "msiFormat": "MSI",
+    "pharmacodeFormat": "Pharmacode",
+    "codabarFormat": "Codabar"
+  },
+  "ellipseElement": {
+    "displayName": "圆形"
+  },
+  "imageElement": {
+    "sourceLabel": "图片来源",
+    "fitLabel": "填充方式",
+    "containOption": "完整显示",
+    "coverOption": "等比填满",
+    "stretchOption": "拉伸填满",
+    "imageSection": "图片"
+  },
+  "lineElement": {
+    "colorLabel": "颜色",
+    "strokeWidthLabel": "线宽",
+    "distanceUnit": "mm",
+    "strokeStyleLabel": "线型",
+    "solidOption": "实线",
+    "dashedOption": "虚线",
+    "dottedOption": "点线",
+    "lineSection": "线条"
+  },
+  "qrcodeElement": {
+    "lowCorrectionOption": "L（7%，容量大）",
+    "mediumCorrectionOption": "M（15%，常用）",
+    "highCorrectionOption": "H（30%，高容错）",
+    "contentLabel": "编码内容",
+    "contentPlaceholder": "URL 或任意文本，可绑定数据字段",
+    "correctionLevelLabel": "纠错级别",
+    "quietZoneLabel": "静默区",
+    "moduleUnit": "模块",
+    "qrCodeSection": "二维码",
+    "dotColorLabel": "码点颜色",
+    "backgroundColorLabel": "背景色",
+    "colorSection": "颜色",
+    "invalidContent": "二维码内容无效",
+    "quartileCorrectionOption": "Q（25%）",
+    "versionLabel": "码版本",
+    "versionHelp": "设为 0 时自动选择版本，也可指定 1 至 40。版本越高，可容纳的内容越多。",
+    "capacityHelp": "建议使用自动版本。指定版本容量不足时会自动提升，中文通常占用更多容量。",
+    "minimumVersionHelp": "当前内容在 {level} 纠错级别下至少需要版本 {version}。建议设为 0 自动选择，也可指定 {version} 至 40。容量不足时会自动提升版本。",
+    "boundCapacityHelp": "内容包含数据绑定，容量取决于实际数据。推荐码版本设为 0（自动）；固定版本需容纳绑定后的完整内容。",
+    "invalidVersion": "请输入整数版本：0 表示自动，1 至 40 表示指定版本。",
+    "emptyContent": "请输入编码内容。",
+    "capacityExceeded": "内容已超出当前纠错级别下版本 40 的容量，请缩短内容或降低纠错级别。",
+    "versionTooSmall": "当前码版本容量不足，请改为 0（自动）或至少 {version}。",
+    "versionAdjusted": "码版本 {previousVersion} 的容量不足，已自动调整为支持当前内容的最低版本 {version}。",
+    "logoHelp": "添加标志后，建议使用 H 纠错级别并保留足够的静默区。",
+    "logoSizeLabel": "标志大小",
+    "versionAutoOption": "自动",
+    "versionUnit": "版本",
+    "logoLabel": "标志图片",
+    "borderColorLabel": "外部边框颜色",
+    "borderWidthLabel": "外部边框宽度",
+    "borderUnit": "mm"
+  },
+  "rectElement": {
+    "borderRadiusLabel": "圆角半径",
+    "distanceUnit": "mm",
+    "displayName": "矩形"
+  },
+  "tableElement": {
+    "fixedRowsHelp": "开启后按指定行数分页；关闭后根据页面可用高度自动计算。",
+    "fixedRowsLabel": "固定每页行数",
+    "backgroundLabel": "表格背景",
+    "headerRowsLabel": "多级表头",
+    "positionModeLabel": "分页定位",
+    "positionFixedOption": "每页固定位置",
+    "positionFlowOption": "续页从顶部排列",
+    "mergeRulesLabel": "动态合并规则",
+    "mergeRuleTitle": "规则 {number}",
+    "mergeRuleColumns": "第 {columns} 列",
+    "mergeRuleNoColumns": "未选择列",
+    "mergeRuleSameValue": "按各列相同值",
+    "mergeRulesHint": "仅纵向合并相邻数据行，不影响表头。",
+    "mergeFieldsLabel": "分组字段",
+    "mergeFieldsHelp": "相邻行的所有分组字段值均相同且非空时合并；未设置分组字段时，各列按自身相同且非空的值分别合并。",
+    "mergeFieldsWarning": "相邻行的所有分组字段值均相同且非空时，所选列将合并。合并后仅显示首行的值，不保留其他行的不同内容，也不计算合计值。",
+    "mergeFieldsPlaceholder": "字段路径，多个字段用逗号分隔",
+    "mergeColumnsLabel": "要合并的列",
+    "mergeColumnsHelp": "例如：输入 1,2，表示分别对第 1 列和第 2 列执行纵向合并。",
+    "mergeColumnsPlaceholder": "列序号，从 1 开始，用逗号分隔",
+    "mergeFieldsOption": "字段组合",
+    "mergeAddLabel": "添加合并规则",
+    "mergeRemoveLabel": "删除合并规则",
+    "columnsLabel": "列与表头",
+    "columnsBindingHint": "绑定数组后，表格按打印数据生成，各列从绑定字段取值。",
+    "rowsLabel": "默认数据",
+    "tableSection": "表格",
+    "dataTab": "数据行",
+    "dataSection": "数据来源",
+    "dataPreviewLabel": "数据预览",
+    "dataPreviewUnbound": "请先绑定数组字段",
+    "dataPreviewEmpty": "暂无示例数据，请在数据源管理中添加。",
+    "nullTextLabel": "空值文本",
+    "nullTextPlaceholder": "单元格取值为空时显示",
+    "basicTab": "表体与样式",
+    "basicSection": "高度与行高",
+    "headerHeightSection": "表头高度",
+    "emptyValueSection": "空值处理",
+    "heightModeLabel": "高度模式",
+    "heightModeAutoOption": "自动（按行高）",
+    "heightModeFixedOption": "固定（压缩行高）",
+    "heightModeHint": "自动模式按内容计算行高，可跨页打印。固定模式将所有行压缩至设定高度。",
+    "minRowHeightLabel": "最小行高",
+    "columnsTab": "结构与列",
+    "showHeaderLabel": "显示表头",
+    "headerTab": "表头样式",
+    "headerBackgroundLabel": "表头背景",
+    "headerTextColorLabel": "表头文字颜色",
+    "headerHeightModeLabel": "表头高度",
+    "autoOption": "自动",
+    "fixedOption": "固定",
+    "headerHeightLabel": "固定高度",
+    "headerBoldLabel": "加粗",
+    "headerNormalOption": "常规",
+    "headerAlignLabel": "水平对齐",
+    "headerFollowColumnOption": "跟随列",
+    "headerVAlignLabel": "垂直对齐",
+    "topAlignOption": "顶部",
+    "middleAlignOption": "居中",
+    "bottomAlignOption": "底部",
+    "headerPaddingLabel": "内边距",
+    "headerWrapLabel": "自动换行",
+    "headerBottomBorderLabel": "表头底部边框",
+    "bordersLabel": "边框",
+    "fontFamilyLabel": "字体",
+    "fontSizeLabel": "字号",
+    "fontSizeUnit": "pt",
+    "textColorLabel": "文字颜色",
+    "borderColorLabel": "边框颜色",
+    "borderWidthLabel": "边框宽度",
+    "distanceUnit": "mm",
+    "cellPaddingLabel": "单元格内边距",
+    "stripedLabel": "隔行变色",
+    "stripeColorLabel": "隔行背景颜色",
+    "styleTab": "表格样式",
+    "styleSection": "样式",
+    "appearanceSection": "背景与边框",
+    "textStyleSection": "默认文字样式",
+    "cellStyleSection": "单元格样式",
+    "summaryStyleSection": "汇总行样式",
+    "summaryLayoutSection": "汇总行排版",
+    "summaryTab": "汇总行",
+    "headerPaginationSection": "表头分页",
+    "printTab": "打印与分页",
+    "crossPageLabel": "允许跨页",
+    "crossPageHelp": "仅在自动高度模式下生效。固定高度模式不跨页。",
+    "repeatHeaderLabel": "跨页重复表头",
+    "rowsPerPageLabel": "每页行数",
+    "rowsPerPageHint": "仅在固定行数模式下生效，取值为 1–500。",
+    "fillEmptyRowsLabel": "空白补行",
+    "fillEmptyRowsHelp": "数据行数少于每页设定行数时，自动添加空白行，使各页表格高度一致、底部对齐。",
+    "summaryEnabledLabel": "显示汇总行",
+    "summaryPositionLabel": "汇总位置",
+    "summaryTopOption": "表格顶部",
+    "summaryBottomOption": "表格底部",
+    "summaryScopeLabel": "显示页",
+    "summaryScopeEachPageOption": "每页",
+    "summaryScopeLastPageOption": "仅最后一页",
+    "summaryBoldLabel": "汇总行加粗",
+    "summaryColorLabel": "汇总文字颜色",
+    "summaryBackgroundLabel": "汇总背景颜色",
+    "summaryColumnsLabel": "汇总列配置",
+    "summaryDefaultLabel": "合计",
+    "defaultNameColumn": "名称",
+    "defaultQuantityColumn": "数量",
+    "defaultNotesColumn": "备注",
+    "sampleFirstRow": "示例数据 1",
+    "sampleSecondRow": "示例数据 2",
+    "rowsBindingFailed": "未找到表格绑定的数组「{bindingPath}」，已使用默认数据。",
+    "rowsUnboundWarning": "表格未绑定数组，将使用默认数据打印。可在「数据行」的「数据来源」中设置绑定。",
+    "fixedHeightWarning": "数据行较多，将压缩至固定高度。如需跨页或限制每页行数，请改用自动高度模式。",
+    "columnBindingFailed": "表格第 {rowNumber} 行未找到字段「{bindingPath}.{columnPath}」，已输出为空。",
+    "overflowSection": "明细超限附页",
+    "overflowEnabled": "启用附页",
+    "overflowIntroHint": "明细超过指定行数时，转到独立附页打印。",
+    "overflowHomeHint": "未超限时，原表格按当前设置输出。",
+    "overflowAllHint": "超限时，原页提示行撑满原明细区域，附页打印全部明细。",
+    "overflowRemainingHint": "超限时，原页保留前 {count} 行及提示，附页打印剩余明细。",
+    "overflowLayoutHint": "清单默认按布局自动分页，可在清单表格设置中调整样式、表头及分页。",
+    "overflowPaginationHint": "注意：已允许跨页，未超限也可能分页。",
+    "overflowFixedHeightHint": "注意：固定高度可能压缩行高；超限后保留原高度，内容过高时自动增高。",
+    "overflowRecommendedHint": "推荐：原单据需保持一页时，选自动高度、关闭允许跨页，并留足明细及提示行空间。",
+    "overflowThreshold": "行数上限",
+    "overflowMessage": "提示文字",
+    "overflowMessageAlign": "提示水平对齐",
+    "overflowMessageVAlign": "提示垂直对齐",
+    "overflowMessageDefault": "以明细为准",
+    "overflowScope": "附页内容",
+    "overflowAll": "全部明细",
+    "overflowRemaining": "仅超出部分",
+    "overflowLayout": "附页布局",
+    "overflowCapacityWarning": "原页面明细及提示行超出预留空间，请调整表格位置或行高，或关闭相关列的自动换行。",
+    "headerBordersLabel": "表头独立边框",
+    "summaryBordersSection": "汇总行边框"
+  },
+  "textElement": {
+    "lightWeightOption": "细体 300",
+    "normalWeightOption": "常规 400",
+    "mediumWeightOption": "中等 500",
+    "semiboldWeightOption": "半粗 600",
+    "boldWeightOption": "粗体 700",
+    "blackWeightOption": "特粗 900",
+    "contentLabel": "内容",
+    "contentPlaceholder": "输入文本，支持换行和 {'{'}{'{'} 数据字段 {'}'}{'}'} 绑定表达式",
+    "textSection": "文本",
+    "fontFamilyLabel": "字体",
+    "fontSizeLabel": "字号",
+    "fontSizeUnit": "pt",
+    "fontWeightLabel": "字重",
+    "italicLabel": "斜体",
+    "normalStyleOption": "常规",
+    "letterSpacingLabel": "字间距",
+    "lineHeightLabel": "行高倍数",
+    "horizontalAlignLabel": "水平对齐",
+    "leftAlignOption": "左",
+    "centerAlignOption": "居中",
+    "rightAlignOption": "右",
+    "justifyAlignOption": "两端",
+    "verticalAlignLabel": "垂直对齐",
+    "topAlignOption": "顶部",
+    "bottomAlignOption": "底部",
+    "textColorLabel": "文字颜色",
+    "transparentBackgroundHint": "清除颜色后背景透明",
+    "backgroundColorLabel": "背景色",
+    "decorationLabel": "装饰线",
+    "noDecorationOption": "无",
+    "underlineOption": "下划线",
+    "strikethroughOption": "删除线",
+    "alignmentAndColorSection": "对齐与颜色",
+    "paddingLabel": "内边距",
+    "distanceUnit": "mm",
+    "autoHeightHint": "编辑文本后，元素高度自动调整至适应内容",
+    "autoHeightLabel": "自动调整高度",
+    "layoutSection": "布局",
+    "defaultContent": "文本内容"
+  },
+  "barcodePreview": {
+    "invalidBarcode": "条形码内容无效"
+  },
+  "imagePreview": {
+    "loadFailed": "图片加载失败",
+    "missingSourceHint": "请在属性面板中添加图片"
+  },
+  "shapeProps": {
+    "noFillHint": "清除颜色后不填充",
+    "fillLabel": "填充",
+    "borderColorLabel": "边框",
+    "borderWidthLabel": "边框宽度",
+    "distanceUnit": "mm",
+    "borderStyleLabel": "边框线型",
+    "solidOption": "实线",
+    "dashedOption": "虚线",
+    "dottedOption": "点线",
+    "styleSection": "样式"
+  }
+}
+;
+
+export default _default;

package/locales/translations/zh-CN/parser.json.d.ts

@@ -0,0 +1,34 @@
+declare const _default: {
+  "htmlParser": {
+    "displayName": "网页打印（HTML）",
+    "emptyDocument": "导出失败：文档没有任何页面",
+    "emptyDocumentDetail": "文档没有任何页面，无法生成 HTML",
+    "elementRenderFailed": "[html-parser] 元素 {elementType}({elementId}) 渲染失败"
+  },
+  "index": {
+    "htmlParserNotRegistered": "HTML 解析器未注册",
+    "pdfParserNotRegistered": "PDF 解析器未注册"
+  },
+  "pdfParser": {
+    "displayName": "PDF 文档",
+    "emptyDocument": "导出失败：文档没有任何页面",
+    "emptyDocumentDetail": "文档没有任何页面，无法生成 PDF",
+    "elementSizeUnit": "mm",
+    "rotatedElementRasterizationFailed": "[pdf-parser] 旋转元素 {elementType}({elementId}) 光栅化失败",
+    "unrotatedFallback": "[pdf-parser] 旋转元素光栅化失败，退化为无旋转绘制",
+    "elementDrawFailed": "[pdf-parser] 元素 {elementType}({elementId}) 绘制失败",
+    "svgImageDecodeFailed": "SVG 光栅化图片解码失败"
+  },
+  "worker": {
+    "cancelled": "渲染任务已取消",
+    "timeout": "后台渲染超时，请重试或关闭 Worker 后重试",
+    "failed": "后台渲染进程异常，请重试",
+    "messageFailed": "后台渲染结果读取失败"
+  },
+  "types": {
+    "duplicateParser": "解析器 \"{parserId}\" 已注册"
+  }
+}
+;
+
+export default _default;

package/locales/types.d.ts

@@ -0,0 +1,8 @@
+export interface Translations {
+    [key: string]: string | Translations;
+}
+export type LocaleLoader = (locale: string) => Promise<Translations>;
+export interface LocaleStorage {
+    get(): null | string;
+    set(locale: string): void;
+}

package/locales/utils.d.ts

@@ -0,0 +1,5 @@
+import { Translations } from './types';
+export declare function isValidLocale(locale: unknown): locale is string;
+export declare function isTranslations(value: unknown): value is Translations;
+export declare function mergeTranslations(sources: Translations[]): Translations;
+export declare function hasTranslationMessages(messages: Translations): boolean;

package/mount-print-designer-BLgVZOnm.js

@@ -0,0 +1,50 @@
+import { n as e } from "./rolldown-runtime-QGRDbDUS.js";
+import { a as t, i as n, t as r } from "./studio-BFQYHZsg.js";
+import { t as i } from "./host-CuGR8rD6.js";
+import { t as a } from "./presets-D3WhkbZK.js";
+// src/designer/mount-print-designer.ts
+var o = /* @__PURE__ */ e({ mountPrintDesigner: () => c }), s = /* @__PURE__ */ new WeakMap();
+function c(e, o = {}) {
+	if (s.has(e)) throw Error("A designer is already mounted in this container");
+	if (typeof document > "u" || !(e instanceof HTMLElement)) throw Error("A designer requires an HTML container in a browser");
+	if (o.studio && n(o.studio).root) throw Error("A designer is already mounted for this studio");
+	let c = o.studio ?? r({
+		...o,
+		createDocument: o.createDocument ?? (() => a(o.presets))
+	}), l = !1, u, d = !1, f, p, m = new Promise((e, t) => {
+		f = e, p = t;
+	}), h = c.errors.subscribe((e) => {
+		l || o.onError?.(e.error);
+	}), g = {
+		ready: m,
+		studio: c,
+		unmount: x
+	}, _ = t(c, x), v = n(c);
+	function y() {
+		l || (d = !0, f());
+	}
+	function b(e) {
+		d || p(e), c.errors.capture(e, { source: "designer.mount" });
+	}
+	function x() {
+		l || (l = !0, h(), _(), d || p(new DOMException("Designer unmounted before ready", "AbortError")), u?.(), s.delete(e), o.studio || c.dispose());
+	}
+	m.catch(() => {}), s.set(e, g);
+	try {
+		return u = i(e, {
+			context: v,
+			"onDirty-change": o.onDirtyChange,
+			onDispose: x,
+			onError: b,
+			onReady: y,
+			plugins: o.plugins,
+			presets: o.presets,
+			settings: o.settings,
+			ui: o.ui,
+			zIndex: o.zIndex
+		}), g;
+	} catch (e) {
+		throw x(), e;
+	}
+}
+export { o as n, c as t };

package/mount-print-preview-D7M-1AqH.js

@@ -0,0 +1,65 @@
+import { P as e, t } from "./cloneDeep-PCw2ErRl.js";
+import { X as n } from "./registries-dZq8MewR.js";
+import { t as r } from "./host-CuGR8rD6.js";
+// src/designer/mount-print-preview.ts
+function i(i, a, o = {}) {
+	return n(async (n) => {
+		let s = i.store(), c = o.container ?? document.body, l = c.ownerDocument.createElement("div");
+		l.className = "print-studio-preview", l.style.cssText = o.container ? "width:100%;height:100%;position:relative" : "position:fixed;inset:0;z-index:2147483647";
+		let u = !1, d, f, p = [], m = () => {}, h;
+		function g() {
+			u || (u = !0, n.removeEventListener("abort", g), m(n.reason ?? new DOMException("Preview closed before ready", "AbortError")), d?.(), l.remove());
+		}
+		let _ = {
+			close: g,
+			get element() {
+				if (!f) throw Error("Preview is not ready");
+				return f;
+			},
+			get warnings() {
+				return p;
+			}
+		}, v = {
+			capture(e) {
+				return i.errors.capture(e, { source: "preview.render" });
+			},
+			close: g,
+			getSampleInput() {
+				return e(a.document);
+			},
+			name: a.document.name,
+			print(e) {
+				i.commands.dispatch("preview.print", e);
+			},
+			render(e, n) {
+				return s.rendering.html(t(a.document), t(e), void 0, n);
+			},
+			request: { previewInput: a.input },
+			revision: 0
+		};
+		try {
+			return h = i.output?.track(_) ?? _, n.addEventListener("abort", g, { once: !0 }), n.throwIfAborted(), c.append(l), await new Promise((e, t) => {
+				m = t, d = r(l, {
+					onDispose: g,
+					onError(e) {
+						t(e), i.errors.capture(e, { source: "preview.mount" });
+					},
+					onReady() {},
+					preview: {
+						onError: t,
+						onReady(t, n) {
+							f = t, p = n, e();
+						},
+						source: v,
+						timeoutMs: o.timeoutMs
+					}
+				});
+			}), n.throwIfAborted(), h;
+		} catch (e) {
+			throw g(), e;
+		} finally {
+			n.removeEventListener("abort", g);
+		}
+	}, o);
+}
+export { i as mountPrintPreview };

package/package.json

@@ -1,6 +1,48 @@
 {
+  "dependencies": {
+    "@vueuse/core": "^15.0.0",
+    "pinia": "^4.1.0",
+    "tdesign-icons-vue-next": "^0.4.12",
+    "vue": "^3.5.0",
+    "vue-i18n": "^11.4.18",
+    "jspdf": "^4.2.1",
+    "tdesign-vue-next": "^1.20.11"
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    },
+    "./core": {
+      "types": "./core/index.d.ts",
+      "import": "./core.js"
+    },
+    "./designer": {
+      "types": "./designer.d.ts",
+      "import": "./designer.js"
+    },
+    "./runtime": {
+      "types": "./runtime/print-renderer.d.ts",
+      "import": "./runtime.js"
+    },
+    "./saas": {
+      "types": "./plugins/saas/index.d.ts",
+      "import": "./saas.js"
+    },
+    "./style.css": "./style.css",
+    "./vue": {
+      "types": "./vue.d.ts",
+      "import": "./vue.js"
+    }
+  },
+  "files": [
+    "**/*"
+  ],
+  "main": "./index.js",
+  "module": "./index.js",
   "name": "@printstack/print-studio",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "sideEffects": true,
+  "type": "module",
+  "types": "./index.d.ts",
+  "version": "0.1.1"
+}

package/parser/html/html-parser.d.ts

@@ -0,0 +1,22 @@
+import { ElementRegistry } from '../../core/element-registry';
+import { RenderProgress } from '../../core/render/render-task';
+import { PrintDocument } from '../../core/types';
+import { DocumentParser } from '../types';
+export interface HtmlParseOptions {
+    fontCss?: string;
+    onProgress?: (progress: RenderProgress) => void;
+    onWarning?: (message: string) => void;
+    signal?: AbortSignal;
+    /** 生成的 <title> */
+    title?: string;
+    waitIfPaused?: () => Promise<void>;
+}
+export declare class HtmlParser implements DocumentParser<string, HtmlParseOptions> {
+    private elements;
+    readonly id = "html";
+    get label(): string;
+    constructor(elements?: ElementRegistry);
+    parse(document: PrintDocument, options?: HtmlParseOptions): Promise<string>;
+    private renderElement;
+    private renderPage;
+}

package/parser/index.d.ts

@@ -0,0 +1,28 @@
+import { PrintDocument } from '../core/types';
+import { HtmlParseOptions } from './html/html-parser';
+import { PdfParseOptions } from './pdf/pdf-parser';
+import { DocumentParser } from './types';
+export type { DocumentParser, HtmlParseOptions, PdfParseOptions };
+export { parserRegistry } from './registry';
+export { createRenderRuntime } from './render-runtime';
+export type { RenderExecutionOptions, RenderRuntime } from './render-runtime';
+export { buildSampleInput } from '../core/data-source';
+export { expandDocument } from '../core/document-expand';
+/** 文档 → 可直接 window.print() 的完整 HTML 字符串（不解析数据绑定，原始模板直出） */
+export declare function parseToHtml(document: PrintDocument, options?: HtmlParseOptions): Promise<string>;
+/** 文档 → PDF Blob（可直接下载 / 上传 / 打印，不解析数据绑定） */
+export declare function parseToPdfBlob(document: PrintDocument, options?: PdfParseOptions): Promise<Blob>;
+/**
+ * 打印渲染主入口：模板 + 打印输入 → 注入数据后的 HTML。
+ * 先经数据上下文展开（解析绑定表达式、物化循环区块），再交给 HTML 解析器，
+ * 返回展开告警（取值失败 / 格式化器未知等）供调用方提示。
+ */
+export declare function renderPrintTemplate(template: PrintDocument, input: Record<string, unknown>, options?: HtmlParseOptions): Promise<{
+    html: string;
+    warnings: string[];
+}>;
+/** 打印渲染主入口（PDF）：模板 + 打印输入 → PDF Blob */
+export declare function renderPrintTemplatePdf(template: PrintDocument, input: Record<string, unknown>, options?: PdfParseOptions): Promise<{
+    blob: Blob;
+    warnings: string[];
+}>;

package/parser/pdf/pdf-parser.d.ts

@@ -0,0 +1,23 @@
+import { ElementRegistry } from '../../core/element-registry';
+import { RenderProgress } from '../../core/render/render-task';
+import { PrintDocument } from '../../core/types';
+import { DocumentParser } from '../types';
+export interface PdfParseOptions {
+    fontCss?: string;
+    onProgress?: (progress: RenderProgress) => void;
+    onWarning?: (message: string) => void;
+    /** 光栅化密度（每毫米像素），默认 300dpi */
+    rasterPxPerMm?: number;
+    signal?: AbortSignal;
+    waitIfPaused?: () => Promise<void>;
+}
+export declare class PdfParser implements DocumentParser<Blob, PdfParseOptions> {
+    private elements;
+    readonly id = "pdf";
+    get label(): string;
+    constructor(elements?: ElementRegistry);
+    parse(document: PrintDocument, options?: PdfParseOptions): Promise<Blob>;
+    /** 旋转元素：同一份 toHtml 输出 → SVG foreignObject → Canvas → PDF */
+    private drawRotated;
+    private renderPage;
+}

package/parser/prepare-document.d.ts

@@ -0,0 +1,4 @@
+import { ExpandResult } from '../core/document-expand';
+import { ElementRegistry } from '../core/element-registry';
+import { PrintDocument } from '../core/types';
+export declare function prepareDocument(document: PrintDocument, input?: Record<string, unknown>, elements?: ElementRegistry): ExpandResult;

package/parser/prepare-resources.d.ts

@@ -0,0 +1,7 @@
+import { ElementRegistry } from '../core/element-registry';
+import { PrintFont } from '../core/render/fonts';
+import { PrintDocument } from '../core/types';
+export declare function prepareResources(document: PrintDocument, input: Record<string, unknown> | undefined, elements: ElementRegistry, fonts?: PrintFont[], signal?: AbortSignal, onWarning?: (message: string) => void): Promise<{
+    css: string;
+    dispose(): void;
+}> | undefined;

package/parser/registry.d.ts

@@ -0,0 +1,6 @@
+import { HtmlParser } from './html/html-parser';
+import { PdfParser } from './pdf/pdf-parser';
+import { ParserRegistry } from './types';
+export declare const builtinHtmlParser: HtmlParser;
+export declare const builtinPdfParser: PdfParser;
+export declare const parserRegistry: ParserRegistry;

package/parser/render-runtime.d.ts

@@ -0,0 +1,39 @@
+import { ElementRegistry } from '../core/element-registry';
+import { RenderProgress } from '../core/render/render-task';
+import { ResourceExecutionOptions } from '../core/render/resource-task';
+import { RuntimeConfig } from '../core/runtime-config';
+import { PrintDocument } from '../core/types';
+import { HtmlParseOptions } from './html/html-parser';
+import { PdfParseOptions } from './pdf/pdf-parser';
+import { ParserRegistry } from './types';
+import { RenderWorkerFactory } from './worker/worker-client';
+export interface RenderExecutionOptions extends ResourceExecutionOptions {
+    onProgress?: (progress: RenderProgress) => void;
+    waitIfPaused?: () => Promise<void>;
+}
+export interface RenderExecution {
+    backend: 'hybrid' | 'main' | 'worker';
+    durationMs: number;
+    reason?: 'custom-parser' | 'disabled' | 'element-capability' | 'unavailable';
+}
+export interface RenderRuntimeOptions {
+    config?: () => RuntimeConfig['rendering'];
+    createWorker?: RenderWorkerFactory;
+    elements?: ElementRegistry;
+    parsers?: ParserRegistry;
+    snapshot?: <Value>(value: Value) => Value;
+}
+export declare function createRenderRuntime(options?: RenderRuntimeOptions): {
+    dispose: () => void;
+    html: (document: PrintDocument, input?: Record<string, unknown>, parseOptions?: HtmlParseOptions, execution?: RenderExecutionOptions) => Promise<{
+        execution: RenderExecution;
+        html: string;
+        warnings: string[];
+    }>;
+    pdf: (document: PrintDocument, input?: Record<string, unknown>, parseOptions?: PdfParseOptions, execution?: RenderExecutionOptions) => Promise<{
+        blob: Blob;
+        execution: RenderExecution;
+        warnings: string[];
+    }>;
+};
+export type RenderRuntime = ReturnType<typeof createRenderRuntime>;