@cluadwong/form-designer 0.2.0

package/dist/types/schema-v2-validation.d.ts

@@ -0,0 +1,10 @@
+import type { FormSchemaV2 } from "./schema-v2";
+export interface SchemaIssueV2 {
+    level: "error" | "warning";
+    code: string;
+    nodeId?: string;
+    path?: Array<string | number>;
+    message: string;
+}
+export declare function validateFormSchemaV2(schema: FormSchemaV2): SchemaIssueV2[];
+//# sourceMappingURL=schema-v2-validation.d.ts.map

package/dist/types/schema-v2-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-v2-validation.d.ts","sourceRoot":"","sources":["../../src/types/schema-v2-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,YAAY,EAQb,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAoUD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,EAAE,CA8B1E"}

package/dist/types/schema-v2.d.ts

@@ -0,0 +1,283 @@
+/**
+ * V2 固定版式表单 Schema。
+ *
+ * V2 使用嵌套结构作为持久化和渲染格式：Page -> Grid -> Row -> Cell -> children。
+ * 设计器运行时可以从这棵树派生节点索引，但索引不写入 Schema。
+ */
+export type PaperSizeV2 = "A4" | "A3";
+export type OrientationV2 = "portrait" | "landscape";
+export type PageModeV2 = "fixed";
+export type GridTrackV2 = number | `${number}fr` | "auto";
+export type BorderModeV2 = "all" | "outer" | "inner" | "none";
+/** 页眉/页脚三栏文本。占位符：`{page}` 当前物理页序（1-based）、`{total}` 总物理页数。
+ *  三栏均可缺省；MVP 仅支持静态文本 + 页码占位符（字段绑定 `{field:key}` 暂不支持）。 */
+export interface HeaderFooterContentV2 {
+    left?: string;
+    center?: string;
+    right?: string;
+}
+/**
+ * 页眉 / 页脚配置。
+ *
+ * 驻留纸张**上/下边距区**，随每个物理页重复渲染（渲染层每个物理页各画一条带，
+ * 故天然每页重复、打印同理）；属于纸张装饰，**不进入 SchemaNode 树**（不参与
+ * 选中 / 拖拽 / 结构树，只能经 Inspector 编辑）。
+ */
+export interface HeaderFooterV2 {
+    /** 开关：仅 `true` 时渲染，未设即关闭。 */
+    enabled?: boolean;
+    content?: HeaderFooterContentV2;
+    /** 带高（mm）；未设/非法回退 `DEFAULT_BAND_HEIGHT_MM`（10）。大于纸张边距会压到正文，由 Inspector 提示。 */
+    height?: number;
+    /** 文本样式：生效子集为 `fontSize` / `fontWeight` / `color`（其余键忽略）。 */
+    style?: TextStyleV2;
+    /** 分隔线（页眉下 / 页脚上）：未设即 true。 */
+    separator?: boolean;
+    separatorColor?: string;
+    separatorWidth?: number;
+}
+/** 页眉/页脚带默认高度（mm）：`height` 未设或非法时的回退值（渲染与面板共用单一真源）。 */
+export declare const DEFAULT_BAND_HEIGHT_MM = 10;
+export interface PaperConfigV2 {
+    size: PaperSizeV2;
+    /** 废弃键：方向自 P11-3 起由纸张尺寸派生（A4→纵向、A3→横向），渲染与打印均忽略本字段。
+     *  保留为可选仅为存量模板向后兼容；新模板不再写入，序列化导出自然丢弃。 */
+    orientation?: OrientationV2;
+    /** 页眉（全局，作用于所有物理页）。 */
+    header?: HeaderFooterV2;
+    /** 页脚（全局，作用于所有物理页）。 */
+    footer?: HeaderFooterV2;
+}
+export interface EdgeInsetsV2 {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface BoxStyleV2 {
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+}
+export interface TextStyleV2 {
+    align?: "left" | "center" | "right";
+    verticalAlign?: "top" | "middle" | "bottom";
+    fontSize?: number;
+    lineHeight?: number;
+    fontWeight?: "normal" | "bold";
+    writingMode?: "horizontal-tb" | "vertical-rl";
+    whiteSpace?: "normal" | "nowrap" | "pre-wrap";
+    /** 文字颜色（CSS color）。仅用于渲染，不影响字段语义。 */
+    color?: string;
+    /** 字体族（CSS font-family）。 */
+    fontFamily?: string;
+}
+export interface SchemaNodeBaseV2 {
+    id: string;
+}
+/**
+ * 固定文字节点（text 类型，标题 / 标签 / 说明等）。
+ * 与可输入字段的 `p` 节点彻底分离：text 不进入字段数据、不参与填写回写，
+ * 仅用于静态展示，可在设计器配置多行文本与文本样式。
+ */
+export interface TextNodeV2 extends SchemaNodeBaseV2 {
+    type: "text";
+    text: string;
+    style?: TextStyleV2;
+}
+export interface FieldPNodeV2 extends SchemaNodeBaseV2 {
+    type: "p";
+    mode: "field";
+    field: string;
+    /** Optional inline label rendered before the input area. */
+    prefix?: string;
+    /** Optional inline label rendered after the input area. */
+    suffix?: string;
+    /** 外部组件触发类型（选项值）：由宿主弹窗调用、在回调里把数据回写 data 再渲染到票面上。
+     *  text=无（纯文本输入）、date=日期选择器、signature=签名板、upload=文件上传。 */
+    action?: "text" | "date" | "signature" | "upload";
+    /** 外部组件的额外参数（含义由 `action` 决定，如 date 的 `format`）。 */
+    actionParams?: Record<string, string>;
+    underline?: boolean;
+    webUnderline?: boolean;
+    printUnderline?: boolean;
+    /** 字段宽度（CSS 长度字符串，支持 mm / px / % 等，如 "30mm"、"120px"、"50%"）。
+     *  缺省时不限制宽度（沿用父容器 100%）。 */
+    width?: string;
+    /** 字段默认内容：无填写数据时的预设文本，支持多行（`\n`）。 */
+    default?: string;
+    /** 内部边框：为 p 标签内每一行（回车生成的 div）显示底边框。
+     *  默认不显示；勾选后设计态 / 预览 / 打印均保持显示。 */
+    innerBorder?: boolean;
+    style?: TextStyleV2;
+}
+export type PNodeV2 = FieldPNodeV2;
+/**
+ * 字段级运行时权限（P9.2a / P9.2b）：**与 `data` 同轨，由消费方经 props 注入渲染组件**
+ * （`fieldPermissions: { 字段名: 权限 }`），**不进 schema**——权限是消费会话关注点，
+ * 设计模板不携带（设计态不注入 → 全部 EDIT，设计交互不受影响）。
+ * - `EDIT`：可输入（**缺省值**，未注明的字段一律可编辑，向后兼容）；
+ * - `READ`：只读回显（渲染值但不可就地输入）；
+ * - `HIDDEN`：**脱敏显示**（2026-09-08 用户拍板）：字段外壳与前/后标签照常渲染、
+ *   占位与分页高度不变，**非空输入内容以 `***` 替代**（空值不打码）；真实值不进 DOM，
+ *   `collectFieldValues` 跳过该字段（防止假值污染），消费页 `getFormData` 仍返回真实值。
+ */
+export type FieldPermissionV2 = "READ" | "EDIT" | "HIDDEN";
+/**
+ * 字段级校验规则（P9.2c）：**与 `data` / `fieldPermissions` 同轨，由消费方经 props
+ * （`FormRenderer` 的 `options.rules`）注入**，不进 schema——「哪些字段必填」是消费
+ * 会话的采集策略，模板不携带。键 = 字段名，值 = 规则对象（当前仅 `required`，
+ * 后续可扩展 min/max/pattern 等）。
+ */
+export interface FieldRuleV2 {
+    /** 必填：值为空（键缺失 / 空串 / 纯空白）时校验不通过。 */
+    required?: boolean;
+}
+/**
+ * 专用控件触发事件契约（P9.1c）：字段 P 配置了 `action`（非 text）时，渲染内核在
+ * **填写态**（canFill）由**点击字段元素本身**触发（表单不加任何额外按钮），经
+ * `action-trigger` 事件把触发权交还宿主——**宿主负责召唤外部输入组件（弹窗/选择器）并在
+ * 回调里回写 data**（与 data 同轨，回写后票面自动重渲染）。内核不做任何弹窗实现
+ * （分层：内核不认识宿主 UI）。
+ */
+export interface FieldActionTriggerV2 {
+    /** 触发源字段节点 id。 */
+    nodeId: string;
+    /** 字段名（宿主回写 data 的键）。 */
+    field: string;
+    /** 外部组件类型。 */
+    action: NonNullable<FieldPNodeV2["action"]>;
+    /** 外部组件额外参数（含义由 action 决定，如 date 的 format）。 */
+    actionParams?: Record<string, string>;
+}
+export interface GridNodeV2 extends SchemaNodeBaseV2 {
+    type: "grid";
+    border: BorderModeV2;
+    rows: GridRowV2[];
+    style?: BoxStyleV2;
+    /** 列宽规范（按逻辑列顺序）。渲染时所有行共用同一组列轨，使跨列合并（colspan）
+     *  在任意列宽下都能正确对齐。缺省时渲染器回退到逐格 cell.width（旧数据兼容）。 */
+    columns?: GridTrackV2[];
+    /** 单元格默认内边距（mm）。子 cell 未单独设置 padding 时继承此值，缺省为 0。 */
+    cellPadding?: number;
+    /** 单元格默认水平对齐。子 cell 未单独设置 align 时继承此值。 */
+    cellAlign?: "left" | "center" | "right";
+    /** 单元格默认垂直对齐。子 cell 未单独设置 verticalAlign 时继承此值。 */
+    cellVerticalAlign?: "top" | "middle" | "bottom";
+    /**
+     * 单元格间距（mm，非负）：同时作用于**行与行之间**与**列与列之间**，
+     * 等价于 CSS `gap`。缺省为 0（单元格紧贴，分隔线相接）。
+     * 注意：间距会让内部边框线之间出现等距空隙（每格只画自己的单边，间隙留白）。
+     */
+    gap?: number;
+}
+export interface GridRowV2 extends SchemaNodeBaseV2 {
+    type: "grid-row";
+    /** 相对于 FormSchemaV2.baseRowHeight 的固定倍数。 */
+    height: number;
+    cells: GridCellV2[];
+}
+export interface GridCellV2 extends SchemaNodeBaseV2 {
+    type: "grid-cell";
+    width?: GridTrackV2;
+    colspan?: number;
+    /** 单元格行高倍数（覆盖所在 Grid 行的 height）；不设置时继承 Grid 行高。 */
+    rowHeight?: number;
+    padding?: number;
+    align?: "left" | "center" | "right";
+    verticalAlign?: "top" | "middle" | "bottom";
+    /**
+     * 弹性布局（单元格级）：为 true 时该单元格自身作为水平流式 flex 容器，
+     * 其直接子节点沿水平方向排布、到达边界自动换行、水平左对齐、垂直居中、间隔 0
+     * （等价于 CSS `display:flex; flex-direction:row; flex-wrap:wrap;
+     *  justify-content:flex-start; align-items:center`）。
+     * 适用于「一格内横排多个字段/文本」的弹性分组场景；缺省为 false（普通格子，
+     * 子节点按默认对齐居中放置）。flex 是单元格属性，不是独立组件。
+     */
+    flex?: boolean;
+    children: FormNodeV2[];
+}
+export interface TableColumnV2 {
+    key: string;
+    title: string;
+    width?: GridTrackV2;
+    align?: "left" | "center" | "right";
+}
+export interface TableCellTemplateV2 extends SchemaNodeBaseV2 {
+    type: "table-cell-template";
+    columnKey: string;
+    children: FormNodeV2[];
+}
+export interface TableNodeV2 extends SchemaNodeBaseV2 {
+    type: "table";
+    field?: string;
+    columns: TableColumnV2[];
+    minRows: number;
+    rowTemplate: TableCellTemplateV2[];
+    /** 表头样式（标题行）：字号(px) / 粗细 / 对齐。可选；未设时回退到列 align 与默认外观。 */
+    headerStyle?: TextStyleV2;
+    /** 边框模式（与 Grid 一致）：all=外框+内部线（默认）、inner=仅内部线、outer=仅外框、none=无。 */
+    border?: BorderModeV2;
+    /**
+     * 分页引擎内部字段（2026-09-03 廿一续）：跨页切分时，本片段最多渲染的数据行数。
+     * 仅由 `paginateTable` 写入，渲染层 `GridSchemaNode.vue` 用它限制 `v-for` 行范围。
+     * 未设置或 ≤0 时渲染全部行（= 不限制，与未分页时一致）。
+     * 序列化/校验层忽略此字段（不在用户 JSON 中出现）。
+     */
+    _paginateMaxRows?: number;
+}
+export interface HtmlNodeV2 extends SchemaNodeBaseV2 {
+    type: "html";
+    /** HTML 片段，配置期即要求不含 <script>/on* 等脚本；渲染前仍由引擎统一清洗（见 engine.md §11） */
+    html: string;
+    /** 仅在 Shadow DOM 内生效，不污染表单样式 */
+    css?: string;
+}
+export interface ImageNodeV2 extends SchemaNodeBaseV2 {
+    type: "image";
+    src?: string;
+    field?: string;
+    width?: number;
+    height?: number;
+    objectFit?: "contain" | "cover" | "fill";
+}
+export type FormNodeV2 = GridNodeV2 | PNodeV2 | TextNodeV2 | TableNodeV2 | HtmlNodeV2 | ImageNodeV2;
+/** 表单数据：字段名 -> 值。渲染时用于原地填充字段节点（见 engine.md §11）。 */
+export type FormDataV2 = Record<string, string | number | boolean | null>;
+/** Persisted component nodes. Rows/cells/templates are owned layout records. */
+export type SchemaNodeV2 = PageSchemaV2 | FormNodeV2;
+export type LayoutNodeV2 = GridRowV2 | GridCellV2 | TableCellTemplateV2;
+export type EditorNodeV2 = SchemaNodeV2 | LayoutNodeV2;
+/** Returns true for nodes that can be selected and edited as components. */
+export declare function isSelectableSchemaNodeV2(node: EditorNodeV2 | undefined): node is SchemaNodeV2;
+export interface PageSchemaV2 extends SchemaNodeBaseV2 {
+    type: "page";
+    mode: PageModeV2;
+    margin: EdgeInsetsV2;
+    children: FormNodeV2[];
+}
+export interface FormSchemaV2 {
+    version: 2;
+    paper: PaperConfigV2;
+    baseRowHeight: number;
+    pages: PageSchemaV2[];
+}
+/** 纸张边长（mm）：short=短边，long=长边。渲染纸张、打印 `@page size`、溢出校验共用同一份，
+ *  避免各处硬编码「A4 = 210×297」（历史上 `@page` 写死 A4，导致选 A3 时打印被裁）。 */
+export declare const PAPER_SIDE_MM: Record<PaperSizeV2, {
+    short: number;
+    long: number;
+}>;
+export interface ResolvedPaperSizeV2 {
+    size: PaperSizeV2;
+    /** 方向由纸张尺寸派生（无独立方向选择）：A4 → 纵向，A3 → 横向。 */
+    orientation: OrientationV2;
+    widthMm: number;
+    heightMm: number;
+}
+/**
+ * 解析纸张物理尺寸（mm）。渲染纸张宽度/最小高度、打印 `@page size`、页面溢出校验
+ * 三处统一调用本函数，保证「屏幕上看到多大纸、打印出来就是多大纸」。
+ */
+export declare function resolvePaperSizeV2(paper: PaperConfigV2): ResolvedPaperSizeV2;
+//# sourceMappingURL=schema-v2.d.ts.map

package/dist/types/schema-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-v2.d.ts","sourceRoot":"","sources":["../../src/types/schema-v2.ts"],"names":[],"mappings":"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"}

package/dist/utils/date-format.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 日期字段显示格式工具（P 字段 action="date" 的「format」属性配套）。
+ *
+ * 格式串 token：`{YYYY}` 年 / `{MM}` 月 / `{DD}` 日 / `{hh}` 时 / `{mm}` 分 / `{ss}` 秒。
+ * 例：`{YYYY}年{MM}月{DD} {hh}时{mm}分{ss}秒`。
+ *
+ * 仅作用于【填写回写】环节：宿主（消费页）在 date 选择器 change 时把原生 ISO 值
+ * （`YYYY-MM-DD` 或 `YYYY-MM-DDTHH:mm[:ss]`）按 `actionParams.format` 套成中文串写进 data，
+ * 票面直接显示该串；脱敏/采集/打印均不改此逻辑（按 data 原样）。无 format 时原样存储（向后兼容）。
+ *
+ * 渲染内核不认识这些 token——它们属于宿主的「外部输入组件」职责（与 action 机制同轨）。
+ */
+export interface DateParts {
+    Y: string;
+    M: string;
+    D: string;
+    h: string;
+    m: string;
+    s: string;
+}
+/**
+ * 把原生 ISO 值格式化为配置串。无 format / 无值 / 无法解析 → 原样返回（向后兼容）。
+ * 注意：替换发生在 format 模板上，值取自解析后的 iso 六段。
+ */
+export declare function formatDateValue(iso: string, format?: string): string;
+/**
+ * 把已格式化的值按 format 还原为原生 ISO（date 或 datetime-local），
+ * 供宿主回填到原生选择器（再次打开时定位到已填值）。解析不到完整年月日 → 返回 ""（无法回填）。
+ */
+export declare function parseDateValue(formatted: string, format?: string): string;
+/** 格式串是否含时间 token（决定宿主用 datetime-local 还是 date 选择器）。
+ *  注意无 `i` 标志：分钟是小写 `{mm}`、月份是大写 `{MM}`，不可混。 */
+export declare function formatHasTime(format?: string): boolean;
+//# sourceMappingURL=date-format.d.ts.map

package/dist/utils/date-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-format.d.ts","sourceRoot":"","sources":["../../src/utils/date-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAwBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAsBpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBzE;AAED;gDACgD;AAChD,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@cluadwong/form-designer",
+  "version": "0.2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "description": "固定布局表单设计器与渲染组件（Schema V2）：可视化编排版式 → 导出 Schema JSON → 渲染 / 填写 / 打印",
+  "license": "MIT",
+  "author": "CluadWong",
+  "keywords": [
+    "vue",
+    "vue3",
+    "form",
+    "form-designer",
+    "form-renderer",
+    "schema",
+    "typescript",
+    "print",
+    "layout"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CluadWong/form-designer.git"
+  },
+  "homepage": "https://github.com/CluadWong/form-designer",
+  "bugs": {
+    "url": "https://github.com/CluadWong/form-designer/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "//typesVersions": "宿主 tsconfig 若用 moduleResolution:\"node\"(node10) 会忽略 exports，子路径 @cluadwong/form-designer/designer|renderer 的类型解析不到（TS2307）。此映射补上该回落路径；用 bundler/node16 的宿主走 exports，两者并存不冲突。",
+  "typesVersions": {
+    "*": {
+      "designer": [
+        "./dist/designer.d.ts"
+      ],
+      "renderer": [
+        "./dist/renderer.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./renderer": {
+      "types": "./dist/renderer.d.ts",
+      "import": "./dist/renderer.js"
+    },
+    "./designer": {
+      "types": "./dist/designer.d.ts",
+      "import": "./dist/designer.js"
+    },
+    "./renderer/style.css": "./dist/renderer-core.css",
+    "./designer/style.css": "./dist/designer-ui.css",
+    "./style.css": "./dist/ticket-designer.css"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc --noEmit && vite build",
+    "build:lib": "vite build --config vite.lib.config.ts --emptyOutDir",
+    "dev:lib": "npm run build:types && vite build --config vite.lib.config.ts --watch",
+    "build:types": "vue-tsc -p tsconfig.lib.json --declaration --emitDeclarationOnly --outDir dist && node scripts/fix-dts-alias.mjs",
+    "pack:check": "npm run build:lib && npm run build:types && npm pack --dry-run",
+    "test": "vitest run",
+    "release": "bash scripts/release.sh"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0"
+  },
+  "dependencies": {
+    "@panzoom/panzoom": "^4.6.2",
+    "dompurify": "^3.4.14",
+    "vue-print-next": "^1.1.6"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.1.0",
+    "@vue/test-utils": "^2.4.0",
+    "jsdom": "^24.0.0",
+    "typescript": "^5.5.0",
+    "vite": "^5.4.0",
+    "vitest": "^1.6.0",
+    "vue": "^3.5.0",
+    "vue-tsc": "^2.1.0"
+  },
+  "private": false
+}