@shwfed/config 3.0.9 → 3.0.11

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

@@ -37,15 +37,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -56,15 +56,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]];
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -76,6 +67,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -112,15 +112,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -131,15 +131,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]];
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -151,6 +142,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/config.d.vue.ts

@@ -37,15 +37,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -55,15 +55,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -75,6 +66,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -111,15 +111,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -129,15 +129,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -149,6 +140,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/config.vue.d.ts

@@ -37,15 +37,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -55,15 +55,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -75,6 +66,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -111,15 +111,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -129,15 +129,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -149,6 +140,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => 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>