@shwfed/config 2.1.2 → 2.2.0

package/dist/module.json

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

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.form/config.d.vue.ts

@@ -10,7 +10,10 @@ type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: {
         readonly form: {
-            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 {
@@ -39,7 +42,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
         readonly form: {
-            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/components/config/blocks/2026-05-06/com.shwfed.block.form/config.vue.d.ts

@@ -10,7 +10,10 @@ type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: {
         readonly form: {
-            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 {
@@ -39,7 +42,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
         readonly form: {
-            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/components/config/blocks/2026-05-06/com.shwfed.block.form/runtime.d.vue.ts

@@ -12,7 +12,10 @@ type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:block": (value: {
         readonly form: {
-            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 {
@@ -42,7 +45,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:block"?: ((value: {
         readonly form: {
-            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/components/config/blocks/2026-05-06/com.shwfed.block.form/runtime.vue.d.ts

@@ -12,7 +12,10 @@ type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:block": (value: {
         readonly form: {
-            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 {
@@ -42,7 +45,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:block"?: ((value: {
         readonly form: {
-            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/components/config/blocks/2026-05-06/com.shwfed.block.form/schema.d.ts

@@ -22,7 +22,10 @@ export declare function schema(configure: (env: Environment) => void, _blockRef:
     type: Schema.tag<"com.shwfed.block.form">;
     compatibilityDate: Schema.tag<"2026-05-06">;
     form: 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 {
@@ -77,7 +80,10 @@ export declare function schema(configure: (env: Environment) => void, _blockRef:
             }>;
         }>>>;
         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>>;
     }>>;
 }>;

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/config.d.vue.ts

@@ -106,7 +106,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 }[];
             } | 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 {
@@ -278,7 +281,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 }[];
             } | 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 {

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/config.vue.d.ts

@@ -106,7 +106,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 }[];
             } | 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 {
@@ -278,7 +281,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 }[];
             } | 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 {

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/runtime.d.vue.ts

@@ -101,7 +101,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 }[];
             } | 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 {
@@ -273,7 +276,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 }[];
             } | 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 {

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/runtime.vue.d.ts

@@ -101,7 +101,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 }[];
             } | 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 {
@@ -273,7 +276,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 }[];
             } | 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 {

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/schema.d.ts

@@ -116,7 +116,10 @@ export declare function schema(configure: (env: Environment) => void, _blockRef:
             }[];
         } | 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 {
@@ -286,7 +289,10 @@ export declare function schema(configure: (env: Environment) => void, _blockRef:
             }>]>>;
         }>>;
         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 {
@@ -341,7 +347,10 @@ export declare function schema(configure: (env: Environment) => void, _blockRef:
                 }>;
             }>>>;
             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>>;

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

@@ -32,13 +32,23 @@ const EXTRAS = [
   { id: "general", label: "\u901A\u7528\u914D\u7F6E", icon: "fluent:settings-20-regular" }
 ];
 const selection = ref({ kind: "extras", id: "general" });
-function updateInitial(value) {
+function updateInitialData(value) {
   const next = { ...config.value };
   if (value.trim() === "") {
     const { initial: _omit, ...rest } = next;
     config.value = rest;
   } else {
-    config.value = { ...next, initial: value };
+    config.value = { ...next, initial: { ...next.initial, data: value } };
+  }
+}
+function updateInitialRequest(value) {
+  const current = config.value.initial;
+  if (!current) return;
+  if (value.trim() === "") {
+    const { request: _omit, ...rest } = current;
+    config.value = { ...config.value, initial: rest };
+  } else {
+    config.value = { ...config.value, initial: { ...current, request: value } };
   }
 }
 function updateReadonly(value) {
@@ -73,15 +83,36 @@ function updateReadonly(value) {
                 class="prose prose-sm prose-zinc"
               />
             </template>
-            {{ generalFieldTitle("initial") }}
+            {{ generalFieldTitle("initial") }}（数据）
           </FieldLabel>
           <ExpressionEditor
-            :model-value="config.initial ?? ''"
+            :model-value="config.initial?.data ?? ''"
             placeholder="如 { 'name': '', 'age': 0 }"
             result-type="dyn"
+            :extra-vars="{ json: { type: 'optional<dyn>', label: 'HTTP \u54CD\u5E94\u4F53', description: '\u300C\u8BF7\u6C42\u300D\u7684\u54CD\u5E94\u4F53\uFF08\u5DF2\u89E3\u6790 JSON\uFF09\uFF1B\u672A\u914D\u7F6E\u8BF7\u6C42\u65F6\u4E3A none' } }"
             multiline
             class="min-h-20"
-            @update:model-value="updateInitial"
+            @update:model-value="updateInitialData"
+          />
+        </Field>
+
+        <Field orientation="vertical">
+          <FieldLabel class="text-xs text-zinc-500">
+            <template #tooltip>
+              <Markdown
+                source="可选的 HTTP 请求：返回 `HttpRequest`，由宿主发起，响应体作为 `json` 传给「数据」表达式"
+                block
+                class="prose prose-sm prose-zinc"
+              />
+            </template>
+            {{ generalFieldTitle("initial") }}（请求）
+          </FieldLabel>
+          <ExpressionEditor
+            :model-value="config.initial?.request ?? ''"
+            placeholder="如 http.get('https://api.example.com/record/1')"
+            result-type="HttpRequest"
+            class="min-h-10"
+            @update:model-value="updateInitialRequest"
           />
         </Field>
 

package/dist/runtime/components/form/fields/2026-05-12/com.shwfed.form.field.upload/config.d.vue.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/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/vendor/cel-js/CLAUDE.md

@@ -20,7 +20,7 @@ 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`.
 
 ## Architecture
 

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

@@ -197,7 +197,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 +236,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)

package/dist/runtime/vendor/cel-js/lib/http-builder.d.ts

@@ -1,9 +1,10 @@
 /**
  * `HttpRequestBuilder` — the value an `http.*` CEL expression evaluates to.
  *
- * A local (non-upstream) extension. A CEL expression builds and *describes* a
- * request; `.file()` is exposed as a CEL method and evaluates to the downloaded
- * `File`, while `.json()` is dispatched by the host on the returned builder.
+ * A local (non-upstream) extension. A CEL expression only *describes* a
+ * request — it never issues one. Both terminal methods, `.json()` and
+ * `.file()`, are dispatched by the host on the returned builder, keeping
+ * expression evaluation free of IO.
  *
  * Endpoints are used verbatim — there is no base-URL resolution, so callers
  * must pass absolute URLs.

package/dist/runtime/vendor/cel-js/lib/http-builtins.d.ts

@@ -3,9 +3,9 @@
  *
  * Registers the `http` / `HttpRequest` types, the `http` constant, and the
  * request-builder functions on the registry. `http.get(url).header(...).body(...)`
- * builds an `HttpRequestBuilder`; the terminal `.file()` method issues the
- * request and evaluates to the downloaded `File`. `.json()` is *not* a CEL
- * method — the host dispatches that on the returned builder value.
+ * builds an `HttpRequestBuilder` — a pure *description* of a request. CEL never
+ * issues it: both `.json()` and `.file()` are dispatched by the host on the
+ * returned builder, so expression evaluation stays free of IO.
  *
  * Wired into `globalRegistry` at module load (see `evaluator.ts`), so every
  * `Environment` gets HTTP for free — both type-checking and evaluation.

package/dist/runtime/vendor/cel-js/lib/http-builtins.js

@@ -52,8 +52,4 @@ export function registerHttpBuiltins(registry) {
     "HttpRequest.body(dyn): HttpRequest",
     (b, data) => b.body(data)
   );
-  registry.registerFunctionOverload(
-    "HttpRequest.file(): File",
-    (b) => b.file()
-  );
 }

package/package.json

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