@shwfed/config 3.0.11 → 3.0.13

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

@@ -0,0 +1,39 @@
+<script setup>
+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 },
+  modelValue: { type: String, required: true },
+  placeholder: { type: String, required: false },
+  multiline: { type: Boolean, required: false }
+});
+defineEmits(["update:modelValue"]);
+</script>
+
+<template>
+  <Field orientation="vertical">
+    <FieldLabel class="text-xs text-zinc-500">
+      <template
+        v-if="description"
+        #tooltip
+      >
+        <Markdown
+          :source="description"
+          block
+          class="prose prose-sm prose-zinc"
+        />
+      </template>
+      {{ label }}
+    </FieldLabel>
+    <ExpressionEditor
+      :model-value="modelValue"
+      :placeholder="placeholder"
+      :multiline="multiline"
+      :class="multiline ? 'min-h-16' : void 0"
+      @update:model-value="(v) => $emit('update:modelValue', v)"
+    />
+  </Field>
+</template>

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

@@ -0,0 +1,14 @@
+type __VLS_Props = {
+    label: string;
+    description?: string;
+    modelValue: string;
+    placeholder?: string;
+    multiline?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (payload: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((payload: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, 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/InvoiceJsonScope.vue

@@ -0,0 +1,19 @@
+<script setup>
+import { injectCELContext, provideCELContext } from "../../../utils/cel-context";
+import { JSON_VAR } from "../../../share/invoice";
+defineOptions({ name: "ShwfedInvoiceJsonScope" });
+if (!injectCELContext().json) {
+  provideCELContext({
+    json: {
+      type: JSON_VAR.type,
+      label: JSON_VAR.label,
+      description: JSON_VAR.description,
+      value: void 0
+    }
+  });
+}
+</script>
+
+<template>
+  <slot />
+</template>

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

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, 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/InvoiceRowScope.d.vue.ts

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, 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/InvoiceRowScope.vue

@@ -0,0 +1,22 @@
+<script setup>
+import { provideCELContext } from "../../../utils/cel-context";
+defineOptions({ name: "ShwfedInvoiceRowScope" });
+provideCELContext({
+  item: {
+    type: "dyn",
+    label: "item",
+    description: "\u5F53\u524D\u660E\u7EC6\u9879",
+    value: void 0
+  },
+  index: {
+    type: "number",
+    label: "index",
+    description: "\u5F53\u524D\u660E\u7EC6\u9879\u5E8F\u53F7\uFF0C\u4ECE 0 \u5F00\u59CB",
+    value: void 0
+  }
+});
+</script>
+
+<template>
+  <slot />
+</template>

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

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, 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/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/dist/runtime/share/rmb.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 人民币金额小写 → 中文大写（票面「价税合计（大写）」栏）。
+ *
+ * 规则是国标固定的，所以在块内本地推导而不是多开一个配置字段 —— 大写与小写永远
+ * 不会不一致。负数（红字发票）走「（负数）」前缀，与税务总局版式一致。
+ */
+/**
+ * 金额 → 中文大写。`6706.1` → `陆仟柒佰零陆圆壹角整`，`-308` → `（负数）叁佰零捌圆整`。
+ * 超出「万亿」量级或非有限数返回 `null`，由调用方决定回退（票面留空）。
+ */
+export declare function toCapital(value: number): string | null;

package/dist/runtime/share/rmb.js

@@ -0,0 +1,58 @@
+const DIGITS = ["\u96F6", "\u58F9", "\u8D30", "\u53C1", "\u8086", "\u4F0D", "\u9646", "\u67D2", "\u634C", "\u7396"];
+const UNITS = ["", "\u62FE", "\u4F70", "\u4EDF"];
+const GROUPS = ["", "\u4E07", "\u4EBF", "\u4E07\u4EBF"];
+function groupToCapital(group) {
+  let out = "";
+  let zero = false;
+  for (let i = 0; i < group.length; i++) {
+    const digit = Number(group[i]);
+    if (digit === 0) {
+      zero = true;
+      continue;
+    }
+    if (zero && out !== "") out += "\u96F6";
+    zero = false;
+    out += DIGITS[digit] + UNITS[group.length - 1 - i];
+  }
+  return out;
+}
+function integerToCapital(digits) {
+  const trimmed = digits.replace(/^0+/, "");
+  if (trimmed === "") return "\u96F6";
+  const groups = [];
+  for (let end = trimmed.length; end > 0; end -= 4) {
+    groups.unshift(trimmed.slice(Math.max(0, end - 4), end));
+  }
+  let out = "";
+  let pendingZero = false;
+  groups.forEach((group, i) => {
+    if (Number(group) === 0) {
+      pendingZero = out !== "";
+      return;
+    }
+    let text = groupToCapital(group);
+    const leadingZero = group.length === 4 && group[0] === "0";
+    if ((pendingZero || leadingZero) && out !== "") text = `\u96F6${text}`;
+    pendingZero = false;
+    out += text + GROUPS[groups.length - 1 - i];
+  });
+  return out;
+}
+export function toCapital(value) {
+  if (!Number.isFinite(value)) return null;
+  const negative = value < 0;
+  const cents = Math.round(Math.abs(value) * 100);
+  const yuan = Math.floor(cents / 100);
+  const jiao = Math.floor(cents % 100 / 10);
+  const fen = cents % 10;
+  if (String(yuan).length > 16) return null;
+  let out = `${integerToCapital(String(yuan))}\u5706`;
+  if (jiao === 0 && fen === 0) {
+    out += "\u6574";
+  } else {
+    if (jiao > 0) out += `${DIGITS[jiao]}\u89D2`;
+    if (fen > 0) out += `${jiao === 0 ? "\u96F6" : ""}${DIGITS[fen]}\u5206`;
+    else out += "\u6574";
+  }
+  return negative ? `\uFF08\u8D1F\u6570\uFF09${out}` : out;
+}

package/package.json

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