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

package/dist/reference/sdk-api/ui/button/buttonVariants.md

@@ -0,0 +1,84 @@
+# buttonVariants
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/button`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/button.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+生成按钮的样式类名；接受其声明的样式变体。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 样式变体以及附加的 class 或 className。 |
+
+返回：合并后的样式类名。
+
+示例：
+
+```tsx
+import { buttonVariants } from '@open-dy/vibecoding-sdk-taro/ui/button'
+buttonVariants()
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：生成按钮的样式类名；接受其声明的样式变体。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function buttonVariants(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;
+```
+
+#### 参数
+
+- `props?`
+
+```ts
+(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
+```
+说明：样式变体以及附加的 class 或 className。
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| variant? | `"default" \| "link" \| "outline" \| "secondary" \| "ghost" \| "destructive" \| null \| undefined` | 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。 |
+| size? | `"default" \| "xs" \| "sm" \| "lg" \| "icon" \| "icon-xs" \| "icon-sm" \| "icon-lg" \| null \| undefined` | 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| class? | `ClassValue` |  |
+| className? | `ClassValue` |  |
+
+</details>
+
+#### 返回值
+
+- 类型：`string`

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

@@ -0,0 +1,11 @@
+# ui/button
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/button`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `Button` | 支持主题样式和抖音 openType 的小程序按钮；用于普通小程序和兴趣卡落地页。 | [查看](./Button.md) |
+| `ButtonProps` | 按钮组件的属性类型；保留 Taro 原生能力，避免 size/type 与样式变体同名冲突。 | [查看](./ButtonProps.md) |
+| `buttonVariants` | 生成按钮的样式类名；接受其声明的样式变体。 | [查看](./buttonVariants.md) |

package/dist/reference/sdk-api/ui/button-group/ButtonGroup.md

@@ -0,0 +1,106 @@
+# ButtonGroup
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/button-group`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/button-group.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+按钮组组件。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { ButtonGroup } from '@open-dy/vibecoding-sdk-taro/ui/button-group'
+<ButtonGroup />
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：按钮组组件。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ButtonGroup(props: ViewProps & VariantProps<(props?: (ConfigVariants<{ orientation: { horizontal: string; vertical: string; }; }> & ClassProp) | undefined) => string>): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `ViewProps & VariantProps<(props?: (ConfigVariants<{ orientation: { horizontal: string; vertical: string; }; }> & ClassProp) \| undefined) => string>` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| orientation? | `"horizontal" \| "vertical" \| null \| undefined` | 排列方向，默认 horizontal（横排）；vertical 纵排。同时调整子按钮的相连边框和首尾圆角。 |
+
+<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/button-group/ButtonGroupSeparator.md

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

@@ -0,0 +1,106 @@
+# ButtonGroupText
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/button-group`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/button-group.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+按钮组文本区域。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { ButtonGroup, ButtonGroupText } from '@open-dy/vibecoding-sdk-taro/ui/button-group'
+<ButtonGroup><ButtonGroupText /></ButtonGroup>
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：按钮组文本区域。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function ButtonGroupText(props: Omit<ViewProps, "children"> & { children?: React.ReactNode; asChild?: boolean; }): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `Omit<ViewProps, "children"> & { children?: React.ReactNode; asChild?: boolean; }` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| children? | `React.ReactNode` | 文本内容；asChild 为 true 且提供单个有效 React 元素时，将样式和 props 合并到该元素。 |
+| asChild? | `boolean \| undefined` | 是否复用单个子元素作为容器，默认 false；否则使用 View。不是有效单元素时仍使用 View。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| 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 设备，重按时会触发 |
+| 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 事件 |
+
+</details>
+
+#### 返回值
+
+- 类型：`React.JSX.Element`

package/dist/reference/sdk-api/ui/button-group/buttonGroupVariants.md

@@ -0,0 +1,70 @@
+# buttonGroupVariants
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/button-group`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/button-group.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+生成按钮组的样式类名；接受其声明的样式变体。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 样式变体以及附加的 class 或 className。 |
+
+返回：合并后的样式类名。
+
+示例：
+
+```tsx
+import { buttonGroupVariants } from '@open-dy/vibecoding-sdk-taro/ui/button-group'
+buttonGroupVariants()
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：生成按钮组的样式类名；接受其声明的样式变体。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function buttonGroupVariants(props?: (ConfigVariants<{ orientation: { horizontal: string; vertical: string; }; }> & ClassProp) | undefined): string;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props? | `(ConfigVariants<{ orientation: { horizontal: string; vertical: string; }; }> & ClassProp) \| undefined` | 样式变体以及附加的 class 或 className。 |
+
+##### props 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| orientation? | `"horizontal" \| "vertical" \| null \| undefined` | 排列方向，默认 horizontal（横排）；vertical 纵排。同时调整子按钮的相连边框和首尾圆角。 |
+
+<details>
+
+<summary>继承的 Taro / React 属性</summary>
+
+以下字段沿用上游类型；组件有特殊处理时，以本页组件属性说明为准。
+
+##### 继承属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| class? | `ClassValue` |  |
+| className? | `ClassValue` |  |
+
+</details>
+
+#### 返回值
+
+- 类型：`string`

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

@@ -0,0 +1,12 @@
+# ui/button-group
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/ui/button-group`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `ButtonGroup` | 按钮组组件。 | [查看](./ButtonGroup.md) |
+| `ButtonGroupSeparator` | 按钮组分隔线。 | [查看](./ButtonGroupSeparator.md) |
+| `ButtonGroupText` | 按钮组文本区域。 | [查看](./ButtonGroupText.md) |
+| `buttonGroupVariants` | 生成按钮组的样式类名；接受其声明的样式变体。 | [查看](./buttonGroupVariants.md) |

package/dist/reference/sdk-api/ui/calendar/Calendar.md

@@ -0,0 +1,144 @@
+# Calendar
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/ui/calendar`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/ui/calendar.tsx`（仅补缺或排错时读取）。
+
+#### 说明
+
+日期选择日历组件。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `calendarProps` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+返回：组件渲染结果；类型见返回值契约。
+
+示例：
+
+```tsx
+import { useState } from 'react'
+import { Calendar } from '@open-dy/vibecoding-sdk-taro/ui/calendar'
+export function SingleDatePicker() {
+  const [selected, setSelected] = useState<Date>()
+  const [month, setMonth] = useState(new Date(2026, 9, 1))
+  return <Calendar month={month} onMonthChange={setMonth} selected={selected} onSelect={setSelected} />
+}
+export function DateRangePicker() {
+  const [selected, setSelected] = useState<{ from?: Date; to?: Date }>({})
+  return <Calendar mode="range" selected={selected} onSelect={(next) => setSelected(next ?? {})} />
+}
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 普通小程序或兴趣卡落地页：日期选择日历组件。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要该 UI 模块时，按模块示例组合使用。 |
+| 避免 | 不要用于 Feed OpenCard。属性与组合方式以本页类型和示例为准。 |
+
+#### 声明
+
+```ts
+declare function Calendar(calendarProps: CalendarProps): React.JSX.Element;
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| calendarProps | `CalendarProps` | 组件属性；自有字段的用途及默认行为见下表，继承属性另列。 |
+
+##### calendarProps 组件属性
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| className? | `string \| undefined` | 日历根 View 的附加类名，在基础样式之后合并；省略时使用 bg-background p-2。 |
+| month? | `Date \| undefined` | 受控显示月份；传入后以该 Date 的年/月为准，需通过 onMonthChange 更新。省略时从 selected 或当前日期初始化内部月份。 |
+| onMonthChange? | `((month: Date) => void) \| undefined` | 切换上一月/下一月或下拉年月时调用，参数为新月份的第一天；受控 month 需由调用方同步。 |
+| showOutsideDays? | `boolean \| undefined` | 是否显示相邻月份的日期，默认 true；为 false 时保留日历网格空位，隐藏那些日期。 |
+| disabled? | `((date: Date) => boolean) \| undefined` | 禁选日期判定函数；对每个日期返回 true 表示不可选，省略时不禁用日期，禁用日期不会触发 onSelect。 |
+| captionLayout? | `"label" \| "dropdown" \| undefined` | 标题布局，默认 label（年月文本）；dropdown 使用原生年月 Picker。 |
+| fromYear? | `number \| undefined` | dropdown 年份选项的起始年，默认当前年减 100；会扩展以包含显示中的年份，不限制可选日期。 |
+| toYear? | `number \| undefined` | dropdown 年份选项的结束年，默认当前年加 20；会扩展以包含显示中的年份，不限制可选日期。 |
+| mode? | `"single" \| "range" \| undefined` | 单日选择模式，省略时为 single；此分支的 selected 使用 Date，onSelect 接收单日。 必须为 range，启用范围选择；selected 使用 { from, to }，不能与单日 props 混用。 |
+| selected? | `Date \| DateRange \| undefined` | 外部维护的选中日；省略时没有选中日。组件不保存选中状态，需在 onSelect 中更新。 外部维护的范围；首次选择只有 from，完成后含 from/to。组件不保存选中范围，需在 onSelect 中更新。 |
+| onSelect? | `((date: Date \| undefined) => void) \| ((range: DateRange \| undefined) => void) \| undefined` | 点击未禁用日期时传入该 Date；类型允许 undefined，但当前实现不会通过再次点击自动取消选择。 点击时返回下一范围：无起点/已完成时重新开始；只有起点时完成范围，早于起点的日期会交换端点。当前实现不发出 undefined。 |
+
+###### selected 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| from? | `Date \| undefined` | 范围起始日；未选择起点时省略。组件仅在 mode="range" 下读取该字段。 |
+| to? | `Date \| undefined` | 范围结束日；仅选好起点时省略，完成范围后必须不早于 from。 |
+
+###### onSelect 回调参数
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| range | `DateRange \| undefined` |  |
+
+###### onSelect.range 子字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| from? | `Date \| undefined` | 范围起始日；未选择起点时省略。组件仅在 mode="range" 下读取该字段。 |
+| to? | `Date \| undefined` | 范围结束日；仅选好起点时省略，完成范围后必须不早于 from。 |
+
+<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` | 组件的唯一标示, 保持整个页面唯一 |
+| 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`