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

package/dist/ui/drawer.d.ts

@@ -1,21 +1,127 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
+/**
+ * @desc 抽屉组件。
+ * @param {Parameters<typeof Drawer>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Drawer>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer />
+ * ```
+ */
 declare function Drawer({ open: openProp, defaultOpen, onOpenChange, direction, children, }: {
+    /** @desc 受控展开状态；传入后以该值为准，需在 onOpenChange 中更新。省略时由组件内部管理。 */
     open?: boolean;
+    /** @desc 非受控模式的初始展开状态，默认 false；仅初始化时读取，传入 open 后不生效。 */
     defaultOpen?: boolean;
+    /** @desc 触发器或关闭操作请求改变展开状态时调用，参数为下一状态；受控模式需由调用方同步 open。 */
     onOpenChange?: (open: boolean) => void;
+    /** @desc 抽屉出现的位置：bottom 底部、top 顶部、left 左侧、right 右侧，默认 bottom；同时决定宽高、边框及圆角。 */
     direction?: "bottom" | "top" | "left" | "right";
+    /** @desc 同一实例的触发器、内容区等组合子组件；省略时不显示内容，子组件通过上下文共享状态。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @desc 抽屉触发器。
+ * @param {Parameters<typeof DrawerTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerTrigger } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerTrigger /></Drawer>
+ * ```
+ */
 declare function DrawerTrigger({ children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 抽屉跨层级渲染入口。
+ * @param {Parameters<typeof DrawerPortal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerPortal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerPortal } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerPortal /></Drawer>
+ * ```
+ */
 declare function DrawerPortal({ children }: {
+    /** @desc 要渲染的子节点；该兼容包装只返回 Fragment，不额外创建原生容器或执行挂载迁移。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @desc 抽屉关闭按钮。
+ * @param {Parameters<typeof DrawerClose>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerClose>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerClose } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerClose /></Drawer>
+ * ```
+ */
 declare function DrawerClose({ children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 抽屉遮罩。
+ * @param {Parameters<typeof DrawerOverlay>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerOverlay>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerOverlay } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerOverlay /></Drawer>
+ * ```
+ */
 declare function DrawerOverlay({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 抽屉内容容器。
+ * @param {Parameters<typeof DrawerContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerContent } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerContent /></Drawer>
+ * ```
+ */
 declare function DrawerContent({ className, children, ...props }: ViewProps): React.JSX.Element | null;
+/**
+ * @desc 抽屉头部布局。
+ * @param {Parameters<typeof DrawerHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerHeader } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerHeader /></Drawer>
+ * ```
+ */
 declare function DrawerHeader({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 抽屉底部布局。
+ * @param {Parameters<typeof DrawerFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerFooter } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerFooter /></Drawer>
+ * ```
+ */
 declare function DrawerFooter({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 抽屉标题。
+ * @param {Parameters<typeof DrawerTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerTitle } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerTitle /></Drawer>
+ * ```
+ */
 declare function DrawerTitle({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 抽屉说明文本。
+ * @param {Parameters<typeof DrawerDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerDescription } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerDescription /></Drawer>
+ * ```
+ */
 declare function DrawerDescription({ className, ...props }: ViewProps): React.JSX.Element;
 export { Drawer, DrawerPortal, DrawerOverlay, DrawerTrigger, DrawerClose, DrawerContent, DrawerHeader, DrawerFooter, DrawerTitle, DrawerDescription, };

package/dist/ui/drawer.js

@@ -3,6 +3,16 @@ import * as React from "react";
 import { View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
 const DrawerContext = React.createContext({ open: false, onOpenChange: () => { }, direction: "bottom" });
+/**
+ * @desc 抽屉组件。
+ * @param {Parameters<typeof Drawer>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Drawer>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer />
+ * ```
+ */
 function Drawer({ open: openProp, defaultOpen, onOpenChange, direction = "bottom", children, }) {
     const [internal, setInternal] = React.useState(defaultOpen ?? false);
     const controlled = openProp !== undefined;
@@ -17,20 +27,70 @@ function Drawer({ open: openProp, defaultOpen, onOpenChange, direction = "bottom
             direction,
         }, children: children }));
 }
+/**
+ * @desc 抽屉触发器。
+ * @param {Parameters<typeof DrawerTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerTrigger } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerTrigger /></Drawer>
+ * ```
+ */
 function DrawerTrigger({ children, ...props }) {
     const { onOpenChange } = React.useContext(DrawerContext);
     return (_jsx(View, { "data-slot": "drawer-trigger", onClick: () => onOpenChange(true), ...props, children: children }));
 }
+/**
+ * @desc 抽屉跨层级渲染入口。
+ * @param {Parameters<typeof DrawerPortal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerPortal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerPortal } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerPortal /></Drawer>
+ * ```
+ */
 function DrawerPortal({ children }) {
     return _jsx(_Fragment, { children: children });
 }
+/**
+ * @desc 抽屉关闭按钮。
+ * @param {Parameters<typeof DrawerClose>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerClose>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerClose } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerClose /></Drawer>
+ * ```
+ */
 function DrawerClose({ children, ...props }) {
     const { onOpenChange } = React.useContext(DrawerContext);
     return (_jsx(View, { "data-slot": "drawer-close", onClick: () => onOpenChange(false), ...props, children: children }));
 }
+/**
+ * @desc 抽屉遮罩。
+ * @param {Parameters<typeof DrawerOverlay>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerOverlay>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerOverlay } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerOverlay /></Drawer>
+ * ```
+ */
 function DrawerOverlay({ className, ...props }) {
     return (_jsx(View, { "data-slot": "drawer-overlay", className: cn("fixed inset-0 z-50 bg-black/50", className), ...props }));
 }
+/**
+ * @desc 抽屉内容容器。
+ * @param {Parameters<typeof DrawerContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerContent } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerContent /></Drawer>
+ * ```
+ */
 function DrawerContent({ className, children, ...props }) {
     const { open, onOpenChange, direction } = React.useContext(DrawerContext);
     if (!open)
@@ -41,15 +101,55 @@ function DrawerContent({ className, children, ...props }) {
                     "inset-y-0 left-0 w-3/4 rounded-r-xl border-r sm:max-w-sm", direction === "right" &&
                     "inset-y-0 right-0 w-3/4 rounded-l-xl border-l sm:max-w-sm", className), ...props, children: [direction === "bottom" && (_jsx(View, { className: "mx-auto mt-4 h-1 w-[100px] shrink-0 rounded-full bg-muted" })), children] })] }));
 }
+/**
+ * @desc 抽屉头部布局。
+ * @param {Parameters<typeof DrawerHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerHeader } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerHeader /></Drawer>
+ * ```
+ */
 function DrawerHeader({ className, ...props }) {
     return (_jsx(View, { "data-slot": "drawer-header", className: cn("flex flex-col gap-0.5 p-4 text-center md:text-left", className), ...props }));
 }
+/**
+ * @desc 抽屉底部布局。
+ * @param {Parameters<typeof DrawerFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerFooter } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerFooter /></Drawer>
+ * ```
+ */
 function DrawerFooter({ className, ...props }) {
     return (_jsx(View, { "data-slot": "drawer-footer", className: cn("mt-auto flex flex-col gap-2 p-4", className), ...props }));
 }
+/**
+ * @desc 抽屉标题。
+ * @param {Parameters<typeof DrawerTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerTitle } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerTitle /></Drawer>
+ * ```
+ */
 function DrawerTitle({ className, ...props }) {
     return (_jsx(View, { "data-slot": "drawer-title", className: cn("font-heading text-base font-medium text-foreground", className), ...props }));
 }
+/**
+ * @desc 抽屉说明文本。
+ * @param {Parameters<typeof DrawerDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DrawerDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Drawer, DrawerDescription } from '@open-dy/vibecoding-sdk-taro/ui/drawer'
+ * <Drawer><DrawerDescription /></Drawer>
+ * ```
+ */
 function DrawerDescription({ className, ...props }) {
     return (_jsx(View, { "data-slot": "drawer-description", className: cn("text-sm text-muted-foreground", className), ...props }));
 }

package/dist/ui/drawer.js.map

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

package/dist/ui/dropdown-menu.d.ts

@@ -1,52 +1,223 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 type DropdownMenuTriggerRenderProps = Omit<ViewProps, "children"> & {
+    /** @desc 组件自动注入的触发器标识；自定义 render 应转发到触发节点，不手动修改。 */
     "data-slot": "dropdown-menu-trigger";
+    /** @desc 组件自动注入的展开状态；自定义 render 应转发到触发节点。 */
     "aria-expanded": boolean;
 };
 type DropdownMenuTriggerProps = Omit<ViewProps, "children"> & {
+    /** @desc 默认触发器内的内容；设置 render 时由自定义渲染结果取代。 */
     children?: React.ReactNode;
+    /** @desc 自定义触发器元素或渲染函数；省略时使用 View。元素会被克隆并合并点击处理；函数收到状态和事件 props，必须传给实际可点击节点。 */
     render?: React.ReactElement | ((props: DropdownMenuTriggerRenderProps) => React.ReactNode);
 };
+/**
+ * @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 />
+ * ```
+ */
 declare function DropdownMenu({ 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 DropdownMenuTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuTrigger /></DropdownMenu>
+ * ```
+ */
 declare function DropdownMenuTrigger({ children, render, onClick, ...props }: DropdownMenuTriggerProps): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuPortal({ children }: {
+    /** @desc 要渲染的子节点；该兼容包装只返回 Fragment，不额外创建原生容器或执行挂载迁移。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuContent({ className, children, sideOffset: _sideOffset, ...props }: ViewProps & {
+    /** @desc 兼容属性；当前实现未使用该值定位，内容固定在触发器下方并使用 mt-1 间隔。 */
     sideOffset?: number;
 }): React.JSX.Element | null;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuGroup({ ...props }: ViewProps): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuItem({ className, inset, variant, ...props }: ViewProps & {
+    /** @desc 是否增加左侧内边距以对齐含图标的项目；默认 false，为 true 时使用 pl-8。 */
     inset?: boolean;
+    /** @desc 项目样式，默认 default；destructive 用危险操作文字及按压色，仅改变样式，不自动执行删除。 */
     variant?: "default" | "destructive";
 }): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuCheckboxItem({ className, children, checked, onCheckedChange, ...props }: ViewProps & {
+    /** @desc 外部控制的勾选状态，默认不勾选；组件不会自己保存状态，需在 onCheckedChange 中同步。 */
     checked?: boolean;
+    /** @desc 点击时传入 !checked；调用方负责更新 checked，没有 defaultChecked 或非受控模式。 */
     onCheckedChange?: (checked: boolean) => void;
 }): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuRadioGroup({ children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuRadioItem({ className, children, checked, ...props }: ViewProps & {
+    /** @desc 是否显示选中指示，默认 false；该项不管理组值，选择和更新由调用方通过点击事件处理。 */
     checked?: boolean;
 }): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuLabel({ className, inset, ...props }: ViewProps & {
+    /** @desc 是否增加左侧内边距以对齐含图标的项目；默认 false，为 true 时使用 pl-8。 */
     inset?: boolean;
 }): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuSeparator({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuShortcut({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuSub({ 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 DropdownMenuSubTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof DropdownMenuSubTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuSubTrigger } from '@open-dy/vibecoding-sdk-taro/ui/dropdown-menu'
+ * <DropdownMenu><DropdownMenuSubTrigger /></DropdownMenu>
+ * ```
+ */
 declare function DropdownMenuSubTrigger({ className, inset, children, ...props }: ViewProps & {
+    /** @desc 是否增加左侧内边距以对齐含图标的项目；默认 false，为 true 时使用 pl-8。 */
     inset?: boolean;
 }): React.JSX.Element;
+/**
+ * @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>
+ * ```
+ */
 declare function DropdownMenuSubContent({ className, ...props }: ViewProps): React.JSX.Element | null;
 export { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuGroup, DropdownMenuPortal, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuRadioGroup, };