@shwfed/config 3.0.10 → 3.0.11

package/dist/runtime/components/form/fields/2026-05-25/com.shwfed.form.field.combobox.multi/config.vue.d.ts

@@ -40,6 +40,14 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly optionValue: string;
+        readonly optionLabel: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]];
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -51,14 +59,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
-        readonly optionValue: string;
-        readonly optionLabel: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]];
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -98,6 +98,14 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly optionValue: string;
+        readonly optionLabel: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]];
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -109,14 +117,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
-        readonly optionValue: string;
-        readonly optionLabel: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]];
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

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

@@ -32,6 +32,23 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly required?: string | undefined;
         readonly displayName?: string | undefined;
+        readonly download?: {
+            readonly label?: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]] | undefined;
+            readonly icon?: string | undefined;
+            readonly operations: readonly {
+                readonly id?: string | undefined;
+                readonly params?: unknown;
+                readonly compatibilityDate?: string | undefined;
+                readonly target: string;
+                readonly operation: string;
+            }[];
+        } | undefined;
         readonly compatibilityDate: "2026-06-09";
         readonly orientation?: "vertical" | "floating" | undefined;
         readonly placeholder?: readonly [{
@@ -106,6 +123,23 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly required?: string | undefined;
         readonly displayName?: string | undefined;
+        readonly download?: {
+            readonly label?: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]] | undefined;
+            readonly icon?: string | undefined;
+            readonly operations: readonly {
+                readonly id?: string | undefined;
+                readonly params?: unknown;
+                readonly compatibilityDate?: string | undefined;
+                readonly target: string;
+                readonly operation: string;
+            }[];
+        } | undefined;
         readonly compatibilityDate: "2026-06-09";
         readonly orientation?: "vertical" | "floating" | undefined;
         readonly placeholder?: readonly [{

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

@@ -1,9 +1,11 @@
 <script setup>
 import { Icon } from "@iconify/vue";
-import { computed, ref, watch } from "vue";
+import { computed, defineComponent, ref, watch } from "vue";
 import {
   useTreeDnd
 } from "../../../../../composables/useTreeDnd";
+import TriggersField from "../../../../actions/components/triggers-field.vue";
+import { provideCELContext } from "../../../../../utils/cel-context";
 import {
   DropdownMenu,
   DropdownMenuContent,
@@ -273,6 +275,52 @@ function setMultiple(v) {
     value.value = { ...value.value, multiple: true };
   }
 }
+const downloadEnabled = computed(() => value.value.download != null);
+function setDownloadEnabled(on) {
+  if (on) {
+    if (value.value.download) return;
+    value.value = { ...value.value, download: { operations: [] } };
+  } else {
+    const { download: _omit, ...rest } = value.value;
+    value.value = rest;
+  }
+}
+const downloadOperations = computed(() => value.value.download?.operations ?? []);
+function updateDownloadOperations(next) {
+  const current = value.value.download;
+  if (!current) return;
+  value.value = { ...value.value, download: { ...current, operations: next } };
+}
+function updateDownloadIcon(icon) {
+  const current = value.value.download;
+  if (!current) return;
+  const trimmed = icon.trim();
+  if (trimmed.length === 0) {
+    const { icon: _omit, ...rest } = current;
+    value.value = { ...value.value, download: rest };
+  } else {
+    value.value = { ...value.value, download: { ...current, icon: trimmed } };
+  }
+}
+function updateDownloadLabel(label) {
+  const current = value.value.download;
+  if (!current) return;
+  if (label == null || label.length === 0) {
+    const { label: _omit, ...rest } = current;
+    value.value = { ...value.value, download: rest };
+  } else {
+    value.value = { ...value.value, download: { ...current, label } };
+  }
+}
+const DownloadScope = defineComponent({
+  name: "ShwfedUploadDownloadScope",
+  setup(_, { slots }) {
+    provideCELContext({
+      file: { type: FILE_VAR.type, label: FILE_VAR.label, description: FILE_VAR.description, value: () => void 0 }
+    });
+    return () => slots.default?.();
+  }
+});
 </script>
 
 <template>
@@ -693,6 +741,66 @@ function setMultiple(v) {
       </Field>
     </div>
 
+    <!-- Per-file download -->
+    <div class="flex items-center gap-2">
+      <h3 class="text-xs font-medium text-zinc-500">
+        {{ fieldTitle("download") }}
+      </h3>
+      <Switch
+        size="sm"
+        :model-value="downloadEnabled"
+        aria-label="启用文件下载"
+        @update:model-value="setDownloadEnabled"
+      />
+    </div>
+
+    <div
+      v-if="downloadEnabled"
+      class="flex flex-col gap-3"
+    >
+      <div class="grid grid-cols-2 gap-3">
+        <Field orientation="vertical">
+          <FieldLabel class="text-xs text-zinc-500">
+            下载按钮图标
+          </FieldLabel>
+          <IconPicker
+            :model-value="value.download?.icon ?? ''"
+            @update:model-value="updateDownloadIcon"
+          />
+        </Field>
+
+        <Field orientation="vertical">
+          <FieldLabel class="text-xs text-zinc-500">
+            下载按钮文本
+          </FieldLabel>
+          <LocaleField
+            translate-hint="file download button label"
+            :model-value="value.download?.label"
+            @update:model-value="updateDownloadLabel"
+          />
+        </Field>
+      </div>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              source="点击文件项的下载按钮时按顺序执行的操作；可用 `file` 引用该文件项。尚未上传的本地文件会直接从内存下载，不经过此列表"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          触发操作
+        </FieldLabel>
+        <DownloadScope>
+          <TriggersField
+            :triggers="downloadOperations"
+            @update:triggers="updateDownloadOperations"
+          />
+        </DownloadScope>
+      </Field>
+    </div>
+
     <!-- Download templates -->
     <Field orientation="vertical">
       <FieldLabel class="text-xs text-zinc-500">

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

@@ -32,6 +32,23 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly required?: string | undefined;
         readonly displayName?: string | undefined;
+        readonly download?: {
+            readonly label?: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]] | undefined;
+            readonly icon?: string | undefined;
+            readonly operations: readonly {
+                readonly id?: string | undefined;
+                readonly params?: unknown;
+                readonly compatibilityDate?: string | undefined;
+                readonly target: string;
+                readonly operation: string;
+            }[];
+        } | undefined;
         readonly compatibilityDate: "2026-06-09";
         readonly orientation?: "vertical" | "floating" | undefined;
         readonly placeholder?: readonly [{
@@ -106,6 +123,23 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly required?: string | undefined;
         readonly displayName?: string | undefined;
+        readonly download?: {
+            readonly label?: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]] | undefined;
+            readonly icon?: string | undefined;
+            readonly operations: readonly {
+                readonly id?: string | undefined;
+                readonly params?: unknown;
+                readonly compatibilityDate?: string | undefined;
+                readonly target: string;
+                readonly operation: string;
+            }[];
+        } | undefined;
         readonly compatibilityDate: "2026-06-09";
         readonly orientation?: "vertical" | "floating" | undefined;
         readonly placeholder?: readonly [{

package/dist/runtime/components/form/fields/2026-06-09/com.shwfed.form.field.upload/prompt.md

@@ -9,4 +9,11 @@
 
 `templates` 在上传区旁渲染「下载模板」按钮：只配 `request` 则直接下载其响应；再配 `download` 则是两步式——第二步经 `json` 引用第一步响应（如用 `json.data.key` 拼真正的下载地址）。
 
+`download`（文件下载）给每个**文件项**渲染一个下载按钮，点击时执行一条「触发操作」列表（复用 actions 的操作子系统，与 state.write 同款），列表里的表达式可用 `file` 引用被点击的那一项。分两种情况：
+
+- **已上传/回填的对象项**（即时上传结果，或编辑时服务端回填的记录）：走操作列表，如放一个 `http.download` 操作、请求写 `http.get('/api/file').query('key', file.cacheKey)`；或两步式——先一个 `发送请求` 行取凭据、再一个 `下载文件` 行经 `steps[?"<步骤标识>"]` 引用其响应。凡下载要用到的字段，都必须已由 `upload.handle` 落进文件项（原始上传 `json` 在 `handle` 之后即失效，只有落进项里的字段才随保存/回填留存，从而让本会话上传的与编辑回填的文件项行为一致）。
+- **尚未上传的本地文件**（延迟模式刚选中的原始 `File`）：内存里没有服务端标识、也没有能表达“存这个本地 blob”的操作，故绕过列表、直接从 blob 下载。
+
+下载按钮在只读表单里仍显示（查看已提交记录并下载附件是主要场景）。`download.icon` / `download.label` 定制按钮图标与无障碍文本。
+
 约束类字段（`accept` / `maxFileSize` / `maxTotalSize` / `maxFiles` / `multiple`）按需设置即可。

package/dist/runtime/components/form/fields/2026-06-09/com.shwfed.form.field.upload/runtime.vue

@@ -6,7 +6,8 @@ import { computed, ref } from "vue";
 import { useI18n } from "vue-i18n";
 import { toast } from "vue-sonner";
 import { cel as _rawCel } from "../../../../../utils/cel";
-import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { celBindings, celScope, injectCELContext } from "../../../../../utils/cel-context";
+import { dispatchTriggers, useEventChannel } from "../../../../../share/event-bus";
 import { getLocalizedText } from "../../../../../share/locale";
 import { interpolateMarkdown } from "../../../../table/utils/runtime";
 import { Button } from "../../../../ui/button";
@@ -112,6 +113,7 @@ const { locale, t } = useI18n({
 });
 const { getAt, setAt } = useFormState();
 const formScope = useFormScope();
+const eventChannel = useEventChannel();
 const inherited = injectCELContext();
 const $cel = (expression, context) => _rawCel(expression, { ...celBindings(inherited), ...context });
 const labelText = computed(
@@ -304,6 +306,16 @@ function onDelete(index) {
   next.splice(index, 1);
   entries.value = next;
 }
+function saveFile(file) {
+  const url = URL.createObjectURL(file);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = file.name;
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+  URL.revokeObjectURL(url);
+}
 const templates = computed(() => props.config.templates ?? []);
 function templateIcon(template) {
   return template.icon ?? "fluent:arrow-download-20-regular";
@@ -328,18 +340,36 @@ async function onDownloadTemplate(template) {
       console.error(`[shwfed-form] template request for ${props.fieldId} did not produce a File`);
       return;
     }
-    const url = URL.createObjectURL(file);
-    const a = document.createElement("a");
-    a.href = url;
-    a.download = file.name;
-    document.body.appendChild(a);
-    a.click();
-    a.remove();
-    URL.revokeObjectURL(url);
+    saveFile(file);
   } catch (err) {
     console.error(`[shwfed-form] failed to download template for ${props.fieldId}:`, err);
   }
 }
+const downloadEnabled = computed(() => props.config.download != null);
+const downloadIcon = computed(() => props.config.download?.icon ?? "fluent:arrow-download-20-regular");
+const downloadLabel = computed(
+  () => (props.config.download?.label ? getLocalizedText(props.config.download.label, locale.value) : void 0) ?? "\u4E0B\u8F7D"
+);
+function canDownload(entry) {
+  if (!downloadEnabled.value) return false;
+  if (entry instanceof File) return true;
+  return (props.config.download?.operations.length ?? 0) > 0;
+}
+async function onDownloadEntry(entry) {
+  if (!downloadEnabled.value) return;
+  if (entry instanceof File) {
+    saveFile(entry);
+    return;
+  }
+  const download = props.config.download;
+  if (!download || download.operations.length === 0) return;
+  const triggerCel = (expression, context) => _rawCel(expression, celScope(inherited, { form: formScope.state.value ?? {}, file: entry, ...context }));
+  try {
+    await Effect.runPromise(dispatchTriggers(eventChannel, download.operations, triggerCel));
+  } catch (err) {
+    if (import.meta.dev) console.warn(`[shwfed-form] download operations halted for ${props.fieldId}:`, err);
+  }
+}
 </script>
 
 <template>
@@ -446,19 +476,33 @@ async function onDownloadTemplate(template) {
               />
               <span class="truncate text-zinc-700">{{ entryName(entry) }}</span>
             </span>
-            <Button
-              v-if="!isDisabled && !isReadonly"
-              type="button"
-              variant="ghost"
-              size="sm"
-              data-slot="upload-zone-delete"
-              class="size-6 p-0 text-zinc-500 hover:bg-red-50 hover:text-red-600"
-              :disabled="uploading"
-              :aria-label="`\u5220\u9664\uFF1A${entryName(entry)}`"
-              @click="onDelete(index)"
-            >
-              <Icon icon="fluent:delete-20-regular" />
-            </Button>
+            <span class="flex shrink-0 items-center gap-0.5">
+              <Button
+                v-if="canDownload(entry)"
+                type="button"
+                variant="ghost"
+                size="sm"
+                data-slot="upload-zone-download"
+                class="size-6 p-0 text-zinc-500 hover:bg-zinc-100 hover:text-zinc-700"
+                :aria-label="`${downloadLabel}\uFF1A${entryName(entry)}`"
+                @click="onDownloadEntry(entry)"
+              >
+                <Icon :icon="downloadIcon" />
+              </Button>
+              <Button
+                v-if="!isDisabled && !isReadonly"
+                type="button"
+                variant="ghost"
+                size="sm"
+                data-slot="upload-zone-delete"
+                class="size-6 p-0 text-zinc-500 hover:bg-red-50 hover:text-red-600"
+                :disabled="uploading"
+                :aria-label="`\u5220\u9664\uFF1A${entryName(entry)}`"
+                @click="onDelete(index)"
+              >
+                <Icon icon="fluent:delete-20-regular" />
+              </Button>
+            </span>
           </li>
         </ul>
 

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

@@ -135,6 +135,29 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
             readonly message: string;
         }[]], never>>;
     }>>>;
+    download: Schema.optional<Schema.Struct<{
+        operations: Schema.Array$<Schema.Struct<{
+            id: Schema.optional<Schema.refine<string, typeof Schema.String>>;
+            target: Schema.refine<string, typeof Schema.String>;
+            operation: Schema.SchemaClass<string, string, never>;
+            compatibilityDate: Schema.optional<Schema.SchemaClass<string, string, never>>;
+            params: Schema.optional<Schema.SchemaClass<unknown, unknown, never>>;
+        }>>;
+        icon: Schema.optional<Schema.refine<string, typeof Schema.String>>;
+        label: Schema.optional<Schema.suspend<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], string | readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], never>>;
+    }>>;
     id: Schema.refine<string, typeof Schema.String>;
     displayName: Schema.optional<Schema.SchemaClass<string, string, never>>;
     hidden: Schema.optional<Schema.Schema<string, string, never>>;

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

@@ -1,5 +1,6 @@
 import { Effect, Schema } from "effect";
 import { Expression, LocaleMarkdown } from "../../../../../share/expression.js";
+import { Triggers } from "../../../../../share/event-bus.js";
 import { Locale } from "../../../../../share/locale.js";
 import { commonFieldFields, FieldOrientationSchema } from "../../../utils/common.js";
 export const type = "com.shwfed.form.field.upload";
@@ -144,6 +145,31 @@ export function schema(configure) {
     })).annotations({
       title: "\u4E0B\u8F7D\u6A21\u677F",
       description: "\u4E0B\u8F7D\u6A21\u677F\u5217\u8868\uFF1B\u6BCF\u4E00\u9879\u5728\u4E0A\u4F20\u533A\u57DF\u65C1\u6E32\u67D3\u4E00\u4E2A\u4E0B\u8F7D\u6309\u94AE"
+    })),
+    // Per-file download — a 触发操作 (trigger-operation) list run when the user
+    // clicks a file item's 下载 button, with the clicked stored item in scope as
+    // `file` (the same `FILE_VAR` as `upload.filename`). Object entries
+    // (immediate-upload results or server-backfilled records) download via these
+    // operations — e.g. an `http.download` op reading `file.cacheKey`, or a
+    // two-step `http.request` → `http.download` chain. A freshly-picked,
+    // not-yet-uploaded native `File` bypasses the list and downloads from its
+    // in-memory blob directly, since no operation can express "save this local
+    // blob". `params` on each row stay opaque here (validated by the target
+    // operation's own schema in the editor); `file` typing is advertised to the
+    // op editors at config time via `provideCELContext`, not by this schema.
+    download: Schema.optional(Schema.Struct({
+      operations: Triggers,
+      icon: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
+        title: "\u4E0B\u8F7D\u6309\u94AE\u56FE\u6807",
+        description: "Iconify \u56FE\u6807\u6807\u8BC6\u7B26\uFF0C\u4F8B\u5982 `fluent:arrow-download-20-regular`\uFF1B\u7559\u7A7A\u65F6\u4F7F\u7528\u9ED8\u8BA4\u56FE\u6807"
+      })),
+      label: Schema.optional(Locale.annotations({
+        title: "\u4E0B\u8F7D\u6309\u94AE\u6587\u672C",
+        description: "\u6BCF\u4E2A\u6587\u4EF6\u9879\u4E0B\u8F7D\u6309\u94AE\u7684\u672C\u5730\u5316\u65E0\u969C\u788D\u6807\u7B7E\uFF1B\u7559\u7A7A\u65F6\u4F7F\u7528\u300C\u4E0B\u8F7D\u300D"
+      }))
+    }).annotations({
+      title: "\u6587\u4EF6\u4E0B\u8F7D",
+      description: "\u914D\u7F6E\u540E\u6BCF\u4E2A\u6587\u4EF6\u9879\u65C1\u6E32\u67D3\u4E0B\u8F7D\u6309\u94AE\uFF1A\u5DF2\u4E0A\u4F20/\u56DE\u586B\u7684\u5BF9\u8C61\u9879\u6309\u300C\u89E6\u53D1\u64CD\u4F5C\u300D\u5217\u8868\u4E0B\u8F7D\uFF08`file` \u4E3A\u8BE5\u6587\u4EF6\u9879\uFF09\uFF1B\u5C1A\u672A\u4E0A\u4F20\u7684\u672C\u5730\u6587\u4EF6\u76F4\u63A5\u4ECE\u5185\u5B58\u4E0B\u8F7D\uFF0C\u4E0D\u7ECF\u8FC7\u8BE5\u5217\u8868"
     }))
   }).annotations({
     title: "UploadField",

package/dist/runtime/components/table/columns/2026-07-16/com.shwfed.table.column.upload/config.d.vue.ts

@@ -0,0 +1,10 @@
+type __VLS_ModelProps = {
+    modelValue: Record<string, any>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;