@ticatec/uniface-element 5.0.5 → 5.1.1

package/docs/components/page-stack/README.md

@@ -0,0 +1,67 @@
+# PageStack
+
+导航组件。本文档由源码自动生成，类型以当前版本为准。
+
+## 简介
+
+以栈方式推入/弹出页面并支持返回结果的导航容器。
+
+## 适用场景
+
+- 向导流程、多级详情和移动端式页面跳转
+- 需要 push/pop 页面并等待子页面返回值
+
+## 导入
+
+```ts
+import PageStack from '@ticatec/uniface-element/PageStack';
+```
+
+## 属性
+
+| 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `style` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的内联样式。 |
+| `transitionDuration` | 否 | `number` | 否 | `260` | 否 | 每一帧 push/pop 的滑入滑出时长（ms）。仅在没有传 transitionParams 时生效；设为 0 关闭动画。 |
+| `transition` | 否 | `TransitionFn` | 否 | `fly` | 否 | 换成任意 svelte/transition 函数（fly/fade/scale/slide...）或自定义的过渡函数。 默认是从右侧滑入的 fly，效果同 transitionParams 未设置时的 {x:'100%', duration:transitionDuration, easing:cubicOut}。 |
+| `transitionParams` | 否 | `Record<string, any>` | 否 | `undefined` | 否 | 传给 transition 函数的参数；一旦提供，会完全替代基于 transitionDuration 生成的默认参数。 |
+| `children` | 是 | `Snippet` | 否 | `undefined` | 否 | 根页面（初始内容，depth = 0） |
+
+> 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
+
+## 重要属性说明
+
+### `children`
+
+根页面（初始内容，depth = 0）
+
+- 类型：`Snippet`
+- 默认值：`undefined`
+- 示例写法：`children={children}`
+
+## 组件实例方法
+
+通过 `bind:this` 获取组件实例后调用。
+
+| 方法 | 类型 | 说明 |
+| --- | --- | --- |
+| `push()` | `(component: any, props: Record<string, any> = {}) => Promise<R>` | push 一个组件进栈，覆盖显示在当前内容之上。返回的 Promise 在该页面调用 getPageStack().close(result) 时以 result resolve；也可以用 PageStack 实例的 pop(result) 从外部（比如 bottombar 的返回按钮）关闭当前栈顶。 |
+| `pop()` | `(result?: any) => void` | 关闭当前栈顶的一帧。栈为空时是 no-op。 |
+| `reset()` | `() => void` | 清空整个栈，直接回到根页面。不逐帧过渡，适合"注销/切换上下文"这类场景。 |
+
+## 示例
+
+完整示例见 [example.svelte](./example.svelte)。
+```svelte
+<script lang="ts">
+  import PageStack from '@ticatec/uniface-element/PageStack';
+</script>
+
+<PageStack>
+  <div>在这里放置子内容</div>
+</PageStack>
+```
+
+## 源码
+
+- `src/lib/navigation/page-stack/PageStack.svelte`

package/docs/components/page-stack/example.svelte

@@ -0,0 +1,7 @@
+<script lang="ts">
+  import PageStack from '@ticatec/uniface-element/PageStack';
+</script>
+
+<PageStack>
+  <div>在这里放置子内容</div>
+</PageStack>

package/docs/components/pagination/README.md

@@ -22,10 +22,10 @@ import Pagination from '@ticatec/uniface-element/Pagination';
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
 | `pageCount` | 是 | `number` | 是 | `0` | 否 | 总页数；为 0 时表示没有可分页数据。 |
-| `pageNo` | 是 | `number` | 否 | `1` | 否 | 当前页码，通常从 1 开始。 |
-| `type` | 否 | `'plain' \| 'round' \| 'circle'` | 否 | `"round"` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `pageNo` | 是 | `number` | 否 | `$bindable(1)` | 是 | 当前页码，通常从 1 开始。 |
+| `variant` | 是 | `'plain' \| 'round' \| 'circle'` | 否 | `"round"` | 否 | 形状：plain / round / circle |
 | `style` | 否 | `string` | 否 | `''` | 否 | 附加到组件根元素的内联样式。 |
-| `big` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `size` | 否 | `Size` | 否 | `'medium'` | 否 | 尺寸档位；'large' 对应旧的 big |
 | `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
 | `onchange` | 是 | `OnPageChange` | 否 | `undefined` | 否 | 用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。 |
 
@@ -46,8 +46,16 @@ import Pagination from '@ticatec/uniface-element/Pagination';
 当前页码，通常从 1 开始。
 
 - 类型：`number`
-- 默认值：`1`
-- 示例写法：`pageNo={1}`
+- 默认值：`$bindable(1)`
+- 推荐写法：`bind:pageNo`
+
+### `variant`
+
+形状：plain / round / circle
+
+- 类型：`'plain' | 'round' | 'circle'`
+- 默认值：`"round"`
+- 示例写法：`variant="plain"`
 
 ### `onchange`
 
@@ -61,6 +69,12 @@ import Pagination from '@ticatec/uniface-element/Pagination';
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
 
+### `Size`
+
+```ts
+export type Size = 'small' | 'medium' | 'large';
+```
+
 ### `OnPageChange`
 
 ```ts
@@ -73,14 +87,17 @@ export type OnPageChange = (pageNo: number) => void;
 ```svelte
 <script lang="ts">
   import Pagination from '@ticatec/uniface-element/Pagination';
+  let pageNo = $state<any>(1);
 </script>
 
 <Pagination
   pageCount={10}
+  bind:pageNo
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}
-  big={true}
-  pageNo={1}
+  variant="plain"
+  size="small"
 />
+<p>当前状态：{JSON.stringify({pageNo})}</p>
 ```
 
 ## 源码

package/docs/components/pagination/example.svelte

@@ -1,10 +1,13 @@
 <script lang="ts">
   import Pagination from '@ticatec/uniface-element/Pagination';
+  let pageNo = $state<any>(1);
 </script>
 
 <Pagination
   pageCount={10}
+  bind:pageNo
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}
-  big={true}
-  pageNo={1}
+  variant="plain"
+  size="small"
 />
+<p>当前状态：{JSON.stringify({pageNo})}</p>

package/docs/components/pagination-panel/README.md

@@ -22,15 +22,15 @@ import PaginationPanel from '@ticatec/uniface-element/PaginationPanel';
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
 | `pageCount` | 是 | `number` | 否 | `0` | 否 | 总页数；为 0 时表示没有可分页数据。 |
-| `pageNo` | 是 | `number` | 否 | `1` | 否 | 当前页码，通常从 1 开始。 |
-| `type` | 否 | `'plain' \| 'round' \| 'circle'` | 否 | `'round'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `pageNo` | 是 | `number` | 否 | `$bindable(1)` | 是 | 当前页码，通常从 1 开始。 |
+| `variant` | 是 | `'plain' \| 'round' \| 'circle'` | 否 | `'round'` | 否 | 形状：plain / round / circle |
 | `page$style` | 否 | `string` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `big` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `size` | 否 | `Size` | 否 | `'medium'` | 否 | 尺寸档位；'large' 对应旧的 big |
 | `rowsSet` | 否 | `Array<number>` | 否 | `[25, 50, 100]` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `total` | 否 | `number` | 否 | `0` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `generateInfo` | 否 | `GenerateTotalInfo` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `rowCount` | 是 | `number` | 否 | `$bindable(25)` | 是 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `rowCountLabel` | 否 | `string` | 否 | `'Rows/Page'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `rowCountText` | 否 | `string` | 否 | `i18nRes.dataTable.rowsPerPage()` | 否 | 每页行数选择框旁的文字 |
 | `align` | 否 | `'left' \| 'right' \| ''` | 否 | `''` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `onPageSizeChange` | 否 | `OnPageSizeChange` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
 | `onchange` | 是 | `OnPageChange` | 否 | `undefined` | 否 | 用户完成值变更时调用；编程式赋值是否触发请以组件行为说明为准。 |
@@ -52,8 +52,16 @@ import PaginationPanel from '@ticatec/uniface-element/PaginationPanel';
 当前页码，通常从 1 开始。
 
 - 类型：`number`
-- 默认值：`1`
-- 示例写法：`pageNo={1}`
+- 默认值：`$bindable(1)`
+- 推荐写法：`bind:pageNo`
+
+### `variant`
+
+形状：plain / round / circle
+
+- 类型：`'plain' | 'round' | 'circle'`
+- 默认值：`'round'`
+- 示例写法：`variant="plain"`
 
 ### `rowCount`
 
@@ -75,6 +83,12 @@ import PaginationPanel from '@ticatec/uniface-element/PaginationPanel';
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
 
+### `Size`
+
+```ts
+export type Size = 'small' | 'medium' | 'large';
+```
+
 ### `GenerateTotalInfo`
 
 ```ts
@@ -99,20 +113,21 @@ export type OnPageChange = (pageNo: number) => void;
 ```svelte
 <script lang="ts">
   import PaginationPanel from '@ticatec/uniface-element/PaginationPanel';
+  let pageNo = $state<any>(1);
   let rowCount = $state<any>(25);
 </script>
 
 <PaginationPanel
+  bind:pageNo
   bind:rowCount
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}
   onPageSizeChange={async (...args: any[]) => { console.log('onPageSizeChange', ...args); return true; }}
-  big={true}
+  variant="plain"
+  size="small"
   pageCount={10}
-  pageNo={1}
   rowsSet={[10, 25, 50]}
-  total={238}
 />
-<p>当前状态：{JSON.stringify({rowCount})}</p>
+<p>当前状态：{JSON.stringify({pageNo, rowCount})}</p>
 ```
 
 ## 源码

package/docs/components/pagination-panel/example.svelte

@@ -1,16 +1,17 @@
 <script lang="ts">
   import PaginationPanel from '@ticatec/uniface-element/PaginationPanel';
+  let pageNo = $state<any>(1);
   let rowCount = $state<any>(25);
 </script>
 
 <PaginationPanel
+  bind:pageNo
   bind:rowCount
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}
   onPageSizeChange={async (...args: any[]) => { console.log('onPageSizeChange', ...args); return true; }}
-  big={true}
+  variant="plain"
+  size="small"
   pageCount={10}
-  pageNo={1}
   rowsSet={[10, 25, 50]}
-  total={238}
 />
-<p>当前状态：{JSON.stringify({rowCount})}</p>
+<p>当前状态：{JSON.stringify({pageNo, rowCount})}</p>

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

@@ -0,0 +1,128 @@
+# PasswordEditor
+
+表单组件。本文档由源码自动生成，类型以当前版本为准。
+
+## 简介
+
+带显示/隐藏切换的密码输入编辑器。
+
+## 适用场景
+
+- 登录、注册和修改密码表单
+- 需要遮蔽输入内容并可临时查看的文本字段
+
+## 导入
+
+```ts
+import PasswordEditor from '@ticatec/uniface-element/PasswordEditor';
+```
+
+## 属性
+
+| 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `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` | 否 | `undefined` | 否 | 自定义内联样式，会应用到字段根容器上 |
+| `onfocus` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 字段获得焦点时触发的回调 |
+| `onblur` | 否 | `(event: FocusEvent) => void` | 否 | `undefined` | 否 | 字段失去焦点时触发的回调 |
+| `onchange` | 是 | `(value?: any) => void` | 否 | `undefined` | 否 | 字段值发生变化时触发的回调 |
+| `onkeydown` | 否 | `(event: KeyboardEvent) => void` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
+| `onkeyup` | 否 | `(event: KeyboardEvent) => void` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
+| `onkeypress` | 否 | `(event: KeyboardEvent) => void` | 否 | `undefined` | 否 | 事件或行为回调；参数与返回值以类型签名为准。 |
+| `value` | 是 | `string` | 否 | `$bindable()` | 是 | 组件的核心值。支持绑定时建议使用 `bind:value`，外部修改会同步到组件。 |
+| `input\$*` | 否 | `any` | 否 | `透传` | 否 | 匹配此前缀的属性会透传给内部元素。 |
+
+> 组件的“可绑定”表示源码使用了 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`
+
+字段值发生变化时触发的回调
+
+- 类型：`(value?: any) => void`
+- 默认值：`undefined`
+- 示例写法：`onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}`
+
+### `value`
+
+组件的核心值。支持绑定时建议使用 `bind:value`，外部修改会同步到组件。
+
+- 类型：`string`
+- 默认值：`$bindable()`
+- 推荐写法：`bind:value`
+
+## 相关类型定义
+
+以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
+
+### `EditorVariant`
+
+```ts
+export type EditorVariant = '' | 'plain' | 'outlined' | 'filled';
+```
+
+## 示例
+
+完整示例见 [example.svelte](./example.svelte)。
+```svelte
+<script lang="ts">
+  import PasswordEditor from '@ticatec/uniface-element/PasswordEditor';
+  let value = $state<any>("示例值");
+</script>
+
+<PasswordEditor
+  bind:value
+  onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}
+  onfocus={async (...args: any[]) => { console.log('onfocus', ...args); return true; }}
+  variant="plain"
+  placeholder="请输入或选择"
+  disabled={false}
+  readonly={false}
+  compact={true}
+/>
+<p>当前状态：{JSON.stringify({value})}</p>
+```
+
+## 源码
+
+- `src/lib/form/text_editor/PasswordEditor.svelte`

package/docs/components/{attachment-files → password-editor}/example.svelte

@@ -1,10 +1,10 @@
 <script lang="ts">
-  import AttachmentFiles from '@ticatec/uniface-element/AttachmentFiles';
-  let files = $state<any>([]);
+  import PasswordEditor from '@ticatec/uniface-element/PasswordEditor';
+  let value = $state<any>("示例值");
 </script>
 
-<AttachmentFiles
-  bind:files
+<PasswordEditor
+  bind:value
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}
   onfocus={async (...args: any[]) => { console.log('onfocus', ...args); return true; }}
   variant="plain"
@@ -13,4 +13,4 @@
   readonly={false}
   compact={true}
 />
-<p>当前状态：{JSON.stringify({files})}</p>
+<p>当前状态：{JSON.stringify({value})}</p>

package/docs/components/progress-bar/README.md

@@ -22,14 +22,24 @@ import ProgressBar from '@ticatec/uniface-element/ProgressBar';
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
 | `progress` | 否 | `number` | 否 | `0` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `size` | 否 | `number` | 否 | `100` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `type` | 否 | `ProgressBarType` | 否 | `"circular"` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `height` | 否 | `number` | 否 | `5` | 否 | 高度配置，数值单位为像素。 |
+| `diameter` | 否 | `number` | 否 | `100` | 否 | 圆形进度条直径（px） |
+| `variant` | 是 | `ProgressBarType` | 否 | `"circular"` | 否 | 形状：circular / linear |
+| `thickness` | 否 | `number` | 否 | `5` | 否 | 线形进度条高度（px） |
 | `showText` | 否 | `boolean` | 否 | `true` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `status` | 否 | `ProgressStatus` | 否 | `ProgressStatus.progressing` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 
 > 组件的“可绑定”表示源码使用了 Svelte 5 的 `$bindable`；服务的“响应式”表示成员使用了 `$state`。复杂类型请同时参考 TypeScript 自动补全。
 
+## 重要属性说明
+
+### `variant`
+
+形状：circular / linear
+
+- 类型：`ProgressBarType`
+- 默认值：`"circular"`
+- 示例写法：`variant="circular"`
+
 ## 相关类型定义
 
 以下定义帮助理解复杂属性的数据结构；其中部分辅助类型属于内部实现，不一定是独立导出入口。
@@ -54,7 +64,7 @@ export enum ProgressStatus {
 </script>
 
 <ProgressBar
-  height={48}
+  variant="circular"
   progress={65}
 />
 ```

package/docs/components/progress-bar/example.svelte

@@ -3,6 +3,6 @@
 </script>
 
 <ProgressBar
-  height={48}
+  variant="circular"
   progress={65}
 />

package/docs/components/progress-step-bar/README.md

@@ -21,7 +21,7 @@ import ProgressStepBar from '@ticatec/uniface-element/ProgressStepBar';
 
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
-| `steps` | 是 | `Array<ProgressStep>` | 是 | `—` | 否 | 流程步骤数据集合；每一步通常包含标题和当前状态（待处理/进行中/已完成）。 |
+| `items` | 是 | `Array<ProgressStep>` | 否 | `[]` | 否 | 步骤列表 |
 | `direction` | 否 | `'vertical' \| 'horizontal'` | 否 | `'horizontal'` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `style` | 否 | `string` | 否 | `undefined` | 否 | 附加到组件根元素的内联样式。 |
 | `theme` | 否 | `string` | 否 | `undefined` | 否 | 组件主题标识，通常通过 `data-theme` 选择对应 CSS 变量。 |
@@ -30,13 +30,17 @@ import ProgressStepBar from '@ticatec/uniface-element/ProgressStepBar';
 
 ## 重要属性说明
 
-### `steps`
+### `items`
 
-流程步骤数据集合；每一步通常包含标题和当前状态（待处理/进行中/已完成）。
+步骤列表
 
 - 类型：`Array<ProgressStep>`
-- 默认值：`—`
-- 示例写法：`steps={[]}`
+- 默认值：`[]`
+- 示例写法：`items={[
+    {title: '提交', status: 'completed' as any},
+    {title: '审核', status: 'processing' as any},
+    {title: '完成', status: 'pending' as any}
+  ]}`
 
 ## 相关类型定义
 
@@ -50,7 +54,8 @@ export default interface ProgressStep {
     /**
      *
      */
-    topic: string;
+    /** 步骤标题 */
+    title: string;
 
     /**
      *
@@ -84,7 +89,11 @@ export enum ProgressStepStatus {
 </script>
 
 <ProgressStepBar
-  steps={[]}
+  items={[
+    {title: '提交', status: 'completed' as any},
+    {title: '审核', status: 'processing' as any},
+    {title: '完成', status: 'pending' as any}
+  ]}
 />
 ```
 

package/docs/components/progress-step-bar/example.svelte

@@ -3,5 +3,9 @@
 </script>
 
 <ProgressStepBar
-  steps={[]}
+  items={[
+    {title: '提交', status: 'completed' as any},
+    {title: '审核', status: 'processing' as any},
+    {title: '完成', status: 'pending' as any}
+  ]}
 />

package/docs/components/prompts-text-editor/README.md

@@ -36,7 +36,7 @@ import PromptsTextEditor from '@ticatec/uniface-element/PromptsTextEditor';
 | `value` | 是 | `string` | 否 | `$bindable()` | 是 | 组件的核心值。支持绑定时建议使用 `bind:value`，外部修改会同步到组件。 |
 | `prefix` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `suffix` | 否 | `string` | 否 | `undefined` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `words` | 是 | `Array<string>` | 是 | `—` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `options` | 是 | `Array<string>` | 否 | `[]` | 否 | 候选提示词列表 |
 | `menu$height` | 否 | `number` | 否 | `0` | 否 | 高度配置，数值单位为像素。 |
 | `input\$*` | 否 | `any` | 否 | `透传` | 否 | 匹配此前缀的属性会透传给内部元素。 |
 
@@ -92,13 +92,16 @@ import PromptsTextEditor from '@ticatec/uniface-element/PromptsTextEditor';
 - 默认值：`$bindable()`
 - 推荐写法：`bind:value`
 
-### `words`
+### `options`
 
-可选配置，具体取值范围和数据结构见类型列。
+候选提示词列表
 
 - 类型：`Array<string>`
-- 默认值：`—`
-- 示例写法：`words={[]}`
+- 默认值：`[]`
+- 示例写法：`options={[
+    {code: 'dev', text: '研发部'},
+    {code: 'product', text: '产品部'}
+  ]}`
 
 ## 组件实例方法
 
@@ -128,7 +131,6 @@ export type EditorVariant = '' | 'plain' | 'outlined' | 'filled';
 </script>
 
 <PromptsTextEditor
-  words={[]}
   bind:value
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}
   onfocus={async (...args: any[]) => { console.log('onfocus', ...args); return true; }}

package/docs/components/prompts-text-editor/example.svelte

@@ -4,7 +4,6 @@
 </script>
 
 <PromptsTextEditor
-  words={[]}
   bind:value
   onchange={async (...args: any[]) => { console.log('onchange', ...args); return true; }}
   onfocus={async (...args: any[]) => { console.log('onfocus', ...args); return true; }}

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

@@ -25,10 +25,10 @@ import RowsLayout from '@ticatec/uniface-element/app-layout/RowsLayout';
 | `height` | 否 | `string` | 否 | `'100%'` | 否 | 高度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
 | `topHeight` | 否 | `string \| null` | 否 | `null` | 否 | 高度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
 | `bottomHeight` | 否 | `string \| null` | 否 | `null` | 否 | 高度配置；字符串可以使用 px、rem、% 等 CSS 单位。 |
-| `topMin` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `topMax` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `bottomMin` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `bottomMax` | 否 | `string \| null` | 否 | `null` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `topMinHeight` | 否 | `string \| null` | 否 | `null` | 否 | 上栏最小高度（CSS 长度） |
+| `topMaxHeight` | 否 | `string \| null` | 否 | `null` | 否 | 上栏最大高度（CSS 长度） |
+| `bottomMinHeight` | 否 | `string \| null` | 否 | `null` | 否 | 下栏最小高度（CSS 长度） |
+| `bottomMaxHeight` | 否 | `string \| null` | 否 | `null` | 否 | 下栏最大高度（CSS 长度） |
 | `topResize` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `bottomResize` | 否 | `boolean` | 否 | `false` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
 | `top` | 否 | `Snippet` | 否 | `undefined` | 否 | Svelte Snippet 渲染入口，用于替换或补充默认内容。 |
@@ -60,6 +60,10 @@ Svelte Snippet 子内容，用于自定义组件主体。
   height="48px"
   topHeight="48px"
   bottomHeight="48px"
+  topMinHeight="48px"
+  topMaxHeight="48px"
+  bottomMinHeight="48px"
+  bottomMaxHeight="48px"
 >
   <div>在这里放置子内容</div>
 </RowsLayout>

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

@@ -7,6 +7,10 @@
   height="48px"
   topHeight="48px"
   bottomHeight="48px"
+  topMinHeight="48px"
+  topMaxHeight="48px"
+  bottomMinHeight="48px"
+  bottomMaxHeight="48px"
 >
   <div>在这里放置子内容</div>
 </RowsLayout>

package/docs/components/switch/README.md

@@ -21,8 +21,8 @@ import Switch from '@ticatec/uniface-element/Switch';
 
 | 属性 | 重要 | 类型 | 必填 | 默认值 | 可绑定/响应式 | 说明 |
 | --- | --- | --- | --- | --- | --- | --- |
-| `checkLabel` | 否 | `string` | 否 | `"On"` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
-| `uncheckLabel` | 否 | `string` | 否 | `"Off"` | 否 | 可选配置，具体取值范围和数据结构见类型列。 |
+| `checkedText` | 否 | `string` | 否 | `"On"` | 否 | 开启状态显示的文字 |
+| `uncheckedText` | 否 | `string` | 否 | `"Off"` | 否 | 关闭状态显示的文字 |
 | `readonly` | 是 | `boolean` | 否 | `false` | 否 | 只读状态。保留内容展示，但阻止用户修改。 |
 | `disabled` | 是 | `boolean` | 否 | `false` | 否 | 禁用交互。禁用后通常不可聚焦、不可修改，也不会触发变更操作。 |
 | `value` | 是 | `boolean` | 否 | `$bindable(false)` | 是 | 组件的核心值。支持绑定时建议使用 `bind:value`，外部修改会同步到组件。 |