@shwfed/config 2.1.2 → 2.2.1

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

@@ -29,7 +29,7 @@ import {
 import { Switch } from "../../../../ui/switch";
 import { getStructFieldDescription, getStructFieldTitle } from "../../../schema";
 import { DEFAULT_FIELD_ORIENTATION, FIELD_ORIENTATION_OPTIONS } from "../../../utils/common";
-import { schema } from "./schema";
+import { JSON_VAR, schema } from "./schema";
 defineOptions({ name: "ShwfedUploadFieldConfig" });
 const value = defineModel({ type: null, ...{ required: true } });
 const fieldSchema = schema(() => {
@@ -48,14 +48,30 @@ const pathText = computed({
     }
   }
 });
-const templateText = computed({
-  get: () => value.value.template ?? "",
+const templateRequestText = computed({
+  get: () => value.value.template?.request ?? "",
   set: (next) => {
     if (next.length === 0) {
       const { template: _omit, ...rest } = value.value;
       value.value = rest;
     } else {
-      value.value = { ...value.value, template: next };
+      value.value = {
+        ...value.value,
+        template: { ...value.value.template, request: next }
+      };
+    }
+  }
+});
+const templateDownloadText = computed({
+  get: () => value.value.template?.download ?? "",
+  set: (next) => {
+    const current = value.value.template;
+    if (!current) return;
+    if (next.length === 0) {
+      const { download: _omit, ...rest } = current;
+      value.value = { ...value.value, template: rest };
+    } else {
+      value.value = { ...value.value, template: { ...current, download: next } };
     }
   }
 });
@@ -482,30 +498,50 @@ function setMultiple(v) {
       </Field>
     </div>
 
-    <div class="grid grid-cols-3 gap-3">
+    <div class="grid grid-cols-2 gap-3">
       <Field orientation="vertical">
         <FieldLabel class="text-xs text-zinc-500">
-          <template
-            v-if="fieldDescription('template')"
-            #tooltip
-          >
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('template') ?? '\u8FD4\u56DE `HttpRequest` \u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u8BBE\u7F6E\u540E\u4F1A\u6E32\u67D3\u4E0B\u8F7D\u6A21\u677F\u6309\u94AE'"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          请求
+        </FieldLabel>
+        <ExpressionEditor
+          :model-value="templateRequestText"
+          placeholder="例：http.get('https://api.example.com/template.xlsx')"
+          result-type="HttpRequest"
+          class="min-h-10"
+          @update:model-value="(v) => templateRequestText = v"
+        />
+      </Field>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
             <Markdown
-              :source="fieldDescription('template')"
+              source="可选的第二步：用第一步响应 `json` 中的凭据构造真正的下载请求，例如 `json.data.key`"
               block
               class="prose prose-sm prose-zinc"
             />
           </template>
-          {{ fieldTitle("template") }}
+          下载请求
         </FieldLabel>
         <ExpressionEditor
-          :model-value="templateText"
-          placeholder="例：fetchFile('/api/template.xlsx')"
-          result-type="File"
+          :model-value="templateDownloadText"
+          placeholder="例：http.get('https://api.example.com/download').query('key', json.data.key)"
+          result-type="HttpRequest"
+          :extra-vars="{ json: JSON_VAR }"
           class="min-h-10"
-          @update:model-value="(v) => templateText = v"
+          @update:model-value="(v) => templateDownloadText = v"
         />
       </Field>
+    </div>
 
+    <div class="grid grid-cols-2 gap-3">
       <Field orientation="vertical">
         <FieldLabel class="text-xs text-zinc-500">
           <template

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

@@ -11,7 +11,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
-        readonly template?: string | undefined;
+        readonly template?: {
+            readonly download?: string | undefined;
+            readonly request: string;
+        } | undefined;
         readonly disabled?: string | undefined;
         readonly type: "com.shwfed.form.field.upload";
         readonly id: string;
@@ -65,7 +68,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
-        readonly template?: string | undefined;
+        readonly template?: {
+            readonly download?: string | undefined;
+            readonly request: string;
+        } | undefined;
         readonly disabled?: string | undefined;
         readonly type: "com.shwfed.form.field.upload";
         readonly id: string;

package/dist/runtime/components/form/fields/2026-05-12/com.shwfed.form.field.upload/runtime.vue

@@ -1,6 +1,7 @@
 <script setup>
 import { Icon } from "@iconify/vue";
 import { Effect } from "effect";
+import { Fetch } from "fx-fetch";
 import { computed, ref } from "vue";
 import { useI18n } from "vue-i18n";
 import { toast } from "vue-sonner";
@@ -215,12 +216,22 @@ function fileIcon(file) {
 }
 const templateIcon = computed(() => props.config.templateIcon ?? "fluent:arrow-download-20-regular");
 async function onDownloadTemplate() {
-  const expression = props.config.template;
-  if (!expression) return;
+  const template = props.config.template;
+  if (!template) return;
+  const ctx = { form: state.value ?? {} };
+  const program = Effect.gen(function* () {
+    const requestBuilder = yield* $cel(template.request, ctx);
+    if (!template.download) {
+      return yield* requestBuilder.file();
+    }
+    const json = yield* requestBuilder.json();
+    const downloadBuilder = yield* $cel(template.download, { ...ctx, json });
+    return yield* downloadBuilder.file();
+  });
   try {
-    const file = await Effect.runPromise($cel(expression, { form: state.value ?? {} }));
+    const file = await Effect.runPromise(Effect.provide(program, Fetch.layer));
     if (!(file instanceof File)) {
-      console.error(`[shwfed-form] template expression for ${props.fieldId} did not return a File`);
+      console.error(`[shwfed-form] template request for ${props.fieldId} did not produce a File`);
       return;
     }
     const url = URL.createObjectURL(file);
@@ -232,7 +243,7 @@ async function onDownloadTemplate() {
     a.remove();
     URL.revokeObjectURL(url);
   } catch (err) {
-    console.error(`[shwfed-form] failed to evaluate template for ${props.fieldId}:`, err);
+    console.error(`[shwfed-form] failed to download template for ${props.fieldId}:`, err);
   }
 }
 </script>

package/dist/runtime/components/form/fields/2026-05-12/com.shwfed.form.field.upload/schema.d.ts

@@ -17,6 +17,11 @@ export declare const metadata: {
         readonly grow: true;
     };
 };
+export declare const JSON_VAR: {
+    readonly type: "dyn";
+    readonly label: "HTTP 响应体";
+    readonly description: "第一步 `请求` 的响应体（已解析 JSON）；用于构造第二步下载请求";
+};
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     label: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{
         locale: Schema.Literal<["zh"]>;
@@ -61,7 +66,10 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
     maxFileSize: Schema.optional<Schema.refine<number, typeof Schema.Number>>;
     maxTotalSize: Schema.optional<Schema.refine<number, typeof Schema.Number>>;
     maxFiles: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
-    template: Schema.optional<Schema.Schema<string, string, never>>;
+    template: Schema.optional<Schema.Struct<{
+        request: Schema.Schema<string, string, never>;
+        download: Schema.optional<Schema.Schema<string, string, never>>;
+    }>>;
     templateIcon: Schema.optional<Schema.refine<string, typeof Schema.String>>;
     templateLabel: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{
         locale: Schema.Literal<["zh"]>;

package/dist/runtime/components/form/fields/2026-05-12/com.shwfed.form.field.upload/schema.js

@@ -10,9 +10,21 @@ export const metadata = {
   w: { initial: 8, min: 8, max: Infinity },
   h: { initial: 6, min: 6, max: Infinity, grow: true }
 };
+export const JSON_VAR = {
+  type: "dyn",
+  label: "HTTP \u54CD\u5E94\u4F53",
+  description: "\u7B2C\u4E00\u6B65 `\u8BF7\u6C42` \u7684\u54CD\u5E94\u4F53\uFF08\u5DF2\u89E3\u6790 JSON\uFF09\uFF1B\u7528\u4E8E\u6784\u9020\u7B2C\u4E8C\u6B65\u4E0B\u8F7D\u8BF7\u6C42"
+};
+function configureWithJson(configure) {
+  return (env) => {
+    configure(env);
+    env.registerVariable("json", JSON_VAR.type, { description: JSON_VAR.description });
+  };
+}
 export function schema(configure) {
   const CelBool = Expression({ configure, resultType: "bool" });
-  const CelFile = Expression({ configure, resultType: "File" });
+  const CelHttpRequest = Expression({ configure, resultType: "HttpRequest" });
+  const CelDownloadRequest = Expression({ configure: configureWithJson(configure), resultType: "HttpRequest" });
   const LocaleMd = LocaleMarkdown({ configure });
   return Schema.Struct({
     type: Schema.Literal(type),
@@ -67,9 +79,18 @@ export function schema(configure) {
       title: "\u6587\u4EF6\u6570\u91CF\u9650\u5236",
       description: "\u5141\u8BB8\u540C\u65F6\u4E0A\u4F20\u7684\u6700\u5927\u6587\u4EF6\u6570\uFF1B\u8FBE\u5230\u4E0A\u9650\u540E\u65B0\u589E\u6587\u4EF6\u4F1A\u88AB\u62D2\u7EDD"
     })),
-    template: Schema.optional(CelFile.annotations({
-      title: "\u6A21\u677F\u8868\u8FBE\u5F0F",
-      description: "\u8FD4\u56DE `File` \u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u8BBE\u7F6E\u540E\u4F1A\u5728\u4E0A\u4F20\u533A\u57DF\u65C1\u6E32\u67D3\u4E0B\u8F7D\u6A21\u677F\u6309\u94AE"
+    template: Schema.optional(Schema.Struct({
+      request: CelHttpRequest.annotations({
+        title: "\u8BF7\u6C42",
+        description: "\u8FD4\u56DE `HttpRequest` \u7684 CEL \u8868\u8FBE\u5F0F\u3002\u672A\u914D\u7F6E\u300C\u4E0B\u8F7D\u8BF7\u6C42\u300D\u65F6\u76F4\u63A5\u53D1\u8D77\u5E76\u4E0B\u8F7D\u5176\u54CD\u5E94\uFF1B\u914D\u7F6E\u4E86\u300C\u4E0B\u8F7D\u8BF7\u6C42\u300D\u65F6\u4F5C\u4E3A\u83B7\u53D6\u4E0B\u8F7D\u51ED\u636E\u7684\u7B2C\u4E00\u6B65\u8BF7\u6C42"
+      }),
+      download: Schema.optional(CelDownloadRequest.annotations({
+        title: "\u4E0B\u8F7D\u8BF7\u6C42",
+        description: "\u53EF\u9009\u7684\u7B2C\u4E8C\u6B65\uFF1A\u8FD4\u56DE `HttpRequest` \u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u53EF\u901A\u8FC7 `json` \u5F15\u7528\u7B2C\u4E00\u6B65\u7684\u54CD\u5E94\u4F53\uFF0C\u4F8B\u5982\u7528 `json.data.key` \u6784\u9020\u771F\u6B63\u7684\u4E0B\u8F7D\u8BF7\u6C42"
+      }))
+    }).annotations({
+      title: "\u4E0B\u8F7D\u6A21\u677F",
+      description: "\u4E0B\u8F7D\u6A21\u677F\u7684\u8BF7\u6C42\u914D\u7F6E\uFF1B\u8BBE\u7F6E\u540E\u4F1A\u5728\u4E0A\u4F20\u533A\u57DF\u65C1\u6E32\u67D3\u4E0B\u8F7D\u6A21\u677F\u6309\u94AE"
     })),
     templateIcon: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
       title: "\u6A21\u677F\u6309\u94AE\u56FE\u6807",

package/dist/runtime/components/form/fields/2026-05-13/com.shwfed.form.field.combobox.single.remote/config.d.vue.ts

@@ -33,12 +33,12 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly readonly?: string | undefined;
+        readonly request: string;
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly request: string;
         readonly options: string;
         readonly optionValue: string;
         readonly optionLabel: readonly [{
@@ -80,12 +80,12 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly readonly?: string | undefined;
+        readonly request: string;
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly request: string;
         readonly options: string;
         readonly optionValue: string;
         readonly optionLabel: readonly [{

package/dist/runtime/components/form/fields/2026-05-13/com.shwfed.form.field.combobox.single.remote/config.vue.d.ts

@@ -33,12 +33,12 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly readonly?: string | undefined;
+        readonly request: string;
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly request: string;
         readonly options: string;
         readonly optionValue: string;
         readonly optionLabel: readonly [{
@@ -80,12 +80,12 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly readonly?: string | undefined;
+        readonly request: string;
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly request: string;
         readonly options: string;
         readonly optionValue: string;
         readonly optionLabel: readonly [{

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

@@ -2,6 +2,7 @@
 import { cel as _rawCel } from "../../utils/cel";
 import { TZDate } from "@date-fns/tz";
 import { Effect } from "effect";
+import { Fetch } from "fx-fetch";
 import { computed, onMounted, ref, watch } from "vue";
 import {
   celBindings,
@@ -11,6 +12,7 @@ import {
 import { provideCommitBus } from "./utils/commit-bus";
 import { provideDerivedQuiescence, useDerived } from "./utils/derived";
 import { useFormHistory } from "./utils/history";
+import { evaluateInitial } from "./utils/initial";
 import { provideFormReadonly } from "./utils/readonly";
 import { findField } from "./utils/resolve";
 import { provideFormState } from "./utils/state";
@@ -62,7 +64,8 @@ const seeded = (() => {
   const current = state.value ?? {};
   const initial = config.value.initial;
   if (!initial || Object.keys(current).length > 0) return Promise.resolve();
-  return Effect.runPromise($cel(initial, { form: current })).then(
+  const program = evaluateInitial(initial, $cel, { form: current });
+  return Effect.runPromise(Effect.provide(program, Fetch.layer)).then(
     (result) => {
       if (result && typeof result === "object" && !Array.isArray(result)) {
         state.value = { ...current, ...result };

package/dist/runtime/components/form/schema.d.ts

@@ -1,5 +1,6 @@
 import { Schema } from 'effect';
 import type { Environment } from '../../vendor/cel-js/lib/index.js';
+import type { InitialSource } from './utils/initial.js';
 import { type LayoutSetValue } from '../../share/layout.js';
 export { commonFieldFields } from './utils/common.js';
 export { getStructFieldTitle, getStructFieldDescription } from './utils/schema-meta.js';
@@ -79,7 +80,10 @@ export declare function FormUnit(configure: (env: Environment) => void): Schema.
  */
 export declare function registerFormVariablesIfAbsent(env: Environment): void;
 export declare function FormConfig(configure: (env: Environment) => void): Schema.refine<{
-    readonly initial?: string | undefined;
+    readonly initial?: {
+        readonly data: string;
+        readonly request?: string | undefined;
+    } | undefined;
     readonly kind: "shwfed.component.form";
     readonly fields: readonly any[];
     readonly layouts: readonly {
@@ -134,11 +138,17 @@ export declare function FormConfig(configure: (env: Environment) => void): Schem
         }>;
     }>>>;
     kind: Schema.tag<"shwfed.component.form">;
-    initial: Schema.optional<Schema.Schema<string, string, never>>;
+    initial: Schema.optional<Schema.Struct<{
+        request: Schema.optional<Schema.Schema<string, string, never>>;
+        data: Schema.Schema<string, string, never>;
+    }>>;
     readonly: Schema.optional<Schema.Schema<string, string, never>>;
 }>>;
 export declare function createFormConfig(body: Omit<Schema.Schema.Type<ReturnType<typeof FormConfig>>, 'kind'>): {
-    initial?: string | undefined;
+    initial?: {
+        readonly data: string;
+        readonly request?: string | undefined;
+    } | undefined;
     fields: readonly any[];
     layouts: readonly {
         readonly name: string;
@@ -173,6 +183,6 @@ export type FormUnitValue = Readonly<{
 }>;
 export type FormConfigValue = Readonly<{
     kind: typeof KIND;
-    initial?: string;
+    initial?: InitialSource;
     readonly?: string;
 }> & FormUnitValue;

package/dist/runtime/components/form/schema.js

@@ -47,23 +47,43 @@ export function FormConfig(configure) {
     registerFormVariablesIfAbsent(env);
     configure(env);
   };
-  const CelFormInitial = Expression({ configure: formConfigure, resultType: "dyn" });
+  const CelInitialRequest = Expression({ configure: formConfigure, resultType: "HttpRequest" });
+  const CelInitialData = Expression({
+    configure: (env) => {
+      formConfigure(env);
+      env.registerVariable("json", "optional<dyn>", {
+        description: "HTTP \u54CD\u5E94\u4F53\uFF08\u5DF2\u89E3\u6790 JSON\uFF09\uFF1B\u672A\u914D\u7F6E request \u65F6\u4E3A none\uFF0C\u7528 `json.?\u5B57\u6BB5` \u8BBF\u95EE"
+      });
+    },
+    resultType: "dyn"
+  });
   const CelFormReadonly = Expression({ configure: formConfigure, resultType: "bool" });
   return Schema.Struct({
     kind: Schema.tag(KIND),
-    initial: Schema.optional(CelFormInitial.annotations({
-      title: "\u521D\u59CB\u503C",
-      description: md`
-        返回整个表单初始值的 CEL 表达式：
+    initial: Schema.optional(Schema.Struct({
+      request: Schema.optional(CelInitialRequest.annotations({
+        title: "\u8BF7\u6C42",
+        description: md`
+          可选的 HTTP 请求表达式：返回 \`HttpRequest\`，运行时由宿主发起，并把响应体作为 \`json\` 传给「数据」表达式。
 
-        - 可以互相依赖，但是应当避免循环引用出现
+          留空时「数据」直接对 CEL 上下文求值（静态默认值，或引用 \`form\` 的表达式）。
+        `
+      })),
+      data: CelInitialData.annotations({
+        title: "\u6570\u636E",
+        description: md`
+          返回整个表单初始值的 CEL 表达式（应为一个对象）：
 
-          考虑一个表单，包含了用户名 & 用户角色。特别的，一个用户可能有多个角色。我们可以默认填入当前登入人的用户名，随后再以此为依据，填入其默认的角色。
+          - 可以互相依赖，但应避免循环引用。考虑一个含「用户名」与「用户角色」的表单：可默认填入当前登入人的用户名，再以此为依据填入其默认角色。
 
-        - 支持异步调用（如 \`http.get(...).json()\`）。运行时会等待表达式 resolve 后再触发依赖 \`form\` 的请求
+          - 配置了「请求」时，可通过 \`json\` 引用响应体，例如 \`json.?data\`。
 
-        - 如果配置了初始值，重置这个表单将**重置为其初始值，而非空**
-      `
+          - 如果配置了初始值，重置这个表单将**重置为其初始值，而非空**。
+        `
+      })
+    }).annotations({
+      title: "\u521D\u59CB\u503C",
+      description: "\u8868\u5355\u521D\u59CB\u503C\u7684\u6765\u6E90\uFF1A\u53EF\u9009\u7684 HTTP \u8BF7\u6C42\uFF0C\u52A0\u4E00\u4E2A\u8FD4\u56DE\u521D\u59CB\u503C\u5BF9\u8C61\u7684 CEL \u8868\u8FBE\u5F0F"
     })),
     readonly: Schema.optional(CelFormReadonly.annotations({
       title: "\u53EA\u8BFB\u6761\u4EF6",

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

@@ -0,0 +1,26 @@
+import { Effect } from 'effect';
+import type { Fetch } from 'fx-fetch';
+/**
+ * The form's initial-state source. Mirrors the table's `dataSource` shape: an
+ * optional HTTP `request` whose response feeds the `data` expression, which
+ * produces the seed object. With no `request`, `data` is evaluated directly
+ * against the CEL context (a static default, or one referencing `form`).
+ */
+export type InitialSource = Readonly<{
+    request?: string;
+    data: string;
+}>;
+/**
+ * Evaluates a CEL expression against the host's context. A CEL `http.*`
+ * expression only *builds* a request, so this never performs IO itself —
+ * `evaluateInitial` issues the request separately.
+ */
+export type CelEvaluator = <T>(expression: string, context?: Record<string, unknown>) => Effect.Effect<T, unknown, never>;
+/**
+ * Resolve an `InitialSource` to the seed value. When `request` is set it is
+ * built by CEL, then issued here as `.json()` — the host owns the IO, CEL only
+ * describes it. The response is exposed to `data` as the `json` variable (an
+ * `Option`, so a missing response is `None`, never a crash). The returned
+ * Effect needs a `Fetch` layer.
+ */
+export declare function evaluateInitial(initial: InitialSource, cel: CelEvaluator, context: Record<string, unknown>): Effect.Effect<unknown, unknown, Fetch.Fetch>;

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

@@ -0,0 +1,11 @@
+import { Effect, Option } from "effect";
+export function evaluateInitial(initial, cel, context) {
+  return Effect.gen(function* () {
+    let json = Option.none();
+    if (initial.request) {
+      const builder = yield* cel(initial.request, context);
+      json = Option.some(yield* builder.json());
+    }
+    return yield* cel(initial.data, { ...context, json });
+  });
+}

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

@@ -24,6 +24,7 @@ import { NumberField, NumberFieldInput } from "../ui/number-field";
 import { Tooltip, TooltipContent, TooltipTrigger } from "../ui/tooltip";
 import ShwfedActions from "../actions/components/group.vue";
 import ShwfedForm from "../form/index.vue";
+import { evaluateInitial } from "../form/utils/initial";
 import { provideTableInstanceId } from "./utils/instance";
 import { provideEventTarget } from "../../share/event-bus";
 import { findColumn } from "./utils/resolve";
@@ -294,7 +295,8 @@ async function resetQuery() {
     return;
   }
   try {
-    const result = await Effect.runPromise($cel(initial, { query: {} }));
+    const program = evaluateInitial(initial, $cel, { query: {} });
+    const result = await Effect.runPromise(Effect.provide(program, Fetch.layer));
     queryState.value = result && typeof result === "object" && !Array.isArray(result) ? { ...result } : {};
   } catch (e) {
     console.error("[shwfed-table] resetQuery failed", e);

package/dist/runtime/components/table/schema.d.ts

@@ -201,7 +201,10 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
         }[];
     } | undefined;
     readonly query?: {
-        readonly initial?: string | undefined;
+        readonly initial?: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        } | undefined;
         readonly kind: "shwfed.component.form";
         readonly fields: readonly any[];
         readonly layouts: readonly {
@@ -371,7 +374,10 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
         }>]>>;
     }>>;
     query: Schema.optional<Schema.refine<{
-        readonly initial?: string | undefined;
+        readonly initial?: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        } | undefined;
         readonly kind: "shwfed.component.form";
         readonly fields: readonly any[];
         readonly layouts: readonly {
@@ -426,7 +432,10 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
             }>;
         }>>>;
         kind: Schema.tag<"shwfed.component.form">;
-        initial: Schema.optional<Schema.Schema<string, string, never>>;
+        initial: Schema.optional<Schema.Struct<{
+            request: Schema.optional<Schema.Schema<string, string, never>>;
+            data: Schema.Schema<string, string, never>;
+        }>>;
         readonly: Schema.optional<Schema.Schema<string, string, never>>;
     }>>>;
     cellStyle: Schema.optional<Schema.Schema<string, string, never>>;
@@ -573,7 +582,10 @@ export declare function createTableConfig(body: Omit<Schema.Schema.Type<ReturnTy
         }[];
     } | undefined;
     query?: {
-        readonly initial?: string | undefined;
+        readonly initial?: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        } | undefined;
         readonly kind: "shwfed.component.form";
         readonly fields: readonly any[];
         readonly layouts: readonly {

package/dist/runtime/plugins/i18n/index.js

@@ -1,14 +1,20 @@
 import { defineNuxtPlugin } from "#app";
 import { createI18n } from "vue-i18n";
+import { HttpRequestBuilder } from "../../vendor/cel-js/lib/http-builder.js";
 export default defineNuxtPlugin({
   name: "shwfed:i18n",
   setup: (nuxt) => {
-    nuxt.vueApp.use(createI18n({
+    const i18n = createI18n({
       locale: navigator?.language,
       legacy: false,
       fallbackWarn: false,
       fallbackLocale: "zh",
       globalInjection: false
-    }));
+    });
+    nuxt.vueApp.use(i18n);
+    HttpRequestBuilder.setDefaultHeader(
+      "Accept-Language",
+      () => i18n.global.locale.value
+    );
   }
 });

package/dist/runtime/vendor/cel-js/CLAUDE.md

@@ -20,7 +20,9 @@ The `homogeneousAggregateLiterals` and `enableOptionalTypes` environment options
 
 The custom `Optional` class has been replaced with Effect's `Option` type (`import { Option } from 'effect'`). Internal helpers `optionalOf(value)` and `optionalValue(opt)` in `optional.js` handle the CEL-specific semantics (treating `undefined` as `None`, throwing `EvaluationError` on missing value access).
 
-An `http` built-in has been added (`http-builtins.ts`, `http-builder.ts`) — not from upstream. It registers the `http` constant and the `http` / `HttpRequest` types on `globalRegistry`, so `http.get(url).header(...).body(...)` expressions type-check and evaluate in every `Environment`. A CEL expression builds an `HttpRequestBuilder`; the terminal `HttpRequest.file(): File` method issues the request and evaluates to the downloaded `File`, while `.json()` is dispatched by the host on the builder value (it is not a CEL method). Endpoints must be absolute URLs — there is no base-URL resolution. Depends on `fx-fetch`.
+An `http` built-in has been added (`http-builtins.ts`, `http-builder.ts`) — not from upstream. It registers the `http` constant and the `http` / `HttpRequest` types on `globalRegistry`, so `http.get(url).header(...).body(...)` expressions type-check and evaluate in every `Environment`. A CEL expression only builds an `HttpRequestBuilder` — a pure description of a request; it never issues one. Both terminal methods, `.json()` and `.file()`, are dispatched by the host on the returned builder (neither is a CEL method), so expression evaluation stays free of IO. Endpoints must be absolute URLs — there is no base-URL resolution. Depends on `fx-fetch`. The host can register process-wide default headers via `HttpRequestBuilder.setDefaultHeader(name, valueOrGetter)` / `clearDefaultHeader(name)`; they are merged in at `#buildRequest()` time, with case-insensitive precedence to an explicit `.header(...)` on the builder. A getter that returns `null` / `undefined` / `''` skips the header for that request, so the host can source values from live refs (e.g. the active i18n locale for `Accept-Language`) without baking in stale snapshots.
+
+Spread syntax (`...expr`) inside list and map literals — not from upstream. A new `ELLIPSIS` token (3-char lookahead in the lexer) and a `spread` AST op let `[1, ...a, 4]` and `{...a, "x": 1, ...b}` desugar inside the parent literal. The spread node's own `check`/`evaluate` are defensive stubs — `parsePrimary` never produces one, so `...` outside a list/map is an "unexpected token" parse error. List `args` shape is unchanged (`IASTNode[]`, with spread elements detected via `op === 'spread'`); map `args` becomes `([IASTNode, IASTNode] | [IASTNode])[]` — a length-1 tuple represents a spread entry, preserving positional ordering for override semantics (later writes win). The fast path is preserved: the `list`/`map` `check` swaps `evaluate` meta to `evaluateSpreadList`/`evaluateSpreadMap` only when a spread child is present; literals without spreads run the original `resolveAstArray`/`safeFromEntries` paths byte-for-byte. Spread map sources may be plain objects, `Map` instances, or registered message types (typed as `map<string, dyn>`); the `__proto__`/`constructor`/`prototype` skip from `safeFromEntries` is applied to spread sources too. Runtime errors fire on non-list/non-map sources (including `null`). `maxListElements` / `maxMapEntries` count a spread as one entry — runtime expansion bypasses those caps (deliberate trade-off). Call-argument spread (`f(...args)`) is **not** supported.
 
 ## Architecture
 

package/dist/runtime/vendor/cel-js/PROMPT.md

@@ -67,6 +67,26 @@ condition ? value_if_true : value_if_false
 [1, 2] + [3, 4]            // [1, 2, 3, 4]
 ```
 
+### Spread (`...expr`)
+A spread inlines another list inside a list literal or another map inside a
+map literal. Order is preserved — a later entry (including a later spread)
+overrides an earlier one when keys collide.
+```cel
+[1, ...a, 4]                 // a flattens in position
+[...a, ...b]                 // equivalent to a + b
+
+{...a, "x": 1}               // copy a, then set x to 1
+{"x": 1, ...a}               // set x, then let a override
+{...a, ...b}                 // b overrides a on overlapping keys
+{...a, "x": 1, ...b}         // a, then x, then b — last write wins
+
+[...[1, 2], 3, ...[4]]       // [1, 2, 3, 4]
+```
+Spread is only valid as a list element or map entry — `f(...args)` is not
+supported (CEL resolves overloads by fixed arity). Spreading a non-list into
+a list, or a non-map into a map (including `null`), is an error — at compile
+time when statically known, at runtime when the source is `dyn`.
+
 ### Field access
 ```cel
 obj.field                   // access field on map/object
@@ -197,7 +217,7 @@ location.param("id")                 // first value when a param repeats
 
 ## HTTP
 
-Build HTTP requests using the `http` builder. A CEL expression *describes* a request; calling `.file()` on it issues the request and evaluates to the downloaded `File`. Any other request is handed to the host to dispatch — there is no way to read a JSON or text response from CEL.
+Build HTTP requests using the `http` builder. A CEL expression only *describes* a request — it always evaluates to an `HttpRequest`, never issues it. The host decides when and how to send it (downloading a file, reading a JSON response, etc.). There is no way to perform the request or read its response from CEL.
 
 **URLs must be absolute** — pass a full `https://…` URL. There is no base URL, so relative paths like `/api/users` will not resolve.
 
@@ -236,12 +256,8 @@ http.post("https://api.example.com/users")
   .header("Content-Type", "application/json")
   .body({"name": "Alice", "channel": query.?channel})
 
-// Download the response as a File. Unlike the chainable methods above,
-// .file() is terminal — it issues the request and the expression evaluates
-// to a File (filename from the Content-Disposition header, else the URL path):
-http.get("https://api.example.com/files/report.pdf").file()
-
-// Full example — the expression returns an HttpRequest; the host sends it:
+// The expression always evaluates to an HttpRequest — the host sends it
+// (downloading a File, reading a JSON response, etc.):
 http.post("https://api.example.com/users")
   .header("Content-Type", "application/json")
   .header("Authorization", "Bearer " + token)