@ticatec/uniface-element 5.0.5 → 5.1.1

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

@@ -0,0 +1,224 @@
+# AttachmentEditor
+
+表单组件。本文档由源码自动生成，类型以当前版本为准。
+
+## 简介
+
+附件上传字段：整个内容区可拖入文件，list / icon 两种排列，内联显示上传进度并可取消、重试。
+
+## 适用场景
+
+- 合同、工单和审批附件
+- 需要限制文件数量、大小或类型的上传
+
+## 导入
+
+```ts
+import AttachmentEditor from '@ticatec/uniface-element/AttachmentEditor';
+```
+
+## 属性
+
+| 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `theme` | 否 | `string` | 否 | `undefined` | 否 | 主题样式名称，用于切换组件外观主题 |
+| `tooltip` | 否 | `string` | 否 | `undefined` | 否 | 悬停提示信息，鼠标悬浮在字段上时显示 |
+| `error` | 否 | `string` | 否 | `undefined` | 否 | 错误信息，用于在字段下方展示校验错误提示 |
+| `disabled` | 是 | `boolean` | 否 | `false` | 否 | 是否禁用该字段，禁用后字段不可编辑且不响应交互 |
+| `readonly` | 是 | `boolean` | 否 | `false` | 否 | 是否只读，只读状态下字段不可编辑但可聚焦和复制 |
+| `compact` | 否 | `boolean` | 否 | `false` | 否 | 是否启用紧凑模式，紧凑模式下字段内部间距更小 |
+| `variant` | 是 | `EditorVariant` | 否 | `undefined` | 否 | 编辑器外观样式变体 |
+| `placeholder` | 是 | `string` | 否 | `undefined` | 否 | 占位提示文本，字段值为空时在输入区域内展示 |
+| `style` | 否 | `string` | 否 | `''` | 否 | 自定义内联样式，会应用到字段根容器上 |
+| `onfocus` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 字段获得焦点时触发的回调 |
+| `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 字段失去焦点时触发的回调 |
+| `onchange` | 是 | `(files: T[]) => void` | 否 | `undefined` | 否 | files 变化后通知（上传完成或删除） |
+| `files` | 是 | `T[]` | 否 | `$bindable<T[]>([])` | 是 | 已上传的附件列表（可绑定） |
+| `layout` | 否 | `AttachmentLayout` | 否 | `'list'` | 否 | 排列方式：list（每行一个）/ icon（图标瓦片，自动换行） |
+| `height` | 否 | `number \| string` | 否 | `undefined` | 否 | 内容区高度；超出后内部滚动，不设则随内容自适应 |
+| `uploadFile` | 否 | `FileUpload` | 否 | `undefined` | 否 | 实际执行上传的函数；不传则组件只读展示（不显示上传入口） |
+| `accept` | 否 | `string` | 否 | `"*/*"` | 否 | 允许的文件类型（同 input accept） |
+| `maxSize` | 否 | `number` | 否 | `1024 * 1024 * 10` | 否 | 单个文件大小上限（字节） |
+| `maxFiles` | 否 | `number` | 否 | `10` | 否 | 文件数量上限（含上传中的） |
+| `multiple` | 否 | `boolean` | 否 | `true` | 否 | 一次是否允许选择 / 拖入多个文件 |
+| `uploadText` | 否 | `string` | 否 | `i18nRes.upload.dropHint()` | 否 | 上传入口的文字（空态时作为拖放区提示） |
+| `emptyText` | 否 | `string` | 否 | `i18nRes.upload.emptyText()` | 否 | 没有文件且不能上传时显示的文字 |
+| `showThumbnail` | 否 | `boolean` | 否 | `false` | 否 | 图片文件显示缩略图（已上传的用 thumbnail ?? uri，上传中的用本地预览）；ImageEditor 默认开启 |
+| `onPreview` | 否 | `(file: T) => void` | 否 | `undefined` | 否 | 预览：有则每个文件显示预览按钮 |
+| `beforeRemove` | 是 | `BeforeRemove<T>` | 否 | `undefined` | 否 | 删除附件前的否决钩子：返回 false 取消删除 |
+| `onremove` | 是 | `(file: T) => void` | 否 | `undefined` | 否 | 附件被删除后通知 |
+| `ondownload` | 否 | `(file: T) => void` | 否 | `undefined` | 否 | 自定义下载；不传则通过 `file.uri` 直接下载 |
+| `onFileUploaded` | 否 | `(file: T, source: File) => void` | 否 | `undefined` | 否 | 单个文件上传完成并加入 files 后通知 |
+| `onFileRejected` | 否 | `(file: File, reason: RejectReason) => void` | 否 | `undefined` | 否 | 文件因类型 / 大小 / 数量限制被拒绝时通知 |
+| `onUploadError` | 否 | `(file: File, error: Error) => void` | 否 | `undefined` | 否 | 上传失败时通知（任务保留在列表中，可重试或移除） |
+
+> 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
+
+## 重要属性说明
+
+### `disabled`
+
+是否禁用该字段，禁用后字段不可编辑且不响应交互
+
+- 类型：`boolean`
+- 默认值：`false`
+- 示例写法：`disabled={false}`
+
+### `readonly`
+
+是否只读，只读状态下字段不可编辑但可聚焦和复制
+
+- 类型：`boolean`
+- 默认值：`false`
+- 示例写法：`readonly={false}`
+
+### `variant`
+
+编辑器外观样式变体
+
+- 类型：`EditorVariant`
+- 默认值：`undefined`
+- 示例写法：`variant="plain"`
+
+### `placeholder`
+
+占位提示文本，字段值为空时在输入区域内展示
+
+- 类型：`string`
+- 默认值：`undefined`
+- 示例写法：`placeholder="请输入或选择"`
+
+### `onchange`
+
+files 变化后通知（上传完成或删除）
+
+- 类型：`(files: T[]) => void`
+- 默认值：`undefined`
+- 示例写法：`onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}`
+
+### `files`
+
+已上传的附件列表（可绑定）
+
+- 类型：`T[]`
+- 默认值：`$bindable<T[]>([])`
+- 推荐写法：`bind:files`
+
+### `beforeRemove`
+
+删除附件前的否决钩子：返回 false 取消删除
+
+- 类型：`BeforeRemove<T>`
+- 默认值：`undefined`
+- 示例写法：参见下方完整示例中的类型化实现。
+
+### `onremove`
+
+附件被删除后通知
+
+- 类型：`(file: T) => void`
+- 默认值：`undefined`
+- 示例写法：`onremove={async (...args: any[]) => { console.log('onremove', ...args); return true; }}`
+
+## 组件实例方法
+
+通过 `bind:this` 获取组件实例后调用。
+
+| 方法 | 类型 | 说明 |
+| --- | --- | --- |
+| `openFileDialog()` | `() => void` | 打开系统文件选择框（等同于点击上传入口） |
+| `focus()` | `() => void` | 组件实例方法。 |
+
+## 相关类型定义
+
+以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
+
+### `EditorVariant`
+
+```ts
+export type EditorVariant = '' | 'plain' | 'outlined' | 'filled';
+```
+
+### `AttachmentLayout`
+
+```ts
+export type AttachmentLayout = 'list' | 'icon';
+```
+
+### `FileUpload`
+
+```ts
+export type FileUpload = (file: File, progressUpdate: ProgressUpdate, onUploaded: OnUploaded, errorHandler: OnError) => UploadProgress;
+```
+
+### `BeforeRemove`
+
+```ts
+export type BeforeRemove<T = any> = (file: T) => boolean | void | Promise<boolean | void>;
+```
+
+### `RejectReason`
+
+```ts
+export type RejectReason = 'accept' | 'size' | 'count';
+```
+
+### `ProgressUpdate`
+
+```ts
+export type ProgressUpdate = (uploadBytes: number) => void;
+```
+
+### `OnUploaded`
+
+```ts
+export type OnUploaded = (url: string, thumbnail?: string) => void;
+```
+
+### `OnError`
+
+```ts
+export type OnError = (e: Error) => void;
+```
+
+### `UploadProgress`
+
+```ts
+export interface UploadProgress {
+
+    cancel:()=>Promise<boolean>;
+
+}
+```
+
+## 示例
+
+完整示例见 [example.svelte](./example.svelte)。
+```svelte
+<script lang="ts">
+  import AttachmentEditor, {type AttachmentFile, type FileUpload} from '@ticatec/uniface-element/AttachmentEditor';
+
+  let files = $state<AttachmentFile[]>([]);
+  const uploadFile: FileUpload = (file, progress, uploaded) => {
+    progress(file.size);
+    uploaded(URL.createObjectURL(file));
+    return {cancel: async () => true};
+  };
+</script>
+
+<AttachmentEditor
+  bind:files
+  {uploadFile}
+  layout="icon"
+  height={160}
+  maxFiles={5}
+  variant="outlined"
+  beforeRemove={async (file) => confirm(`确定删除 ${file.name}？`)}
+  onFileRejected={(file, reason) => console.log('拒绝', file.name, reason)}
+/>
+<p>已上传 {files.length} 个附件</p>
+```
+
+## 源码
+
+- `src/lib/form/attachment_files/AttachmentEditor.svelte`

package/docs/components/attachment-editor/example.svelte

@@ -0,0 +1,22 @@
+<script lang="ts">
+  import AttachmentEditor, {type AttachmentFile, type FileUpload} from '@ticatec/uniface-element/AttachmentEditor';
+
+  let files = $state<AttachmentFile[]>([]);
+  const uploadFile: FileUpload = (file, progress, uploaded) => {
+    progress(file.size);
+    uploaded(URL.createObjectURL(file));
+    return {cancel: async () => true};
+  };
+</script>
+
+<AttachmentEditor
+  bind:files
+  {uploadFile}
+  layout="icon"
+  height={160}
+  maxFiles={5}
+  variant="outlined"
+  beforeRemove={async (file) => confirm(`确定删除 ${file.name}？`)}
+  onFileRejected={(file, reason) => console.log('拒绝', file.name, reason)}
+/>
+<p>已上传 {files.length} 个附件</p>

package/docs/components/box/README.md

@@ -24,7 +24,7 @@ import Box from '@ticatec/uniface-element/Box';
 | `title` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `round` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `style` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的内联样式。 |
-| `contentStyle` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `content$style` | 否 | `string` | 否 | `''` | 否 | 内容区内联样式 |
 | `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
 | `children` | 是 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
 | `header` | 否 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 渲染入口，用于替换或补充默认内容。 |

package/docs/components/button/README.md

@@ -27,7 +27,7 @@ import Button from '@ticatec/uniface-element/Button';
 | `variant` | 是 | `'plain' \| 'round' \| ''` | 否 | `''` | 否 | 视觉样式变体，可选值：`plain`、`round`、`""`(默认)；具体含义见组件说明。 |
 | `disabled` | 是 | `boolean` | 否 | `false` | 否 | 禁用交互。禁用后通常不可聚焦、不可修改，也不会触发变更操作。 |
 | `style` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的内联样式。 |
-| `size` | 否 | `'big' \| 'medium' \| 'small'` | 否 | `'medium'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `size` | 否 | `Size` | 否 | `'medium'` | 否 | 尺寸档位 |
 | `onclick` | 是 | `(event: MouseEvent) => void` | 否 | `undefined` | 否 | 用户点击组件时调用，参数通常为 MouseEvent。 |
 | `autofocus` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `icon` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
@@ -82,6 +82,12 @@ Svelte Snippet 子内容，用于自定义组件主体。
 export type ButtonType = 'default' | 'primary' | 'secondary' | 'third' | 'forth';
 ```
 
+### `Size`
+
+```ts
+export type Size = 'small' | 'medium' | 'large';
+```
+
 ## 示例
 
 完整示例见 [example.svelte](./example.svelte)。
@@ -95,6 +101,7 @@ export type ButtonType = 'default' | 'primary' | 'secondary' | 'third' | 'forth'
   label="示例标签"
   variant="plain"
   disabled={false}
+  size="small"
 />
 ```
 

package/docs/components/button/example.svelte

@@ -7,4 +7,5 @@
   label="示例标签"
   variant="plain"
   disabled={false}
+  size="small"
 />

package/docs/components/card/README.md

@@ -26,9 +26,12 @@ import Card from '@ticatec/uniface-element/Card';
 | `actions` | 否 | `Array<CardAction>` | 否 | `[]` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `variant` | 是 | `'plain' \| '3d'` | 否 | `'plain'` | 否 | 视觉样式变体，可选值：`plain`、`3d`；具体含义见组件说明。 |
 | `data` | 否 | `any` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `headerBar` | 否 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 渲染入口，用于替换或补充默认内容。 |
+| `header` | 否 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 渲染入口，用于替换或补充默认内容。 |
 | `children` | 是 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
-| `theme` | 否 | `string` | 否 | `""` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
+| `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
+| `actions$align` | 否 | `CardActionsAlign` | 否 | `'distribute'` | 否 | 操作栏图标排布方式，默认 'distribute'（按数量平分宽度、每个居中，不会被拉到两端） */ /** 动作栏对齐方式 |
+| `actionsGap` | 否 | `string` | 否 | `undefined` | 否 | 'center'/'left'/'right' 模式下相邻图标的固定间距，例如 '16px' |
+| `content$style` | 否 | `string` | 否 | `''` | 否 | 内容区内联样式 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 
@@ -59,6 +62,11 @@ Svelte Snippet 子内容，用于自定义组件主体。
 ```ts
 export default interface CardAction {
 
+    /**
+     * 显示文字（图标动作可省略，用 tooltip 说明）
+     */
+    label?: string;
+
     /**
      * 使用icon字体
      */
@@ -82,14 +90,20 @@ export default interface CardAction {
     /**
      *
      */
-    callback: ActionCallback;
+    handler: ActionHandler;
 }
 ```
 
-### `ActionCallback`
+### `CardActionsAlign`
+
+```ts
+export type CardActionsAlign = 'distribute' | 'center' | 'left' | 'right';
+```
+
+### `ActionHandler`
 
 ```ts
-export type ActionCallback = () => void;
+export type ActionHandler<T = any> = (data: T) => void | Promise<void>;
 ```
 
 ## 示例

package/docs/components/cascade-options-select/README.md

@@ -33,7 +33,7 @@ import CascadeOptionsSelect from '@ticatec/uniface-element/CascadeOptionsSelect'
 | `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` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
@@ -44,10 +44,10 @@ import CascadeOptionsSelect from '@ticatec/uniface-element/CascadeOptionsSelect'
 | `abbrField` | 否 | `string` | 否 | `"abbr"` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `childrenField` | 否 | `string` | 否 | `"children"` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `emptyText` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `checkLeaf` | 否 | `IsLeafDetermine \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `checkLeaf` | 否 | `IsLeaf \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `menu$height` | 否 | `number` | 否 | `150` | 否 | 高度配置，数值单位为像素。 |
 | `box$style` | 否 | `string` | 否 | `""` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `onSelect` | 否 | `OnSelectOption` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
+| `loadChildren` | 否 | `LoadChildren` | 否 | `undefined` | 否 | 按需加载叶节点的子级选项；返回空数组表示确实是叶子 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 
@@ -127,10 +127,16 @@ import CascadeOptionsSelect from '@ticatec/uniface-element/CascadeOptionsSelect'
 export type EditorVariant = '' | 'plain' | 'outlined' | 'filled';
 ```
 
-### `IsLeafDetermine`
+### `IsLeaf`
 
 ```ts
-export type IsLeafDetermine = (item: any) => boolean;
+export type IsLeaf = (item: any) => boolean;
+```
+
+### `LoadChildren`
+
+```ts
+export type LoadChildren = (item: IHierarchyData<any>) => Promise<Array<any>>;
 ```
 
 ## 示例

package/docs/components/columns-layout/README.md

@@ -25,10 +25,10 @@ import ColumnsLayout from '@ticatec/uniface-element/app-layout/ColumnsLayout';
 | `height` | 否 | `string` | 否 | `'100%'` | 否 | 高度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
 | `leftWidth` | 否 | `string \| null` | 否 | `null` | 否 | 宽度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
 | `rightWidth` | 否 | `string \| null` | 否 | `null` | 否 | 宽度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
-| `leftMin` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `leftMax` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `rightMin` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `rightMax` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `leftMinWidth` | 否 | `string \| null` | 否 | `null` | 否 | 左栏最小宽度（CSS 长度） |
+| `leftMaxWidth` | 否 | `string \| null` | 否 | `null` | 否 | 左栏最大宽度（CSS 长度） |
+| `rightMinWidth` | 否 | `string \| null` | 否 | `null` | 否 | 右栏最小宽度（CSS 长度） |
+| `rightMaxWidth` | 否 | `string \| null` | 否 | `null` | 否 | 右栏最大宽度（CSS 长度） |
 | `leftResize` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `rightResize` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `left` | 否 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 渲染入口，用于替换或补充默认内容。 |
@@ -60,6 +60,10 @@ Svelte Snippet 子内容，用于自定义组件主体。
   height="48px"
   leftWidth="240px"
   rightWidth="240px"
+  leftMinWidth="240px"
+  leftMaxWidth="240px"
+  rightMinWidth="240px"
+  rightMaxWidth="240px"
 >
   <div>在这里放置子内容</div>
 </ColumnsLayout>

package/docs/components/columns-layout/example.svelte

@@ -7,6 +7,10 @@
   height="48px"
   leftWidth="240px"
   rightWidth="240px"
+  leftMinWidth="240px"
+  leftMaxWidth="240px"
+  rightMinWidth="240px"
+  rightMaxWidth="240px"
 >
   <div>在这里放置子内容</div>
 </ColumnsLayout>

package/docs/components/common-dialog/README.md

@@ -24,12 +24,12 @@ import CommonDialog from '@ticatec/uniface-element/CommonDialog';
 | `title` | 是 | `string` | 是 | `—` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `width` | 否 | `string` | 否 | `'unset'` | 否 | 宽度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
 | `height` | 否 | `string` | 否 | `'unset'` | 否 | 高度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
-| `closeConfirm` | 否 | `DialogCloseConfirm \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `beforeClose` | 是 | `BeforeClose \| null` | 否 | `null` | 否 | 关闭前的否决钩子：结果为 MR_CANCEL / MR_CLOSE 时调用，返回 false 阻止关闭 |
 | `content$style` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `enableConfirm` | 否 | `boolean` | 否 | `true` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `confirmHandler` | 否 | `(() => Promise<any>) \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `confirmable` | 否 | `boolean` | 否 | `true` | 否 | 确认按钮是否可用 |
+| `onconfirm` | 否 | `(() => Promise<any>) \| null` | 否 | `null` | 否 | 点击确认时调用；返回 truthy 值则以 MR_OK 关闭 |
 | `confirmText` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `onClose` | 是 | `OnClose \| null` | 否 | `null` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
+| `onclose` | 是 | `OnClose \| null` | 否 | `null` | 否 | 关闭后的通知回调，参数为 ModalResult |
 | `children` | 是 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 子内容，用于自定义组件主体。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
@@ -44,13 +44,21 @@ import CommonDialog from '@ticatec/uniface-element/CommonDialog';
 - 默认值：`—`
 - 示例写法：`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`
 
@@ -64,10 +72,10 @@ Svelte Snippet 子内容，用于自定义组件主体。
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
 
-### `DialogCloseConfirm`
+### `BeforeClose`
 
 ```ts
-export type DialogCloseConfirm = () => Promise<boolean>;
+export type BeforeClose = () => boolean | void | Promise<boolean | void>;
 ```
 
 ### `OnClose`
@@ -96,7 +104,8 @@ export enum ModalResult {
 
 <CommonDialog
   title="示例标题"
-  onClose={async (...args: any[]) => { console.log('onClose', ...args); return true; }}
+  onconfirm={async (...args: any[]) => { console.log('onconfirm', ...args); return true; }}
+  onclose={async (...args: any[]) => { console.log('onclose', ...args); return true; }}
   width="240px"
   height="48px"
 >

package/docs/components/common-dialog/example.svelte

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

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

@@ -25,7 +25,7 @@ import ConciseDataTable from '@ticatec/uniface-element/ConciseDataTable';
 | `columns` | 是 | `Array<Column>` | 是 | `—` | 否 | 表格列定义，控制字段、标题、宽度、格式化、链接和自定义渲染。 |
 | `autoScroll` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `scrollInterval` | 否 | `number` | 否 | `2000` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `rowClickHandler` | 否 | `RowClickHandler \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `onRowClick` | 否 | `OnRowClick \| null` | 否 | `null` | 否 | 行点击回调 |
 | `options` | 是 | `TableOptions` | 否 | `{}` | 否 | 可选项数据源；通常配合 `keyField` 与 `textField` 指定值字段和显示字段。 |
 | `style` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的内联样式。 |
 | `class` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的 CSS class。 |
@@ -72,7 +72,7 @@ import ConciseDataTable from '@ticatec/uniface-element/ConciseDataTable';
 
 | 方法 | 类型 | 说明 |
 | --- | --- | --- |
-| `setFocus()` | `() => void` | 组件实例方法。 |
+| `focus()` | `() => void` | 组件实例方法。 |
 
 ## 相关类型定义
 
@@ -100,19 +100,13 @@ export default interface Column {
     // DataColumn#renderHTML in the data_table component.
     renderHTML?: boolean;
 
-    /**
-     * @deprecated Use renderHTML instead; "escapeHTML" reads as "this escapes HTML"
-     * when it actually means the opposite — true renders raw, trusted HTML. Still
-     * honored as a fallback for existing callers.
-     */
-    escapeHTML?: boolean;
 }
 ```
 
-### `RowClickHandler`
+### `OnRowClick`
 
 ```ts
-export type RowClickHandler = (row:any) => void;
+export type OnRowClick = (row:any) => void;
 ```
 
 ### `TableOptions`
@@ -144,9 +138,9 @@ export interface TableOptions {
 export default interface DataColumn {
 
     /**
-     * 列头文字
+     * 列头文字（与 ConciseListTable 的 Column.title 统一）
      */
-    text: string;
+    title: string;
 
     /**
      * 对应的字段/属性名
@@ -173,12 +167,12 @@ export default interface DataColumn {
     /**
      * 是否可以换行，默认为false
      */
-    warp?: boolean;
+    wrap?: boolean;
 
     /**
      * 单元格转换函数
      */
-    formatter?: FormatCell;
+    formatter?: FormatCellFn;
 
     /**
      * 是否将单元格内容作为可信 HTML 渲染（{@html}），而非纯文本转义。
@@ -186,11 +180,6 @@ export default interface DataColumn {
      */
     renderHTML?: boolean;
 
-    /**
-     * @deprecated 请使用 renderHTML；名称容易被误读为"转义 HTML"，
-     * 实际含义相反——设为 true 会把内容作为可信 HTML 渲染。仍受支持以兼容旧调用。
-     */
-    escapeHTML?: boolean;
 
     /**
      * 超链接设置
@@ -220,7 +209,7 @@ export default interface DataColumn {
     /**
      *
      */
-    compareFunction?: CompareFunction;
+    compareFunction?: CompareFn;
 
     /**
      * 获取表格的样式
@@ -229,10 +218,10 @@ export default interface DataColumn {
 }
 ```
 
-### `FormatCell`
+### `FormatCellFn`
 
 ```ts
-export type FormatCell = (value: any) => string;
+export type FormatCellFn = (value: any) => string;
 ```
 
 ### `HrefBuilder`
@@ -247,10 +236,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`
@@ -266,18 +255,18 @@ export default interface HrefLink {
     /**
      * 显示超链接的文字
      */
-    text: string;
+    label: string;
     /**
      * 点击的处理函数
      */
-    action: HrefAction;
+    handler: OnHrefClick;
 }
 ```
 
-### `HrefAction`
+### `OnHrefClick`
 
 ```ts
-export type HrefAction = () => void;
+export type OnHrefClick = () => void;
 ```
 
 ## 示例
@@ -297,8 +286,8 @@ export type HrefAction = () => void;
     {field: 'name', title: '姓名', width: 160},
     {field: 'department', title: '部门', width: 180}
   ]}
+  onRowClick={async (...args: any[]) => { console.log('onRowClick', ...args); return true; }}
   onfocus={async (...args: any[]) => { console.log('onfocus', ...args); return true; }}
-  onblur={async (...args: any[]) => { console.log('onblur', ...args); return true; }}
 />
 ```
 

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

@@ -11,6 +11,6 @@
     {field: 'name', title: '姓名', width: 160},
     {field: 'department', title: '部门', width: 180}
   ]}
+  onRowClick={async (...args: any[]) => { console.log('onRowClick', ...args); return true; }}
   onfocus={async (...args: any[]) => { console.log('onfocus', ...args); return true; }}
-  onblur={async (...args: any[]) => { console.log('onblur', ...args); return true; }}
 />