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

package/dist/ui/button.d.ts

@@ -3,28 +3,80 @@ import { Button as TaroButton, type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
 type TaroButtonProps = React.ComponentProps<typeof TaroButton>;
 type OpenTypeDetailEvent = {
+    /** @desc 原生能力回调的结果明细；平台未提供时可缺省，使用前需判空。 */
     detail?: {
+        /** @desc 平台提供的结果或错误描述；可缺省，请保留原文用于判断和诊断。 */
         errMsg?: string;
+        /** @desc 平台提供的数值结果码；可缺省，含义以所用原生能力的契约为准。 */
         errNo?: number;
     };
 };
 type DouyinButtonExtras = {
+    /** @desc 抖音原生按钮能力类型；非空时改用 Taro Button 并透传该值，否则渲染 View。可用值和授权要求以目标平台能力为准。 */
     openType?: TaroButtonProps["openType"] | (string & {});
+    /** @desc navigateToVideoView 的视频标识；优先于 data-video-id，同时注入两种拼写给原生按钮。其他 openType 仅透传。 */
     dataVideoId?: string;
+    /** @desc 视频类型；优先于 data-video-type。navigateToVideoView 场景省略时为 "raw"，其他场景不设置默认值。 */
     dataVideoType?: string;
+    /** @desc 原生视频能力的渠道参数；优先于 data-channel，未提供时不注入。不控制 SDK 网络通道。 */
     dataChannel?: string;
+    /** @desc dataVideoId 的兼容写法；两者都提供时以 dataVideoId 为准。 */
     "data-video-id"?: string;
+    /** @desc dataVideoType 的兼容写法；两者都提供时以 dataVideoType 为准。 */
     "data-video-type"?: string;
+    /** @desc dataChannel 的兼容写法；两者都提供时以 dataChannel 为准。 */
     "data-channel"?: string;
+    /** @desc 仅在原生 navigateToVideoView 能力分支中透传的结果回调；event.detail 可缺省，不代表业务点击回调。 */
     onNavigateToVideoView?: (event: OpenTypeDetailEvent) => void;
+    /** @desc 仅在原生 addShortcut 能力分支中透传的结果回调；结果从 event.detail 读取，普通 View 按钮不会主动调用。 */
     onAddShortcut?: (event: OpenTypeDetailEvent) => void;
 };
 /** Taro Button `size`/`type` 与 CVA variant 同名，必须 Omit，否则 size 会收成只剩 `"default"`。 */
 type TaroButtonNativeKeys = keyof ViewProps | "className" | "style" | "children" | "size" | "type";
+/**
+ * @desc 按钮组件的属性类型；保留 Taro 原生能力，避免 size/type 与样式变体同名冲突。
+ * @property {ButtonProps["variant"]} variant 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。
+ * @property {ButtonProps["size"]} size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @example
+ * ```tsx
+ * import { ButtonProps } from '@open-dy/vibecoding-sdk-taro/ui/button'
+ * const props: ButtonProps = { children: '确认' }
+ * ```
+ */
 export type ButtonProps = ViewProps & VariantProps<typeof buttonVariants> & Omit<TaroButtonProps, TaroButtonNativeKeys> & DouyinButtonExtras;
+/**
+ * @desc 生成按钮的样式类名；接受其声明的样式变体。
+ * @param {Parameters<typeof buttonVariants>[0]} props 样式变体以及附加的 class 或 className。
+ * @param {Parameters<typeof buttonVariants>[0]["variant"]} props.variant 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。
+ * @param {Parameters<typeof buttonVariants>[0]["size"]} props.size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @return {string} 合并后的样式类名。
+ * @example
+ * ```tsx
+ * import { buttonVariants } from '@open-dy/vibecoding-sdk-taro/ui/button'
+ * buttonVariants()
+ * ```
+ */
 declare const buttonVariants: (props?: ({
     variant?: "default" | "link" | "outline" | "secondary" | "ghost" | "destructive" | null | undefined;
     size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 支持主题样式和抖音 openType 的小程序按钮；用于普通小程序和兴趣卡落地页。
+ * @param {ButtonProps} props 按钮属性；variant 和 size 选择视觉样式，className 覆写容器，onClick 处理普通点击。
+ * @param {Parameters<typeof Button>[0]["variant"]} props.variant 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。
+ * @param {Parameters<typeof Button>[0]["size"]} props.size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @param {Parameters<typeof Button>[0]["className"]} props.className 追加到预置样式之后的容器类名，可覆写色彩、边框、圆角和尺寸。普通分支应用于 View，openType 分支应用于原生 Button。
+ * @param {Parameters<typeof Button>[0]["style"]} props.style 传给渲染根节点的内联样式；普通分支为 View，openType 分支为原生 Button。
+ * @param {Parameters<typeof Button>[0]["disabled"]} props.disabled 原生 Taro Button 的禁用属性，仅 openType 分支有原生禁用保证。普通 View 分支透传该值但未实现点击拦截，请在业务回调中处理。
+ * @return {React.JSX.Element} 普通交互返回 View；传入 openType 时返回原生 Taro Button。
+ * @remarks variant 默认 default（主题背景和前景色），size 默认 default（h-8）。className 合并在预置样式之后，可覆写背景、文字色、边框、圆角和尺寸。不要为获得另一种风格重写通用按钮；按 DESIGN.md 传入 className 或 variant。openType 走原生按钮能力，普通按钮走 View，两者使用同一组视觉样式。
+ * @example
+ * ```tsx
+ * import { Button } from '@open-dy/vibecoding-sdk-taro/ui/button'
+ * export function AddTaskButton() {
+ *   return <Button className="h-11 rounded-none border-4 border-black bg-black text-white" onClick={() => console.log('add task')}>添加</Button>
+ * }
+ * ```
+ */
 declare function Button({ className, variant, size, openType, dataVideoId, dataVideoType, dataChannel, "data-video-id": dataVideoIdAttr, "data-video-type": dataVideoTypeAttr, "data-channel": dataChannelAttr, style, ...props }: ButtonProps): React.JSX.Element;
 export { Button, buttonVariants };

package/dist/ui/button.js

@@ -5,6 +5,18 @@ import { cva } from "class-variance-authority";
 import { cn } from "../lib/utils.js";
 import { collectDataIconState } from "./helpers.js";
 const NativeButton = TaroButton;
+/**
+ * @desc 生成按钮的样式类名；接受其声明的样式变体。
+ * @param {Parameters<typeof buttonVariants>[0]} props 样式变体以及附加的 class 或 className。
+ * @param {Parameters<typeof buttonVariants>[0]["variant"]} props.variant 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。
+ * @param {Parameters<typeof buttonVariants>[0]["size"]} props.size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @return {string} 合并后的样式类名。
+ * @example
+ * ```tsx
+ * import { buttonVariants } from '@open-dy/vibecoding-sdk-taro/ui/button'
+ * buttonVariants()
+ * ```
+ */
 const buttonVariants = cva("group/button inline-flex shrink-0 items-center justify-center rounded-lg border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-[transform,opacity,background-color,color,box-shadow] duration-150 ease-out outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:scale-[0.98] active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", {
     variants: {
         variant: {
@@ -48,6 +60,24 @@ function getButtonHoverClass(variant) {
             return "scale-[0.98] opacity-88";
     }
 }
+/**
+ * @desc 支持主题样式和抖音 openType 的小程序按钮；用于普通小程序和兴趣卡落地页。
+ * @param {ButtonProps} props 按钮属性；variant 和 size 选择视觉样式，className 覆写容器，onClick 处理普通点击。
+ * @param {Parameters<typeof Button>[0]["variant"]} props.variant 视觉变体，默认 default（主题色）；outline 描边、secondary 次要、ghost 无底色、destructive 危险色、link 链接样式。只控制样式，不执行业务动作。
+ * @param {Parameters<typeof Button>[0]["size"]} props.size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @param {Parameters<typeof Button>[0]["className"]} props.className 追加到预置样式之后的容器类名，可覆写色彩、边框、圆角和尺寸。普通分支应用于 View，openType 分支应用于原生 Button。
+ * @param {Parameters<typeof Button>[0]["style"]} props.style 传给渲染根节点的内联样式；普通分支为 View，openType 分支为原生 Button。
+ * @param {Parameters<typeof Button>[0]["disabled"]} props.disabled 原生 Taro Button 的禁用属性，仅 openType 分支有原生禁用保证。普通 View 分支透传该值但未实现点击拦截，请在业务回调中处理。
+ * @return {React.JSX.Element} 普通交互返回 View；传入 openType 时返回原生 Taro Button。
+ * @remarks variant 默认 default（主题背景和前景色），size 默认 default（h-8）。className 合并在预置样式之后，可覆写背景、文字色、边框、圆角和尺寸。不要为获得另一种风格重写通用按钮；按 DESIGN.md 传入 className 或 variant。openType 走原生按钮能力，普通按钮走 View，两者使用同一组视觉样式。
+ * @example
+ * ```tsx
+ * import { Button } from '@open-dy/vibecoding-sdk-taro/ui/button'
+ * export function AddTaskButton() {
+ *   return <Button className="h-11 rounded-none border-4 border-black bg-black text-white" onClick={() => console.log('add task')}>添加</Button>
+ * }
+ * ```
+ */
 function Button({ className, variant = "default", size = "default", openType, dataVideoId, dataVideoType, dataChannel, "data-video-id": dataVideoIdAttr, "data-video-type": dataVideoTypeAttr, "data-channel": dataChannelAttr, style, ...props }) {
     const { hasInlineStartIcon, hasInlineEndIcon } = React.useMemo(() => collectDataIconState(props.children), [props.children]);
     const sharedClassName = cn(buttonVariants({ variant, size }), hasInlineStartIcon && (size === "xs" || size === "sm" ? "pl-1.5" : "pl-2"), hasInlineEndIcon && (size === "xs" || size === "sm" ? "pr-1.5" : "pr-2"), className);

package/dist/ui/button.js.map

@@ -1 +1 @@
-{"version":3,"file":"button.js","sourceRoot":"","sources":["../../src/ui/button.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"button.js","sourceRoot":"","sources":["../../src/ui/button.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAuChD,MAAM,YAAY,GAAG,UAAoD,CAAA;AA4BzE;;;;;;;;;;;GAWG;AACH,MAAM,cAAc,GAAG,GAAG,CACxB,4sBAA4sB,EAC5sB;IACE,QAAQ,EAAE;QACR,OAAO,EAAE;YACP,OAAO,EAAE,4DAA4D;YACrE,OAAO,EACL,iLAAiL;YACnL,SAAS,EACP,iIAAiI;YACnI,KAAK,EACH,kHAAkH;YACpH,WAAW,EACT,6NAA6N;YAC/N,IAAI,EAAE,iDAAiD;SACxD;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,oBAAoB;YAC7B,EAAE,EAAE,kGAAkG;YACtG,EAAE,EAAE,4GAA4G;YAChH,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,kFAAkF;YAC7F,SAAS,EAAE,6CAA6C;YACxD,SAAS,EAAE,QAAQ;SACpB;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,SAAS;KAChB;CACF,CACF,CAAA;AAED,SAAS,mBAAmB,CAAC,OAAsB;IACjD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,0CAA0C,CAAA;QACnD,KAAK,WAAW;YACd,OAAO,yBAAyB,CAAA;QAClC,KAAK,OAAO;YACV,OAAO,0CAA0C,CAAA;QACnD,KAAK,aAAa;YAChB,OAAO,wEAAwE,CAAA;QACjF,KAAK,MAAM;YACT,OAAO,YAAY,CAAA;QACrB,KAAK,SAAS,CAAC;QACf;YACE,OAAO,yBAAyB,CAAA;IACpC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EAAE,eAAe,EAChC,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,EAAE,eAAe,EAC/B,KAAK,EACL,GAAG,KAAK,EACI;IACZ,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC,OAAO,CAC5D,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAC1C,CAAC,KAAK,CAAC,QAAQ,CAAC,CACjB,CAAA;IAED,MAAM,eAAe,GAAG,EAAE,CACxB,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EACjC,kBAAkB,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAC1E,gBAAgB,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EACxE,SAAS,CACV,CAAA;IACD,MAAM,WAAW,GAAG;QAClB,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,eAAe;QAC1B,UAAU,EAAE,mBAAmB,CAAC,OAAO,CAAC;QACxC,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,EAAE;KAClB,CAAA;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,WAAW,IAAI,eAAe,CAAA;QAC9C,MAAM,SAAS,GACb,aAAa;YACb,iBAAiB;YACjB,CAAC,QAAQ,KAAK,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAC1D,MAAM,OAAO,GAAG,WAAW,IAAI,eAAe,CAAA;QAE9C,wEAAwE;QACxE,OAAO,CACL,KAAC,YAAY,OACP,KAAK,KACL,WAAW,EACf,QAAQ,EAAE,QAAQ,KACd,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACnE,CAAC,SAAS;gBACZ,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE;gBAC5D,CAAC,CAAC,EAAE,CAAC,KACH,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACtE,KAAK,EAAE,KAAK,GACZ,CACH,CAAA;IACH,CAAC;IAED,OAAO,KAAC,IAAI,OAAK,KAAK,KAAM,WAAW,EAAE,KAAK,EAAE,KAAK,GAAI,CAAA;AAC3D,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA"}

package/dist/ui/calendar.d.ts

@@ -1,29 +1,73 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 type DateRange = {
+    /** @desc 范围起始日；未选择起点时省略。组件仅在 mode="range" 下读取该字段。 */
     from?: Date;
+    /** @desc 范围结束日；仅选好起点时省略，完成范围后必须不早于 from。 */
     to?: Date;
 };
 type CalendarBaseProps = ViewProps & {
+    /** @desc 受控显示月份；传入后以该 Date 的年/月为准，需通过 onMonthChange 更新。省略时从 selected 或当前日期初始化内部月份。 */
     month?: Date;
+    /** @desc 切换上一月/下一月或下拉年月时调用，参数为新月份的第一天；受控 month 需由调用方同步。 */
     onMonthChange?: (month: Date) => void;
+    /** @desc 是否显示相邻月份的日期，默认 true；为 false 时保留日历网格空位，隐藏那些日期。 */
     showOutsideDays?: boolean;
+    /** @desc 禁选日期判定函数；对每个日期返回 true 表示不可选，省略时不禁用日期，禁用日期不会触发 onSelect。 */
     disabled?: (date: Date) => boolean;
+    /** @desc 标题布局，默认 label（年月文本）；dropdown 使用原生年月 Picker。 */
     captionLayout?: "label" | "dropdown";
+    /** @desc dropdown 年份选项的起始年，默认当前年减 100；会扩展以包含显示中的年份，不限制可选日期。 */
     fromYear?: number;
+    /** @desc dropdown 年份选项的结束年，默认当前年加 20；会扩展以包含显示中的年份，不限制可选日期。 */
     toYear?: number;
+    /** @desc 日历根 View 的附加类名，在基础样式之后合并；省略时使用 bg-background p-2。 */
     className?: string;
 };
 type SingleCalendarProps = CalendarBaseProps & {
+    /** @desc 单日选择模式，省略时为 single；此分支的 selected 使用 Date，onSelect 接收单日。 */
     mode?: "single";
+    /** @desc 外部维护的选中日；省略时没有选中日。组件不保存选中状态，需在 onSelect 中更新。 */
     selected?: Date;
+    /** @desc 点击未禁用日期时传入该 Date；类型允许 undefined，但当前实现不会通过再次点击自动取消选择。 */
     onSelect?: (date: Date | undefined) => void;
 };
 type RangeCalendarProps = CalendarBaseProps & {
+    /** @desc 必须为 range，启用范围选择；selected 使用 { from, to }，不能与单日 props 混用。 */
     mode: "range";
+    /** @desc 外部维护的范围；首次选择只有 from，完成后含 from/to。组件不保存选中范围，需在 onSelect 中更新。 */
     selected?: DateRange;
+    /** @desc 点击时返回下一范围：无起点/已完成时重新开始；只有起点时完成范围，早于起点的日期会交换端点。当前实现不发出 undefined。 */
     onSelect?: (range: DateRange | undefined) => void;
 };
+/**
+ * @desc 日历属性联合类型；mode 区分单日选择和日期范围选择。
+ * @example
+ * ```tsx
+ * import { CalendarProps } from '@open-dy/vibecoding-sdk-taro/ui/calendar'
+ * const single: CalendarProps = { mode: 'single', selected: new Date(2026, 9, 1) }
+ * const range: CalendarProps = { mode: 'range', selected: { from: new Date(2026, 9, 1), to: new Date(2026, 9, 3) } }
+ * ```
+ */
 type CalendarProps = SingleCalendarProps | RangeCalendarProps;
+/**
+ * @desc 日期选择日历组件。
+ * @param {Parameters<typeof Calendar>[0]} calendarProps 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Calendar>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```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 ?? {})} />
+ * }
+ * ```
+ */
 declare function Calendar(calendarProps: CalendarProps): React.JSX.Element;
 export { Calendar, type CalendarProps };

package/dist/ui/calendar.js

@@ -18,6 +18,25 @@ function isSameDay(a, b) {
         a.getMonth() === b.getMonth() &&
         a.getDate() === b.getDate());
 }
+/**
+ * @desc 日期选择日历组件。
+ * @param {Parameters<typeof Calendar>[0]} calendarProps 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Calendar>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```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 ?? {})} />
+ * }
+ * ```
+ */
 function Calendar(calendarProps) {
     const { className, month: monthProp, onMonthChange, showOutsideDays = true, disabled, captionLayout = "label", fromYear, toYear, mode = "single", selected: _selected, onSelect: _onSelect, ...viewProps } = calendarProps;
     const selectedSingle = isRangeCalendarProps(calendarProps)

package/dist/ui/calendar.js.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/ui/calendar.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/ui/calendar.tsx"],"names":[],"mappings":"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"}

package/dist/ui/card.d.ts

@@ -1,12 +1,83 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
+/**
+ * @desc 内容卡片组件。
+ * @param {Parameters<typeof Card>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Card>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card />
+ * ```
+ */
 declare function Card({ className, size, children, ...props }: ViewProps & {
+    /** @desc 卡片密度，默认 default（gap-4/py-4，内区 px-4）；sm 使用 gap-3/py-3 和内区 px-3，影响标题及页脚。 */
     size?: "default" | "sm";
 }): React.JSX.Element;
+/**
+ * @desc 内容卡片头部布局。
+ * @param {Parameters<typeof CardHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardHeader } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardHeader /></Card>
+ * ```
+ */
 declare function CardHeader({ className, children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 内容卡片标题。
+ * @param {Parameters<typeof CardTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardTitle } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardTitle /></Card>
+ * ```
+ */
 declare function CardTitle({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 内容卡片说明文本。
+ * @param {Parameters<typeof CardDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardDescription } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardDescription /></Card>
+ * ```
+ */
 declare function CardDescription({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 内容卡片操作入口。
+ * @param {Parameters<typeof CardAction>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardAction>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardAction } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardAction /></Card>
+ * ```
+ */
 declare function CardAction({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 内容卡片内容容器。
+ * @param {Parameters<typeof CardContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardContent } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardContent /></Card>
+ * ```
+ */
 declare function CardContent({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 内容卡片底部布局。
+ * @param {Parameters<typeof CardFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardFooter } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardFooter /></Card>
+ * ```
+ */
 declare function CardFooter({ className, ...props }: ViewProps): React.JSX.Element;
 export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent, };

package/dist/ui/card.js

@@ -5,10 +5,30 @@ import { cn } from "../lib/utils.js";
 const CardContext = React.createContext({
     size: "default",
 });
+/**
+ * @desc 内容卡片组件。
+ * @param {Parameters<typeof Card>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Card>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card />
+ * ```
+ */
 function Card({ className, size = "default", children, ...props }) {
     const hasFooter = React.useMemo(() => React.Children.toArray(children).some((child) => React.isValidElement(child) && child.type === CardFooter), [children]);
     return (_jsx(CardContext.Provider, { value: { size }, children: _jsx(View, { "data-slot": "card", "data-size": size, className: cn("group/card flex flex-col overflow-hidden rounded-xl bg-card text-sm text-card-foreground ring-1 ring-foreground/10 has-[>img:first-child]:pt-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl", size === "sm" ? "gap-3 py-3" : "gap-4 py-4", hasFooter && "pb-0", className), ...props, children: children }) }));
 }
+/**
+ * @desc 内容卡片头部布局。
+ * @param {Parameters<typeof CardHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardHeader } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardHeader /></Card>
+ * ```
+ */
 function CardHeader({ className, children, ...props }) {
     const { size } = React.useContext(CardContext);
     const childArray = React.Children.toArray(children);
@@ -16,20 +36,70 @@ function CardHeader({ className, children, ...props }) {
     const hasDescription = childArray.some((child) => React.isValidElement(child) && child.type === CardDescription);
     return (_jsx(View, { "data-slot": "card-header", className: cn("group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl", size === "sm" ? "px-3" : "px-4", hasAction && "grid-cols-[1fr_auto]", hasDescription && "grid-rows-[auto_auto]", size === "sm" ? "[.border-b]:pb-3" : "[.border-b]:pb-4", className), ...props, children: children }));
 }
+/**
+ * @desc 内容卡片标题。
+ * @param {Parameters<typeof CardTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardTitle } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardTitle /></Card>
+ * ```
+ */
 function CardTitle({ className, ...props }) {
     const { size } = React.useContext(CardContext);
     return (_jsx(View, { "data-slot": "card-title", className: cn("font-heading text-base leading-snug font-medium", size === "sm" && "text-sm", className), ...props }));
 }
+/**
+ * @desc 内容卡片说明文本。
+ * @param {Parameters<typeof CardDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardDescription } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardDescription /></Card>
+ * ```
+ */
 function CardDescription({ className, ...props }) {
     return (_jsx(View, { "data-slot": "card-description", className: cn("text-sm text-muted-foreground", className), ...props }));
 }
+/**
+ * @desc 内容卡片操作入口。
+ * @param {Parameters<typeof CardAction>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardAction>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardAction } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardAction /></Card>
+ * ```
+ */
 function CardAction({ className, ...props }) {
     return (_jsx(View, { "data-slot": "card-action", className: cn("col-start-2 row-span-2 row-start-1 self-start justify-self-end", className), ...props }));
 }
+/**
+ * @desc 内容卡片内容容器。
+ * @param {Parameters<typeof CardContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardContent } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardContent /></Card>
+ * ```
+ */
 function CardContent({ className, ...props }) {
     const { size } = React.useContext(CardContext);
     return (_jsx(View, { "data-slot": "card-content", className: cn(size === "sm" ? "px-3" : "px-4", className), ...props }));
 }
+/**
+ * @desc 内容卡片底部布局。
+ * @param {Parameters<typeof CardFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CardFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Card, CardFooter } from '@open-dy/vibecoding-sdk-taro/ui/card'
+ * <Card><CardFooter /></Card>
+ * ```
+ */
 function CardFooter({ className, ...props }) {
     const { size } = React.useContext(CardContext);
     return (_jsx(View, { "data-slot": "card-footer", className: cn("flex items-center rounded-b-xl border-t bg-muted/50", size === "sm" ? "p-3" : "p-4", className), ...props }));

package/dist/ui/card.js.map

@@ -1 +1 @@
-{"version":3,"file":"card.js","sourceRoot":"","sources":["../../src/ui/card.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../src/ui/card.tsx"],"names":[],"mappings":"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"}

package/dist/ui/carousel.d.ts

@@ -2,8 +2,11 @@ import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 import { Button } from "./button.js";
 type CarouselProps = ViewProps & {
+    /** @desc 轮播方向，默认 horizontal；vertical 启用原生 Swiper 的纵向模式并调整前后按钮位置。 */
     orientation?: "horizontal" | "vertical";
+    /** @desc 兼容属性；当前组件不读取该配置，也不把它作为 Swiper 配置，不能依赖它控制轮播。 */
     opts?: Record<string, unknown>;
+    /** @desc 兼容回调；当前组件不会调用它。需要内部轮播状态时应在 Carousel 内使用 useCarousel。 */
     setApi?: (api: unknown) => void;
 };
 type CarouselContextProps = {
@@ -17,14 +20,82 @@ type CarouselContextProps = {
     canScrollPrev: boolean;
     canScrollNext: boolean;
 };
+/**
+ * @desc 读取最近的 Carousel 上下文，包括当前位置、总数和前后翻页方法。
+ * @param 无参数
+ * @return {ReturnType<typeof useCarousel>} 当前上下文或锚点引用。
+ * @remarks 必须在 Carousel 的后代组件中调用；缺少上下文时会抛错。
+ * @example
+ * ```tsx
+ * import { useCarousel, CarouselNext } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+ * function Controls() { const carousel = useCarousel(); return <CarouselNext disabled={!carousel.canScrollNext} /> }
+ * // Controls 必须渲染在 Carousel 内。
+ * ```
+ */
 declare function useCarousel(): CarouselContextProps;
+/**
+ * @desc 轮播组件。
+ * @param {Parameters<typeof Carousel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Carousel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Carousel } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+ * <Carousel />
+ * ```
+ */
 declare function Carousel({ orientation, className, children, ...props }: CarouselProps): React.JSX.Element;
+/**
+ * @desc 轮播内容容器。
+ * @param {Parameters<typeof CarouselContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CarouselContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Carousel, CarouselContent } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+ * <Carousel><CarouselContent /></Carousel>
+ * ```
+ */
 declare function CarouselContent({ className, children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 轮播条目。
+ * @param {Parameters<typeof CarouselItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CarouselItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Carousel, CarouselItem } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+ * <Carousel><CarouselItem /></Carousel>
+ * ```
+ */
 declare function CarouselItem({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 轮播上一项按钮。
+ * @param {Parameters<typeof CarouselPrevious>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof CarouselPrevious>[0]["variant"]} props.variant 按钮外观，默认 outline；其余变体同 Button.variant。
+ * @param {Parameters<typeof CarouselPrevious>[0]["size"]} props.size 按钮尺寸，默认 icon-sm（size-7）；可按 Button.size 选择其他尺寸。
+ * @return {ReturnType<typeof CarouselPrevious>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Carousel, CarouselPrevious } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+ * <Carousel><CarouselPrevious /></Carousel>
+ * ```
+ */
 declare function CarouselPrevious({ className, variant, size, ...props }: React.ComponentProps<typeof Button> & {
+    /** @desc 沿用 Button 的原生属性；普通 View 分支不保证阻止点击。边界状态由轮播组件自身的 canScrollPrev/canScrollNext 样式控制。 */
     disabled?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 轮播下一项按钮。
+ * @param {Parameters<typeof CarouselNext>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof CarouselNext>[0]["variant"]} props.variant 按钮外观，默认 outline；其余变体同 Button.variant。
+ * @param {Parameters<typeof CarouselNext>[0]["size"]} props.size 按钮尺寸，默认 icon-sm（size-7）；可按 Button.size 选择其他尺寸。
+ * @return {ReturnType<typeof CarouselNext>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Carousel, CarouselNext } from '@open-dy/vibecoding-sdk-taro/ui/carousel'
+ * <Carousel><CarouselNext /></Carousel>
+ * ```
+ */
 declare function CarouselNext({ className, variant, size, ...props }: React.ComponentProps<typeof Button> & {
+    /** @desc 沿用 Button 的原生属性；普通 View 分支不保证阻止点击。边界状态由轮播组件自身的 canScrollPrev/canScrollNext 样式控制。 */
     disabled?: boolean;
 }): React.JSX.Element;
 export { Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext, useCarousel, };