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

package/dist/ui/input.js

@@ -1,6 +1,26 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Input as TaroInput, View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
+/**
+ * @desc 带视觉容器的 Taro 输入框；用于普通小程序和兴趣卡落地页。
+ * @param {InputProps} props 输入属性；value、onInput 等传给原生输入框，className 和 style 作用于外层 View。
+ * @param {Parameters<typeof Input>[0]["className"]} props.className 外层 View 容器的附加类名，控制边框、尺寸和布局；不会传给内部原生 Input。
+ * @param {Parameters<typeof Input>[0]["style"]} props.style 外层 View 的内联样式；内部 Input 使用固定的透明背景和零内边距样式。
+ * @param {Parameters<typeof Input>[0]["value"]} props.value 原生输入值；在 onInput 中更新可构成受控输入，事件值位于 event.detail.value。省略时沿用 Taro Input 行为。
+ * @param {Parameters<typeof Input>[0]["onInput"]} props.onInput 原生 Input 输入事件，值位于 event.detail.value；与 InputOTP.onChange 接收字符串的协议不同。
+ * @param {Parameters<typeof Input>[0]["disabled"]} props.disabled 是否禁用原生 Input，默认 false；同时对外层添加透明度和 pointer-events-none。
+ * @param {Parameters<typeof Input>[0]["type"]} props.type 输入类型，直接传给原生 Taro Input；此组件不做转换，省略时由平台默认行为决定。
+ * @return {React.JSX.Element} 一个带边框、背景、圆角、横向内边距和原生输入框的 View。
+ * @remarks 默认容器使用 h-11、w-full、rounded-lg、border、bg-background、px-3。通过 className 覆写容器，不要在外层再加相同边框、背景或内边距；横向布局的外层 View 只负责 flex 和间距。className 不会直接改变内部原生输入框的 text-sm。
+ * @example
+ * ```tsx
+ * import { Input } from '@open-dy/vibecoding-sdk-taro/ui/input'
+ * import { View } from '@tarojs/components'
+ * export function TaskInput() {
+ *   return <View className="flex gap-3"><Input placeholder="添加任务" className="flex-1 rounded-none border-4 border-black bg-white" /></View>
+ * }
+ * ```
+ */
 function Input({ className, type, disabled = false, "aria-invalid": ariaInvalid, style, ...props }) {
     return (_jsx(View, { "data-slot": "input", "aria-invalid": ariaInvalid, style: style, className: cn("flex h-11 w-full min-w-0 items-center rounded-lg border border-input bg-background px-3 text-base transition-colors outline-none placeholder:text-muted-foreground focus-within:border-ring aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 md:text-sm dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40", disabled && "pointer-events-none cursor-not-allowed opacity-50", className), children: _jsx(TaroInput, { type: type, disabled: disabled, className: "w-full flex-1 text-sm outline-none", ...props, style: { backgroundColor: 'transparent', padding: 0, borderRadius: 0, height: 'auto' } }) }));
 }

package/dist/ui/input.js.map

@@ -1 +1 @@
-{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/ui/input.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE7D,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC,SAAS,KAAK,CAAC,EACb,SAAS,EACT,IAAI,EACJ,QAAQ,GAAG,KAAK,EAChB,cAAc,EAAE,WAAW,EAC3B,KAAK,EACL,GAAG,KAAK,EAGT;IACC,OAAO,CACL,KAAC,IAAI,iBACO,OAAO,kBACH,WAAW,EACzB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,EAAE,CACX,4XAA4X,EAC5X,QAAQ,IAAI,mDAAmD,EAC/D,SAAS,CACV,YAED,KAAC,SAAS,IACR,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAC,oCAAoC,KAC1C,KAAK,EACT,KAAK,EAAE,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GACtF,GACG,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/ui/input.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE7D,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAOjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,KAAK,CAAC,EACb,SAAS,EACT,IAAI,EACJ,QAAQ,GAAG,KAAK,EAChB,cAAc,EAAE,WAAW,EAC3B,KAAK,EACL,GAAG,KAAK,EACG;IACX,OAAO,CACL,KAAC,IAAI,iBACO,OAAO,kBACH,WAAW,EACzB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,EAAE,CACX,4XAA4X,EAC5X,QAAQ,IAAI,mDAAmD,EAC/D,SAAS,CACV,YAED,KAAC,SAAS,IACR,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAC,oCAAoC,KAC1C,KAAK,EACT,KAAK,EAAE,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GACtF,GACG,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/ui/item.d.ts

@@ -2,21 +2,124 @@ import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
 import { Separator } from "./separator.js";
+/**
+ * @desc 信息列表项分组容器。
+ * @param {Parameters<typeof ItemGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup />
+ * ```
+ */
 declare function ItemGroup({ className, children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 信息列表项分隔线。
+ * @param {Parameters<typeof ItemSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemSeparator } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemSeparator /></ItemGroup>
+ * ```
+ */
 declare function ItemSeparator({ className, ...props }: React.ComponentProps<typeof Separator>): React.JSX.Element;
 declare const itemVariants: (props?: ({
     variant?: "default" | "outline" | "muted" | null | undefined;
     size?: "default" | "xs" | "sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 信息列表项组件。
+ * @param {Parameters<typeof Item>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Item>[0]["variant"]} props.variant 项目外观，默认 default（透明边框），outline 描边，muted 使用浅底色。
+ * @param {Parameters<typeof Item>[0]["size"]} props.size 项目密度，默认 default；sm 与 default 使用同组根间距但内嵌媒体更小，xs 进一步缩小间距及说明字号。
+ * @return {ReturnType<typeof Item>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, Item } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><Item /></ItemGroup>
+ * ```
+ */
 declare function Item({ className, variant, size, children, ...props }: ViewProps & VariantProps<typeof itemVariants>): React.JSX.Element;
 declare const itemMediaVariants: (props?: ({
     variant?: "default" | "image" | "icon" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 信息列表项媒体区域。
+ * @param {Parameters<typeof ItemMedia>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof ItemMedia>[0]["variant"]} props.variant 媒体内容样式，默认 default（透明）；icon 调整图标尺寸，image 显示裁切图片框，框尺寸跟随父 Item.size。
+ * @return {ReturnType<typeof ItemMedia>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemMedia } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemMedia /></ItemGroup>
+ * ```
+ */
 declare function ItemMedia({ className, variant, ...props }: ViewProps & VariantProps<typeof itemMediaVariants>): React.JSX.Element;
+/**
+ * @desc 信息列表项内容容器。
+ * @param {Parameters<typeof ItemContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemContent } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemContent /></ItemGroup>
+ * ```
+ */
 declare function ItemContent({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 信息列表项标题。
+ * @param {Parameters<typeof ItemTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemTitle } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemTitle /></ItemGroup>
+ * ```
+ */
 declare function ItemTitle({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 信息列表项说明文本。
+ * @param {Parameters<typeof ItemDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemDescription } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemDescription /></ItemGroup>
+ * ```
+ */
 declare function ItemDescription({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 信息列表项操作区域。
+ * @param {Parameters<typeof ItemActions>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemActions>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemActions } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemActions /></ItemGroup>
+ * ```
+ */
 declare function ItemActions({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 信息列表项头部布局。
+ * @param {Parameters<typeof ItemHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemHeader } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemHeader /></ItemGroup>
+ * ```
+ */
 declare function ItemHeader({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 信息列表项底部布局。
+ * @param {Parameters<typeof ItemFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemFooter } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemFooter /></ItemGroup>
+ * ```
+ */
 declare function ItemFooter({ className, ...props }: ViewProps): React.JSX.Element;
 export { Item, ItemMedia, ItemContent, ItemActions, ItemGroup, ItemSeparator, ItemTitle, ItemDescription, ItemHeader, ItemFooter, };

package/dist/ui/item.js

@@ -8,6 +8,16 @@ const ItemContext = React.createContext({
     size: "default",
     hasDescription: false,
 });
+/**
+ * @desc 信息列表项分组容器。
+ * @param {Parameters<typeof ItemGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup />
+ * ```
+ */
 function ItemGroup({ className, children, ...props }) {
     const childArray = React.Children.toArray(children);
     const groupSize = childArray.find((child) => React.isValidElement(child) && child.type === Item);
@@ -17,6 +27,16 @@ function ItemGroup({ className, children, ...props }) {
                 ? "gap-2.5"
                 : "gap-4", className), ...props, children: children }));
 }
+/**
+ * @desc 信息列表项分隔线。
+ * @param {Parameters<typeof ItemSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemSeparator } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemSeparator /></ItemGroup>
+ * ```
+ */
 function ItemSeparator({ className, ...props }) {
     return (_jsx(Separator, { "data-slot": "item-separator", orientation: "horizontal", className: cn("my-2", className), ...props }));
 }
@@ -38,6 +58,18 @@ const itemVariants = cva("group/item flex w-full flex-wrap items-center rounded-
         size: "default",
     },
 });
+/**
+ * @desc 信息列表项组件。
+ * @param {Parameters<typeof Item>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Item>[0]["variant"]} props.variant 项目外观，默认 default（透明边框），outline 描边，muted 使用浅底色。
+ * @param {Parameters<typeof Item>[0]["size"]} props.size 项目密度，默认 default；sm 与 default 使用同组根间距但内嵌媒体更小，xs 进一步缩小间距及说明字号。
+ * @return {ReturnType<typeof Item>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, Item } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><Item /></ItemGroup>
+ * ```
+ */
 function Item({ className, variant = "default", size, children, ...props }) {
     const resolvedSize = size ?? "default";
     const hasDescription = React.useMemo(() => React.Children.toArray(children).some((child) => React.isValidElement(child) && child.type === ItemDescription), [children]);
@@ -55,27 +87,98 @@ const itemMediaVariants = cva("flex shrink-0 items-center justify-center gap-2 [
         variant: "default",
     },
 });
+/**
+ * @desc 信息列表项媒体区域。
+ * @param {Parameters<typeof ItemMedia>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof ItemMedia>[0]["variant"]} props.variant 媒体内容样式，默认 default（透明）；icon 调整图标尺寸，image 显示裁切图片框，框尺寸跟随父 Item.size。
+ * @return {ReturnType<typeof ItemMedia>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemMedia } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemMedia /></ItemGroup>
+ * ```
+ */
 function ItemMedia({ className, variant = "default", ...props }) {
     const { size, hasDescription } = React.useContext(ItemContext);
     return (_jsx(View, { "data-slot": "item-media", "data-variant": variant, className: cn(itemMediaVariants({ variant }), hasDescription && "translate-y-0.5 self-start", variant === "image" && size === "sm" && "size-8", variant === "image" && size === "xs" && "size-6", className), ...props }));
 }
+/**
+ * @desc 信息列表项内容容器。
+ * @param {Parameters<typeof ItemContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemContent } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemContent /></ItemGroup>
+ * ```
+ */
 function ItemContent({ className, ...props }) {
     const { size } = React.useContext(ItemContext);
     return (_jsx(View, { "data-slot": "item-content", className: cn("flex flex-1 flex-col", size === "xs" ? "gap-0" : "gap-1", className), ...props }));
 }
+/**
+ * @desc 信息列表项标题。
+ * @param {Parameters<typeof ItemTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemTitle } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemTitle /></ItemGroup>
+ * ```
+ */
 function ItemTitle({ className, ...props }) {
     return (_jsx(View, { "data-slot": "item-title", className: cn("line-clamp-1 flex w-fit items-center gap-2 text-sm leading-snug font-medium underline-offset-4", className), ...props }));
 }
+/**
+ * @desc 信息列表项说明文本。
+ * @param {Parameters<typeof ItemDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemDescription } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemDescription /></ItemGroup>
+ * ```
+ */
 function ItemDescription({ className, ...props }) {
     const { size } = React.useContext(ItemContext);
     return (_jsx(View, { "data-slot": "item-description", className: cn("line-clamp-2 text-left text-sm leading-normal font-normal text-muted-foreground [&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-primary", size === "xs" && "text-xs", className), ...props }));
 }
+/**
+ * @desc 信息列表项操作区域。
+ * @param {Parameters<typeof ItemActions>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemActions>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemActions } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemActions /></ItemGroup>
+ * ```
+ */
 function ItemActions({ className, ...props }) {
     return (_jsx(View, { "data-slot": "item-actions", className: cn("flex items-center gap-2", className), ...props }));
 }
+/**
+ * @desc 信息列表项头部布局。
+ * @param {Parameters<typeof ItemHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemHeader } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemHeader /></ItemGroup>
+ * ```
+ */
 function ItemHeader({ className, ...props }) {
     return (_jsx(View, { "data-slot": "item-header", className: cn("flex basis-full items-center justify-between gap-2", className), ...props }));
 }
+/**
+ * @desc 信息列表项底部布局。
+ * @param {Parameters<typeof ItemFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ItemFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ItemGroup, ItemFooter } from '@open-dy/vibecoding-sdk-taro/ui/item'
+ * <ItemGroup><ItemFooter /></ItemGroup>
+ * ```
+ */
 function ItemFooter({ className, ...props }) {
     return (_jsx(View, { "data-slot": "item-footer", className: cn("flex basis-full items-center justify-between gap-2", className), ...props }));
 }

package/dist/ui/item.js.map

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

package/dist/ui/label.d.ts

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

package/dist/ui/label.js

@@ -1,6 +1,16 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Label as TaroLabel } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
+/**
+ * @desc 标签组件。
+ * @param {Parameters<typeof Label>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Label>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Label } from '@open-dy/vibecoding-sdk-taro/ui/label'
+ * <Label />
+ * ```
+ */
 function Label({ className, ...props }) {
     return (_jsx(TaroLabel, { "data-slot": "label", className: cn("flex items-center gap-2 text-sm leading-none font-medium select-none peer-disabled:cursor-not-allowed peer-disabled:opacity-50", className), ...props }));
 }

package/dist/ui/label.js.map

@@ -1 +1 @@
-{"version":3,"file":"label.js","sourceRoot":"","sources":["../../src/ui/label.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC,SAAS,KAAK,CAAC,EACb,SAAS,EACT,GAAG,KAAK,EACyC;IACjD,OAAO,CACL,KAAC,SAAS,iBACE,OAAO,EACjB,SAAS,EAAE,EAAE,CACX,gIAAgI,EAChI,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"label.js","sourceRoot":"","sources":["../../src/ui/label.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC;;;;;;;;;GASG;AACH,SAAS,KAAK,CAAC,EACb,SAAS,EACT,GAAG,KAAK,EACyC;IACjD,OAAO,CACL,KAAC,SAAS,iBACE,OAAO,EACjB,SAAS,EAAE,EAAE,CACX,gIAAgI,EAChI,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/ui/menubar.d.ts

@@ -2,64 +2,257 @@ import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 type MenuSide = "top" | "bottom" | "left" | "right";
 type MenuAlign = "start" | "center" | "end";
+/**
+ * @desc 菜单栏组件。
+ * @param {Parameters<typeof Menubar>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Menubar>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar />
+ * ```
+ */
 declare function Menubar({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 菜单栏Menu。
+ * @param {Parameters<typeof MenubarMenu>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarMenu>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarMenu /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarMenu({ children }: {
+    /** @desc 当前菜单的触发器和内容区；应放在 Menubar 内，同一 Menubar 同时只展开一个菜单。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏分组容器。
+ * @param {Parameters<typeof MenubarGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarGroup } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarGroup /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarGroup({ ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 菜单栏跨层级渲染入口。
+ * @param {Parameters<typeof MenubarPortal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarPortal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarPortal } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarPortal /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarPortal({ children }: {
+    /** @desc 要渲染的子节点；该兼容包装只返回 Fragment，不额外创建原生容器或执行挂载迁移。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏触发器。
+ * @param {Parameters<typeof MenubarTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarTrigger /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarTrigger({ className, onClick, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 菜单栏内容容器。
+ * @param {Parameters<typeof MenubarContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarContent } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarContent /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarContent({ className, align, side, sideOffset, children, ...props }: ViewProps & {
+    /** @desc 相对触发器的对齐位置：start 起端、center 居中、end 末端；默认 start。 */
     align?: MenuAlign;
+    /** @desc 内容出现的方向：top、bottom、left 或 right；默认 bottom，定位时会结合视口边界调整。 */
     side?: MenuSide;
+    /** @desc 内容与触发器之间的间距，单位为像素，默认 4；参与测量后的浮层定位。 */
     sideOffset?: number;
 }): React.JSX.Element | null;
+/**
+ * @desc 菜单栏条目。
+ * @param {Parameters<typeof MenubarItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarItem } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarItem /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarItem({ className, inset, variant, disabled, closeOnSelect, onClick, ...props }: ViewProps & {
+    /** @desc 是否使用左侧缩进以对齐选择指示，默认 false；为 true 时使用 pl-7。 */
     inset?: boolean;
+    /** @desc 项目视觉样式，默认 default；destructive 使用危险操作色，仅影响样式。 */
     variant?: "default" | "destructive";
+    /** @desc 是否禁止当前项的内部点击操作；默认可操作，禁用后不触发内部选择或关闭逻辑。 */
     disabled?: boolean;
+    /** @desc 点击操作后是否关闭父菜单，默认 true；为 false 时保留展开状态。 */
     closeOnSelect?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏复选条目。
+ * @param {Parameters<typeof MenubarCheckboxItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarCheckboxItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarCheckboxItem } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarCheckboxItem /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarCheckboxItem({ className, children, checked: checkedProp, defaultChecked, onCheckedChange, inset, disabled, closeOnSelect, onClick, ...props }: ViewProps & {
+    /** @desc 受控选中状态；传入后以该值为准，需在 onCheckedChange 中更新。省略时由内部状态管理。 */
     checked?: boolean;
+    /** @desc 非受控模式的初始选中状态，默认 false；仅初始化时读取，传入 checked 后不生效。 */
     defaultChecked?: boolean;
+    /** @desc 用户点击切换时调用，参数为下一选中状态；禁用时不触发，受控模式需同步 checked。 */
     onCheckedChange?: (checked: boolean) => void;
+    /** @desc 是否使用左侧缩进以对齐选择指示，默认 false；为 true 时使用 pl-7。 */
     inset?: boolean;
+    /** @desc 是否禁止当前项的内部点击操作；默认可操作，禁用后不触发内部选择或关闭逻辑。 */
     disabled?: boolean;
+    /** @desc 切换勾选后是否关闭父菜单，默认 false；可在菜单内连续勾选多项。 */
     closeOnSelect?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏单选分组。
+ * @param {Parameters<typeof MenubarRadioGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarRadioGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarRadioGroup } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarRadioGroup /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarRadioGroup({ value: valueProp, defaultValue, onValueChange, ...props }: ViewProps & {
+    /** @desc 受控选中项的标识；传入后以该值为准，需在 onValueChange 中更新。省略时由内部状态管理。 */
     value?: string;
+    /** @desc 非受控模式的初始选中项；省略时没有选中项，传入 value 后不生效。 */
     defaultValue?: string;
+    /** @desc 用户选择项目时调用，参数为下一选中项标识；受控模式需由调用方同步 value。 */
     onValueChange?: (value: string) => void;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏单选条目。
+ * @param {Parameters<typeof MenubarRadioItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarRadioItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarRadioItem } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarRadioItem value="one" /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarRadioItem({ className, children, value, checked: checkedProp, inset, disabled, closeOnSelect, onClick, ...props }: ViewProps & {
+    /** @desc 当前选项的唯一标识，点击时传给父 MenubarRadioGroup.onValueChange。 */
     value: string;
+    /** @desc 选中指示的可选覆盖值；省略时按父单选组 value 判断。传入后调用方需同步该值。 */
     checked?: boolean;
+    /** @desc 是否使用左侧缩进以对齐选择指示，默认 false；为 true 时使用 pl-7。 */
     inset?: boolean;
+    /** @desc 是否禁止当前项的内部点击操作；默认可操作，禁用后不触发内部选择或关闭逻辑。 */
     disabled?: boolean;
+    /** @desc 点击选择后是否关闭父菜单，默认 false；为 true 时请求关闭父菜单。 */
     closeOnSelect?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏标签文本。
+ * @param {Parameters<typeof MenubarLabel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarLabel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarLabel } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarLabel /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarLabel({ className, inset, ...props }: ViewProps & {
+    /** @desc 是否使用左侧缩进以对齐选择指示，默认 false；为 true 时使用 pl-7。 */
     inset?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏分隔线。
+ * @param {Parameters<typeof MenubarSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarSeparator } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarSeparator /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarSeparator({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 菜单栏快捷键说明。
+ * @param {Parameters<typeof MenubarShortcut>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarShortcut>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarShortcut } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarShortcut /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarShortcut({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 菜单栏子菜单上下文。
+ * @param {Parameters<typeof MenubarSub>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarSub>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarSub } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarSub /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarSub({ open: openProp, defaultOpen, onOpenChange, children, }: {
+    /** @desc 受控展开状态；传入后以该值为准，需在 onOpenChange 中更新。省略时由组件内部管理。 */
     open?: boolean;
+    /** @desc 非受控模式的初始展开状态，默认 false；仅初始化时读取，传入 open 后不生效。 */
     defaultOpen?: boolean;
+    /** @desc 触发器或关闭操作请求改变展开状态时调用，参数为下一状态；受控模式需由调用方同步 open。 */
     onOpenChange?: (open: boolean) => void;
+    /** @desc 同一实例的触发器、内容区等组合子组件；省略时不显示内容，子组件通过上下文共享状态。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏子菜单触发器。
+ * @param {Parameters<typeof MenubarSubTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarSubTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarSubTrigger } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarSubTrigger /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarSubTrigger({ className, inset, disabled, children, onClick, ...props }: ViewProps & {
+    /** @desc 是否使用左侧缩进以对齐选择指示，默认 false；为 true 时使用 pl-7。 */
     inset?: boolean;
+    /** @desc 是否禁止当前项的内部点击操作；默认可操作，禁用后不触发内部选择或关闭逻辑。 */
     disabled?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 菜单栏子菜单内容。
+ * @param {Parameters<typeof MenubarSubContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof MenubarSubContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarSubContent } from '@open-dy/vibecoding-sdk-taro/ui/menubar'
+ * <Menubar><MenubarMenu><MenubarSubContent /></MenubarMenu></Menubar>
+ * ```
+ */
 declare function MenubarSubContent({ className, align, side, sideOffset, children, ...props }: ViewProps & {
+    /** @desc 相对触发器的对齐位置：start 起端、center 居中、end 末端；默认 start。 */
     align?: MenuAlign;
+    /** @desc 内容出现的方向：top、bottom、left 或 right；默认 right，定位时会结合视口边界调整。 */
     side?: MenuSide;
+    /** @desc 内容与触发器之间的间距，单位为像素，默认 4；参与测量后的浮层定位。 */
     sideOffset?: number;
 }): React.JSX.Element | null;
 export { Menubar, MenubarPortal, MenubarMenu, MenubarTrigger, MenubarContent, MenubarGroup, MenubarSeparator, MenubarLabel, MenubarItem, MenubarShortcut, MenubarCheckboxItem, MenubarRadioGroup, MenubarRadioItem, MenubarSub, MenubarSubTrigger, MenubarSubContent, };