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

package/dist/reference/sdk-api/ui/input-group/InputGroupButton.md

@@ -0,0 +1,220 @@
+# InputGroupButton
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/input-group`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/input-group.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+输入组合操作按钮。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { InputGroup, InputGroupButton } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+<InputGroup><InputGroupButton /></InputGroup>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：输入组合操作按钮。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function InputGroupButton(props: Omit<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, "size"> & VariantProps<(props?: (ConfigVariants<{ size: { xs: string; sm: string; "icon-xs": string; "icon-sm": string; }; }> & ClassProp) | undefined) => string>): React.JSX.Element;
+```
+
+#### 参数
+
+- `props`
+
+```ts
+Omit<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, "size"> & VariantProps<(props?: (ConfigVariants<{ size: { xs: string;
+  sm: string; "icon-xs": string; "icon-sm": string; }; }> & ClassProp) | undefined) => string>
+```
+说明：组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| variant? | `"default" \| "link" \| "outline" \| "secondary" \| "ghost" \| "destructive" \| null \| undefined` | 按钮外观，默认 ghost；其余变体同 Button.variant。 |
+| 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 按钮不会主动调用。 |
+| size? | `"xs" \| "sm" \| "icon-xs" \| "icon-sm" \| null \| undefined` | 输入组按钮尺寸，默认 xs；xs 为 h-6，sm 不额外缩小底层默认按钮，icon-xs 为 size-6，icon-sm 为 size-8。 |
+
+- `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>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| 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 设备，重按时会触发 |
+| onError? | `CommonEventFunction \| undefined` | 当使用开放能力时，发生错误的回调 生效时机：`open-type="launchApp"` |
+| 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 事件 |
+| plain? | `boolean \| undefined` | 按钮是否镂空，背景色透明 |
+| disabled? | `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/input-group/InputGroupInput.md

@@ -0,0 +1,135 @@
+# InputGroupInput
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/input-group`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/input-group.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+输入组合输入区域。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { InputGroup, InputGroupInput } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+<InputGroup><InputGroupInput /></InputGroup>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：输入组合输入区域。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function InputGroupInput(props: Omit<InputProps, "ref">): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `Omit<InputProps, "ref">` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| className? | `string \| undefined` | 附加到内部原生 Input 的类名；外层布局和横向内边距由 InputGroup 组合状态控制。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| name? | `string \| undefined` | 组件名字，用于表单提交获取数据。 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| hidden? | `boolean \| undefined` | 组件是否显示, 所有组件默认显示 |
+| animation? | `TaroGeneral.IAnyObject \| { actions: TaroGeneral.IAnyObject[]; } \| undefined` | 动画属性 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onTouchStart? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作开始 |
+| onTouchMove? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后移动 |
+| onTouchCancel? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作被打断，如来电提醒，弹窗 |
+| onTouchEnd? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作结束 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTransitionEnd? | `((event: CommonEvent) => void) \| undefined` | 会在 WXSS transition 或 Taro.createAnimation 动画结束后触发 |
+| onAnimationStart? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画开始时触发 |
+| onAnimationIteration? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 一次迭代结束时触发 |
+| onAnimationEnd? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画完成时触发 |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| nativeProps? | `Record<string, unknown> \| undefined` | 用于透传 `WebComponents` 上的属性到内部 H5 标签上 |
+| type? | `keyof InputProps.Type \| undefined` | input 的类型 |
+| disabled? | `boolean \| undefined` | 是否禁用 |
+| value? | `string \| undefined` | 输入框的初始内容 |
+| defaultValue? | `string \| undefined` | 设置 React 非受控输入框的初始内容 |
+| password? | `boolean \| undefined` | 是否是密码类型 |
+| placeholder? | `string \| undefined` | 输入框为空时占位符 |
+| placeholderStyle? | `string \| undefined` | 指定 placeholder 的样式 |
+| placeholderClass? | `string \| undefined` | 指定 placeholder 的样式类 |
+| placeholderTextColor? | `string \| undefined` | 指定 placeholder 的文本颜色 |
+| maxlength? | `number \| undefined` | 最大输入长度，设置为 -1 的时候不限制最大长度 |
+| cursorSpacing? | `number \| undefined` | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
+| autoFocus? | `boolean \| undefined` | (即将废弃，请直接使用 focus )自动聚焦，拉起键盘 |
+| focus? | `boolean \| undefined` | 获取焦点 |
+| confirmType? | `keyof InputProps.ConfirmType \| undefined` | 设置键盘右下角按钮的文字，仅在type='text'时生效 |
+| confirmHold? | `boolean \| undefined` | 点击键盘右下角按钮时是否保持键盘不收起 |
+| cursor? | `number \| undefined` | 指定focus时的光标位置 |
+| cursorColor? | `string \| undefined` | 光标颜色。iOS 下的格式为十六进制颜色值 #000000，安卓下的只支持 default 和 green，Skyline 下无限制 |
+| selectionStart? | `number \| undefined` | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
+| selectionEnd? | `number \| undefined` | 光标结束位置，自动聚集时有效，需与selection-start搭配使用 |
+| adjustPosition? | `boolean \| undefined` | 键盘弹起时，是否自动上推页面 |
+| holdKeyboard? | `boolean \| undefined` | focus 时，点击页面的时候不收起键盘 |
+| alwaysEmbed? | `boolean \| undefined` | 强制 input 处于同层状态，默认 focus 时 input 会切到非同层状态 (仅在 iOS 下生效) |
+| safePasswordCertPath? | `string \| undefined` | 安全键盘加密公钥的路径，只支持包内路径 |
+| safePasswordLength? | `number \| undefined` | 安全键盘输入密码长度 |
+| safePasswordTimeStamp? | `number \| undefined` | 安全键盘加密时间戳 |
+| safePasswordNonce? | `string \| undefined` | 安全键盘加密盐值 |
+| safePasswordSalt? | `string \| undefined` | 安全键盘计算hash盐值，若指定custom-hash 则无效 |
+| safePasswordCustomHash? | `string \| undefined` | 安全键盘计算hash的算法表达式，如 `md5(sha1('foo' + sha256(sm3(password + 'bar'))))` |
+| randomNumber? | `boolean \| undefined` | 当 type 为 number, digit, idcard 数字键盘是否随机排列 |
+| controlled? | `boolean \| undefined` | 是否为受控组件。为 true 时，value 内容会完全受 setData 控制。 建议当 type 值为 text 时不要将 controlled 设置为 true,详见 [Bugs & Tips](https://opendocs.alipay.com/mini/component/input#Bug%20%26%20Tip) |
+| alwaysSystem? | `boolean \| undefined` | 是否强制使用系统键盘和 Web-view 创建的 input 元素。为 true 时，confirm-type、confirm-hold 可能失效。 |
+| clueType? | `number \| undefined` | 用于分发目的。取值：0 和 1，其中 0 表示默认，1 表示手机号，需要和留资分发配置一起使用，详情见留资分发配置。 |
+| onInput? | `CommonEventFunction<InputProps.inputEventDetail> \| undefined` | 当键盘输入时，触发input事件，event.detail = {value, cursor, keyCode}，处理函数可以直接 return 一个字符串，将替换输入框的内容。 |
+| onFocus? | `CommonEventFunction<InputProps.inputForceEventDetail> \| undefined` | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度 |
+| onBlur? | `CommonEventFunction<InputProps.inputValueEventDetail> \| undefined` | 输入框失去焦点时触发 |
+| onConfirm? | `CommonEventFunction<InputProps.inputValueEventDetail> \| undefined` | 点击完成按钮时触发 |
+| onKeyboardHeightChange? | `CommonEventFunction<InputProps.onKeyboardHeightChangeEventDetail> \| undefined` | 键盘高度发生变化的时候触发此事件 |
+| onNickNameReview? | `CommonEventFunction \| undefined` | 用户昵称审核完毕后触发，仅在 type 为 "nickname" 时有效，event.detail = { pass, timeout } |
+| onSelectionChange? | `CommonEventFunction \| undefined` | 选区改变事件, {selectionStart, selectionEnd} |
+| onKeyboardCompositionStart? | `CommonEventFunction \| undefined` | 输入法开始新的输入时触发 （仅当输入法支持时触发） |
+| onKeyboardCompositionUpdate? | `CommonEventFunction \| undefined` | 输入法输入字符时触发（仅当输入法支持时触发） |
+| onKeyboardCompositionEnd? | `CommonEventFunction \| undefined` | 输入法输入结束时触发（仅当输入法支持时触发） |
+| onKeyoardHeightChangeWorklet? | `string \| undefined` | 键盘高度变化时触发。event.detail = {height: height, pageBottomPadding: pageBottomPadding}； height: 键盘高度，pageBottomPadding: 页面上推高度 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/input-group/InputGroupText.md

@@ -0,0 +1,100 @@
+# InputGroupText
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/input-group`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/input-group.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+输入组合文本区域。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { InputGroup, InputGroupText } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+<InputGroup><InputGroupText /></InputGroup>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：输入组合文本区域。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function InputGroupText(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/input-group/InputGroupTextarea.md

@@ -0,0 +1,126 @@
+# InputGroupTextarea
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/input-group`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/input-group.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+输入组合多行输入区域。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { InputGroup, InputGroupTextarea } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+<InputGroup><InputGroupTextarea /></InputGroup>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：输入组合多行输入区域。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function InputGroupTextarea(props: Omit<TextareaProps, "ref">): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `Omit<TextareaProps, "ref">` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| className? | `string \| undefined` | 附加到原生 Textarea 的类名，用于覆写输入区尺寸和文字样式。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| name? | `string \| undefined` | 组件名字，用于表单提交获取数据。 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| children? | `React.ReactNode` | 子节点 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| hidden? | `boolean \| undefined` | 组件是否显示, 所有组件默认显示 |
+| animation? | `TaroGeneral.IAnyObject \| { actions: TaroGeneral.IAnyObject[]; } \| undefined` | 动画属性 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onTouchStart? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作开始 |
+| onTouchMove? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后移动 |
+| onTouchCancel? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作被打断，如来电提醒，弹窗 |
+| onTouchEnd? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作结束 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTransitionEnd? | `((event: CommonEvent) => void) \| undefined` | 会在 WXSS transition 或 Taro.createAnimation 动画结束后触发 |
+| onAnimationStart? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画开始时触发 |
+| onAnimationIteration? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 一次迭代结束时触发 |
+| onAnimationEnd? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画完成时触发 |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+| fixed? | `boolean \| undefined` | 如果 Textarea 是在一个 `position:fixed` 的区域，需要显示指定属性 fixed 为 true |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| nativeProps? | `Record<string, unknown> \| undefined` | 用于透传 `WebComponents` 上的属性到内部 H5 标签上 |
+| disabled? | `boolean \| undefined` | 是否禁用 |
+| value? | `string \| undefined` | 输入框的内容 |
+| defaultValue? | `string \| undefined` | 设置 React 非受控输入框的初始内容 |
+| placeholder? | `string \| undefined` | 输入框为空时占位符 |
+| placeholderStyle? | `string \| undefined` | 指定 placeholder 的样式 需传入对象，格式为 { fontSize: number, fontWeight: string, color: string } |
+| placeholderClass? | `string \| undefined` | 指定 placeholder 的样式类 |
+| maxlength? | `number \| undefined` | 最大输入长度，设置为 -1 的时候不限制最大长度 |
+| cursorSpacing? | `number \| undefined` | 指定光标与键盘的距离，单位 px 。取 Textarea 距离底部的距离和 cursorSpacing 指定的距离的最小值作为光标与键盘的距离 |
+| autoFocus? | `boolean \| undefined` | 自动聚焦，拉起键盘 |
+| focus? | `boolean \| undefined` | 获取焦点 |
+| confirmType? | `"search" \| "send" \| "next" \| "go" \| "done" \| "return" \| undefined` | 设置键盘右下角按钮的文字 |
+| confirmHold? | `boolean \| undefined` | 点击键盘右下角按钮时是否保持键盘不收起 |
+| cursor? | `number \| undefined` | 指定 focus 时的光标位置 |
+| selectionStart? | `number \| undefined` | 光标起始位置，自动聚集时有效，需与 selectionEnd 搭配使用 |
+| selectionEnd? | `number \| undefined` | 光标结束位置，自动聚集时有效，需与 selectionStart 搭配使用 |
+| adjustPosition? | `boolean \| undefined` | 键盘弹起时，是否自动上推页面 |
+| holdKeyboard? | `boolean \| undefined` | focus 时，点击页面的时候不收起键盘 |
+| controlled? | `boolean \| undefined` | 是否为受控组件。为 true 时，value 内容会完全受 setData 控制。 |
+| onInput? | `CommonEventFunction<TextareaProps.onInputEventDetail> \| undefined` | 当键盘输入时，触发 input 事件 **onInput 处理函数的返回值并不会反映到 textarea 上** |
+| onFocus? | `CommonEventFunction<TextareaProps.onFocusEventDetail> \| undefined` | 输入框聚焦时触发 |
+| onBlur? | `CommonEventFunction<TextareaProps.onBlurEventDetail> \| undefined` | 输入框失去焦点时触发 |
+| onConfirm? | `CommonEventFunction<TextareaProps.onConfirmEventDetail> \| undefined` | 点击完成时， 触发 confirm 事件 |
+| onKeyboardHeightChange? | `CommonEventFunction<TextareaProps.onKeyboardHeightChangeEventDetail> \| undefined` | 键盘高度发生变化的时候触发此事件 |
+| onSelectionChange? | `CommonEventFunction \| undefined` | 选区改变事件, {selectionStart, selectionEnd} |
+| onKeyboardCompositionStart? | `CommonEventFunction \| undefined` | 输入法开始新的输入时触发 （仅当输入法支持时触发） |
+| onKeyboardCompositionUpdate? | `CommonEventFunction \| undefined` | 输入法输入字符时触发（仅当输入法支持时触发） |
+| onKeyboardCompositionEnd? | `CommonEventFunction \| undefined` | 输入法输入结束时触发（仅当输入法支持时触发） |
+| autoHeight? | `boolean \| undefined` | 是否自动增高，设置 autoHeight 时，style.height不生效 |
+| showConfirmBar? | `boolean \| undefined` | 是否显示键盘上方带有”完成“按钮那一栏 |
+| disableDefaultPadding? | `boolean \| undefined` | 是否去掉 iOS 下的默认内边距 |
+| showCount? | `boolean \| undefined` | 是否渲染字数统计功能（是否删除默认计数器/是否显示字数统计）。 |
+| adjustKeyboardTo? | `"bottom" \| "cursor" \| undefined` | 键盘对齐位置 |
+| onLineChange? | `CommonEventFunction<TextareaProps.onLineChangeEventDetail> \| undefined` | 输入框行数变化时调用 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/input-group/index.md

@@ -0,0 +1,14 @@
+# ui/input-group
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/input-group`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `InputGroup` | 输入组合组件。 | [查看](./InputGroup.md) |
+| `InputGroupAddon` | 输入组合附加内容。 | [查看](./InputGroupAddon.md) |
+| `InputGroupButton` | 输入组合操作按钮。 | [查看](./InputGroupButton.md) |
+| `InputGroupInput` | 输入组合输入区域。 | [查看](./InputGroupInput.md) |
+| `InputGroupText` | 输入组合文本区域。 | [查看](./InputGroupText.md) |
+| `InputGroupTextarea` | 输入组合多行输入区域。 | [查看](./InputGroupTextarea.md) |