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

package/dist/ui/checkbox.d.ts

@@ -1,9 +1,23 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
+/**
+ * @desc 复选框组件。
+ * @param {Parameters<typeof Checkbox>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Checkbox>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Checkbox } from '@open-dy/vibecoding-sdk-taro/ui/checkbox'
+ * <Checkbox />
+ * ```
+ */
 declare function Checkbox({ className, checked: checkedProp, defaultChecked, onCheckedChange, disabled, ...props }: ViewProps & {
+    /** @desc 受控选中状态；传入后以该值为准，需在 onCheckedChange 中更新。省略时由内部状态管理。 */
     checked?: boolean;
+    /** @desc 非受控模式的初始选中状态，默认 false；仅初始化时读取，传入 checked 后不生效。 */
     defaultChecked?: boolean;
+    /** @desc 用户点击切换时调用，参数为下一选中状态；禁用时不触发，受控模式需同步 checked。 */
     onCheckedChange?: (checked: boolean) => void;
+    /** @desc 是否禁止用户切换；省略或 false 时可操作，true 时不触发内部切换回调。 */
     disabled?: boolean;
 }): React.JSX.Element;
 export { Checkbox };

package/dist/ui/checkbox.js

@@ -3,6 +3,16 @@ import * as React from "react";
 import { View } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
 import { Check } from "@open-dy/lucide-taro";
+/**
+ * @desc 复选框组件。
+ * @param {Parameters<typeof Checkbox>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Checkbox>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Checkbox } from '@open-dy/vibecoding-sdk-taro/ui/checkbox'
+ * <Checkbox />
+ * ```
+ */
 function Checkbox({ className, checked: checkedProp, defaultChecked, onCheckedChange, disabled, ...props }) {
     const [internalChecked, setInternalChecked] = React.useState(defaultChecked ?? false);
     const isControlled = checkedProp !== undefined;

package/dist/ui/checkbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkbox.js","sourceRoot":"","sources":["../../src/ui/checkbox.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,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAE5C,SAAS,QAAQ,CAAC,EAChB,SAAS,EACT,OAAO,EAAE,WAAW,EACpB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,GAAG,KAAK,EAMT;IACC,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC,CAAA;IACrF,MAAM,YAAY,GAAG,WAAW,KAAK,SAAS,CAAA;IAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAA;IAE5D,OAAO,CACL,KAAC,IAAI,iBACO,UAAU,kBACN,OAAO,IAAI,SAAS,kBACpB,OAAO,mBACN,QAAQ,IAAI,SAAS,EACpC,SAAS,EAAE,EAAE,CACX,6iBAA6iB,EAC7iB,OAAO,IAAI,mEAAmE,EAC9E,SAAS,CACV,EACD,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,QAAQ;gBAAE,OAAM;YACpB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAA;YACrB,IAAI,CAAC,YAAY;gBAAE,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAC3C,eAAe,EAAE,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC,KACG,KAAK,YAER,OAAO,CAAC,CAAC,CAAC,KAAC,KAAK,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,GACtF,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"checkbox.js","sourceRoot":"","sources":["../../src/ui/checkbox.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,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAE5C;;;;;;;;;GASG;AACH,SAAS,QAAQ,CAAC,EAChB,SAAS,EACT,OAAO,EAAE,WAAW,EACpB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,GAAG,KAAK,EAUT;IACC,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC,CAAA;IACrF,MAAM,YAAY,GAAG,WAAW,KAAK,SAAS,CAAA;IAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAA;IAE5D,OAAO,CACL,KAAC,IAAI,iBACO,UAAU,kBACN,OAAO,IAAI,SAAS,kBACpB,OAAO,mBACN,QAAQ,IAAI,SAAS,EACpC,SAAS,EAAE,EAAE,CACX,6iBAA6iB,EAC7iB,OAAO,IAAI,mEAAmE,EAC9E,SAAS,CACV,EACD,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,QAAQ;gBAAE,OAAM;YACpB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAA;YACrB,IAAI,CAAC,YAAY;gBAAE,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAC3C,eAAe,EAAE,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC,KACG,KAAK,YAER,OAAO,CAAC,CAAC,CAAC,KAAC,KAAK,IAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,GACtF,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/ui/collapsible.d.ts

@@ -1,18 +1,55 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 type CollapsibleTriggerRenderProps = Omit<ViewProps, "children"> & {
+    /** @desc 组件自动注入的触发器标识；自定义 render 应转发到触发节点，不手动修改。 */
     "data-slot": "collapsible-trigger";
+    /** @desc 组件自动注入的展开状态：open 或 closed；自定义 render 应转发以供状态样式使用。 */
     "data-state": "open" | "closed";
 };
 type CollapsibleTriggerProps = Omit<ViewProps, "children"> & {
+    /** @desc 默认触发器内的内容；设置 render 时由自定义渲染结果取代。 */
     children?: React.ReactNode;
+    /** @desc 自定义触发器元素或渲染函数；省略时使用 View。元素会被克隆并合并点击处理；函数收到状态和事件 props，必须传给实际可点击节点。 */
     render?: React.ReactElement | ((props: CollapsibleTriggerRenderProps) => React.ReactNode);
 };
+/**
+ * @desc 可折叠区域组件。
+ * @param {Parameters<typeof Collapsible>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Collapsible>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Collapsible } from '@open-dy/vibecoding-sdk-taro/ui/collapsible'
+ * <Collapsible />
+ * ```
+ */
 declare function Collapsible({ open: openProp, defaultOpen, onOpenChange, children, ...props }: ViewProps & {
+    /** @desc 受控展开状态；传入后以该值为准，需在 onOpenChange 中更新。省略时由组件内部管理。 */
     open?: boolean;
+    /** @desc 非受控模式的初始展开状态，默认 false；仅初始化时读取，传入 open 后不生效。 */
     defaultOpen?: boolean;
+    /** @desc 触发器或关闭操作请求改变展开状态时调用，参数为下一状态；受控模式需由调用方同步 open。 */
     onOpenChange?: (open: boolean) => void;
 }): React.JSX.Element;
+/**
+ * @desc 可折叠区域触发器。
+ * @param {Parameters<typeof CollapsibleTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CollapsibleTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Collapsible, CollapsibleTrigger } from '@open-dy/vibecoding-sdk-taro/ui/collapsible'
+ * <Collapsible><CollapsibleTrigger /></Collapsible>
+ * ```
+ */
 declare function CollapsibleTrigger({ children, render, onClick, ...props }: CollapsibleTriggerProps): React.JSX.Element;
+/**
+ * @desc 可折叠区域内容容器。
+ * @param {Parameters<typeof CollapsibleContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CollapsibleContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Collapsible, CollapsibleContent } from '@open-dy/vibecoding-sdk-taro/ui/collapsible'
+ * <Collapsible><CollapsibleContent /></Collapsible>
+ * ```
+ */
 declare function CollapsibleContent({ children, ...props }: ViewProps): React.JSX.Element | null;
 export { Collapsible, CollapsibleTrigger, CollapsibleContent };

package/dist/ui/collapsible.js

@@ -2,6 +2,16 @@ import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import * as React from "react";
 import { View } from "@tarojs/components";
 const CollapsibleContext = React.createContext({ open: false, toggle: () => { } });
+/**
+ * @desc 可折叠区域组件。
+ * @param {Parameters<typeof Collapsible>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Collapsible>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Collapsible } from '@open-dy/vibecoding-sdk-taro/ui/collapsible'
+ * <Collapsible />
+ * ```
+ */
 function Collapsible({ open: openProp, defaultOpen, onOpenChange, children, ...props }) {
     const [internal, setInternal] = React.useState(defaultOpen ?? false);
     const controlled = openProp !== undefined;
@@ -14,6 +24,16 @@ function Collapsible({ open: openProp, defaultOpen, onOpenChange, children, ...p
     }, [open, controlled, onOpenChange]);
     return (_jsx(CollapsibleContext.Provider, { value: { open, toggle }, children: _jsx(View, { "data-slot": "collapsible", "data-state": open ? "open" : "closed", ...props, children: children }) }));
 }
+/**
+ * @desc 可折叠区域触发器。
+ * @param {Parameters<typeof CollapsibleTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CollapsibleTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Collapsible, CollapsibleTrigger } from '@open-dy/vibecoding-sdk-taro/ui/collapsible'
+ * <Collapsible><CollapsibleTrigger /></Collapsible>
+ * ```
+ */
 function CollapsibleTrigger({ children, render, onClick, ...props }) {
     const { open, toggle } = React.useContext(CollapsibleContext);
     const handleClick = (event) => {
@@ -43,6 +63,16 @@ function CollapsibleTrigger({ children, render, onClick, ...props }) {
     }
     return (_jsx(View, { ...triggerProps, children: children }));
 }
+/**
+ * @desc 可折叠区域内容容器。
+ * @param {Parameters<typeof CollapsibleContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof CollapsibleContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Collapsible, CollapsibleContent } from '@open-dy/vibecoding-sdk-taro/ui/collapsible'
+ * <Collapsible><CollapsibleContent /></Collapsible>
+ * ```
+ */
 function CollapsibleContent({ children, ...props }) {
     const { open } = React.useContext(CollapsibleContext);
     if (!open)

package/dist/ui/collapsible.js.map

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

package/dist/ui/combobox.d.ts

@@ -3,53 +3,243 @@ import { type ViewProps } from "@tarojs/components";
 type ComboboxOption = string;
 type ComboboxAnchorRef = React.RefObject<unknown> | React.MutableRefObject<unknown>;
 type ComboboxValueInput = string | string[];
+/**
+ * @desc 可搜索选择框组件。
+ * @param {Parameters<typeof Combobox>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Combobox>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { useState } from 'react'
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * export function CityPicker() {
+ *   const [value, setValue] = useState<string[]>([])
+ *   return <Combobox items={['北京', '上海']} value={value} onValueChange={setValue}>
+ *     <ComboboxInput placeholder="搜索城市" showClear />
+ *     <ComboboxContent><ComboboxList>{(item) => <ComboboxItem value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent>
+ *   </Combobox>
+ * }
+ * ```
+ */
 declare function Combobox({ open: openProp, defaultOpen, onOpenChange, value: valueProp, defaultValue, onValueChange, multiple, autoHighlight, items, children, ...props }: ViewProps & {
+    /** @desc 受控展开状态；传入后以该值为准，需在 onOpenChange 中更新。省略时由组件内部管理。 */
     open?: boolean;
+    /** @desc 非受控模式的初始展开状态，默认 false；仅初始化时读取，传入 open 后不生效。 */
     defaultOpen?: boolean;
+    /** @desc 触发器或关闭操作请求改变展开状态时调用，参数为下一状态；受控模式需由调用方同步 open。 */
     onOpenChange?: (open: boolean) => void;
+    /** @desc 受控选中值；接受字符串或字符串数组，内部统一为数组。省略时使用内部状态，传入后需同步 onValueChange。 */
     value?: ComboboxValueInput;
+    /** @desc 非受控模式的初始选中值，默认空数组；字符串会转为单元素数组，传入 value 后不生效。 */
     defaultValue?: ComboboxValueInput;
+    /** @desc 选中、取消或清空时调用，始终返回字符串数组；单选也返回数组，清空返回 []。 */
     onValueChange?: (value: string[]) => void;
+    /** @desc 是否允许多选，默认 false；单选选择后清空搜索并关闭列表，多选切换各项且保留列表。 */
     multiple?: boolean;
+    /** @desc 兼容属性；当前实现不执行自动高亮，传入 true 也不会选中首项。 */
     autoHighlight?: boolean;
+    /** @desc 可选的字符串候选列表，用于按搜索词进行不区分大小写的包含过滤；由 ComboboxList 的渲染函数生成过滤后的项目，不会自动生成 UI。 */
     items?: readonly ComboboxOption[];
 }): React.JSX.Element;
 type ComboboxValueProps = Omit<ViewProps, "children"> & {
+    /** @desc 选中值的自定义节点或渲染函数；函数收到 string[]，省略时将选中值用逗号连接显示。 */
     children?: React.ReactNode | ((values: string[]) => React.ReactNode);
 };
+/**
+ * @desc 可搜索选择框当前值展示。
+ * @param {Parameters<typeof ComboboxValue>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxValue>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxValue } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxValue /></Combobox>
+ * ```
+ */
 declare function ComboboxValue({ className, children, ...props }: ComboboxValueProps): React.JSX.Element;
+/**
+ * @desc 可搜索选择框触发器。
+ * @param {Parameters<typeof ComboboxTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxTrigger } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxTrigger /></Combobox>
+ * ```
+ */
 declare function ComboboxTrigger({ className, children, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 可搜索选择框输入区域。
+ * @param {Parameters<typeof ComboboxInput>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxInput>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxInput /></Combobox>
+ * ```
+ */
 declare function ComboboxInput({ className, children, disabled, showTrigger, showClear, placeholder, "aria-invalid": ariaInvalid, ...props }: Omit<ViewProps, "children"> & {
+    /** @desc 输入框末尾的附加内容；省略时仅显示输入区及配置的触发/清空按钮。 */
     children?: React.ReactNode;
+    /** @desc 是否禁用搜索输入及内部按钮交互，默认 false。 */
     disabled?: boolean;
+    /** @desc 是否显示展开按钮，默认 true；有可清空值且 showClear 为 true 时优先显示清空按钮。 */
     showTrigger?: boolean;
+    /** @desc 是否在有搜索词或选中值时显示清空按钮，默认 false；点击同时清空搜索词和选中值。 */
     showClear?: boolean;
+    /** @desc 空输入时的提示文本；省略时不设置原生输入提示。 */
     placeholder?: string;
+    /** @desc 是否显示校验失败样式；true 或 "true" 表示失败，不负责执行校验。 */
     "aria-invalid"?: boolean | "true" | "false";
 }): React.JSX.Element;
+/**
+ * @desc 可搜索选择框内容容器。
+ * @param {Parameters<typeof ComboboxContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxContent } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxContent /></Combobox>
+ * ```
+ */
 declare function ComboboxContent({ className, children, anchor, ...props }: ViewProps & {
+    /** @desc 兼容的锚点引用；当前实现未使用它测量定位，内容在原位置相对布局，不会自动跟随该 ref。 */
     anchor?: ComboboxAnchorRef;
 }): React.JSX.Element | null;
 type ComboboxListProps = Omit<ViewProps, "children"> & {
+    /** @desc 静态列表节点或逐项渲染函数；函数收到过滤后的候选字符串，需要根 Combobox 提供 items，未提供时不生成列表项。 */
     children?: React.ReactNode | ((item: ComboboxOption) => React.ReactNode);
 };
+/**
+ * @desc 可搜索选择框列表容器。
+ * @param {Parameters<typeof ComboboxList>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxList>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxList } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxList /></Combobox>
+ * ```
+ */
 declare function ComboboxList({ className, children, ...props }: ComboboxListProps): React.JSX.Element;
+/**
+ * @desc 可搜索选择框条目。
+ * @param {Parameters<typeof ComboboxItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxItem } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxItem value="one" /></Combobox>
+ * ```
+ */
 declare function ComboboxItem({ className, children, value: itemValue, ...props }: ViewProps & {
+    /** @desc 该候选项的字符串值；用于比较和更新选择，需与 items 或业务候选值一致。 */
     value: string;
 }): React.JSX.Element;
+/**
+ * @desc 可搜索选择框分组容器。
+ * @param {Parameters<typeof ComboboxGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxGroup } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxGroup /></Combobox>
+ * ```
+ */
 declare function ComboboxGroup({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 可搜索选择框标签文本。
+ * @param {Parameters<typeof ComboboxLabel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxLabel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxLabel } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxLabel /></Combobox>
+ * ```
+ */
 declare function ComboboxLabel({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 选择项集合的布局容器；直接渲染传入的子节点，不执行列表迭代。
+ * @param {Parameters<typeof ComboboxCollection>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxCollection>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxCollection } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxCollection /></Combobox>
+ * ```
+ */
 declare function ComboboxCollection({ ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 可搜索选择框无结果内容。
+ * @param {Parameters<typeof ComboboxEmpty>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxEmpty>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxEmpty } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxEmpty /></Combobox>
+ * ```
+ */
 declare function ComboboxEmpty({ className, ...props }: ViewProps): React.JSX.Element | null;
+/**
+ * @desc 可搜索选择框分隔线。
+ * @param {Parameters<typeof ComboboxSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxSeparator } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxSeparator /></Combobox>
+ * ```
+ */
 declare function ComboboxSeparator({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 可搜索选择框已选标签容器。
+ * @param {React.ComponentProps<typeof ComboboxChips>} props 容器属性与锚点 ref。
+ * @return {React.ReactNode} 已选标签的布局容器。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxChips } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxChips /></Combobox>
+ * ```
+ */
 declare const ComboboxChips: React.ForwardRefExoticComponent<Omit<ViewProps, "ref"> & React.RefAttributes<unknown>>;
+/**
+ * @desc 可搜索选择框已选标签。
+ * @param {Parameters<typeof ComboboxChip>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxChip>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxChip } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxChip /></Combobox>
+ * ```
+ */
 declare function ComboboxChip({ className, children, value: chipValue, showRemove, ...props }: ViewProps & {
+    /** @desc 点击移除时匹配的选中值；省略时从字符串/数字 children 推导，无法推导时移除按钮不会改变选择。 */
     value?: string;
+    /** @desc 是否显示移除按钮，默认 true；点击只移除当前值并阻止冒泡，不关闭列表。 */
     showRemove?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 可搜索选择框标签输入框。
+ * @param {Parameters<typeof ComboboxChipsInput>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof ComboboxChipsInput>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxChipsInput } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * <Combobox><ComboboxChipsInput /></Combobox>
+ * ```
+ */
 declare function ComboboxChipsInput({ className, placeholder, disabled, ...props }: ViewProps & {
+    /** @desc 空搜索词时的输入提示；省略时不设置提示文本。 */
     placeholder?: string;
+    /** @desc 是否禁用原生搜索输入；默认可输入，禁用状态由 Taro Input 处理。 */
     disabled?: boolean;
 }): React.JSX.Element;
+/**
+ * @desc 创建组合选择框的锚点 ref，用于关联定位容器。
+ * @param 无参数
+ * @return {ReturnType<typeof useComboboxAnchor>} 当前上下文或锚点引用。
+ * @example
+ * ```tsx
+ * import { useComboboxAnchor, ComboboxChips } from '@open-dy/vibecoding-sdk-taro/ui/combobox'
+ * function Anchor() { const ref = useComboboxAnchor(); return <ComboboxChips ref={ref} /> }
+ * ```
+ */
 declare function useComboboxAnchor(): React.MutableRefObject<unknown>;
 export { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxGroup, ComboboxLabel, ComboboxCollection, ComboboxEmpty, ComboboxSeparator, ComboboxChips, ComboboxChip, ComboboxChipsInput, ComboboxTrigger, ComboboxValue, useComboboxAnchor, };