shineout 3.10.0-beta.2 → 3.10.0-beta.21

package/esm/tabs/tabs.semantic.js

@@ -0,0 +1,114 @@
+/**
+ * Tabs Semantic DOM 元数据。
+ *
+ * 文档站构建时通过 chunk 模板自动引入，渲染 Semantic tab。
+ *
+ * @see /docs/rfc/0001-semantic-dom.md
+ */
+import React from 'react';
+import { Tabs } from "./..";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var TabsSemanticDemo = function TabsSemanticDemo() {
+  return /*#__PURE__*/_jsx("div", {
+    style: {
+      width: 400
+    },
+    children: /*#__PURE__*/_jsxs(Tabs, {
+      defaultActive: 0,
+      shape: "line",
+      extra: "Extra",
+      collapsible: true,
+      children: [/*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 1",
+        children: "Content 1"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 2",
+        children: "Content 2"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 3",
+        children: "Content 3"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 4",
+        children: "Content 4"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 5",
+        children: "Content 5"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 6",
+        children: "Content 6"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 7",
+        children: "Content 7"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 8",
+        children: "Content 8"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 9",
+        children: "Content 9"
+      }), /*#__PURE__*/_jsx(Tabs.Panel, {
+        tab: "Tab 10",
+        children: "Content 10"
+      })]
+    })
+  });
+};
+var tabsSemantic = {
+  keys: [{
+    key: 'root',
+    cn: 'Tabs 最外层容器',
+    en: 'Tabs outermost wrapper element',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ root: 'my-tabs' }}\n  styles={{ root: { borderRadius: 8 } }}\n/>"
+  }, {
+    key: 'header',
+    cn: '标签栏区域',
+    en: 'Tab bar header area',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ header: 'my-header' }}\n  styles={{ header: { padding: '0 16px' } }}\n/>"
+  }, {
+    key: 'tab',
+    cn: '每个标签项',
+    en: 'Each tab item',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ tab: 'my-tab' }}\n  styles={{ tab: { fontWeight: 500 } }}\n/>"
+  }, {
+    key: 'panel',
+    cn: '内容面板区域',
+    en: 'Content panel area',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ panel: 'my-panel' }}\n  styles={{ panel: { padding: 16 } }}\n/>"
+  }, {
+    key: 'extra',
+    cn: '额外内容区',
+    en: 'Extra content area',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ extra: 'my-extra' }}\n  styles={{ extra: { color: '#999' } }}\n/>"
+  }, {
+    key: 'ink',
+    cn: '指示条（line/dash 形态）',
+    en: 'Ink bar indicator (line/dash shape)',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ ink: 'my-ink' }}\n  styles={{ ink: { background: '#1890ff' } }}\n/>"
+  }, {
+    key: 'prev',
+    cn: '前滚动按钮',
+    en: 'Previous scroll button',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ prev: 'my-prev' }}\n  styles={{ prev: { color: '#1890ff' } }}\n/>"
+  }, {
+    key: 'next',
+    cn: '后滚动按钮',
+    en: 'Next scroll button',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ next: 'my-next' }}\n  styles={{ next: { color: '#1890ff' } }}\n/>"
+  }, {
+    key: 'collapsible',
+    cn: '折叠按钮',
+    en: 'Collapsible button',
+    version: '3.10.0',
+    example: "<Tabs\n  classNames={{ collapsible: 'my-collapsible' }}\n  styles={{ collapsible: { color: '#52c41a' } }}\n/>"
+  }],
+  demo: TabsSemanticDemo
+};
+export default tabsSemantic;

package/esm/tag/interface.d.ts

@@ -1 +1 @@
-export type { TagInputProps as InputProps, TagProps as Props } from './tag.type';
+export type { TagInputProps as InputProps, TagProps as Props, TagSemanticKey } from './tag.type';

package/esm/tag/tag.semantic.d.ts

@@ -0,0 +1,4 @@
+import type { SemanticSchema } from '@sheinx/base';
+import type { TagSemanticKey } from '@sheinx/base';
+declare const tagSemantic: SemanticSchema<TagSemanticKey>;
+export default tagSemantic;

package/esm/tag/tag.semantic.js

@@ -0,0 +1,56 @@
+/**
+ * Tag Semantic DOM 元数据。
+ *
+ * 文档站构建时通过 chunk 模板自动引入，渲染 Semantic tab。
+ *
+ * @see /docs/rfc/0001-semantic-dom.md
+ */
+import React from 'react';
+import { Tag } from "./..";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var TagSemanticDemo = function TagSemanticDemo() {
+  return /*#__PURE__*/_jsxs("div", {
+    style: {
+      display: 'flex',
+      gap: 8,
+      flexWrap: 'wrap'
+    },
+    children: [/*#__PURE__*/_jsx(Tag, {
+      color: "info",
+      onClose: true,
+      children: "Closable Tag"
+    }), /*#__PURE__*/_jsx(Tag, {
+      color: "success",
+      children: "Simple Tag"
+    }), /*#__PURE__*/_jsx(Tag, {
+      color: "warning",
+      shape: "rounded",
+      onClose: true,
+      children: "Rounded"
+    })]
+  });
+};
+var tagSemantic = {
+  keys: [{
+    key: 'root',
+    cn: 'Tag 最外层容器',
+    en: 'Tag outermost wrapper element',
+    version: '3.10.0',
+    example: "<Tag\n  classNames={{ root: 'my-tag' }}\n  styles={{ root: { borderRadius: 8 } }}\n/>"
+  }, {
+    key: 'wrapper',
+    cn: '内容包装区域',
+    en: 'Content wrapper area',
+    version: '3.10.0',
+    example: "<Tag\n  classNames={{ wrapper: 'my-wrapper' }}\n  styles={{ wrapper: { padding: '0 8px' } }}\n/>"
+  }, {
+    key: 'closeIcon',
+    cn: '关闭按钮',
+    en: 'Close icon button',
+    version: '3.10.0',
+    example: "<Tag\n  onClose\n  classNames={{ closeIcon: 'my-close' }}\n  styles={{ closeIcon: { color: 'red' } }}\n/>"
+  }],
+  demo: TagSemanticDemo
+};
+export default tagSemantic;

package/esm/tag/tag.type.d.ts

@@ -1,4 +1,5 @@
-import { TagProps as UnStyledTagProps, TagInputProps as UnStyledTagInputProps } from '@sheinx/base';
+import { TagProps as UnStyledTagProps, TagInputProps as UnStyledTagInputProps, TagSemanticKey as _TagSemanticKey } from '@sheinx/base';
+export type TagSemanticKey = _TagSemanticKey;
 /**
  * @title Tag
  */

package/esm/textarea/textarea.semantic.d.ts

@@ -0,0 +1,4 @@
+import type { SemanticSchema } from '@sheinx/base';
+import type { TextareaSemanticKey } from '@sheinx/base';
+declare const textareaSemantic: SemanticSchema<TextareaSemanticKey>;
+export default textareaSemantic;

package/esm/textarea/textarea.semantic.js

@@ -0,0 +1,38 @@
+/**
+ * Textarea Semantic DOM 元数据。
+ *
+ * 文档站构建时通过 chunk 模板自动引入，渲染 Semantic tab。
+ *
+ * @see /docs/rfc/0001-semantic-dom.md
+ */
+import React from 'react';
+import { Textarea } from "./..";
+import { jsx as _jsx } from "react/jsx-runtime";
+var TextareaSemanticDemo = function TextareaSemanticDemo() {
+  return /*#__PURE__*/_jsx("div", {
+    style: {
+      width: 300
+    },
+    children: /*#__PURE__*/_jsx(Textarea, {
+      placeholder: "Please input",
+      rows: 3
+    })
+  });
+};
+var textareaSemantic = {
+  keys: [{
+    key: 'root',
+    cn: 'Textarea 最外层容器',
+    en: 'Textarea outermost wrapper element',
+    version: '3.10.0',
+    example: "<Textarea\n  classNames={{ root: 'my-textarea' }}\n  styles={{ root: { borderRadius: 8 } }}\n/>"
+  }, {
+    key: 'textarea',
+    cn: '内部 textarea 元素',
+    en: 'Inner textarea element',
+    version: '3.10.0',
+    example: "<Textarea\n  classNames={{ textarea: 'my-textarea-inner' }}\n  styles={{ textarea: { fontFamily: 'monospace' } }}\n/>"
+  }],
+  demo: TextareaSemanticDemo
+};
+export default textareaSemantic;

package/esm/tooltip/tooltip.semantic.d.ts

@@ -0,0 +1,4 @@
+import type { SemanticSchema } from '@sheinx/base';
+import type { TooltipSemanticKey } from '@sheinx/base';
+declare const tooltipSemantic: SemanticSchema<TooltipSemanticKey>;
+export default tooltipSemantic;

package/esm/tooltip/tooltip.semantic.js

@@ -0,0 +1,49 @@
+/**
+ * Tooltip Semantic DOM 元数据。
+ *
+ * 文档站构建时通过 chunk 模板自动引入，渲染 Semantic tab。
+ * 修改 key 列表即修改 TooltipSemanticKey 公开契约，需谨慎。
+ *
+ * @see /docs/rfc/0001-semantic-dom.md
+ */
+import React from 'react';
+import Tooltip from "./index";
+import { jsx as _jsx } from "react/jsx-runtime";
+var TooltipSemanticDemo = function TooltipSemanticDemo() {
+  return /*#__PURE__*/_jsx(Tooltip, {
+    tip: "This is the tooltip content.",
+    trigger: "click",
+    children: /*#__PURE__*/_jsx("span", {
+      style: {
+        padding: '4px 8px',
+        border: '1px solid #d9d9d9',
+        borderRadius: 4,
+        cursor: 'pointer'
+      },
+      children: "Click me"
+    })
+  });
+};
+var tooltipSemantic = {
+  keys: [{
+    key: 'root',
+    cn: '最外层弹层容器（与 className 等价）',
+    en: 'Outer wrapper of the tooltip popup (equivalent to className)',
+    version: '3.10.0',
+    example: "<Tooltip\n  tip=\"hello\"\n  classNames={{\n    root: 'my-classname'\n  }}\n  styles={{\n    root: {\n      color: 'red'\n    }\n  }}\n/>"
+  }, {
+    key: 'arrow',
+    cn: '指向触发元素的小箭头',
+    en: 'The small arrow pointing at the trigger element',
+    version: '3.10.0',
+    example: "<Tooltip\n  tip=\"hello\"\n  classNames={{\n    arrow: 'my-arrow'\n  }}\n  styles={{\n    arrow: {\n      background: '#fafafa'\n    }\n  }}\n/>"
+  }, {
+    key: 'content',
+    cn: '弹层内容承载区',
+    en: 'The inner content area',
+    version: '3.10.0',
+    example: "<Tooltip\n  tip=\"hello\"\n  classNames={{\n    content: 'my-content'\n  }}\n  styles={{\n    content: {\n      padding: 16,\n      borderRadius: 8\n    }\n  }}\n/>"
+  }],
+  demo: TooltipSemanticDemo
+};
+export default tooltipSemantic;

package/esm/transfer/transfer.semantic.d.ts

@@ -0,0 +1,4 @@
+import type { SemanticSchema } from '@sheinx/base';
+import type { TransferSemanticKey } from '@sheinx/base';
+declare const transferSemantic: SemanticSchema<TransferSemanticKey>;
+export default transferSemantic;

package/esm/transfer/transfer.semantic.js

@@ -0,0 +1,63 @@
+/**
+ * Transfer Semantic DOM 元数据。
+ *
+ * 文档站构建时通过 chunk 模板自动引入，渲染 Semantic tab。
+ *
+ * @see /docs/rfc/0001-semantic-dom.md
+ */
+import React from 'react';
+import { Transfer } from "./..";
+import { jsx as _jsx } from "react/jsx-runtime";
+var data = Array.from({
+  length: 6
+}, function (_, i) {
+  return {
+    id: i + 1,
+    name: "Item ".concat(i + 1)
+  };
+});
+var TransferSemanticDemo = function TransferSemanticDemo() {
+  return /*#__PURE__*/_jsx(Transfer, {
+    data: data,
+    keygen: "id",
+    renderItem: "name",
+    defaultValue: [4, 5],
+    titles: ['Source', 'Target'],
+    listHeight: 180
+  });
+};
+var transferSemantic = {
+  keys: [{
+    key: 'root',
+    cn: 'Transfer 最外层容器',
+    en: 'Transfer outermost wrapper element',
+    version: '3.10.0',
+    example: "<Transfer\n  classNames={{ root: 'my-transfer' }}\n  styles={{ root: { border: '1px solid #eee' } }}\n/>"
+  }, {
+    key: 'header',
+    cn: '面板头部区域（含全选 + 标题）',
+    en: 'Panel header area (includes select-all + title)',
+    version: '3.10.0',
+    example: "<Transfer\n  classNames={{ header: 'my-header' }}\n  styles={{ header: { background: '#fafafa' } }}\n/>"
+  }, {
+    key: 'list',
+    cn: '列表容器',
+    en: 'List container',
+    version: '3.10.0',
+    example: "<Transfer\n  classNames={{ list: 'my-list' }}\n  styles={{ list: { padding: 4 } }}\n/>"
+  }, {
+    key: 'item',
+    cn: '单个列表项',
+    en: 'Individual list item',
+    version: '3.10.0',
+    example: "<Transfer\n  classNames={{ item: 'my-item' }}\n  styles={{ item: { borderRadius: 4 } }}\n/>"
+  }, {
+    key: 'operations',
+    cn: '中间操作按钮区',
+    en: 'Middle operation buttons area',
+    version: '3.10.0',
+    example: "<Transfer\n  classNames={{ operations: 'my-ops' }}\n  styles={{ operations: { padding: '0 12px' } }}\n/>"
+  }],
+  demo: TransferSemanticDemo
+};
+export default transferSemantic;

package/esm/tree/interface.d.ts

@@ -1,2 +1,2 @@
-export type { TreeProps as Props } from './tree.type';
+export type { TreeProps as Props, TreeSemanticKey } from './tree.type';
 export type { KeygenResult } from '@sheinx/hooks';

package/esm/tree/tree.semantic.d.ts

@@ -0,0 +1,4 @@
+import type { SemanticSchema } from '@sheinx/base';
+import type { TreeSemanticKey } from '@sheinx/base';
+declare const treeSemantic: SemanticSchema<TreeSemanticKey>;
+export default treeSemantic;

package/esm/tree/tree.semantic.js

@@ -0,0 +1,75 @@
+/**
+ * Tree Semantic DOM 元数据。
+ *
+ * 文档站构建时通过 chunk 模板自动引入，渲染 Semantic tab。
+ *
+ * @see /docs/rfc/0001-semantic-dom.md
+ */
+import React from 'react';
+import { Tree } from "./..";
+import { jsx as _jsx } from "react/jsx-runtime";
+var treeData = [{
+  id: '1',
+  name: 'Node 1',
+  children: [{
+    id: '1-1',
+    name: 'Child 1-1'
+  }, {
+    id: '1-2',
+    name: 'Child 1-2'
+  }]
+}, {
+  id: '2',
+  name: 'Node 2',
+  children: [{
+    id: '2-1',
+    name: 'Child 2-1'
+  }]
+}, {
+  id: '3',
+  name: 'Node 3'
+}];
+var TreeSemanticDemo = function TreeSemanticDemo() {
+  return /*#__PURE__*/_jsx("div", {
+    style: {
+      width: 300
+    },
+    children: /*#__PURE__*/_jsx(Tree, {
+      data: treeData,
+      keygen: "id",
+      renderItem: function renderItem(node) {
+        return node.name;
+      },
+      defaultExpandAll: true
+    })
+  });
+};
+var treeSemantic = {
+  keys: [{
+    key: 'root',
+    cn: 'Tree 最外层容器',
+    en: 'Tree outermost wrapper element',
+    version: '3.10.0',
+    example: "<Tree\n  classNames={{ root: 'my-tree' }}\n  styles={{ root: { border: '1px solid #eee' } }}\n/>"
+  }, {
+    key: 'node',
+    cn: '每个树节点容器',
+    en: 'Each tree node wrapper',
+    version: '3.10.0',
+    example: "<Tree\n  classNames={{ node: 'my-node' }}\n  styles={{ node: { padding: '4px 0' } }}\n/>"
+  }, {
+    key: 'content',
+    cn: '节点内容区域（含 checkbox 和文本）',
+    en: 'Node content area (includes checkbox and text)',
+    version: '3.10.0',
+    example: "<Tree\n  classNames={{ content: 'my-content' }}\n  styles={{ content: { borderRadius: 4 } }}\n/>"
+  }, {
+    key: 'icon',
+    cn: '展开/折叠图标',
+    en: 'Expand/collapse icon',
+    version: '3.10.0',
+    example: "<Tree\n  classNames={{ icon: 'my-icon' }}\n  styles={{ icon: { color: '#1890ff' } }}\n/>"
+  }],
+  demo: TreeSemanticDemo
+};
+export default treeSemantic;

package/esm/tree/tree.type.d.ts

@@ -1,4 +1,5 @@
-import { TreeProps as UnStyledTreeProps } from '@sheinx/base';
+import { TreeProps as UnStyledTreeProps, TreeSemanticKey as _TreeSemanticKey } from '@sheinx/base';
+export type TreeSemanticKey = _TreeSemanticKey;
 /**
  * @title Tree
  */

package/esm/tree-select/tree-select.semantic.d.ts

@@ -0,0 +1,4 @@
+import type { SemanticSchema } from '@sheinx/base';
+import type { TreeSelectSemanticKey } from '@sheinx/base';
+declare const treeSelectSemantic: SemanticSchema<TreeSelectSemanticKey>;
+export default treeSelectSemantic;

package/esm/tree-select/tree-select.semantic.js

@@ -0,0 +1,81 @@
+/**
+ * TreeSelect Semantic DOM 元数据。
+ *
+ * 文档站构建时通过 chunk 模板自动引入，渲染 Semantic tab。
+ *
+ * @see /docs/rfc/0001-semantic-dom.md
+ */
+import React from 'react';
+import { TreeSelect } from "./..";
+import { jsx as _jsx } from "react/jsx-runtime";
+var treeData = [{
+  id: '1',
+  name: 'Option 1',
+  children: [{
+    id: '1-1',
+    name: 'Option 1-1'
+  }, {
+    id: '1-2',
+    name: 'Option 1-2'
+  }]
+}, {
+  id: '2',
+  name: 'Option 2',
+  children: [{
+    id: '2-1',
+    name: 'Option 2-1'
+  }]
+}, {
+  id: '3',
+  name: 'Option 3'
+}];
+var TreeSelectSemanticDemo = function TreeSelectSemanticDemo() {
+  return /*#__PURE__*/_jsx("div", {
+    style: {
+      width: 300
+    },
+    children: /*#__PURE__*/_jsx(TreeSelect, {
+      data: treeData,
+      keygen: "id",
+      renderItem: function renderItem(node) {
+        return node.name;
+      },
+      placeholder: "Please select"
+    })
+  });
+};
+var treeSelectSemantic = {
+  keys: [{
+    key: 'root',
+    cn: 'TreeSelect 最外层容器',
+    en: 'TreeSelect outermost wrapper element',
+    version: '3.10.0',
+    example: "<TreeSelect\n  classNames={{ root: 'my-tree-select' }}\n  styles={{ root: { border: '1px solid #eee' } }}\n/>"
+  }, {
+    key: 'header',
+    cn: '结果区域（显示已选值 / placeholder）',
+    en: 'Header area (shows selected values / placeholder)',
+    version: '3.10.0',
+    example: "<TreeSelect\n  classNames={{ header: 'my-header' }}\n  styles={{ header: { padding: '8px' } }}\n/>"
+  }, {
+    key: 'popup',
+    cn: '下拉面板',
+    en: 'Dropdown popup panel',
+    version: '3.10.0',
+    example: "<TreeSelect\n  classNames={{ popup: 'my-popup' }}\n  styles={{ popup: { background: '#fff' } }}\n/>"
+  }, {
+    key: 'list',
+    cn: '树列表容器',
+    en: 'Tree list container',
+    version: '3.10.0',
+    example: "<TreeSelect\n  classNames={{ list: 'my-list' }}\n  styles={{ list: { padding: 8 } }}\n/>"
+  }, {
+    key: 'option',
+    cn: '树节点选项',
+    en: 'Tree node option',
+    version: '3.10.0',
+    example: "<TreeSelect\n  classNames={{ option: 'my-option' }}\n  styles={{ option: { borderRadius: 4 } }}\n/>"
+  }],
+  demo: TreeSelectSemanticDemo
+};
+export default treeSelectSemantic;

package/esm/type.d.ts

@@ -1,6 +1,7 @@
 export * as Alert from './alert/interface';
 export * as Avatar from './avatar/interface';
 export * as Badge from './badge/interface';
+export * as BorderBeam from './border-beam/interface';
 export * as Breadcrumb from './breadcrumb/interface';
 export * as Button from './button/interface';
 export * as Card from './card/interface';

package/esm/type.js

@@ -4,6 +4,8 @@ import * as _Avatar from "./avatar/interface";
 export { _Avatar as Avatar };
 import * as _Badge from "./badge/interface";
 export { _Badge as Badge };
+import * as _BorderBeam from "./border-beam/interface";
+export { _BorderBeam as BorderBeam };
 import * as _Breadcrumb from "./breadcrumb/interface";
 export { _Breadcrumb as Breadcrumb };
 import * as _Button from "./button/interface";

package/esm/upload/button.js

@@ -5,6 +5,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { UploadButton } from '@sheinx/base';
+import { util } from '@sheinx/hooks';
 import { useAlertStyle, useButtonStyle, useImageStyle, usePopoverStyle, useSpinStyle, useUploadStyle } from '@sheinx/shineout-style';
 import useFieldCommon from "../hooks/use-field-common";
 import useUploadCommon from "./use-upload-common";
@@ -24,8 +25,18 @@ var BaseUploadButton = function BaseUploadButton(props) {
 };
 BaseUploadButton.displayName = 'ShineoutUploadButton';
 export default (function (props) {
+  var _props$htmlName;
   var customProps = useUploadCommon({
     rules: props.rules
   });
-  return useFieldCommon(_objectSpread(_objectSpread({}, props), customProps), BaseUploadButton);
+
+  // 同 upload.tsx：useFieldCommon 会把 name 从子组件 props 中移除，
+  // 提前将其作为 htmlName 的 fallback 保存，以兼容 v2 中 name 作为 FormData 键名的行为。
+  var htmlName = (_props$htmlName = props.htmlName) !== null && _props$htmlName !== void 0 ? _props$htmlName : typeof props.name === 'string' ? props.name : undefined;
+  if (!props.htmlName && typeof props.name === 'string' && props.name !== 'file') {
+    util.devUseWarning.warn("Upload.Button \u7684 name=\"".concat(props.name, "\" \u4F1A\u4F5C\u4E3A\u4E0A\u4F20\u8BF7\u6C42 FormData \u7684\u5B57\u6BB5\u540D\u3002\u5982\u9700\u4FDD\u6301\u9ED8\u8BA4\u5B57\u6BB5\u540D \"file\"\uFF0C\u8BF7\u663E\u5F0F\u8BBE\u7F6E htmlName=\"file\"\u3002"));
+  }
+  return useFieldCommon(_objectSpread(_objectSpread({}, props), {}, {
+    htmlName: htmlName
+  }, customProps), BaseUploadButton);
 });

package/esm/upload/image.js

@@ -5,6 +5,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { UploadImage } from '@sheinx/base';
+import { util } from '@sheinx/hooks';
 import { useAlertStyle, useButtonStyle, useImageStyle, usePopoverStyle, useSpinStyle, useUploadStyle } from '@sheinx/shineout-style';
 import useFieldCommon from "../hooks/use-field-common";
 import useUploadCommon from "./use-upload-common";
@@ -32,6 +33,9 @@ export default (function (props) {
   // 同 upload.tsx：useFieldCommon 会把 name 从子组件 props 中移除，
   // 提前将其作为 htmlName 的 fallback 保存，以兼容 v2 中 name 作为 FormData 键名的行为。
   var htmlName = (_props$htmlName = props.htmlName) !== null && _props$htmlName !== void 0 ? _props$htmlName : typeof props.name === 'string' ? props.name : undefined;
+  if (!props.htmlName && typeof props.name === 'string' && props.name !== 'file') {
+    util.devUseWarning.warn("Upload.Image \u7684 name=\"".concat(props.name, "\" \u4F1A\u4F5C\u4E3A\u4E0A\u4F20\u8BF7\u6C42 FormData \u7684\u5B57\u6BB5\u540D\u3002\u5982\u9700\u4FDD\u6301\u9ED8\u8BA4\u5B57\u6BB5\u540D \"file\"\uFF0C\u8BF7\u663E\u5F0F\u8BBE\u7F6E htmlName=\"file\"\u3002"));
+  }
   return useFieldCommon(_objectSpread(_objectSpread({}, props), {}, {
     htmlName: htmlName
   }, customProps), BaseUploadImage);

package/esm/upload/interface.d.ts

@@ -1,4 +1,4 @@
-export type { UploadProps as Props, Validator } from './upload.type';
+export type { UploadProps as Props, Validator, UploadRef as Ref } from './upload.type';
 export type { UploadImageProps as ImageProps } from './image.type';
 export type { UploadDraggerProps as DraggerProps } from './dragger.type';
 export type { UploadOptions as Options } from '@sheinx/hooks';

package/esm/upload/upload.js

@@ -5,6 +5,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { Upload } from '@sheinx/base';
+import { util } from '@sheinx/hooks';
 import { useAlertStyle, useButtonStyle, useImageStyle, usePopoverStyle, useSpinStyle, useUploadStyle } from '@sheinx/shineout-style';
 import useFieldCommon from "../hooks/use-field-common";
 import useUploadCommon from "./use-upload-common";
@@ -33,6 +34,9 @@ export default (function (props) {
   // 但 Upload 的 name 在 v2 中同时作为 FormData 的键名，为了兼容 v2 行为，
   // 在 name 被移除之前将其作为 htmlName 的 fallback 保存下来。
   var htmlName = (_props$htmlName = props.htmlName) !== null && _props$htmlName !== void 0 ? _props$htmlName : typeof props.name === 'string' ? props.name : undefined;
+  if (!props.htmlName && typeof props.name === 'string' && props.name !== 'file') {
+    util.devUseWarning.warn("Upload \u7684 name=\"".concat(props.name, "\" \u4F1A\u4F5C\u4E3A\u4E0A\u4F20\u8BF7\u6C42 FormData \u7684\u5B57\u6BB5\u540D\u3002\u5982\u9700\u4FDD\u6301\u9ED8\u8BA4\u5B57\u6BB5\u540D \"file\"\uFF0C\u8BF7\u663E\u5F0F\u8BBE\u7F6E htmlName=\"file\"\u3002"));
+  }
   return useFieldCommon(_objectSpread(_objectSpread({}, props), {}, {
     htmlName: htmlName
   }, customProps), BaseUpload, 'array');

package/esm/upload/upload.semantic.d.ts

@@ -0,0 +1,4 @@
+import type { SemanticSchema } from '@sheinx/base';
+import type { UploadSemanticKey } from '@sheinx/base';
+declare const uploadSemantic: SemanticSchema<UploadSemanticKey>;
+export default uploadSemantic;