@open-dy/vibecoding-sdk-taro 0.0.1-beta.4 → 0.0.1-beta.6

package/dist/reference/sdk-api/ui/combobox/ComboboxInput.md

@@ -0,0 +1,113 @@
+# ComboboxInput
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/combobox`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/combobox.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+可搜索选择框输入区域。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Combobox, ComboboxInput } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+<Combobox><ComboboxInput /></Combobox>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：可搜索选择框输入区域。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ComboboxInput(props: Omit<ViewProps, "children"> & { children?: React.ReactNode; disabled?: boolean; showTrigger?: boolean; showClear?: boolean; placeholder?: string; "aria-invalid"?: boolean | "true" | "false"; }): React.JSX.Element;
+```
+
+#### 参数
+
+- `props`
+
+```ts
+Omit<ViewProps, "children"> & { children?: React.ReactNode; disabled?: boolean; showTrigger?: boolean; showClear?: boolean; placeholder?: string; "aria-invalid"?: boolean | "true" | "false"; }
+```
+说明：组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| children? | `React.ReactNode` | 输入框末尾的附加内容；省略时仅显示输入区及配置的触发/清空按钮。 |
+| disabled? | `boolean \| undefined` | 是否禁用搜索输入及内部按钮交互，默认 false。 |
+| showTrigger? | `boolean \| undefined` | 是否显示展开按钮，默认 true；有可清空值且 showClear 为 true 时优先显示清空按钮。 |
+| showClear? | `boolean \| undefined` | 是否在有搜索词或选中值时显示清空按钮，默认 false；点击同时清空搜索词和选中值。 |
+| placeholder? | `string \| undefined` | 空输入时的提示文本；省略时不设置原生输入提示。 |
+| aria-invalid? | `boolean \| "true" \| "false" \| undefined` | 是否显示校验失败样式；true 或 "true" 表示失败，不负责执行校验。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/combobox/ComboboxItem.md

@@ -0,0 +1,106 @@
+# ComboboxItem
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/combobox`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/combobox.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+可搜索选择框条目。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Combobox, ComboboxItem } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+<Combobox><ComboboxItem value="one" /></Combobox>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：可搜索选择框条目。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ComboboxItem(props: ViewProps & { value: string; }): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps & { value: string; }` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| value | `string` | 该候选项的字符串值；用于比较和更新选择，需与 items 或业务候选值一致。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/combobox/ComboboxLabel.md

@@ -0,0 +1,100 @@
+# ComboboxLabel
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/combobox`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/combobox.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+可搜索选择框标签文本。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Combobox, ComboboxLabel } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+<Combobox><ComboboxLabel /></Combobox>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：可搜索选择框标签文本。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ComboboxLabel(props: ViewProps): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/combobox/ComboboxList.md

@@ -0,0 +1,105 @@
+# ComboboxList
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/combobox`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/combobox.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+可搜索选择框列表容器。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Combobox, ComboboxList } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+<Combobox><ComboboxList /></Combobox>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：可搜索选择框列表容器。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ComboboxList(props: ComboboxListProps): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ComboboxListProps` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| children? | `React.ReactNode \| ((item: ComboboxOption) => React.ReactNode)` | 静态列表节点或逐项渲染函数；函数收到过滤后的候选字符串，需要根 Combobox 提供 items，未提供时不生成列表项。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/combobox/ComboboxSeparator.md

@@ -0,0 +1,100 @@
+# ComboboxSeparator
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/combobox`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/combobox.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+可搜索选择框分隔线。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Combobox, ComboboxSeparator } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+<Combobox><ComboboxSeparator /></Combobox>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：可搜索选择框分隔线。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ComboboxSeparator(props: ViewProps): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/combobox/ComboboxTrigger.md

@@ -0,0 +1,100 @@
+# ComboboxTrigger
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/combobox`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/combobox.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+可搜索选择框触发器。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Combobox, ComboboxTrigger } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+<Combobox><ComboboxTrigger /></Combobox>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：可搜索选择框触发器。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ComboboxTrigger(props: ViewProps): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| hoverClass? | `string \| undefined` | 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果 |
+| hoverStyle? | `any` | 由于 RN 不支持 hoverClass，故 RN 端的 View 组件实现了 `hoverStyle`属性，写法和 style 类似，只不过 `hoverStyle` 的样式是指定按下去的样式。 |
+| hoverStopPropagation? | `boolean \| undefined` | 指定是否阻止本节点的祖先节点出现点击态 |
+| hoverStartTime? | `number \| undefined` | 按住后多久出现点击态，单位毫秒 |
+| hoverStayTime? | `number \| undefined` | 手指松开后点击态保留时间，单位毫秒 |
+| disableScroll? | `boolean \| undefined` | 是否阻止区域内滚动页面。 说明： 如果 view 中嵌套 view，外层 view 设置 disable-scroll 为 true 时禁止内部的滚动。 |
+| hidden? | `boolean \| undefined` | 是否隐藏。 |
+| animation? | `TaroGeneral.IAnyObject \| undefined` | 用于动画，详见 my.createAnimation 。使用 my.createAnimation 生成的动画是通过过渡（Transition）实现的，只会触发 onTransitionEnd，不会触发 onAnimationStart, onAnimationIteration, onAnimationEnd。 |
+| role? | `string \| undefined` | 表示组件的语义角色。设置为 img 时，组件聚焦后读屏软件会朗读出 图像 ；设置为 button 时，聚焦后读屏软件会朗读出 按钮 。详情请参见 aria-component。 |
+| ariaRole? | `string \| undefined` | 无障碍访问，（角色）标识元素的作用 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTap? | `CommonEventFunction \| undefined` | 点击。 |
+| onTouchStart? | `CommonEventFunction \| undefined` | 触摸动作开始。 |
+| onTouchMove? | `CommonEventFunction \| undefined` | 触摸后移动。 |
+| onTouchEnd? | `CommonEventFunction \| undefined` | 触摸动作结束。 |
+| onTouchCancel? | `CommonEventFunction \| undefined` | 触摸动作被打断，如来电提醒，弹窗。 |
+| onLongTap? | `CommonEventFunction \| undefined` | 长按 500ms 之后触发，触发了长按事件后进行移动将不会触发屏幕的滚动。 |
+| onTransitionEnd? | `CommonEventFunction \| undefined` | 过渡（Transition）结束时触发。 |
+| onAnimationIteration? | `CommonEventFunction \| undefined` | 每开启一次新的动画过程时触发。（第一次不触发） |
+| onAnimationStart? | `CommonEventFunction \| undefined` | 动画开始时触发。 |
+| onAnimationEnd? | `CommonEventFunction \| undefined` | 动画结束时触发。 |
+| onAppear? | `CommonEventFunction \| undefined` | 当前元素可见面积超过50%时触发。 |
+| onDisappear? | `CommonEventFunction \| undefined` | 当前元素不可见面积超过50%时触发。 |
+| onFirstAppear? | `CommonEventFunction \| undefined` | 当前元素首次可见面积达到50%时触发。 |
+| catchMove? | `boolean \| undefined` | 是否以 catch 的形式绑定 touchmove 事件 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`