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

package/dist/reference/sdk-api.md

@@ -3,6 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 本文档是 SDK API 的入口索引。详细契约按导入路径和 API 拆分到 `sdk-api/`，内容来自 SDK 源码的结构化 JSDoc 与 TypeScript 类型契约。
+文档之外的实现信息可按 API 页标注的 `src/` 路径，在安装包中按需查阅；运行入口仍由 `exports` 指向编译产物。
 
 `?` 表示可选字段；平台运行时对象（例如 `taro`）只展示类型，不展开其内部方法。
 
@@ -17,8 +18,8 @@
 | `@open-dy/vibecoding-sdk-taro/interest-card/runtime/microapp` | 兴趣卡普通小程序适配器，复用 runtime 入口。 | [查看](sdk-api/runtime/index.md) |
 | `@open-dy/vibecoding-sdk-taro/interest-card/eslint/taro` | 公开导出入口。 | — |
 | `@open-dy/vibecoding-sdk-taro/interest-card/types/taro` | 公开导出入口。 | — |
-| `@open-dy/vibecoding-sdk-taro/ui` | React UI 组件入口。 | — |
-| `@open-dy/vibecoding-sdk-taro/ui/*` | React UI 组件入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/ui` | React UI 组件、Hook、类型和样式函数；按模块渐进查阅。 | [查看](sdk-api/ui/index.md) |
+| `@open-dy/vibecoding-sdk-taro/ui/*` | React UI 组件、Hook、类型和样式函数；按模块渐进查阅。 | [查看](sdk-api/ui/index.md) |
 | `@open-dy/vibecoding-sdk-taro/ui/theme.css` | UI 样式资源入口。 | — |
 | `@open-dy/vibecoding-sdk-taro/ui/tailwind.css` | UI 样式资源入口。 | — |
 | `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card` | 公开导出入口。 | — |
@@ -41,3 +42,50 @@
   - `BuildContext`
   - `CreateMicroappTaroConfigOptions`
   - `createMicroappTaroConfig`
+- [ui/accordion](sdk-api/ui/accordion/index.md)
+- [ui/alert-dialog](sdk-api/ui/alert-dialog/index.md)
+- [ui/alert](sdk-api/ui/alert/index.md)
+- [ui/aspect-ratio](sdk-api/ui/aspect-ratio/index.md)
+- [ui/avatar](sdk-api/ui/avatar/index.md)
+- [ui/badge](sdk-api/ui/badge/index.md)
+- [ui/button-group](sdk-api/ui/button-group/index.md)
+- [ui/button](sdk-api/ui/button/index.md)
+- [ui/calendar](sdk-api/ui/calendar/index.md)
+- [ui/card](sdk-api/ui/card/index.md)
+- [ui/carousel](sdk-api/ui/carousel/index.md)
+- [ui/checkbox](sdk-api/ui/checkbox/index.md)
+- [ui/collapsible](sdk-api/ui/collapsible/index.md)
+- [ui/combobox](sdk-api/ui/combobox/index.md)
+- [ui/dialog](sdk-api/ui/dialog/index.md)
+- [ui/drawer](sdk-api/ui/drawer/index.md)
+- [ui/dropdown-menu](sdk-api/ui/dropdown-menu/index.md)
+- [ui/empty](sdk-api/ui/empty/index.md)
+- [ui/field](sdk-api/ui/field/index.md)
+- [ui/helpers](sdk-api/ui/helpers/index.md)
+- [ui/input-group](sdk-api/ui/input-group/index.md)
+- [ui/input-otp](sdk-api/ui/input-otp/index.md)
+- [ui/input](sdk-api/ui/input/index.md)
+- [ui/item](sdk-api/ui/item/index.md)
+- [ui/label](sdk-api/ui/label/index.md)
+- [ui/menubar](sdk-api/ui/menubar/index.md)
+- [ui/navigation-menu](sdk-api/ui/navigation-menu/index.md)
+- [ui/pagination](sdk-api/ui/pagination/index.md)
+- [ui/popover](sdk-api/ui/popover/index.md)
+- [ui/portal](sdk-api/ui/portal/index.md)
+- [ui/progress](sdk-api/ui/progress/index.md)
+- [ui/radio-group](sdk-api/ui/radio-group/index.md)
+- [ui/resizable](sdk-api/ui/resizable/index.md)
+- [ui/scroll-area](sdk-api/ui/scroll-area/index.md)
+- [ui/select](sdk-api/ui/select/index.md)
+- [ui/separator](sdk-api/ui/separator/index.md)
+- [ui/sheet](sdk-api/ui/sheet/index.md)
+- [ui/skeleton](sdk-api/ui/skeleton/index.md)
+- [ui/slider](sdk-api/ui/slider/index.md)
+- [ui/sonner](sdk-api/ui/sonner/index.md)
+- [ui/spinner](sdk-api/ui/spinner/index.md)
+- [ui/switch](sdk-api/ui/switch/index.md)
+- [ui/table](sdk-api/ui/table/index.md)
+- [ui/tabs](sdk-api/ui/tabs/index.md)
+- [ui/textarea](sdk-api/ui/textarea/index.md)
+- [ui/toggle-group](sdk-api/ui/toggle-group/index.md)
+- [ui/toggle](sdk-api/ui/toggle/index.md)

package/dist/ui/accordion.d.ts

@@ -1,17 +1,65 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
+/**
+ * @desc 手风琴折叠面板组件。
+ * @param {Parameters<typeof Accordion>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Accordion>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Accordion } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+ * <Accordion />
+ * ```
+ */
 declare function Accordion({ className, type, value: valueProp, defaultValue, onValueChange, children, disabled, multiple, ...props }: ViewProps & {
+    /** @desc 展开模式：single 仅展开一项、multiple 可展开多项，默认 single；multiple 为 true 时强制多项展开。 */
     type?: "single" | "multiple";
+    /** @desc 受控展开项的标识；字符串表示单项，数组表示多项。传入后需在 onValueChange 中同步，省略时由内部状态管理。 */
     value?: string | string[];
+    /** @desc 非受控模式的初始展开项；默认全部收起，字符串表示单项、数组表示多项。仅初始化时读取，传入 value 后不生效。 */
     defaultValue?: string | string[];
+    /** @desc 是否禁止整组切换，默认 false；禁用后各项不能通过内部操作改变选中状态。 */
     disabled?: boolean;
+    /** @desc 多选快捷开关，默认 false；为 true 时优先于 type，允许同时选中多项。 */
     multiple?: boolean;
+    /** @desc 用户展开或收起项目时调用；单项模式返回字符串（全部收起为空字符串），多项模式返回字符串数组（全部收起为空数组）。 */
     onValueChange?: (value: string | string[]) => void;
 }): React.JSX.Element;
+/**
+ * @desc 手风琴折叠面板条目。
+ * @param {Parameters<typeof AccordionItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AccordionItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Accordion, AccordionItem } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+ * <Accordion><AccordionItem value="details"><AccordionItem value="details" /></AccordionItem></Accordion>
+ * ```
+ */
 declare function AccordionItem({ className, value, children, disabled, ...props }: ViewProps & {
+    /** @desc 当前项目的唯一标识；必须与父组件的 value/defaultValue 对应，不同项目使用不同值。 */
     value: string;
+    /** @desc 是否禁用当前项目，默认 false；禁用后不执行内部切换。父组件禁用时此项也不可操作。 */
     disabled?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 手风琴折叠面板触发器。
+ * @param {Parameters<typeof AccordionTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AccordionTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Accordion, AccordionItem, AccordionTrigger } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+ * <Accordion><AccordionItem value="details"><AccordionTrigger /></AccordionItem></Accordion>
+ * ```
+ */
 declare function AccordionTrigger({ className, children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 手风琴折叠面板内容容器。
+ * @param {Parameters<typeof AccordionContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AccordionContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Accordion, AccordionItem, AccordionContent } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+ * <Accordion><AccordionItem value="details"><AccordionContent /></AccordionItem></Accordion>
+ * ```
+ */
 declare function AccordionContent({ className, children, ...props }: ViewProps): React.JSX.Element | null;
 export { Accordion, AccordionItem, AccordionTrigger, AccordionContent };

package/dist/ui/accordion.js

@@ -4,6 +4,16 @@ import { View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
 import { ChevronDown, ChevronUp } from "@open-dy/lucide-taro";
 const AccordionContext = React.createContext({ value: [], toggle: () => { }, disabled: false });
+/**
+ * @desc 手风琴折叠面板组件。
+ * @param {Parameters<typeof Accordion>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Accordion>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Accordion } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+ * <Accordion />
+ * ```
+ */
 function Accordion({ className, type = "single", value: valueProp, defaultValue, onValueChange, children, disabled = false, multiple = false, ...props }) {
     const [internal, setInternal] = React.useState(defaultValue
         ? Array.isArray(defaultValue)
@@ -36,10 +46,30 @@ function Accordion({ className, type = "single", value: valueProp, defaultValue,
     return (_jsx(AccordionContext.Provider, { value: { value: current, toggle, disabled }, children: _jsx(View, { "data-slot": "accordion", className: cn("flex w-full flex-col", className), ...props, children: children }) }));
 }
 const AccordionItemContext = React.createContext({ value: "", disabled: false });
+/**
+ * @desc 手风琴折叠面板条目。
+ * @param {Parameters<typeof AccordionItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AccordionItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Accordion, AccordionItem } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+ * <Accordion><AccordionItem value="details"><AccordionItem value="details" /></AccordionItem></Accordion>
+ * ```
+ */
 function AccordionItem({ className, value, children, disabled = false, ...props }) {
     const itemContext = React.useMemo(() => ({ value, disabled }), [value, disabled]);
     return (_jsx(AccordionItemContext.Provider, { value: itemContext, children: _jsx(View, { "data-slot": "accordion-item", className: cn("not-last:border-b", className), ...props, children: children }) }));
 }
+/**
+ * @desc 手风琴折叠面板触发器。
+ * @param {Parameters<typeof AccordionTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AccordionTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Accordion, AccordionItem, AccordionTrigger } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+ * <Accordion><AccordionItem value="details"><AccordionTrigger /></AccordionItem></Accordion>
+ * ```
+ */
 function AccordionTrigger({ className, children, ...props }) {
     const { value, toggle, disabled: accordionDisabled } = React.useContext(AccordionContext);
     const { value: itemValue, disabled: itemDisabled } = React.useContext(AccordionItemContext);
@@ -48,6 +78,16 @@ function AccordionTrigger({ className, children, ...props }) {
     return (_jsx(View, { className: "flex", children: _jsxs(View, { "data-slot": "accordion-trigger", "aria-expanded": isOpen, "aria-disabled": isDisabled, className: cn("group/accordion-trigger relative flex flex-1 items-start justify-between rounded-lg border border-transparent py-2.5 text-left text-sm font-medium transition-all outline-none hover:underline focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 focus-visible:after:border-ring aria-disabled:pointer-events-none aria-disabled:opacity-50", className), onClick: () => { if (!isDisabled)
                 toggle(itemValue); }, ...props, children: [children, isOpen ? (_jsx(ChevronUp, { "data-slot": "accordion-trigger-icon", className: "pointer-events-none ml-auto size-4 shrink-0 text-muted-foreground" })) : (_jsx(ChevronDown, { "data-slot": "accordion-trigger-icon", className: "pointer-events-none ml-auto size-4 shrink-0 text-muted-foreground" }))] }) }));
 }
+/**
+ * @desc 手风琴折叠面板内容容器。
+ * @param {Parameters<typeof AccordionContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AccordionContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Accordion, AccordionItem, AccordionContent } from '@open-dy/vibecoding-sdk-taro/ui/accordion'
+ * <Accordion><AccordionItem value="details"><AccordionContent /></AccordionItem></Accordion>
+ * ```
+ */
 function AccordionContent({ className, children, ...props }) {
     const { value } = React.useContext(AccordionContext);
     const { value: itemValue } = React.useContext(AccordionItemContext);

package/dist/ui/accordion.js.map

@@ -1 +1 @@
-{"version":3,"file":"accordion.js","sourceRoot":"","sources":["../../src/ui/accordion.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;AACjC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAE7D,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAIzC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;AAEpD,SAAS,SAAS,CAAC,EACjB,SAAS,EACT,IAAI,GAAG,QAAQ,EACf,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,QAAQ,GAAG,KAAK,EAChB,QAAQ,GAAG,KAAK,EAChB,GAAG,KAAK,EAQT;IACC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAC5C,YAAY;QACV,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;YAC3B,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,CAAC,YAAY,CAAC;QAClB,CAAC,CAAC,EAAE,CACP,CAAA;IACD,MAAM,UAAU,GAAG,SAAS,KAAK,SAAS,CAAA;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAC3B,GAAG,EAAE,CACH,UAAU;QACR,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACxB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,SAAS,CAAC;QACf,CAAC,CAAC,QAAQ,EACd,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAClC,CAAA;IAED,MAAM,UAAU,GAAG,QAAQ,IAAI,IAAI,KAAK,UAAU,CAAA;IAElD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAC9B,CAAC,GAAW,EAAE,EAAE;QACd,IAAI,QAAQ;YAAE,OAAM;QACpB,IAAI,IAAc,CAAA;QAClB,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAC1B,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC;gBAClC,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,CAAA;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC3C,CAAC;QACD,IAAI,CAAC,UAAU;YAAE,WAAW,CAAC,IAAI,CAAC,CAAA;QAClC,aAAa,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACpD,CAAC,EACD,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,CAAC,CAC3D,CAAA;IAED,OAAO,CACL,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YACpE,KAAC,IAAI,iBACO,WAAW,EACrB,SAAS,EAAE,EAAE,CAAC,sBAAsB,EAAE,SAAS,CAAC,KAC5C,KAAK,YAER,QAAQ,GACJ,GACmB,CAC7B,CAAA;AACH,CAAC;AAED,MAAM,oBAAoB,GAAG,KAAK,CAAC,aAAa,CAG7C,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;AAElC,SAAS,aAAa,CAAC,EACrB,SAAS,EACT,KAAK,EACL,QAAQ,EACR,QAAQ,GAAG,KAAK,EAChB,GAAG,KAAK,EAC0C;IAClD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;IACjF,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,WAAW,YAC/C,KAAC,IAAI,iBACO,gBAAgB,EAC1B,SAAS,EAAE,EAAE,CAAC,mBAAmB,EAAE,SAAS,CAAC,KACzC,KAAK,YAER,QAAQ,GACJ,GACuB,CACjC,CAAA;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACE;IACV,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;IACzF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAA;IAC3F,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,iBAAiB,IAAI,YAAY,CAAA;IAEpD,OAAO,CACL,KAAC,IAAI,IAAC,SAAS,EAAC,MAAM,YACpB,MAAC,IAAI,iBACO,mBAAmB,mBACd,MAAM,mBACN,UAAU,EACzB,SAAS,EAAE,EAAE,CACX,qWAAqW,EACrW,SAAS,CACV,EACD,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU;gBAAE,MAAM,CAAC,SAAS,CAAC,CAAA,CAAC,CAAC,KACjD,KAAK,aAER,QAAQ,EACR,MAAM,CAAC,CAAC,CAAC,CACR,KAAC,SAAS,iBACE,wBAAwB,EAClC,SAAS,EAAC,mEAAmE,GAC7E,CACH,CAAC,CAAC,CAAC,CACF,KAAC,WAAW,iBACA,wBAAwB,EAClC,SAAS,EAAC,mEAAmE,GAC7E,CACH,IACI,GACF,CACR,CAAA;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACE;IACV,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;IACpD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAA;IACnE,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAExC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,OAAO,CACL,KAAC,IAAI,iBACO,mBAAmB,EAC7B,SAAS,EAAC,yBAAyB,KAC/B,KAAK,YAET,KAAC,IAAI,IACH,SAAS,EAAE,EAAE,CACX,8GAA8G,EAC9G,SAAS,CACV,YAEA,QAAQ,GACJ,GACF,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"accordion.js","sourceRoot":"","sources":["../../src/ui/accordion.tsx"],"names":[],"mappings":"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"}

package/dist/ui/alert-dialog.d.ts

@@ -3,31 +3,154 @@ import { type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
 import { buttonVariants } from "./button.js";
 type AlertDialogTriggerRenderProps = Omit<ViewProps, "children"> & {
+    /** @desc 组件自动注入的触发器标识；自定义 render 应转发到触发节点，不手动修改。 */
     "data-slot": "alert-dialog-trigger";
 };
 type AlertDialogTriggerProps = Omit<ViewProps, "children"> & {
+    /** @desc 默认触发器内的内容；设置 render 时由自定义渲染结果取代。 */
     children?: React.ReactNode;
+    /** @desc 自定义触发器元素或渲染函数；省略时使用 View。元素会被克隆并合并点击处理；函数收到状态和事件 props，必须传给实际可点击节点。 */
     render?: React.ReactElement | ((props: AlertDialogTriggerRenderProps) => React.ReactNode);
 };
 type AlertDialogActionProps = ViewProps & VariantProps<typeof buttonVariants>;
+/**
+ * @desc 确认对话框组件。
+ * @param {Parameters<typeof AlertDialog>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialog>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog />
+ * ```
+ */
 declare function AlertDialog({ 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 AlertDialogTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogTrigger } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogTrigger /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogTrigger({ children, render, onClick, ...props }: AlertDialogTriggerProps): React.JSX.Element;
+/**
+ * @desc 确认对话框跨层级渲染入口。
+ * @param {Parameters<typeof AlertDialogPortal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogPortal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogPortal } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogPortal /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogPortal({ children }: {
+    /** @desc 要渲染的子节点；该兼容包装只返回 Fragment，不额外创建原生容器或执行挂载迁移。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @desc 确认对话框遮罩。
+ * @param {Parameters<typeof AlertDialogOverlay>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogOverlay>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogOverlay } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogOverlay /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogOverlay({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 确认对话框内容容器。
+ * @param {Parameters<typeof AlertDialogContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogContent } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogContent /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogContent({ className, children, size, ...props }: ViewProps & {
+    /** @desc 对话框尺寸，默认 default；sm 使用紧凑宽度和双列操作区，default 可在较宽屏幕扩展到 max-w-sm。 */
     size?: "default" | "sm";
 }): React.JSX.Element | null;
+/**
+ * @desc 确认对话框头部布局。
+ * @param {Parameters<typeof AlertDialogHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogHeader } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogHeader /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogHeader({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 确认对话框底部布局。
+ * @param {Parameters<typeof AlertDialogFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogFooter } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogFooter /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogFooter({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 确认对话框标题。
+ * @param {Parameters<typeof AlertDialogTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogTitle } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogTitle /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogTitle({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 确认对话框说明文本。
+ * @param {Parameters<typeof AlertDialogDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogDescription } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogDescription /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogDescription({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 确认对话框操作入口。
+ * @param {Parameters<typeof AlertDialogAction>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof AlertDialogAction>[0]["variant"]} props.variant 确认按钮外观，默认 default；其余变体同 Button.variant。
+ * @param {Parameters<typeof AlertDialogAction>[0]["size"]} props.size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @return {ReturnType<typeof AlertDialogAction>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogAction } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogAction /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogAction({ className, variant, size, onClick, ...props }: AlertDialogActionProps): React.JSX.Element;
+/**
+ * @desc 确认对话框取消按钮。
+ * @param {Parameters<typeof AlertDialogCancel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof AlertDialogCancel>[0]["variant"]} props.variant 取消按钮外观，默认 outline；其余变体同 Button.variant。
+ * @param {Parameters<typeof AlertDialogCancel>[0]["size"]} props.size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @return {ReturnType<typeof AlertDialogCancel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogCancel } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogCancel /></AlertDialog>
+ * ```
+ */
 declare function AlertDialogCancel({ className, variant, size, onClick, ...props }: AlertDialogActionProps): React.JSX.Element;
 export { AlertDialog, AlertDialogPortal, AlertDialogOverlay, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, };

package/dist/ui/alert-dialog.js

@@ -8,6 +8,16 @@ const AlertDialogContentContext = React.createContext({
     size: "default",
     hasMedia: false,
 });
+/**
+ * @desc 确认对话框组件。
+ * @param {Parameters<typeof AlertDialog>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialog>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog />
+ * ```
+ */
 function AlertDialog({ open: openProp, defaultOpen, onOpenChange, children, }) {
     const [internal, setInternal] = React.useState(defaultOpen ?? false);
     const controlled = openProp !== undefined;
@@ -21,6 +31,16 @@ function AlertDialog({ open: openProp, defaultOpen, onOpenChange, children, }) {
             },
         }, children: children }));
 }
+/**
+ * @desc 确认对话框触发器。
+ * @param {Parameters<typeof AlertDialogTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogTrigger } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogTrigger /></AlertDialog>
+ * ```
+ */
 function AlertDialogTrigger({ children, render, onClick, ...props }) {
     const { onOpenChange } = React.useContext(AlertDialogContext);
     const handleClick = (event) => {
@@ -50,12 +70,42 @@ function AlertDialogTrigger({ children, render, onClick, ...props }) {
     }
     return (_jsx(View, { ...triggerProps, children: children }));
 }
+/**
+ * @desc 确认对话框跨层级渲染入口。
+ * @param {Parameters<typeof AlertDialogPortal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogPortal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogPortal } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogPortal /></AlertDialog>
+ * ```
+ */
 function AlertDialogPortal({ children }) {
     return _jsx(_Fragment, { children: children });
 }
+/**
+ * @desc 确认对话框遮罩。
+ * @param {Parameters<typeof AlertDialogOverlay>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogOverlay>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogOverlay } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogOverlay /></AlertDialog>
+ * ```
+ */
 function AlertDialogOverlay({ className, ...props }) {
     return (_jsx(View, { "data-slot": "alert-dialog-overlay", className: cn("fixed inset-0 isolate z-50 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs", className), ...props }));
 }
+/**
+ * @desc 确认对话框内容容器。
+ * @param {Parameters<typeof AlertDialogContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogContent } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogContent /></AlertDialog>
+ * ```
+ */
 function AlertDialogContent({ className, children, size = "default", ...props }) {
     const ctx = React.useContext(AlertDialogContext);
     const hasMedia = React.useMemo(() => React.Children.toArray(children).some((child) => React.isValidElement(child) &&
@@ -64,20 +114,72 @@ function AlertDialogContent({ className, children, size = "default", ...props })
         return null;
     return (_jsxs(View, { className: "fixed inset-0 z-50 flex items-center justify-center", children: [_jsx(AlertDialogOverlay, {}), _jsx(AlertDialogContentContext.Provider, { value: { size, hasMedia }, children: _jsx(View, { "data-slot": "alert-dialog-content", className: cn("group/alert-dialog-content fixed top-1/2 left-1/2 z-50 grid w-full -translate-x-1/2 -translate-y-1/2 gap-4 rounded-xl bg-popover p-4 text-popover-foreground ring-1 ring-foreground/10 duration-100 outline-none", size === "sm" ? "max-w-xs" : "max-w-xs sm:max-w-sm", className), ...props, children: children }) })] }));
 }
+/**
+ * @desc 确认对话框头部布局。
+ * @param {Parameters<typeof AlertDialogHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogHeader } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogHeader /></AlertDialog>
+ * ```
+ */
 function AlertDialogHeader({ className, ...props }) {
     const { size, hasMedia } = React.useContext(AlertDialogContentContext);
     return (_jsx(View, { "data-slot": "alert-dialog-header", className: cn("grid grid-rows-[auto_1fr] place-items-center gap-1.5 text-center", hasMedia && "grid-rows-[auto_auto_1fr] gap-x-4", size === "default" && "sm:place-items-start sm:text-left", size === "default" && hasMedia && "sm:grid-rows-[auto_1fr]", className), ...props }));
 }
+/**
+ * @desc 确认对话框底部布局。
+ * @param {Parameters<typeof AlertDialogFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogFooter } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogFooter /></AlertDialog>
+ * ```
+ */
 function AlertDialogFooter({ className, ...props }) {
     const { size } = React.useContext(AlertDialogContentContext);
     return (_jsx(View, { "data-slot": "alert-dialog-footer", className: cn("-mx-4 -mb-4 flex flex-col-reverse gap-2 rounded-b-xl border-t bg-muted/50 p-4", size === "sm" && "grid grid-cols-2", size !== "sm" && "sm:flex-row sm:justify-end", className), ...props }));
 }
+/**
+ * @desc 确认对话框标题。
+ * @param {Parameters<typeof AlertDialogTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogTitle } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogTitle /></AlertDialog>
+ * ```
+ */
 function AlertDialogTitle({ className, ...props }) {
     return (_jsx(View, { "data-slot": "alert-dialog-title", className: cn("text-lg font-semibold", className), ...props }));
 }
+/**
+ * @desc 确认对话框说明文本。
+ * @param {Parameters<typeof AlertDialogDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDialogDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogDescription } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogDescription /></AlertDialog>
+ * ```
+ */
 function AlertDialogDescription({ className, ...props }) {
     return (_jsx(View, { "data-slot": "alert-dialog-description", className: cn("text-sm text-muted-foreground", className), ...props }));
 }
+/**
+ * @desc 确认对话框操作入口。
+ * @param {Parameters<typeof AlertDialogAction>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof AlertDialogAction>[0]["variant"]} props.variant 确认按钮外观，默认 default；其余变体同 Button.variant。
+ * @param {Parameters<typeof AlertDialogAction>[0]["size"]} props.size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @return {ReturnType<typeof AlertDialogAction>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogAction } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogAction /></AlertDialog>
+ * ```
+ */
 function AlertDialogAction({ className, variant = "default", size = "default", onClick, ...props }) {
     const { onOpenChange } = React.useContext(AlertDialogContext);
     return (_jsx(Button, { "data-slot": "alert-dialog-action", className: cn(buttonVariants({ variant, size }), "w-full sm:w-auto", className), onClick: (event) => {
@@ -85,6 +187,18 @@ function AlertDialogAction({ className, variant = "default", size = "default", o
             onClick?.(event);
         }, ...props }));
 }
+/**
+ * @desc 确认对话框取消按钮。
+ * @param {Parameters<typeof AlertDialogCancel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof AlertDialogCancel>[0]["variant"]} props.variant 取消按钮外观，默认 outline；其余变体同 Button.variant。
+ * @param {Parameters<typeof AlertDialogCancel>[0]["size"]} props.size 尺寸，默认 default（h-8）；xs/sm/lg 分别为 h-6/h-7/h-9；icon/icon-xs/icon-sm/icon-lg 为 size-8/6/7/9 正方形图标按钮。
+ * @return {ReturnType<typeof AlertDialogCancel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { AlertDialog, AlertDialogCancel } from '@open-dy/vibecoding-sdk-taro/ui/alert-dialog'
+ * <AlertDialog><AlertDialogCancel /></AlertDialog>
+ * ```
+ */
 function AlertDialogCancel({ className, variant = "outline", size = "default", onClick, ...props }) {
     const { onOpenChange } = React.useContext(AlertDialogContext);
     return (_jsx(View, { "data-slot": "alert-dialog-cancel", className: cn(buttonVariants({ variant, size }), "mt-2 w-full sm:mt-0 sm:w-auto", className), onClick: (event) => {

package/dist/ui/alert-dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert-dialog.js","sourceRoot":"","sources":["../../src/ui/alert-dialog.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAGzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEjD,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAG3C,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAA;AAE3C,MAAM,yBAAyB,GAAG,KAAK,CAAC,aAAa,CAGlD;IACD,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,KAAK;CAChB,CAAC,CAAA;AAmBF,SAAS,WAAW,CAAC,EACnB,IAAI,EAAE,QAAQ,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,GAMT;IACC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,KAAK,CAAC,CAAA;IACpE,MAAM,UAAU,GAAG,QAAQ,KAAK,SAAS,CAAA;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IAE7C,OAAO,CACL,KAAC,kBAAkB,CAAC,QAAQ,IAC1B,KAAK,EAAE;YACL,IAAI;YACJ,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;gBAClB,IAAI,CAAC,UAAU;oBAAE,WAAW,CAAC,CAAC,CAAC,CAAA;gBAC/B,YAAY,EAAE,CAAC,CAAC,CAAC,CAAA;YACnB,CAAC;SACF,YAEA,QAAQ,GACmB,CAC/B,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,EAC1B,QAAQ,EACR,MAAM,EACN,OAAO,EACP,GAAG,KAAK,EACgB;IACxB,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC7D,MAAM,WAAW,GAAG,CAAC,KAAmC,EAAE,EAAE;QAC1D,KAAK,CAAC,eAAe,EAAE,CAAA;QACvB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAChB,YAAY,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,YAAY,GAAkC;QAClD,WAAW,EAAE,sBAAsB;QACnC,OAAO,EAAE,WAAW;QACpB,GAAG,KAAK;KACT,CAAA;IAED,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,4BAAG,MAAM,CAAC,YAAY,CAAC,GAAI,CAAA;QACpC,CAAC;QAED,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAEd,CAAA;YAEF,OAAO,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE;gBACjC,GAAG,YAAY;gBACf,OAAO,EAAE,CAAC,KAAmC,EAAE,EAAE;oBAC/C,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;oBAC9B,WAAW,CAAC,KAAK,CAAC,CAAA;gBACpB,CAAC;aACF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CACL,KAAC,IAAI,OAAK,YAAY,YACnB,QAAQ,GACJ,CACR,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAE,QAAQ,EAAkC;IACrE,OAAO,4BAAG,QAAQ,GAAI,CAAA;AACxB,CAAC;AAED,SAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC5D,OAAO,CACL,KAAC,IAAI,iBACO,sBAAsB,EAChC,SAAS,EAAE,EAAE,CACX,+FAA+F,EAC/F,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,IAAI,GAAG,SAAS,EAChB,GAAG,KAAK,EACgC;IACxC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAC5B,GAAG,EAAE,CACH,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CACnC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;QAC1B,KAAK,CAAC,KAAkC,CAAC,WAAW,CAAC,KAAK,oBAAoB,CAClF,EACH,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAE1B,OAAO,CACL,MAAC,IAAI,IAAC,SAAS,EAAC,qDAAqD,aACnE,KAAC,kBAAkB,KAAG,EACtB,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,YAC3D,KAAC,IAAI,iBACO,sBAAsB,EAChC,SAAS,EAAE,EAAE,CACX,kNAAkN,EAClN,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAsB,EACnD,SAAS,CACV,KACG,KAAK,YAER,QAAQ,GACJ,GAC4B,IAChC,CACR,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC3D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAA;IACtE,OAAO,CACL,KAAC,IAAI,iBACO,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CACX,kEAAkE,EAClE,QAAQ,IAAI,mCAAmC,EAC/C,IAAI,KAAK,SAAS,IAAI,mCAAmC,EACzD,IAAI,KAAK,SAAS,IAAI,QAAQ,IAAI,yBAAyB,EAC3D,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC3D,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAA;IAC5D,OAAO,CACL,KAAC,IAAI,iBACO,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CACX,+EAA+E,EAC/E,IAAI,KAAK,IAAI,IAAI,kBAAkB,EACnC,IAAI,KAAK,IAAI,IAAI,4BAA4B,EAC7C,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,oBAAoB,EAC9B,SAAS,EAAE,EAAE,CAAC,uBAAuB,EAAE,SAAS,CAAC,KAC7C,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAChE,OAAO,CACL,KAAC,IAAI,iBACO,0BAA0B,EACpC,SAAS,EAAE,EAAE,CAAC,+BAA+B,EAAE,SAAS,CAAC,KACrD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,OAAO,EACP,GAAG,KAAK,EACe;IACvB,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC7D,OAAO,CACL,KAAC,MAAM,iBACK,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAC/E,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,OAAO,EACP,GAAG,KAAK,EACe;IACvB,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC7D,OAAO,CACL,KAAC,IAAI,iBACO,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CACX,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EACjC,+BAA+B,EAC/B,SAAS,CACV,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,CAAA"}
+{"version":3,"file":"alert-dialog.js","sourceRoot":"","sources":["../../src/ui/alert-dialog.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAGzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEjD,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAG3C,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAA;AAE3C,MAAM,yBAAyB,GAAG,KAAK,CAAC,aAAa,CAGlD;IACD,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,KAAK;CAChB,CAAC,CAAA;AAsBF;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,EACnB,IAAI,EAAE,QAAQ,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,GAUT;IACC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,KAAK,CAAC,CAAA;IACpE,MAAM,UAAU,GAAG,QAAQ,KAAK,SAAS,CAAA;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IAE7C,OAAO,CACL,KAAC,kBAAkB,CAAC,QAAQ,IAC1B,KAAK,EAAE;YACL,IAAI;YACJ,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;gBAClB,IAAI,CAAC,UAAU;oBAAE,WAAW,CAAC,CAAC,CAAC,CAAA;gBAC/B,YAAY,EAAE,CAAC,CAAC,CAAC,CAAA;YACnB,CAAC;SACF,YAEA,QAAQ,GACmB,CAC/B,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,EAC1B,QAAQ,EACR,MAAM,EACN,OAAO,EACP,GAAG,KAAK,EACgB;IACxB,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC7D,MAAM,WAAW,GAAG,CAAC,KAAmC,EAAE,EAAE;QAC1D,KAAK,CAAC,eAAe,EAAE,CAAA;QACvB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAChB,YAAY,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,YAAY,GAAkC;QAClD,WAAW,EAAE,sBAAsB;QACnC,OAAO,EAAE,WAAW;QACpB,GAAG,KAAK;KACT,CAAA;IAED,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,4BAAG,MAAM,CAAC,YAAY,CAAC,GAAI,CAAA;QACpC,CAAC;QAED,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAEd,CAAA;YAEF,OAAO,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE;gBACjC,GAAG,YAAY;gBACf,OAAO,EAAE,CAAC,KAAmC,EAAE,EAAE;oBAC/C,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;oBAC9B,WAAW,CAAC,KAAK,CAAC,CAAA;gBACpB,CAAC;aACF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CACL,KAAC,IAAI,OAAK,YAAY,YACnB,QAAQ,GACJ,CACR,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,EAAE,QAAQ,EAEP;IAC5B,OAAO,4BAAG,QAAQ,GAAI,CAAA;AACxB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC5D,OAAO,CACL,KAAC,IAAI,iBACO,sBAAsB,EAChC,SAAS,EAAE,EAAE,CACX,+FAA+F,EAC/F,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,IAAI,GAAG,SAAS,EAChB,GAAG,KAAK,EAGiB;IACzB,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAC5B,GAAG,EAAE,CACH,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CACnC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;QAC1B,KAAK,CAAC,KAAkC,CAAC,WAAW,CAAC,KAAK,oBAAoB,CAClF,EACH,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAE1B,OAAO,CACL,MAAC,IAAI,IAAC,SAAS,EAAC,qDAAqD,aACnE,KAAC,kBAAkB,KAAG,EACtB,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,YAC3D,KAAC,IAAI,iBACO,sBAAsB,EAChC,SAAS,EAAE,EAAE,CACX,kNAAkN,EAClN,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAsB,EACnD,SAAS,CACV,KACG,KAAK,YAER,QAAQ,GACJ,GAC4B,IAChC,CACR,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC3D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAA;IACtE,OAAO,CACL,KAAC,IAAI,iBACO,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CACX,kEAAkE,EAClE,QAAQ,IAAI,mCAAmC,EAC/C,IAAI,KAAK,SAAS,IAAI,mCAAmC,EACzD,IAAI,KAAK,SAAS,IAAI,QAAQ,IAAI,yBAAyB,EAC3D,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC3D,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAA;IAC5D,OAAO,CACL,KAAC,IAAI,iBACO,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CACX,+EAA+E,EAC/E,IAAI,KAAK,IAAI,IAAI,kBAAkB,EACnC,IAAI,KAAK,IAAI,IAAI,4BAA4B,EAC7C,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,oBAAoB,EAC9B,SAAS,EAAE,EAAE,CAAC,uBAAuB,EAAE,SAAS,CAAC,KAC7C,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,sBAAsB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAChE,OAAO,CACL,KAAC,IAAI,iBACO,0BAA0B,EACpC,SAAS,EAAE,EAAE,CAAC,+BAA+B,EAAE,SAAS,CAAC,KACrD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,OAAO,EACP,GAAG,KAAK,EACe;IACvB,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC7D,OAAO,CACL,KAAC,MAAM,iBACK,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAC/E,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,OAAO,EACP,GAAG,KAAK,EACe;IACvB,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC7D,OAAO,CACL,KAAC,IAAI,iBACO,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CACX,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EACjC,+BAA+B,EAC/B,SAAS,CACV,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,CAAA"}

package/dist/ui/alert.d.ts

@@ -4,8 +4,49 @@ import { type VariantProps } from "class-variance-authority";
 declare const alertVariants: (props?: ({
     variant?: "default" | "destructive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 提示信息组件。
+ * @param {Parameters<typeof Alert>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Alert>[0]["variant"]} props.variant 提示色彩，默认 default；destructive 使用危险操作颜色并同步到 AlertDescription，只控制视觉，不执行错误处理。
+ * @return {ReturnType<typeof Alert>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Alert } from '@open-dy/vibecoding-sdk-taro/ui/alert'
+ * <Alert />
+ * ```
+ */
 declare function Alert({ className, variant, children, ...props }: ViewProps & VariantProps<typeof alertVariants>): React.JSX.Element;
+/**
+ * @desc 提示信息标题。
+ * @param {Parameters<typeof AlertTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Alert, AlertTitle } from '@open-dy/vibecoding-sdk-taro/ui/alert'
+ * <Alert><AlertTitle /></Alert>
+ * ```
+ */
 declare function AlertTitle({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 提示信息说明文本。
+ * @param {Parameters<typeof AlertDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Alert, AlertDescription } from '@open-dy/vibecoding-sdk-taro/ui/alert'
+ * <Alert><AlertDescription /></Alert>
+ * ```
+ */
 declare function AlertDescription({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 提示信息操作入口。
+ * @param {Parameters<typeof AlertAction>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof AlertAction>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Alert, AlertAction } from '@open-dy/vibecoding-sdk-taro/ui/alert'
+ * <Alert><AlertAction /></Alert>
+ * ```
+ */
 declare function AlertAction({ className, ...props }: ViewProps): React.JSX.Element;
 export { Alert, AlertTitle, AlertDescription, AlertAction };