@shwfed/config 2.12.11 → 2.12.14

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "shwfed",
   "configKey": "shwfed",
-  "version": "2.12.11",
+  "version": "2.12.14",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/runtime/components/actions/buttons/2026-06-25/com.shwfed.actions.button.state.write/config.d.vue.ts

@@ -13,6 +13,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly target: string;
             readonly operation: string;
         }[] | undefined;
+        readonly requests?: readonly {
+            readonly id: string;
+            readonly request: string;
+        }[] | undefined;
         readonly writes: readonly {
             readonly path: string;
             readonly value: string;
@@ -29,6 +33,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly target: string;
             readonly operation: string;
         }[] | undefined;
+        readonly requests?: readonly {
+            readonly id: string;
+            readonly request: string;
+        }[] | undefined;
         readonly writes: readonly {
             readonly path: string;
             readonly value: string;

package/dist/runtime/components/actions/buttons/2026-06-25/com.shwfed.actions.button.state.write/config.vue

@@ -8,6 +8,7 @@ import { Markdown } from "../../../../ui/markdown";
 import { InputGroupButton } from "../../../../ui/input-group";
 import { getStructFieldDescription, getStructFieldTitle } from "../../../schema";
 import TriggersField from "../../../components/triggers-field.vue";
+import TriggerRowScope from "../../../components/trigger-row-scope.vue";
 import { schema } from "./schema";
 defineOptions({ name: "ShwfedStateWriteActionConfig" });
 const value = defineModel({ type: null, ...{ required: true } });
@@ -16,9 +17,33 @@ const actionSchema = schema(() => {
 const fieldTitle = (f) => getStructFieldTitle(actionSchema, f) ?? f;
 const fieldDescription = (f) => getStructFieldDescription(actionSchema, f);
 const writes = computed(() => value.value.writes ?? []);
+const requests = computed(() => value.value.requests ?? []);
+const roster = computed(
+  () => requests.value.map((r, i) => ({
+    id: r.id,
+    label: `\u7B2C ${i + 1} \u6B65`,
+    valid: true,
+    description: "HTTP \u54CD\u5E94"
+  }))
+);
 function patchWrites(next) {
   value.value = { ...value.value, writes: next };
 }
+function patchRequests(next) {
+  const draft = { ...value.value };
+  if (next.length === 0) Reflect.deleteProperty(draft, "requests");
+  else draft.requests = next;
+  value.value = draft;
+}
+function updateRequestRow(index, patch) {
+  patchRequests(requests.value.map((r, i) => i === index ? { ...r, ...patch } : r));
+}
+function addRequestRow() {
+  patchRequests([...requests.value, { id: crypto.randomUUID(), request: "" }]);
+}
+function removeRequestRow(index) {
+  patchRequests(requests.value.filter((_, i) => i !== index));
+}
 function updateRow(index, patch) {
   patchWrites(writes.value.map((w, i) => i === index ? { ...w, ...patch } : w));
 }
@@ -41,40 +66,37 @@ function updateTriggers(next) {
     <Field orientation="vertical">
       <FieldLabel class="text-xs text-zinc-500">
         <template
-          v-if="fieldDescription('writes')"
+          v-if="fieldDescription('requests')"
           #tooltip
         >
           <Markdown
-            :source="fieldDescription('writes')"
+            :source="fieldDescription('requests')"
             block
             class="prose prose-sm prose-zinc"
           />
         </template>
-        {{ fieldTitle("writes") }}
+        {{ fieldTitle("requests") }}
       </FieldLabel>
 
       <div class="flex flex-col gap-3">
-        <!-- One write item, on a single line: a monofont binding path notched
-             into the editor's `leading` slot, the value expression in the
-             editor itself (its own `{x}` badge), and a destructive delete in
-             the `trailing` slot. Reuses the ExpressionEditor's own InputGroup. -->
+        <!-- One「写入前」request per line: a static「第 N 步」marker notched into
+             the editor's `leading` slot (its response is referenced positionally
+             as `steps["<id>"]`), the request expression in the editor, and a
+             destructive delete in the `trailing` slot. Outside `TriggerRowScope`
+             so the request expressions keep the base scope (no `steps`). -->
         <ExpressionEditor
-          v-for="(row, index) in writes"
-          :key="index"
-          :model-value="row.value"
-          placeholder="值，如 selected[?0].?exchangeRate"
-          @update:model-value="(v) => updateRow(index, { value: v })"
+          v-for="(row, index) in requests"
+          :key="row.id"
+          :model-value="row.request"
+          result-type="HttpRequest"
+          placeholder="请求，如 http.get('/api/rate')"
+          @update:model-value="(v) => updateRequestRow(index, { request: v })"
         >
           <template #leading>
-            <input
-              type="text"
-              data-slot="state-write-path"
-              :value="row.path"
-              placeholder="路径"
-              class="w-44 min-w-0 border-r border-zinc-200 bg-transparent pr-3 font-mono text-sm text-zinc-700 outline-none placeholder:text-zinc-300"
-              :aria-label="`\u5199\u5165\u8DEF\u5F84 ${index + 1}`"
-              @input="updateRow(index, { path: $event.target.value })"
-            >
+            <span
+              data-slot="state-write-request-step"
+              class="w-16 shrink-0 border-r border-zinc-200 pr-3 font-mono text-xs whitespace-nowrap text-zinc-500 select-none"
+            >第 {{ index + 1 }} 步</span>
           </template>
           <template #trailing>
             <InputGroupButton
@@ -84,8 +106,8 @@ function updateTriggers(next) {
             >
               <button
                 type="button"
-                :aria-label="`\u79FB\u9664\u5199\u5165\u9879 ${index + 1}`"
-                @click="removeRow(index)"
+                :aria-label="`\u79FB\u9664\u8BF7\u6C42 ${index + 1}`"
+                @click="removeRequestRow(index)"
               >
                 <Icon icon="fluent:delete-20-regular" />
               </button>
@@ -96,14 +118,85 @@ function updateTriggers(next) {
         <Button
           type="button"
           class="justify-center"
-          @click="addRow"
+          @click="addRequestRow"
         >
           <Icon icon="fluent:add-20-regular" />
-          <span>添加写入项</span>
+          <span>添加请求</span>
         </Button>
       </div>
     </Field>
 
+    <Field orientation="vertical">
+      <FieldLabel class="text-xs text-zinc-500">
+        <template
+          v-if="fieldDescription('writes')"
+          #tooltip
+        >
+          <Markdown
+            :source="fieldDescription('writes')"
+            block
+            class="prose prose-sm prose-zinc"
+          />
+        </template>
+        {{ fieldTitle("writes") }}
+      </FieldLabel>
+
+      <!-- Advertise the「写入前」requests as the step roster to the value
+           editors only: they get the「第 N 步」picker chips + `steps` inline
+           validation, while the request editors above keep the base scope. -->
+      <TriggerRowScope :roster="roster">
+        <div class="flex flex-col gap-3">
+          <!-- One write item, on a single line: a monofont binding path notched
+               into the editor's `leading` slot, the value expression in the
+               editor itself (its own `{x}` badge), and a destructive delete in
+               the `trailing` slot. Reuses the ExpressionEditor's own InputGroup. -->
+          <ExpressionEditor
+            v-for="(row, index) in writes"
+            :key="index"
+            :model-value="row.value"
+            placeholder="值，如 selected[?0].?exchangeRate"
+            @update:model-value="(v) => updateRow(index, { value: v })"
+          >
+            <template #leading>
+              <input
+                type="text"
+                data-slot="state-write-path"
+                :value="row.path"
+                placeholder="路径"
+                class="w-44 min-w-0 border-r border-zinc-200 bg-transparent pr-3 font-mono text-sm text-zinc-700 outline-none placeholder:text-zinc-300"
+                :aria-label="`\u5199\u5165\u8DEF\u5F84 ${index + 1}`"
+                @input="updateRow(index, { path: $event.target.value })"
+              >
+            </template>
+            <template #trailing>
+              <InputGroupButton
+                variant="destructive"
+                size="icon-xs"
+                as-child
+              >
+                <button
+                  type="button"
+                  :aria-label="`\u79FB\u9664\u5199\u5165\u9879 ${index + 1}`"
+                  @click="removeRow(index)"
+                >
+                  <Icon icon="fluent:delete-20-regular" />
+                </button>
+              </InputGroupButton>
+            </template>
+          </ExpressionEditor>
+
+          <Button
+            type="button"
+            class="justify-center"
+            @click="addRow"
+          >
+            <Icon icon="fluent:add-20-regular" />
+            <span>添加写入项</span>
+          </Button>
+        </div>
+      </TriggerRowScope>
+    </Field>
+
     <Field orientation="vertical">
       <FieldLabel class="text-xs text-zinc-500">
         <template

package/dist/runtime/components/actions/buttons/2026-06-25/com.shwfed.actions.button.state.write/config.vue.d.ts

@@ -13,6 +13,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly target: string;
             readonly operation: string;
         }[] | undefined;
+        readonly requests?: readonly {
+            readonly id: string;
+            readonly request: string;
+        }[] | undefined;
         readonly writes: readonly {
             readonly path: string;
             readonly value: string;
@@ -29,6 +33,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly target: string;
             readonly operation: string;
         }[] | undefined;
+        readonly requests?: readonly {
+            readonly id: string;
+            readonly request: string;
+        }[] | undefined;
         readonly writes: readonly {
             readonly path: string;
             readonly value: string;

package/dist/runtime/components/actions/buttons/2026-06-25/com.shwfed.actions.button.state.write/runtime.vue

@@ -1,9 +1,11 @@
 <script setup>
-import { Effect } from "effect";
+import { Effect, Option } from "effect";
+import { Fetch } from "fx-fetch";
 import { createDefu } from "defu";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { dispatchTriggers, useEventChannel } from "../../../../../share/event-bus";
+import { asRequest } from "../../../../../share/request";
 import { useFormState } from "../../../../form/utils/state";
 import ShwfedActionDefinition from "../../../components/definition.vue";
 defineOptions({ name: "ShwfedStateWriteActionRuntime" });
@@ -31,27 +33,52 @@ function mergeAtPath(current, next) {
   }
   return next;
 }
-const effect = Effect.suspend(
-  () => Effect.flatMap(
-    // Evaluate every row's `value` in list order. A row with a blank `path` is
-    // skipped (a half-authored row writes nowhere) but its value is never
-    // evaluated — `Effect.forEach` keeps the click sequential and short-circuits
-    // on the first failing expression, matching the old map-eval-then-write.
-    Effect.forEach(
-      props.config.writes ?? [],
-      (write) => {
-        const path = write.path?.trim() ?? "";
-        if (path.length === 0) return Effect.void;
-        return Effect.map($cel(write.value), (result) => {
-          const merged = mergeAtPath(formState.getAt(path), result);
-          formState.setAt(path, merged);
-        });
-      },
-      { discard: true }
+const effect = Effect.suspend(() => {
+  const steps = {};
+  return Effect.forEach(
+    // 写入前: issue each request in list order against the base scope (no
+    // `steps` — requests can't reference each other). `asRequest` maps the
+    // evaluated value to `Some(builder)` / `None` (author opted out → skip the
+    // fetch, leaving `steps["<id>"]` unset). A failed `.json()` short-circuits
+    // the whole click before any write runs — the effect fails and the action
+    // runner absorbs it, exactly as a failing `value` expression does.
+    props.config.requests ?? [],
+    (request) => Effect.flatMap($cel(request.request), (evaluated) => {
+      const builder = asRequest(evaluated);
+      if (Option.isNone(builder)) return Effect.void;
+      return Effect.map(builder.value.json(), (json) => {
+        steps[request.id] = json;
+      });
+    }),
+    { discard: true }
+  ).pipe(
+    Effect.flatMap(
+      () => (
+        // Evaluate every row's `value` in list order. A row with a blank `path` is
+        // skipped (a half-authored row writes nowhere) but its value is never
+        // evaluated — `Effect.forEach` keeps the click sequential and short-circuits
+        // on the first failing expression, matching the old map-eval-then-write.
+        Effect.forEach(
+          props.config.writes ?? [],
+          (write) => {
+            const path = write.path?.trim() ?? "";
+            if (path.length === 0) return Effect.void;
+            return Effect.map($cel(write.value, { steps }), (result) => {
+              const merged = mergeAtPath(formState.getAt(path), result);
+              formState.setAt(path, merged);
+            });
+          },
+          { discard: true }
+        )
+      )
     ),
-    () => dispatchTriggers(channel, props.config.onSuccess, $cel)
-  )
-);
+    Effect.flatMap(() => dispatchTriggers(channel, props.config.onSuccess, $cel)),
+    // The request builders need a `Fetch` layer; `ShwfedActionDefinition` runs
+    // the effect with no requirements channel, so provide it here — same layer
+    // the request op/button use.
+    Effect.provide(Fetch.layer)
+  );
+});
 </script>
 
 <template>

package/dist/runtime/components/actions/buttons/2026-06-25/com.shwfed.actions.button.state.write/schema.d.ts

@@ -9,6 +9,10 @@ export declare const metadata: {
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     type: Schema.Literal<["com.shwfed.actions.button.state.write"]>;
     compatibilityDate: Schema.Literal<["2026-06-25"]>;
+    requests: Schema.optional<Schema.Array$<Schema.Struct<{
+        id: Schema.refine<string, typeof Schema.String>;
+        request: Schema.Schema<string, string, never>;
+    }>>>;
     writes: Schema.Array$<Schema.Struct<{
         path: Schema.SchemaClass<string, string, never>;
         value: Schema.Schema<string, string, never>;
@@ -23,3 +27,4 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
 }>;
 export type Value = Schema.Schema.Type<ReturnType<typeof schema>>;
 export type WriteValue = Value['writes'][number];
+export type RequestValue = NonNullable<Value['requests']>[number];

package/dist/runtime/components/actions/buttons/2026-06-25/com.shwfed.actions.button.state.write/schema.js

@@ -2,6 +2,7 @@ import { Schema } from "effect";
 import { Expression } from "../../../../../share/expression.js";
 import { Triggers } from "../../../../../share/event-bus.js";
 import { md } from "../../../../../share/markdown.js";
+import { registerStepsVariableIfAbsent } from "../../../../operations/utils/step-vars.js";
 export const type = "com.shwfed.actions.button.state.write";
 export const compatibilityDate = "2026-06-25";
 export const metadata = {
@@ -9,19 +10,41 @@ export const metadata = {
   icon: "fluent:document-edit-20-regular"
 };
 export function schema(configure) {
+  const withSteps = (env) => {
+    configure(env);
+    registerStepsVariableIfAbsent(env);
+  };
   const Write = Schema.Struct({
     path: Schema.String.annotations({
       title: "\u8DEF\u5F84",
       description: "\u5199\u5165\u7684\u7ED1\u5B9A\u8DEF\u5F84\uFF0C\u5982 `dataJson.cus_currency`"
     }),
-    value: Expression({ configure }).annotations({
+    value: Expression({ configure: withSteps }).annotations({
       title: "\u503C",
       description: "\u70B9\u51FB\u540E\u6C42\u503C\uFF0C\u7ED3\u679C\u5199\u5165\u8BE5\u8DEF\u5F84"
     })
   });
+  const Request = Schema.Struct({
+    id: Schema.UUID.annotations({
+      title: "ID",
+      description: '\u8BF7\u6C42\u6807\u8BC6\uFF0C\u5199\u5165\u503C\u7ECF `steps["<id>"]` \u5F15\u7528'
+    }),
+    request: Expression({ configure, resultType: "HttpRequest" }).annotations({
+      title: "\u8BF7\u6C42",
+      description: "\u6784\u9020\u4E00\u4E2A\u8BF7\u6C42\uFF0C\u670D\u52A1\u5668\u987B\u8FD4\u56DE JSON \u54CD\u5E94\uFF1B\u7ED3\u679C\u6309\u300C\u7B2C N \u6B65\u300D\u5B58\u5165 `steps`"
+    })
+  });
   return Schema.Struct({
     type: Schema.Literal(type),
     compatibilityDate: Schema.Literal(compatibilityDate),
+    requests: Schema.optional(Schema.Array(Request).annotations({
+      title: "\u5199\u5165\u524D",
+      description: md`
+        点击后先按列表顺序发起这些请求，其响应可在「写入值」中经
+        \`steps["<第 N 步>"]\` 引用。任一请求失败（网络错误 / 非 2xx / 不可解析）
+        则中止，不进行任何写入。
+      `
+    })),
     writes: Schema.Array(Write).annotations({
       title: "\u5199\u5165\u503C",
       description: md`

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-04-28/com.shwfed.form.field.number/runtime.vue

@@ -1,13 +1,13 @@
 <script setup>
 import { Icon } from "@iconify/vue";
 import { Effect } from "effect";
-import { computed, nextTick } from "vue";
+import { computed, nextTick, watch } from "vue";
 import { useI18n } from "vue-i18n";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { getLocalizedText } from "../../../../../share/locale";
 import { interpolateMarkdown } from "../../../../table/utils/runtime";
-import { formatNumberDisplay } from "../../../../../share/number-format";
+import { formatNumberDisplay, roundToPrecision } from "../../../../../share/number-format";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupNumberField } from "../../../../ui/input-group";
 import { Markdown } from "../../../../ui/markdown";
@@ -16,7 +16,7 @@ import { DEFAULT_FIELD_ORIENTATION } from "../../../utils/common";
 import { useFieldValue } from "../../../utils/field-value";
 import { useFieldValidation } from "../../../utils/validation";
 import { useFormReadonly } from "../../../utils/readonly";
-import { useFormScope } from "../../../utils/state";
+import { useFormScope, useFormState } from "../../../utils/state";
 defineOptions({ name: "ShwfedNumberFieldRuntime" });
 const props = defineProps({
   fieldId: { type: String, required: true },
@@ -86,22 +86,29 @@ const { draft, commit } = useFieldValue({
     return props.config.valueAsString ? String(next) : next;
   }
 });
+const bag = useFormState();
+watch(
+  () => [props.config.binding, props.config.precision, props.config.roundingMode, props.config.valueAsString],
+  ([binding, precision, roundingMode, valueAsString], _prev, onCleanup) => {
+    if (binding == null || precision === void 0) return;
+    const mode = roundingMode ?? "round";
+    const unregister = bag.registerCoercion(binding, (value) => {
+      let n;
+      if (typeof value === "number" && Number.isFinite(value)) n = value;
+      else if (typeof value === "string" && value.length > 0 && Number.isFinite(Number(value))) n = Number(value);
+      if (n === void 0) return value;
+      const rounded = roundToPrecision(n, precision, mode);
+      return valueAsString ? String(rounded) : rounded;
+    });
+    onCleanup(unregister);
+  },
+  { immediate: true }
+);
 const readonlyDisplay = computed(() => formatNumberDisplay(draft.value, {
   displayMode: props.config.displayMode,
   precision: props.config.precision,
   roundingMode: props.config.roundingMode
 }));
-function applyRounding(n, precision, mode) {
-  const factor = 10 ** precision;
-  switch (mode) {
-    case "floor":
-      return Math.floor(n * factor) / factor;
-    case "ceil":
-      return Math.ceil(n * factor) / factor;
-    default:
-      return Math.round(n * factor) / factor;
-  }
-}
 const addonConfig = computed(() => {
   const addon = props.config.addon;
   if (!addon || addon.items.length === 0) return null;
@@ -125,7 +132,7 @@ async function onBlur() {
   if (precision !== void 0) {
     const current = draft.value;
     if (current !== void 0) {
-      const rounded = applyRounding(current, precision, props.config.roundingMode ?? "round");
+      const rounded = roundToPrecision(current, precision, props.config.roundingMode ?? "round");
       if (rounded !== current) draft.value = rounded;
     }
   }

package/dist/runtime/components/form/fields/2026-04-28/com.shwfed.form.field.numberrange/runtime.vue

@@ -6,6 +6,7 @@ import { useI18n } from "vue-i18n";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { getLocalizedText } from "../../../../../share/locale";
+import { roundToPrecision } from "../../../../../share/number-format";
 import { interpolateMarkdown } from "../../../../table/utils/runtime";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupNumberField } from "../../../../ui/input-group";
@@ -21,7 +22,8 @@ const props = defineProps({
   config: { type: null, required: true }
 });
 const { locale } = useI18n();
-const { getAt, setAt } = useFormState();
+const bag = useFormState();
+const { getAt, setAt } = bag;
 const formScope = useFormScope();
 const inherited = injectCELContext();
 const $cel = (expression, context) => _rawCel(expression, { ...celBindings(inherited), ...context });
@@ -158,17 +160,6 @@ const endMin = computed(() => {
   if (typeof s === "number") return s;
   return m;
 });
-function applyRounding(n, precision, mode) {
-  const factor = 10 ** precision;
-  switch (mode) {
-    case "floor":
-      return Math.floor(n * factor) / factor;
-    case "ceil":
-      return Math.ceil(n * factor) / factor;
-    default:
-      return Math.round(n * factor) / factor;
-  }
-}
 async function onBlurSide(side) {
   await nextTick();
   const precision = props.config.precision;
@@ -176,12 +167,42 @@ async function onBlurSide(side) {
     const ref_ = side === "start" ? localStart : localEnd;
     const current = ref_.value;
     if (current !== void 0) {
-      const rounded = applyRounding(current, precision, props.config.roundingMode ?? "round");
+      const rounded = roundToPrecision(current, precision, props.config.roundingMode ?? "round");
       if (rounded !== current) ref_.value = rounded;
     }
   }
   commit();
 }
+function roundScalar(precision, mode, value) {
+  let n;
+  if (typeof value === "number" && Number.isFinite(value)) n = value;
+  else if (typeof value === "string" && value.length > 0 && Number.isFinite(Number(value))) n = Number(value);
+  if (n === void 0) return value;
+  const rounded = roundToPrecision(n, precision, mode);
+  return props.config.valueAsString ? String(rounded) : rounded;
+}
+watch(
+  () => [props.config.binding, props.config.precision, props.config.roundingMode, props.config.valueAsString],
+  ([binding, precision, roundingMode], _prev, onCleanup) => {
+    if (binding == null || precision === void 0) return;
+    const mode = roundingMode ?? "round";
+    const unregisters = [];
+    if (typeof binding === "string") {
+      unregisters.push(bag.registerCoercion(
+        binding,
+        (value) => Array.isArray(value) && value.length === 2 ? [roundScalar(precision, mode, value[0]), roundScalar(precision, mode, value[1])] : value
+      ));
+    } else {
+      for (const path of binding) {
+        unregisters.push(bag.registerCoercion(path, (value) => roundScalar(precision, mode, value)));
+      }
+    }
+    onCleanup(() => {
+      for (const off of unregisters) off();
+    });
+  },
+  { immediate: true }
+);
 const showClear = computed(
   () => !isDisabled.value && (localStart.value !== void 0 || localEnd.value !== void 0)
 );

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/runtime.vue

@@ -397,29 +397,33 @@ const readonlyText = computed(() => {
         :class="isDisabled ? 'pointer-events-none opacity-60' : void 0"
       >
         <template #node="{ node, selected, indeterminate }">
-          <span class="flex items-start gap-2">
-            <!-- Presentational checkbox: mirrors the row's selection state but
-                 never owns it. `pointer-events-none` + `tabindex=-1` keep the
-                 existing row-click / keyboard toggle in `<UiTree>` the single
-                 source of truth — the control is a visual reflection only. -->
-            <Checkbox
-              :model-value="indeterminate ? 'indeterminate' : selected"
-              class="pointer-events-none mt-0.5 shrink-0"
-              tabindex="-1"
-              aria-hidden="true"
-            />
-            <span class="flex flex-col gap-0.5">
+          <span class="flex flex-col gap-0.5">
+            <!-- Checkbox shares a centered row with the label so it aligns to
+                 the label's line box (not the top of the label+tooltip stack).
+                 The tooltip drops below, indented `pl-6` (checkbox `size-4` +
+                 `gap-2`) to hang under the label text. -->
+            <span class="flex items-center gap-2">
+              <!-- Presentational checkbox: mirrors the row's selection state but
+                   never owns it. `pointer-events-none` + `tabindex=-1` keep the
+                   existing row-click / keyboard toggle in `<UiTree>` the single
+                   source of truth — the control is a visual reflection only. -->
+              <Checkbox
+                :model-value="indeterminate ? 'indeterminate' : selected"
+                class="pointer-events-none shrink-0"
+                tabindex="-1"
+                aria-hidden="true"
+              />
               <Markdown
                 :source="nodeLabelText(node)"
                 class="prose prose-sm prose-zinc text-zinc-700"
               />
-              <Markdown
-                v-if="nodeTooltipText(node)"
-                :source="nodeTooltipText(node)"
-                block
-                class="prose prose-xs prose-zinc text-zinc-400"
-              />
             </span>
+            <Markdown
+              v-if="nodeTooltipText(node)"
+              :source="nodeTooltipText(node)"
+              block
+              class="prose prose-xs prose-zinc text-zinc-400 pl-6"
+            />
           </span>
         </template>
 

package/dist/runtime/components/form/utils/derived.js

@@ -55,7 +55,7 @@ export function useDerivedQuiescence() {
   return inject(QUIESCENCE_KEY, null) ?? createQuiescence();
 }
 export function useDerived(options) {
-  const { state, getAt, setAtSilent, isDirty, markDirty } = options.formState;
+  const { state, getAt, setAtSilent, isDirty, markDirty, coerce } = options.formState;
   const quiescence = options.quiescence;
   const derivedFields = computed(
     () => options.fields().flatMap((field) => {
@@ -76,7 +76,7 @@ export function useDerived(options) {
       (result) => {
         if (gen !== generation) return;
         if (field.mode === "prefill" && isDirty(field.binding)) return;
-        const normalized = result === void 0 ? null : result;
+        const normalized = coerce(field.binding, result === void 0 ? null : result);
         if (!deepEqual(getAt(field.binding), normalized)) setAtSilent(field.binding, normalized);
       },
       () => {

package/dist/runtime/components/form/utils/state.d.ts

@@ -63,6 +63,24 @@ export type FormStateBag = {
      * expression will not overwrite it.
      */
     markDirty: (path: string) => void;
+    /**
+     * Register a value coercion for one binding. It runs on EVERY write to that
+     * path — user commit, `setAtSilent`, `state.write` action, or a `derived`
+     * write-back — so a field whose stored shape is constrained can enforce that
+     * constraint at the storage boundary rather than only in its own input
+     * handler. The number field registers rounding-to-小数位数 here, so a value a
+     * `derived` formula computes (which never passes through the field's blur
+     * handler) still lands rounded. Returns an unregister.
+     *
+     * The coercion MUST be idempotent — `coerce(coerce(x))` has to equal
+     * `coerce(x)`. `useDerived` compares its freshly evaluated result against the
+     * already-coerced stored value to decide whether to re-write; a non-idempotent
+     * coercion would make that comparison never converge and loop the formula on
+     * its own write-back.
+     */
+    registerCoercion: (path: string, fn: (value: unknown) => unknown) => () => void;
+    /** Apply the coercion registered for `path` (identity when none). */
+    coerce: (path: string, value: unknown) => unknown;
 };
 export declare const FORM_STATE_KEY: InjectionKey<FormStateBag>;
 export declare function provideFormState(state: Ref<unknown>, kind?: FormStateBagKind): FormStateBag;

package/dist/runtime/components/form/utils/state.js

@@ -5,8 +5,14 @@ export const FORM_STATE_KEY = Symbol("shwfed-form-state");
 export function provideFormState(state, kind = "form") {
   const parent = inject(FORM_STATE_KEY, void 0);
   const dirty = ref(/* @__PURE__ */ new Set());
+  const coercions = /* @__PURE__ */ new Map();
+  function coerce(path, value) {
+    const fn = coercions.get(path);
+    return fn ? fn(value) : value;
+  }
   function write(path, value) {
-    const normalized = value === void 0 ? null : value;
+    const coerced = coerce(path, value === void 0 ? null : value);
+    const normalized = coerced === void 0 ? null : coerced;
     if (path === SELF_BINDING) {
       state.value = normalized;
       return;
@@ -30,7 +36,14 @@ export function provideFormState(state, kind = "form") {
     setAtSilent: write,
     dirty,
     isDirty: (path) => dirty.value.has(path),
-    markDirty
+    markDirty,
+    registerCoercion: (path, fn) => {
+      coercions.set(path, fn);
+      return () => {
+        if (coercions.get(path) === fn) coercions.delete(path);
+      };
+    },
+    coerce
   };
   provide(FORM_STATE_KEY, bag);
   return bag;

package/dist/runtime/components/table/columns/2026-05-20/com.shwfed.table.column.number-input/runtime.vue

@@ -1,16 +1,17 @@
 <script setup>
 import { Icon } from "@iconify/vue";
 import { Effect } from "effect";
-import { computed, nextTick } from "vue";
+import { computed, nextTick, watch } from "vue";
 import { useI18n } from "vue-i18n";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celScope, injectCELContext } from "../../../../../utils/cel-context";
 import { useFormReadonly } from "../../../../form/utils/readonly";
 import { getLocalizedText } from "../../../../../share/locale";
-import { formatNumberDisplay } from "../../../../../share/number-format";
+import { formatNumberDisplay, roundToPrecision } from "../../../../../share/number-format";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupNumberField } from "../../../../ui/input-group";
 import ShwfedActions from "../../../../actions/components/group.vue";
 import { useFieldValue } from "../../../../form/utils/field-value";
+import { useFormState } from "../../../../form/utils/state";
 import { JUSTIFY_CLASS, TEXT_ALIGN_CLASS } from "../../../utils/runtime";
 defineOptions({ name: "ShwfedTableNumberInputRendererRuntime" });
 const props = defineProps({
@@ -76,17 +77,24 @@ const readonlyDisplay = computed(() => formatNumberDisplay(draft.value, {
   precision: props.column.precision,
   roundingMode: props.column.roundingMode
 }));
-function applyRounding(n, precision, mode) {
-  const factor = 10 ** precision;
-  switch (mode) {
-    case "floor":
-      return Math.floor(n * factor) / factor;
-    case "ceil":
-      return Math.ceil(n * factor) / factor;
-    default:
-      return Math.round(n * factor) / factor;
-  }
-}
+const bag = useFormState();
+watch(
+  () => [props.column.binding, props.column.precision, props.column.roundingMode, props.column.valueAsString],
+  ([binding, precision, roundingMode, valueAsString], _prev, onCleanup) => {
+    if (binding == null || precision === void 0) return;
+    const mode = roundingMode ?? "round";
+    const unregister = bag.registerCoercion(binding, (value) => {
+      let n;
+      if (typeof value === "number" && Number.isFinite(value)) n = value;
+      else if (typeof value === "string" && value.length > 0 && Number.isFinite(Number(value))) n = Number(value);
+      if (n === void 0) return value;
+      const rounded = roundToPrecision(n, precision, mode);
+      return valueAsString ? String(rounded) : rounded;
+    });
+    onCleanup(unregister);
+  },
+  { immediate: true }
+);
 const addonConfig = computed(() => {
   const addon = props.column.addon;
   if (!addon || addon.items.length === 0) return null;
@@ -112,7 +120,7 @@ async function onBlur() {
   if (precision !== void 0) {
     const current = draft.value;
     if (current !== void 0) {
-      const rounded = applyRounding(current, precision, props.column.roundingMode ?? "round");
+      const rounded = roundToPrecision(current, precision, props.column.roundingMode ?? "round");
       if (rounded !== current) draft.value = rounded;
     }
   }

package/dist/runtime/components/table/config.vue

@@ -612,10 +612,7 @@ async function pasteColumns() {
   const clip = await readClip();
   if (!clip || clip.surface !== "table") return;
   const { items } = reidFragment(clip.items);
-  const pasted = items.map(({ groupId: _g, ...rest }) => ({
-    ...rest,
-    id: crypto.randomUUID()
-  }));
+  const pasted = items.map(({ groupId: _g, ...rest }) => rest);
   if (pasted.length === 0) return;
   editingColumns.value = [...editingColumns.value, ...pasted];
   const ids = pasted.map((c) => c.id);

package/dist/runtime/components/table/index.vue

@@ -810,7 +810,7 @@ export { TableConfig, createTableConfig, getColumnTechnicalKey } from "./schema"
       />
     </div>
     <nav
-      v-if="tableActionsConfig"
+      v-if="tableActionsConfig && !formReadonly"
       class="flex items-center justify-between"
     >
       <ShwfedActions
@@ -1246,7 +1246,7 @@ export { TableConfig, createTableConfig, getColumnTechnicalKey } from "./schema"
       </ClientOnly>
     </div>
     <nav
-      v-if="tableBottomActionsConfig"
+      v-if="tableBottomActionsConfig && !formReadonly"
       class="flex items-center justify-between"
     >
       <ShwfedActions

package/dist/runtime/share/number-format.d.ts

@@ -1,5 +1,6 @@
 export type NumberDisplayMode = 'plain' | 'uppercaseChinese' | 'monoThousand';
 export declare function toChineseUppercase(n: number): string;
+export declare function roundToPrecision(n: number, precision: number, mode?: 'round' | 'floor' | 'ceil'): number;
 export declare function formatNumberDisplay(value: unknown, opts: {
     displayMode?: NumberDisplayMode;
     precision?: number;

package/dist/runtime/share/number-format.js

@@ -35,6 +35,17 @@ export function toChineseUppercase(n) {
   }
   return isNegative ? `\u8D1F${result}` : result;
 }
+export function roundToPrecision(n, precision, mode = "round") {
+  const factor = 10 ** precision;
+  switch (mode) {
+    case "floor":
+      return Math.floor(n * factor) / factor;
+    case "ceil":
+      return Math.ceil(n * factor) / factor;
+    default:
+      return Math.round(n * factor) / factor;
+  }
+}
 export function formatNumberDisplay(value, opts) {
   if (value === void 0 || value === null) return "-";
   const n = Number(value);
@@ -45,20 +56,8 @@ export function formatNumberDisplay(value, opts) {
   }
   let result;
   if (opts.precision !== void 0) {
-    const mode = opts.roundingMode ?? "round";
     const digits = opts.precision;
-    const factor = 10 ** digits;
-    let processed;
-    switch (mode) {
-      case "floor":
-        processed = Math.floor(n * factor) / factor;
-        break;
-      case "ceil":
-        processed = Math.ceil(n * factor) / factor;
-        break;
-      default:
-        processed = Math.round(n * factor) / factor;
-    }
+    const processed = roundToPrecision(n, digits, opts.roundingMode ?? "round");
     result = processed.toFixed(digits);
   } else {
     result = String(n);

package/package.json

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