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

package/dist/reference/sdk-api/ui/carousel/CarouselNext.md

@@ -0,0 +1,219 @@
+# CarouselNext
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/carousel`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/carousel.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+轮播下一项按钮。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Carousel, CarouselNext } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+<Carousel><CarouselNext /></Carousel>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：轮播下一项按钮。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function CarouselNext(props: ViewProps & VariantProps<(props?: (ConfigVariants<{ variant: { default: string; outline: string; secondary: string; ghost: string; destructive: string; link: string; }; size: { default: string; xs: string; sm: string; lg: string; icon: string; "icon-xs": string; "icon-sm": string; "icon-lg": string; }; }> & ClassProp) | undefined) => string> & Omit<ButtonProps, TaroButtonNativeKeys> & DouyinButtonExtras & { disabled?: boolean; }): React.JSX.Element;
+```
+
+#### 参数
+
+- `props`
+
+```ts
+ViewProps & VariantProps<(props?: (ConfigVariants<{ variant: { default: string;
+  outline: string;
+  secondary: string;
+  ghost: string;
+  destructive: string;
+  link: string; };
+  size: { default: string;
+  xs: string;
+  sm: string;
+  lg: string;
+  icon: string; "icon-xs": string; "icon-sm": string; "icon-lg": string; }; }> & ClassProp) | undefined) => string> & Omit<ButtonProps, TaroButtonNativeKeys> & DouyinButtonExtras & { disabled?: boolean; }
+```
+说明：组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| variant? | `"default" \| "link" \| "outline" \| "secondary" \| "ghost" \| "destructive" \| null \| undefined` | 按钮外观，默认 outline；其余变体同 Button.variant。 |
+| size? | `"default" \| "xs" \| "sm" \| "lg" \| "icon" \| "icon-xs" \| "icon-sm" \| "icon-lg" \| null \| undefined` | 按钮尺寸，默认 icon-sm（size-7）；可按 Button.size 选择其他尺寸。 |
+| disabled? | `boolean \| undefined` | 沿用 Button 的原生属性；普通 View 分支不保证阻止点击。边界状态由轮播组件自身的 canScrollPrev/canScrollNext 样式控制。 |
+| dataVideoId? | `string \| undefined` | navigateToVideoView 的视频标识；优先于 data-video-id，同时注入两种拼写给原生按钮。其他 openType 仅透传。 |
+| dataVideoType? | `string \| undefined` | 视频类型；优先于 data-video-type。navigateToVideoView 场景省略时为 "raw"，其他场景不设置默认值。 |
+| dataChannel? | `string \| undefined` | 原生视频能力的渠道参数；优先于 data-channel，未提供时不注入。不控制 SDK 网络通道。 |
+| data-video-id? | `string \| undefined` | dataVideoId 的兼容写法；两者都提供时以 dataVideoId 为准。 |
+| data-video-type? | `string \| undefined` | dataVideoType 的兼容写法；两者都提供时以 dataVideoType 为准。 |
+| data-channel? | `string \| undefined` | dataChannel 的兼容写法；两者都提供时以 dataChannel 为准。 |
+| onNavigateToVideoView? | `(((event: DouyinOpenTypeDetailEvent) => void) & ((event: OpenTypeDetailEvent) => void)) \| undefined` | 仅在原生 navigateToVideoView 能力分支中透传的结果回调；event.detail 可缺省，不代表业务点击回调。 |
+| onAddShortcut? | `(((event: DouyinOpenTypeDetailEvent) => void) & ((event: OpenTypeDetailEvent) => void)) \| undefined` | 仅在原生 addShortcut 能力分支中透传的结果回调；结果从 event.detail 读取，普通 View 按钮不会主动调用。 |
+
+- `openType?`
+
+```ts
+"contact" | "share" | "getPhoneNumber" | "getRealtimePhoneNumber" | "getUserInfo" | "launchApp" | "openSetting" | "feedback" | "chooseAvatar" | "agreePrivacyAuthorization" | "getPhoneNumber|agreePrivacyAuthorization" | "getRealtimePhoneNumber|agreePrivacyAuthorization" | "getUserInfo|agreePrivacyAuthorization" | "getAuthorize" | "contactShare" | "lifestyle" | "openGroupProfile" | "addFriend" | "addColorSign" | "openPublicProfile" | "addGroupApp" | "shareMessageToFriend" | "im" | "platformIm" | "navigateToVideoView" | "openAwemeUserProfile" | "openWebcastRoom" | "addCalendarEvent" | "addShortcut" | "joinGroup" | "privateMessage" | "authorizePrivateMessage" | "liveActivity" | "getPhoneNumberAndRiskLevel" | undefined
+```
+说明：抖音原生按钮能力类型；非空时改用 Taro Button 并透传该值，否则渲染 View。可用值和授权要求以目标平台能力为准。
+
+###### onNavigateToVideoView 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| event | `OpenTypeDetailEvent` |  |
+
+###### onNavigateToVideoView.event 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| detail? | `{ errMsg?: string; errNo?: number; } \| undefined` | 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 |
+
+###### onNavigateToVideoView.event.detail 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg? | `string \| undefined` | 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 |
+| errNo? | `number \| undefined` | 平台提供的数值结果码；可缺省，含义以所用原生能力的契约为准。 |
+
+###### onAddShortcut 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| event | `OpenTypeDetailEvent` |  |
+
+###### onAddShortcut.event 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| detail? | `{ errMsg?: string; errNo?: number; } \| undefined` | 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 |
+
+###### onAddShortcut.event.detail 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg? | `string \| undefined` | 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 |
+| errNo? | `number \| 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 设备，重按时会触发 |
+| onError? | `CommonEventFunction \| undefined` | 当使用开放能力时，发生错误的回调 生效时机：`open-type="launchApp"` |
+| plain? | `boolean \| undefined` | 按钮是否镂空，背景色透明 |
+| loading? | `boolean \| undefined` | 名称前是否带 loading 图标 |
+| formType? | `keyof ButtonProps.FormType \| undefined` | 用于 `<form/>` 组件，点击分别会触发 `<form/>` 组件的 submit/reset 事件 |
+| lang? | `keyof ButtonProps.Lang \| undefined` | 指定返回用户信息的语言，zh_CN 简体中文，zh_TW 繁体中文，en 英文。 生效时机: `open-type="getUserInfo"` |
+| sessionFrom? | `string \| undefined` | 会话来源 生效时机：`open-type="contact"` |
+| sendMessageTitle? | `string \| undefined` | 会话内消息卡片标题 生效时机：`open-type="contact"` |
+| sendMessagePath? | `string \| undefined` | 会话内消息卡片点击跳转小程序路径 生效时机：`open-type="contact"` |
+| sendMessageImg? | `string \| undefined` | 会话内消息卡片图片 生效时机：`open-type="contact"` |
+| appParameter? | `string \| undefined` | 打开 APP 时，向 APP 传递的参数 生效时机：`open-type="launchApp"` |
+| scope? | `"userInfo" \| "phoneNumber" \| undefined` | 支付宝小程序 scope 生效时机：`open-type="getAuthorize"` |
+| showMessageCard? | `boolean \| undefined` | 显示会话内消息卡片 生效时机：`open-type="contact"` |
+| publicId? | `string \| undefined` | 生活号 id，必须是当前小程序同主体且已关联的生活号，open-type="lifestyle" 时有效。 |
+| templateId? | `string \| string[] \| undefined` | 发送订阅类模板消息所用的模板库标题 ID ，可通过 getTemplateLibraryList 获取 当参数类型为 Array 时，可传递 1~3 个模板库标题 ID |
+| subscribeId? | `string \| undefined` | 发送订阅类模板消息时所使用的唯一标识符，内容由开发者自定义，用来标识订阅场景 注意：同一用户在同一 subscribe-id 下的多次授权不累积下发权限，只能下发一条。若要订阅多条，需要不同 subscribe-id |
+| groupId? | `string \| undefined` | 群聊 id |
+| guildId? | `string \| undefined` | 打开频道页面时，传递的频道号 |
+| shareType? | `string \| undefined` | 分享类型集合，请参考下面share-type有效值说明。share-type后续将不再维护，请更新为share-mode |
+| shareMode? | `string \| undefined` | 分享类型集合，请参考下面share-mode有效值说明 |
+| openId? | `string \| undefined` | 添加好友时，对方的 openid |
+| shareMessageFriendInfo? | `string \| undefined` | 发送对象的 FriendInfo |
+| shareMessageTitle? | `string \| undefined` | 转发标题，不传则默认使用当前小程序的昵称。 FriendInfo |
+| shareMessageImg? | `string \| undefined` | 转发显示图片的链接，可以是网络图片路径（仅 QQ CDN 域名路径）或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4FriendInfo |
+| dataAwemeId? | `string \| undefined` | 跳转抖音号个人页，只支持小程序绑定的品牌号、员工号、合作号 |
+| dataIsHalfPage? | `boolean \| undefined` | 是否开启半屏模式 |
+| onGetUserInfo? | `CommonEventFunction<ButtonProps.onGetUserInfoEventDetail> \| undefined` | 用户点击该按钮时，会返回获取到的用户信息，回调的detail数据与 Taro.getUserInfo 返回的一致 生效时机: `open-type="getUserInfo"` |
+| onGetAuthorize? | `CommonEventFunction \| undefined` | 支付宝获取会员基础信息授权回调 生效时机：`open-type="getAuthorize"` |
+| onContact? | `CommonEventFunction<ButtonProps.onContactEventDetail> \| undefined` | 客服消息回调 生效时机：`open-type="contact"` |
+| onGetPhoneNumber? | `CommonEventFunction<ButtonProps.onGetPhoneNumberEventDetail> \| undefined` | 获取用户手机号回调 生效时机：`open-type="getPhoneNumber"` |
+| onGetPhoneNumberAndRiskLevel? | `CommonEventFunction<ButtonProps.onGetPhoneNumberAndRiskLevelEventDetail> \| undefined` | 获取手机号和风险等级的回调 生效时机：`open-type="getPhoneNumberAndRiskLevel"` |
+| onGetRealTimePhoneNumber? | `CommonEventFunction<ButtonProps.onGetRealTimePhoneNumberEventDetail> \| undefined` | 手机号实时验证回调，`open-type="getRealtimePhoneNumber"` 时有效 |
+| onOpenSetting? | `CommonEventFunction<ButtonProps.onOpenSettingEventDetail> \| undefined` | 在打开授权设置页后回调 生效时机：`open-type="openSetting"` |
+| onLaunchApp? | `CommonEventFunction \| undefined` | 打开 APP 成功的回调 生效时机：`open-type="launchApp"` |
+| onChooseAvatar? | `CommonEventFunction \| undefined` | 获取用户头像回调 生效时机：`open-type="chooseAvatar"` |
+| onAgreePrivacyAuthorization? | `CommonEventFunction \| undefined` | 用户同意隐私协议事件回调，`open-type="agreePrivacyAuthorization"`时有效 |
+| onFollowLifestyle? | `CommonEventFunction<{ followStatus: 1 \| 2 \| 3 \| true; }> \| undefined` | 当 open-type 为 lifestyle 时有效。 当点击按钮时触发。 event.detail = { followStatus }，followStatus 合法值有 1、2、3，其中 1 表示已关注。2 表示用户不允许关注。3 表示发生未知错误； 已知问题：基础库 1.0，当用户在点击按钮前已关注生活号，event.detail.followStatus 的值为 true。 |
+| onChooseAddress? | `CommonEventFunction \| undefined` | 用户点击该按钮时，调起用户编辑收货地址原生界面，并在编辑完成后返回用户选择的地址，从返回参数的 detail 中获取，和 swan.chooseAddress 一样的。和 open-type 搭配使用，使用时机：open-type="chooseAddress" |
+| onChooseInvoiceTitle? | `CommonEventFunction \| undefined` | 用户点击该按钮时，选择用户的发票抬头，和 swan.chooseInvoiceTitle 一样的。和 open-type 搭配使用，使用时机：open-type="chooseInvoiceTitle" |
+| onLogin? | `CommonEventFunction \| undefined` | 登录回调，和 open-type 搭配使用，使用时机：open-type="login"。可以通过返回参数的 detail 判断是否登录成功，当 errMsg 为'login:ok'时即为成功。如想获取登录凭证请使用 swan.getLoginCode |
+| onSubscribe? | `CommonEventFunction \| undefined` | 订阅消息授权回调，和 open-type 搭配使用，使用时机：open-type="subscribe" |
+| onAddFriend? | `CommonEventFunction \| undefined` | 添加好友的回调 |
+| onAddGroupApp? | `CommonEventFunction \| undefined` | 添加群应用的回调。errCode 错误码：41004（当前用户非管理员或群主，无权操作），41005（超过可添加群应用的群数量） |
+| onOpenAwemeUserProfile? | `CommonEventFunction \| undefined` | 监听跳转抖音号个人页的回调 生效时机：`open-type="openAwemeUserProfile"` |
+| onJoinGroup? | `CommonEventFunction<{ errMsg: string; errNo: number; }> \| undefined` | 加群后触发 |
+| hideBorder? | `boolean \| undefined` |  |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/carousel/CarouselPrevious.md

@@ -0,0 +1,219 @@
+# CarouselPrevious
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/carousel`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/carousel.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+轮播上一项按钮。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Carousel, CarouselPrevious } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+<Carousel><CarouselPrevious /></Carousel>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：轮播上一项按钮。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function CarouselPrevious(props: ViewProps & VariantProps<(props?: (ConfigVariants<{ variant: { default: string; outline: string; secondary: string; ghost: string; destructive: string; link: string; }; size: { default: string; xs: string; sm: string; lg: string; icon: string; "icon-xs": string; "icon-sm": string; "icon-lg": string; }; }> & ClassProp) | undefined) => string> & Omit<ButtonProps, TaroButtonNativeKeys> & DouyinButtonExtras & { disabled?: boolean; }): React.JSX.Element;
+```
+
+#### 参数
+
+- `props`
+
+```ts
+ViewProps & VariantProps<(props?: (ConfigVariants<{ variant: { default: string;
+  outline: string;
+  secondary: string;
+  ghost: string;
+  destructive: string;
+  link: string; };
+  size: { default: string;
+  xs: string;
+  sm: string;
+  lg: string;
+  icon: string; "icon-xs": string; "icon-sm": string; "icon-lg": string; }; }> & ClassProp) | undefined) => string> & Omit<ButtonProps, TaroButtonNativeKeys> & DouyinButtonExtras & { disabled?: boolean; }
+```
+说明：组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| variant? | `"default" \| "link" \| "outline" \| "secondary" \| "ghost" \| "destructive" \| null \| undefined` | 按钮外观，默认 outline；其余变体同 Button.variant。 |
+| size? | `"default" \| "xs" \| "sm" \| "lg" \| "icon" \| "icon-xs" \| "icon-sm" \| "icon-lg" \| null \| undefined` | 按钮尺寸，默认 icon-sm（size-7）；可按 Button.size 选择其他尺寸。 |
+| disabled? | `boolean \| undefined` | 沿用 Button 的原生属性；普通 View 分支不保证阻止点击。边界状态由轮播组件自身的 canScrollPrev/canScrollNext 样式控制。 |
+| dataVideoId? | `string \| undefined` | navigateToVideoView 的视频标识；优先于 data-video-id，同时注入两种拼写给原生按钮。其他 openType 仅透传。 |
+| dataVideoType? | `string \| undefined` | 视频类型；优先于 data-video-type。navigateToVideoView 场景省略时为 "raw"，其他场景不设置默认值。 |
+| dataChannel? | `string \| undefined` | 原生视频能力的渠道参数；优先于 data-channel，未提供时不注入。不控制 SDK 网络通道。 |
+| data-video-id? | `string \| undefined` | dataVideoId 的兼容写法；两者都提供时以 dataVideoId 为准。 |
+| data-video-type? | `string \| undefined` | dataVideoType 的兼容写法；两者都提供时以 dataVideoType 为准。 |
+| data-channel? | `string \| undefined` | dataChannel 的兼容写法；两者都提供时以 dataChannel 为准。 |
+| onNavigateToVideoView? | `(((event: DouyinOpenTypeDetailEvent) => void) & ((event: OpenTypeDetailEvent) => void)) \| undefined` | 仅在原生 navigateToVideoView 能力分支中透传的结果回调；event.detail 可缺省，不代表业务点击回调。 |
+| onAddShortcut? | `(((event: DouyinOpenTypeDetailEvent) => void) & ((event: OpenTypeDetailEvent) => void)) \| undefined` | 仅在原生 addShortcut 能力分支中透传的结果回调；结果从 event.detail 读取，普通 View 按钮不会主动调用。 |
+
+- `openType?`
+
+```ts
+"contact" | "share" | "getPhoneNumber" | "getRealtimePhoneNumber" | "getUserInfo" | "launchApp" | "openSetting" | "feedback" | "chooseAvatar" | "agreePrivacyAuthorization" | "getPhoneNumber|agreePrivacyAuthorization" | "getRealtimePhoneNumber|agreePrivacyAuthorization" | "getUserInfo|agreePrivacyAuthorization" | "getAuthorize" | "contactShare" | "lifestyle" | "openGroupProfile" | "addFriend" | "addColorSign" | "openPublicProfile" | "addGroupApp" | "shareMessageToFriend" | "im" | "platformIm" | "navigateToVideoView" | "openAwemeUserProfile" | "openWebcastRoom" | "addCalendarEvent" | "addShortcut" | "joinGroup" | "privateMessage" | "authorizePrivateMessage" | "liveActivity" | "getPhoneNumberAndRiskLevel" | undefined
+```
+说明：抖音原生按钮能力类型；非空时改用 Taro Button 并透传该值，否则渲染 View。可用值和授权要求以目标平台能力为准。
+
+###### onNavigateToVideoView 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| event | `OpenTypeDetailEvent` |  |
+
+###### onNavigateToVideoView.event 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| detail? | `{ errMsg?: string; errNo?: number; } \| undefined` | 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 |
+
+###### onNavigateToVideoView.event.detail 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg? | `string \| undefined` | 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 |
+| errNo? | `number \| undefined` | 平台提供的数值结果码；可缺省，含义以所用原生能力的契约为准。 |
+
+###### onAddShortcut 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| event | `OpenTypeDetailEvent` |  |
+
+###### onAddShortcut.event 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| detail? | `{ errMsg?: string; errNo?: number; } \| undefined` | 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 |
+
+###### onAddShortcut.event.detail 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg? | `string \| undefined` | 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 |
+| errNo? | `number \| 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 设备，重按时会触发 |
+| onError? | `CommonEventFunction \| undefined` | 当使用开放能力时，发生错误的回调 生效时机：`open-type="launchApp"` |
+| plain? | `boolean \| undefined` | 按钮是否镂空，背景色透明 |
+| loading? | `boolean \| undefined` | 名称前是否带 loading 图标 |
+| formType? | `keyof ButtonProps.FormType \| undefined` | 用于 `<form/>` 组件，点击分别会触发 `<form/>` 组件的 submit/reset 事件 |
+| lang? | `keyof ButtonProps.Lang \| undefined` | 指定返回用户信息的语言，zh_CN 简体中文，zh_TW 繁体中文，en 英文。 生效时机: `open-type="getUserInfo"` |
+| sessionFrom? | `string \| undefined` | 会话来源 生效时机：`open-type="contact"` |
+| sendMessageTitle? | `string \| undefined` | 会话内消息卡片标题 生效时机：`open-type="contact"` |
+| sendMessagePath? | `string \| undefined` | 会话内消息卡片点击跳转小程序路径 生效时机：`open-type="contact"` |
+| sendMessageImg? | `string \| undefined` | 会话内消息卡片图片 生效时机：`open-type="contact"` |
+| appParameter? | `string \| undefined` | 打开 APP 时，向 APP 传递的参数 生效时机：`open-type="launchApp"` |
+| scope? | `"userInfo" \| "phoneNumber" \| undefined` | 支付宝小程序 scope 生效时机：`open-type="getAuthorize"` |
+| showMessageCard? | `boolean \| undefined` | 显示会话内消息卡片 生效时机：`open-type="contact"` |
+| publicId? | `string \| undefined` | 生活号 id，必须是当前小程序同主体且已关联的生活号，open-type="lifestyle" 时有效。 |
+| templateId? | `string \| string[] \| undefined` | 发送订阅类模板消息所用的模板库标题 ID ，可通过 getTemplateLibraryList 获取 当参数类型为 Array 时，可传递 1~3 个模板库标题 ID |
+| subscribeId? | `string \| undefined` | 发送订阅类模板消息时所使用的唯一标识符，内容由开发者自定义，用来标识订阅场景 注意：同一用户在同一 subscribe-id 下的多次授权不累积下发权限，只能下发一条。若要订阅多条，需要不同 subscribe-id |
+| groupId? | `string \| undefined` | 群聊 id |
+| guildId? | `string \| undefined` | 打开频道页面时，传递的频道号 |
+| shareType? | `string \| undefined` | 分享类型集合，请参考下面share-type有效值说明。share-type后续将不再维护，请更新为share-mode |
+| shareMode? | `string \| undefined` | 分享类型集合，请参考下面share-mode有效值说明 |
+| openId? | `string \| undefined` | 添加好友时，对方的 openid |
+| shareMessageFriendInfo? | `string \| undefined` | 发送对象的 FriendInfo |
+| shareMessageTitle? | `string \| undefined` | 转发标题，不传则默认使用当前小程序的昵称。 FriendInfo |
+| shareMessageImg? | `string \| undefined` | 转发显示图片的链接，可以是网络图片路径（仅 QQ CDN 域名路径）或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4FriendInfo |
+| dataAwemeId? | `string \| undefined` | 跳转抖音号个人页，只支持小程序绑定的品牌号、员工号、合作号 |
+| dataIsHalfPage? | `boolean \| undefined` | 是否开启半屏模式 |
+| onGetUserInfo? | `CommonEventFunction<ButtonProps.onGetUserInfoEventDetail> \| undefined` | 用户点击该按钮时，会返回获取到的用户信息，回调的detail数据与 Taro.getUserInfo 返回的一致 生效时机: `open-type="getUserInfo"` |
+| onGetAuthorize? | `CommonEventFunction \| undefined` | 支付宝获取会员基础信息授权回调 生效时机：`open-type="getAuthorize"` |
+| onContact? | `CommonEventFunction<ButtonProps.onContactEventDetail> \| undefined` | 客服消息回调 生效时机：`open-type="contact"` |
+| onGetPhoneNumber? | `CommonEventFunction<ButtonProps.onGetPhoneNumberEventDetail> \| undefined` | 获取用户手机号回调 生效时机：`open-type="getPhoneNumber"` |
+| onGetPhoneNumberAndRiskLevel? | `CommonEventFunction<ButtonProps.onGetPhoneNumberAndRiskLevelEventDetail> \| undefined` | 获取手机号和风险等级的回调 生效时机：`open-type="getPhoneNumberAndRiskLevel"` |
+| onGetRealTimePhoneNumber? | `CommonEventFunction<ButtonProps.onGetRealTimePhoneNumberEventDetail> \| undefined` | 手机号实时验证回调，`open-type="getRealtimePhoneNumber"` 时有效 |
+| onOpenSetting? | `CommonEventFunction<ButtonProps.onOpenSettingEventDetail> \| undefined` | 在打开授权设置页后回调 生效时机：`open-type="openSetting"` |
+| onLaunchApp? | `CommonEventFunction \| undefined` | 打开 APP 成功的回调 生效时机：`open-type="launchApp"` |
+| onChooseAvatar? | `CommonEventFunction \| undefined` | 获取用户头像回调 生效时机：`open-type="chooseAvatar"` |
+| onAgreePrivacyAuthorization? | `CommonEventFunction \| undefined` | 用户同意隐私协议事件回调，`open-type="agreePrivacyAuthorization"`时有效 |
+| onFollowLifestyle? | `CommonEventFunction<{ followStatus: 1 \| 2 \| 3 \| true; }> \| undefined` | 当 open-type 为 lifestyle 时有效。 当点击按钮时触发。 event.detail = { followStatus }，followStatus 合法值有 1、2、3，其中 1 表示已关注。2 表示用户不允许关注。3 表示发生未知错误； 已知问题：基础库 1.0，当用户在点击按钮前已关注生活号，event.detail.followStatus 的值为 true。 |
+| onChooseAddress? | `CommonEventFunction \| undefined` | 用户点击该按钮时，调起用户编辑收货地址原生界面，并在编辑完成后返回用户选择的地址，从返回参数的 detail 中获取，和 swan.chooseAddress 一样的。和 open-type 搭配使用，使用时机：open-type="chooseAddress" |
+| onChooseInvoiceTitle? | `CommonEventFunction \| undefined` | 用户点击该按钮时，选择用户的发票抬头，和 swan.chooseInvoiceTitle 一样的。和 open-type 搭配使用，使用时机：open-type="chooseInvoiceTitle" |
+| onLogin? | `CommonEventFunction \| undefined` | 登录回调，和 open-type 搭配使用，使用时机：open-type="login"。可以通过返回参数的 detail 判断是否登录成功，当 errMsg 为'login:ok'时即为成功。如想获取登录凭证请使用 swan.getLoginCode |
+| onSubscribe? | `CommonEventFunction \| undefined` | 订阅消息授权回调，和 open-type 搭配使用，使用时机：open-type="subscribe" |
+| onAddFriend? | `CommonEventFunction \| undefined` | 添加好友的回调 |
+| onAddGroupApp? | `CommonEventFunction \| undefined` | 添加群应用的回调。errCode 错误码：41004（当前用户非管理员或群主，无权操作），41005（超过可添加群应用的群数量） |
+| onOpenAwemeUserProfile? | `CommonEventFunction \| undefined` | 监听跳转抖音号个人页的回调 生效时机：`open-type="openAwemeUserProfile"` |
+| onJoinGroup? | `CommonEventFunction<{ errMsg: string; errNo: number; }> \| undefined` | 加群后触发 |
+| hideBorder? | `boolean \| undefined` |  |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/carousel/index.md

@@ -0,0 +1,14 @@
+# ui/carousel
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/carousel`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `Carousel` | 轮播组件。 | [查看](./Carousel.md) |
+| `CarouselContent` | 轮播内容容器。 | [查看](./CarouselContent.md) |
+| `CarouselItem` | 轮播条目。 | [查看](./CarouselItem.md) |
+| `CarouselNext` | 轮播下一项按钮。 | [查看](./CarouselNext.md) |
+| `CarouselPrevious` | 轮播上一项按钮。 | [查看](./CarouselPrevious.md) |
+| `useCarousel` | 读取最近的 Carousel 上下文，包括当前位置、总数和前后翻页方法。 | [查看](./useCarousel.md) |

package/dist/reference/sdk-api/ui/carousel/useCarousel.md

@@ -0,0 +1,46 @@
+# useCarousel
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/carousel`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/carousel.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+读取最近的 Carousel 上下文，包括当前位置、总数和前后翻页方法。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `无参数` | — |
+
+返回：当前上下文或锚点引用。
+
+备注：必须在 Carousel 的后代组件中调用；缺少上下文时会抛错。
+
+示例：
+
+```tsx
+import { useCarousel, CarouselNext } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+function Controls() { const carousel = useCarousel(); return <CarouselNext disabled={!carousel.canScrollNext} /> }
+// Controls 必须渲染在 Carousel 内。
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：读取最近的 Carousel 上下文，包括当前位置、总数和前后翻页方法。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。必须在 Carousel 的后代组件中调用；缺少上下文时会抛错。 |
+
+#### 声明
+
+```ts
+declare function useCarousel(): CarouselContextProps;
+```
+
+#### 返回值
+
+- 类型：`CarouselContextProps`

package/dist/reference/sdk-api/ui/checkbox/Checkbox.md

@@ -0,0 +1,109 @@
+# Checkbox
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/checkbox`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/checkbox.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+复选框组件。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Checkbox } from '@open-dy/vibecoding-sdk-taro/ui/checkbox'
+<Checkbox />
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：复选框组件。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function Checkbox(props: ViewProps & { checked?: boolean; defaultChecked?: boolean; onCheckedChange?: (checked: boolean) => void; disabled?: boolean; }): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps & { checked?: boolean; defaultChecked?: boolean; onCheckedChange?: (checked: boolean) => void; disabled?: boolean; }` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| checked? | `boolean \| undefined` | 受控选中状态；传入后以该值为准，需在 onCheckedChange 中更新。省略时由内部状态管理。 |
+| defaultChecked? | `boolean \| undefined` | 非受控模式的初始选中状态，默认 false；仅初始化时读取，传入 checked 后不生效。 |
+| onCheckedChange? | `((checked: boolean) => void) \| undefined` | 用户点击切换时调用，参数为下一选中状态；禁用时不触发，受控模式需同步 checked。 |
+| disabled? | `boolean \| undefined` | 是否禁止用户切换；省略或 false 时可操作，true 时不触发内部切换回调。 |
+
+<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/checkbox/index.md

@@ -0,0 +1,9 @@
+# ui/checkbox
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/checkbox`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `Checkbox` | 复选框组件。 | [查看](./Checkbox.md) |