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

package/dist/ui/pagination.d.ts

@@ -1,17 +1,93 @@
 import { type ViewProps } from "@tarojs/components";
 import { Button } from "./button.js";
+/**
+ * @desc 分页组件。
+ * @param {Parameters<typeof Pagination>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Pagination>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination />
+ * ```
+ */
 declare function Pagination({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 分页内容容器。
+ * @param {Parameters<typeof PaginationContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PaginationContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationContent } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationContent /></Pagination>
+ * ```
+ */
 declare function PaginationContent({ className, ...props }: ViewProps): import("react").JSX.Element;
+/**
+ * @desc 分页条目。
+ * @param {Parameters<typeof PaginationItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PaginationItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationItem } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationItem /></Pagination>
+ * ```
+ */
 declare function PaginationItem({ ...props }: ViewProps): import("react").JSX.Element;
 type PaginationLinkProps = {
+    /** @desc 是否为当前页，默认 false；当前页用 outline 按钮，其他页用 ghost。组件不管理页码或自动翻页。 */
     isActive?: boolean;
 } & Pick<React.ComponentProps<typeof Button>, "size"> & ViewProps;
+/**
+ * @desc 分页链接。
+ * @param {Parameters<typeof PaginationLink>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof PaginationLink>[0]["size"]} props.size 页码按钮尺寸，默认 icon（size-8）；其他尺寸同 Button.size，isActive 控制其外观。
+ * @return {ReturnType<typeof PaginationLink>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationLink } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationLink /></Pagination>
+ * ```
+ */
 declare function PaginationLink({ className, isActive, size, ...props }: PaginationLinkProps): import("react").JSX.Element;
+/**
+ * @desc 分页上一项按钮。
+ * @param {Parameters<typeof PaginationPrevious>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof PaginationPrevious>[0]["size"]} props.size 导航按钮尺寸，默认 default；可按 Button.size 覆写，文字及图标由组件提供。
+ * @return {ReturnType<typeof PaginationPrevious>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationPrevious } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationPrevious /></Pagination>
+ * ```
+ */
 declare function PaginationPrevious({ className, text, ...props }: React.ComponentProps<typeof PaginationLink> & {
+    /** @desc 上一页按钮文字，默认 "Previous"；窄屏下文字隐藏，只保留图标，翻页需自行绑定事件。 */
     text?: string;
 }): import("react").JSX.Element;
+/**
+ * @desc 分页下一项按钮。
+ * @param {Parameters<typeof PaginationNext>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof PaginationNext>[0]["size"]} props.size 导航按钮尺寸，默认 default；可按 Button.size 覆写，文字及图标由组件提供。
+ * @return {ReturnType<typeof PaginationNext>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationNext } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationNext /></Pagination>
+ * ```
+ */
 declare function PaginationNext({ className, text, ...props }: React.ComponentProps<typeof PaginationLink> & {
+    /** @desc 下一页按钮文字，默认 "Next"；窄屏下文字隐藏，只保留图标，翻页需自行绑定事件。 */
     text?: string;
 }): import("react").JSX.Element;
+/**
+ * @desc 分页省略标记。
+ * @param {Parameters<typeof PaginationEllipsis>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PaginationEllipsis>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationEllipsis } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationEllipsis /></Pagination>
+ * ```
+ */
 declare function PaginationEllipsis({ className, ...props }: ViewProps): import("react").JSX.Element;
 export { Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, };

package/dist/ui/pagination.js

@@ -3,24 +3,97 @@ import { View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
 import { Button } from "./button.js";
 import { ChevronLeft, ChevronRight, Ellipsis } from "@open-dy/lucide-taro";
+/**
+ * @desc 分页组件。
+ * @param {Parameters<typeof Pagination>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Pagination>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination />
+ * ```
+ */
 function Pagination({ className, ...props }) {
     return (_jsx(View, { "data-slot": "pagination", className: cn("mx-auto flex w-full justify-center", className), ...props }));
 }
+/**
+ * @desc 分页内容容器。
+ * @param {Parameters<typeof PaginationContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PaginationContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationContent } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationContent /></Pagination>
+ * ```
+ */
 function PaginationContent({ className, ...props }) {
     return (_jsx(View, { "data-slot": "pagination-content", className: cn("flex items-center gap-0.5", className), ...props }));
 }
+/**
+ * @desc 分页条目。
+ * @param {Parameters<typeof PaginationItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PaginationItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationItem } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationItem /></Pagination>
+ * ```
+ */
 function PaginationItem({ ...props }) {
     return _jsx(View, { "data-slot": "pagination-item", ...props });
 }
+/**
+ * @desc 分页链接。
+ * @param {Parameters<typeof PaginationLink>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof PaginationLink>[0]["size"]} props.size 页码按钮尺寸，默认 icon（size-8）；其他尺寸同 Button.size，isActive 控制其外观。
+ * @return {ReturnType<typeof PaginationLink>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationLink } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationLink /></Pagination>
+ * ```
+ */
 function PaginationLink({ className, isActive, size = "icon", ...props }) {
     return (_jsx(Button, { variant: isActive ? "outline" : "ghost", size: size, "data-slot": "pagination-link", "data-active": isActive, className: cn(className), ...props }));
 }
+/**
+ * @desc 分页上一项按钮。
+ * @param {Parameters<typeof PaginationPrevious>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof PaginationPrevious>[0]["size"]} props.size 导航按钮尺寸，默认 default；可按 Button.size 覆写，文字及图标由组件提供。
+ * @return {ReturnType<typeof PaginationPrevious>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationPrevious } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationPrevious /></Pagination>
+ * ```
+ */
 function PaginationPrevious({ className, text = "Previous", ...props }) {
     return (_jsxs(PaginationLink, { size: "default", className: cn("pl-1.5!", className), ...props, children: [_jsx(ChevronLeft, { "data-icon": "inline-start" }), _jsx(View, { className: "hidden sm:block", children: text })] }));
 }
+/**
+ * @desc 分页下一项按钮。
+ * @param {Parameters<typeof PaginationNext>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof PaginationNext>[0]["size"]} props.size 导航按钮尺寸，默认 default；可按 Button.size 覆写，文字及图标由组件提供。
+ * @return {ReturnType<typeof PaginationNext>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationNext } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationNext /></Pagination>
+ * ```
+ */
 function PaginationNext({ className, text = "Next", ...props }) {
     return (_jsxs(PaginationLink, { size: "default", className: cn("pr-1.5!", className), ...props, children: [_jsx(View, { className: "hidden sm:block", children: text }), _jsx(ChevronRight, { "data-icon": "inline-end" })] }));
 }
+/**
+ * @desc 分页省略标记。
+ * @param {Parameters<typeof PaginationEllipsis>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PaginationEllipsis>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Pagination, PaginationEllipsis } from '@open-dy/vibecoding-sdk-taro/ui/pagination'
+ * <Pagination><PaginationEllipsis /></Pagination>
+ * ```
+ */
 function PaginationEllipsis({ className, ...props }) {
     return (_jsx(View, { "data-slot": "pagination-ellipsis", className: cn("flex size-8 items-center justify-center [&_svg:not([class*='size-'])]:size-4", className), ...props, children: _jsx(Ellipsis, {}) }));
 }

package/dist/ui/pagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/ui/pagination.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAEzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE1E,SAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACpD,OAAO,CACL,KAAC,IAAI,iBACO,YAAY,EACtB,SAAS,EAAE,EAAE,CAAC,oCAAoC,EAAE,SAAS,CAAC,KAC1D,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,KAAK,EACE;IACV,OAAO,CACL,KAAC,IAAI,iBACO,oBAAoB,EAC9B,SAAS,EAAE,EAAE,CAAC,2BAA2B,EAAE,SAAS,CAAC,KACjD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,EAAE,GAAG,KAAK,EAAa;IAC7C,OAAO,KAAC,IAAI,iBAAW,iBAAiB,KAAK,KAAK,GAAI,CAAA;AACxD,CAAC;AAOD,SAAS,cAAc,CAAC,EACtB,SAAS,EACT,QAAQ,EACR,IAAI,GAAG,MAAM,EACb,GAAG,KAAK,EACY;IACpB,OAAO,CACL,KAAC,MAAM,IACL,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EACvC,IAAI,EAAE,IAAI,eACA,iBAAiB,iBACd,QAAQ,EACrB,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KACpB,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,IAAI,GAAG,UAAU,EACjB,GAAG,KAAK,EACwD;IAChE,OAAO,CACL,MAAC,cAAc,IACb,IAAI,EAAC,SAAS,EACd,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,KAC/B,KAAK,aAET,KAAC,WAAW,iBAAW,cAAc,GAAG,EACxC,KAAC,IAAI,IAAC,SAAS,EAAC,iBAAiB,YAAE,IAAI,GAAQ,IAChC,CAClB,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,EACtB,SAAS,EACT,IAAI,GAAG,MAAM,EACb,GAAG,KAAK,EACwD;IAChE,OAAO,CACL,MAAC,cAAc,IACb,IAAI,EAAC,SAAS,EACd,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,KAC/B,KAAK,aAET,KAAC,IAAI,IAAC,SAAS,EAAC,iBAAiB,YAAE,IAAI,GAAQ,EAC/C,KAAC,YAAY,iBAAW,YAAY,GAAG,IACxB,CAClB,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,GAAG,KAAK,EACE;IACV,OAAO,CACL,KAAC,IAAI,iBACO,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CACX,8EAA8E,EAC9E,SAAS,CACV,KACG,KAAK,YAET,KAAC,QAAQ,KAAG,GACP,CACR,CAAA;AACH,CAAC;AAED,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,CAAA"}
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/ui/pagination.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAEzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE1E;;;;;;;;;GASG;AACH,SAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACpD,OAAO,CACL,KAAC,IAAI,iBACO,YAAY,EACtB,SAAS,EAAE,EAAE,CAAC,oCAAoC,EAAE,SAAS,CAAC,KAC1D,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,KAAK,EACE;IACV,OAAO,CACL,KAAC,IAAI,iBACO,oBAAoB,EAC9B,SAAS,EAAE,EAAE,CAAC,2BAA2B,EAAE,SAAS,CAAC,KACjD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,cAAc,CAAC,EAAE,GAAG,KAAK,EAAa;IAC7C,OAAO,KAAC,IAAI,iBAAW,iBAAiB,KAAK,KAAK,GAAI,CAAA;AACxD,CAAC;AAQD;;;;;;;;;;GAUG;AACH,SAAS,cAAc,CAAC,EACtB,SAAS,EACT,QAAQ,EACR,IAAI,GAAG,MAAM,EACb,GAAG,KAAK,EACY;IACpB,OAAO,CACL,KAAC,MAAM,IACL,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EACvC,IAAI,EAAE,IAAI,eACA,iBAAiB,iBACd,QAAQ,EACrB,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KACpB,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,IAAI,GAAG,UAAU,EACjB,GAAG,KAAK,EAGO;IACf,OAAO,CACL,MAAC,cAAc,IACb,IAAI,EAAC,SAAS,EACd,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,KAC/B,KAAK,aAET,KAAC,WAAW,iBAAW,cAAc,GAAG,EACxC,KAAC,IAAI,IAAC,SAAS,EAAC,iBAAiB,YAAE,IAAI,GAAQ,IAChC,CAClB,CAAA;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,cAAc,CAAC,EACtB,SAAS,EACT,IAAI,GAAG,MAAM,EACb,GAAG,KAAK,EAGO;IACf,OAAO,CACL,MAAC,cAAc,IACb,IAAI,EAAC,SAAS,EACd,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,KAC/B,KAAK,aAET,KAAC,IAAI,IAAC,SAAS,EAAC,iBAAiB,YAAE,IAAI,GAAQ,EAC/C,KAAC,YAAY,iBAAW,YAAY,GAAG,IACxB,CAClB,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,GAAG,KAAK,EACE;IACV,OAAO,CACL,KAAC,IAAI,iBACO,qBAAqB,EAC/B,SAAS,EAAE,EAAE,CACX,8EAA8E,EAC9E,SAAS,CACV,KACG,KAAK,YAET,KAAC,QAAQ,KAAG,GACP,CACR,CAAA;AACH,CAAC;AAED,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,CAAA"}

package/dist/ui/popover.d.ts

@@ -1,27 +1,108 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 type PopoverTriggerRenderProps = Omit<ViewProps, "children"> & {
+    /** @desc 组件自动注入的触发器标识；自定义 render 应转发到触发节点，不手动修改。 */
     "data-slot": "popover-trigger";
+    /** @desc 组件自动注入的展开状态；自定义 render 应转发到触发节点。 */
     "aria-expanded": boolean;
 };
 type PopoverTriggerProps = Omit<ViewProps, "children"> & {
+    /** @desc 默认触发器内的内容；设置 render 时由自定义渲染结果取代。 */
     children?: React.ReactNode;
+    /** @desc 自定义触发器元素或渲染函数；省略时使用 View。元素会被克隆并合并点击处理；函数收到状态和事件 props，必须传给实际可点击节点。 */
     render?: React.ReactElement | ((props: PopoverTriggerRenderProps) => React.ReactNode);
 };
+/**
+ * @desc 弹出面板组件。
+ * @param {Parameters<typeof Popover>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Popover>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover />
+ * ```
+ */
 declare function Popover({ 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 PopoverTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverTrigger } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverTrigger /></Popover>
+ * ```
+ */
 declare function PopoverTrigger({ children, render, onClick, ...props }: PopoverTriggerProps): React.JSX.Element;
+/**
+ * @desc 弹出面板内容容器。
+ * @param {Parameters<typeof PopoverContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverContent } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverContent /></Popover>
+ * ```
+ */
 declare function PopoverContent({ className, align, sideOffset, side, children, style, ...props }: ViewProps & {
+    /** @desc 相对触发器的对齐位置：start 起端、center 居中、end 末端；默认 center。 */
     align?: "start" | "center" | "end";
+    /** @desc 内容与触发器之间的间距，单位为像素，默认 4；参与测量后的浮层定位。 */
     sideOffset?: number;
+    /** @desc 内容出现的方向：top、bottom、left 或 right；默认 bottom，定位时会结合视口边界调整。 */
     side?: "top" | "right" | "bottom" | "left";
 }): React.JSX.Element | null;
+/**
+ * @desc 弹出面板定位锚点。
+ * @param {Parameters<typeof PopoverAnchor>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverAnchor>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverAnchor } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverAnchor /></Popover>
+ * ```
+ */
 declare function PopoverAnchor({ children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 弹出面板头部布局。
+ * @param {Parameters<typeof PopoverHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverHeader } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverHeader /></Popover>
+ * ```
+ */
 declare function PopoverHeader({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 弹出面板标题。
+ * @param {Parameters<typeof PopoverTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverTitle } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverTitle /></Popover>
+ * ```
+ */
 declare function PopoverTitle({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 弹出面板说明文本。
+ * @param {Parameters<typeof PopoverDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverDescription } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverDescription /></Popover>
+ * ```
+ */
 declare function PopoverDescription({ className, ...props }: ViewProps): React.JSX.Element;
 export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor, PopoverHeader, PopoverTitle, PopoverDescription, };

package/dist/ui/popover.js

@@ -10,6 +10,16 @@ const PopoverContext = React.createContext({
     onOpenChange: () => { },
     triggerId: "",
 });
+/**
+ * @desc 弹出面板组件。
+ * @param {Parameters<typeof Popover>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Popover>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover />
+ * ```
+ */
 function Popover({ open: openProp, defaultOpen, onOpenChange, children, }) {
     const triggerId = React.useRef(`popover-trigger-${Math.random().toString(36).slice(2, 10)}`);
     const [internal, setInternal] = React.useState(defaultOpen ?? false);
@@ -38,6 +48,16 @@ function Popover({ open: openProp, defaultOpen, onOpenChange, children, }) {
             triggerId: triggerId.current,
         }, children: children }));
 }
+/**
+ * @desc 弹出面板触发器。
+ * @param {Parameters<typeof PopoverTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverTrigger } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverTrigger /></Popover>
+ * ```
+ */
 function PopoverTrigger({ children, render, onClick, ...props }) {
     const { open, onOpenChange, triggerId } = React.useContext(PopoverContext);
     const handleClick = (event) => {
@@ -68,6 +88,16 @@ function PopoverTrigger({ children, render, onClick, ...props }) {
     }
     return (_jsx(View, { ...triggerProps, children: children }));
 }
+/**
+ * @desc 弹出面板内容容器。
+ * @param {Parameters<typeof PopoverContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverContent } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverContent /></Popover>
+ * ```
+ */
 function PopoverContent({ className, align = "center", sideOffset = 4, side = "bottom", children, style, ...props }) {
     const { open, onOpenChange, triggerId } = React.useContext(PopoverContext);
     const contentId = React.useRef(`popover-content-${Math.random().toString(36).slice(2, 10)}`);
@@ -123,15 +153,55 @@ function PopoverContent({ className, align = "center", sideOffset = 4, side = "b
         };
     return (_jsxs(Portal, { children: [_jsx(View, { className: "fixed inset-0 z-40", onClick: () => onOpenChange(false) }), _jsx(View, { id: contentId.current, "data-slot": "popover-content", "data-state": "open", "data-align": align, "data-side": side, className: cn("fixed z-50 w-72 origin-[var(--transform-origin)] rounded-lg border bg-popover p-4 text-popover-foreground shadow-md outline-hidden", className), style: contentStyle, onClick: (event) => event.stopPropagation(), ...props, children: children })] }));
 }
+/**
+ * @desc 弹出面板定位锚点。
+ * @param {Parameters<typeof PopoverAnchor>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverAnchor>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverAnchor } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverAnchor /></Popover>
+ * ```
+ */
 function PopoverAnchor({ children, ...props }) {
     return (_jsx(View, { "data-slot": "popover-anchor", ...props, children: children }));
 }
+/**
+ * @desc 弹出面板头部布局。
+ * @param {Parameters<typeof PopoverHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverHeader } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverHeader /></Popover>
+ * ```
+ */
 function PopoverHeader({ className, ...props }) {
     return (_jsx(View, { "data-slot": "popover-header", className: cn("grid gap-1.5", className), ...props }));
 }
+/**
+ * @desc 弹出面板标题。
+ * @param {Parameters<typeof PopoverTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverTitle } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverTitle /></Popover>
+ * ```
+ */
 function PopoverTitle({ className, ...props }) {
     return (_jsx(View, { "data-slot": "popover-title", className: cn("font-medium leading-none", className), ...props }));
 }
+/**
+ * @desc 弹出面板说明文本。
+ * @param {Parameters<typeof PopoverDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof PopoverDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Popover, PopoverDescription } from '@open-dy/vibecoding-sdk-taro/ui/popover'
+ * <Popover><PopoverDescription /></Popover>
+ * ```
+ */
 function PopoverDescription({ className, ...props }) {
     return (_jsx(View, { "data-slot": "popover-description", className: cn("text-sm text-muted-foreground", className), ...props }));
 }

package/dist/ui/popover.js.map

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

package/dist/ui/portal.d.ts

@@ -1,5 +1,16 @@
 import * as React from "react";
+/**
+ * @desc H5 将内容挂载到 document.body；其他端优先使用 RootPortal，不可用时保留子节点。
+ * @param {Parameters<typeof Portal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Portal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Portal } from '@open-dy/vibecoding-sdk-taro/ui/portal'
+ * <Portal>内容</Portal>
+ * ```
+ */
 declare const Portal: ({ children }: {
+    /** @desc 要挂载的节点；H5 挂到 document.body，小程序优先使用 RootPortal，不可用时在当前位置渲染。 */
     children: React.ReactNode;
 }) => any;
 export { Portal };

package/dist/ui/portal.js

@@ -3,6 +3,16 @@ import * as TaroComponents from "@tarojs/components";
 import { createPortal } from "react-dom";
 import { isH5 } from "../lib/platform.js";
 const RootPortal = TaroComponents.RootPortal;
+/**
+ * @desc H5 将内容挂载到 document.body；其他端优先使用 RootPortal，不可用时保留子节点。
+ * @param {Parameters<typeof Portal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Portal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Portal } from '@open-dy/vibecoding-sdk-taro/ui/portal'
+ * <Portal>内容</Portal>
+ * ```
+ */
 const Portal = ({ children }) => {
     if (isH5()) {
         if (typeof document === "undefined")

package/dist/ui/portal.js.map

@@ -1 +1 @@
-{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../src/ui/portal.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,cAAc,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEtC,MAAM,UAAU,GAAI,cAAsB,CAAC,UAAU,CAAA;AAErD,MAAM,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE;IAC7D,IAAI,IAAI,EAAE,EAAE,CAAC;QACX,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO,4BAAG,QAAQ,GAAI,CAAA;QAC3D,OAAO,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,4BAAG,QAAQ,GAAI,CAAA;IACxB,CAAC;IACD,OAAO,KAAC,UAAU,cAAE,QAAQ,GAAc,CAAA;AAC5C,CAAC,CAAA;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}
+{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../src/ui/portal.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,cAAc,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEtC,MAAM,UAAU,GAAI,cAAsB,CAAC,UAAU,CAAA;AAErD;;;;;;;;;GASG;AACH,MAAM,MAAM,GAAG,CAAC,EAAE,QAAQ,EAEG,EAAE,EAAE;IAC/B,IAAI,IAAI,EAAE,EAAE,CAAC;QACX,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO,4BAAG,QAAQ,GAAI,CAAA;QAC3D,OAAO,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,4BAAG,QAAQ,GAAI,CAAA;IACxB,CAAC;IACD,OAAO,KAAC,UAAU,cAAE,QAAQ,GAAc,CAAA;AAC5C,CAAC,CAAA;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/ui/progress.d.ts

@@ -2,44 +2,71 @@ import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 type ProgressValueRender = (formattedValue: string | null, value: number | null) => React.ReactNode;
 type ProgressValueProps = Omit<ViewProps, "children"> & {
+    /** @desc 自定义数值节点或渲染函数；函数收到格式化百分比和原始 value，缺少确定值时收到 "indeterminate" 和 null。省略时显示上下文百分比。 */
     children?: React.ReactNode | ProgressValueRender;
 };
 /**
- * Progress — context 提供者 + 布局容器。
- *
- * 不自动渲染 ProgressTrack，避免使用者在 children 中传入 ProgressTrack 时出现双轨道。
- * 无 children 时自动渲染默认 ProgressTrack + ProgressIndicator 作为兜底。
- *
- * 用法示例：
- *   // 极简（无 children，自动渲染默认轨道）
- *   <Progress value={60} />
- *
- *   // 带标签（显式传入 ProgressTrack）
- *   <Progress value={60}>
- *     <ProgressLabel>加载中</ProgressLabel>
- *     <ProgressValue />
- *     <ProgressTrack>
- *       <ProgressIndicator />
- *     </ProgressTrack>
- *   </Progress>
- *
- *   // 自定义颜色
- *   <Progress value={60}>
- *     <ProgressTrack className="bg-violet-100">
- *       <ProgressIndicator className="bg-violet-500" />
- *     </ProgressTrack>
- *   </Progress>
+ * @desc 进度上下文与布局容器；没有 children 时自动渲染默认轨道和指示器。
+ * @param {Parameters<typeof Progress>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Progress>[0]["children"]} props.children 自定义组合内容；省略或 null 时自动渲染 ProgressTrack 与 ProgressIndicator，提供内容时需自行组合轨道和填充。
+ * @return {ReturnType<typeof Progress>} 组件渲染结果；类型见返回值契约。
+ * @remarks 未传 children 时自动渲染轨道和指示器；传入 children 后显式组合 ProgressTrack 和 ProgressIndicator，避免双轨道。
+ * @example
+ * ```tsx
+ * import { Progress } from '@open-dy/vibecoding-sdk-taro/ui/progress'
+ * <Progress />
+ * ```
  */
 declare function Progress({ className, children, value, max, ...props }: ViewProps & {
+    /** @desc 当前进度值；省略或 null 表示没有确定值（填充宽度为 0、默认数值文本为空）。数值按 max 换算百分比并限制在 0–100%。 */
     value?: number | null;
+    /** @desc 进度满值，默认 100；大于 0 时作为百分比的分母，非正数回退为 100。 */
     max?: number;
 }): React.JSX.Element;
+/**
+ * @desc 进度条轨道。
+ * @param {Parameters<typeof ProgressTrack>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ProgressTrack>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Progress, ProgressTrack } from '@open-dy/vibecoding-sdk-taro/ui/progress'
+ * <Progress><ProgressTrack /></Progress>
+ * ```
+ */
 declare function ProgressTrack({ className, ...props }: ViewProps): React.JSX.Element;
 /**
- * ProgressIndicator — 自动从 ProgressContext 读取百分比，无需手动传 style={{ width }}。
- * 若外部显式传入 style.width，则以外部值为准。
+ * @desc 从 Progress 上下文读取百分比作为宽度；显式 style.width 优先。
+ * @param {Parameters<typeof ProgressIndicator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof ProgressIndicator>[0]["style"]} props.style 填充条内联样式；指定 width 时优先于上下文百分比，不指定时按 Progress.value/max 计算。
+ * @return {ReturnType<typeof ProgressIndicator>} 组件渲染结果；类型见返回值契约。
+ * @remarks ProgressIndicator — 自动从 ProgressContext 读取百分比，无需手动传 style={{ width }}。 若外部显式传入 style.width，则以外部值为准。
+ * @example
+ * ```tsx
+ * import { Progress, ProgressIndicator } from '@open-dy/vibecoding-sdk-taro/ui/progress'
+ * <Progress><ProgressIndicator /></Progress>
+ * ```
  */
 declare function ProgressIndicator({ className, style, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 进度条标签文本。
+ * @param {Parameters<typeof ProgressLabel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ProgressLabel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Progress, ProgressLabel } from '@open-dy/vibecoding-sdk-taro/ui/progress'
+ * <Progress><ProgressLabel /></Progress>
+ * ```
+ */
 declare function ProgressLabel({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 展示进度值；支持自定义 children 或读取格式化值的渲染函数。
+ * @param {Parameters<typeof ProgressValue>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ProgressValue>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Progress, ProgressValue } from '@open-dy/vibecoding-sdk-taro/ui/progress'
+ * <Progress><ProgressValue /></Progress>
+ * ```
+ */
 declare function ProgressValue({ className, children, ...props }: ProgressValueProps): React.JSX.Element;
 export { Progress, ProgressTrack, ProgressIndicator, ProgressLabel, ProgressValue, };