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

package/dist/ui/slider.js.map

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

package/dist/ui/sonner.d.ts

@@ -1,6 +1,29 @@
+/**
+ * @desc 通过 Taro.showToast 显示轻提示；默认 icon 为 none，duration 为 2000 毫秒。
+ * @param {Parameters<typeof toast>[0]} message 提示文本。
+ * @param {Parameters<typeof toast>[1]} options 轻提示图标和持续时间（毫秒）。
+ * @return {ReturnType<typeof toast>} 没有返回值。
+ * @example
+ * ```tsx
+ * import { toast } from '@open-dy/vibecoding-sdk-taro/ui/sonner'
+ * toast('已保存', { duration: 2000 })
+ * ```
+ */
 declare function toast(message: string, options?: {
+    /** @desc 原生提示图标，默认 "none"；当前透传给 Taro.showToast，可用值及表现受目标平台约束（类型未收窄）。 */
     icon?: string;
+    /** @desc 显示时长，单位毫秒，默认 2000；透传给 Taro.showToast。 */
     duration?: number;
 }): void;
+/**
+ * @desc 轻提示的兼容入口；当前返回 null，不创建独立提示容器。
+ * @param 无参数
+ * @return {ReturnType<typeof Toaster>} 固定返回 null。
+ * @example
+ * ```tsx
+ * import { Toaster } from '@open-dy/vibecoding-sdk-taro/ui/sonner'
+ * <Toaster />
+ * ```
+ */
 declare function Toaster(): null;
 export { Toaster, toast };

package/dist/ui/sonner.js

@@ -1,4 +1,15 @@
 import Taro from "@tarojs/taro";
+/**
+ * @desc 通过 Taro.showToast 显示轻提示；默认 icon 为 none，duration 为 2000 毫秒。
+ * @param {Parameters<typeof toast>[0]} message 提示文本。
+ * @param {Parameters<typeof toast>[1]} options 轻提示图标和持续时间（毫秒）。
+ * @return {ReturnType<typeof toast>} 没有返回值。
+ * @example
+ * ```tsx
+ * import { toast } from '@open-dy/vibecoding-sdk-taro/ui/sonner'
+ * toast('已保存', { duration: 2000 })
+ * ```
+ */
 function toast(message, options) {
     Taro.showToast({
         title: message,
@@ -6,6 +17,16 @@ function toast(message, options) {
         duration: options?.duration ?? 2000,
     });
 }
+/**
+ * @desc 轻提示的兼容入口；当前返回 null，不创建独立提示容器。
+ * @param 无参数
+ * @return {ReturnType<typeof Toaster>} 固定返回 null。
+ * @example
+ * ```tsx
+ * import { Toaster } from '@open-dy/vibecoding-sdk-taro/ui/sonner'
+ * <Toaster />
+ * ```
+ */
 function Toaster() {
     return null;
 }

package/dist/ui/sonner.js.map

@@ -1 +1 @@
-{"version":3,"file":"sonner.js","sourceRoot":"","sources":["../../src/ui/sonner.tsx"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,cAAc,CAAA;AAE/B,SAAS,KAAK,CAAC,OAAe,EAAE,OAA8C;IAC5E,IAAI,CAAC,SAAS,CAAC;QACb,KAAK,EAAE,OAAO;QACd,IAAI,EAAG,OAAO,EAAE,IAAiD,IAAI,MAAM;QAC3E,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI;KACpC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,OAAO;IACd,OAAO,IAAI,CAAA;AACb,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"sonner.js","sourceRoot":"","sources":["../../src/ui/sonner.tsx"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,cAAc,CAAA;AAE/B;;;;;;;;;;GAUG;AACH,SAAS,KAAK,CAAC,OAAe,EAAE,OAIX;IACnB,IAAI,CAAC,SAAS,CAAC;QACb,KAAK,EAAE,OAAO;QACd,IAAI,EAAG,OAAO,EAAE,IAAiD,IAAI,MAAM;QAC3E,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI;KACpC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,OAAO;IACd,OAAO,IAAI,CAAA;AACb,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/ui/spinner.d.ts

@@ -1,3 +1,13 @@
 import { type ViewProps } from "@tarojs/components";
+/**
+ * @desc 加载指示器组件。
+ * @param {Parameters<typeof Spinner>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Spinner>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Spinner } from '@open-dy/vibecoding-sdk-taro/ui/spinner'
+ * <Spinner />
+ * ```
+ */
 declare function Spinner({ className, ...props }: ViewProps): import("react").JSX.Element;
 export { Spinner };

package/dist/ui/spinner.js

@@ -2,6 +2,16 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
 import { Loader } from "@open-dy/lucide-taro";
+/**
+ * @desc 加载指示器组件。
+ * @param {Parameters<typeof Spinner>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Spinner>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Spinner } from '@open-dy/vibecoding-sdk-taro/ui/spinner'
+ * <Spinner />
+ * ```
+ */
 function Spinner({ className, ...props }) {
     return (_jsx(View, { "data-slot": "spinner", className: cn("inline-flex items-center justify-center", className), ...props, children: _jsx(Loader, { className: "size-4 animate-spin" }) }));
 }

package/dist/ui/spinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/ui/spinner.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,SAAS,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACjD,OAAO,CACL,KAAC,IAAI,iBAAW,SAAS,EAAC,SAAS,EAAE,EAAE,CAAC,yCAAyC,EAAE,SAAS,CAAC,KAAM,KAAK,YACtG,KAAC,MAAM,IAAC,SAAS,EAAC,qBAAqB,GAAG,GACrC,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/ui/spinner.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C;;;;;;;;;GASG;AACH,SAAS,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACjD,OAAO,CACL,KAAC,IAAI,iBAAW,SAAS,EAAC,SAAS,EAAE,EAAE,CAAC,yCAAyC,EAAE,SAAS,CAAC,KAAM,KAAK,YACtG,KAAC,MAAM,IAAC,SAAS,EAAC,qBAAqB,GAAG,GACrC,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/dist/ui/switch.d.ts

@@ -1,11 +1,26 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 type SwitchProps = ViewProps & {
+    /** @desc 开关尺寸，默认 default；default 为较大轨道和滑块，sm 为紧凑轨道和滑块。 */
     size?: "sm" | "default";
+    /** @desc 受控选中状态；传入后以该值为准，需在 onCheckedChange 中更新。省略时由内部状态管理。 */
     checked?: boolean;
+    /** @desc 非受控模式的初始选中状态，默认 false；仅初始化时读取，传入 checked 后不生效。 */
     defaultChecked?: boolean;
+    /** @desc 用户点击切换时调用，参数为下一选中状态；禁用时不触发，受控模式需同步 checked。 */
     onCheckedChange?: (checked: boolean) => void;
+    /** @desc 是否禁止用户切换；省略或 false 时可操作，true 时不触发内部切换回调。 */
     disabled?: boolean;
 };
+/**
+ * @desc 开关组件。
+ * @param {Parameters<typeof Switch>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Switch>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Switch } from '@open-dy/vibecoding-sdk-taro/ui/switch'
+ * <Switch />
+ * ```
+ */
 declare function Switch({ className, size, checked: checkedProp, defaultChecked, onCheckedChange, disabled, ...props }: SwitchProps): React.JSX.Element;
 export { Switch };

package/dist/ui/switch.js

@@ -14,6 +14,16 @@ const SWITCH_SIZE_STYLES = {
         translateChecked: "translate-x-3.5",
     },
 };
+/**
+ * @desc 开关组件。
+ * @param {Parameters<typeof Switch>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Switch>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Switch } from '@open-dy/vibecoding-sdk-taro/ui/switch'
+ * <Switch />
+ * ```
+ */
 function Switch({ className, size = "default", checked: checkedProp, defaultChecked, onCheckedChange, disabled, ...props }) {
     const [internalChecked, setInternalChecked] = React.useState(defaultChecked ?? false);
     const isControlled = checkedProp !== undefined;

package/dist/ui/switch.js.map

@@ -1 +1 @@
-{"version":3,"file":"switch.js","sourceRoot":"","sources":["../../src/ui/switch.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAEzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAUjC,MAAM,kBAAkB,GAAG;IACzB,EAAE,EAAE;QACF,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,QAAQ;QACf,gBAAgB,EAAE,iBAAiB;KACpC;IACD,OAAO,EAAE;QACP,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,QAAQ;QACf,gBAAgB,EAAE,iBAAiB;KACpC;CACO,CAAA;AAEV,SAAS,MAAM,CAAC,EACd,SAAS,EACT,IAAI,GAAG,SAAS,EAChB,OAAO,EAAE,WAAW,EACpB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,GAAG,KAAK,EACI;IACZ,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC,CAAA;IACrF,MAAM,YAAY,GAAG,WAAW,KAAK,SAAS,CAAA;IAC9C,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAA;IACnE,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;IAE3C,OAAO,CACL,KAAC,IAAI,iBACO,QAAQ,eACP,IAAI,kBACD,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,oBACjC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,mBACrC,QAAQ,IAAI,SAAS,EACpC,SAAS,EAAE,EAAE,CACX,+ZAA+Z,EAC/Z,UAAU,CAAC,KAAK,EAChB,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,EAC1C,QAAQ,IAAI,+BAA+B,EAC3C,SAAS,CACV,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,QAAQ;gBAAE,OAAM;YACpB,KAAK,CAAC,eAAe,EAAE,CAAA;YACvB,MAAM,IAAI,GAAG,CAAC,cAAc,CAAA;YAC5B,IAAI,CAAC,YAAY;gBAAE,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAC3C,eAAe,EAAE,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC,KACG,KAAK,YAET,KAAC,IAAI,iBACO,cAAc,kBACV,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,oBACjC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EACpD,SAAS,EAAE,EAAE,CACX,kFAAkF,EAClF,UAAU,CAAC,KAAK,EAChB,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,EAC9D,cAAc,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,oBAAoB,CACrE,GACD,GACG,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}
+{"version":3,"file":"switch.js","sourceRoot":"","sources":["../../src/ui/switch.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAEzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAejC,MAAM,kBAAkB,GAAG;IACzB,EAAE,EAAE;QACF,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,QAAQ;QACf,gBAAgB,EAAE,iBAAiB;KACpC;IACD,OAAO,EAAE;QACP,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,QAAQ;QACf,gBAAgB,EAAE,iBAAiB;KACpC;CACO,CAAA;AAEV;;;;;;;;;GASG;AACH,SAAS,MAAM,CAAC,EACd,SAAS,EACT,IAAI,GAAG,SAAS,EAChB,OAAO,EAAE,WAAW,EACpB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,GAAG,KAAK,EACI;IACZ,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC,CAAA;IACrF,MAAM,YAAY,GAAG,WAAW,KAAK,SAAS,CAAA;IAC9C,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAA;IACnE,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;IAE3C,OAAO,CACL,KAAC,IAAI,iBACO,QAAQ,eACP,IAAI,kBACD,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,oBACjC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,mBACrC,QAAQ,IAAI,SAAS,EACpC,SAAS,EAAE,EAAE,CACX,+ZAA+Z,EAC/Z,UAAU,CAAC,KAAK,EAChB,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,EAC1C,QAAQ,IAAI,+BAA+B,EAC3C,SAAS,CACV,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,QAAQ;gBAAE,OAAM;YACpB,KAAK,CAAC,eAAe,EAAE,CAAA;YACvB,MAAM,IAAI,GAAG,CAAC,cAAc,CAAA;YAC5B,IAAI,CAAC,YAAY;gBAAE,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAC3C,eAAe,EAAE,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC,KACG,KAAK,YAET,KAAC,IAAI,iBACO,cAAc,kBACV,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,oBACjC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EACpD,SAAS,EAAE,EAAE,CACX,kFAAkF,EAClF,UAAU,CAAC,KAAK,EAChB,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,EAC9D,cAAc,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,oBAAoB,CACrE,GACD,GACG,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/ui/table.d.ts

@@ -1,13 +1,94 @@
 import { type ViewProps } from "@tarojs/components";
 type TableCellProps = ViewProps & {
+    /** @desc 兼容的列占比参数；TableCell 仅在传入 style 且未用 w-* 类固定宽度时转换为 flexGrow，并非原生表格合并。TableHead 不做此转换。 */
     colSpan?: number;
 };
+/**
+ * @desc 表格组件。
+ * @param {Parameters<typeof Table>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Table>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table />
+ * ```
+ */
 declare function Table({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 表格头部布局。
+ * @param {Parameters<typeof TableHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableHeader } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableHeader /></Table>
+ * ```
+ */
 declare function TableHeader({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 表格主体区域。
+ * @param {Parameters<typeof TableBody>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableBody>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableBody } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableBody /></Table>
+ * ```
+ */
 declare function TableBody({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 表格底部布局。
+ * @param {Parameters<typeof TableFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableFooter } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableFooter /></Table>
+ * ```
+ */
 declare function TableFooter({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 表格行容器。
+ * @param {Parameters<typeof TableRow>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableRow>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableRow } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableRow /></Table>
+ * ```
+ */
 declare function TableRow({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 表格表头单元格。
+ * @param {Parameters<typeof TableHead>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableHead>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableHead } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableHead /></Table>
+ * ```
+ */
 declare function TableHead({ className, ...props }: TableCellProps): import("react").JSX.Element;
+/**
+ * @desc 表格单元格。
+ * @param {Parameters<typeof TableCell>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableCell>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableCell } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableCell /></Table>
+ * ```
+ */
 declare function TableCell({ className, colSpan, style, ...props }: TableCellProps): import("react").JSX.Element;
+/**
+ * @desc 表格的说明文本。
+ * @param {Parameters<typeof TableCaption>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableCaption>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableCaption } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableCaption /></Table>
+ * ```
+ */
 declare function TableCaption({ className, ...props }: ViewProps): import("react").JSX.Element;
 export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, };

package/dist/ui/table.js

@@ -18,21 +18,81 @@ function getColSpanStyle(colSpan, className, style) {
     }
     return style;
 }
+/**
+ * @desc 表格组件。
+ * @param {Parameters<typeof Table>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Table>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table />
+ * ```
+ */
 function Table({ className, ...props }) {
     return (_jsx(View, { "data-slot": "table-container", className: "relative w-full overflow-x-auto", children: _jsx(View, { "data-slot": "table", className: cn("w-full caption-bottom text-sm", className), ...props }) }));
 }
+/**
+ * @desc 表格头部布局。
+ * @param {Parameters<typeof TableHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableHeader } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableHeader /></Table>
+ * ```
+ */
 function TableHeader({ className, ...props }) {
     return (_jsx(View, { "data-slot": "table-header", className: cn("[&>*]:border-b", className), ...props }));
 }
+/**
+ * @desc 表格主体区域。
+ * @param {Parameters<typeof TableBody>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableBody>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableBody } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableBody /></Table>
+ * ```
+ */
 function TableBody({ className, ...props }) {
     return (_jsx(View, { "data-slot": "table-body", className: cn("[&>*:last-child]:border-0", className), ...props }));
 }
+/**
+ * @desc 表格底部布局。
+ * @param {Parameters<typeof TableFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableFooter } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableFooter /></Table>
+ * ```
+ */
 function TableFooter({ className, ...props }) {
     return (_jsx(View, { "data-slot": "table-footer", className: cn("border-t bg-muted/50 font-medium [&>*:last-child]:border-b-0", className), ...props }));
 }
+/**
+ * @desc 表格行容器。
+ * @param {Parameters<typeof TableRow>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableRow>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableRow } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableRow /></Table>
+ * ```
+ */
 function TableRow({ className, ...props }) {
     return (_jsx(View, { "data-slot": "table-row", className: cn("flex border-b transition-colors hover:bg-muted/50 aria-selected:bg-muted", className), ...props }));
 }
+/**
+ * @desc 表格表头单元格。
+ * @param {Parameters<typeof TableHead>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableHead>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableHead } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableHead /></Table>
+ * ```
+ */
 function TableHead({ className, ...props }) {
     return (_jsx(View, { "data-slot": "table-head", className: cn("h-10 px-2 text-left align-middle font-medium whitespace-nowrap text-foreground flex flex-1 basis-0 min-w-0 items-center justify-start", typeof className === "string" && /(^|\s)text-right(\s|$)/.test(className)
             ? "justify-end"
@@ -40,6 +100,16 @@ function TableHead({ className, ...props }) {
             ? "flex-none basis-auto"
             : null, className), ...props }));
 }
+/**
+ * @desc 表格单元格。
+ * @param {Parameters<typeof TableCell>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableCell>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableCell } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableCell /></Table>
+ * ```
+ */
 function TableCell({ className, colSpan, style, ...props }) {
     return (_jsx(View, { "data-slot": "table-cell", style: getColSpanStyle(colSpan, className, style), className: cn("p-2 align-middle whitespace-nowrap flex flex-1 basis-0 min-w-0 items-center justify-start", typeof className === "string" && /(^|\s)text-right(\s|$)/.test(className)
             ? "justify-end"
@@ -47,6 +117,16 @@ function TableCell({ className, colSpan, style, ...props }) {
             ? "flex-none basis-auto"
             : null, className), ...props }));
 }
+/**
+ * @desc 表格的说明文本。
+ * @param {Parameters<typeof TableCaption>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableCaption>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableCaption } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableCaption /></Table>
+ * ```
+ */
 function TableCaption({ className, ...props }) {
     return (_jsx(View, { "data-slot": "table-caption", className: cn("mt-4 text-sm text-muted-foreground", className), ...props }));
 }

package/dist/ui/table.js.map

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

package/dist/ui/tabs.d.ts

@@ -1,23 +1,82 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
+/**
+ * @desc 标签页组件。
+ * @param {Parameters<typeof Tabs>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Tabs>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs />
+ * ```
+ */
 declare function Tabs({ className, orientation, value: valueProp, defaultValue, onValueChange, children, ...props }: ViewProps & {
+    /** @desc 页签排列方向：horizontal 横排、vertical 竖排；默认 horizontal，同时影响触发器和内容区布局。 */
     orientation?: "horizontal" | "vertical";
+    /** @desc 受控选中项的标识；传入后以该值为准，需在 onValueChange 中更新。省略时由内部状态管理。 */
     value?: string;
+    /** @desc 非受控模式的初始选中页签，默认空字符串（没有选中项）；传入 value 后不生效。 */
     defaultValue?: string;
+    /** @desc 用户选择项目时调用，参数为下一选中项标识；受控模式需由调用方同步 value。 */
     onValueChange?: (value: string) => void;
 }): React.JSX.Element;
+/**
+ * @desc 生成标签页列表的样式类名；接受其声明的样式变体。
+ * @param {Parameters<typeof tabsListVariants>[0]} props 样式变体以及附加的 class 或 className。
+ * @param {Parameters<typeof tabsListVariants>[0]["variant"]} props.variant 列表样式，默认 default（圆角底色），line 为透明底；同时通过上下文控制触发器的选中下划线。
+ * @return {string} 合并后的样式类名。
+ * @example
+ * ```tsx
+ * import { tabsListVariants } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * tabsListVariants()
+ * ```
+ */
 declare const tabsListVariants: (props?: ({
     variant?: "default" | "line" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 标签页列表容器。
+ * @param {Parameters<typeof TabsList>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsList>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsList } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsList /></Tabs>
+ * ```
+ */
 declare function TabsList({ className, variant, ...props }: ViewProps & VariantProps<typeof tabsListVariants> & {
+    /** @desc 页签列表样式，默认 default（圆角底色），line 为透明底和选中下划线；由上下文影响 TabsTrigger。 */
     variant?: "default" | "line";
 }): React.JSX.Element;
+/**
+ * @desc 标签页触发器。
+ * @param {Parameters<typeof TabsTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsTrigger } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsTrigger value="one" /></Tabs>
+ * ```
+ */
 declare function TabsTrigger({ className, value, children, disabled, ...props }: ViewProps & {
+    /** @desc 当前项目的唯一标识；必须与父组件的 value/defaultValue 对应，不同项目使用不同值。 */
     value: string;
+    /** @desc 是否禁用当前页签；默认可操作，禁用后不执行内部页签切换。 */
     disabled?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 标签页内容容器。
+ * @param {Parameters<typeof TabsContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsContent } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsContent value="one" /></Tabs>
+ * ```
+ */
 declare function TabsContent({ className, value, children, ...props }: ViewProps & {
+    /** @desc 内容区对应的页签标识；须与 TabsTrigger.value 相同，仅父 Tabs.value 匹配时渲染。 */
     value: string;
 }): React.JSX.Element | null;
 export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants };

package/dist/ui/tabs.js

@@ -6,6 +6,16 @@ import { cn } from "../lib/utils.js";
 import { collectDataIconState } from "./helpers.js";
 const TabsContext = React.createContext({});
 const TabsListContext = React.createContext({});
+/**
+ * @desc 标签页组件。
+ * @param {Parameters<typeof Tabs>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Tabs>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs />
+ * ```
+ */
 function Tabs({ className, orientation = "horizontal", value: valueProp, defaultValue, onValueChange, children, ...props }) {
     const [internal, setInternal] = React.useState(defaultValue ?? "");
     const controlled = valueProp !== undefined;
@@ -20,6 +30,17 @@ function Tabs({ className, orientation = "horizontal", value: valueProp, default
             orientation,
         }, children: _jsx(View, { "data-slot": "tabs", className: cn("group/tabs flex gap-2", orientation === "horizontal" && "flex-col", className), ...props, children: children }) }));
 }
+/**
+ * @desc 生成标签页列表的样式类名；接受其声明的样式变体。
+ * @param {Parameters<typeof tabsListVariants>[0]} props 样式变体以及附加的 class 或 className。
+ * @param {Parameters<typeof tabsListVariants>[0]["variant"]} props.variant 列表样式，默认 default（圆角底色），line 为透明底；同时通过上下文控制触发器的选中下划线。
+ * @return {string} 合并后的样式类名。
+ * @example
+ * ```tsx
+ * import { tabsListVariants } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * tabsListVariants()
+ * ```
+ */
 const tabsListVariants = cva("group/tabs-list inline-flex w-fit items-center justify-center p-1 text-muted-foreground", {
     variants: {
         variant: {
@@ -31,10 +52,30 @@ const tabsListVariants = cva("group/tabs-list inline-flex w-fit items-center jus
         variant: "default",
     },
 });
+/**
+ * @desc 标签页列表容器。
+ * @param {Parameters<typeof TabsList>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsList>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsList } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsList /></Tabs>
+ * ```
+ */
 function TabsList({ className, variant = "default", ...props }) {
     const tabs = React.useContext(TabsContext);
     return (_jsx(TabsListContext.Provider, { value: { variant }, children: _jsx(View, { "data-slot": "tabs-list", className: cn(tabsListVariants({ variant }), tabs.orientation === "horizontal" && "h-8", tabs.orientation === "vertical" && "h-fit flex-col", className), ...props }) }));
 }
+/**
+ * @desc 标签页触发器。
+ * @param {Parameters<typeof TabsTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsTrigger } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsTrigger value="one" /></Tabs>
+ * ```
+ */
 function TabsTrigger({ className, value, children, disabled, ...props }) {
     const ctx = React.useContext(TabsContext);
     const list = React.useContext(TabsListContext);
@@ -51,6 +92,16 @@ function TabsTrigger({ className, value, children, disabled, ...props }) {
             ctx.onValueChange?.(value);
         }, ...props, children: children }));
 }
+/**
+ * @desc 标签页内容容器。
+ * @param {Parameters<typeof TabsContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsContent } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsContent value="one" /></Tabs>
+ * ```
+ */
 function TabsContent({ className, value, children, ...props }) {
     const ctx = React.useContext(TabsContext);
     if (ctx.value !== value)

package/dist/ui/tabs.js.map

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

package/dist/ui/textarea.d.ts

@@ -1,3 +1,16 @@
 import { Textarea as TaroTextarea } from "@tarojs/components";
+/**
+ * @desc 多行输入框组件。
+ * @param {Parameters<typeof Textarea>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Textarea>[0]["className"]} props.className 外层 View 的附加类名；内部 Textarea 使用自己的填满容器样式。
+ * @param {Parameters<typeof Textarea>[0]["style"]} props.style 外层 View 的内联样式；不会原样传给内部 Textarea。
+ * @param {Parameters<typeof Textarea>[0]["onInput"]} props.onInput 原生 Textarea 输入事件，文字值从 event.detail.value 读取；调用方自行同步输入状态。
+ * @return {ReturnType<typeof Textarea>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Textarea } from '@open-dy/vibecoding-sdk-taro/ui/textarea'
+ * <Textarea />
+ * ```
+ */
 declare function Textarea({ className, style, ...props }: React.ComponentPropsWithoutRef<typeof TaroTextarea>): import("react").JSX.Element;
 export { Textarea };

package/dist/ui/textarea.js

@@ -1,6 +1,19 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Textarea as TaroTextarea, View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
+/**
+ * @desc 多行输入框组件。
+ * @param {Parameters<typeof Textarea>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Textarea>[0]["className"]} props.className 外层 View 的附加类名；内部 Textarea 使用自己的填满容器样式。
+ * @param {Parameters<typeof Textarea>[0]["style"]} props.style 外层 View 的内联样式；不会原样传给内部 Textarea。
+ * @param {Parameters<typeof Textarea>[0]["onInput"]} props.onInput 原生 Textarea 输入事件，文字值从 event.detail.value 读取；调用方自行同步输入状态。
+ * @return {ReturnType<typeof Textarea>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Textarea } from '@open-dy/vibecoding-sdk-taro/ui/textarea'
+ * <Textarea />
+ * ```
+ */
 function Textarea({ className, style, ...props }) {
     const disabled = !!props.disabled;
     const ariaInvalid = props["aria-invalid"];