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

package/dist/ui/dropdown-menu.js

@@ -4,6 +4,16 @@ import { View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
 import { Check, ChevronRight, Circle } from "@open-dy/lucide-taro";
 const DropdownMenuContext = React.createContext({ open: false, onOpenChange: () => { } });
+/**
+ * @desc 下拉菜单组件。
+ * @param {Parameters<typeof DropdownMenu>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenu>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu />
+ * ```
+ */
 function DropdownMenu({ open: openProp, defaultOpen, onOpenChange, children, }) {
     const [internal, setInternal] = React.useState(defaultOpen ?? false);
     const controlled = openProp !== undefined;
@@ -17,6 +27,16 @@ function DropdownMenu({ open: openProp, defaultOpen, onOpenChange, children, })
             },
         }, children: _jsx(View, { "data-slot": "dropdown-menu", className: "relative z-50 inline-block", children: children }) }));
 }
+/**
+ * @desc 下拉菜单触发器。
+ * @param {Parameters<typeof DropdownMenuTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuTrigger /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuTrigger({ children, render, onClick, ...props }) {
     const { onOpenChange, open } = React.useContext(DropdownMenuContext);
     const handleClick = (event) => {
@@ -46,18 +66,58 @@ function DropdownMenuTrigger({ children, render, onClick, ...props }) {
     }
     return (_jsx(View, { ...triggerProps, children: children }));
 }
+/**
+ * @desc 下拉菜单跨层级渲染入口。
+ * @param {Parameters<typeof DropdownMenuPortal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuPortal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuPortal } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuPortal /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuPortal({ children }) {
     return _jsx(_Fragment, { children: children });
 }
+/**
+ * @desc 下拉菜单内容容器。
+ * @param {Parameters<typeof DropdownMenuContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuContent } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuContent /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuContent({ className, children, sideOffset: _sideOffset, ...props }) {
     const { open, onOpenChange } = React.useContext(DropdownMenuContext);
     if (!open)
         return null;
     return (_jsxs(_Fragment, { children: [_jsx(View, { className: "fixed inset-0 z-40", onClick: () => onOpenChange(false) }), _jsx(View, { "data-slot": "dropdown-menu-content", className: cn("absolute top-full left-0 z-50 mt-1 min-w-[8rem] overflow-hidden rounded-lg border bg-popover p-1 text-popover-foreground shadow-md", className), ...props, children: children })] }));
 }
+/**
+ * @desc 下拉菜单分组容器。
+ * @param {Parameters<typeof DropdownMenuGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuGroup } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuGroup /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuGroup({ ...props }) {
     return _jsx(View, { "data-slot": "dropdown-menu-group", ...props });
 }
+/**
+ * @desc 下拉菜单条目。
+ * @param {Parameters<typeof DropdownMenuItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuItem } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuItem /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuItem({ className, inset, variant = "default", ...props }) {
     const { onOpenChange } = React.useContext(DropdownMenuContext);
     return (_jsx(View, { "data-slot": "dropdown-menu-item", "data-inset": inset, "data-variant": variant, className: cn("relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none active:bg-accent active:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", variant === "destructive" &&
@@ -66,25 +126,95 @@ function DropdownMenuItem({ className, inset, variant = "default", ...props }) {
             onOpenChange(false);
         }, ...props }));
 }
+/**
+ * @desc 下拉菜单复选条目。
+ * @param {Parameters<typeof DropdownMenuCheckboxItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuCheckboxItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuCheckboxItem } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuCheckboxItem /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuCheckboxItem({ className, children, checked, onCheckedChange, ...props }) {
     return (_jsxs(View, { "data-slot": "dropdown-menu-checkbox-item", className: cn("relative flex items-center gap-2 rounded-sm py-1.5 pl-8 pr-2 text-sm outline-hidden select-none active:bg-accent active:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", className), onClick: () => onCheckedChange?.(!checked), ...props, children: [_jsx(View, { className: "pointer-events-none absolute left-2 flex size-3.5 items-center justify-center", children: checked ? _jsx(Check, { className: "size-4" }) : null }), children] }));
 }
+/**
+ * @desc 下拉菜单单选分组。
+ * @param {Parameters<typeof DropdownMenuRadioGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuRadioGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuRadioGroup } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuRadioGroup /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuRadioGroup({ children, ...props }) {
     return (_jsx(View, { "data-slot": "dropdown-menu-radio-group", ...props, children: children }));
 }
+/**
+ * @desc 下拉菜单单选条目。
+ * @param {Parameters<typeof DropdownMenuRadioItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuRadioItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuRadioItem } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuRadioItem checked /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuRadioItem({ className, children, checked, ...props }) {
     return (_jsxs(View, { "data-slot": "dropdown-menu-radio-item", className: cn("relative flex items-center gap-2 rounded-sm py-1.5 pl-8 pr-2 text-sm outline-hidden select-none active:bg-accent active:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", className), ...props, children: [_jsx(View, { className: "pointer-events-none absolute left-2 flex size-3.5 items-center justify-center", children: checked ? _jsx(Circle, { className: "size-2 fill-current" }) : null }), children] }));
 }
+/**
+ * @desc 下拉菜单标签文本。
+ * @param {Parameters<typeof DropdownMenuLabel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuLabel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuLabel } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuLabel /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuLabel({ className, inset, ...props }) {
     return (_jsx(View, { "data-slot": "dropdown-menu-label", "data-inset": inset, className: cn("px-2 py-1.5 text-sm font-medium", inset && "pl-8", className), ...props }));
 }
+/**
+ * @desc 下拉菜单分隔线。
+ * @param {Parameters<typeof DropdownMenuSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuSeparator } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuSeparator /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuSeparator({ className, ...props }) {
     return (_jsx(View, { "data-slot": "dropdown-menu-separator", className: cn("-mx-1 my-1 h-px bg-border", className), ...props }));
 }
+/**
+ * @desc 下拉菜单快捷键说明。
+ * @param {Parameters<typeof DropdownMenuShortcut>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuShortcut>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuShortcut } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuShortcut /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuShortcut({ className, ...props }) {
     return (_jsx(View, { "data-slot": "dropdown-menu-shortcut", className: cn("ml-auto text-xs tracking-widest text-muted-foreground", className), ...props }));
 }
 const DropdownMenuSubContext = React.createContext({ open: false, onOpenChange: () => { } });
+/**
+ * @desc 下拉菜单子菜单上下文。
+ * @param {Parameters<typeof DropdownMenuSub>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuSub>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuSub } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuSub /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuSub({ open: openProp, defaultOpen, onOpenChange, children, }) {
     const [internal, setInternal] = React.useState(defaultOpen ?? false);
     const controlled = openProp !== undefined;
@@ -98,10 +228,30 @@ function DropdownMenuSub({ open: openProp, defaultOpen, onOpenChange, children,
             },
         }, children: children }));
 }
+/**
+ * @desc 下拉菜单子菜单触发器。
+ * @param {Parameters<typeof DropdownMenuSubTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuSubTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuSubTrigger } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuSubTrigger /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuSubTrigger({ className, inset, children, ...props }) {
     const { onOpenChange, open } = React.useContext(DropdownMenuSubContext);
     return (_jsxs(View, { "data-slot": "dropdown-menu-sub-trigger", "data-inset": inset, "data-state": open ? "open" : "closed", className: cn("flex items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", open && "bg-accent", inset && "pl-8", className), onClick: () => onOpenChange(!open), ...props, children: [children, _jsx(ChevronRight, { className: "ml-auto" })] }));
 }
+/**
+ * @desc 下拉菜单子菜单内容。
+ * @param {Parameters<typeof DropdownMenuSubContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuSubContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuSubContent } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuSubContent /></DropdownMenu>
+ * ```
+ */
 function DropdownMenuSubContent({ className, ...props }) {
     const { open } = React.useContext(DropdownMenuSubContext);
     if (!open)

package/dist/ui/dropdown-menu.js.map

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

package/dist/ui/empty.d.ts

@@ -1,12 +1,73 @@
 import { type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
+/**
+ * @desc 空状态组件。
+ * @param {Parameters<typeof Empty>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Empty>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty />
+ * ```
+ */
 declare function Empty({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 空状态头部布局。
+ * @param {Parameters<typeof EmptyHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof EmptyHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyHeader } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyHeader /></Empty>
+ * ```
+ */
 declare function EmptyHeader({ className, ...props }: ViewProps): import("react").JSX.Element;
 declare const emptyMediaVariants: (props?: ({
     variant?: "default" | "icon" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 空状态媒体区域。
+ * @param {Parameters<typeof EmptyMedia>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof EmptyMedia>[0]["variant"]} props.variant 媒体区外观，默认 default（透明背景）；icon 为带底色的 size-8 图标容器。
+ * @return {ReturnType<typeof EmptyMedia>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyMedia } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyMedia /></Empty>
+ * ```
+ */
 declare function EmptyMedia({ className, variant, ...props }: ViewProps & VariantProps<typeof emptyMediaVariants>): import("react").JSX.Element;
+/**
+ * @desc 空状态标题。
+ * @param {Parameters<typeof EmptyTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof EmptyTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyTitle } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyTitle /></Empty>
+ * ```
+ */
 declare function EmptyTitle({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 空状态说明文本。
+ * @param {Parameters<typeof EmptyDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof EmptyDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyDescription } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyDescription /></Empty>
+ * ```
+ */
 declare function EmptyDescription({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 空状态内容容器。
+ * @param {Parameters<typeof EmptyContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof EmptyContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyContent } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyContent /></Empty>
+ * ```
+ */
 declare function EmptyContent({ className, ...props }: ViewProps): import("react").JSX.Element;
 export { Empty, EmptyHeader, EmptyTitle, EmptyDescription, EmptyContent, EmptyMedia, };

package/dist/ui/empty.js

@@ -2,9 +2,29 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { View } from "@tarojs/components";
 import { cva } from "class-variance-authority";
 import { cn } from "../lib/utils.js";
+/**
+ * @desc 空状态组件。
+ * @param {Parameters<typeof Empty>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Empty>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty />
+ * ```
+ */
 function Empty({ className, ...props }) {
     return (_jsx(View, { "data-slot": "empty", className: cn("flex w-full min-w-0 flex-1 flex-col items-center justify-center gap-4 rounded-xl border-dashed p-6", className), ...props }));
 }
+/**
+ * @desc 空状态头部布局。
+ * @param {Parameters<typeof EmptyHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof EmptyHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyHeader } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyHeader /></Empty>
+ * ```
+ */
 function EmptyHeader({ className, ...props }) {
     return (_jsx(View, { "data-slot": "empty-header", className: cn("flex max-w-sm flex-col items-center gap-2", className), ...props }));
 }
@@ -19,15 +39,56 @@ const emptyMediaVariants = cva("mb-2 flex shrink-0 items-center justify-center [
         variant: "default",
     },
 });
+/**
+ * @desc 空状态媒体区域。
+ * @param {Parameters<typeof EmptyMedia>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof EmptyMedia>[0]["variant"]} props.variant 媒体区外观，默认 default（透明背景）；icon 为带底色的 size-8 图标容器。
+ * @return {ReturnType<typeof EmptyMedia>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyMedia } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyMedia /></Empty>
+ * ```
+ */
 function EmptyMedia({ className, variant = "default", ...props }) {
     return (_jsx(View, { "data-slot": "empty-icon", "data-variant": variant, className: cn(emptyMediaVariants({ variant, className })), ...props }));
 }
+/**
+ * @desc 空状态标题。
+ * @param {Parameters<typeof EmptyTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof EmptyTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyTitle } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyTitle /></Empty>
+ * ```
+ */
 function EmptyTitle({ className, ...props }) {
     return (_jsx(View, { "data-slot": "empty-title", className: cn("font-heading text-sm font-medium tracking-tight", className), ...props }));
 }
+/**
+ * @desc 空状态说明文本。
+ * @param {Parameters<typeof EmptyDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof EmptyDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyDescription } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyDescription /></Empty>
+ * ```
+ */
 function EmptyDescription({ className, ...props }) {
     return (_jsx(View, { "data-slot": "empty-description", className: cn("text-sm/relaxed text-muted-foreground [&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-primary", className), ...props }));
 }
+/**
+ * @desc 空状态内容容器。
+ * @param {Parameters<typeof EmptyContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof EmptyContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Empty, EmptyContent } from '@open-dy/vibecoding-sdk-taro/ui/empty'
+ * <Empty><EmptyContent /></Empty>
+ * ```
+ */
 function EmptyContent({ className, ...props }) {
     return (_jsx(View, { "data-slot": "empty-content", className: cn("flex w-full max-w-sm min-w-0 flex-col items-center gap-2.5 text-sm text-balance", className), ...props }));
 }

package/dist/ui/empty.js.map

@@ -1 +1 @@
-{"version":3,"file":"empty.js","sourceRoot":"","sources":["../../src/ui/empty.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC,SAAS,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC/C,OAAO,CACL,KAAC,IAAI,iBACO,OAAO,EACjB,SAAS,EAAE,EAAE,CACX,oGAAoG,EACpG,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACrD,OAAO,CACL,KAAC,IAAI,iBACO,cAAc,EACxB,SAAS,EAAE,EAAE,CAAC,2CAA2C,EAAE,SAAS,CAAC,KACjE,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG,GAAG,CAC5B,6FAA6F,EAC7F;IACE,QAAQ,EAAE;QACR,OAAO,EAAE;YACP,OAAO,EAAE,gBAAgB;YACzB,IAAI,EAAE,2HAA2H;SAClI;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,SAAS;KACnB;CACF,CACF,CAAA;AAED,SAAS,UAAU,CAAC,EAClB,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,GAAG,KAAK,EAC4C;IACpD,OAAO,CACL,KAAC,IAAI,iBACO,YAAY,kBACR,OAAO,EACrB,SAAS,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,KACrD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACpD,OAAO,CACL,KAAC,IAAI,iBACO,aAAa,EACvB,SAAS,EAAE,EAAE,CACX,iDAAiD,EACjD,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC1D,OAAO,CACL,KAAC,IAAI,iBACO,mBAAmB,EAC7B,SAAS,EAAE,EAAE,CACX,yGAAyG,EACzG,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACtD,OAAO,CACL,KAAC,IAAI,iBACO,eAAe,EACzB,SAAS,EAAE,EAAE,CACX,iFAAiF,EACjF,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EACL,KAAK,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,CAAA"}
+{"version":3,"file":"empty.js","sourceRoot":"","sources":["../../src/ui/empty.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC;;;;;;;;;GASG;AACH,SAAS,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC/C,OAAO,CACL,KAAC,IAAI,iBACO,OAAO,EACjB,SAAS,EAAE,EAAE,CACX,oGAAoG,EACpG,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACrD,OAAO,CACL,KAAC,IAAI,iBACO,cAAc,EACxB,SAAS,EAAE,EAAE,CAAC,2CAA2C,EAAE,SAAS,CAAC,KACjE,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG,GAAG,CAC5B,6FAA6F,EAC7F;IACE,QAAQ,EAAE;QACR,OAAO,EAAE;YACP,OAAO,EAAE,gBAAgB;YACzB,IAAI,EAAE,2HAA2H;SAClI;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,SAAS;KACnB;CACF,CACF,CAAA;AAED;;;;;;;;;;GAUG;AACH,SAAS,UAAU,CAAC,EAClB,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,GAAG,KAAK,EAC4C;IACpD,OAAO,CACL,KAAC,IAAI,iBACO,YAAY,kBACR,OAAO,EACrB,SAAS,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,KACrD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACpD,OAAO,CACL,KAAC,IAAI,iBACO,aAAa,EACvB,SAAS,EAAE,EAAE,CACX,iDAAiD,EACjD,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC1D,OAAO,CACL,KAAC,IAAI,iBACO,mBAAmB,EAC7B,SAAS,EAAE,EAAE,CACX,yGAAyG,EACzG,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACtD,OAAO,CACL,KAAC,IAAI,iBACO,eAAe,EACzB,SAAS,EAAE,EAAE,CACX,iFAAiF,EACjF,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EACL,KAAK,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,CAAA"}

package/dist/ui/field.d.ts

@@ -2,24 +2,129 @@ import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
 import { Label } from "./label.js";
+/**
+ * @desc 表单字段字段组容器。
+ * @param {Parameters<typeof FieldSet>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldSet>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet />
+ * ```
+ */
 declare function FieldSet({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 表单字段字段组标题。
+ * @param {Parameters<typeof FieldLegend>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldLegend>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldLegend /></FieldSet>
+ * ```
+ */
 declare function FieldLegend({ className, variant, ...props }: ViewProps & {
+    /** @desc 标题字号，默认 legend（text-base），label 使用较小的 text-sm；仅改变视觉样式。 */
     variant?: "legend" | "label";
 }): React.JSX.Element;
+/**
+ * @desc 表单字段分组容器。
+ * @param {Parameters<typeof FieldGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldGroup } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldGroup /></FieldSet>
+ * ```
+ */
 declare function FieldGroup({ className, ...props }: ViewProps): React.JSX.Element;
 declare const fieldVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 表单字段组件。
+ * @param {Parameters<typeof Field>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Field>[0]["orientation"]} props.orientation 布局方向，默认 vertical；horizontal 横排，responsive 在 FieldGroup 容器较宽时切换为横排。不会改变输入控件本身的值或禁用状态。
+ * @return {ReturnType<typeof Field>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, Field } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><Field /></FieldSet>
+ * ```
+ */
 declare function Field({ className, orientation, children, ...props }: ViewProps & VariantProps<typeof fieldVariants>): React.JSX.Element;
+/**
+ * @desc 表单字段内容容器。
+ * @param {Parameters<typeof FieldContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldContent } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldContent /></FieldSet>
+ * ```
+ */
 declare function FieldContent({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 表单字段标签文本。
+ * @param {Parameters<typeof FieldLabel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldLabel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLabel } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldLabel /></FieldSet>
+ * ```
+ */
 declare function FieldLabel({ className, children, ...props }: React.ComponentProps<typeof Label>): React.JSX.Element;
+/**
+ * @desc 表单字段标题。
+ * @param {Parameters<typeof FieldTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldTitle } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldTitle /></FieldSet>
+ * ```
+ */
 declare function FieldTitle({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 表单字段说明文本。
+ * @param {Parameters<typeof FieldDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldDescription } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldDescription /></FieldSet>
+ * ```
+ */
 declare function FieldDescription({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 表单字段分隔线。
+ * @param {Parameters<typeof FieldSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldSeparator } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldSeparator /></FieldSet>
+ * ```
+ */
 declare function FieldSeparator({ children, className, ...props }: ViewProps & {
+    /** @desc 分隔线中心的可选文字或节点；内容为假值时只显示横线。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @desc 表单字段错误信息。
+ * @param {Parameters<typeof FieldError>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldError>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldError } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldError /></FieldSet>
+ * ```
+ */
 declare function FieldError({ className, children, errors, ...props }: ViewProps & {
+    /** @desc 错误列表；按 message 去重后显示，children 非空时优先显示 children；省略或无可显示内容时不渲染。 */
     errors?: Array<{
+        /** @desc 单条错误的展示文本；省略时无对应文字，重复文本只显示一次。 */
         message?: string;
     } | undefined>;
 }): React.JSX.Element | null;