@shwfed/config 3.0.10 → 3.0.12

package/dist/runtime/components/config/blocks/2026-07-17/com.shwfed.block.invoice.digital/runtime.vue.d.ts

@@ -0,0 +1,86 @@
+import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
+import { type Value } from './schema.js';
+type __VLS_Props = {
+    configure?: (env: Environment) => void;
+};
+type __VLS_ModelProps = {
+    'block': Value;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:block": (value: {
+        readonly type: "com.shwfed.block.invoice.digital";
+        readonly id: string;
+        readonly line: {
+            readonly name: string;
+            readonly spec?: string | undefined;
+            readonly unit?: string | undefined;
+            readonly quantity?: string | undefined;
+            readonly unitPrice?: string | undefined;
+            readonly amount: string;
+            readonly taxRate?: string | undefined;
+            readonly taxAmount?: string | undefined;
+        };
+        readonly displayName?: string | undefined;
+        readonly kind?: "normal" | "special" | undefined;
+        readonly compatibilityDate: "2026-07-17";
+        readonly items: string;
+        readonly request?: string | undefined;
+        readonly itemsMaxHeight?: string | undefined;
+        readonly invoiceNumber: string;
+        readonly issueDate: string;
+        readonly buyer: {
+            readonly name: string;
+            readonly taxId: string;
+        };
+        readonly seller: {
+            readonly name: string;
+            readonly taxId: string;
+        };
+        readonly totalAmount: string;
+        readonly totalTax: string;
+        readonly grandTotal: string;
+        readonly remark?: string | undefined;
+        readonly issuer?: string | undefined;
+        readonly redLetter?: string | undefined;
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:block"?: ((value: {
+        readonly type: "com.shwfed.block.invoice.digital";
+        readonly id: string;
+        readonly line: {
+            readonly name: string;
+            readonly spec?: string | undefined;
+            readonly unit?: string | undefined;
+            readonly quantity?: string | undefined;
+            readonly unitPrice?: string | undefined;
+            readonly amount: string;
+            readonly taxRate?: string | undefined;
+            readonly taxAmount?: string | undefined;
+        };
+        readonly displayName?: string | undefined;
+        readonly kind?: "normal" | "special" | undefined;
+        readonly compatibilityDate: "2026-07-17";
+        readonly items: string;
+        readonly request?: string | undefined;
+        readonly itemsMaxHeight?: string | undefined;
+        readonly invoiceNumber: string;
+        readonly issueDate: string;
+        readonly buyer: {
+            readonly name: string;
+            readonly taxId: string;
+        };
+        readonly seller: {
+            readonly name: string;
+            readonly taxId: string;
+        };
+        readonly totalAmount: string;
+        readonly totalTax: string;
+        readonly grandTotal: string;
+        readonly remark?: string | undefined;
+        readonly issuer?: string | undefined;
+        readonly redLetter?: string | undefined;
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/config/blocks/2026-07-17/com.shwfed.block.invoice.digital/schema.d.ts

@@ -0,0 +1,109 @@
+import { Schema } from 'effect';
+import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
+export { getStructFieldDescription, getStructFieldTitle } from '../../../../table/utils/schema-meta.js';
+type AnySchema = Schema.Schema<any, any, never>;
+type Configure = (env: Environment) => void;
+export declare const type: "com.shwfed.block.invoice.digital";
+export declare const compatibilityDate: "2026-07-17";
+export declare const metadata: {
+    readonly name: "数电票";
+    readonly icon: "fluent:receipt-20-regular";
+    readonly description: "按国家税务总局版式渲染一张数电票（增值税专用发票 / 普通发票），票面各栏由 CEL 表达式映射";
+    readonly w: {
+        readonly initial: 24;
+        readonly min: 12;
+        readonly max: number;
+    };
+    readonly h: {
+        readonly initial: 12;
+        readonly min: 8;
+        readonly max: number;
+        readonly grow: true;
+    };
+};
+/**
+ * 票面自己的（可选）取数：`request` 求值出的 HTTP 响应体，票面**每一栏**都能读。
+ *
+ * 与「不内建 DataSource」的边界不冲突 —— 这里只有 `request`，没有 `data`：票面各栏
+ * 本来就是逐栏 CEL 映射，`json` 只是多了一个可读的上下文变量，而不是又一层「列表 →
+ * 行」的取数抽象。不配置时 `json` 为 `none`，票面照旧从外层上下文（`item` / 详情页
+ * 变量）取值，行为与加这个字段之前完全一致。
+ *
+ * 导出给 `config.vue` —— 它直接渲染 `ExpressionEditor`（不经过本 schema），不共享
+ * 这份声明的话，编辑器会把 `json` 误报成 `Unknown variable`。镜像 card 块的 `JSON_VAR`。
+ */
+export declare const JSON_VAR: {
+    readonly type: "optional<dyn>";
+    readonly label: "HTTP 响应体";
+    readonly description: "HTTP 响应体（配置了「请求」时为已解析 JSON，否则为 none）";
+};
+/** 票种：决定票面标题（「电子发票（增值税专用发票）」/「…（普通发票）」）。 */
+export declare const INVOICE_KINDS: readonly ["special", "normal"];
+export declare const INVOICE_KIND_LABELS: Record<(typeof INVOICE_KINDS)[number], string>;
+/**
+ * 购买方 / 销售方信息栏。票面只有「名称」与「统一社会信用代码/纳税人识别号」两栏 ——
+ * 开户行与账号在真实发票上属于「备注」栏的自由文本（不是独立栏位），因此不建模，
+ * 由 `remark` 承载。
+ */
+export declare function partySchema(configure: Configure, role: '购买方' | '销售方'): Schema.Struct<{
+    name: Schema.Schema<string, string, never>;
+    taxId: Schema.Schema<string, string, never>;
+}>;
+/**
+ * 明细行的列映射。每个表达式对一行求值，可访问 `item`（当前明细项）与 `index`
+ * （序号，从 0 开始）—— 与 `loop` 块同一套行作用域（`registerLoopVariablesIfAbsent`）。
+ *
+ * 只有「项目名称」与「金额」必填：真实发票上规格型号 / 单位 / 数量 / 单价 常为空
+ * （如服务费类目），留空即该单元格不渲染内容。
+ */
+export declare function lineSchema(configure: Configure): Schema.Struct<{
+    name: Schema.Schema<string, string, never>;
+    spec: Schema.optional<Schema.Schema<string, string, never>>;
+    unit: Schema.optional<Schema.Schema<string, string, never>>;
+    quantity: Schema.optional<Schema.Schema<string, string, never>>;
+    unitPrice: Schema.optional<Schema.Schema<string, string, never>>;
+    amount: Schema.Schema<string, string, never>;
+    taxRate: Schema.optional<Schema.Schema<string, string, never>>;
+    taxAmount: Schema.optional<Schema.Schema<string, string, never>>;
+}>;
+export declare function schema(configure: Configure, _blockRef?: AnySchema): Schema.Struct<{
+    id: Schema.refine<string, typeof Schema.String>;
+    type: Schema.tag<"com.shwfed.block.invoice.digital">;
+    compatibilityDate: Schema.tag<"2026-07-17">;
+    displayName: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    kind: Schema.optional<Schema.Literal<["special", "normal"]>>;
+    request: Schema.optional<Schema.Schema<string, string, never>>;
+    itemsMaxHeight: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    invoiceNumber: Schema.Schema<string, string, never>;
+    issueDate: Schema.Schema<string, string, never>;
+    buyer: Schema.Struct<{
+        name: Schema.Schema<string, string, never>;
+        taxId: Schema.Schema<string, string, never>;
+    }>;
+    seller: Schema.Struct<{
+        name: Schema.Schema<string, string, never>;
+        taxId: Schema.Schema<string, string, never>;
+    }>;
+    items: Schema.Schema<string, string, never>;
+    line: Schema.Struct<{
+        name: Schema.Schema<string, string, never>;
+        spec: Schema.optional<Schema.Schema<string, string, never>>;
+        unit: Schema.optional<Schema.Schema<string, string, never>>;
+        quantity: Schema.optional<Schema.Schema<string, string, never>>;
+        unitPrice: Schema.optional<Schema.Schema<string, string, never>>;
+        amount: Schema.Schema<string, string, never>;
+        taxRate: Schema.optional<Schema.Schema<string, string, never>>;
+        taxAmount: Schema.optional<Schema.Schema<string, string, never>>;
+    }>;
+    totalAmount: Schema.Schema<string, string, never>;
+    totalTax: Schema.Schema<string, string, never>;
+    grandTotal: Schema.Schema<string, string, never>;
+    remark: Schema.optional<Schema.Schema<string, string, never>>;
+    issuer: Schema.optional<Schema.Schema<string, string, never>>;
+    redLetter: Schema.optional<Schema.Schema<string, string, never>>;
+}>;
+export declare function defaultBody(): Record<string, unknown>;
+export type Value = Schema.Schema.Type<ReturnType<typeof schema>>;
+export type PartyValue = Value['buyer'];
+export type LineValue = Value['line'];
+export type InvoiceKind = (typeof INVOICE_KINDS)[number];

package/dist/runtime/components/config/blocks/2026-07-17/com.shwfed.block.invoice.digital/schema.js

@@ -0,0 +1,189 @@
+import { Schema } from "effect";
+import { Expression, HttpRequestResult } from "../../../../../share/expression.js";
+import { registerLoopVariablesIfAbsent } from "../../../../../share/loop-item-var.js";
+export { getStructFieldDescription, getStructFieldTitle } from "../../../../table/utils/schema-meta.js";
+export const type = "com.shwfed.block.invoice.digital";
+export const compatibilityDate = "2026-07-17";
+export const metadata = {
+  name: "\u6570\u7535\u7968",
+  icon: "fluent:receipt-20-regular",
+  description: "\u6309\u56FD\u5BB6\u7A0E\u52A1\u603B\u5C40\u7248\u5F0F\u6E32\u67D3\u4E00\u5F20\u6570\u7535\u7968\uFF08\u589E\u503C\u7A0E\u4E13\u7528\u53D1\u7968 / \u666E\u901A\u53D1\u7968\uFF09\uFF0C\u7968\u9762\u5404\u680F\u7531 CEL \u8868\u8FBE\u5F0F\u6620\u5C04",
+  w: { initial: 24, min: 12, max: Infinity },
+  // `grow: true`：票面高度由明细行数决定（内容驱动），需要脱离网格 `1fr` 等分、
+  // 顶部锚定向下生长，否则行数变化会让整张票在过大的轨道里重新定位。
+  // 与 `loop` / `tree.single` 同理，见 `config/utils/resolve.ts` 的 `BlockSizeRange.grow`。
+  h: { initial: 12, min: 8, max: Infinity, grow: true }
+};
+export const JSON_VAR = {
+  type: "optional<dyn>",
+  label: "HTTP \u54CD\u5E94\u4F53",
+  description: "HTTP \u54CD\u5E94\u4F53\uFF08\u914D\u7F6E\u4E86\u300C\u8BF7\u6C42\u300D\u65F6\u4E3A\u5DF2\u89E3\u6790 JSON\uFF0C\u5426\u5219\u4E3A none\uFF09"
+};
+function registerJsonIfAbsent(env) {
+  const declared = env.getDefinitions().variables.some((v) => v.name === "json");
+  if (declared) return;
+  env.registerVariable("json", JSON_VAR.type, {
+    label: JSON_VAR.label,
+    description: JSON_VAR.description
+  });
+}
+export const INVOICE_KINDS = ["special", "normal"];
+export const INVOICE_KIND_LABELS = {
+  special: "\u589E\u503C\u7A0E\u4E13\u7528\u53D1\u7968",
+  normal: "\u589E\u503C\u7A0E\u666E\u901A\u53D1\u7968"
+};
+const textResult = (t) => t === "string" || t === "dyn" || t.startsWith("optional");
+const moneyResult = (t) => t === "number" || t === "string" || t === "dyn" || t.startsWith("optional");
+const listResult = (t) => t === "dyn" || t.startsWith("list") || t.startsWith("optional");
+const boolResult = (t) => t === "bool" || t === "dyn" || t.startsWith("optional");
+export function partySchema(configure, role) {
+  const CelText = Expression({ configure, resultType: textResult });
+  return Schema.Struct({
+    name: CelText.annotations({
+      title: "\u540D\u79F0",
+      description: `\u8FD4\u56DE${role}\u540D\u79F0\uFF08\`string\`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F`
+    }),
+    taxId: CelText.annotations({
+      title: "\u7EDF\u4E00\u793E\u4F1A\u4FE1\u7528\u4EE3\u7801/\u7EB3\u7A0E\u4EBA\u8BC6\u522B\u53F7",
+      description: `\u8FD4\u56DE${role}\u7EDF\u4E00\u793E\u4F1A\u4FE1\u7528\u4EE3\u7801\u6216\u7EB3\u7A0E\u4EBA\u8BC6\u522B\u53F7\uFF08\`string\`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F`
+    })
+  }).annotations({
+    title: `${role}\u4FE1\u606F`,
+    description: `${role}\u7684\u540D\u79F0\u4E0E\u7EB3\u7A0E\u4EBA\u8BC6\u522B\u53F7\uFF1B\u5F00\u6237\u884C / \u8D26\u53F7\u8BF7\u5199\u5165\u300C\u5907\u6CE8\u300D`
+  });
+}
+export function lineSchema(configure) {
+  const rowConfigure = (env) => {
+    configure(env);
+    registerLoopVariablesIfAbsent(env);
+  };
+  const CelText = Expression({ configure: rowConfigure, resultType: textResult });
+  const CelMoney = Expression({ configure: rowConfigure, resultType: moneyResult });
+  return Schema.Struct({
+    name: CelText.annotations({
+      title: "\u9879\u76EE\u540D\u79F0",
+      description: "\u8FD4\u56DE\u9879\u76EE\u540D\u79F0\uFF08`string`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u5982 `item.xmmc`\u3002\u7968\u9762\u60EF\u4F8B\u5E26\u7C7B\u76EE\u524D\u7F00\uFF0C\u5982 `*\u96C6\u6210\u7535\u8DEF*\u96C6\u6210\u7535\u8DEF`"
+    }),
+    spec: Schema.optional(CelText.annotations({
+      title: "\u89C4\u683C\u578B\u53F7",
+      description: "\u8FD4\u56DE\u89C4\u683C\u578B\u53F7\uFF08`string`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u7559\u7A7A\u5219\u8BE5\u680F\u4E3A\u7A7A"
+    })),
+    unit: Schema.optional(CelText.annotations({
+      title: "\u5355\u4F4D",
+      description: "\u8FD4\u56DE\u8BA1\u91CF\u5355\u4F4D\uFF08`string`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u5982 `\u4E2A` / `\u4EF6`\uFF1B\u7559\u7A7A\u5219\u8BE5\u680F\u4E3A\u7A7A"
+    })),
+    quantity: Schema.optional(CelMoney.annotations({
+      title: "\u6570\u91CF",
+      description: "\u8FD4\u56DE\u6570\u91CF\u7684 CEL \u8868\u8FBE\u5F0F\u3002\u8FD4\u56DE `number` \u65F6\u539F\u6837\u5C55\u793A\uFF08\u4E0D\u8865\u5C0F\u6570\u4F4D\uFF09\uFF0C\u8FD4\u56DE `string` \u65F6\u539F\u6837\u6253\u5370\uFF1B\u7559\u7A7A\u5219\u8BE5\u680F\u4E3A\u7A7A"
+    })),
+    unitPrice: Schema.optional(CelMoney.annotations({
+      title: "\u5355\u4EF7",
+      description: "\u8FD4\u56DE\u5355\u4EF7\u7684 CEL \u8868\u8FBE\u5F0F\u3002\u8FD4\u56DE `number` \u65F6\u539F\u6837\u5C55\u793A\uFF08\u7968\u9762\u5355\u4EF7\u5E38\u5E26\u591A\u4F4D\u5C0F\u6570\uFF0C\u5982 `272.5663716814`\uFF0C\u6545\u4E0D\u505A\u56DB\u820D\u4E94\u5165\uFF09\uFF1B\u7559\u7A7A\u5219\u8BE5\u680F\u4E3A\u7A7A"
+    })),
+    amount: CelMoney.annotations({
+      title: "\u91D1\u989D",
+      description: "\u8FD4\u56DE\u4E0D\u542B\u7A0E\u91D1\u989D\u7684 CEL \u8868\u8FBE\u5F0F\u3002\u8FD4\u56DE `number` \u65F6\u683C\u5F0F\u5316\u4E3A\u4E24\u4F4D\u5C0F\u6570\u5E76\u52A0\u5343\u5206\u4F4D\uFF1B\u8FD4\u56DE `string` \u65F6\u539F\u6837\u6253\u5370"
+    }),
+    taxRate: Schema.optional(CelText.annotations({
+      title: "\u7A0E\u7387/\u5F81\u6536\u7387",
+      description: "\u8FD4\u56DE\u7A0E\u7387\uFF08`string`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u539F\u6837\u6253\u5370\uFF0C\u5982 `13%`\u3002\u523B\u610F\u4E0D\u662F\u6570\u5B57 \u2014\u2014 \u8BE5\u680F\u5408\u6CD5\u53D6\u503C\u8FD8\u5305\u62EC `\u514D\u7A0E` / `\u4E0D\u5F81\u7A0E` / `***`"
+    })),
+    taxAmount: Schema.optional(CelMoney.annotations({
+      title: "\u7A0E\u989D",
+      description: "\u8FD4\u56DE\u7A0E\u989D\u7684 CEL \u8868\u8FBE\u5F0F\u3002\u8FD4\u56DE `number` \u65F6\u683C\u5F0F\u5316\u4E3A\u4E24\u4F4D\u5C0F\u6570\u5E76\u52A0\u5343\u5206\u4F4D\uFF1B\u7559\u7A7A\u5219\u8BE5\u680F\u4E3A\u7A7A"
+    }))
+  }).annotations({
+    title: "\u660E\u7EC6\u884C",
+    description: "\u660E\u7EC6\u5404\u680F\u7684\u53D6\u503C\u8868\u8FBE\u5F0F\uFF0C\u5BF9\u6BCF\u4E00\u884C\u6C42\u503C\uFF1B\u53EF\u8BBF\u95EE `item`\uFF08\u5F53\u524D\u660E\u7EC6\u9879\uFF09\u4E0E `index`\uFF08\u5E8F\u53F7\uFF0C\u4ECE 0 \u5F00\u59CB\uFF09"
+  });
+}
+export function schema(configure, _blockRef) {
+  const CelRequest = Expression({ configure, resultType: HttpRequestResult });
+  const bodyConfigure = (env) => {
+    configure(env);
+    registerJsonIfAbsent(env);
+  };
+  const CelText = Expression({ configure: bodyConfigure, resultType: textResult });
+  const CelMoney = Expression({ configure: bodyConfigure, resultType: moneyResult });
+  const CelItems = Expression({ configure: bodyConfigure, resultType: listResult });
+  const CelBool = Expression({ configure: bodyConfigure, resultType: boolResult });
+  return Schema.Struct({
+    id: Schema.UUID.annotations({ description: "\u5757\u552F\u4E00\u6807\u8BC6" }),
+    type: Schema.tag(type),
+    compatibilityDate: Schema.tag(compatibilityDate),
+    displayName: Schema.optional(Schema.String.annotations({
+      title: "\u5185\u90E8\u540D\u79F0",
+      description: "\u4EC5\u5728\u7F16\u8F91\u5668\u5185\u53EF\u89C1\u7684\u5757\u540D\uFF0C\u7528\u4E8E\u5728\u4FA7\u8FB9\u680F\u548C\u5E03\u5C40\u7F16\u8F91\u5668\u4E2D\u8BC6\u522B\u5757\uFF1B\u8FD0\u884C\u65F6\u4E0D\u5C55\u793A"
+    })),
+    kind: Schema.optional(Schema.Literal(...INVOICE_KINDS).annotations({
+      title: "\u7968\u79CD",
+      description: "\u51B3\u5B9A\u7968\u9762\u6807\u9898\uFF1A`special` \u4E3A\u300C\u7535\u5B50\u53D1\u7968\uFF08\u589E\u503C\u7A0E\u4E13\u7528\u53D1\u7968\uFF09\u300D\uFF0C`normal` \u4E3A\u300C\u7535\u5B50\u53D1\u7968\uFF08\u589E\u503C\u7A0E\u666E\u901A\u53D1\u7968\uFF09\u300D\uFF1B\u7559\u7A7A\u7B49\u540C `special`"
+    })),
+    request: Schema.optional(CelRequest.annotations({
+      title: "\u8BF7\u6C42",
+      description: "\u53EF\u9009\u7684 HTTP \u8BF7\u6C42\u8868\u8FBE\u5F0F\uFF08\u8FD4\u56DE `HttpRequest`\uFF09\uFF1B\u54CD\u5E94\u4F53\u4EE5 `json` \u63D0\u4F9B\u7ED9\u7968\u9762\u6240\u6709\u680F\u4F4D\uFF08\u542B\u660E\u7EC6\u5217\u8868\u4E0E\u9010\u884C\u680F\u4F4D\uFF09\u3002\u7559\u7A7A\u5219 `json` \u4E3A none\uFF0C\u5404\u680F\u4ECE\u5916\u5C42\u4E0A\u4E0B\u6587\u53D6\u503C"
+    })),
+    itemsMaxHeight: Schema.optional(Schema.String.annotations({
+      title: "\u660E\u7EC6\u533A\u9AD8\u5EA6",
+      description: "\u660E\u7EC6\u533A\u7684\u6700\u5927\u9AD8\u5EA6\uFF08CSS \u957F\u5EA6\uFF0C\u5982 `24rem` / `50vh`\uFF09\uFF1B\u8D85\u51FA\u540E\u660E\u7EC6\u5185\u5BB9\u6EDA\u52A8\uFF0C\u5217\u6807\u9898\u4E0E\u5408\u8BA1\u884C\u4FDD\u6301\u53EF\u89C1\u3002\u7559\u7A7A\u5219\u660E\u7EC6\u533A\u968F\u884C\u6570\u589E\u957F\uFF0C\u7968\u9762\u6574\u4F53\u53D8\u9AD8"
+    })),
+    invoiceNumber: CelText.annotations({
+      title: "\u53D1\u7968\u53F7\u7801",
+      description: "\u8FD4\u56DE\u53D1\u7968\u53F7\u7801\uFF08`string`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u5C55\u793A\u5728\u7968\u9762\u53F3\u4E0A\u89D2"
+    }),
+    issueDate: CelText.annotations({
+      title: "\u5F00\u7968\u65E5\u671F",
+      description: "\u8FD4\u56DE\u5F00\u7968\u65E5\u671F\uFF08`string`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u539F\u6837\u6253\u5370\u3002\u7968\u9762\u60EF\u4F8B\u4E3A `2026\u5E7406\u670801\u65E5`\uFF0C\u683C\u5F0F\u5316\u8BF7\u5728\u8868\u8FBE\u5F0F\u5185\u5B8C\u6210"
+    }),
+    buyer: partySchema(bodyConfigure, "\u8D2D\u4E70\u65B9"),
+    seller: partySchema(bodyConfigure, "\u9500\u552E\u65B9"),
+    items: CelItems.annotations({
+      title: "\u660E\u7EC6\u5217\u8868",
+      description: "\u8FD4\u56DE\u660E\u7EC6\u884C\u5217\u8868\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u5982 `json.mxList`\uFF1B\u6BCF\u4E00\u9879\u6309\u300C\u660E\u7EC6\u884C\u300D\u7684\u5217\u6620\u5C04\u6E32\u67D3\u4E00\u884C\u3002\u8FD4\u56DE `none` / \u975E\u5217\u8868\u65F6\u4E0D\u6E32\u67D3\u4EFB\u4F55\u660E\u7EC6\u884C"
+    }),
+    line: lineSchema(bodyConfigure).annotations({
+      title: "\u660E\u7EC6\u884C",
+      description: "\u660E\u7EC6\u5404\u680F\u7684\u53D6\u503C\u8868\u8FBE\u5F0F\uFF0C\u5BF9\u300C\u660E\u7EC6\u5217\u8868\u300D\u7684\u6BCF\u4E00\u9879\u6C42\u503C"
+    }),
+    totalAmount: CelMoney.annotations({
+      title: "\u5408\u8BA1\u91D1\u989D",
+      description: "\u8FD4\u56DE\u5408\u8BA1\u680F\u4E0D\u542B\u7A0E\u91D1\u989D\u7684 CEL \u8868\u8FBE\u5F0F\u3002\u523B\u610F\u4E0D\u7531\u660E\u7EC6\u81EA\u52A8\u6C42\u548C \u2014\u2014 \u7968\u9762\u5408\u8BA1\u4EE5\u5F00\u7968\u6570\u636E\u4E3A\u51C6\uFF0C\u4E0D\u5E94\u7531\u524D\u7AEF\u91CD\u7B97"
+    }),
+    totalTax: CelMoney.annotations({
+      title: "\u5408\u8BA1\u7A0E\u989D",
+      description: "\u8FD4\u56DE\u5408\u8BA1\u680F\u7A0E\u989D\u7684 CEL \u8868\u8FBE\u5F0F"
+    }),
+    grandTotal: CelMoney.annotations({
+      title: "\u4EF7\u7A0E\u5408\u8BA1",
+      description: "\u8FD4\u56DE\u4EF7\u7A0E\u5408\u8BA1\uFF08\u5C0F\u5199\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\u3002\u5927\u5199\u680F\u7531\u8BE5\u503C\u672C\u5730\u63A8\u5BFC\uFF08\u5982 `\u9646\u4EDF\u67D2\u4F70\u96F6\u9646\u5706\u58F9\u89D2\u6574`\u3001\u8D1F\u6570\u4E3A `\uFF08\u8D1F\u6570\uFF09\u53C1\u4F70\u96F6\u634C\u5706\u6574`\uFF09\uFF0C\u65E0\u9700\u53E6\u884C\u914D\u7F6E"
+    }),
+    remark: Schema.optional(CelText.annotations({
+      title: "\u5907\u6CE8",
+      description: "\u8FD4\u56DE\u5907\u6CE8\uFF08`string`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u6309\u6362\u884C\u539F\u6837\u6E32\u67D3\u3002\u5F00\u6237\u884C\u3001\u94F6\u884C\u8D26\u53F7\u3001\u7EA2\u5B57\u53D1\u7968\u4FE1\u606F\u786E\u8BA4\u5355\u7F16\u53F7\u7B49\u5747\u5C5E\u6B64\u680F"
+    })),
+    issuer: Schema.optional(CelText.annotations({
+      title: "\u5F00\u7968\u4EBA",
+      description: "\u8FD4\u56DE\u5F00\u7968\u4EBA\u59D3\u540D\uFF08`string`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u7559\u7A7A\u5219\u4E0D\u5C55\u793A"
+    })),
+    redLetter: Schema.optional(CelBool.annotations({
+      title: "\u7EA2\u5B57\u53D1\u7968",
+      description: "\u8FD4\u56DE `bool` \u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u4E3A `true` \u65F6\u7968\u9762\u4E2D\u592E\u53E0\u52A0\u300C\u7EA2\u5B57\u53D1\u7968\u300D\u6C34\u5370\u3002\u7559\u7A7A\u5219\u4E0D\u5C55\u793A\u6C34\u5370"
+    }))
+  }).annotations({
+    title: "\u6570\u7535\u7968\u5757",
+    description: "\u6309\u56FD\u5BB6\u7A0E\u52A1\u603B\u5C40\u7248\u5F0F\u6E32\u67D3\u4E00\u5F20\u6570\u7535\u7968\uFF08\u589E\u503C\u7A0E\u4E13\u7528\u53D1\u7968 / \u666E\u901A\u53D1\u7968\uFF09\uFF0C\u7968\u9762\u5404\u680F\u7531 CEL \u8868\u8FBE\u5F0F\u6620\u5C04"
+  });
+}
+export function defaultBody() {
+  return {
+    invoiceNumber: "",
+    issueDate: "",
+    buyer: { name: "", taxId: "" },
+    seller: { name: "", taxId: "" },
+    items: "[]",
+    line: { name: "", amount: "" },
+    totalAmount: "",
+    totalTax: "",
+    grandTotal: ""
+  };
+}

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.textarea/config.d.vue.ts

@@ -39,6 +39,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly maxLength?: number | undefined;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -50,7 +51,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
-        readonly maxLength?: number | undefined;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -89,6 +89,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly maxLength?: number | undefined;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -100,7 +101,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
-        readonly maxLength?: number | undefined;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.textarea/config.vue.d.ts

@@ -39,6 +39,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly maxLength?: number | undefined;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -50,7 +51,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
-        readonly maxLength?: number | undefined;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -89,6 +89,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly maxLength?: number | undefined;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -100,7 +101,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
-        readonly maxLength?: number | undefined;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/form/fields/2026-06-09/com.shwfed.form.field.upload/config.d.vue.ts

@@ -32,6 +32,23 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly required?: string | undefined;
         readonly displayName?: string | undefined;
+        readonly download?: {
+            readonly label?: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]] | undefined;
+            readonly icon?: string | undefined;
+            readonly operations: readonly {
+                readonly id?: string | undefined;
+                readonly params?: unknown;
+                readonly compatibilityDate?: string | undefined;
+                readonly target: string;
+                readonly operation: string;
+            }[];
+        } | undefined;
         readonly compatibilityDate: "2026-06-09";
         readonly orientation?: "vertical" | "floating" | undefined;
         readonly placeholder?: readonly [{
@@ -106,6 +123,23 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly required?: string | undefined;
         readonly displayName?: string | undefined;
+        readonly download?: {
+            readonly label?: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]] | undefined;
+            readonly icon?: string | undefined;
+            readonly operations: readonly {
+                readonly id?: string | undefined;
+                readonly params?: unknown;
+                readonly compatibilityDate?: string | undefined;
+                readonly target: string;
+                readonly operation: string;
+            }[];
+        } | undefined;
         readonly compatibilityDate: "2026-06-09";
         readonly orientation?: "vertical" | "floating" | undefined;
         readonly placeholder?: readonly [{

package/dist/runtime/components/form/fields/2026-06-09/com.shwfed.form.field.upload/config.vue

@@ -1,9 +1,11 @@
 <script setup>
 import { Icon } from "@iconify/vue";
-import { computed, ref, watch } from "vue";
+import { computed, defineComponent, ref, watch } from "vue";
 import {
   useTreeDnd
 } from "../../../../../composables/useTreeDnd";
+import TriggersField from "../../../../actions/components/triggers-field.vue";
+import { provideCELContext } from "../../../../../utils/cel-context";
 import {
   DropdownMenu,
   DropdownMenuContent,
@@ -273,6 +275,52 @@ function setMultiple(v) {
     value.value = { ...value.value, multiple: true };
   }
 }
+const downloadEnabled = computed(() => value.value.download != null);
+function setDownloadEnabled(on) {
+  if (on) {
+    if (value.value.download) return;
+    value.value = { ...value.value, download: { operations: [] } };
+  } else {
+    const { download: _omit, ...rest } = value.value;
+    value.value = rest;
+  }
+}
+const downloadOperations = computed(() => value.value.download?.operations ?? []);
+function updateDownloadOperations(next) {
+  const current = value.value.download;
+  if (!current) return;
+  value.value = { ...value.value, download: { ...current, operations: next } };
+}
+function updateDownloadIcon(icon) {
+  const current = value.value.download;
+  if (!current) return;
+  const trimmed = icon.trim();
+  if (trimmed.length === 0) {
+    const { icon: _omit, ...rest } = current;
+    value.value = { ...value.value, download: rest };
+  } else {
+    value.value = { ...value.value, download: { ...current, icon: trimmed } };
+  }
+}
+function updateDownloadLabel(label) {
+  const current = value.value.download;
+  if (!current) return;
+  if (label == null || label.length === 0) {
+    const { label: _omit, ...rest } = current;
+    value.value = { ...value.value, download: rest };
+  } else {
+    value.value = { ...value.value, download: { ...current, label } };
+  }
+}
+const DownloadScope = defineComponent({
+  name: "ShwfedUploadDownloadScope",
+  setup(_, { slots }) {
+    provideCELContext({
+      file: { type: FILE_VAR.type, label: FILE_VAR.label, description: FILE_VAR.description, value: () => void 0 }
+    });
+    return () => slots.default?.();
+  }
+});
 </script>
 
 <template>
@@ -693,6 +741,66 @@ function setMultiple(v) {
       </Field>
     </div>
 
+    <!-- Per-file download -->
+    <div class="flex items-center gap-2">
+      <h3 class="text-xs font-medium text-zinc-500">
+        {{ fieldTitle("download") }}
+      </h3>
+      <Switch
+        size="sm"
+        :model-value="downloadEnabled"
+        aria-label="启用文件下载"
+        @update:model-value="setDownloadEnabled"
+      />
+    </div>
+
+    <div
+      v-if="downloadEnabled"
+      class="flex flex-col gap-3"
+    >
+      <div class="grid grid-cols-2 gap-3">
+        <Field orientation="vertical">
+          <FieldLabel class="text-xs text-zinc-500">
+            下载按钮图标
+          </FieldLabel>
+          <IconPicker
+            :model-value="value.download?.icon ?? ''"
+            @update:model-value="updateDownloadIcon"
+          />
+        </Field>
+
+        <Field orientation="vertical">
+          <FieldLabel class="text-xs text-zinc-500">
+            下载按钮文本
+          </FieldLabel>
+          <LocaleField
+            translate-hint="file download button label"
+            :model-value="value.download?.label"
+            @update:model-value="updateDownloadLabel"
+          />
+        </Field>
+      </div>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              source="点击文件项的下载按钮时按顺序执行的操作；可用 `file` 引用该文件项。尚未上传的本地文件会直接从内存下载，不经过此列表"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          触发操作
+        </FieldLabel>
+        <DownloadScope>
+          <TriggersField
+            :triggers="downloadOperations"
+            @update:triggers="updateDownloadOperations"
+          />
+        </DownloadScope>
+      </Field>
+    </div>
+
     <!-- Download templates -->
     <Field orientation="vertical">
       <FieldLabel class="text-xs text-zinc-500">