@ticatec/uniface-element 5.0.4 → 5.1.0

package/dist/form/options_select/OptionsSelect.svelte

@@ -12,7 +12,8 @@
         keyField?: string;
         textField?: string;
         menu$height?: number;
-        disableOptions?: Array<string>;
+        /** 要渲染但禁用的选项 key 列表 */
+        disabledOptions?: Array<string>;
         hideOptions?: Array<string>;
         itemRender?: any;
         filterPlaceholder?: string;
@@ -24,7 +25,7 @@
         variant,
         disabled = false,
         readonly = false,
-        mandatory = false,
+        clearable,
         compact = false,
         error,
         tooltip,
@@ -37,18 +38,19 @@
         textField = "text",
         emptyText,
         menu$height = 0,
-        disableOptions = [],
+        disabledOptions = [],
         hideOptions = [],
         onchange,
         onfocus,
         onblur,
-        filterPlaceholder = i18nRes.common.filterPlaceholder.toString(),
+        filterPlaceholder = i18nRes.common.filterPlaceholder(),
         filterFunction,
-        noResultsText = i18nRes.common.noResultsText.toString(),
+        noResultsText = i18nRes.common.noResultsText(),
         itemRender,
     }: Props = $props();
 
 
+
     let searchBox: SearchBox | undefined = $state(undefined);
     let editor: HTMLElement | undefined = $state(undefined);
     let isOpen = $state(false);
@@ -83,7 +85,7 @@
         filterText = keyword ?? '';
     }
 
-    export const focus = () => {
+    export function focus() {
         setTimeout(() => {
             picker?.focus();
         }, 50);
@@ -95,11 +97,12 @@
     $effect(() => {
         if (isOpen) {
             if (filterFunction != null) {
-                setTimeout(() => {
+                const timer = setTimeout(() => {
                     searchBox?.focus();
                     filterText = "";
                     doSearch(filterText);
                 }, 50);
+                return () => clearTimeout(timer);
             } else {
                 picker?.focus();
             }
@@ -110,19 +113,20 @@
     $effect(() => {
         if (!isOpen && hasFocus) {
             // 延迟检查，如果input仍然有焦点，说明是选择项目导致的关闭
-            setTimeout(() => {
+            const timer = setTimeout(() => {
                 if (document.activeElement !== editor &&
                     (!searchBox || document.activeElement !== (searchBox as any).element)) {
                     hasFocus = false;
                     onblur?.(new FocusEvent('blur'));
                 }
             }, 50);
+            return () => clearTimeout(timer);
         }
     });
 
 
     const handleItemClick = (data: any) => () => {
-        if (disableOptions.indexOf(data[keyField]) < 0) {
+        if (disabledOptions.indexOf(data[keyField]) < 0) {
             value = data[keyField];
             onchange?.(data);
             isOpen = false;
@@ -142,9 +146,9 @@
 
 </script>
 
-<CommonPicker bind:this={picker} {error} {tooltip} {variant} {style} {compact} {textValue} {readonly} {placeholder} {disabled} bind:isOpen
-              {theme} {value} clear={()=> {value = undefined}} {mandatory} {onfocus} {onblur}>
-    {#snippet popupLayer()}
+<CommonPicker bind:this={picker} {error} {tooltip} {variant} {style} {compact} {textValue} {readonly} {placeholder} {disabled} bind:expanded={isOpen}
+              {theme} {value} clear={()=> {value = undefined}} {clearable} {onfocus} {onblur}>
+    {#snippet popup()}
         <div class="uniface-options-popover" style={mh} role="listbox">
             {#if filterFunction != null}
                 <div class="quick-filter-box">
@@ -167,11 +171,11 @@
                         {#if itemRender != null}
                             {@const ItemComp = itemRender.component}
                             <ItemComp {...itemRender.props} item={op}
-                                      disabled={disableOptions.indexOf(op[keyField])>-1}
+                                      disabled={disabledOptions.indexOf(op[keyField])>-1}
                                       onclick={handleItemClick(op)}/>
                         {:else}
-                            <div class="option-item" class:disabled={disableOptions.indexOf(op[keyField])>-1}
-                                 role="option" tabindex={disableOptions.indexOf(op[keyField])>-1 ? -1 : 0}
+                            <div class="option-item" class:disabled={disabledOptions.indexOf(op[keyField])>-1}
+                                 role="option" tabindex={disabledOptions.indexOf(op[keyField])>-1 ? -1 : 0}
                                  aria-selected={String(op[keyField]) === String(value)}
                                  onclick={handleItemClick(op)} onkeydown={handleItemKeyDown(op)}>
                                 <span>{op[textField]}</span>

package/dist/form/options_select/OptionsSelect.svelte.d.ts

@@ -7,7 +7,8 @@ declare function $$render<Option extends Record<string, any> = any>(): {
         keyField?: string;
         textField?: string;
         menu$height?: number;
-        disableOptions?: Array<string>;
+        /** 要渲染但禁用的选项 key 列表 */
+        disabledOptions?: Array<string>;
         hideOptions?: Array<string>;
         itemRender?: any;
         filterPlaceholder?: string;

package/dist/form/options_select/README.md

@@ -1,5 +1,7 @@
 # OptionsSelect
 
+> **Renamed in 5.1.0**: this document uses the names from the [API Naming Guide](../../../docs/NAMING.md); the old names `disableOptions`, `mandatory` were removed in 5.1.0 (no compatibility aliases are kept).
+
 A single-selection dropdown picker. The user types nothing — they click, optionally filter, and pick one option from a list. Renders via the shared `CommonPicker` + `Popover` chrome, so it inherits the same surface/shadow/border tokens every dropdown in the library uses.
 
 > This is the **single-select** picker. For multi-select see [OptionsMultiSelect](../options_multi_select/README.md); for cascading (tree-shaped) data see [CascadeOptionSelect](../cascade_options_select/README.md).
@@ -8,7 +10,7 @@ A single-selection dropdown picker. The user types nothing — they click, optio
 
 - **Single selection** with `value` bound to the option's key field (default `code`).
 - **Custom field mapping** via `keyField` / `textField` — your option objects don't need to be shaped `{code, text}`.
-- **Hide or disable individual options** through `hideOptions` / `disableOptions`.
+- **Hide or disable individual options** through `hideOptions` / `disabledOptions`.
 - **Optional quick filter** — pass a `filterFunction` and the dropdown grows a search box at the top. No separate `quickFilter` boolean anymore; the presence of `filterFunction` is the toggle.
 - **Custom item rendering** through `itemRender` — supply `{component, props}`, receive `item` / `disabled` / `onclick`.
 - **Read-only & disabled modes** — replaces the old `displayMode` enum.
@@ -49,7 +51,7 @@ import OptionsSelect from "@ticatec/uniface-element/OptionsSelect";
 
 ## Props
 
-`OptionsSelect` extends `PickerProps`, so all the common editor props (`variant`, `compact`, `disabled`, `readonly`, `mandatory`, `style`, `error`, `tooltip`, `theme`, `placeholder`, `onfocus` / `onblur` / `onchange`) are available out of the box.
+`OptionsSelect` extends `PickerProps`, so all the common editor props (`variant`, `compact`, `disabled`, `readonly`, `clearable={false}`, `style`, `error`, `tooltip`, `theme`, `placeholder`, `onfocus` / `onblur` / `onchange`) are available out of the box.
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
@@ -59,13 +61,13 @@ import OptionsSelect from "@ticatec/uniface-element/OptionsSelect";
 | `textField` | `string` | `"text"` | Property name to display. |
 | `placeholder` | `string` | — | Shown in the input when `value` is empty. |
 | `emptyText` | `string` | — | Overrides the display text when no option matches `value`. Useful for "the saved value is no longer in the list" cases. |
-| `disableOptions` | `Array<string>` | `[]` | Keys of options that should render but be unclickable (dimmed). |
+| `disabledOptions` | `Array<string>` | `[]` | Keys of options that should render but be unclickable (dimmed). |
 | `hideOptions` | `Array<string>` | `[]` | Keys of options that should not render at all. |
 | `variant` | `'' \| 'plain' \| 'outlined' \| 'filled'` | `''` | Visual style variant. |
 | `compact` | `boolean` | `false` | Dense layout for table cells and inline forms. |
 | `disabled` | `boolean` | `false` | Fully disabled — renders a read-only input, no popup. |
 | `readonly` | `boolean` | `false` | Read-only — same visual as disabled but semantics are "view, don't edit". |
-| `mandatory` | `boolean` | `false` | Hides the clear (×) button. The user must pick something; they can't go back to empty. |
+| `clearable` | `boolean` | `true` | Whether the value can be cleared (shows the clear button). The old `mandatory` prop meant the opposite (`mandatory={true}` = `clearable={false}`) and was removed in 5.1.0. |
 | `style` | `string` | — | Inline CSS on the editor root. |
 | `error` | `string` | — | Validation error text. Triggers the editor's error state (typically a red border). |
 | `tooltip` | `string` | — | Hover tooltip on the editor. |
@@ -110,7 +112,7 @@ Pass `{component, props?}`. The component receives:
 | Prop | Source |
 |------|--------|
 | `item` | The current option object. |
-| `disabled` | `true` when the option's key is in `disableOptions`. |
+| `disabled` | `true` when the option's key is in `disabledOptions`. |
 | `onclick` | Internal handler — call this on click to select the item. |
 | `...props` | Anything you put in `itemRender.props` is spread onto the component. |
 
@@ -207,7 +209,7 @@ Pass `{component, props?}`. The component receives:
   {options: statuses}
   bind:value={status}
   variant="outlined"
-  disableOptions={["ARCHIVED"]}
+  disabledOptions={["ARCHIVED"]}
   hideOptions={["CANCELLED"]}
   mandatory
 />
@@ -348,7 +350,7 @@ Both layers read tokens from `uniface-root.scss`. The tokens **exist in light +
 
 ### Read-only / disabled rendering
 
-Both render a plain `<input readonly>` with the display text. The clear (×) button, dropdown arrow, and popup are all suppressed. `mandatory` has no effect in these modes.
+Both render a plain `<input readonly>` with the display text. The clear (×) button, dropdown arrow, and popup are all suppressed. `clearable={false}` has no effect in these modes.
 
 ### `emptyText` vs `placeholder`
 

package/dist/form/options_select/README_CN.md

@@ -1,5 +1,7 @@
 # OptionsSelect
 
+> **5.1.0 重命名**：本文使用 [API 命名规范](../../../docs/NAMING_CN.md) 中的名字；旧名 `disableOptions`, `mandatory` 已在 5.1.0 移除（5.1.0 不保留兼容别名）。
+
 单选下拉选择器。用户不输入文字 —— 点击、（可选地）过滤、从列表中选一项。基于共享的 `CommonPicker` + `Popover` 渲染，所以继承本库所有下拉组件共用的表面色 / 阴影 / 边框 token。
 
 > 这是**单选**组件。多选见 [OptionsMultiSelect](../options_multi_select/README_CN.md)；树形级联见 [CascadeOptionSelect](../cascade_options_select/README_CN.md)。
@@ -8,7 +10,7 @@
 
 - **单选**：`value` 绑定到选项的 key 字段（默认 `code`）。
 - **自定义字段映射**：`keyField` / `textField` —— 你的选项对象不必是 `{code, text}` 形状。
-- **隐藏或禁用单个选项**：通过 `hideOptions` / `disableOptions`。
+- **隐藏或禁用单个选项**：通过 `hideOptions` / `disabledOptions`。
 - **可选的快速过滤** —— 传入 `filterFunction`，下拉框顶部就会长出一个搜索框。**不再有 `quickFilter` 布尔开关**；`filterFunction` 的存在与否就是开关。
 - **自定义项渲染**：`itemRender` —— 传 `{component, props}`，子组件接收 `item` / `disabled` / `onclick`。
 - **只读与禁用模式** —— 取代旧的 `displayMode` 枚举。
@@ -49,7 +51,7 @@ import OptionsSelect from "@ticatec/uniface-element/OptionsSelect";
 
 ## 属性（Props）
 
-`OptionsSelect` 继承自 `PickerProps`，因此所有通用编辑器属性（`variant`、`compact`、`disabled`、`readonly`、`mandatory`、`style`、`error`、`tooltip`、`theme`、`placeholder`、`onfocus` / `onblur` / `onchange`）都开箱可用。
+`OptionsSelect` 继承自 `PickerProps`，因此所有通用编辑器属性（`variant`、`compact`、`disabled`、`readonly`、`clearable={false}`、`style`、`error`、`tooltip`、`theme`、`placeholder`、`onfocus` / `onblur` / `onchange`）都开箱可用。
 
 | 属性 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
@@ -59,13 +61,13 @@ import OptionsSelect from "@ticatec/uniface-element/OptionsSelect";
 | `textField` | `string` | `"text"` | 显示用的字段名。 |
 | `placeholder` | `string` | — | `value` 为空时输入框的占位文字。 |
 | `emptyText` | `string` | — | 当 `value` 在 `options` 中找不到对应项时的显示文本。适用于"已保存的值已从列表移除"这类场景。 |
-| `disableOptions` | `Array<string>` | `[]` | 要渲染但禁用（变灰）的选项 key 列表。 |
+| `disabledOptions` | `Array<string>` | `[]` | 要渲染但禁用（变灰）的选项 key 列表。 |
 | `hideOptions` | `Array<string>` | `[]` | 完全不渲染的选项 key 列表。 |
 | `variant` | `'' \| 'plain' \| 'outlined' \| 'filled'` | `''` | 视觉风格。 |
 | `compact` | `boolean` | `false` | 紧凑布局，用于表格单元格和行内表单。 |
 | `disabled` | `boolean` | `false` | 完全禁用 —— 渲染只读输入框，无弹窗。 |
 | `readonly` | `boolean` | `false` | 只读 —— 视觉同 disabled，但语义是"查看，不可编辑"。 |
-| `mandatory` | `boolean` | `false` | 隐藏清空（×）按钮。用户必须选一项，不能回到空。 |
+| `clearable` | `boolean` | `true` | 是否允许清空（显示清空按钮）。旧名 `mandatory` 语义相反（`mandatory={true}` = `clearable={false}`），5.1.0 已移除。 |
 | `style` | `string` | — | 编辑器根节点的内联 CSS。 |
 | `error` | `string` | — | 校验错误文本。触发编辑器的 error 状态（通常是红色边框）。 |
 | `tooltip` | `string` | — | 编辑器的 hover tooltip。 |
@@ -110,7 +112,7 @@ import OptionsSelect from "@ticatec/uniface-element/OptionsSelect";
 | 属性 | 来源 |
 |------|------|
 | `item` | 当前选项对象。 |
-| `disabled` | 选项 key 在 `disableOptions` 中时为 `true`。 |
+| `disabled` | 选项 key 在 `disabledOptions` 中时为 `true`。 |
 | `onclick` | 内部处理函数 —— 点击时调用它来选中这一项。 |
 | `...props` | 你放在 `itemRender.props` 里的任何属性都会展开到组件上。 |
 
@@ -207,7 +209,7 @@ import OptionsSelect from "@ticatec/uniface-element/OptionsSelect";
   {options: statuses}
   bind:value={status}
   variant="outlined"
-  disableOptions={["ARCHIVED"]}
+  disabledOptions={["ARCHIVED"]}
   hideOptions={["CANCELLED"]}
   mandatory
 />

package/dist/form/prompts_text_editor/PromptsTextEditor.svelte

@@ -9,7 +9,8 @@
         value?: string;
         prefix?: string;
         suffix?: string;
-        words: Array<string>;
+        /** 候选提示词列表 */
+        options?: Array<string>;
         menu$height?: number;
 
         [key: `input\$${string}`]: any;
@@ -27,7 +28,7 @@
         suffix,
         tooltip,
         placeholder,
-        words,
+        options = [],
         menu$height = 0,
         onchange,
         ...restProps
@@ -46,7 +47,7 @@
     const handleHintClick = (item: string) => (e: MouseEvent) => {
         value = item;
         editor?.focus();
-        editorRef?.closePopup();
+        editorRef?.close();
         e.stopPropagation();
         e.preventDefault();
     };
@@ -74,9 +75,9 @@
                    {suffix} {clear} textValue={value}>
     <input bind:this={editor} bind:value {disabled} {readonly} {placeholder} {...eventHandlers}/>
 
-    {#snippet popupLayer()}
+    {#snippet popup()}
         <div class="options-popover" style={mh} role="listbox">
-            {#each words as word}
+            {#each options as word}
                 <div
                         class="option-item"
                         style="padding-left: 12px; padding-right: 12px"

package/dist/form/prompts_text_editor/PromptsTextEditor.svelte.d.ts

@@ -3,7 +3,8 @@ interface Props extends CommonFieldProps {
     value?: string;
     prefix?: string;
     suffix?: string;
-    words: Array<string>;
+    /** 候选提示词列表 */
+    options?: Array<string>;
     menu$height?: number;
     [key: `input\$${string}`]: any;
 }

package/dist/form/prompts_text_editor/README.md

@@ -1,5 +1,7 @@
 # PromptsTextEditor
 
+> **Renamed in 5.1.0**: this document uses the names from the [API Naming Guide](../../../docs/NAMING.md); the old names `words` were removed in 5.1.0 (no compatibility aliases are kept).
+
 A text input component with auto-suggestion functionality that displays a dropdown menu of predefined words/prompts when clicked. Perfect for scenarios where users need to input from a set of known options with the ability to type custom values.
 
 ## Features
@@ -38,7 +40,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 
 <PromptsTextEditor
   bind:value={value}
-  words={suggestions}
+  options={suggestions}
   onchange={handleChange}
   placeholder="Type or select a fruit..."
 />
@@ -49,7 +51,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `value` | `string \| undefined` | `undefined` | Current input value (bindable). |
-| `words` | `Array<string>` | — (required) | Array of suggestion words to display in the dropdown. |
+| `options` | `Array<string>` | — (required) | Array of suggestion options to display in the dropdown. |
 | `variant` | `"" \| "plain" \| "outlined" \| "filled"` | `""` | Visual style variant. |
 | `compact` | `boolean` | `false` | Compact spacing layout. |
 | `disabled` | `boolean` | `false` | Disables the editor. |
@@ -97,7 +99,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 
 <PromptsTextEditor
   bind:value={selectedTag}
-  words={availableTags}
+  options={availableTags}
   placeholder="Select or type a programming language..."
 />
 ```
@@ -129,7 +131,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 
 <PromptsTextEditor
   bind:value={currentValue}
-  words={commands}
+  options={commands}
   onchange={handleValueChange}
   onfocus={handleFocus}
   onblur={handleBlur}
@@ -148,13 +150,13 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 </script>
 
 <!-- Default variant -->
-<PromptsTextEditor bind:value={value1} words={options} placeholder="Default" />
+<PromptsTextEditor bind:value={value1} options={options} placeholder="Default" />
 
 <!-- Outlined variant -->
-<PromptsTextEditor bind:value={value2} words={options} variant="outlined" placeholder="Outlined" />
+<PromptsTextEditor bind:value={value2} options={options} variant="outlined" placeholder="Outlined" />
 
 <!-- Filled variant -->
-<PromptsTextEditor bind:value={value3} words={options} variant="filled" placeholder="Filled" />
+<PromptsTextEditor bind:value={value3} options={options} variant="filled" placeholder="Filled" />
 ```
 
 ### Custom Menu Height
@@ -169,7 +171,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 
 <PromptsTextEditor
   bind:value={selectedItem}
-  words={longList}
+  options={longList}
   menu$height={200}
   placeholder="Select from many options..."
 />
@@ -201,7 +203,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
     <label>Category</label>
     <PromptsTextEditor
       bind:value={formData.category}
-      words={categories}
+      options={categories}
       placeholder="Select category..."
     />
   </div>
@@ -210,7 +212,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
     <label>Priority</label>
     <PromptsTextEditor
       bind:value={formData.priority}
-      words={priorities}
+      options={priorities}
       placeholder="Select priority..."
     />
   </div>
@@ -219,7 +221,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
     <label>Status</label>
     <PromptsTextEditor
       bind:value={formData.status}
-      words={statuses}
+      options={statuses}
       placeholder="Select status..."
     />
   </div>
@@ -257,7 +259,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 <!-- Readonly -->
 <PromptsTextEditor
   bind:value={value1}
-  words={options}
+  options={options}
   readonly
   placeholder="This is readonly"
 />
@@ -265,7 +267,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 <!-- Disabled -->
 <PromptsTextEditor
   bind:value={value2}
-  words={options}
+  options={options}
   disabled
   placeholder="This is disabled"
 />
@@ -290,7 +292,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 <div class="command-palette">
   <PromptsTextEditor
     bind:value={command}
-    words={commands}
+    options={commands}
     variant="outlined"
     placeholder="Type a command..."
   />

package/dist/form/prompts_text_editor/README_CN.md

@@ -1,5 +1,7 @@
 # PromptsTextEditor 带建议的文本输入
 
+> **5.1.0 重命名**：本文使用 [API 命名规范](../../../docs/NAMING_CN.md) 中的名字；旧名 `words` 已在 5.1.0 移除（5.1.0 不保留兼容别名）。
+
 带自动建议功能的文本输入组件，点击时显示预定义词语/提示的下拉菜单。适用于用户需要从已知选项集中输入，同时支持输入自定义值的场景。
 
 ## 功能特性
@@ -38,7 +40,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 
 <PromptsTextEditor
   bind:value={value}
-  words={suggestions}
+  options={suggestions}
   onchange={handleChange}
   placeholder="输入或选择一个水果..."
 />
@@ -49,7 +51,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 | 属性 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
 | `value` | `string \| undefined` | `undefined` | 当前输入值（可双向绑定）。 |
-| `words` | `Array<string>` | —（必填） | 下拉菜单中显示的建议词语数组。 |
+| `options` | `Array<string>` | —（必填） | 下拉菜单中显示的建议词语数组。 |
 | `variant` | `"" \| "plain" \| "outlined" \| "filled"` | `""` | 视觉样式变体。 |
 | `compact` | `boolean` | `false` | 紧凑间距布局。 |
 | `disabled` | `boolean` | `false` | 禁用编辑器。 |
@@ -97,7 +99,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 
 <PromptsTextEditor
   bind:value={selectedTag}
-  words={availableTags}
+  options={availableTags}
   placeholder="选择或输入编程语言..."
 />
 ```
@@ -129,7 +131,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 
 <PromptsTextEditor
   bind:value={currentValue}
-  words={commands}
+  options={commands}
   onchange={handleValueChange}
   onfocus={handleFocus}
   onblur={handleBlur}
@@ -148,13 +150,13 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 </script>
 
 <!-- 默认变体 -->
-<PromptsTextEditor bind:value={value1} words={options} placeholder="默认" />
+<PromptsTextEditor bind:value={value1} options={options} placeholder="默认" />
 
 <!-- 描边变体 -->
-<PromptsTextEditor bind:value={value2} words={options} variant="outlined" placeholder="描边" />
+<PromptsTextEditor bind:value={value2} options={options} variant="outlined" placeholder="描边" />
 
 <!-- 填充变体 -->
-<PromptsTextEditor bind:value={value3} words={options} variant="filled" placeholder="填充" />
+<PromptsTextEditor bind:value={value3} options={options} variant="filled" placeholder="填充" />
 ```
 
 ### 自定义菜单高度
@@ -169,7 +171,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 
 <PromptsTextEditor
   bind:value={selectedItem}
-  words={longList}
+  options={longList}
   menu$height={200}
   placeholder="从许多选项中选取..."
 />
@@ -201,7 +203,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
     <label>类别</label>
     <PromptsTextEditor
       bind:value={formData.category}
-      words={categories}
+      options={categories}
       placeholder="选择类别..."
     />
   </div>
@@ -210,7 +212,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
     <label>优先级</label>
     <PromptsTextEditor
       bind:value={formData.priority}
-      words={priorities}
+      options={priorities}
       placeholder="选择优先级..."
     />
   </div>
@@ -219,7 +221,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
     <label>状态</label>
     <PromptsTextEditor
       bind:value={formData.status}
-      words={statuses}
+      options={statuses}
       placeholder="选择状态..."
     />
   </div>
@@ -257,7 +259,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 <!-- 只读 -->
 <PromptsTextEditor
   bind:value={value1}
-  words={options}
+  options={options}
   readonly
   placeholder="这是只读的"
 />
@@ -265,7 +267,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 <!-- 禁用 -->
 <PromptsTextEditor
   bind:value={value2}
-  words={options}
+  options={options}
   disabled
   placeholder="这是禁用的"
 />
@@ -290,7 +292,7 @@ import PromptsTextEditor from "@ticatec/uniface-element/PromptsTextEditor";
 <div class="command-palette">
   <PromptsTextEditor
     bind:value={command}
-    words={commands}
+    options={commands}
     variant="outlined"
     placeholder="输入命令..."
   />

package/dist/form/search_box/SearchBox.svelte

@@ -1,7 +1,8 @@
 <script lang="ts">
     import CommonEditor from "../common_editor/CommonEditor.svelte";
-    import type {EditorEvents, EditorVariant} from "../types";
-    import type {KeyboardEvents} from "../common_editor/EditorEvents";
+    import type {EditorVariant} from "../types";
+    import type {EditorEvents} from "../events";
+    import type {KeyboardEvents} from "../events";
     import {eventFilter} from "../../utils/prefixFilter";
     import type CommonFieldProps from "../common_editor/CommonFieldProps";
 

package/dist/form/search_box/SearchBox.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { KeyboardEvents } from "../common_editor/EditorEvents";
+import type { KeyboardEvents } from "../events";
 import type CommonFieldProps from "../common_editor/CommonFieldProps";
 interface Props extends CommonFieldProps, KeyboardEvents {
     value?: string;

package/dist/form/switch/README.md

@@ -1,5 +1,7 @@
 # Switch Component
 
+> **Renamed in 5.1.0**: this document uses the names from the [API Naming Guide](../../../docs/NAMING.md); the old names `checkLabel`, `uncheckLabel` were removed in 5.1.0 (no compatibility aliases are kept).
+
 A toggle switch component for binary on/off states. The switch displays labeled "On"/"Off" states with smooth sliding animation and customizable label text. Ideal for enabling or disabling features, toggling settings, and managing boolean preferences.
 
 ## Installation
@@ -33,8 +35,8 @@ import Switch from "@ticatec/uniface-element/Switch";
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `value` | `boolean` | `false` | Toggle state of the switch (supports two-way binding with `bind:value`) |
-| `checkLabel` | `string` | `"On"` | Label displayed when the switch is in the checked/on state |
-| `uncheckLabel` | `string` | `"Off"` | Label displayed when the switch is in the unchecked/off state |
+| `checkedText` | `string` | `"On"` | Label displayed when the switch is in the checked/on state |
+| `uncheckedText` | `string` | `"Off"` | Label displayed when the switch is in the unchecked/off state |
 | `readonly` | `boolean` | `false` | Whether the switch is read-only (cannot be toggled) |
 | `disabled` | `boolean` | `false` | Whether the switch is disabled |
 
@@ -83,8 +85,8 @@ import Switch from "@ticatec/uniface-element/Switch";
 
 <Switch 
   bind:value={wifiEnabled} 
-  checkLabel="Connected" 
-  uncheckLabel="Disconnected" 
+  checkedText="Connected" 
+  uncheckedText="Disconnected" 
 />
 
 <p>WiFi: {wifiEnabled ? 'Connected' : 'Disconnected'}</p>
@@ -206,7 +208,7 @@ The Switch component supports the following CSS custom properties for theming:
 ## Features
 
 - **Two-way Binding**: Supports `bind:value` for reactive state management
-- **Custom Labels**: Configurable on/off text via `checkLabel` and `uncheckLabel` props
+- **Custom Labels**: Configurable on/off text via `checkedText` and `uncheckedText` props
 - **Smooth Animation**: CSS transition for sliding knob and color changes
 - **Disabled State**: Non-interactive switch with visual feedback
 - **Read-only State**: Display-only mode that prevents toggling

package/dist/form/switch/README_CN.md

@@ -1,5 +1,7 @@
 # 开关组件 (Switch)
 
+> **5.1.0 重命名**：本文使用 [API 命名规范](../../../docs/NAMING_CN.md) 中的名字；旧名 `checkLabel`, `uncheckLabel` 已在 5.1.0 移除（5.1.0 不保留兼容别名）。
+
 一个用于二元开/关状态的切换开关组件，支持平滑的滑动动画和自定义标签文字。非常适合启用或禁用功能、切换设置和管理布尔偏好。
 
 ## 安装
@@ -33,8 +35,8 @@ import Switch from "@ticatec/uniface-element/Switch";
 | 属性 | 类型 | 默认值 | 描述 |
 |------|------|--------|------|
 | `value` | `boolean` | `false` | 开关状态（支持 `bind:value` 双向绑定） |
-| `checkLabel` | `string` | `"On"` | 开关打开时显示的标签文字 |
-| `uncheckLabel` | `string` | `"Off"` | 开关关闭时显示的标签文字 |
+| `checkedText` | `string` | `"On"` | 开关打开时显示的标签文字 |
+| `uncheckedText` | `string` | `"Off"` | 开关关闭时显示的标签文字 |
 | `readonly` | `boolean` | `false` | 是否为只读状态（不可切换） |
 | `disabled` | `boolean` | `false` | 是否禁用开关 |
 
@@ -83,8 +85,8 @@ import Switch from "@ticatec/uniface-element/Switch";
 
 <Switch 
   bind:value={wifi已连接} 
-  checkLabel="已连接" 
-  uncheckLabel="未连接" 
+  checkedText="已连接" 
+  uncheckedText="未连接" 
 />
 
 <p>WiFi：{wifi已连接 ? '已连接' : '未连接'}</p>
@@ -230,7 +232,7 @@ Switch 组件支持以下 CSS 自定义属性进行主题定制：
 ## 功能特性
 
 - **双向绑定**：支持 `bind:value` 实现响应式状态管理
-- **自定义标签**：通过 `checkLabel` 和 `uncheckLabel` 属性自定义开/关文字
+- **自定义标签**：通过 `checkedText` 和 `uncheckedText` 属性自定义开/关文字
 - **平滑动画**：滑动按钮和颜色变化的 CSS 过渡动画
 - **禁用状态**：非交互式的禁用开关，带有视觉反馈
 - **只读状态**：仅展示模式的开关，防止用户切换