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

package/dist/reference/sdk-api/ui/field/FieldTitle.md

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

@@ -0,0 +1,18 @@
+# ui/field
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/field`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `Field` | 表单字段组件。 | [查看](./Field.md) |
+| `FieldContent` | 表单字段内容容器。 | [查看](./FieldContent.md) |
+| `FieldDescription` | 表单字段说明文本。 | [查看](./FieldDescription.md) |
+| `FieldError` | 表单字段错误信息。 | [查看](./FieldError.md) |
+| `FieldGroup` | 表单字段分组容器。 | [查看](./FieldGroup.md) |
+| `FieldLabel` | 表单字段标签文本。 | [查看](./FieldLabel.md) |
+| `FieldLegend` | 表单字段字段组标题。 | [查看](./FieldLegend.md) |
+| `FieldSeparator` | 表单字段分隔线。 | [查看](./FieldSeparator.md) |
+| `FieldSet` | 表单字段字段组容器。 | [查看](./FieldSet.md) |
+| `FieldTitle` | 表单字段标题。 | [查看](./FieldTitle.md) |

package/dist/reference/sdk-api/ui/helpers/collectDataIconState.md

@@ -0,0 +1,66 @@
+# collectDataIconState
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/helpers`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/helpers.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+扫描 React 子节点的 data-icon 标记，返回行首和行尾图标是否存在。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `children` | 要检查的 React 子节点。 |
+
+返回：包含 hasInlineStartIcon 和 hasInlineEndIcon 的对象。
+
+示例：
+
+```tsx
+import { View } from '@tarojs/components'
+import { collectDataIconState } from '@open-dy/vibecoding-sdk-taro/ui/helpers'
+collectDataIconState(<View data-icon="inline-start" />)
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：扫描 React 子节点的 data-icon 标记，返回行首和行尾图标是否存在。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function collectDataIconState(children: React.ReactNode): { hasInlineStartIcon: boolean; hasInlineEndIcon: boolean; };
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| children | `React.ReactNode` | 要检查的 React 子节点。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| toString | `(() => string) \| ((radix?: number) => string) \| (() => string)` | Returns a string representation of a string. Returns a string representation of an object. |
+| valueOf | `(() => string) \| (() => number) \| (() => boolean) \| (() => Object)` | Returns the primitive value of the specified object. |
+| toLocaleString | `(() => string) \| { (locales?: string \| string[], options?: Intl.NumberFormatOptions): string; (locales?: Intl.LocalesArgument, options?: Intl.NumberFormatOptions): string; }` | Returns a date converted to a string using the current locale. Converts a number to a string by using the current or specified locale. |
+
+</details>
+
+#### 返回值
+
+- 类型：`{ hasInlineStartIcon: boolean; hasInlineEndIcon: boolean; }`

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

@@ -0,0 +1,9 @@
+# ui/helpers
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/helpers`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `collectDataIconState` | 扫描 React 子节点的 data-icon 标记，返回行首和行尾图标是否存在。 | [查看](./collectDataIconState.md) |

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

@@ -0,0 +1,57 @@
+# UI Reference
+
+普通小程序和兴趣卡落地页的 UI。详细文档按模块和公开导出拆分；Feed OpenCard 不使用这些组件。
+
+| 模块 | 公开 API 数量 |
+| --- | --- |
+| [accordion](./accordion/index.md) | 4 |
+| [alert-dialog](./alert-dialog/index.md) | 11 |
+| [alert](./alert/index.md) | 4 |
+| [aspect-ratio](./aspect-ratio/index.md) | 1 |
+| [avatar](./avatar/index.md) | 6 |
+| [badge](./badge/index.md) | 2 |
+| [button-group](./button-group/index.md) | 4 |
+| [button](./button/index.md) | 3 |
+| [calendar](./calendar/index.md) | 2 |
+| [card](./card/index.md) | 7 |
+| [carousel](./carousel/index.md) | 6 |
+| [checkbox](./checkbox/index.md) | 1 |
+| [collapsible](./collapsible/index.md) | 3 |
+| [combobox](./combobox/index.md) | 16 |
+| [dialog](./dialog/index.md) | 10 |
+| [drawer](./drawer/index.md) | 10 |
+| [dropdown-menu](./dropdown-menu/index.md) | 15 |
+| [empty](./empty/index.md) | 6 |
+| [field](./field/index.md) | 10 |
+| [helpers](./helpers/index.md) | 1 |
+| [input-group](./input-group/index.md) | 6 |
+| [input-otp](./input-otp/index.md) | 4 |
+| [input](./input/index.md) | 1 |
+| [item](./item/index.md) | 10 |
+| [label](./label/index.md) | 1 |
+| [menubar](./menubar/index.md) | 16 |
+| [navigation-menu](./navigation-menu/index.md) | 9 |
+| [pagination](./pagination/index.md) | 7 |
+| [popover](./popover/index.md) | 7 |
+| [portal](./portal/index.md) | 1 |
+| [progress](./progress/index.md) | 5 |
+| [radio-group](./radio-group/index.md) | 2 |
+| [resizable](./resizable/index.md) | 3 |
+| [scroll-area](./scroll-area/index.md) | 2 |
+| [select](./select/index.md) | 10 |
+| [separator](./separator/index.md) | 1 |
+| [sheet](./sheet/index.md) | 10 |
+| [skeleton](./skeleton/index.md) | 1 |
+| [slider](./slider/index.md) | 1 |
+| [sonner](./sonner/index.md) | 2 |
+| [spinner](./spinner/index.md) | 1 |
+| [switch](./switch/index.md) | 1 |
+| [table](./table/index.md) | 8 |
+| [tabs](./tabs/index.md) | 5 |
+| [textarea](./textarea/index.md) | 1 |
+| [toggle-group](./toggle-group/index.md) | 2 |
+| [toggle](./toggle/index.md) | 2 |
+
+样式入口：`@open-dy/vibecoding-sdk-taro/ui/theme.css`、`@open-dy/vibecoding-sdk-taro/ui/tailwind.css`。
+
+文档不足以解释实现时，可按 API 页的源码路径查看安装包内的 `src/ui/`；运行入口仍为 `dist/ui/`。

package/dist/reference/sdk-api/ui/input/Input.md

@@ -0,0 +1,141 @@
+# Input
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/input`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/input.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+带视觉容器的 Taro 输入框；用于普通小程序和兴趣卡落地页。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 输入属性；value、onInput 等传给原生输入框，className 和 style 作用于外层 View。 |
+
+返回：一个带边框、背景、圆角、横向内边距和原生输入框的 View。
+
+备注：默认容器使用 h-11、w-full、rounded-lg、border、bg-background、px-3。通过 className 覆写容器，不要在外层再加相同边框、背景或内边距；横向布局的外层 View 只负责 flex 和间距。className 不会直接改变内部原生输入框的 text-sm。
+
+示例：
+
+```tsx
+import { Input } from '@open-dy/vibecoding-sdk-taro/ui/input'
+import { View } from '@tarojs/components'
+export function TaskInput() {
+  return <View className="flex gap-3"><Input placeholder="添加任务" className="flex-1 rounded-none border-4 border-black bg-white" /></View>
+}
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：带视觉容器的 Taro 输入框；用于普通小程序和兴趣卡落地页。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。默认容器使用 h-11、w-full、rounded-lg、border、bg-background、px-3。通过 className 覆写容器，不要在外层再加相同边框、背景或内边距；横向布局的外层 View 只负责 flex 和间距。className 不会直接改变内部原生输入框的 text-sm。 |
+
+#### 声明
+
+```ts
+declare function Input(props: InputProps): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `InputProps` | 输入属性；value、onInput 等传给原生输入框，className 和 style 作用于外层 View。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| style? | `string \| React.CSSProperties \| undefined` | 外层 View 的内联样式；内部 Input 使用固定的透明背景和零内边距样式。 |
+| className? | `string \| undefined` | 外层 View 容器的附加类名，控制边框、尺寸和布局；不会传给内部原生 Input。 |
+| type? | `keyof InputProps.Type \| undefined` | 输入类型，直接传给原生 Taro Input；此组件不做转换，省略时由平台默认行为决定。 |
+| disabled? | `boolean \| undefined` | 是否禁用原生 Input，默认 false；同时对外层添加透明度和 pointer-events-none。 |
+| value? | `string \| undefined` | 原生输入值；在 onInput 中更新可构成受控输入，事件值位于 event.detail.value。省略时沿用 Taro Input 行为。 |
+| onInput? | `CommonEventFunction<InputProps.inputEventDetail> \| undefined` | 原生 Input 输入事件，值位于 event.detail.value；与 InputOTP.onChange 接收字符串的协议不同。 |
+| aria-invalid? | `boolean \| "true" \| "false" \| undefined` | 校验失败的视觉状态；true 或 "true" 设置错误边框和光圈，默认无错误样式，不执行值校验。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| name? | `string \| 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 标签上 |
+| 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 表示手机号，需要和留资分发配置一起使用，详情见留资分发配置。 |
+| 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/index.md

@@ -0,0 +1,9 @@
+# ui/input
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/input`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `Input` | 带视觉容器的 Taro 输入框；用于普通小程序和兴趣卡落地页。 | [查看](./Input.md) |

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

@@ -0,0 +1,100 @@
+# InputGroup
+
+<!-- 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 } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+<InputGroup />
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：输入组合组件。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function InputGroup(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/InputGroupAddon.md

@@ -0,0 +1,109 @@
+# InputGroupAddon
+
+<!-- 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, InputGroupAddon } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+<InputGroup><InputGroupAddon /></InputGroup>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：输入组合附加内容。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function InputGroupAddon(props: ViewProps & VariantProps<(props?: (ConfigVariants<{ align: { "inline-start": string; "inline-end": string; "block-start": string; "block-end": string; }; }> & ClassProp) | undefined) => string>): React.JSX.Element;
+```
+
+#### 参数
+
+- `props`
+
+```ts
+ViewProps & VariantProps<(props?: (ConfigVariants<{ align: { "inline-start": string; "inline-end": string; "block-start": string; "block-end": string; }; }> & ClassProp) | undefined) => string>
+```
+说明：组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| align? | `"inline-start" \| "inline-end" \| "block-start" \| "block-end" \| null \| undefined` | 附加区位置，默认 inline-start（行首），inline-end 行尾；block-start 顶部、block-end 底部，这两项让 InputGroup 使用纵向布局。 |
+
+<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`