@chenzy-design/svelte 0.1.0

package/dist/upload/Upload.svelte.d.ts

@@ -0,0 +1,99 @@
+import type { Snippet } from 'svelte';
+import { type BeforeUploadResult } from '@chenzy-design/core';
+import type { UploadFileItem } from './types.js';
+interface Props {
+    value?: UploadFileItem[];
+    defaultValue?: UploadFileItem[];
+    accept?: string;
+    multiple?: boolean;
+    /** 上传整个目录（input 加 webkitdirectory，递归选择目录下所有文件）。 */
+    directory?: boolean;
+    limit?: number;
+    /** Max size per file, in KB. */
+    maxSize?: number;
+    /** Min size per file, in KB. 小于此值的文件校验失败（error）。 */
+    minSize?: number;
+    disabled?: boolean;
+    /**
+     * 组件级尺寸（触发按钮/列表项），与其它表单控件一致。
+     * 注意：区别于每个文件项的 file.size（字节体积）。
+     */
+    size?: 'small' | 'default' | 'large';
+    /**
+     * 组件级校验态（表单联动），影响上传区/边框色。
+     * 注意：区别于每个文件项的 file.status（ready/uploading/error 上传进度态）。
+     */
+    status?: 'default' | 'warning' | 'error';
+    listType?: 'text' | 'image' | 'picture-card' | 'none';
+    drag?: boolean;
+    /** 上传地址；提供且无 customRequest 时选文件后自动 XHR 上传 */
+    action?: string;
+    /** 表单字段名，默认 'file' */
+    uploadName?: string;
+    /** 额外请求头 */
+    headers?: Record<string, string>;
+    /** 随文件一起提交的额外字段 */
+    uploadData?: Record<string, string>;
+    /** 同时进行的上传数上限；0/不传=不限（受控调度，超出排队，完成补位） */
+    concurrency?: number;
+    /**
+     * 每个文件上传前调用：返回 false / reject 跳过该文件（移除）；
+     * 返回 File 替换为该文件（如压缩后）；返回 true / resolve 正常上传。异步会被 await。
+     */
+    beforeUpload?: (file: File, fileList: File[]) => BeforeUploadResult | Promise<BeforeUploadResult>;
+    /** 自定义上传实现（优先于 action）。返回 Promise 时受 concurrency 调度（完成才释放槽位）。 */
+    customRequest?: (item: UploadFileItem) => void | Promise<void>;
+    onChange?: (list: UploadFileItem[]) => void;
+    onExceed?: (files: File[]) => void;
+    onSuccess?: (response: string, item: UploadFileItem) => void;
+    onError?: (item: UploadFileItem) => void;
+    children?: Snippet;
+    /** 上传失败是否显示重试按钮。默认 true */
+    showRetry?: boolean;
+    /** 是否允许替换已有文件（单文件模式下显示"替换"而不是"添加"）。默认 false */
+    showReplace?: boolean;
+    /** 是否显示批量清除按钮。默认 false */
+    showClear?: boolean;
+    /** 清除按钮点击回调 */
+    onClear?: () => void;
+    /** 文件列表标题文字；false 则不渲染。默认 undefined（不渲染） */
+    fileListTitle?: string | false;
+    /** 文件名超长是否展示 Tooltip（简单实现：title 属性）。true=展示 title；false=不展示。默认 true */
+    showTooltip?: boolean;
+    /** 上传区提示内容（文字或 Snippet） */
+    prompt?: string | Snippet;
+    /** 提示位置：left/right 为水平排列，bottom 为下方。默认 'bottom' */
+    promptPosition?: 'left' | 'right' | 'bottom';
+    /** 拖拽放下回调 */
+    onDrop?: (e: DragEvent, files: File[], rejectFiles: File[]) => void;
+    /** 打开文件选择弹窗时回调 */
+    onOpenFileDialog?: () => void;
+    /** 预览图点击回调（image/picture-card listType） */
+    onPreviewClick?: (fileItem: UploadFileItem) => void;
+    /** accept 校验失败（文件类型不符）的回调 */
+    onAcceptInvalid?: (files: File[]) => void;
+    /** 重试回调 */
+    onRetry?: (file: UploadFileItem) => void;
+    /** 大小校验失败回调 */
+    onSizeError?: (file: UploadFileItem, validResult: 'max' | 'min') => void;
+    /** 校验失败统一文案（覆盖 i18n 默认文案） */
+    validateMessage?: string;
+    /** XHR withCredentials（跨域凭证） */
+    withCredentials?: boolean;
+    /** 上传前文件转换（async，返回转换后的 File） */
+    transformFile?: (file: File) => Promise<File>;
+    /** 拖拽区自定义图标 Snippet */
+    dragIcon?: Snippet;
+    /** 拖拽区主文案（Snippet 或 string） */
+    dragMainText?: string | Snippet;
+    /** 拖拽区副文案（Snippet 或 string） */
+    dragSubText?: string | Snippet;
+    /** 粘贴添加文件（监听 document paste） */
+    addOnPasting?: boolean;
+    /** 触发热点位置（拖拽区时无效）。'start'=前置，'end'=后置，'none'=隐藏触发器。默认 'start' */
+    hotSpotLocation?: 'start' | 'end' | 'none';
+}
+declare const Upload: import("svelte").Component<Props, {}, "">;
+type Upload = ReturnType<typeof Upload>;
+export default Upload;
+//# sourceMappingURL=Upload.svelte.d.ts.map

package/dist/upload/Upload.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Upload.svelte.d.ts","sourceRoot":"","sources":["../../src/upload/Upload.svelte.ts"],"names":[],"mappings":"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"}

package/dist/upload/UploadA11yFixture.svelte

@@ -0,0 +1,23 @@
+<!--
+  Upload a11y 测试夹具：在 LocaleProvider 内渲染 Upload，不传 children。
+  说明：LocaleHarness 总会注入一个 children 插槽，会命中 Upload 的 {#if children}
+  分支，使触发按钮/拖拽区跳过内置 locale 文案（渲染空插槽），故这里直接包
+  LocaleProvider 渲染、不经 harness。仅供 Upload.a11y.test.ts 使用，不对外导出。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import Upload from './Upload.svelte';
+  import type { UploadFileItem } from './types.js';
+
+  interface Props {
+    drag?: boolean;
+    value?: UploadFileItem[];
+    locale?: string;
+  }
+
+  let { drag = false, value, locale = 'en_US' }: Props = $props();
+</script>
+
+<LocaleProvider {locale}>
+  <Upload {drag} {...(value !== undefined ? { value } : {})} />
+</LocaleProvider>

package/dist/upload/UploadA11yFixture.svelte.d.ts

@@ -0,0 +1,10 @@
+import type { UploadFileItem } from './types.js';
+interface Props {
+    drag?: boolean;
+    value?: UploadFileItem[];
+    locale?: string;
+}
+declare const UploadA11yFixture: import("svelte").Component<Props, {}, "">;
+type UploadA11yFixture = ReturnType<typeof UploadA11yFixture>;
+export default UploadA11yFixture;
+//# sourceMappingURL=UploadA11yFixture.svelte.d.ts.map

package/dist/upload/UploadA11yFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadA11yFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/upload/UploadA11yFixture.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG/C,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiBH,QAAA,MAAM,iBAAiB,2CAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/upload/index.d.ts

@@ -0,0 +1,4 @@
+export { default as Upload } from './Upload.svelte';
+export { meta as uploadMeta } from './meta.js';
+export type { UploadFileItem, UploadStatus } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/upload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/upload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/upload/index.js

@@ -0,0 +1,2 @@
+export { default as Upload } from './Upload.svelte';
+export { meta as uploadMeta } from './meta.js';

package/dist/upload/meta.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "Upload";
+    readonly category: "input";
+    readonly description: "文件上传，支持点击与拖拽选择、文件列表（名称/大小/状态/移除）。本轮不做真实网络上传。";
+    readonly props: readonly [{
+        readonly name: "value";
+        readonly type: "UploadFileItem[]";
+        readonly default: "undefined";
+        readonly desc: "受控文件列表；提供则为受控";
+    }, {
+        readonly name: "defaultValue";
+        readonly type: "UploadFileItem[]";
+        readonly default: "[]";
+        readonly desc: "非受控初始文件列表";
+    }, {
+        readonly name: "accept";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "接受的文件类型（input accept）";
+    }, {
+        readonly name: "multiple";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "directory";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "上传整个目录（webkitdirectory），递归选择目录下所有文件，保留 relativePath";
+    }, {
+        readonly name: "limit";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "最大文件数；超出触发 onExceed";
+    }, {
+        readonly name: "maxSize";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "单文件最大体积（KB）；超限标记 error";
+    }, {
+        readonly name: "minSize";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "单文件最小体积（KB）；过小标记 error";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "'default'";
+        readonly desc: "组件级尺寸（触发按钮/拖拽区/列表项），区别于文件项的 file.size 体积";
+    }, {
+        readonly name: "status";
+        readonly type: "'default'|'warning'|'error'";
+        readonly default: "'default'";
+        readonly desc: "组件级校验态（表单联动，影响上传区/边框色），区别于文件项的 file.status 上传进度态";
+    }, {
+        readonly name: "listType";
+        readonly type: "'text'|'image'|'picture-card'|'none'";
+        readonly default: "text";
+        readonly desc: "image/picture-card 显示缩略图网格";
+    }, {
+        readonly name: "drag";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "true 渲染拖拽区，false 渲染按钮";
+    }, {
+        readonly name: "action";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "上传地址；有则选文件后自动 XHR 上传";
+    }, {
+        readonly name: "uploadName";
+        readonly type: "string";
+        readonly default: "'file'";
+        readonly desc: "表单字段名";
+    }, {
+        readonly name: "headers";
+        readonly type: "Record<string,string>";
+        readonly default: "undefined";
+        readonly desc: "额外请求头";
+    }, {
+        readonly name: "uploadData";
+        readonly type: "Record<string,string>";
+        readonly default: "undefined";
+        readonly desc: "额外表单字段";
+    }, {
+        readonly name: "concurrency";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "同时进行的上传数上限；0/不传=不限，超出排队、完成补位";
+    }, {
+        readonly name: "beforeUpload";
+        readonly type: "(file: File, fileList: File[]) => boolean | File | Promise<boolean | File>";
+        readonly default: "undefined";
+        readonly desc: "上传前异步校验/转换：false/reject 跳过该文件，返回 File 替换，true 正常上传";
+    }, {
+        readonly name: "customRequest";
+        readonly type: "(item: UploadFileItem) => void | Promise<void>";
+        readonly default: "undefined";
+        readonly desc: "提供则由外部接管上传（优先于 action）；返回 Promise 时受 concurrency 调度";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(list: UploadFileItem[]) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onExceed";
+        readonly type: "(files: File[]) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onSuccess";
+        readonly type: "(response: string, item: UploadFileItem) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onError";
+        readonly type: "(item: UploadFileItem) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "children";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义触发器内容";
+    }, {
+        readonly name: "showRetry";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "上传失败是否显示重试按钮";
+    }, {
+        readonly name: "showReplace";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "是否允许替换已有文件（单文件模式下显示\"替换\"而不是\"添加\"）";
+    }, {
+        readonly name: "showClear";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "是否显示批量清除按钮";
+    }, {
+        readonly name: "onClear";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "清除按钮点击回调";
+    }, {
+        readonly name: "fileListTitle";
+        readonly type: "string | false";
+        readonly default: "undefined";
+        readonly desc: "文件列表标题文字；false 则不渲染";
+    }, {
+        readonly name: "showTooltip";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "文件名超长是否展示 Tooltip（title 属性）";
+    }, {
+        readonly name: "prompt";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "上传区提示内容（文字或 Snippet）";
+    }, {
+        readonly name: "promptPosition";
+        readonly type: "'left'|'right'|'bottom'";
+        readonly default: "'bottom'";
+        readonly desc: "提示位置：left/right 水平排列，bottom 下方";
+    }, {
+        readonly name: "onDrop";
+        readonly type: "(e: DragEvent, files: File[], rejectFiles: File[]) => void";
+        readonly default: "undefined";
+        readonly desc: "拖拽放下回调";
+    }, {
+        readonly name: "onOpenFileDialog";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "打开文件选择弹窗时回调";
+    }, {
+        readonly name: "onPreviewClick";
+        readonly type: "(fileItem: UploadFileItem) => void";
+        readonly default: "undefined";
+        readonly desc: "预览图点击回调（image/picture-card listType）";
+    }, {
+        readonly name: "onAcceptInvalid";
+        readonly type: "(files: File[]) => void";
+        readonly default: "undefined";
+        readonly desc: "accept 校验失败（文件类型不符）的回调";
+    }, {
+        readonly name: "onRetry";
+        readonly type: "(file: UploadFileItem) => void";
+        readonly default: "undefined";
+        readonly desc: "重试回调";
+    }, {
+        readonly name: "onSizeError";
+        readonly type: "(file: UploadFileItem, validResult: 'max' | 'min') => void";
+        readonly default: "undefined";
+        readonly desc: "大小校验失败回调";
+    }, {
+        readonly name: "validateMessage";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "校验失败统一文案（覆盖 i18n 默认文案）";
+    }, {
+        readonly name: "withCredentials";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "XHR withCredentials（跨域凭证）";
+    }, {
+        readonly name: "transformFile";
+        readonly type: "(file: File) => Promise<File>";
+        readonly default: "undefined";
+        readonly desc: "上传前文件转换（async，返回转换后的 File）";
+    }, {
+        readonly name: "dragIcon";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "拖拽区自定义图标 Snippet";
+    }, {
+        readonly name: "dragMainText";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "拖拽区主文案";
+    }, {
+        readonly name: "dragSubText";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "拖拽区副文案";
+    }, {
+        readonly name: "addOnPasting";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "粘贴添加文件（监听 document paste）";
+    }, {
+        readonly name: "hotSpotLocation";
+        readonly type: "'start'|'end'|'none'";
+        readonly default: "'start'";
+        readonly desc: "触发热点位置：'start'=前置，'end'=后置，'none'=隐藏触发器";
+    }];
+    readonly a11y: {
+        readonly role: "button";
+        readonly keyboard: readonly ["Enter", "Space"];
+        readonly notes: readonly ["隐藏的 file input（visually-hidden）", "触发器为 button", "移除按钮 aria-label「移除」", "dragger role=button + tabindex + 键盘 Enter/Space"];
+    };
+    readonly tokens: readonly ["--cd-upload-*", "--cd-upload-border-warning", "--cd-upload-border-error", "--cd-button-height-*", "--cd-focus-ring", "--cd-color-warning", "--cd-color-danger", "--cd-spacing-*"];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/upload/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/upload/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DP,CAAC"}

package/dist/upload/meta.js

@@ -0,0 +1,64 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export const meta = {
+    name: 'Upload',
+    category: 'input',
+    description: '文件上传，支持点击与拖拽选择、文件列表（名称/大小/状态/移除）。本轮不做真实网络上传。',
+    props: [
+        { name: 'value', type: 'UploadFileItem[]', default: 'undefined', desc: '受控文件列表；提供则为受控' },
+        { name: 'defaultValue', type: 'UploadFileItem[]', default: '[]', desc: '非受控初始文件列表' },
+        { name: 'accept', type: 'string', default: 'undefined', desc: '接受的文件类型（input accept）' },
+        { name: 'multiple', type: 'boolean', default: 'false' },
+        { name: 'directory', type: 'boolean', default: 'false', desc: '上传整个目录（webkitdirectory），递归选择目录下所有文件，保留 relativePath' },
+        { name: 'limit', type: 'number', default: 'undefined', desc: '最大文件数；超出触发 onExceed' },
+        { name: 'maxSize', type: 'number', default: 'undefined', desc: '单文件最大体积（KB）；超限标记 error' },
+        { name: 'minSize', type: 'number', default: 'undefined', desc: '单文件最小体积（KB）；过小标记 error' },
+        { name: 'disabled', type: 'boolean', default: 'false' },
+        { name: 'size', type: "'small'|'default'|'large'", default: "'default'", desc: '组件级尺寸（触发按钮/拖拽区/列表项），区别于文件项的 file.size 体积' },
+        { name: 'status', type: "'default'|'warning'|'error'", default: "'default'", desc: '组件级校验态（表单联动，影响上传区/边框色），区别于文件项的 file.status 上传进度态' },
+        { name: 'listType', type: "'text'|'image'|'picture-card'|'none'", default: 'text', desc: 'image/picture-card 显示缩略图网格' },
+        { name: 'drag', type: 'boolean', default: 'false', desc: 'true 渲染拖拽区，false 渲染按钮' },
+        { name: 'action', type: 'string', default: 'undefined', desc: '上传地址；有则选文件后自动 XHR 上传' },
+        { name: 'uploadName', type: 'string', default: "'file'", desc: '表单字段名' },
+        { name: 'headers', type: 'Record<string,string>', default: 'undefined', desc: '额外请求头' },
+        { name: 'uploadData', type: 'Record<string,string>', default: 'undefined', desc: '额外表单字段' },
+        { name: 'concurrency', type: 'number', default: '0', desc: '同时进行的上传数上限；0/不传=不限，超出排队、完成补位' },
+        { name: 'beforeUpload', type: '(file: File, fileList: File[]) => boolean | File | Promise<boolean | File>', default: 'undefined', desc: '上传前异步校验/转换：false/reject 跳过该文件，返回 File 替换，true 正常上传' },
+        { name: 'customRequest', type: '(item: UploadFileItem) => void | Promise<void>', default: 'undefined', desc: '提供则由外部接管上传（优先于 action）；返回 Promise 时受 concurrency 调度' },
+        { name: 'onChange', type: '(list: UploadFileItem[]) => void', default: 'undefined' },
+        { name: 'onExceed', type: '(files: File[]) => void', default: 'undefined' },
+        { name: 'onSuccess', type: '(response: string, item: UploadFileItem) => void', default: 'undefined' },
+        { name: 'onError', type: '(item: UploadFileItem) => void', default: 'undefined' },
+        { name: 'children', type: 'Snippet', default: 'undefined', desc: '自定义触发器内容' },
+        { name: 'showRetry', type: 'boolean', default: 'true', desc: '上传失败是否显示重试按钮' },
+        { name: 'showReplace', type: 'boolean', default: 'false', desc: '是否允许替换已有文件（单文件模式下显示"替换"而不是"添加"）' },
+        { name: 'showClear', type: 'boolean', default: 'false', desc: '是否显示批量清除按钮' },
+        { name: 'onClear', type: '() => void', default: 'undefined', desc: '清除按钮点击回调' },
+        { name: 'fileListTitle', type: 'string | false', default: 'undefined', desc: '文件列表标题文字；false 则不渲染' },
+        { name: 'showTooltip', type: 'boolean', default: 'true', desc: '文件名超长是否展示 Tooltip（title 属性）' },
+        { name: 'prompt', type: 'string | Snippet', default: 'undefined', desc: '上传区提示内容（文字或 Snippet）' },
+        { name: 'promptPosition', type: "'left'|'right'|'bottom'", default: "'bottom'", desc: '提示位置：left/right 水平排列，bottom 下方' },
+        { name: 'onDrop', type: '(e: DragEvent, files: File[], rejectFiles: File[]) => void', default: 'undefined', desc: '拖拽放下回调' },
+        { name: 'onOpenFileDialog', type: '() => void', default: 'undefined', desc: '打开文件选择弹窗时回调' },
+        { name: 'onPreviewClick', type: '(fileItem: UploadFileItem) => void', default: 'undefined', desc: '预览图点击回调（image/picture-card listType）' },
+        { name: 'onAcceptInvalid', type: '(files: File[]) => void', default: 'undefined', desc: 'accept 校验失败（文件类型不符）的回调' },
+        { name: 'onRetry', type: '(file: UploadFileItem) => void', default: 'undefined', desc: '重试回调' },
+        { name: 'onSizeError', type: "(file: UploadFileItem, validResult: 'max' | 'min') => void", default: 'undefined', desc: '大小校验失败回调' },
+        { name: 'validateMessage', type: 'string', default: 'undefined', desc: '校验失败统一文案（覆盖 i18n 默认文案）' },
+        { name: 'withCredentials', type: 'boolean', default: 'false', desc: 'XHR withCredentials（跨域凭证）' },
+        { name: 'transformFile', type: '(file: File) => Promise<File>', default: 'undefined', desc: '上传前文件转换（async，返回转换后的 File）' },
+        { name: 'dragIcon', type: 'Snippet', default: 'undefined', desc: '拖拽区自定义图标 Snippet' },
+        { name: 'dragMainText', type: 'string | Snippet', default: 'undefined', desc: '拖拽区主文案' },
+        { name: 'dragSubText', type: 'string | Snippet', default: 'undefined', desc: '拖拽区副文案' },
+        { name: 'addOnPasting', type: 'boolean', default: 'false', desc: '粘贴添加文件（监听 document paste）' },
+        { name: 'hotSpotLocation', type: "'start'|'end'|'none'", default: "'start'", desc: "触发热点位置：'start'=前置，'end'=后置，'none'=隐藏触发器" },
+    ],
+    a11y: {
+        role: 'button',
+        keyboard: ['Enter', 'Space'],
+        notes: ['隐藏的 file input（visually-hidden）', '触发器为 button', '移除按钮 aria-label「移除」', 'dragger role=button + tabindex + 键盘 Enter/Space'],
+    },
+    tokens: ['--cd-upload-*', '--cd-upload-border-warning', '--cd-upload-border-error', '--cd-button-height-*', '--cd-focus-ring', '--cd-color-warning', '--cd-color-danger', '--cd-spacing-*'],
+};

package/dist/upload/types.d.ts

@@ -0,0 +1,16 @@
+export type UploadStatus = 'ready' | 'uploading' | 'success' | 'error';
+export interface UploadFileItem {
+    uid: string;
+    name: string;
+    size: number;
+    status: UploadStatus;
+    percent?: number;
+    file?: File;
+    /** 远程预览地址（image/picture-card 列表优先用它，否则由 file 生成 objectURL） */
+    url?: string;
+    /** 校验失败时的本地化提示（如大小超限/过小）；status==='error' 时展示 */
+    error?: string;
+    /** 目录上传时文件相对路径（webkitRelativePath，若可用） */
+    relativePath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/upload/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/upload/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/upload/types.js

@@ -0,0 +1 @@
+export {};