clickgo 5.17.3 → 5.18.0

package/dist/lib/control.d.ts

@@ -628,7 +628,7 @@ export interface ISelectItemclickedEvent {
 }
 export interface IStabChangeEvent extends ICustomEvent {
     'detail': {
-        'value': number;
+        'value': number | string;
     };
 }
 export interface ISwitchChangeEvent extends ICustomEvent {

package/dist/lib/form.d.ts

@@ -660,18 +660,18 @@ export interface IFormDialogOptions {
     /** --- 路径基，以 / 结束或文件路径则以文件的基路径为准，可留空 --- */
     'path'?: string;
     /**
-     * --- 点击按钮触发事件 ---
+     * --- 点击按钮触发事件，不能用 Promise ---
      * @param e 数据事件
      * @param button 按钮的文本
      */
-    'select'?: (this: AbstractForm & {
+    select?: (this: AbstractForm & {
         'data': Record<string, any>;
         'methods': Record<string, (...param: any) => any>;
     }, e: IFormDialogSelectEvent, button: string) => void;
     /**
      * --- 窗体挂载完成事件 ---
      */
-    'onMounted'?: () => void | Promise<void>;
+    onMounted?: () => void | Promise<void>;
 }
 export interface IFormDialogSelectEvent extends lControl.ICustomEvent {
     'detail': {

package/doc/clickgo-rag.md

@@ -6461,9 +6461,9 @@ QR 码组件，用于生成二维码。
 
 #### modelValue
 
-`number`
+`number | string`
 
-双向绑定，当前选中的索引，从 0 开始，默认 `0`。
+双向绑定，当前选中的标识。为数字时等同于索引（向后兼容），为字符串时对应 `stab-item` 的 `value` 属性，默认 `0`。
 
 #### type
 
@@ -6479,9 +6479,9 @@ QR 码组件，用于生成二维码。
 
 参数：
 
-`event: { go: boolean, preventDefault: Function, detail: { value: number } }`
+`event: { go: boolean, preventDefault: Function, detail: { value: number | string } }`
 
-其中 `detail.value` 为即将切换到的索引，`preventDefault()` 可阻止切换。
+其中 `detail.value` 为即将切换到的标识，`preventDefault()` 可阻止切换。
 
 ### 样式
 
@@ -6494,11 +6494,20 @@ QR 码组件，用于生成二维码。
 ### 示例
 
 ```html
-<stab v-model="tab" type="default">
+<!-- 数字索引（向后兼容） -->
+<stab v-model="tabIndex" type="default">
     <stab-item>Tab 1</stab-item>
     <stab-item>Tab 2</stab-item>
     <stab-item>Tab 3</stab-item>
 </stab>
+
+<!-- 字符串 key -->
+<stab v-model="activeTab" type="default">
+    <stab-item value="deploy">部署</stab-item>
+    <stab-item value="hosts">Hosts 设置</stab-item>
+    <stab-item value="project">子项目配置</stab-item>
+    <stab-item value="package">Package 更新</stab-item>
+</stab>
 ```
 
 
@@ -6507,27 +6516,33 @@ QR 码组件，用于生成二维码。
 
 轻量化选项卡子项控件，与父级 `stab` 控件搭配使用。点击后通知父级更新选中索引，并在 `rect` 模式下自动上报自身宽度与位置以驱动滑块动画。
 
-## 参数
+### 参数
 
-### disabled
+#### disabled
 
 `boolean` | `string`
 
 是否禁用此项，禁用后不可点击选中，默认 false。
 
-## 事件
+#### value
+
+`number` | `string`
+
+选项标识，支持字符串 key（如 `'deploy'`、`'hosts'` 等）。未设置时自动回退到 DOM 位置索引。
+
+### 事件
 
 无。
 
-## 方法
+### 方法
 
 无。
 
-## 插槽
+### 插槽
 
 无（`default` 插槽用于放置选项卡标签文本或内容）。
 
-## 样式
+### 样式
 
 **布局结构**：块级 flex 元素，通过 `selected` 类标记当前选中状态，并从父级 `stab` 获取 `type` 类以切换对应外观。
 
@@ -6535,14 +6550,20 @@ QR 码组件，用于生成二维码。
 
 **交互响应**：点击时立即切换选中状态，`rect` 模式下同步触发 `resize` 上报位置给父级；所有状态变化均通过 `var(--g-transition)` 过渡动画。
 
-## 示例
+### 示例
 
 ```html
-<stab v-model="tab">
+<stab v-model="tabIndex">
     <stab-item>Tab 1</stab-item>
     <stab-item>Tab 2</stab-item>
     <stab-item>Tab 3</stab-item>
 </stab>
+
+<stab v-model="activeTab">
+    <stab-item value="deploy">部署</stab-item>
+    <stab-item value="hosts">Hosts 设置</stab-item>
+    <stab-item value="package">Package 更新</stab-item>
+</stab>
 ```
 
 
@@ -13488,7 +13509,7 @@ Defined in: [lib/control.ts:1416](https://github.com/maiyun/clickgo/blob/master/
 
 #### value
 
-> **value**: `number`
+> **value**: `string` \| `number`
 
 ***
 
@@ -23290,7 +23311,7 @@ Defined in: [lib/form.ts:4269](https://github.com/maiyun/clickgo/blob/master/dis
 
 Defined in: [lib/form.ts:4276](https://github.com/maiyun/clickgo/blob/master/dist/lib/form.ts#L4276)
 
-点击按钮触发事件
+点击按钮触发事件，不能用 Promise
 
 #### Parameters
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickgo",
-  "version": "5.17.3",
+  "version": "5.18.0",
   "description": "Background interface, software interface, mobile phone APP interface operation library.",
   "type": "module",
   "keywords": [