@shwfed/config 3.0.12 → 3.0.13

package/dist/runtime/components/ui/invoice/InvoiceSheet.vue.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 数电票的票面骨架。国家税务总局的数电票是**一张底版 + 逐业务的差异**：抬头（双线标题 /
+ * 发票号码 / 开票日期）、购销双方、明细三表对齐、合计、价税合计大小写、备注框、开票人
+ * 在全家族逐像素相同；只有「业务标签」「明细有哪些列」「备注里有哪些栏」逐票不同。
+ * 这里收口相同的那部分，差异走 slot。
+ *
+ * 列宽（`colgroup`）刻意由调用方给：明细列逐业务不同，但**同一张票的三张表必须共用同
+ * 一份 colgroup** 才对得齐，所以它属于「块自己写一份、三处都用」，不属于骨架。同理
+ * 合计行（`items-foot`）—— 金额 / 税额落在第几列取决于该票的列，骨架不该猜。
+ */
+type __VLS_Props = {
+    /** 票面标题全文，如 `电子发票（增值税专用发票）`。骨架不认识票种。 */
+    title: string;
+    invoiceNumber: string;
+    issueDate: string;
+    buyer: {
+        name: string;
+        taxId: string;
+    };
+    seller: {
+        name: string;
+        taxId: string;
+    };
+    /** 价税合计（小写）。已格式化，空串即不打印 `¥`。 */
+    grandTotal: string;
+    /** 价税合计（大写）。空串即留空 —— 见 `useInvoiceEval` 的 `capital`。 */
+    grandTotalCapital: string;
+    issuer?: string;
+    /** 为真时票面中央叠加「红字发票」水印。 */
+    redLetter?: boolean;
+    /** 明细列数 —— 只用来给填充空行的 `colspan` 定宽。 */
+    columnCount: number;
+    /** 实际明细行数 —— 骨架据此补足填充空行。 */
+    rowCount: number;
+    /** 明细区最大高度（CSS 长度）。留空则明细区随行数增长，滚动条永不出现。 */
+    itemsMaxHeight?: string;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {};
+type __VLS_Slots = {} & {
+    business?: (props: typeof __VLS_1) => any;
+} & {
+    colgroup?: (props: typeof __VLS_3) => any;
+} & {
+    'items-head'?: (props: typeof __VLS_5) => any;
+} & {
+    colgroup?: (props: typeof __VLS_13) => any;
+} & {
+    'items-body'?: (props: typeof __VLS_15) => any;
+} & {
+    colgroup?: (props: typeof __VLS_17) => any;
+} & {
+    'items-foot'?: (props: typeof __VLS_19) => any;
+} & {
+    remark?: (props: typeof __VLS_21) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    redLetter: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/ui/invoice/index.d.ts

@@ -0,0 +1 @@
+export { default as InvoiceSheet } from './InvoiceSheet.vue.js';

package/dist/runtime/components/ui/invoice/index.js

@@ -0,0 +1 @@
+export { default as InvoiceSheet } from "./InvoiceSheet.vue";

package/dist/runtime/components/ui/invoice-config/InvoiceConfigShell.d.vue.ts

@@ -0,0 +1,36 @@
+/**
+ * 票面配置面的外壳：左栏是票面分区导航，右栏是当前分区的栏位。分区**有哪些**逐票
+ * 不同（不动产系多一个「不动产信息」分区），但「按票面自上而下的阅读顺序分区、左选
+ * 右填」这套是全家族一致的，故收口在此。
+ *
+ * 右栏内容整个走默认 slot —— 调用方按自己的 `section` 分支渲染。壳不认识分区语义，
+ * 只负责选中态与布局。
+ */
+type __VLS_Props = {
+    sections: ReadonlyArray<{
+        key: string;
+        label: string;
+        icon: string;
+    }>;
+};
+type __VLS_ModelProps = {
+    'section': string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_12: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_12) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:section": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:section"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/ui/invoice-config/InvoiceConfigShell.vue

@@ -0,0 +1,41 @@
+<script setup>
+import { Icon } from "@iconify/vue";
+import { ScrollArea } from "../scroll-area";
+defineOptions({ name: "ShwfedInvoiceConfigShell" });
+defineProps({
+  sections: { type: Array, required: true }
+});
+const section = defineModel("section", { type: String, ...{ required: true } });
+</script>
+
+<template>
+  <div class="flex min-w-0 gap-2 min-h-128">
+    <!-- 左栏：票面分区 -->
+    <div class="flex w-44 shrink-0 flex-col">
+      <ScrollArea class="flex-1">
+        <div
+          v-for="s in sections"
+          :key="s.key"
+          class="row"
+          :class="section === s.key ? 'bg-[color-mix(in_srgb,var(--primary)_10%,white)] text-(--primary)' : 'text-zinc-700 hover:bg-zinc-50'"
+          @click="section = s.key"
+        >
+          <Icon
+            :icon="s.icon"
+            class="size-4 shrink-0"
+          />
+          <span class="flex-1 truncate">{{ s.label }}</span>
+        </div>
+      </ScrollArea>
+    </div>
+
+    <!-- 右栏 -->
+    <div class="flex min-w-0 flex-1 flex-col gap-3">
+      <slot />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.row{align-items:center;border-radius:.25rem;cursor:pointer;display:flex;font-size:.875rem;gap:.375rem;padding-block:.375rem;padding-left:.5rem;padding-right:.5rem;position:relative;transition:background-color .1s ease;-webkit-user-select:none;-moz-user-select:none;user-select:none}
+</style>

package/dist/runtime/components/ui/invoice-config/InvoiceConfigShell.vue.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 票面配置面的外壳：左栏是票面分区导航，右栏是当前分区的栏位。分区**有哪些**逐票
+ * 不同（不动产系多一个「不动产信息」分区），但「按票面自上而下的阅读顺序分区、左选
+ * 右填」这套是全家族一致的，故收口在此。
+ *
+ * 右栏内容整个走默认 slot —— 调用方按自己的 `section` 分支渲染。壳不认识分区语义，
+ * 只负责选中态与布局。
+ */
+type __VLS_Props = {
+    sections: ReadonlyArray<{
+        key: string;
+        label: string;
+        icon: string;
+    }>;
+};
+type __VLS_ModelProps = {
+    'section': string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_12: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_12) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:section": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:section"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/{config/blocks/2026-07-17/com.shwfed.block.invoice.digital/expr-field.vue → ui/invoice-config/InvoiceExprField.vue}

@@ -1,8 +1,8 @@
 <script setup>
-import { ExpressionEditor } from "../../../../ui/expression-editor";
-import { Field, FieldLabel } from "../../../../ui/field";
-import { Markdown } from "../../../../ui/markdown";
-defineOptions({ name: "ShwfedBlockInvoiceDigitalExprField" });
+import { ExpressionEditor } from "../expression-editor";
+import { Field, FieldLabel } from "../field";
+import { Markdown } from "../markdown";
+defineOptions({ name: "ShwfedInvoiceExprField" });
 defineProps({
   label: { type: String, required: true },
   description: { type: String, required: false },

package/dist/runtime/components/{config/blocks/2026-07-17/com.shwfed.block.invoice.digital/json-scope-provider.vue → ui/invoice-config/InvoiceJsonScope.vue}

@@ -1,7 +1,7 @@
 <script setup>
-import { injectCELContext, provideCELContext } from "../../../../../utils/cel-context";
-import { JSON_VAR } from "./schema";
-defineOptions({ name: "ShwfedBlockInvoiceDigitalJsonScopeProvider" });
+import { injectCELContext, provideCELContext } from "../../../utils/cel-context";
+import { JSON_VAR } from "../../../share/invoice";
+defineOptions({ name: "ShwfedInvoiceJsonScope" });
 if (!injectCELContext().json) {
   provideCELContext({
     json: {

package/dist/runtime/components/{config/blocks/2026-07-17/com.shwfed.block.invoice.digital/row-scope-provider.vue → ui/invoice-config/InvoiceRowScope.vue}

@@ -1,6 +1,6 @@
 <script setup>
-import { provideCELContext } from "../../../../../utils/cel-context";
-defineOptions({ name: "ShwfedBlockInvoiceDigitalRowScopeProvider" });
+import { provideCELContext } from "../../../utils/cel-context";
+defineOptions({ name: "ShwfedInvoiceRowScope" });
 provideCELContext({
   item: {
     type: "dyn",

package/dist/runtime/components/ui/invoice-config/index.d.ts

@@ -0,0 +1,4 @@
+export { default as InvoiceConfigShell } from './InvoiceConfigShell.vue.js';
+export { default as InvoiceExprField } from './InvoiceExprField.vue.js';
+export { default as InvoiceJsonScope } from './InvoiceJsonScope.vue.js';
+export { default as InvoiceRowScope } from './InvoiceRowScope.vue.js';

package/dist/runtime/components/ui/invoice-config/index.js

@@ -0,0 +1,4 @@
+export { default as InvoiceConfigShell } from "./InvoiceConfigShell.vue";
+export { default as InvoiceExprField } from "./InvoiceExprField.vue";
+export { default as InvoiceJsonScope } from "./InvoiceJsonScope.vue";
+export { default as InvoiceRowScope } from "./InvoiceRowScope.vue";

package/dist/runtime/share/invoice-eval.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @param requestExpr 读「请求」表达式的 getter（可选字段，未配置时返回 `undefined`）。
+ *   getter 而不是值 —— 编辑器里改表达式要能重取，composable 自己 watch 它。
+ */
+export declare function useInvoiceEval(requestExpr: () => string | undefined): {
+    json: import("vue").Ref<unknown, unknown>;
+    evaluate: (expression: string | undefined, scope?: Record<string, unknown>) => unknown;
+    text: (expression: string | undefined, scope?: Record<string, unknown>) => string;
+    money: (expression: string | undefined, scope?: Record<string, unknown>) => string;
+    plain: (expression: string | undefined, scope?: Record<string, unknown>) => string;
+    bool: (expression: string | undefined, scope?: Record<string, unknown>) => boolean;
+    capital: (expression: string | undefined) => string;
+};

package/dist/runtime/share/invoice-eval.js

@@ -0,0 +1,88 @@
+import { computed, onMounted, ref, watch } from "vue";
+import { Effect, Option } from "effect";
+import { Fetch } from "fx-fetch";
+import { cel } from "../utils/cel.js";
+import { celBindings, injectCELContext } from "../utils/cel-context.js";
+import { fetchJsonOption } from "./request.js";
+import { toCapital } from "./rmb.js";
+const MONEY_FORMAT = new Intl.NumberFormat("zh-CN", {
+  minimumFractionDigits: 2,
+  maximumFractionDigits: 2
+});
+function toFiniteNumber(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : null;
+  if (typeof v === "string" && v.trim() !== "") {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
+  }
+  return null;
+}
+export function useInvoiceEval(requestExpr) {
+  const inheritedContext = injectCELContext();
+  const json = ref(void 0);
+  const jsonOption = computed(
+    () => json.value === void 0 ? Option.none() : Option.some(json.value)
+  );
+  const hasRequest = computed(() => {
+    const expr = requestExpr();
+    return !!expr && expr.trim().length > 0;
+  });
+  function baseContext() {
+    const inherited = celBindings(inheritedContext);
+    if (!hasRequest.value && "json" in inherited) return inherited;
+    return { ...inherited, json: jsonOption.value };
+  }
+  async function refresh() {
+    const expr = requestExpr();
+    if (!expr || expr.trim().length === 0) {
+      json.value = void 0;
+      return;
+    }
+    const program = Effect.gen(function* () {
+      const body = yield* fetchJsonOption(
+        yield* cel(expr, celBindings(inheritedContext))
+      );
+      return Option.getOrUndefined(body);
+    });
+    try {
+      json.value = await Effect.runPromise(Effect.provide(program, Fetch.layer));
+    } catch (err) {
+      console.warn("[shwfed-invoice] request failed", err);
+      json.value = void 0;
+    }
+  }
+  onMounted(() => void refresh());
+  watch(() => requestExpr() ?? "", () => void refresh());
+  function evaluate(expression, scope) {
+    if (!expression || expression.trim().length === 0) return void 0;
+    try {
+      return Effect.runSync(cel(expression, { ...baseContext(), ...scope }));
+    } catch (err) {
+      console.warn("[shwfed-invoice] expression evaluation failed", expression, err);
+      return void 0;
+    }
+  }
+  function text(expression, scope) {
+    const v = evaluate(expression, scope);
+    return v === null || v === void 0 ? "" : String(v);
+  }
+  function money(expression, scope) {
+    const v = evaluate(expression, scope);
+    if (v === null || v === void 0) return "";
+    if (typeof v === "number") return Number.isFinite(v) ? MONEY_FORMAT.format(v) : "";
+    return String(v);
+  }
+  function plain(expression, scope) {
+    const v = evaluate(expression, scope);
+    if (v === null || v === void 0) return "";
+    return String(v);
+  }
+  function bool(expression, scope) {
+    return evaluate(expression, scope) === true;
+  }
+  function capital(expression) {
+    const n = toFiniteNumber(evaluate(expression));
+    return n === null ? "" : toCapital(n) ?? "";
+  }
+  return { json, evaluate, text, money, plain, bool, capital };
+}

package/dist/runtime/share/invoice.d.ts

@@ -0,0 +1,68 @@
+import { Schema } from 'effect';
+import type { Environment } from '../vendor/cel-js/lib/index.js';
+import type { ResultType } from './expression.js';
+/**
+ * The pieces every 数电票 block shares. The 税总 invoice family (通用数电票、不动产
+ * 经营租赁服务、不动产销售、建筑服务…) is one 版式 with a per-业务 label, per-业务
+ * 明细 columns and a per-业务 备注 — everything else (抬头 / 购销双方 / 合计 /
+ * 价税合计 / 开票人) is byte-identical across members. This module holds the schema
+ * half of that overlap; `ui/invoice` holds the rendering half and `share/
+ * invoice-eval.ts` the per-栏 evaluation.
+ *
+ * Deliberately NOT a "common fields" factory: each block composes its own
+ * `Schema.Struct` so that `type` / `compatibilityDate` stay literal `Schema.tag`s
+ * at the folder that owns them. A factory would have to take those as arguments
+ * and hand back a half-built struct — more indirection than the duplication it
+ * would remove.
+ */
+export type Configure = (env: Environment) => void;
+/**
+ * 票面绝大多数栏位是文本。上下文取值的表达式常被 CEL 推断为 `dyn`（只在运行时收
+ * 窄），所以与 animated-number / card 的字符串字段一样容忍 `dyn` / `optional`。
+ */
+export declare const textResult: ResultType;
+/**
+ * 金额类栏位同时接受 `number` 与 `string`：格式化规则是「返回 string 原样打印，
+ * 返回 number 按票面惯例格式化」（见 `share/invoice-eval.ts` 的 `money`）。后端常以
+ * string 传小数以免丢精度，作者也可借此完全接管格式。
+ */
+export declare const moneyResult: ResultType;
+export declare const listResult: ResultType;
+export declare const boolResult: ResultType;
+/**
+ * 票面自己的（可选）取数：`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）";
+};
+/**
+ * 登记 `json`，但外层 `configure` 已经声明过就跳过 —— 宿主（详情页）本来就可能把自己
+ * 的响应体以 `json` 喂进来，重复声明会被 CEL 注册表拒掉（`'json' is already
+ * registered`），整个配置面直接抛错。与 `registerLoopVariablesIfAbsent` 同解。
+ *
+ * 外层已有时以**外层的声明为准**（类型通常是 `dyn` 而不是这里的 `optional<dyn>`）。
+ * 运行期的对应规则见 `share/invoice-eval.ts` 的 `baseContext`：配了「请求」本块的
+ * 响应体遮蔽外层的 `json`，没配则外层的 `json` 原样透传。
+ */
+export declare function registerJsonIfAbsent(env: Environment): void;
+/**
+ * 购买方 / 销售方信息栏。票面只有「名称」与「统一社会信用代码/纳税人识别号」两栏 ——
+ * 开户行与账号在真实发票上属于「备注」栏的自由文本（不是独立栏位），因此不建模，
+ * 由各块的备注承载。整个发票家族逐字相同，故在此共享。
+ */
+export declare function partySchema(configure: Configure, role: '购买方' | '销售方'): Schema.Struct<{
+    name: Schema.Schema<string, string, never>;
+    taxId: Schema.Schema<string, string, never>;
+}>;
+export type PartyValue = Schema.Schema.Type<ReturnType<typeof partySchema>>;

package/dist/runtime/share/invoice.js

@@ -0,0 +1,35 @@
+import { Schema } from "effect";
+import { Expression } from "./expression.js";
+export const textResult = (t) => t === "string" || t === "dyn" || t.startsWith("optional");
+export const moneyResult = (t) => t === "number" || t === "string" || t === "dyn" || t.startsWith("optional");
+export const listResult = (t) => t === "dyn" || t.startsWith("list") || t.startsWith("optional");
+export const boolResult = (t) => t === "bool" || t === "dyn" || t.startsWith("optional");
+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"
+};
+export 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 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`
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shwfed/config",
-  "version": "3.0.12",
+  "version": "3.0.13",
   "description": "Configurable UI for SHWFED",
   "type": "module",
   "publishConfig": {