@ticatec/uniface-element 5.0.4 → 5.1.0

package/docs/components/context-menu/README.md

@@ -43,12 +43,12 @@ export interface ContextMenuItem {
     /**
      * Display text for the menu item
      */
-    text?: string;
+    label?: string;
 
     /**
      * Action to execute when item is clicked
      */
-    action?: ActionCallback;
+    handler?: ContextMenuAction;
 
     /**
      * Whether the item is disabled
@@ -72,10 +72,10 @@ export interface ContextMenuItem {
 }
 ```
 
-### `ActionCallback`
+### `ContextMenuAction`
 
 ```ts
-export type ActionCallback = () => void;
+export type ContextMenuAction = () => void;
 ```
 
 ## 示例
@@ -87,7 +87,7 @@ export type ActionCallback = () => void;
 
   function openMenu(event: MouseEvent) {
     event.preventDefault();
-    ContextMenu.show(event, [{text: '查看', action: () => console.log('查看')}]);
+    ContextMenu.show(event, [{label: '查看', handler: () => console.log('查看')}]);
   }
 </script>
 

package/docs/components/context-menu/example.svelte

@@ -3,7 +3,7 @@
 
   function openMenu(event: MouseEvent) {
     event.preventDefault();
-    ContextMenu.show(event, [{text: '查看', action: () => console.log('查看')}]);
+    ContextMenu.show(event, [{label: '查看', handler: () => console.log('查看')}]);
   }
 </script>
 

package/docs/components/criteria-field/README.md

@@ -59,6 +59,7 @@ Svelte Snippet 子内容，用于自定义组件主体。
 
 <CriteriaField
   label="示例标签"
+  size="x15"
 >
   <div>在这里放置子内容</div>
 </CriteriaField>

package/docs/components/criteria-field/example.svelte

@@ -4,6 +4,7 @@
 
 <CriteriaField
   label="示例标签"
+  size="x15"
 >
   <div>在这里放置子内容</div>
 </CriteriaField>

package/docs/components/data-table/README.md

@@ -31,9 +31,11 @@ import DataTable from '@ticatec/uniface-element/DataTable';
 | `inlineRowHeight` | 是 | `number` | 否 | `$bindable(80)` | 是 | 高度配置，数值单位为像素。 |
 | `rowBorder` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `colBorder` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `emptyIndicator` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `emptyText` | 否 | `string` | 否 | `undefined` | 否 | 无数据时显示的文案 |
 | `getRowFontStyle` | 否 | `GetRowFontStyle<T>` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `style` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的内联样式。 |
+| `virtual` | 否 | `boolean` | 否 | `false` | 否 | 行虚拟化(窗口化渲染):仅渲染可视区域附近的行,大数据集(数千行以上) 建议开启。要求所有行高度一致(即统一的 rowHeight),因此默认关闭。 |
+| `overscan` | 否 | `number` | 否 | `8` | 否 | 虚拟化时可视区上下额外渲染的行数。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 
@@ -46,8 +48,8 @@ import DataTable from '@ticatec/uniface-element/DataTable';
 - 类型：`Array<DataColumn>`
 - 默认值：`—`
 - 示例写法：`columns={[
-    {field: 'name', text: '姓名', width: 160},
-    {field: 'department', text: '部门', width: 180}
+    {field: 'name', title: '姓名', width: 160},
+    {field: 'department', title: '部门', width: 180}
   ]}`
 
 ### `list`
@@ -87,9 +89,9 @@ import DataTable from '@ticatec/uniface-element/DataTable';
 export default interface DataColumn {
 
     /**
-     * 列头文字
+     * 列头文字（与 ConciseListTable 的 Column.title 统一）
      */
-    text: string;
+    title: string;
 
     /**
      * 对应的字段/属性名
@@ -116,12 +118,12 @@ export default interface DataColumn {
     /**
      * 是否可以换行，默认为false
      */
-    warp?: boolean;
+    wrap?: boolean;
 
     /**
      * 单元格转换函数
      */
-    formatter?: FormatCell;
+    formatter?: FormatCellFn;
 
     /**
      * 是否将单元格内容作为可信 HTML 渲染（{@html}），而非纯文本转义。
@@ -129,11 +131,6 @@ export default interface DataColumn {
      */
     renderHTML?: boolean;
 
-    /**
-     * @deprecated 请使用 renderHTML；名称容易被误读为"转义 HTML"，
-     * 实际含义相反——设为 true 会把内容作为可信 HTML 渲染。仍受支持以兼容旧调用。
-     */
-    escapeHTML?: boolean;
 
     /**
      * 超链接设置
@@ -163,7 +160,7 @@ export default interface DataColumn {
     /**
      *
      */
-    compareFunction?: CompareFunction;
+    compareFunction?: CompareFn;
 
     /**
      * 获取表格的样式
@@ -214,7 +211,8 @@ export default interface IndicatorColumn {
     /**
      * 是否显示行号
      */
-    displayNo?: boolean
+    /** 是否显示行号 */
+    showRowNo?: boolean
 }
 ```
 
@@ -224,10 +222,35 @@ export default interface IndicatorColumn {
 export type GetRowFontStyle<T = any> = (data: T) => RowFontStyle;
 ```
 
-### `FormatCell`
+### `Column`
+
+```ts
+export default interface Column {
+    // Display title for column header
+    title: string;
+    // Field name in data object
+    field: string;
+    // Width in pixels
+    width: number;
+    // Alignment: "left", "center", "right"
+    align?: "left" | "center" | "right",
+    // Flex weight: 0 = fixed width, >0 = proportional scaling
+    weight?: number;
+    // Optional formatter function
+    formatter?: (value: any) => string
+    // When true, the cell's (formatted) value is rendered as raw HTML ({@html}).
+    // Defaults to false/unset (safe, escaped plain text). Only set true when the
+    // field/formatter output is trusted markup — this is the same opt-in semantic as
+    // DataColumn#renderHTML in the data_table component.
+    renderHTML?: boolean;
+
+}
+```
+
+### `FormatCellFn`
 
 ```ts
-export type FormatCell = (value: any) => string;
+export type FormatCellFn = (value: any) => string;
 ```
 
 ### `HrefBuilder`
@@ -242,10 +265,10 @@ export type HrefBuilder = (item: any) => Array<HrefLink> | HrefLink | string;
 export type CellHint = (value: any) => string;
 ```
 
-### `CompareFunction`
+### `CompareFn`
 
 ```ts
-export type CompareFunction = (o1: any, o2: any) => number;
+export type CompareFn = (o1: any, o2: any) => number;
 ```
 
 ### `GetCellStyle`
@@ -257,7 +280,7 @@ export type GetCellStyle = (data: any) => string;
 ### `GetRowActions`
 
 ```ts
-export type GetRowActions = (data: any) => Array<CellAction>;
+export type GetRowActions<T = any> = (item: T) => Array<RowAction<T>>;
 ```
 
 ### `RowFontStyle`
@@ -286,37 +309,37 @@ export default interface HrefLink {
     /**
      * 显示超链接的文字
      */
-    text: string;
+    label: string;
     /**
      * 点击的处理函数
      */
-    action: HrefAction;
+    handler: OnHrefClick;
 }
 ```
 
-### `CellAction`
+### `RowAction`
 
 ```ts
-export interface CellAction {
-    /**
-     * action的文本
-     */
-    text: string;
-    /**
-     * action的类型
-     */
+export default interface RowAction<T = any> {
+    /** 显示文字 */
+    label: string;
+    /** 语义类型 */
     type?: ButtonType;
-    /**
-     * 点击处理
-     */
-    handle: HandleAction;
+    /** 前缀图标 */
+    icon?: string;
+    /** 提示 */
+    tooltip?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 点击处理 */
+    handler: ActionHandler<T>;
 }
 ```
 
-### `HrefAction`
+### `OnHrefClick`
 
 ```ts
-export type HrefAction = () => void;
+export type OnHrefClick = () => void;
 ```
 
 ### `ButtonType`
@@ -325,10 +348,10 @@ export type HrefAction = () => void;
 export type ButtonType = 'default' | 'primary' | 'secondary' | 'third' | 'forth';
 ```
 
-### `HandleAction`
+### `ActionHandler`
 
 ```ts
-export type HandleAction = (data: any) => Promise<void>;
+export type ActionHandler<T = any> = (data: T) => void | Promise<void>;
 ```
 
 ## 示例
@@ -343,8 +366,8 @@ export type HandleAction = (data: any) => Promise<void>;
 
 <DataTable
   columns={[
-    {field: 'name', text: '姓名', width: 160},
-    {field: 'department', text: '部门', width: 180}
+    {field: 'name', title: '姓名', width: 160},
+    {field: 'department', title: '部门', width: 180}
   ]}
   list={[
     {id: 1, name: '张三', department: '研发部'},

package/docs/components/data-table/example.svelte

@@ -6,8 +6,8 @@
 
 <DataTable
   columns={[
-    {field: 'name', text: '姓名', width: 160},
-    {field: 'department', text: '部门', width: 180}
+    {field: 'name', title: '姓名', width: 160},
+    {field: 'department', title: '部门', width: 180}
   ]}
   list={[
     {id: 1, name: '张三', department: '研发部'},

package/docs/components/date-picker/README.md

@@ -33,7 +33,7 @@ import DatePicker from '@ticatec/uniface-element/DatePicker';
 | `onfocus` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 字段获得焦点时触发的回调 |
 | `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 字段失去焦点时触发的回调 |
 | `onchange` | 是 | `(value?: any) => void` | 否 | `undefined` | 否 | 字段值发生变化时触发的回调 |
-| `mandatory` | 否 | `boolean` | 否 | `false` | 否 | 是否为必填字段，必填时字段值不能为空 |
+| `clearable` | 否 | `boolean` | 否 | `undefined` | 否 | 是否允许清空（显示清空按钮），默认 true |
 | `onkeydown` | 否 | `(event: KeyboardEvent) => void` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
 | `onkeyup` | 否 | `(event: KeyboardEvent) => void` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
 | `onkeypress` | 否 | `(event: KeyboardEvent) => void` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |

package/docs/components/date-time-picker/README.md

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

package/docs/components/dialog/README.md

@@ -25,12 +25,11 @@ import Dialog from '@ticatec/uniface-element/Dialog';
 | `width` | 否 | `string` | 否 | `'unset'` | 否 | 宽度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
 | `height` | 否 | `string` | 否 | `'unset'` | 否 | 高度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
 | `actions` | 否 | `ButtonActions \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `closeConfirm` | 否 | `DialogCloseConfirm \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `beforeClose` | 是 | `BeforeClose \| null` | 否 | `null` | 否 | 关闭前的否决钩子：结果为 MR_CANCEL / MR_CLOSE 时调用，返回 false 阻止关闭 |
 | `content$style` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `hideClose` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `closeButton` | 否 | `string` | 否 | `i18nRes.common.btnClose` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `onClose` | 是 | `OnClose \| null` | 否 | `null` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
-| `closable` | 否 | `boolean` | 否 | `true` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `closable` | 否 | `boolean` | 否 | `true` | 否 | 是否允许用户不经过显式动作直接关闭：控制标题栏 X、Escape 键和自动追加的"关闭"动作。 为 false 时用户必须点击 actions 中的某个动作。 |
+| `closeText` | 否 | `string` | 否 | `i18nRes.common.btnClose()` | 否 | 自动追加的"关闭"动作的文字 |
+| `onclose` | 是 | `OnClose \| null` | 否 | `null` | 否 | 关闭后的通知回调，参数为 ModalResult |
 | `dialog$style` | 否 | `string` | 否 | `""` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `children` | 是 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
 
@@ -46,13 +45,21 @@ import Dialog from '@ticatec/uniface-element/Dialog';
 - 默认值：`—`
 - 示例写法：`title="示例标题"`
 
-### `onClose`
+### `beforeClose`
 
-事件或行为回调；参数与返回值以类型签名为准。
+关闭前的否决钩子：结果为 MR_CANCEL / MR_CLOSE 时调用，返回 false 阻止关闭
+
+- 类型：`BeforeClose | null`
+- 默认值：`null`
+- 示例写法：参见下方完整示例中的类型化实现。
+
+### `onclose`
+
+关闭后的通知回调，参数为 ModalResult
 
 - 类型：`OnClose | null`
 - 默认值：`null`
-- 示例写法：`onClose={async (...args: any[]) => { console.log('onClose', ...args); return true; }}`
+- 示例写法：`onclose={async (...args: any[]) => { console.log('onclose', ...args); return true; }}`
 
 ### `children`
 
@@ -80,10 +87,10 @@ Svelte Snippet 子内容，用于自定义组件主体。
 export type ButtonActions = Array<ButtonAction | null>;
 ```
 
-### `DialogCloseConfirm`
+### `BeforeClose`
 
 ```ts
-export type DialogCloseConfirm = () => Promise<boolean>;
+export type BeforeClose = () => boolean | void | Promise<boolean | void>;
 ```
 
 ### `OnClose`
@@ -124,7 +131,7 @@ export interface ButtonAction {
     /**
      * click处理函数
      */
-    handler?: MouseClickHandler;
+    handler?: OnClick;
 }
 ```
 
@@ -144,10 +151,10 @@ export enum ModalResult {
 export type ButtonType = 'default' | 'primary' | 'secondary' | 'third' | 'forth';
 ```
 
-### `MouseClickHandler`
+### `OnClick`
 
 ```ts
-export type MouseClickHandler = (event: MouseEvent) => void;
+export type OnClick = (event: MouseEvent) => void;
 ```
 
 ## 示例
@@ -160,7 +167,7 @@ export type MouseClickHandler = (event: MouseEvent) => void;
 
 <Dialog
   title="示例标题"
-  onClose={async (...args: any[]) => { console.log('onClose', ...args); return true; }}
+  onclose={async (...args: any[]) => { console.log('onclose', ...args); return true; }}
   closable={true}
   width="240px"
   height="48px"

package/docs/components/dialog/example.svelte

@@ -4,7 +4,7 @@
 
 <Dialog
   title="示例标题"
-  onClose={async (...args: any[]) => { console.log('onClose', ...args); return true; }}
+  onclose={async (...args: any[]) => { console.log('onclose', ...args); return true; }}
   closable={true}
   width="240px"
   height="48px"

package/docs/components/form-field/README.md

@@ -29,7 +29,7 @@ import FormField from '@ticatec/uniface-element/FormField';
 | `label$alignment` | 否 | `'center' \| 'top'` | 否 | `'center'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `autoHeight` | 否 | `boolean` | 否 | `undefined` | 否 | 高度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
 | `required` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `layout` | 否 | `FieldLayout` | 否 | `getLayoutMode()` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `direction` | 否 | `Direction` | 否 | `getLayoutMode()` | 否 | 标签与控件的排布方向 |
 | `class` | 否 | `string` | 否 | `undefined` | 否 | 附加到组件根元素的 CSS class。 |
 | `children` | 是 | `Snippet` | 是 | `—` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
 
@@ -57,10 +57,10 @@ Svelte Snippet 子内容，用于自定义组件主体。
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
 
-### `FieldLayout`
+### `Direction`
 
 ```ts
-export type FieldLayout = 'vertical' | 'horizontal';
+export type Direction = 'vertical' | 'horizontal';
 ```
 
 ## 示例

package/docs/components/grid-form/README.md

@@ -23,7 +23,7 @@ import GridForm from '@ticatec/uniface-element/GridForm';
 | --- | --- | --- | --- | --- | --- | --- |
 | `style` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的内联样式。 |
 | `columns` | 是 | `number` | 否 | `6` | 否 | 表格列定义，控制字段、标题、宽度、格式化、链接和自定义渲染。 |
-| `variant` | 是 | `string` | 否 | `undefined` | 否 | 视觉样式变体，可选值见类型列。 |
+| `variant` | 是 | `EditorVariant` | 否 | `undefined` | 否 | 传给内部编辑器的外观变体 |
 | `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
 | `children` | 是 | `Snippet<[string \| undefined, string \| undefined]>` | 否 | `undefined` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
 
@@ -41,11 +41,11 @@ import GridForm from '@ticatec/uniface-element/GridForm';
 
 ### `variant`
 
-视觉样式变体，可选值见类型列。
+传给内部编辑器的外观变体
 
-- 类型：`string`
+- 类型：`EditorVariant`
 - 默认值：`undefined`
-- 示例写法：`variant="示例"`
+- 示例写法：`variant="plain"`
 
 ### `children`
 
@@ -55,6 +55,16 @@ Svelte Snippet 子内容，用于自定义组件主体。
 - 默认值：`undefined`
 - 示例写法：`children={children}`
 
+## 相关类型定义
+
+以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
+
+### `EditorVariant`
+
+```ts
+export type EditorVariant = '' | 'plain' | 'outlined' | 'filled';
+```
+
 ## 示例
 
 完整示例见 [example.svelte](./example.svelte)。
@@ -64,7 +74,7 @@ Svelte Snippet 子内容，用于自定义组件主体。
 </script>
 
 <GridForm
-  variant="示例"
+  variant="plain"
 >
   <div>在这里放置子内容</div>
 </GridForm>

package/docs/components/grid-form/example.svelte

@@ -3,7 +3,7 @@
 </script>
 
 <GridForm
-  variant="示例"
+  variant="plain"
 >
   <div>在这里放置子内容</div>
 </GridForm>

package/docs/components/group-check-box/README.md

@@ -32,15 +32,15 @@ import GroupCheckBox from '@ticatec/uniface-element/GroupCheckBox';
 | `keyField` | 否 | `string` | 否 | `"code"` | 否 | 数据项中作为唯一值或选中值的字段名。 |
 | `textField` | 否 | `string` | 否 | `"text"` | 否 | 数据项中用于界面显示的文本字段名。 |
 | `delimiter` | 否 | `string` | 否 | `';'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `itemStyle` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `item$style` | 否 | `string` | 否 | `''` | 否 | 每个选项的内联样式 |
 | `disabledOptions` | 否 | `Array<string>` | 否 | `[]` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `hideOptions` | 否 | `Array<string>` | 否 | `[]` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `variant` | 是 | `EditorVariant` | 否 | `undefined` | 否 | 视觉样式变体，可选值：`""`(默认)、`plain`、`outlined`、`filled`；具体含义见组件说明。 |
 | `compact` | 否 | `boolean` | 否 | `false` | 否 | 启用紧凑尺寸，减少组件高度和内边距。 |
 | `class` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的 CSS class。 |
 | `onchange` | 是 | `(value: any) => void` | 否 | `undefined` | 否 | 用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。 |
-| `onblur` | 否 | `(e: FocusEvent) => void` | 否 | `undefined` | 否 | 组件失去焦点时调用。 |
-| `onfocus` | 否 | `(e: FocusEvent) => void` | 否 | `undefined` | 否 | 组件获得焦点时调用。 |
+| `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件失去焦点时调用。 |
+| `onfocus` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件获得焦点时调用。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 

package/docs/components/group-radio-box/README.md

@@ -30,14 +30,14 @@ import GroupRadioBox from '@ticatec/uniface-element/GroupRadioBox';
 | `options` | 是 | `Array<OptionItem>` | 是 | `—` | 否 | 可选项数据源；通常配合 `keyField` 与 `textField` 指定值字段和显示字段。 |
 | `keyField` | 否 | `string` | 否 | `"code"` | 否 | 数据项中作为唯一值或选中值的字段名。 |
 | `textField` | 否 | `string` | 否 | `"text"` | 否 | 数据项中用于界面显示的文本字段名。 |
-| `itemStyle` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `item$style` | 否 | `string` | 否 | `''` | 否 | 每个选项的内联样式 |
 | `disabledOptions` | 否 | `Array<string>` | 否 | `[]` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `variant` | 是 | `EditorVariant` | 否 | `undefined` | 否 | 视觉样式变体，可选值：`""`(默认)、`plain`、`outlined`、`filled`；具体含义见组件说明。 |
 | `compact` | 否 | `boolean` | 否 | `false` | 否 | 启用紧凑尺寸，减少组件高度和内边距。 |
 | `class` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的 CSS class。 |
 | `onchange` | 是 | `(value: any) => void` | 否 | `undefined` | 否 | 用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。 |
-| `onblur` | 否 | `(e: FocusEvent) => void` | 否 | `undefined` | 否 | 组件失去焦点时调用。 |
-| `onfocus` | 否 | `(e: FocusEvent) => void` | 否 | `undefined` | 否 | 组件获得焦点时调用。 |
+| `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件失去焦点时调用。 |
+| `onfocus` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 组件获得焦点时调用。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 

package/docs/components/icon/README.md

@@ -22,12 +22,13 @@ import Icon from '@ticatec/uniface-element/Icon';
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
 | `name` | 是 | `string` | 是 | `—` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `onclick` | 是 | `MouseClickHandler \| null` | 否 | `null` | 否 | 用户点击组件时调用，参数通常为 MouseEvent。 |
+| `onclick` | 是 | `OnClick \| null` | 否 | `null` | 否 | 用户点击组件时调用，参数通常为 MouseEvent。 |
 | `style` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的内联样式。 |
-| `theme` | 否 | `string` | 否 | `''` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
+| `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
 | `class` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的 CSS class。 |
 | `tooltip` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `disabled` | 是 | `boolean` | 否 | `false` | 否 | 禁用交互。禁用后通常不可聚焦、不可修改，也不会触发变更操作。 |
+| `tabindex` | 否 | `number` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 
@@ -45,7 +46,7 @@ import Icon from '@ticatec/uniface-element/Icon';
 
 用户点击组件时调用，参数通常为 MouseEvent。
 
-- 类型：`MouseClickHandler | null`
+- 类型：`OnClick | null`
 - 默认值：`null`
 - 示例写法：`onclick={async (...args: any[]) => { console.log('onclick', ...args); return true; }}`
 
@@ -61,10 +62,10 @@ import Icon from '@ticatec/uniface-element/Icon';
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
 
-### `MouseClickHandler`
+### `OnClick`
 
 ```ts
-export type MouseClickHandler = (event: MouseEvent) => void;
+export type OnClick = (event: MouseEvent) => void;
 ```
 
 ## 示例

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

@@ -24,13 +24,15 @@ import IconButton from '@ticatec/uniface-element/IconButton';
 | `type` | 否 | `ButtonType` | 否 | `'default'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `htmlType` | 否 | `'button' \| 'submit' \| 'reset'` | 否 | `'button'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `disabled` | 是 | `boolean` | 否 | `false` | 否 | 禁用交互。禁用后通常不可聚焦、不可修改，也不会触发变更操作。 |
-| `size` | 否 | `ButtonSize` | 否 | `'medium'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `size` | 否 | `Size` | 否 | `'medium'` | 否 | 尺寸档位 |
 | `style` | 否 | `string` | 否 | `undefined` | 否 | 附加到组件根元素的内联样式。 |
 | `icon` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `tooltip` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `onclick` | 是 | `(event: MouseEvent) => void` | 否 | `undefined` | 否 | 用户点击组件时调用，参数通常为 MouseEvent。 |
 | `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
 | `children` | 是 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
+| `tabindex` | 否 | `number` | 否 | `-1` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `outer` | 否 | `boolean` | 否 | `true` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 
@@ -70,6 +72,12 @@ Svelte Snippet 子内容，用于自定义组件主体。
 export type ButtonType = 'default' | 'primary' | 'secondary' | 'third' | 'forth';
 ```
 
+### `Size`
+
+```ts
+export type Size = 'small' | 'medium' | 'large';
+```
+
 ## 示例
 
 完整示例见 [example.svelte](./example.svelte)。
@@ -81,6 +89,7 @@ export type ButtonType = 'default' | 'primary' | 'secondary' | 'third' | 'forth'
 <IconButton
   onclick={async (...args: any[]) => { console.log('onclick', ...args); return true; }}
   disabled={false}
+  size="small"
 >
   <div>在这里放置子内容</div>
 </IconButton>

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

@@ -5,6 +5,7 @@
 <IconButton
   onclick={async (...args: any[]) => { console.log('onclick', ...args); return true; }}
   disabled={false}
+  size="small"
 >
   <div>在这里放置子内容</div>
 </IconButton>