@ticatec/uniface-element 5.0.5 → 5.1.0

package/docs/components/tabs/README.md

@@ -28,12 +28,13 @@ import Tabs from '@ticatec/uniface-element/Tabs';
 | `style` | 否 | `string` | 否 | `undefined` | 否 | 附加到组件根元素的内联样式。 |
 | `tabs` | 是 | `Array<any>` | 是 | `$bindable([])` | 是 | 标签页数据集合；每个标签应包含 `keyField` 与 `textField` 指向的字段。 |
 | `scrollStep` | 否 | `number` | 否 | `100` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `closable` | 否 | `boolean \| TabActionHandler` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `closable` | 否 | `boolean \| IsTabClosable` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `activeTab` | 是 | `any` | 否 | `$bindable()` | 是 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `maxTabWidth` | 否 | `number` | 否 | `undefined` | 否 | 宽度配置，数值单位为像素。 |
 | `tabRender` | 否 | `TabRender` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `onrefresh` | 否 | `TabActionHandler` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
-| `onremove` | 是 | `TabCloseHandler` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
+| `onrefresh` | 否 | `OnTabAction` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
+| `beforeRemove` | 是 | `BeforeTabClose` | 否 | `undefined` | 否 | 关闭标签前的否决钩子：返回 false 阻止关闭。 |
+| `onremove` | 是 | `OnTabAction` | 否 | `undefined` | 否 | 标签被移除后的通知。 |
 | `children` | 是 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
@@ -56,11 +57,19 @@ import Tabs from '@ticatec/uniface-element/Tabs';
 - 默认值：`$bindable()`
 - 推荐写法：`bind:activeTab`
 
+### `beforeRemove`
+
+关闭标签前的否决钩子：返回 false 阻止关闭。
+
+- 类型：`BeforeTabClose`
+- 默认值：`undefined`
+- 示例写法：参见下方完整示例中的类型化实现。
+
 ### `onremove`
 
-事件或行为回调；参数与返回值以类型签名为准。
+标签被移除后的通知。
 
-- 类型：`TabCloseHandler`
+- 类型：`OnTabAction`
 - 默认值：`undefined`
 - 示例写法：`onremove={async (...args: any[]) => { console.log('onremove', ...args); return true; }}`
 
@@ -76,10 +85,10 @@ Svelte Snippet 子内容，用于自定义组件主体。
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
 
-### `TabActionHandler`
+### `IsTabClosable`
 
 ```ts
-export type TabActionHandler = (tab: any) => void;
+export type IsTabClosable = (tab: any) => boolean;
 ```
 
 ### `TabRender`
@@ -88,10 +97,16 @@ export type TabActionHandler = (tab: any) => void;
 export type TabRender = (tab: any) => any;
 ```
 
-### `TabCloseHandler`
+### `OnTabAction`
+
+```ts
+export type OnTabAction = (tab: any) => void;
+```
+
+### `BeforeTabClose`
 
 ```ts
-export type TabCloseHandler = (tab: any) => boolean | Promise<boolean>;
+export type BeforeTabClose = (tab: any) => boolean | void | Promise<boolean | void>;
 ```
 
 ## 示例

package/docs/components/tag/README.md

@@ -21,14 +21,14 @@ import Tag from '@ticatec/uniface-element/Tag';
 
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
-| `size` | 否 | `'big' \| 'middle' \| 'small'` | 否 | `'middle'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `size` | 否 | `Size` | 否 | `'medium'` | 否 | 尺寸档位 |
 | `variant` | 是 | `'borderless' \| 'border' \| 'round'` | 否 | `'border'` | 否 | 视觉样式变体，可选值：`borderless`、`border`、`round`；具体含义见组件说明。 |
 | `removable` | 否 | `boolean` | 否 | `true` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
 | `data` | 否 | `any` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `text` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `style` | 否 | `string` | 否 | `undefined` | 否 | 附加到组件根元素的内联样式。 |
-| `class` | 否 | `string` | 否 | `undefined` | 否 | 附加到组件根元素的 CSS class。 |
+| `class` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的 CSS class。 |
 | `ondelete` | 否 | `(data?: any)=>void` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
 | `color` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 
@@ -44,6 +44,16 @@ import Tag from '@ticatec/uniface-element/Tag';
 - 默认值：`'border'`
 - 示例写法：`variant="borderless"`
 
+## 相关类型定义
+
+以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
+
+### `Size`
+
+```ts
+export type Size = 'small' | 'medium' | 'large';
+```
+
 ## 示例
 
 完整示例见 [example.svelte](./example.svelte)。
@@ -55,6 +65,7 @@ import Tag from '@ticatec/uniface-element/Tag';
 <Tag
   ondelete={async (...args: any[]) => { console.log('ondelete', ...args); return true; }}
   variant="borderless"
+  size="small"
 />
 ```
 

package/docs/components/tag/example.svelte

@@ -5,4 +5,5 @@
 <Tag
   ondelete={async (...args: any[]) => { console.log('ondelete', ...args); return true; }}
   variant="borderless"
+  size="small"
 />

package/docs/components/text-button/README.md

@@ -22,7 +22,7 @@ import TextButton from '@ticatec/uniface-element/TextButton';
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
 | `disabled` | 是 | `boolean` | 否 | `false` | 否 | 禁用交互。禁用后通常不可聚焦、不可修改，也不会触发变更操作。 |
-| `size` | 否 | `ButtonSize` | 否 | `'medium'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `size` | 否 | `Size` | 否 | `'medium'` | 否 | 尺寸档位 |
 | `label` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `type` | 否 | `ButtonType` | 否 | `'default'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `htmlType` | 否 | `'button' \| 'submit' \| 'reset'` | 否 | `'button'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
@@ -31,6 +31,9 @@ import TextButton from '@ticatec/uniface-element/TextButton';
 | `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
 | `tooltip` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `children` | 是 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
+| `tabindex` | 否 | `number` | 否 | `-1` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `outer` | 否 | `boolean` | 否 | `true` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `variant` | 是 | `'plain' \| 'round' \| ''` | 否 | `'round'` | 否 | 视觉样式变体，可选值：`plain`、`round`、`""`(默认)；具体含义见组件说明。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 
@@ -60,10 +63,24 @@ Svelte Snippet 子内容，用于自定义组件主体。
 - 默认值：`undefined`
 - 示例写法：`children={children}`
 
+### `variant`
+
+视觉样式变体，可选值：`plain`、`round`、`""`(默认)；具体含义见组件说明。
+
+- 类型：`'plain' | 'round' | ''`
+- 默认值：`'round'`
+- 示例写法：`variant="plain"`
+
 ## 相关类型定义
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
 
+### `Size`
+
+```ts
+export type Size = 'small' | 'medium' | 'large';
+```
+
 ### `ButtonType`
 
 ```ts
@@ -81,7 +98,9 @@ export type ButtonType = 'default' | 'primary' | 'secondary' | 'third' | 'forth'
 <TextButton
   onclick={async (...args: any[]) => { console.log('onclick', ...args); return true; }}
   label="示例标签"
+  variant="plain"
   disabled={false}
+  size="small"
 />
 ```
 

package/docs/components/text-button/example.svelte

@@ -5,5 +5,7 @@
 <TextButton
   onclick={async (...args: any[]) => { console.log('onclick', ...args); return true; }}
   label="示例标签"
+  variant="plain"
   disabled={false}
+  size="small"
 />

package/docs/components/time-editor/README.md

@@ -34,7 +34,7 @@ import TimeEditor from '@ticatec/uniface-element/TimeEditor';
 | `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 字段失去焦点时触发的回调 |
 | `onchange` | 是 | `(value?: any) => void` | 否 | `undefined` | 否 | 字段值发生变化时触发的回调 |
 | `precision` | 否 | `TimePrecision` | 否 | `'M'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `mandatory` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `clearable` | 否 | `boolean` | 否 | `true` | 否 | 是否允许清空（显示清空按钮），默认 true |
 | `suffix` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `prefix` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `value` | 是 | `number \| undefined` | 否 | `$bindable<number \| undefined>()` | 是 | 组件的核心值。支持绑定时建议使用 `bind:value`，外部修改会同步到组件。 |

package/docs/components/transfer/README.md

@@ -27,8 +27,9 @@ import Transfer from '@ticatec/uniface-element/Transfer';
 | `targetList` | 是 | `Array<any>` | 否 | `$bindable([])` | 是 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `targetTitle` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `itemRender` | 否 | `any` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `filter` | 是 | `FunFilter \| null` | 否 | `null` | 否 | 本地过滤函数。接收当前数据项和搜索文字，返回 true 时保留该项。仅用于已经加载到内存中的 list。 |
-| `onchange` | 是 | `TransferData` | 否 | `undefined` | 否 | 用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。 |
+| `filter` | 是 | `FilterFn \| null` | 否 | `null` | 否 | 本地过滤函数。接收当前数据项和搜索文字，返回 true 时保留该项。仅用于已经加载到内存中的 list。 |
+| `beforeTransfer` | 否 | `BeforeTransfer` | 否 | `undefined` | 否 | 移动前的否决钩子：返回 false 阻止移动。 |
+| `onchange` | 是 | `OnTransfer` | 否 | `undefined` | 否 | 移动完成后的通知。 |
 | `onfocus` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件获得焦点时调用。 |
 | `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件失去焦点时调用。 |
 | `footer$style` | 否 | `string` | 否 | `'width: 100%; background-color: #f0f0f0; padding: 2px 6px; text-align: right; box-sizing: border-box'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
@@ -57,15 +58,15 @@ import Transfer from '@ticatec/uniface-element/Transfer';
 
 本地过滤函数。接收当前数据项和搜索文字，返回 true 时保留该项。仅用于已经加载到内存中的 list。
 
-- 类型：`FunFilter | null`
+- 类型：`FilterFn | null`
 - 默认值：`null`
 - 示例写法：参见下方完整示例中的类型化实现。
 
 ### `onchange`
 
-用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。
+移动完成后的通知。
 
-- 类型：`TransferData`
+- 类型：`OnTransfer`
 - 默认值：`undefined`
 - 示例写法：`onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}`
 
@@ -73,16 +74,22 @@ import Transfer from '@ticatec/uniface-element/Transfer';
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
 
-### `FunFilter`
+### `FilterFn`
 
 ```ts
-export type FunFilter = (item: any, text: string) => boolean;
+export type FilterFn = (item: any, text: string) => boolean;
 ```
 
-### `TransferData`
+### `BeforeTransfer`
 
 ```ts
-export type TransferData = (list: Array<any>, direction: "left" | "right") => Promise<boolean>;
+export type BeforeTransfer = (list: Array<any>, direction: "left" | "right") => boolean | void | Promise<boolean | void>;
+```
+
+### `OnTransfer`
+
+```ts
+export type OnTransfer = (list: Array<any>, direction: "left" | "right") => void;
 ```
 
 ## 示例

package/docs/components/tree-view/README.md

@@ -30,11 +30,12 @@ import TreeView from '@ticatec/uniface-element/TreeView';
 | `lazyLoader` | 是 | `TreeLazyLoader \| null` | 否 | `null` | 否 | 异步分页加载器，签名为 `(filterText, pageNo) => Promise<{list, hasMore}>`。ListBox 当前从第 1 页开始请求，滚动到底部且 `hasMore=true` 时继续加载。 |
 | `activeNode` | 是 | `any` | 否 | `$bindable<any>(null)` | 是 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `class` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的 CSS class。 |
-| `isVisible` | 否 | `NodeVisibleFun` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `onchange` | 是 | `OnNodeSelectionChange` | 否 | `undefined` | 否 | 用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。 |
+| `isVisible` | 否 | `IsNodeVisible` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `beforeChange` | 是 | `BeforeNodeChange` | 否 | `undefined` | 否 | 切换选中节点前的否决钩子：返回 false 阻止切换；node 为 null 表示取消选中。 |
+| `onchange` | 是 | `OnNodeChange` | 否 | `undefined` | 否 | 选中节点变化后的通知。 |
 | `onfocus` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件获得焦点时调用。 |
 | `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件失去焦点时调用。 |
-| `onContextMenu` | 否 | `OnContextMenu` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
+| `oncontextmenu` | 否 | `OnContextMenu` | 否 | `undefined` | 否 | 节点右键菜单回调 (event, node) |
 | `title` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `defaultExpandDepth` | 否 | `number` | 否 | `0` | 否 | 初始展开多少层（0 = 全部折叠，1 = 展开根节点，依此类推）。默认 0。 |
 
@@ -74,11 +75,19 @@ HierarchyTree 实例，负责节点层级、键值与父子关系。
 - 默认值：`$bindable<any>(null)`
 - 推荐写法：`bind:activeNode`
 
+### `beforeChange`
+
+切换选中节点前的否决钩子：返回 false 阻止切换；node 为 null 表示取消选中。
+
+- 类型：`BeforeNodeChange`
+- 默认值：`undefined`
+- 示例写法：参见下方完整示例中的类型化实现。
+
 ### `onchange`
 
-用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。
+选中节点变化后的通知。
 
-- 类型：`OnNodeSelectionChange`
+- 类型：`OnNodeChange`
 - 默认值：`undefined`
 - 示例写法：`onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}`
 
@@ -98,20 +107,26 @@ export interface TreeLazyLoader {
     /**
      * 加载子节点数据
      */
-    load: LoadChildrenFun;
+    load: LoadChildren;
 }
 ```
 
-### `NodeVisibleFun`
+### `IsNodeVisible`
+
+```ts
+export type IsNodeVisible = (node: IHierarchyData<any>) => boolean;
+```
+
+### `BeforeNodeChange`
 
 ```ts
-export type NodeVisibleFun = (node: IHierarchyData<any>) => boolean;
+export type BeforeNodeChange = (node: IHierarchyData<any> | null) => boolean | void | Promise<boolean | void>;
 ```
 
-### `OnNodeSelectionChange`
+### `OnNodeChange`
 
 ```ts
-export type OnNodeSelectionChange = (node: IHierarchyData<any>) => Promise<boolean>;
+export type OnNodeChange = (node: IHierarchyData<any> | null) => void;
 ```
 
 ### `OnContextMenu`
@@ -120,10 +135,10 @@ export type OnNodeSelectionChange = (node: IHierarchyData<any>) => Promise<boole
 export type OnContextMenu = (event: MouseEvent, data: any) => void;
 ```
 
-### `LoadChildrenFun`
+### `LoadChildren`
 
 ```ts
-export type LoadChildrenFun = (item: IHierarchyData<any>) => Promise<Array<any>>;
+export type LoadChildren = (item: IHierarchyData<any>) => Promise<Array<any>>;
 ```
 
 ## 示例
@@ -154,7 +169,8 @@ export type LoadChildrenFun = (item: IHierarchyData<any>) => Promise<Array<any>>
   title="组织架构"
   defaultExpandDepth={1}
   bind:activeNode
-  onchange={async (node) => { console.log('选择节点', node?.data); return true; }}
+  beforeChange={async (node: any) => true}
+  onchange={(node: any) => console.log('选择节点', node?.data)}
 />
 ```
 

package/docs/components/tree-view/example.svelte

@@ -22,5 +22,6 @@
   title="组织架构"
   defaultExpandDepth={1}
   bind:activeNode
-  onchange={async (node) => { console.log('选择节点', node?.data); return true; }}
+  beforeChange={async (node: any) => true}
+  onchange={(node: any) => console.log('选择节点', node?.data)}
 />

package/docs/components/unit-number-editor/README.md

@@ -22,13 +22,14 @@ import UnitNumberEditor from '@ticatec/uniface-element/UnitNumberEditor';
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
 | `variant` | 是 | `EditorVariant` | 否 | `undefined` | 否 | 视觉样式变体，可选值：`""`(默认)、`plain`、`outlined`、`filled`；具体含义见组件说明。 |
+| `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
 | `compact` | 否 | `boolean` | 否 | `false` | 否 | 启用紧凑尺寸，减少组件高度和内边距。 |
 | `style` | 否 | `string` | 否 | `undefined` | 否 | 附加到组件根元素的内联样式。 |
 | `tooltip` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `error` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `value` | 是 | `number` | 否 | `$bindable<number \| undefined>()` | 是 | 组件的核心值。支持绑定时建议使用 `bind:value`，外部修改会同步到组件。 |
 | `unitCode` | 是 | `string` | 否 | `$bindable<string \| undefined>()` | 是 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `units` | 是 | `Array<UnitOption>` | 是 | `—` | 否 | 可选单位列表；用户可在输入框旁切换单位，数值随单位换算显示。 |
+| `options` | 是 | `Array<UnitOption>` | 否 | `[]` | 否 | 可选单位列表 |
 | `disabled` | 是 | `boolean` | 否 | `false` | 否 | 禁用交互。禁用后通常不可聚焦、不可修改，也不会触发变更操作。 |
 | `readonly` | 是 | `boolean` | 否 | `false` | 否 | 只读状态。保留内容展示，但阻止用户修改。 |
 | `prefix` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
@@ -36,8 +37,8 @@ import UnitNumberEditor from '@ticatec/uniface-element/UnitNumberEditor';
 | `menu$height` | 否 | `number` | 否 | `0` | 否 | 高度配置，数值单位为像素。 |
 | `placeholder` | 是 | `string` | 否 | `undefined` | 否 | 值为空时显示的提示文本。 |
 | `onchange` | 是 | `(value: number \| undefined) => void` | 否 | `undefined` | 否 | 用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。 |
-| `onfocus` | 否 | `(e: FocusEvent) => void` | 否 | `undefined` | 否 | 组件获得焦点时调用。 |
-| `onblur` | 否 | `(e: FocusEvent) => void` | 否 | `undefined` | 否 | 组件失去焦点时调用。 |
+| `onfocus` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件获得焦点时调用。 |
+| `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件失去焦点时调用。 |
 | `leadingIcon` | 否 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 渲染入口，用于替换或补充默认内容。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
@@ -68,13 +69,16 @@ import UnitNumberEditor from '@ticatec/uniface-element/UnitNumberEditor';
 - 默认值：`$bindable<string | undefined>()`
 - 推荐写法：`bind:unitCode`
 
-### `units`
+### `options`
 
-可选单位列表；用户可在输入框旁切换单位，数值随单位换算显示。
+可选单位列表
 
 - 类型：`Array<UnitOption>`
-- 默认值：`—`
-- 示例写法：`units={[]}`
+- 默认值：`[]`
+- 示例写法：`options={[
+    {code: 'dev', text: '研发部'},
+    {code: 'product', text: '产品部'}
+  ]}`
 
 ### `disabled`
 
@@ -174,7 +178,6 @@ export default interface UnitOption {
 </script>
 
 <UnitNumberEditor
-  units={[]}
   bind:value
   bind:unitCode
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}

package/docs/components/unit-number-editor/example.svelte

@@ -5,7 +5,6 @@
 </script>
 
 <UnitNumberEditor
-  units={[]}
   bind:value
   bind:unitCode
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ticatec/uniface-element",
-  "version": "5.0.5",
+  "version": "5.1.0",
   "description": "A comprehensive UI component library for Svelte applications with rich form controls, data tables, layouts and interactive elements",
   "keywords": [
     "svelte",
@@ -190,15 +190,15 @@
       "svelte": "./dist/form/date_range/index.js",
       "import": "./dist/form/date_range/index.js"
     },
-    "./AttachmentFiles": {
+    "./AttachmentEditor": {
       "types": "./dist/form/attachment_files/index.d.ts",
       "svelte": "./dist/form/attachment_files/index.js",
       "import": "./dist/form/attachment_files/index.js"
     },
-    "./ImageFiles": {
-      "types": "./dist/form/image-files/index.d.ts",
-      "svelte": "./dist/form/image-files/index.js",
-      "import": "./dist/form/image-files/index.js"
+    "./ImageEditor": {
+      "types": "./dist/form/image_editor/index.d.ts",
+      "svelte": "./dist/form/image_editor/index.js",
+      "import": "./dist/form/image_editor/index.js"
     },
     "./InputOptionsSelect": {
       "types": "./dist/form/input_options_select/index.d.ts",
@@ -260,6 +260,11 @@
       "svelte": "./dist/form/text_editor/index.js",
       "import": "./dist/form/text_editor/index.js"
     },
+    "./PasswordEditor": {
+      "types": "./dist/form/text_editor/PasswordEditor.svelte.d.ts",
+      "svelte": "./dist/form/text_editor/PasswordEditor.svelte",
+      "import": "./dist/form/text_editor/PasswordEditor.svelte"
+    },
     "./TimeEditor": {
       "types": "./dist/form/time_editor/index.d.ts",
       "svelte": "./dist/form/time_editor/index.js",
@@ -491,7 +496,8 @@
     "build": "pnpm run build:css && svelte-kit sync && svelte-package",
     "package": "svelte-kit sync && svelte-package && publint",
     "test:consumer": "pnpm --filter uniface-element-consumer-test test",
-    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json && node ./scripts/check-api-naming.mjs",
+    "check:naming": "node ./scripts/check-api-naming.mjs",
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
     "lint": "eslint src/lib",
     "lint:fix": "eslint src/lib --fix",

package/dist/data_table/lib/CompareFunction.d.ts

@@ -1,3 +0,0 @@
-export type CompareFunction = (o1: any, o2: any) => number;
-declare const compareObject: CompareFunction;
-export { compareObject };

package/dist/data_table/lib/FormatCell.d.ts

@@ -1,2 +0,0 @@
-export type FormatCell = (value: any) => string;
-export type CellHint = (value: any) => string;

package/dist/form/attachment_files/FileRender.svelte

@@ -1,125 +0,0 @@
-<script lang="ts">
-
-    
-    import type AttachmentFile from "./AttachmentFile";
-
-    interface Props {
-        file: AttachmentFile;
-        readonly: boolean;
-        onRemove: (file: AttachmentFile) => void;
-    }
-    
-    let {
-        file,
-        readonly,
-        onRemove
-    }: Props = $props();
-    
-    const getTypeIcon = (type: string) => {
-        switch (type) {
-            case 'img': return 'icon_google_image';
-            case 'pdf': return 'icon_google_picture';
-            case 'doc': return 'icon_google_description';
-            case 'xml': return 'icon_google_table_chart';
-            case 'ppt': return 'icon_google_slideshow';
-            case 'wav': return 'icon_google_audiotrack';
-            case 'mov': return 'icon_google_movie';
-            default: return 'icon_google_attach';
-        }
-    };
-
-    const removeFile = async (event: MouseEvent) => {
-        onRemove?.(file);
-    }
-</script>
-
-<div class="uniface-file-render" class:readonly>
-    <i class="{getTypeIcon(file.type)}" aria-hidden="true"></i>
-    <div class="file-info">
-        <div class="file-name" title={file.name}>{file.name}</div>
-        {#if file.uri}
-            <a href={file.uri} target="_blank" rel="noopener noreferrer" class="file-link">
-                <span>download / open</span>
-            </a>
-        {/if}
-    </div>
-    {#if !readonly}
-        <button type="button" class="remove-btn" onclick={removeFile} aria-label="remove file">
-            <i class="icon_google_delete" aria-hidden="true"></i>
-        </button>
-    {/if}
-</div>
-
-<style>
-    .uniface-file-render {
-        display: flex;
-        align-items: center;
-        gap: 8px;
-        padding: 4px 8px;
-        border-radius: 4px;
-        background-color: rgba(0, 0, 0, 0.02);
-        border: 1px solid transparent;
-        transition: all 0.2s;
-    }
-    
-    .uniface-file-render:hover {
-        background-color: rgba(0, 0, 0, 0.05);
-        border-color: rgba(0, 0, 0, 0.1);
-    }
-    
-    .uniface-file-render.readonly {
-        cursor: default;
-    }
-    
-    .uniface-file-render.readonly:hover {
-        background-color: rgba(0, 0, 0, 0.02);
-        border-color: transparent;
-    }
-    
-    i {
-        font-size: 20px;
-        color: #6b7280;
-    }
-    
-    .file-info {
-        flex: 1;
-        min-width: 0;
-    }
-    
-    .file-name {
-        font-size: 14px;
-        color: #1f2937;
-        overflow: hidden;
-        text-overflow: ellipsis;
-        white-space: nowrap;
-    }
-    
-    .file-link {
-        font-size: 12px;
-        color: #3b82f6;
-        text-decoration: none;
-    }
-    
-    .file-link:hover {
-        text-decoration: underline;
-    }
-    
-    .remove-btn {
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        width: 24px;
-        height: 24px;
-        border: none;
-        background: transparent;
-        cursor: pointer;
-        color: #9ca3af;
-        border-radius: 4px;
-        transition: all 0.2s;
-    }
-    
-    .remove-btn:hover {
-        background-color: rgba(239, 68, 68, 0.1);
-        color: #ef4444;
-    }
-</style>

package/dist/form/attachment_files/FileRender.svelte.d.ts

@@ -1,9 +0,0 @@
-import type AttachmentFile from "./AttachmentFile";
-interface Props {
-    file: AttachmentFile;
-    readonly: boolean;
-    onRemove: (file: AttachmentFile) => void;
-}
-declare const FileRender: import("svelte").Component<Props, {}, "">;
-type FileRender = ReturnType<typeof FileRender>;
-export default FileRender;