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

package/dist/reference/sdk-api/ui/tabs/TabsContent.md

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

package/dist/reference/sdk-api/ui/tabs/TabsList.md

@@ -0,0 +1,106 @@
+# TabsList
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/tabs`
+源码：[src/ui/tabs.tsx](../../../../../src/ui/tabs.tsx)（安装包内保留）
+
+#### 说明
+
+标签页列表容器。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Tabs, TabsList } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+<Tabs><TabsList /></Tabs>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：标签页列表容器。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function TabsList(props: ViewProps & VariantProps<(props?: (ConfigVariants<{ variant: { default: string; line: string; }; }> & ClassProp) | undefined) => string> & { variant?: "default" | "line"; }): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps & VariantProps<(props?: (ConfigVariants<{ variant: { default: string; line: string; }; }> & ClassProp) \| undefined) => string> & { variant?: "default" \| "line"; }` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| variant? | `"default" \| "line" \| undefined` | 页签列表样式，默认 default（圆角底色），line 为透明底和选中下划线；由上下文影响 TabsTrigger。 |
+
+<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/tabs/TabsTrigger.md

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

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

@@ -0,0 +1,13 @@
+# ui/tabs
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/tabs`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `Tabs` | 标签页组件。 | [查看](./Tabs.md) |
+| `TabsContent` | 标签页内容容器。 | [查看](./TabsContent.md) |
+| `TabsList` | 标签页列表容器。 | [查看](./TabsList.md) |
+| `tabsListVariants` | 生成标签页列表的样式类名；接受其声明的样式变体。 | [查看](./tabsListVariants.md) |
+| `TabsTrigger` | 标签页触发器。 | [查看](./TabsTrigger.md) |

package/dist/reference/sdk-api/ui/tabs/tabsListVariants.md

@@ -0,0 +1,70 @@
+# tabsListVariants
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/tabs`
+源码：[src/ui/tabs.tsx](../../../../../src/ui/tabs.tsx)（安装包内保留）
+
+#### 说明
+
+生成标签页列表的样式类名；接受其声明的样式变体。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 样式变体以及附加的 class 或 className。 |
+
+返回：合并后的样式类名。
+
+示例：
+
+```tsx
+import { tabsListVariants } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+tabsListVariants()
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：生成标签页列表的样式类名；接受其声明的样式变体。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function tabsListVariants(props?: (ConfigVariants<{ variant: { default: string; line: string; }; }> & ClassProp) | undefined): string;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props? | `(ConfigVariants<{ variant: { default: string; line: string; }; }> & ClassProp) \| undefined` | 样式变体以及附加的 class 或 className。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| variant? | `"default" \| "line" \| null \| undefined` | 列表样式，默认 default（圆角底色），line 为透明底；同时通过上下文控制触发器的选中下划线。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| class? | `ClassValue` |  |
+| className? | `ClassValue` |  |
+
+</details>
+
+#### 返回值
+
+- 类型：`string`

package/dist/reference/sdk-api/ui/textarea/Textarea.md

@@ -0,0 +1,126 @@
+# Textarea
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/textarea`
+源码：[src/ui/textarea.tsx](../../../../../src/ui/textarea.tsx)（安装包内保留）
+
+#### 说明
+
+多行输入框组件。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { Textarea } from '@open-dy/vibecoding-sdk-taro/ui/textarea'
+<Textarea />
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：多行输入框组件。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function Textarea(props: Omit<TextareaProps, "ref">): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `Omit<TextareaProps, "ref">` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| className? | `string \| undefined` | 外层 View 的附加类名；内部 Textarea 使用自己的填满容器样式。 |
+| style? | `string \| React.CSSProperties \| undefined` | 外层 View 的内联样式；不会原样传给内部 Textarea。 |
+| onInput? | `CommonEventFunction<TextareaProps.onInputEventDetail> \| undefined` | 原生 Textarea 输入事件，文字值从 event.detail.value 读取；调用方自行同步输入状态。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| name? | `string \| undefined` | 组件名字，用于表单提交获取数据。 |
+| children? | `React.ReactNode` | 子节点 |
+| hidden? | `boolean \| undefined` | 组件是否显示, 所有组件默认显示 |
+| animation? | `TaroGeneral.IAnyObject \| { actions: TaroGeneral.IAnyObject[]; } \| undefined` | 动画属性 |
+| ariaLabel? | `string \| undefined` | 无障碍访问，（属性）元素的额外描述 |
+| onTouchStart? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作开始 |
+| onTouchMove? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后移动 |
+| onTouchEnd? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作结束 |
+| onTouchCancel? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作被打断，如来电提醒，弹窗 |
+| onTransitionEnd? | `((event: CommonEvent) => void) \| undefined` | 会在 WXSS transition 或 Taro.createAnimation 动画结束后触发 |
+| onAnimationIteration? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 一次迭代结束时触发 |
+| onAnimationStart? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画开始时触发 |
+| onAnimationEnd? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画完成时触发 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| 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 设备，重按时会触发 |
+| fixed? | `boolean \| undefined` | 如果 Textarea 是在一个 `position:fixed` 的区域，需要显示指定属性 fixed 为 true |
+| 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 控制。 |
+| 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/textarea/index.md

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