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

package/dist/ui/select.js

@@ -12,6 +12,24 @@ const SelectContext = React.createContext({
     triggerId: "",
     setSelectedLabel: () => { },
 });
+/**
+ * @desc 选择框组件。
+ * @param {Parameters<typeof Select>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Select>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { useState } from 'react'
+ * import { Select, SelectTrigger, SelectValue, SelectContent, SelectItem } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * export function ThemePicker() {
+ *   const [value, setValue] = useState<string | null>(null)
+ *   const items = [{ value: 'light', label: '明亮' }, { value: 'dark', label: '深色' }]
+ *   return <Select items={items} value={value} onValueChange={setValue}>
+ *     <SelectTrigger><SelectValue placeholder="选择主题" /></SelectTrigger>
+ *     <SelectContent>{items.map((item) => <SelectItem key={item.value} value={item.value}>{item.label}</SelectItem>)}</SelectContent>
+ *   </Select>
+ * }
+ * ```
+ */
 function Select({ open: openProp, defaultOpen, onOpenChange, value: valueProp, defaultValue, onValueChange, items, children, }) {
     const triggerIdRef = React.useRef(`select-${Math.random().toString(36).slice(2, 10)}`);
     const [internalOpen, setInternalOpen] = React.useState(defaultOpen ?? false);
@@ -51,16 +69,46 @@ function Select({ open: openProp, defaultOpen, onOpenChange, value: valueProp, d
             placeholder,
         }, children: children }));
 }
+/**
+ * @desc 选择框触发器。
+ * @param {Parameters<typeof SelectTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectTrigger } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectTrigger /></Select>
+ * ```
+ */
 function SelectTrigger({ className, size = "default", children, ...props }) {
     const { onOpenChange, open, triggerId } = React.useContext(SelectContext);
     return (_jsxs(View, { id: triggerId, "data-slot": "select-trigger", "data-size": size, "aria-expanded": open, className: cn("flex w-fit items-center justify-between gap-2 rounded-lg border border-input bg-transparent px-2.5 py-1 text-sm whitespace-nowrap transition-colors outline-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 [&>span]:line-clamp-1", size === "default" && "h-8", size === "sm" && "h-7 rounded-[min(var(--radius-md),12px)]", className), onClick: () => onOpenChange(!open), ...props, children: [children, _jsx(ChevronDown, { className: "opacity-50", size: 16 })] }));
 }
+/**
+ * @desc 选择框当前值展示。
+ * @param {Parameters<typeof SelectValue>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectValue>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectValue } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectValue /></Select>
+ * ```
+ */
 function SelectValue({ placeholder, className, ...props }) {
     const { value, selectedLabel, placeholder: contextPlaceholder } = React.useContext(SelectContext);
     const hasValue = !isEmptyValue(value);
     const displayValue = selectedLabel || value || placeholder || contextPlaceholder;
     return (_jsx(View, { "data-slot": "select-value", className: cn("line-clamp-1 flex items-center gap-1", !hasValue && "text-muted-foreground", className), ...props, children: displayValue }));
 }
+/**
+ * @desc 选择框内容容器。
+ * @param {Parameters<typeof SelectContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectContent } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectContent /></Select>
+ * ```
+ */
 function SelectContent({ className, children, position: _position, ...props }) {
     const { open, onOpenChange, triggerId } = React.useContext(SelectContext);
     const contentIdRef = React.useRef(`select-content-${Math.random().toString(36).slice(2, 10)}`);
@@ -108,6 +156,16 @@ function SelectContent({ className, children, position: _position, ...props }) {
                         pointerEvents: "none",
                     }, ...props, children: _jsx(ScrollView, { scrollY: true, className: "max-h-[50vh]", children: _jsx(View, { className: "w-full p-1", children: children }) }) })] }));
 }
+/**
+ * @desc 选择框条目。
+ * @param {Parameters<typeof SelectItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectItem } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectItem value="one" /></Select>
+ * ```
+ */
 function SelectItem({ className, children, value, ...props }) {
     const ctx = React.useContext(SelectContext);
     const isSelected = ctx.value === value;
@@ -117,18 +175,68 @@ function SelectItem({ className, children, value, ...props }) {
             ctx.onOpenChange(false);
         }, ...props, children: [_jsx(View, { className: "pointer-events-none absolute left-2 flex size-3.5 items-center justify-center", children: isSelected ? _jsx(Check, { className: "size-4" }) : null }), children] }));
 }
+/**
+ * @desc 选择框分组容器。
+ * @param {Parameters<typeof SelectGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectGroup } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectGroup /></Select>
+ * ```
+ */
 function SelectGroup({ ...props }) {
     return _jsx(View, { "data-slot": "select-group", ...props });
 }
+/**
+ * @desc 选择框标签文本。
+ * @param {Parameters<typeof SelectLabel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectLabel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectLabel } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectLabel /></Select>
+ * ```
+ */
 function SelectLabel({ className, ...props }) {
     return (_jsx(View, { "data-slot": "select-label", className: cn("py-1.5 pl-8 pr-2 text-sm font-semibold", className), ...props }));
 }
+/**
+ * @desc 选择框分隔线。
+ * @param {Parameters<typeof SelectSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectSeparator } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectSeparator /></Select>
+ * ```
+ */
 function SelectSeparator({ className, ...props }) {
     return (_jsx(View, { "data-slot": "select-separator", className: cn("-mx-1 my-1 h-px bg-muted", className), ...props }));
 }
+/**
+ * @desc 选择框向上滚动按钮。
+ * @param {Parameters<typeof SelectScrollUpButton>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectScrollUpButton>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectScrollUpButton } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectScrollUpButton /></Select>
+ * ```
+ */
 function SelectScrollUpButton({ className, ...props }) {
     return (_jsx(View, { "data-slot": "select-scroll-up-button", className: cn("flex cursor-default items-center justify-center py-1", className), ...props }));
 }
+/**
+ * @desc 选择框向下滚动按钮。
+ * @param {Parameters<typeof SelectScrollDownButton>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SelectScrollDownButton>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Select, SelectScrollDownButton } from '@open-dy/vibecoding-sdk-taro/ui/select'
+ * <Select><SelectScrollDownButton /></Select>
+ * ```
+ */
 function SelectScrollDownButton({ className, ...props }) {
     return (_jsx(View, { "data-slot": "select-scroll-down-button", className: cn("flex cursor-default items-center justify-center py-1", className), ...props }));
 }

package/dist/ui/select.js.map

@@ -1 +1 @@
-{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/ui/select.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/ui/select.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAErE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAWjC,MAAM,YAAY,GAAG,CAAC,KAAkC,EAAE,EAAE,CAC1D,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAA;AAEvD,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAStC;IACD,IAAI,EAAE,KAAK;IACX,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;IACtB,SAAS,EAAE,EAAE;IACb,gBAAgB,EAAE,GAAG,EAAE,GAAE,CAAC;CAC3B,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,MAAM,CAAC,EACd,IAAI,EAAE,QAAQ,EACd,WAAW,EACX,YAAY,EACZ,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,aAAa,EACb,KAAK,EACL,QAAQ,GAkBT;IACC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAC/B,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CACpD,CAAA;IACD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,KAAK,CAAC,CAAA;IAC5E,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,QAAQ,CACtD,YAAY,IAAI,IAAI,CACrB,CAAA;IACD,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAmB,CAAA;IAC3E,MAAM,cAAc,GAAG,QAAQ,KAAK,SAAS,CAAA;IAC7C,MAAM,eAAe,GAAG,SAAS,KAAK,SAAS,CAAA;IAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAA;IACrD,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAA;IACzD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAC/B,GAAG,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAC5D,CAAC,KAAK,CAAC,CACR,CAAA;IAED,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,gBAAgB,CAAC,SAAS,CAAC,CAAA;YAC3B,OAAM;QACR,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;QAC/D,IAAI,WAAW,EAAE,CAAC;YAChB,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QACrC,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;IAElB,OAAO,CACL,KAAC,aAAa,CAAC,QAAQ,IACrB,KAAK,EAAE;YACL,IAAI;YACJ,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;gBAClB,IAAI,CAAC,cAAc;oBAAE,eAAe,CAAC,CAAC,CAAC,CAAA;gBACvC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAA;YACnB,CAAC;YACD,KAAK;YACL,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE;gBACnB,IAAI,CAAC,eAAe;oBAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;gBACzC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAA;YACpB,CAAC;YACD,SAAS,EAAE,YAAY,CAAC,OAAO;YAC/B,aAAa;YACb,gBAAgB;YAChB,WAAW;SACZ,YAEA,QAAQ,GACc,CAC1B,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,aAAa,CAAC,EACrB,SAAS,EACT,IAAI,GAAG,SAAS,EAChB,QAAQ,EACR,GAAG,KAAK,EAIT;IACC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;IACzE,OAAO,CACL,MAAC,IAAI,IACH,EAAE,EAAE,SAAS,eACH,gBAAgB,eACf,IAAI,mBACA,IAAI,EACnB,SAAS,EAAE,EAAE,CACX,wjBAAwjB,EACxjB,IAAI,KAAK,SAAS,IAAI,KAAK,EAC3B,IAAI,KAAK,IAAI,IAAI,0CAA0C,EAC3D,SAAS,CACV,EACD,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAC9B,KAAK,aAER,QAAQ,EACT,KAAC,WAAW,IAAC,SAAS,EAAC,YAAY,EAAC,IAAI,EAAE,EAAE,GAAI,IAC3C,CACR,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,EACnB,WAAW,EACX,SAAS,EACT,GAAG,KAAK,EAGc;IACtB,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,GAC7D,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;IACjC,MAAM,QAAQ,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,MAAM,YAAY,GAAG,aAAa,IAAI,KAAK,IAAI,WAAW,IAAI,kBAAkB,CAAA;IAEhF,OAAO,CACL,KAAC,IAAI,iBACO,cAAc,EACxB,SAAS,EAAE,EAAE,CACX,sCAAsC,EACtC,CAAC,QAAQ,IAAI,uBAAuB,EACpC,SAAS,CACV,KACG,KAAK,YAER,YAAY,GACR,CACR,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,aAAa,CAAC,EACrB,SAAS,EACT,QAAQ,EACR,QAAQ,EAAE,SAAS,EACnB,GAAG,KAAK,EAGW;IACnB,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;IACzE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAC/B,kBAAkB,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAC5D,CAAA;IACD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAIpC,IAAI,CAAC,CAAA;IAEf,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,WAAW,CAAC,IAAI,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAA;QAErB,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;YACjC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACnD,WAAW,CAAC,SAAS,CAAC;gBACtB,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC;aAClC,CAAC,CAAA;YAEF,IAAI,SAAS,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW;gBAAE,OAAM;YAErD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;YAC9B,MAAM,MAAM,GAAG,CAAC,CAAA;YAChB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAA;YAChE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CACnB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,EAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC,CACtD,CAAA;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAClB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,EAC1D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAChE,CAAA;YAED,WAAW,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAA;QACtD,CAAC,CAAA;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,KAAK,eAAe,EAAE,CAAA;QACxB,CAAC,EAAE,CAAC,CAAC,CAAA;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;YAChB,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;IAErB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,OAAO,CACL,MAAC,MAAM,eACL,KAAC,IAAI,IAAC,SAAS,EAAC,oBAAoB,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,GAAI,EAC3E,KAAC,IAAI,IACH,EAAE,EAAE,YAAY,CAAC,OAAO,eACd,gBAAgB,EAC1B,SAAS,EAAE,EAAE,CACX,wGAAwG,EACxG,SAAS,CACV,EACD,KAAK,EACH,QAAQ;oBACN,CAAC,CAAC;wBACE,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,GAAG,EAAE,QAAQ,CAAC,GAAG;wBACjB,KAAK,EAAE,QAAQ,CAAC,KAAK;qBACtB;oBACH,CAAC,CAAC;wBACE,IAAI,EAAE,CAAC;wBACP,GAAG,EAAE,CAAC;wBACN,OAAO,EAAE,CAAC;wBACV,aAAa,EAAE,MAAM;qBACtB,KAEH,KAAK,YAET,KAAC,UAAU,IAAC,OAAO,QAAC,SAAS,EAAC,cAAc,YAC1C,KAAC,IAAI,IAAC,SAAS,EAAC,YAAY,YAAE,QAAQ,GAAQ,GACnC,GACR,IACA,CACV,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,UAAU,CAAC,EAClB,SAAS,EACT,QAAQ,EACR,KAAK,EACL,GAAG,KAAK,EAGgB;IACxB,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;IAC3C,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,KAAK,KAAK,CAAA;IAEtC,OAAO,CACL,MAAC,IAAI,iBACO,aAAa,mBACR,UAAU,IAAI,SAAS,EACtC,SAAS,EAAE,EAAE,CACX,yOAAyO,EACzO,UAAU,IAAI,kCAAkC,EAChD,SAAS,CACV,EACD,OAAO,EAAE,GAAG,EAAE;YACZ,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;YAC9B,GAAG,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAA;YAC1B,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC,KACG,KAAK,aAET,KAAC,IAAI,IAAC,SAAS,EAAC,+EAA+E,YAC5F,UAAU,CAAC,CAAC,CAAC,KAAC,KAAK,IAAC,SAAS,EAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,GAC5C,EACN,QAAQ,IACJ,CACR,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,EAAE,GAAG,KAAK,EAAa;IAC1C,OAAO,KAAC,IAAI,iBAAW,cAAc,KAAK,KAAK,GAAI,CAAA;AACrD,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,EACnB,SAAS,EACT,GAAG,KAAK,EACE;IACV,OAAO,CACL,KAAC,IAAI,iBACO,cAAc,EACxB,SAAS,EAAE,EAAE,CAAC,wCAAwC,EAAE,SAAS,CAAC,KAC9D,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IACzD,OAAO,CACL,KAAC,IAAI,iBACO,kBAAkB,EAC5B,SAAS,EAAE,EAAE,CAAC,0BAA0B,EAAE,SAAS,CAAC,KAChD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAC9D,OAAO,CACL,KAAC,IAAI,iBACO,yBAAyB,EACnC,SAAS,EAAE,EAAE,CAAC,sDAAsD,EAAE,SAAS,CAAC,KAC5E,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,sBAAsB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAChE,OAAO,CACL,KAAC,IAAI,iBACO,2BAA2B,EACrC,SAAS,EAAE,EAAE,CAAC,sDAAsD,EAAE,SAAS,CAAC,KAC5E,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EACL,MAAM,EACN,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,WAAW,GACZ,CAAA"}

package/dist/ui/separator.d.ts

@@ -1,5 +1,16 @@
 import { type ViewProps } from "@tarojs/components";
+/**
+ * @desc 分隔线组件。
+ * @param {Parameters<typeof Separator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Separator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Separator } from '@open-dy/vibecoding-sdk-taro/ui/separator'
+ * <Separator />
+ * ```
+ */
 declare function Separator({ className, orientation, ...props }: ViewProps & {
+    /** @desc 分隔线方向，默认 horizontal（h-px/w-full）；vertical 使用 w-px 并沿父容器拉伸高度。 */
     orientation?: "horizontal" | "vertical";
 }): import("react").JSX.Element;
 export { Separator };

package/dist/ui/separator.js

@@ -1,6 +1,16 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
+/**
+ * @desc 分隔线组件。
+ * @param {Parameters<typeof Separator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Separator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Separator } from '@open-dy/vibecoding-sdk-taro/ui/separator'
+ * <Separator />
+ * ```
+ */
 function Separator({ className, orientation = "horizontal", ...props }) {
     return (_jsx(View, { "data-slot": "separator", "data-orientation": orientation, className: cn("shrink-0 bg-border", orientation === "horizontal" && "h-px w-full", orientation === "vertical" && "w-px self-stretch", className), ...props }));
 }

package/dist/ui/separator.js.map

@@ -1 +1 @@
-{"version":3,"file":"separator.js","sourceRoot":"","sources":["../../src/ui/separator.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAEzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC,SAAS,SAAS,CAAC,EACjB,SAAS,EACT,WAAW,GAAG,YAAY,EAC1B,GAAG,KAAK,EACgD;IACxD,OAAO,CACL,KAAC,IAAI,iBACO,WAAW,sBACH,WAAW,EAC7B,SAAS,EAAE,EAAE,CACX,oBAAoB,EACpB,WAAW,KAAK,YAAY,IAAI,aAAa,EAC7C,WAAW,KAAK,UAAU,IAAI,mBAAmB,EACjD,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"separator.js","sourceRoot":"","sources":["../../src/ui/separator.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAEzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC;;;;;;;;;GASG;AACH,SAAS,SAAS,CAAC,EACjB,SAAS,EACT,WAAW,GAAG,YAAY,EAC1B,GAAG,KAAK,EAGiC;IACzC,OAAO,CACL,KAAC,IAAI,iBACO,WAAW,sBACH,WAAW,EAC7B,SAAS,EAAE,EAAE,CACX,oBAAoB,EACpB,WAAW,KAAK,YAAY,IAAI,aAAa,EAC7C,WAAW,KAAK,UAAU,IAAI,mBAAmB,EACjD,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/dist/ui/sheet.d.ts

@@ -1,26 +1,133 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
+/**
+ * @desc 侧边面板组件。
+ * @param {Parameters<typeof Sheet>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Sheet>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet />
+ * ```
+ */
 declare function Sheet({ 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 SheetTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetTrigger } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetTrigger /></Sheet>
+ * ```
+ */
 declare function SheetTrigger({ children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 侧边面板关闭按钮。
+ * @param {Parameters<typeof SheetClose>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetClose>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetClose } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetClose /></Sheet>
+ * ```
+ */
 declare function SheetClose({ children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 侧边面板跨层级渲染入口。
+ * @param {Parameters<typeof SheetPortal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetPortal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetPortal } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetPortal /></Sheet>
+ * ```
+ */
 declare function SheetPortal({ children }: {
+    /** @desc 要渲染的子节点；该兼容包装只返回 Fragment，不额外创建原生容器或执行挂载迁移。 */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * @desc 侧边面板遮罩。
+ * @param {Parameters<typeof SheetOverlay>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetOverlay>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetOverlay } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetOverlay /></Sheet>
+ * ```
+ */
 declare function SheetOverlay({ className, ...props }: ViewProps): React.JSX.Element;
 declare const sheetVariants: (props?: ({
     side?: "left" | "right" | "top" | "bottom" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 侧边面板内容容器。
+ * @param {Parameters<typeof SheetContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof SheetContent>[0]["side"]} props.side 面板所在边，默认 right；top/bottom 贴顶部/底部，left/right 为侧栏并设置侧向宽度。
+ * @return {ReturnType<typeof SheetContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetContent } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetContent /></Sheet>
+ * ```
+ */
 declare function SheetContent({ className, children, side, showCloseButton, ...props }: ViewProps & VariantProps<typeof sheetVariants> & {
+    /** @desc 是否显示内置关闭按钮，默认 true；为 false 时仍可通过遮罩或 SheetClose 关闭。 */
     showCloseButton?: boolean;
 }): React.JSX.Element | null;
+/**
+ * @desc 侧边面板头部布局。
+ * @param {Parameters<typeof SheetHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetHeader } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetHeader /></Sheet>
+ * ```
+ */
 declare function SheetHeader({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 侧边面板底部布局。
+ * @param {Parameters<typeof SheetFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetFooter } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetFooter /></Sheet>
+ * ```
+ */
 declare function SheetFooter({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 侧边面板标题。
+ * @param {Parameters<typeof SheetTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetTitle } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetTitle /></Sheet>
+ * ```
+ */
 declare function SheetTitle({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 侧边面板说明文本。
+ * @param {Parameters<typeof SheetDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetDescription } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetDescription /></Sheet>
+ * ```
+ */
 declare function SheetDescription({ className, ...props }: ViewProps): React.JSX.Element;
 export { Sheet, SheetPortal, SheetOverlay, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription, };

package/dist/ui/sheet.js

@@ -5,6 +5,16 @@ import { cva } from "class-variance-authority";
 import { cn } from "../lib/utils.js";
 import { X } from "@open-dy/lucide-taro";
 const SheetContext = React.createContext({ open: false, onOpenChange: () => { } });
+/**
+ * @desc 侧边面板组件。
+ * @param {Parameters<typeof Sheet>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Sheet>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet />
+ * ```
+ */
 function Sheet({ open: openProp, defaultOpen, onOpenChange, children, }) {
     const [internal, setInternal] = React.useState(defaultOpen ?? false);
     const controlled = openProp !== undefined;
@@ -18,17 +28,57 @@ function Sheet({ open: openProp, defaultOpen, onOpenChange, children, }) {
             },
         }, children: children }));
 }
+/**
+ * @desc 侧边面板触发器。
+ * @param {Parameters<typeof SheetTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetTrigger } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetTrigger /></Sheet>
+ * ```
+ */
 function SheetTrigger({ children, ...props }) {
     const { onOpenChange } = React.useContext(SheetContext);
     return (_jsx(View, { "data-slot": "sheet-trigger", onClick: () => onOpenChange(true), ...props, children: children }));
 }
+/**
+ * @desc 侧边面板关闭按钮。
+ * @param {Parameters<typeof SheetClose>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetClose>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetClose } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetClose /></Sheet>
+ * ```
+ */
 function SheetClose({ children, ...props }) {
     const { onOpenChange } = React.useContext(SheetContext);
     return (_jsx(View, { "data-slot": "sheet-close", onClick: () => onOpenChange(false), ...props, children: children }));
 }
+/**
+ * @desc 侧边面板跨层级渲染入口。
+ * @param {Parameters<typeof SheetPortal>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetPortal>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetPortal } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetPortal /></Sheet>
+ * ```
+ */
 function SheetPortal({ children }) {
     return _jsx(_Fragment, { children: children });
 }
+/**
+ * @desc 侧边面板遮罩。
+ * @param {Parameters<typeof SheetOverlay>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetOverlay>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetOverlay } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetOverlay /></Sheet>
+ * ```
+ */
 function SheetOverlay({ className, ...props }) {
     return (_jsx(View, { "data-slot": "sheet-overlay", className: cn("fixed inset-0 z-50 bg-black/50", className), ...props }));
 }
@@ -45,21 +95,72 @@ const sheetVariants = cva("fixed z-50 flex flex-col gap-4 bg-background shadow-l
         side: "right",
     },
 });
+/**
+ * @desc 侧边面板内容容器。
+ * @param {Parameters<typeof SheetContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof SheetContent>[0]["side"]} props.side 面板所在边，默认 right；top/bottom 贴顶部/底部，left/right 为侧栏并设置侧向宽度。
+ * @return {ReturnType<typeof SheetContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetContent } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetContent /></Sheet>
+ * ```
+ */
 function SheetContent({ className, children, side = "right", showCloseButton = true, ...props }) {
     const ctx = React.useContext(SheetContext);
     if (!ctx.open)
         return null;
     return (_jsxs(View, { className: "fixed inset-0 z-50", children: [_jsx(SheetOverlay, { onClick: () => ctx.onOpenChange(false) }), _jsxs(View, { "data-slot": "sheet-content", className: cn(sheetVariants({ side }), "p-4", className), ...props, children: [children, showCloseButton ? _jsx(View, { className: "absolute top-3 right-3 flex size-5 items-center justify-center rounded-sm opacity-70", onClick: () => ctx.onOpenChange(false), children: _jsx(X, { className: "size-4" }) }) : null] })] }));
 }
+/**
+ * @desc 侧边面板头部布局。
+ * @param {Parameters<typeof SheetHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetHeader } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetHeader /></Sheet>
+ * ```
+ */
 function SheetHeader({ className, ...props }) {
     return (_jsx(View, { "data-slot": "sheet-header", className: cn("flex flex-col gap-2", className), ...props }));
 }
+/**
+ * @desc 侧边面板底部布局。
+ * @param {Parameters<typeof SheetFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetFooter } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetFooter /></Sheet>
+ * ```
+ */
 function SheetFooter({ className, ...props }) {
     return (_jsx(View, { "data-slot": "sheet-footer", className: cn("mt-auto flex flex-col-reverse gap-2 sm:flex-row sm:justify-end", className), ...props }));
 }
+/**
+ * @desc 侧边面板标题。
+ * @param {Parameters<typeof SheetTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetTitle } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetTitle /></Sheet>
+ * ```
+ */
 function SheetTitle({ className, ...props }) {
     return (_jsx(View, { "data-slot": "sheet-title", className: cn("text-lg font-semibold text-foreground", className), ...props }));
 }
+/**
+ * @desc 侧边面板说明文本。
+ * @param {Parameters<typeof SheetDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof SheetDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Sheet, SheetDescription } from '@open-dy/vibecoding-sdk-taro/ui/sheet'
+ * <Sheet><SheetDescription /></Sheet>
+ * ```
+ */
 function SheetDescription({ className, ...props }) {
     return (_jsx(View, { "data-slot": "sheet-description", className: cn("text-sm text-muted-foreground", className), ...props }));
 }

package/dist/ui/sheet.js.map

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

package/dist/ui/skeleton.d.ts

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

package/dist/ui/skeleton.js

@@ -1,6 +1,16 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
+/**
+ * @desc 骨架屏组件。
+ * @param {Parameters<typeof Skeleton>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Skeleton>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Skeleton } from '@open-dy/vibecoding-sdk-taro/ui/skeleton'
+ * <Skeleton />
+ * ```
+ */
 function Skeleton({ className, ...props }) {
     return (_jsx(View, { "data-slot": "skeleton", className: cn("animate-pulse rounded-md bg-muted", className), ...props }));
 }

package/dist/ui/skeleton.js.map

@@ -1 +1 @@
-{"version":3,"file":"skeleton.js","sourceRoot":"","sources":["../../src/ui/skeleton.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAEzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC,SAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAClD,OAAO,CACL,KAAC,IAAI,iBACO,UAAU,EACpB,SAAS,EAAE,EAAE,CAAC,mCAAmC,EAAE,SAAS,CAAC,KACzD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"skeleton.js","sourceRoot":"","sources":["../../src/ui/skeleton.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAEzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC;;;;;;;;;GASG;AACH,SAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAa;IAClD,OAAO,CACL,KAAC,IAAI,iBACO,UAAU,EACpB,SAAS,EAAE,EAAE,CAAC,mCAAmC,EAAE,SAAS,CAAC,KACzD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/ui/slider.d.ts

@@ -1,12 +1,33 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
+/**
+ * @desc 滑块组件。
+ * @param {Parameters<typeof Slider>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Slider>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { useState } from 'react'
+ * import { Slider } from '@open-dy/vibecoding-sdk-taro/ui/slider'
+ * export function VolumeSlider() {
+ *   const [value, setValue] = useState([30])
+ *   return <Slider value={value} onValueChange={setValue} min={0} max={100} step={5} />
+ * }
+ * ```
+ */
 declare function Slider({ className, defaultValue, value: valueProp, min, max, step, onValueChange, disabled, ...props }: ViewProps & {
+    /** @desc 非受控初始数值数组，默认 [min]；当前只使用首元素，传入 value 后不生效。 */
     defaultValue?: number[];
+    /** @desc 受控数值数组；当前实现只使用首元素，只支持单滑块。传入后需同步 onValueChange，空数组按 min 展示。 */
     value?: number[];
+    /** @desc 下限，默认 0；须小于 max，外部受控值应在 min/max 范围内。 */
     min?: number;
+    /** @desc 上限，默认 100；须大于 min，用户拖动的结果会限制在 min/max 范围。 */
     max?: number;
+    /** @desc 步进值，默认 1，应大于 0；拖动结果按原始数值除以 step 四舍五入后取倍数，再限制到范围。 */
     step?: number;
+    /** @desc 触摸或 H5 鼠标拖动时连续调用，返回只有一个数值的数组；不是仅在拖动结束时调用，禁用时不触发。 */
     onValueChange?: (value: number[]) => void;
+    /** @desc 是否禁用拖动，默认 false；禁用时降低透明度且不更新内部数值或调用变化回调。 */
     disabled?: boolean;
 }): React.JSX.Element;
 export { Slider };

package/dist/ui/slider.js

@@ -4,6 +4,20 @@ import { View } from "@tarojs/components";
 import Taro from "@tarojs/taro";
 import { cn } from "../lib/utils.js";
 import { isH5 } from "../lib/platform.js";
+/**
+ * @desc 滑块组件。
+ * @param {Parameters<typeof Slider>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Slider>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { useState } from 'react'
+ * import { Slider } from '@open-dy/vibecoding-sdk-taro/ui/slider'
+ * export function VolumeSlider() {
+ *   const [value, setValue] = useState([30])
+ *   return <Slider value={value} onValueChange={setValue} min={0} max={100} step={5} />
+ * }
+ * ```
+ */
 function Slider({ className, defaultValue, value: valueProp, min = 0, max = 100, step = 1, onValueChange, disabled, ...props }) {
     const [internal, setInternal] = React.useState(valueProp ?? defaultValue ?? [min]);
     const controlled = valueProp !== undefined;