@cluadwong/form-designer 0.2.0

package/dist/components/designer/composables/useSchemaEdits.d.ts

@@ -0,0 +1,111 @@
+/**
+ * 设计器结构编辑动作：节点增删、Grid/Cell 结构、Inspector 的属性更新。
+ *
+ * 从 `FormDesigner.vue` 抽出（2026-09-07 批次 1 拆分）：所有「改 schema」的动作集中在此，
+ * 只依赖文档句柄与选择态句柄，**不直接依赖组件实例**，可脱离 UI 单测。
+ *
+ * 闸门：结构性编辑统一走 `ctx.editable()`（设计态才允许），避免逐处手写守卫。
+ */
+import { type ComputedRef } from "vue";
+import type { EditorNodeV2, HeaderFooterV2, TextStyleV2 } from "../../../types";
+import type { SchemaDocument } from "./useSchemaDocument";
+import type { NodeSelection } from "./useNodeSelection";
+export type NodeKind = "text" | "field" | "table" | "html" | "image" | "grid";
+export interface SchemaEditsContext {
+    document: SchemaDocument;
+    selection: NodeSelection;
+    /** 是否允许结构性编辑（设计态）。 */
+    editable: () => boolean;
+    /** 结构变化后清空选中（删除 / 撤销等场景）。 */
+    clearSelection: () => void;
+}
+export type SchemaEdits = ReturnType<typeof useSchemaEdits>;
+export declare function useSchemaEdits(ctx: SchemaEditsContext): {
+    addRootGrid: () => void;
+    addGrid: () => void;
+    addNodeToSelectedCell: (kind: NodeKind) => void;
+    removeSelectedNode: () => void;
+    copySelected: () => void;
+    cutSelected: () => void;
+    pasteClipboard: () => void;
+    duplicateSelected: () => void;
+    mergeSelectedCellRight: () => void;
+    splitSelectedCell: () => void;
+    onCanvasNodeDragStart: (id: string) => void;
+    onDropNode: (detail: {
+        moveId: string;
+        cellId: string;
+        index: number;
+    }) => void;
+    onDropPalette: (detail: {
+        kind: NodeKind;
+        cellId: string;
+    }) => void;
+    updateSelectedNode: (updater: (node: EditorNodeV2) => EditorNodeV2, tag?: string) => void;
+    updateSelectedText: (event: Event) => void;
+    updateSelectedField: (event: Event) => void;
+    updateSelectedPrefix: (event: Event) => void;
+    updateSelectedSuffix: (event: Event) => void;
+    updateSelectedWidth: (event: Event) => void;
+    updateSelectedDefault: (event: Event) => void;
+    updateSelectedInnerBorder: (event: Event) => void;
+    updateSelectedAction: (event: Event) => void;
+    updateSelectedDateFormat: (event: Event) => void;
+    updateGridBorder: (event: Event) => void;
+    updateTableBorder: (event: Event) => void;
+    updateGridDimensions: (event: Event) => void;
+    updateTableRows: (event: Event) => void;
+    addTableColumn: () => void;
+    removeTableColumn: (columnKey: string) => void;
+    renameTableColumnKey: (oldKey: string, event: Event) => void;
+    updateTableColumn: (columnKey: string, field: "title" | "width" | "align", event: Event) => void;
+    updateTableHeaderFontSize: (event: Event) => void;
+    updateTableHeaderFontWeight: (event: Event) => void;
+    updateTableHeaderAlign: (event: Event) => void;
+    updateGridColumnWidth: (columnIndex: number, event: Event) => void;
+    updateGridCellDefault: (field: "cellPadding" | "cellAlign" | "cellVerticalAlign", event: Event) => void;
+    updateGridGap: (event: Event) => void;
+    updateSelectedCellPadding: (event: Event) => void;
+    updateSelectedCellAlign: (event: Event) => void;
+    updateSelectedCellVerticalAlign: (event: Event) => void;
+    updateSelectedCellFlex: (event: Event) => void;
+    updateSelectedCellRowHeight: (event: Event) => void;
+    updateSelectedTextStyle: (patch: Partial<TextStyleV2>) => void;
+    updateSelectedFontSize: (event: Event) => void;
+    updateSelectedLineHeight: (event: Event) => void;
+    updateSelectedFontWeight: (event: Event) => void;
+    updateSelectedColor: (event: Event) => void;
+    updateSelectedFontFamily: (event: Event) => void;
+    updateSelectedAlign: (event: Event) => void;
+    updateSelectedVerticalAlign: (event: Event) => void;
+    updateSelectedHtml: (event: Event) => void;
+    updateSelectedCss: (event: Event) => void;
+    updateSelectedImageSrc: (event: Event) => void;
+    updateSelectedImageField: (event: Event) => void;
+    updateSelectedImageSize: (dimension: "width" | "height", event: Event) => void;
+    updateSelectedImageFit: (event: Event) => void;
+    updateBaseRowHeight: (event: Event) => void;
+    updatePaperSize: (event: Event) => void;
+    paperMarginTop: ComputedRef<number>;
+    paperMarginRight: ComputedRef<number>;
+    paperMarginBottom: ComputedRef<number>;
+    paperMarginLeft: ComputedRef<number>;
+    updatePaperMarginSide: (side: "top" | "right" | "bottom" | "left", event: Event) => void;
+    updatePaperHeader: (next: Partial<HeaderFooterV2>) => void;
+    updatePaperHeaderContent: (zone: "left" | "center" | "right", event: Event) => void;
+    updatePaperHeaderEnabled: (event: Event) => void;
+    updatePaperHeaderHeight: (event: Event) => void;
+    updatePaperHeaderSeparator: (event: Event) => void;
+    updatePaperHeaderFontSize: (event: Event) => void;
+    updatePaperHeaderFontWeight: (event: Event) => void;
+    updatePaperHeaderColor: (event: Event) => void;
+    updatePaperFooter: (next: Partial<HeaderFooterV2>) => void;
+    updatePaperFooterContent: (zone: "left" | "center" | "right", event: Event) => void;
+    updatePaperFooterEnabled: (event: Event) => void;
+    updatePaperFooterHeight: (event: Event) => void;
+    updatePaperFooterSeparator: (event: Event) => void;
+    updatePaperFooterFontSize: (event: Event) => void;
+    updatePaperFooterFontWeight: (event: Event) => void;
+    updatePaperFooterColor: (event: Event) => void;
+};
+//# sourceMappingURL=useSchemaEdits.d.ts.map

package/dist/components/designer/composables/useSchemaEdits.d.ts.map

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

package/dist/components/designer/config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 设计器全局 UI 配置（2026-09-08）。
+ *
+ * 用途：用一个结构化配置对象集中控制「设计页 UI」的可见性——当前主要作用于顶部
+ * 工具栏的模块按钮组，后续可扩展到左侧组件面板 / 右侧检查器等（配置结构已预留）。
+ *
+ * 设计约定：
+ * - `defaultDesignerUIConfig` 是**全局默认值**——默认显示**全部**模块（含「填充数据」组）；
+ *   不想展示该组时由宿主经 `FormDesigner` 的 `uiConfig` prop 显式关闭。
+ * - 默认语言 `locale: "zh-CN"`（见 `src/i18n`）；宿主经 `uiConfig.locale` 切换，如
+ *   `<FormDesigner :ui-config="{ locale: 'en' }" />` 即可整页切英文（已迁移到 `t()` 的文案生效）。
+ * - 宿主通过 `<FormDesigner :ui-config="{ showFillDataModule: false }" />` 局部覆盖；
+ *   `resolveDesignerUIConfig` 做浅合并（每个开关独立），未提供的键回退到默认。
+ * - 组件内统一用 `resolveDesignerUIConfig(props.uiConfig)` 得到完整配置，避免散落默认值。
+ */
+import type { Locale } from "../../i18n";
+/** 设计页 UI 可见性开关 + 语言（每个开关独立，缺省见 `defaultDesignerUIConfig`）。 */
+export interface DesignerUIConfig {
+    /** 新建空白按钮。 */
+    showNewBlank?: boolean;
+    /** 样例载入按钮（B3 注入的样例集）。 */
+    showSamples?: boolean;
+    /** 撤销 / 重做按钮组。 */
+    showUndoRedo?: boolean;
+    /** 模板模块组（保存模板 / 读取模板 / 导出文件 / 导入文件）。 */
+    showTemplateModule?: boolean;
+    /** 填充数据模块组（导入数据 / 导出数据 / 读取数据 / 保存数据）。默认显示。 */
+    showFillDataModule?: boolean;
+    /** 预览 / 打印按钮。 */
+    showPreviewPrint?: boolean;
+    /** 帮助按钮。 */
+    showHelp?: boolean;
+    /** 界面语言（默认简体中文）。 */
+    locale?: Locale;
+}
+/** 全局默认：显示所有模块，语言简体中文。 */
+export declare const defaultDesignerUIConfig: DesignerUIConfig;
+/** 浅合并宿主覆盖到默认配置，返回完整 `DesignerUIConfig`。 */
+export declare function resolveDesignerUIConfig(partial?: Partial<DesignerUIConfig>): DesignerUIConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/components/designer/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/components/designer/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0BAA0B;AAC1B,eAAO,MAAM,uBAAuB,EAAE,gBASrC,CAAC;AAEF,4CAA4C;AAC5C,wBAAgB,uBAAuB,CACrC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,gBAAgB,CAElB"}

package/dist/components/designer/export-api.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 设计器对外交付 API：把「当前表单」转成宿主可直接消费的 JSON 契约。
+ *
+ * 两个取值入口（宿主经 `FormDesigner` 的 ref 调用，或用同名纯函数）：
+ * 1. **schema 配置** —— 整份 `FormSchemaV2`（版式描述），与工具栏「导出文件」同口径；
+ * 2. **表单数据** —— `{ 字段名: 值 }`（如 `{"单位":"运输队"}`）。取值口径与渲染期
+ *    **完全同源**：直接复用 `collectFieldValues`（遍历渲染 DOM 的 `[data-field]`），
+ *    不另写一套 schema 遍历。表单没有任何字段时结果就是 `{}`。
+ *
+ * 工具栏「导出文件」/「导出数据」两个动作也调用同一组 API（见 `useSchemaDocument` /
+ * `useFillData`），并在控制台打印对应 JSON，便于联调时直接抄走数据。
+ *
+ * 除 `collectFormData` / `downloadJsonFile` 外均为纯函数，可脱离组件单测。
+ */
+import { type CollectFieldValuesOptions } from "../renderer-v2";
+import type { FormDataV2, FormSchemaV2 } from "../../types";
+/** 默认 JSON 缩进空格数（导出物是给人看 / 进版本库的，默认美化）。 */
+export declare const JSON_INDENT = 2;
+/** 导出文件名前缀（沿用 `ticket-designer-*` 命名惯例，与 `useSchemaDocument` / `useFillData` 一致）。 */
+export declare const SCHEMA_EXPORT_PREFIX = "ticket-schema-v2";
+export declare const FILL_DATA_EXPORT_PREFIX = "ticket-fill-data";
+/**
+ * 采集渲染根容器内的**字段与值**，构成 `{ 字段名: 值 }`。
+ *
+ * 薄转发 `collectFieldValues`（渲染内核的 DOM 遍历采集器）：两者是同一个实现，
+ * 保证「设计器导出的数据」与「消费页采集的数据」口径不会漂移。
+ *
+ * @param root 渲染根容器（设计器的 `.v2-canvas`），为 `null` 时返回 `{}`。
+ * @param options 脱敏口径等透传给 `collectFieldValues`。
+ */
+export declare function collectFormData(root: ParentNode | null | undefined, options?: CollectFieldValuesOptions): FormDataV2;
+/** 序列化整份 schema（`pretty` 控制缩进，默认缩进）。 */
+export declare function serializeSchemaJson(schema: FormSchemaV2, pretty?: boolean): string;
+/** 序列化表单数据 JSON（`pretty` 控制缩进，默认缩进）。 */
+export declare function serializeFormDataJson(data: FormDataV2, pretty?: boolean): string;
+/** 生成带时间戳的导出文件名，避免连续导出互相覆盖。 */
+export declare function exportFileName(prefix: string, stamp?: number): string;
+/**
+ * 触发浏览器下载一个 JSON 文件（唯一的副作用点）。
+ * 非浏览器环境（Node / SSR）静默返回，调用方不必自己判断 `document`。
+ */
+export declare function downloadJsonFile(fileName: string, jsonText: string): void;
+/**
+ * `FormDesigner` 经 `defineExpose` 对宿主开放的程序化 API。
+ *
+ * 宿主典型用法（**宿主侧代码**，本仓库不改宿主）：
+ * ```ts
+ * const designerRef = ref<InstanceType<typeof FormDesigner> | null>(null);
+ * // 保存：schema 配置 + 表单数据一起拿走
+ * const schema = designerRef.value!.getSchema();        // FormSchemaV2
+ * const data = designerRef.value!.getFormData();        // { 单位: "", 编号: "", ... }
+ * // 回填：
+ * designerRef.value!.setSchema(version.schema);
+ * ```
+ */
+export interface FormDesignerExposed {
+    /** 当前 schema 的深拷贝（改它不会污染设计器内部状态）。需要 JSON 文本时宿主自行 `JSON.stringify`。 */
+    getSchema: () => FormSchemaV2;
+    /**
+     * 当前表单的**字段与值**（`{ 字段名: 值 }`）。值来自渲染 DOM 遍历（`collectFieldValues`），
+     * 因此含用户在设计态 / 预览态就地输入的内容；表单没有配置字段时返回 `{}`。
+     * 需要 JSON 文本时宿主自行 `JSON.stringify`。
+     */
+    getFormData: (options?: CollectFieldValuesOptions) => FormDataV2;
+    /** 载入一份 schema（对象或 JSON 文本），并清空历史与选中。 */
+    setSchema: (next: FormSchemaV2 | string) => void;
+    /** 下载 schema JSON 文件（与工具栏「导出文件」同一实现）。 */
+    exportSchemaFile: () => void;
+    /** 下载表单数据 JSON 文件（与工具栏「导出数据」同一实现）。 */
+    exportFillDataFile: () => void;
+    /** 触发打印（与工具栏「打印」同一实现）。 */
+    print: () => void;
+    /** 重置为空白模板（一个空 page + 一个根 Grid）。 */
+    resetBlank: () => void;
+}
+/**
+ * `setSchema` 的入参归一化：字符串按严格解析（`parseFormSchemaV2`，非法直接抛错），
+ * 对象走一次深拷贝——宿主传入的引用后续被它自己改，也不该影响设计器。
+ */
+export declare function normalizeIncomingSchema(next: FormSchemaV2 | string): FormSchemaV2;
+//# sourceMappingURL=export-api.d.ts.map

package/dist/components/designer/export-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-api.d.ts","sourceRoot":"","sources":["../../../src/components/designer/export-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGxD,2CAA2C;AAC3C,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACnC,OAAO,GAAE,yBAA8B,GACtC,UAAU,CAGZ;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,UAAO,GAAG,MAAM,CAE/E;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,UAAO,GAAG,MAAM,CAE7E;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM,CAEjF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAezE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,SAAS,EAAE,MAAM,YAAY,CAAC;IAC9B;;;;OAIG;IACH,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,yBAAyB,KAAK,UAAU,CAAC;IACjE,yCAAyC;IACzC,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,KAAK,IAAI,CAAC;IACjD,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,YAAY,CAGjF"}

package/dist/components/designer/inspectors/CellInspector.vue.d.ts

@@ -0,0 +1,20 @@
+/** 单元格（grid-cell）：仅样式覆盖（padding / 行高 / 对齐）+ 合并拆分。 */
+import type { GridCellV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    node: GridCellV2;
+    cellContext: {
+        rowIndex: number;
+        columnIndex: number;
+        hasNextSibling: boolean;
+        canSplit: boolean;
+    } | null;
+    cellBox: {
+        align?: string;
+        verticalAlign?: string;
+    } | null;
+    api: SchemaEdits;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=CellInspector.vue.d.ts.map

package/dist/components/designer/inspectors/CellInspector.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CellInspector.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/CellInspector.vue"],"names":[],"mappings":"AAgGA,qDAAqD;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,GAAG,IAAI,CAAC;IACT,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,GAAG,EAAE,WAAW,CAAC;CAClB,CAAC;;AA8IF,wBAMG"}

package/dist/components/designer/inspectors/FieldPInspector.vue.d.ts

@@ -0,0 +1,10 @@
+/** 字段 P：字段名 / 前后标签 / 外部组件 action / 文本样式 / 默认值 / 宽度 / 内部边框。 */
+import type { FieldPNodeV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    node: FieldPNodeV2;
+    api: SchemaEdits;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=FieldPInspector.vue.d.ts.map

package/dist/components/designer/inspectors/FieldPInspector.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldPInspector.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/FieldPInspector.vue"],"names":[],"mappings":"AAgFA,8DAA8D;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;;AAuK5D,wBAMG"}

package/dist/components/designer/inspectors/GridInspector.vue.d.ts

@@ -0,0 +1,10 @@
+/** Grid 配置：行列数 / 列宽 / 边框 / 单元格默认 / 间距。 */
+import type { GridNodeV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    node: GridNodeV2;
+    api: SchemaEdits;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=GridInspector.vue.d.ts.map

package/dist/components/designer/inspectors/GridInspector.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridInspector.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/GridInspector.vue"],"names":[],"mappings":"AAiHA,0CAA0C;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;;AA4M1D,wBAMG"}

package/dist/components/designer/inspectors/HeaderFooterFields.vue.d.ts

@@ -0,0 +1,14 @@
+import { type HeaderFooterV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    /** 段标题（页眉 / 页脚）。 */
+    label: string;
+    band: HeaderFooterV2 | undefined;
+    kind: "header" | "footer";
+    api: SchemaEdits;
+    /** 当前纸张边距（mm，四边同值）：用于提示「带高不得超过边距」。 */
+    margin?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=HeaderFooterFields.vue.d.ts.map

package/dist/components/designer/inspectors/HeaderFooterFields.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderFooterFields.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/HeaderFooterFields.vue"],"names":[],"mappings":"AAyKA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,KAAK,WAAW,GAAG;IACjB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,GAAG,EAAE,WAAW,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;;AAwOF,wBAMG"}

package/dist/components/designer/inspectors/HtmlInspector.vue.d.ts

@@ -0,0 +1,10 @@
+/** HTML 模块：片段 + 模块内 CSS（Shadow DOM 隔离）。 */
+import type { HtmlNodeV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    node: HtmlNodeV2;
+    api: SchemaEdits;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=HtmlInspector.vue.d.ts.map

package/dist/components/designer/inspectors/HtmlInspector.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlInspector.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/HtmlInspector.vue"],"names":[],"mappings":"AAiCA,2CAA2C;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;;AA6D1D,wBAMG"}

package/dist/components/designer/inspectors/ImageInspector.vue.d.ts

@@ -0,0 +1,10 @@
+/** 图片：地址 / 数据字段 / 尺寸 / 填充方式。 */
+import type { ImageNodeV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    node: ImageNodeV2;
+    api: SchemaEdits;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=ImageInspector.vue.d.ts.map

package/dist/components/designer/inspectors/ImageInspector.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageInspector.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/ImageInspector.vue"],"names":[],"mappings":"AA4DA,gCAAgC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;;AAmH3D,wBAMG"}

package/dist/components/designer/inspectors/IssuesPanel.vue.d.ts

@@ -0,0 +1,11 @@
+import type { SchemaIssueV2 } from "../../../types";
+type __VLS_Props = {
+    issues: SchemaIssueV2[];
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (issue: SchemaIssueV2) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((issue: SchemaIssueV2) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=IssuesPanel.vue.d.ts.map

package/dist/components/designer/inspectors/IssuesPanel.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IssuesPanel.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/IssuesPanel.vue"],"names":[],"mappings":"AAAA,OA0DO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,KAAK,WAAW,GAAG;IAAE,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC;;;;;;AAgE/C,wBAOG"}

package/dist/components/designer/inspectors/PageInspector.vue.d.ts

@@ -0,0 +1,27 @@
+/** 页面设置：纸张 / 四边边距 / 基础行高 / 分页开关 / 页眉 / 页脚（Inspector 组件化，2026-09-07 批次 2）。 */
+import type { FormSchemaV2, HeaderFooterV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    paperSize: FormSchemaV2["paper"]["size"];
+    baseRowHeight: number;
+    /** 四边边距（mm），独立配置。 */
+    paperMarginTop: number;
+    paperMarginRight: number;
+    paperMarginBottom: number;
+    paperMarginLeft: number;
+    /** 页眉（paper 级全局配置，作用于所有物理页）。 */
+    header?: HeaderFooterV2;
+    /** 页脚（paper 级全局配置，作用于所有物理页）。 */
+    footer?: HeaderFooterV2;
+    api: SchemaEdits;
+};
+type __VLS_PublicProps = __VLS_Props & {
+    "paginate": boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:paginate": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:paginate"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=PageInspector.vue.d.ts.map

package/dist/components/designer/inspectors/PageInspector.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageInspector.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/PageInspector.vue"],"names":[],"mappings":"AA+GA,6EAA6E;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,KAAK,WAAW,GAAG;IACjB,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,gCAAgC;IAChC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,GAAG,EAAE,WAAW,CAAC;CAClB,CAAC;AASF,KAAK,iBAAiB,GAAG,WAAW,GAAG;IACvC,UAAU,EAAE,OAAO,CAAC;CACnB,CAAC;;;;;;AAuLF,wBAOG"}

package/dist/components/designer/inspectors/TableInspector.vue.d.ts

@@ -0,0 +1,10 @@
+/** 表格：最小行数 / 边框 / 列配置（增删列即增删派生字段）。 */
+import type { TableNodeV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    node: TableNodeV2;
+    api: SchemaEdits;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=TableInspector.vue.d.ts.map

package/dist/components/designer/inspectors/TableInspector.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableInspector.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/TableInspector.vue"],"names":[],"mappings":"AAkNA,sCAAsC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;;AA0N3D,wBAMG"}

package/dist/components/designer/inspectors/TextInspector.vue.d.ts

@@ -0,0 +1,10 @@
+/** 固定文本节点：内容 + 文本样式。 */
+import type { TextNodeV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    node: TextNodeV2;
+    api: SchemaEdits;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=TextInspector.vue.d.ts.map

package/dist/components/designer/inspectors/TextInspector.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextInspector.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/TextInspector.vue"],"names":[],"mappings":"AAuBA,wBAAwB;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;;AAsD1D,wBAMG"}

package/dist/components/designer/inspectors/TextStyleFields.vue.d.ts

@@ -0,0 +1,10 @@
+/** 文本样式字段组（text / p 共用）：字号 / 行高 / 粗细 / 颜色 / 对齐 / 字体。 */
+import type { TextStyleV2 } from "../../../types";
+import type { SchemaEdits } from "../composables/useSchemaEdits";
+type __VLS_Props = {
+    style?: TextStyleV2;
+    api: SchemaEdits;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=TextStyleFields.vue.d.ts.map

package/dist/components/designer/inspectors/TextStyleFields.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextStyleFields.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/designer/inspectors/TextStyleFields.vue"],"names":[],"mappings":"AA8EA,wDAAwD;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,KAAK,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;;AAmJ7D,wBAMG"}

package/dist/components/renderer-v2/FormRenderer.vue.d.ts

@@ -0,0 +1,106 @@
+import type { FieldActionTriggerV2, FieldPermissionV2, FieldRuleV2, FormDataV2, FormSchemaV2 } from "../../types";
+/**
+ * 消费页渲染形态选项（G8 / G10）。
+ *
+ * 设计态与消费态由**两个正交轴**区分（同一套渲染内核 `GridFormRenderer`）：
+ * - `isDesign`（内核 `mode="design"`，仅设计器内）：可编辑组件（表面层负责）+ 字段可就地输入看交互效果（不回写 schema）；
+ * - `readonly`（消费态闸门）：消费页不编辑组件，字段是否可输入由 `readonly` 全局控制，**默认 true（只读回显）**，
+ *   显式传 `false` 即进入「填写」——这正是 `FormRenderer` 这里唯一的输入控制。
+ *
+ * 因此 `FormRenderer` 不需要 `preview` / `fill` 这类模式区分：它永远是消费态（非 design），
+ * 对内统一传固定的非设计 `mode` 给内核，对外只暴露 `readonly` 与 `getFormData`。
+ */
+export interface FormRendererOptions {
+    /** 无外壳：去掉灰底纸张画布，便于嵌入消费页中部（G8 / G10）。 */
+    bare?: boolean;
+    /**
+     * 启用纸张视口缩放（浏览 / 移动端查看）：包一层可平移缩放的视口。
+     * 启用时强制 `bare`（缩放态由视口管理，内核画布不再自带滚动/灰底），
+     * 缩放条与滚轮 / 双指捏合由视口提供；打印时缩放被 `@media print` 复位，走真实 mm。
+     */
+    zoom?: boolean;
+    /**
+     * 缩放视口挂载后自动适应宽度（窄屏 / 移动端查看场景）。仅当 `zoom` 为真时生效。
+     * 默认 false（保持 100%）；窄屏传 true 可让表单自动铺满视口宽度。
+     */
+    fitOnMount?: boolean;
+    /**
+     * 只读闸门（与内核 `mode` **正交**）：默认 **true** —— 消费页默认只读回显（仅浏览详情）。
+     * 设为 false 即进入「填写」态，字段可输入（契合「预览即消费模板、输入数据以配合业务流程流转」）。
+     * 设计态的「不回写 schema 的就地输入」是另一回事（内核 `mode="design"`，由设计器控制），与此无关。
+     */
+    readonly?: boolean;
+    /**
+     * 字段级运行时权限（P9.2a / P9.2b）：与 `data` 同轨经 props 注入、不进 schema。
+     * `{ 字段名: "READ" | "EDIT" | "HIDDEN" }`——EDIT=可输入（缺省）、READ=只读回显、
+     * HIDDEN=脱敏显示（输入内容以 `***` 替代，占位与前后标签保留；真实值不进 DOM，
+     * `collectFieldValues` 跳过该字段，`getFormData` 仍返回真实值）。
+     * 未注明的字段一律 EDIT，向后兼容。
+     */
+    fieldPermissions?: Record<string, FieldPermissionV2>;
+    /**
+     * 字段级校验规则（P9.2c）：与 `data` / `fieldPermissions` 同轨经 props 注入、不进
+     * schema。`{ 字段名: { required: true } }`——经 `validate()` 对当前数据做必填校验，
+     * 返回值为空的字段名数组（空数组 = 全部通过）。后续可扩展更多规则。
+     */
+    rules?: Record<string, FieldRuleV2>;
+}
+/**
+ * 公共渲染入口（G8）：消费页引用渲染器的唯一公开组件。
+ *
+ * 设计器（FormDesigner）仍直接引用内核 `GridFormRenderer`（并包 `CanvasSurface` 负责组件编辑）；
+ * 本组件是在内核之上收敛出的「消费页友好」包装——props 收敛为 `schema / data / options`，
+ * 不暴露任何设计器私有状态（`selectedNodeId` / 拖拽态 / `node-drag-start`），从而可被独立引用与库化。
+ *
+ * 消费页典型流程：拿到 JSON 字符串 → `parseTolerantFormSchemaV2(json).schema` →
+ * `<FormRenderer :schema="schema" v-model:data="data" />`（只读回显）；
+ * 需要录入时 `<FormRenderer :schema="schema" :options="{ readonly: false }" v-model:data="data" />`。
+ */
+type __VLS_Props = {
+    /** 设计器导出的 Schema（消费页由 json + 容错解析得到）。 */
+    schema: FormSchemaV2;
+    /** 字段数据；缺省为空（显示静态内容或 default）。 */
+    data?: FormDataV2 | null;
+    /** 渲染形态选项（G8 / G10：bare / zoom / fitOnMount / readonly）。 */
+    options?: FormRendererOptions;
+};
+/**
+ * D2：向消费页暴露打印能力，使「触发」与「呈现」同归渲染层。
+ * 消费页 `ref.value.print()` 即可打印，无需自己 `window.print()`、也无需关心
+ * `@page` 纸张注入（由本组件持有内核渲染实例在挂载期完成）。
+ *
+ * 打印走内核的**局部打印**（vue-print-next）：只把纸张序列化进同源 iframe，
+ * 消费页其余内容（导航 / 头部 / 其他区域）不进打印流。
+ * @returns 是否真的触发了打印（找不到打印根 / 宿主不支持时为 `false`）。
+ */
+declare function print(): boolean;
+/**
+ * 获取整个表单当前输入数据（消费页「提交 / 导出填写结果」入口）。
+ * 返回内部响应式 data 的快照——初始来自 `props.data`，每次字段 `field-change` 即时并入，
+ * 与 `update:data` 发射的口径一致。只读态返回的是回显数据，填写态返回的是已录入值。
+ */
+declare function getFormData(): FormDataV2;
+/**
+ * P9.2c 提交校验：对当前数据执行 `options.rules` 里的必填规则（引擎
+ * `findEmptyRequiredFields` 为真相源），返回**值为空**的必填字段名数组。
+ * 空数组 = 全部通过。规则与 data 同轨经 props 注入、不进 schema；
+ * HIDDEN 脱敏字段的真实值在响应式数据侧，此处校验不受脱敏影响。
+ */
+declare function validate(): string[];
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    print: typeof print;
+    getFormData: typeof getFormData;
+    validate: typeof validate;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    action: (payload: FieldActionTriggerV2) => any;
+    "field-change": (field: string, value: string) => any;
+    "update:data": (data: FormDataV2) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAction?: ((payload: FieldActionTriggerV2) => any) | undefined;
+    "onField-change"?: ((field: string, value: string) => any) | undefined;
+    "onUpdate:data"?: ((data: FormDataV2) => any) | undefined;
+}>, {
+    options: FormRendererOptions;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=FormRenderer.vue.d.ts.map

package/dist/components/renderer-v2/FormRenderer.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormRenderer.vue.d.ts","sourceRoot":"","sources":["../../../src/components/renderer-v2/FormRenderer.vue"],"names":[],"mappings":"AAiMA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACrD;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,KAAK,WAAW,GAAG;IACf,yCAAyC;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,kCAAkC;IAClC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAkDJ;;;;;;;;GAQG;AACH,iBAAS,KAAK,IAAI,OAAO,CAGxB;AAED;;;;GAIG;AACH,iBAAS,WAAW,IAAI,UAAU,CAEjC;AAED;;;;;GAKG;AACH,iBAAS,QAAQ,IAAI,MAAM,EAAE,CAE5B;;;;;;;;;;;;;;aAlFa,mBAAmB;;AAoNjC,wBASG"}

package/dist/components/renderer-v2/GridFormRenderer.vue.d.ts

@@ -0,0 +1,49 @@
+import { type FieldActionTriggerV2, type FormSchemaV2, type FormDataV2, type FieldPermissionV2 } from "../../types";
+type __VLS_Props = {
+    schema: FormSchemaV2;
+    /**
+     * 渲染模式（A1 / A5 分层重构）：显式声明调用方意图，取代旧版靠 `data != null` 推断三态。
+     * - design：设计态，字段以 contenteditable 就地占位（不回写 schema），结构可编辑。
+     * - preview：带数据回显，**字段可输入**（消费模板、输入数据以配合流程流转）。
+     * 未传时向后兼容：有 `data` → preview，否则 design。
+     * ⚠️ `mode` 不决定可编辑性；真正的「不可输入」由下面的 `readonly` 闸门决定。
+     */
+    mode?: "design" | "preview";
+    /** 填充/预览态数据；用于字段取值与 Table 行数推导。设计态可为空（字段显示 default/占位）。 */
+    data?: FormDataV2 | null;
+    /**
+     * 只读闸门：为 `true` 时字段一律不可输入（真·只读回显/打印浏览）。
+     * 与 `mode` **正交**——`mode` 不决定可编辑性：
+     * - `FormRenderer` 默认 `readonly=true`（消费页默认只读回显），显式传 `readonly=false` 即进入填写态；
+     * - 设计器预览态显式传 `:readonly="false"`（查看输入交互效果，亦不回写 schema）。
+     */
+    readonly?: boolean;
+    /**
+     * 无外壳模式（G8/G10）：去掉灰底纸张画布外壳（padding / 背景 / 阴影），
+     * 仅渲染纸张 `<main>`，便于消费页把表单嵌入自身页面中部（而非模拟整张纸）。
+     */
+    bare?: boolean;
+    /**
+     * 分页开关（默认 true）：预览/填写/打印时按纸张正文高度把超高内容切成多个物理页；
+     * 设计态传 false，整页连续渲染便于编辑（不切分）。
+     */
+    paginate?: boolean;
+    /**
+     * 字段级运行时权限（P9.2a/P9.2b，与 `data` 同轨经 props 注入，不进 schema）：
+     * `{ 字段名: "READ" | "EDIT" | "HIDDEN" }`。EDIT=可输入（缺省）；READ=只读回显；
+     * HIDDEN=隐藏且保留固定空间（visibility:hidden，占位/分页高度不变，值仍可采集）。
+     * 未注明的字段一律 EDIT，向后兼容。
+     */
+    fieldPermissions?: Record<string, FieldPermissionV2>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "field-change": (field: string, value: string) => any;
+    "action-trigger": (payload: FieldActionTriggerV2) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onField-change"?: ((field: string, value: string) => any) | undefined;
+    "onAction-trigger"?: ((payload: FieldActionTriggerV2) => any) | undefined;
+}>, {
+    paginate: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=GridFormRenderer.vue.d.ts.map