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

package/dist/reference/llms.txt

@@ -8,8 +8,8 @@
 - `@open-dy/vibecoding-sdk-taro/interest-card/runtime/microapp` — 兴趣卡普通小程序适配器，复用 runtime 入口。 ([docs](./sdk-api/runtime/index.md))
 - `@open-dy/vibecoding-sdk-taro/interest-card/eslint/taro` — 公开导出入口。
 - `@open-dy/vibecoding-sdk-taro/interest-card/types/taro` — 公开导出入口。
-- `@open-dy/vibecoding-sdk-taro/ui` — React UI 组件入口。
-- `@open-dy/vibecoding-sdk-taro/ui/*` — React UI 组件入口。
+- `@open-dy/vibecoding-sdk-taro/ui` — React UI 组件、Hook、类型和样式函数；按模块渐进查阅。 ([docs](./sdk-api/ui/index.md))
+- `@open-dy/vibecoding-sdk-taro/ui/*` — React UI 组件、Hook、类型和样式函数；按模块渐进查阅。 ([docs](./sdk-api/ui/index.md))
 - `@open-dy/vibecoding-sdk-taro/ui/theme.css` — UI 样式资源入口。
 - `@open-dy/vibecoding-sdk-taro/ui/tailwind.css` — UI 样式资源入口。
 - `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card` — 公开导出入口。
@@ -34,3 +34,53 @@
   Import: `@open-dy/vibecoding-sdk-taro/build/taro`
 - [createMicroappTaroConfig](./sdk-api/build/taro/createMicroappTaroConfig.md) — 创建普通小程序的 Taro/Vite 构建配置。
   Import: `@open-dy/vibecoding-sdk-taro/build/taro`
+
+## UI modules
+Each module index lists all its public components, types, hooks and style functions; follow an API link for props, examples and source.
+- [accordion](./sdk-api/ui/accordion/index.md)
+- [alert-dialog](./sdk-api/ui/alert-dialog/index.md)
+- [alert](./sdk-api/ui/alert/index.md)
+- [aspect-ratio](./sdk-api/ui/aspect-ratio/index.md)
+- [avatar](./sdk-api/ui/avatar/index.md)
+- [badge](./sdk-api/ui/badge/index.md)
+- [button-group](./sdk-api/ui/button-group/index.md)
+- [button](./sdk-api/ui/button/index.md)
+- [calendar](./sdk-api/ui/calendar/index.md)
+- [card](./sdk-api/ui/card/index.md)
+- [carousel](./sdk-api/ui/carousel/index.md)
+- [checkbox](./sdk-api/ui/checkbox/index.md)
+- [collapsible](./sdk-api/ui/collapsible/index.md)
+- [combobox](./sdk-api/ui/combobox/index.md)
+- [dialog](./sdk-api/ui/dialog/index.md)
+- [drawer](./sdk-api/ui/drawer/index.md)
+- [dropdown-menu](./sdk-api/ui/dropdown-menu/index.md)
+- [empty](./sdk-api/ui/empty/index.md)
+- [field](./sdk-api/ui/field/index.md)
+- [helpers](./sdk-api/ui/helpers/index.md)
+- [input-group](./sdk-api/ui/input-group/index.md)
+- [input-otp](./sdk-api/ui/input-otp/index.md)
+- [input](./sdk-api/ui/input/index.md)
+- [item](./sdk-api/ui/item/index.md)
+- [label](./sdk-api/ui/label/index.md)
+- [menubar](./sdk-api/ui/menubar/index.md)
+- [navigation-menu](./sdk-api/ui/navigation-menu/index.md)
+- [pagination](./sdk-api/ui/pagination/index.md)
+- [popover](./sdk-api/ui/popover/index.md)
+- [portal](./sdk-api/ui/portal/index.md)
+- [progress](./sdk-api/ui/progress/index.md)
+- [radio-group](./sdk-api/ui/radio-group/index.md)
+- [resizable](./sdk-api/ui/resizable/index.md)
+- [scroll-area](./sdk-api/ui/scroll-area/index.md)
+- [select](./sdk-api/ui/select/index.md)
+- [separator](./sdk-api/ui/separator/index.md)
+- [sheet](./sdk-api/ui/sheet/index.md)
+- [skeleton](./sdk-api/ui/skeleton/index.md)
+- [slider](./sdk-api/ui/slider/index.md)
+- [sonner](./sdk-api/ui/sonner/index.md)
+- [spinner](./sdk-api/ui/spinner/index.md)
+- [switch](./sdk-api/ui/switch/index.md)
+- [table](./sdk-api/ui/table/index.md)
+- [tabs](./sdk-api/ui/tabs/index.md)
+- [textarea](./sdk-api/ui/textarea/index.md)
+- [toggle-group](./sdk-api/ui/toggle-group/index.md)
+- [toggle](./sdk-api/ui/toggle/index.md)

package/dist/reference/sdk-api/build/taro/BuildContext.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/build/taro`
-源码：`src/build/taro.ts`
+源码：[src/build/taro.ts](../../../../../src/build/taro.ts)（安装包内保留）
 
 #### 说明
 
@@ -22,7 +22,12 @@ const context: BuildContext = { isH5: true, isTt: false, mode: 'development', pr
 | 意图 | 描述 SDK 构建插件收到的 Taro 编译上下文。 |
 | 适用时机 | 需要根据 H5、TT 或开发模式调整构建配置时。 |
 | 避免 | 不要在业务页面中手动伪造该上下文或修改构建产物。 |
-| 示例 | `{ isH5: true, isTt: false, mode: 'development', projectRoot }` |
+
+示例：
+
+```ts
+{ isH5: true, isTt: false, mode: 'development', projectRoot }
+```
 
 #### 声明
 

package/dist/reference/sdk-api/build/taro/CreateMicroappTaroConfigOptions.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/build/taro`
-源码：`src/build/taro.ts`
+源码：[src/build/taro.ts](../../../../../src/build/taro.ts)（安装包内保留）
 
 #### 说明
 
@@ -31,7 +31,6 @@ createMicroappTaroConfig({ projectRoot: process.cwd() })
 | 意图 | 配置普通小程序的 Taro/Vite 构建入口。 |
 | 适用时机 | 需要从项目构建脚本创建普通小程序配置时。 |
 | 避免 | 不要在业务代码中直接调用 Taro/Vite 内部构建 API。 |
-| 示例 | `createMicroappTaroConfig({ projectRoot: process.cwd() })` |
 
 #### 声明
 

package/dist/reference/sdk-api/build/taro/createMicroappTaroConfig.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/build/taro`
-源码：`src/build/taro.ts`
+源码：[src/build/taro.ts](../../../../../src/build/taro.ts)（安装包内保留）
 
 #### 说明
 
@@ -30,7 +30,6 @@ createMicroappTaroConfig({ projectRoot: process.cwd() })
 | 意图 | 创建普通小程序的 Taro/Vite 构建配置。 |
 | 适用时机 | 构建脚本需要加载普通小程序的 SDK 配置时。 |
 | 避免 | 不要在业务页面调用该构建工厂，也不要绕过 SDK 修改代理配置。 |
-| 示例 | `createMicroappTaroConfig({ projectRoot: process.cwd() })` |
 
 #### 声明
 

package/dist/reference/sdk-api/runtime/CreateMicroappClientOptions.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/runtime`
-源码：`src/runtime/client.ts`
+源码：[src/runtime/client.ts](../../../../src/runtime/client.ts)（安装包内保留）
 
 #### 说明
 
@@ -22,7 +22,12 @@ const options = { platformChannel: 'ext' as const }
 | 意图 | 配置普通小程序 Network 的平台渠道。 |
 | 适用时机 | 需要让普通小程序请求携带内场或外场渠道标识时。 |
 | 避免 | 不要在业务页面直接拼接渠道请求头。 |
-| 示例 | `{ platformChannel: 'ext' }` |
+
+示例：
+
+```ts
+{ platformChannel: 'ext' }
+```
 
 #### 声明
 

package/dist/reference/sdk-api/runtime/createMicroappClient.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/runtime`
-源码：`src/runtime/default-client.ts`
+源码：[src/runtime/default-client.ts](../../../../src/runtime/default-client.ts)（安装包内保留）
 
 #### 说明
 
@@ -33,7 +33,12 @@ const response = await Network.request({ url: '/api/products', method: 'GET' })
 | 意图 | 创建绑定默认 Taro 实例的普通小程序 Network。 |
 | 适用时机 | 业务代码需要统一调用普通小程序的 request、uploadFile、downloadFile 或 streamSse 时。 |
 | 避免 | 不要在页面中直接调用 Taro.request，也不要传入 OpenCard 的 taro 实例。 |
-| 示例 | `const Network = createMicroappClient({ platformChannel: 'ext' })` |
+
+示例：
+
+```ts
+const Network = createMicroappClient({ platformChannel: 'ext' })
+```
 
 #### 声明
 

package/dist/reference/sdk-api/ui/accordion/Accordion.md

@@ -0,0 +1,114 @@
+# Accordion
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/accordion`
+源码：[src/ui/accordion.tsx](../../../../../src/ui/accordion.tsx)（安装包内保留）
+
+#### 说明
+
+手风琴折叠面板组件。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Accordion } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+<Accordion />
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：手风琴折叠面板组件。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function Accordion(props: ViewProps & { type?: "single" | "multiple"; value?: string | string[]; defaultValue?: string | string[]; disabled?: boolean; multiple?: boolean; onValueChange?: (value: string | string[]) => void; }): React.JSX.Element;
+```
+
+#### 参数
+
+- `props`
+
+```ts
+ViewProps & { type?: "single" | "multiple"; value?: string | string[]; defaultValue?: string | string[]; disabled?: boolean; multiple?: boolean; onValueChange?: (value: string | string[]) => void; }
+```
+说明：组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| type? | `"single" \| "multiple" \| undefined` | 展开模式：single 仅展开一项、multiple 可展开多项，默认 single；multiple 为 true 时强制多项展开。 |
+| value? | `string \| string[] \| undefined` | 受控展开项的标识；字符串表示单项，数组表示多项。传入后需在 onValueChange 中同步，省略时由内部状态管理。 |
+| defaultValue? | `string \| string[] \| undefined` | 非受控模式的初始展开项；默认全部收起，字符串表示单项、数组表示多项。仅初始化时读取，传入 value 后不生效。 |
+| disabled? | `boolean \| undefined` | 是否禁止整组切换，默认 false；禁用后各项不能通过内部操作改变选中状态。 |
+| multiple? | `boolean \| undefined` | 多选快捷开关，默认 false；为 true 时优先于 type，允许同时选中多项。 |
+| onValueChange? | `((value: string \| string[]) => void) \| undefined` | 用户展开或收起项目时调用；单项模式返回字符串（全部收起为空字符串），多项模式返回字符串数组（全部收起为空数组）。 |
+
+<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/accordion/AccordionContent.md

@@ -0,0 +1,100 @@
+# AccordionContent
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/accordion`
+源码：[src/ui/accordion.tsx](../../../../../src/ui/accordion.tsx)（安装包内保留）
+
+#### 说明
+
+手风琴折叠面板内容容器。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Accordion, AccordionItem, AccordionContent } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+<Accordion><AccordionItem value="details"><AccordionContent /></AccordionItem></Accordion>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：手风琴折叠面板内容容器。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function AccordionContent(props: ViewProps): React.JSX.Element | null;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| 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 | null`

package/dist/reference/sdk-api/ui/accordion/AccordionItem.md

@@ -0,0 +1,107 @@
+# AccordionItem
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/accordion`
+源码：[src/ui/accordion.tsx](../../../../../src/ui/accordion.tsx)（安装包内保留）
+
+#### 说明
+
+手风琴折叠面板条目。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Accordion, AccordionItem } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+<Accordion><AccordionItem value="details"><AccordionItem value="details" /></AccordionItem></Accordion>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：手风琴折叠面板条目。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function AccordionItem(props: ViewProps & { value: string; disabled?: boolean; }): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps & { value: string; disabled?: boolean; }` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| value | `string` | 当前项目的唯一标识；必须与父组件的 value/defaultValue 对应，不同项目使用不同值。 |
+| disabled? | `boolean \| undefined` | 是否禁用当前项目，默认 false；禁用后不执行内部切换。父组件禁用时此项也不可操作。 |
+
+<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/accordion/AccordionTrigger.md

@@ -0,0 +1,100 @@
+# AccordionTrigger
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/accordion`
+源码：[src/ui/accordion.tsx](../../../../../src/ui/accordion.tsx)（安装包内保留）
+
+#### 说明
+
+手风琴折叠面板触发器。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Accordion, AccordionItem, AccordionTrigger } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+<Accordion><AccordionItem value="details"><AccordionTrigger /></AccordionItem></Accordion>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：手风琴折叠面板触发器。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function AccordionTrigger(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/accordion/index.md

@@ -0,0 +1,12 @@
+# ui/accordion
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/accordion`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `Accordion` | 手风琴折叠面板组件。 | [查看](./Accordion.md) |
+| `AccordionContent` | 手风琴折叠面板内容容器。 | [查看](./AccordionContent.md) |
+| `AccordionItem` | 手风琴折叠面板条目。 | [查看](./AccordionItem.md) |
+| `AccordionTrigger` | 手风琴折叠面板触发器。 | [查看](./AccordionTrigger.md) |