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

package/dist/ui/field.js

@@ -33,12 +33,42 @@ function hasCheckedControl(node) {
     visit(node);
     return found;
 }
+/**
+ * @desc 表单字段字段组容器。
+ * @param {Parameters<typeof FieldSet>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldSet>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet />
+ * ```
+ */
 function FieldSet({ className, ...props }) {
     return (_jsx(View, { "data-slot": "field-set", className: cn("flex flex-col gap-4", className), ...props }));
 }
+/**
+ * @desc 表单字段字段组标题。
+ * @param {Parameters<typeof FieldLegend>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldLegend>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldLegend /></FieldSet>
+ * ```
+ */
 function FieldLegend({ className, variant = "legend", ...props }) {
     return (_jsx(View, { "data-slot": "field-legend", "data-variant": variant, className: cn("mb-1.5 font-medium", variant === "label" ? "text-sm" : "text-base", className), ...props }));
 }
+/**
+ * @desc 表单字段分组容器。
+ * @param {Parameters<typeof FieldGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldGroup } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldGroup /></FieldSet>
+ * ```
+ */
 function FieldGroup({ className, ...props }) {
     return (_jsx(View, { "data-slot": "field-group", className: cn("group/field-group @container/field-group flex w-full flex-col gap-5", className), ...props }));
 }
@@ -54,6 +84,17 @@ const fieldVariants = cva("group/field flex w-full gap-2", {
         orientation: "vertical",
     },
 });
+/**
+ * @desc 表单字段组件。
+ * @param {Parameters<typeof Field>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Field>[0]["orientation"]} props.orientation 布局方向，默认 vertical；horizontal 横排，responsive 在 FieldGroup 容器较宽时切换为横排。不会改变输入控件本身的值或禁用状态。
+ * @return {ReturnType<typeof Field>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, Field } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><Field /></FieldSet>
+ * ```
+ */
 function Field({ className, orientation, children, ...props }) {
     const resolvedOrientation = orientation ?? "vertical";
     const hasContent = React.useMemo(() => React.Children.toArray(children).some((child) => React.isValidElement(child) && child.type === FieldContent), [children]);
@@ -70,9 +111,29 @@ function Field({ className, orientation, children, ...props }) {
                 resolvedOrientation === "responsive" &&
                 "@md/field-group:items-start @md/field-group:[&>[role=checkbox],[role=radio]]:mt-px", className), ...props, children: children }) }));
 }
+/**
+ * @desc 表单字段内容容器。
+ * @param {Parameters<typeof FieldContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldContent } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldContent /></FieldSet>
+ * ```
+ */
 function FieldContent({ className, ...props }) {
     return (_jsx(View, { "data-slot": "field-content", className: cn("group/field-content flex flex-1 flex-col gap-0.5 leading-snug", className), ...props }));
 }
+/**
+ * @desc 表单字段标签文本。
+ * @param {Parameters<typeof FieldLabel>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldLabel>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLabel } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldLabel /></FieldSet>
+ * ```
+ */
 function FieldLabel({ className, children, ...props }) {
     const { disabled } = React.useContext(FieldContext);
     const childArray = React.Children.toArray(children);
@@ -81,17 +142,57 @@ function FieldLabel({ className, children, ...props }) {
     return (_jsx(Label, { "data-slot": "field-label", className: cn("group/field-label peer/field-label flex w-fit gap-2 leading-snug", disabled && "opacity-50", hasCheckedChild &&
             "border-primary/30 bg-primary/5 dark:border-primary/20 dark:bg-primary/10", hasNestedField && "w-full flex-col rounded-lg border", hasNestedField && "*:p-2.5", className), ...props, children: children }));
 }
+/**
+ * @desc 表单字段标题。
+ * @param {Parameters<typeof FieldTitle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldTitle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldTitle } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldTitle /></FieldSet>
+ * ```
+ */
 function FieldTitle({ className, ...props }) {
     const { disabled, orientation } = React.useContext(FieldContext);
     return (_jsx(View, { "data-slot": "field-label", className: cn("flex w-fit items-center gap-2 text-sm font-medium", disabled && "opacity-50", orientation !== "vertical" && "flex-auto", className), ...props }));
 }
+/**
+ * @desc 表单字段说明文本。
+ * @param {Parameters<typeof FieldDescription>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldDescription>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldDescription } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldDescription /></FieldSet>
+ * ```
+ */
 function FieldDescription({ className, ...props }) {
     const { orientation } = React.useContext(FieldContext);
     return (_jsx(View, { "data-slot": "field-description", className: cn("text-left text-sm leading-normal font-normal text-muted-foreground", orientation === "horizontal" && "text-balance", "last:mt-0 nth-last-2:-mt-1", "[&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-primary", className), ...props }));
 }
+/**
+ * @desc 表单字段分隔线。
+ * @param {Parameters<typeof FieldSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldSeparator } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldSeparator /></FieldSet>
+ * ```
+ */
 function FieldSeparator({ children, className, ...props }) {
     return (_jsxs(View, { "data-slot": "field-separator", "data-content": !!children, className: cn("relative -my-2 h-5 text-sm", className), ...props, children: [_jsx(Separator, { className: "absolute inset-0 top-1/2" }), children ? _jsx(View, { className: "relative mx-auto block w-fit bg-background px-2 text-muted-foreground", "data-slot": "field-separator-content", children: children }) : null] }));
 }
+/**
+ * @desc 表单字段错误信息。
+ * @param {Parameters<typeof FieldError>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof FieldError>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldError } from '@open-dy/vibecoding-sdk-taro/ui/field'
+ * <FieldSet><FieldError /></FieldSet>
+ * ```
+ */
 function FieldError({ className, children, errors, ...props }) {
     const content = React.useMemo(() => {
         if (children) {

package/dist/ui/field.js.map

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

package/dist/ui/helpers.d.ts

@@ -1,4 +1,15 @@
 import * as React from "react";
+/**
+ * @desc 扫描 React 子节点的 data-icon 标记，返回行首和行尾图标是否存在。
+ * @param {Parameters<typeof collectDataIconState>[0]} children 要检查的 React 子节点。
+ * @return {ReturnType<typeof collectDataIconState>} 包含 hasInlineStartIcon 和 hasInlineEndIcon 的对象。
+ * @example
+ * ```tsx
+ * import { View } from '@tarojs/components'
+ * import { collectDataIconState } from '@open-dy/vibecoding-sdk-taro/ui/helpers'
+ * collectDataIconState(<View data-icon="inline-start" />)
+ * ```
+ */
 declare function collectDataIconState(children: React.ReactNode): {
     hasInlineStartIcon: boolean;
     hasInlineEndIcon: boolean;

package/dist/ui/helpers.js

@@ -1,4 +1,15 @@
 import * as React from "react";
+/**
+ * @desc 扫描 React 子节点的 data-icon 标记，返回行首和行尾图标是否存在。
+ * @param {Parameters<typeof collectDataIconState>[0]} children 要检查的 React 子节点。
+ * @return {ReturnType<typeof collectDataIconState>} 包含 hasInlineStartIcon 和 hasInlineEndIcon 的对象。
+ * @example
+ * ```tsx
+ * import { View } from '@tarojs/components'
+ * import { collectDataIconState } from '@open-dy/vibecoding-sdk-taro/ui/helpers'
+ * collectDataIconState(<View data-icon="inline-start" />)
+ * ```
+ */
 function collectDataIconState(children) {
     let hasInlineStartIcon = false;
     let hasInlineEndIcon = false;

package/dist/ui/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/ui/helpers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,SAAS,oBAAoB,CAAC,QAAyB;IACrD,IAAI,kBAAkB,GAAG,KAAK,CAAA;IAC9B,IAAI,gBAAgB,GAAG,KAAK,CAAA;IAE5B,MAAM,KAAK,GAAG,CAAC,IAAqB,EAAE,EAAE;QACtC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACrC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;gBAAE,OAAM;YAExC,MAAM,SAAS,GAAI,KAAK,CAAC,KAAyC,CAAC,WAAW,CAAC,CAAA;YAC/E,IAAI,SAAS,KAAK,cAAc;gBAAE,kBAAkB,GAAG,IAAI,CAAA;YAC3D,IAAI,SAAS,KAAK,YAAY;gBAAE,gBAAgB,GAAG,IAAI,CAAA;YAEvD,IAAI,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;gBAC1B,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAC7B,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,KAAK,CAAC,QAAQ,CAAC,CAAA;IAEf,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;AACjD,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/ui/helpers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B;;;;;;;;;;GAUG;AACH,SAAS,oBAAoB,CAAC,QAAyB;IACrD,IAAI,kBAAkB,GAAG,KAAK,CAAA;IAC9B,IAAI,gBAAgB,GAAG,KAAK,CAAA;IAE5B,MAAM,KAAK,GAAG,CAAC,IAAqB,EAAE,EAAE;QACtC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACrC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;gBAAE,OAAM;YAExC,MAAM,SAAS,GAAI,KAAK,CAAC,KAAyC,CAAC,WAAW,CAAC,CAAA;YAC/E,IAAI,SAAS,KAAK,cAAc;gBAAE,kBAAkB,GAAG,IAAI,CAAA;YAC3D,IAAI,SAAS,KAAK,YAAY;gBAAE,gBAAgB,GAAG,IAAI,CAAA;YAEvD,IAAI,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;gBAC1B,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAC7B,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,KAAK,CAAC,QAAQ,CAAC,CAAA;IAEf,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;AACjD,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/ui/input-group.d.ts

@@ -2,16 +2,81 @@ import * as React from "react";
 import { Input as TaroInput, Textarea as TaroTextarea, type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
 import { Button } from "./button.js";
+/**
+ * @desc 输入组合组件。
+ * @param {Parameters<typeof InputGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup />
+ * ```
+ */
 declare function InputGroup({ className, children, ...props }: ViewProps): React.JSX.Element;
 declare const inputGroupAddonVariants: (props?: ({
     align?: "inline-start" | "inline-end" | "block-start" | "block-end" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 输入组合附加内容。
+ * @param {Parameters<typeof InputGroupAddon>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof InputGroupAddon>[0]["align"]} props.align 附加区位置，默认 inline-start（行首），inline-end 行尾；block-start 顶部、block-end 底部，这两项让 InputGroup 使用纵向布局。
+ * @return {ReturnType<typeof InputGroupAddon>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupAddon } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupAddon /></InputGroup>
+ * ```
+ */
 declare function InputGroupAddon({ className, align, ...props }: ViewProps & VariantProps<typeof inputGroupAddonVariants>): React.JSX.Element;
 declare const inputGroupButtonVariants: (props?: ({
     size?: "xs" | "sm" | "icon-xs" | "icon-sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 输入组合操作按钮。
+ * @param {Parameters<typeof InputGroupButton>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof InputGroupButton>[0]["variant"]} props.variant 按钮外观，默认 ghost；其余变体同 Button.variant。
+ * @param {Parameters<typeof InputGroupButton>[0]["size"]} props.size 输入组按钮尺寸，默认 xs；xs 为 h-6，sm 不额外缩小底层默认按钮，icon-xs 为 size-6，icon-sm 为 size-8。
+ * @return {ReturnType<typeof InputGroupButton>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupButton } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupButton /></InputGroup>
+ * ```
+ */
 declare function InputGroupButton({ className, variant, size, ...props }: Omit<React.ComponentProps<typeof Button>, "size"> & VariantProps<typeof inputGroupButtonVariants>): React.JSX.Element;
+/**
+ * @desc 输入组合文本区域。
+ * @param {Parameters<typeof InputGroupText>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputGroupText>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupText } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupText /></InputGroup>
+ * ```
+ */
 declare function InputGroupText({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 输入组合输入区域。
+ * @param {Parameters<typeof InputGroupInput>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof InputGroupInput>[0]["className"]} props.className 附加到内部原生 Input 的类名；外层布局和横向内边距由 InputGroup 组合状态控制。
+ * @return {ReturnType<typeof InputGroupInput>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupInput } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupInput /></InputGroup>
+ * ```
+ */
 declare function InputGroupInput({ className, ...props }: React.ComponentPropsWithoutRef<typeof TaroInput>): React.JSX.Element;
+/**
+ * @desc 输入组合多行输入区域。
+ * @param {Parameters<typeof InputGroupTextarea>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof InputGroupTextarea>[0]["className"]} props.className 附加到原生 Textarea 的类名，用于覆写输入区尺寸和文字样式。
+ * @return {ReturnType<typeof InputGroupTextarea>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupTextarea } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupTextarea /></InputGroup>
+ * ```
+ */
 declare function InputGroupTextarea({ className, ...props }: React.ComponentPropsWithoutRef<typeof TaroTextarea>): React.JSX.Element;
 export { InputGroup, InputGroupAddon, InputGroupButton, InputGroupText, InputGroupInput, InputGroupTextarea, };

package/dist/ui/input-group.js

@@ -63,6 +63,16 @@ function collectInputGroupState(children) {
     visit(children);
     return state;
 }
+/**
+ * @desc 输入组合组件。
+ * @param {Parameters<typeof InputGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup />
+ * ```
+ */
 function InputGroup({ className, children, ...props }) {
     const groupState = React.useMemo(() => collectInputGroupState(children), [children]);
     const isVertical = groupState.hasBlockStartAddon ||
@@ -85,6 +95,17 @@ const inputGroupAddonVariants = cva("flex h-auto cursor-text items-center justif
         align: "inline-start",
     },
 });
+/**
+ * @desc 输入组合附加内容。
+ * @param {Parameters<typeof InputGroupAddon>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof InputGroupAddon>[0]["align"]} props.align 附加区位置，默认 inline-start（行首），inline-end 行尾；block-start 顶部、block-end 底部，这两项让 InputGroup 使用纵向布局。
+ * @return {ReturnType<typeof InputGroupAddon>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupAddon } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupAddon /></InputGroup>
+ * ```
+ */
 function InputGroupAddon({ className, align = "inline-start", ...props }) {
     const groupState = React.useContext(inputGroupContext);
     return (_jsx(View, { className: cn(inputGroupAddonVariants({ align }), groupState.disabled && "opacity-50", className), ...props }));
@@ -102,12 +123,45 @@ const inputGroupButtonVariants = cva("flex items-center gap-2 text-sm shadow-non
         size: "xs",
     },
 });
+/**
+ * @desc 输入组合操作按钮。
+ * @param {Parameters<typeof InputGroupButton>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof InputGroupButton>[0]["variant"]} props.variant 按钮外观，默认 ghost；其余变体同 Button.variant。
+ * @param {Parameters<typeof InputGroupButton>[0]["size"]} props.size 输入组按钮尺寸，默认 xs；xs 为 h-6，sm 不额外缩小底层默认按钮，icon-xs 为 size-6，icon-sm 为 size-8。
+ * @return {ReturnType<typeof InputGroupButton>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupButton } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupButton /></InputGroup>
+ * ```
+ */
 function InputGroupButton({ className, variant = "ghost", size = "xs", ...props }) {
     return (_jsx(Button, { variant: variant, className: cn(inputGroupButtonVariants({ size }), className), ...props }));
 }
+/**
+ * @desc 输入组合文本区域。
+ * @param {Parameters<typeof InputGroupText>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputGroupText>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupText } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupText /></InputGroup>
+ * ```
+ */
 function InputGroupText({ className, ...props }) {
     return (_jsx(View, { className: cn("flex items-center gap-2 text-sm text-muted-foreground [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4", className), ...props }));
 }
+/**
+ * @desc 输入组合输入区域。
+ * @param {Parameters<typeof InputGroupInput>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof InputGroupInput>[0]["className"]} props.className 附加到内部原生 Input 的类名；外层布局和横向内边距由 InputGroup 组合状态控制。
+ * @return {ReturnType<typeof InputGroupInput>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupInput } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupInput /></InputGroup>
+ * ```
+ */
 function InputGroupInput({ className, ...props }) {
     const groupState = React.useContext(inputGroupContext);
     const horizontalPadding = groupState.hasInlineStartAddon || groupState.hasInlineEndAddon
@@ -115,6 +169,17 @@ function InputGroupInput({ className, ...props }) {
         : "px-2.5";
     return (_jsx(View, { className: cn("flex min-w-0 flex-1 items-center py-2", groupState.isMultiline ? "w-full" : "h-full", horizontalPadding), children: _jsx(TaroInput, { className: cn("w-full flex-1 bg-transparent text-base text-foreground placeholder:text-muted-foreground outline-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm", className), ...props }) }));
 }
+/**
+ * @desc 输入组合多行输入区域。
+ * @param {Parameters<typeof InputGroupTextarea>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof InputGroupTextarea>[0]["className"]} props.className 附加到原生 Textarea 的类名，用于覆写输入区尺寸和文字样式。
+ * @return {ReturnType<typeof InputGroupTextarea>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputGroup, InputGroupTextarea } from '@open-dy/vibecoding-sdk-taro/ui/input-group'
+ * <InputGroup><InputGroupTextarea /></InputGroup>
+ * ```
+ */
 function InputGroupTextarea({ className, ...props }) {
     return (_jsx(TaroTextarea, { className: cn("min-h-16 w-full flex-1 resize-none border-0 bg-transparent px-2.5 py-2 text-sm text-foreground outline-none placeholder:text-muted-foreground disabled:cursor-not-allowed", className), ...props }));
 }

package/dist/ui/input-group.js.map

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

package/dist/ui/input-otp.d.ts

@@ -1,18 +1,66 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 type InputOTPProps = ViewProps & {
+    /** @desc 必填最大字符数，应为正整数；原生数字输入按此值截断，需自行渲染对应数量的 InputOTPSlot。 */
     maxLength: number;
+    /** @desc 受控验证码字符串；传入后以该值为准，需同步 onChange。受控值本身不自动截断，请保持长度不超过 maxLength。 */
     value?: string;
+    /** @desc 非受控初始验证码，默认空字符串；初始化时截断到 maxLength，传入 value 后不生效。 */
     defaultValue?: string;
+    /** @desc 原生输入改变时调用，收到截断到 maxLength 的字符串；不是 Taro 事件对象，受控模式需同步 value。 */
     onChange?: (value: string) => void;
+    /** @desc 是否禁用原生输入，默认可输入；同时降低容器透明度。 */
     disabled?: boolean;
+    /** @desc 是否请求原生输入聚焦；省略时不主动聚焦，实际行为由目标平台决定。 */
     autoFocus?: boolean;
 };
+/**
+ * @desc 验证码输入组件。
+ * @param {Parameters<typeof InputOTP>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputOTP>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputOTP } from '@open-dy/vibecoding-sdk-taro/ui/input-otp'
+ * <InputOTP maxLength={6} />
+ * ```
+ */
 declare function InputOTP({ className, maxLength, value: valueProp, defaultValue, onChange, disabled, autoFocus, children, ...props }: InputOTPProps): React.JSX.Element;
+/**
+ * @desc 验证码输入分组容器。
+ * @param {Parameters<typeof InputOTPGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputOTPGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputOTP, InputOTPGroup } from '@open-dy/vibecoding-sdk-taro/ui/input-otp'
+ * <InputOTP maxLength={6}><InputOTPGroup><InputOTPGroup /></InputOTPGroup></InputOTP>
+ * ```
+ */
 declare function InputOTPGroup({ className, ...props }: ViewProps): React.JSX.Element;
+/**
+ * @desc 验证码输入单字符槽位。
+ * @param {Parameters<typeof InputOTPSlot>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputOTPSlot>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputOTP, InputOTPGroup, InputOTPSlot } from '@open-dy/vibecoding-sdk-taro/ui/input-otp'
+ * <InputOTP maxLength={6}><InputOTPGroup><InputOTPSlot index={0} /></InputOTPGroup></InputOTP>
+ * ```
+ */
 declare function InputOTPSlot({ index, className, "aria-invalid": ariaInvalid, ...props }: ViewProps & {
+    /** @desc 必填字符位置，从 0 开始；应小于父 InputOTP.maxLength，显示对应字符，聚焦且位于末尾时显示输入光标。 */
     index: number;
+    /** @desc 是否显示此单元格的校验失败样式；true 或 "true" 表示失败，不执行验证码校验。 */
     "aria-invalid"?: boolean | "true" | "false";
 }): React.JSX.Element;
+/**
+ * @desc 验证码输入分隔线。
+ * @param {Parameters<typeof InputOTPSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputOTPSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputOTP, InputOTPGroup, InputOTPSeparator } from '@open-dy/vibecoding-sdk-taro/ui/input-otp'
+ * <InputOTP maxLength={6}><InputOTPGroup><InputOTPSeparator /></InputOTPGroup></InputOTP>
+ * ```
+ */
 declare function InputOTPSeparator({ ...props }: ViewProps): React.JSX.Element;
 export { InputOTP, InputOTPGroup, InputOTPSlot, InputOTPSeparator };

package/dist/ui/input-otp.js

@@ -3,6 +3,16 @@ import * as React from "react";
 import { View, Input as TaroInput } from "@tarojs/components";
 import { cn } from "../lib/utils.js";
 import { Minus } from "@open-dy/lucide-taro";
+/**
+ * @desc 验证码输入组件。
+ * @param {Parameters<typeof InputOTP>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputOTP>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputOTP } from '@open-dy/vibecoding-sdk-taro/ui/input-otp'
+ * <InputOTP maxLength={6} />
+ * ```
+ */
 function InputOTP({ className, maxLength, value: valueProp, defaultValue, onChange, disabled, autoFocus, children, ...props }) {
     const [internal, setInternal] = React.useState(() => (defaultValue ?? "").slice(0, maxLength));
     const [isFocused, setIsFocused] = React.useState(false);
@@ -32,15 +42,45 @@ function InputOTP({ className, maxLength, value: valueProp, defaultValue, onChan
                 }, type: "number", maxlength: maxLength, value: value, onInput: handleInput, onFocus: () => setIsFocused(true), onBlur: () => setIsFocused(false), disabled: disabled, focus: autoFocus }), _jsx(InputOTPContext.Provider, { value: { value, maxLength, isFocused }, children: children })] }));
 }
 const InputOTPContext = React.createContext({ value: "", maxLength: 6, isFocused: false });
+/**
+ * @desc 验证码输入分组容器。
+ * @param {Parameters<typeof InputOTPGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputOTPGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputOTP, InputOTPGroup } from '@open-dy/vibecoding-sdk-taro/ui/input-otp'
+ * <InputOTP maxLength={6}><InputOTPGroup><InputOTPGroup /></InputOTPGroup></InputOTP>
+ * ```
+ */
 function InputOTPGroup({ className, ...props }) {
     return (_jsx(View, { "data-slot": "input-otp-group", className: cn("flex items-center rounded-lg", className), ...props }));
 }
+/**
+ * @desc 验证码输入单字符槽位。
+ * @param {Parameters<typeof InputOTPSlot>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputOTPSlot>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputOTP, InputOTPGroup, InputOTPSlot } from '@open-dy/vibecoding-sdk-taro/ui/input-otp'
+ * <InputOTP maxLength={6}><InputOTPGroup><InputOTPSlot index={0} /></InputOTPGroup></InputOTP>
+ * ```
+ */
 function InputOTPSlot({ index, className, "aria-invalid": ariaInvalid, ...props }) {
     const { value, isFocused } = React.useContext(InputOTPContext);
     const char = value[index] ?? "";
     const isActive = isFocused && value.length === index;
     return (_jsxs(View, { "data-slot": "input-otp-slot", "data-active": isActive || undefined, "aria-invalid": ariaInvalid, className: cn("relative flex size-8 items-center justify-center border-y border-r border-input text-sm transition-all first:rounded-l-lg first:border-l last:rounded-r-lg 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", isActive && "z-10 border-ring ring-3 ring-ring/50", className), ...props, children: [char, isActive ? _jsx(View, { className: "pointer-events-none absolute inset-0 flex items-center justify-center", children: _jsx(View, { className: "h-4 w-px animate-pulse bg-foreground" }) }) : null] }));
 }
+/**
+ * @desc 验证码输入分隔线。
+ * @param {Parameters<typeof InputOTPSeparator>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof InputOTPSeparator>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { InputOTP, InputOTPGroup, InputOTPSeparator } from '@open-dy/vibecoding-sdk-taro/ui/input-otp'
+ * <InputOTP maxLength={6}><InputOTPGroup><InputOTPSeparator /></InputOTPGroup></InputOTP>
+ * ```
+ */
 function InputOTPSeparator({ ...props }) {
     return (_jsx(View, { "data-slot": "input-otp-separator", className: "flex items-center [&_svg:not([class*='size-'])]:size-4", ...props, children: _jsx(Minus, {}) }));
 }

package/dist/ui/input-otp.js.map

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

package/dist/ui/input.d.ts

@@ -1,5 +1,27 @@
 import { Input as TaroInput } from "@tarojs/components";
-declare function Input({ className, type, disabled, "aria-invalid": ariaInvalid, style, ...props }: React.ComponentPropsWithoutRef<typeof TaroInput> & {
+type InputProps = React.ComponentPropsWithoutRef<typeof TaroInput> & {
+    /** @desc 校验失败的视觉状态；true 或 "true" 设置错误边框和光圈，默认无错误样式，不执行值校验。 */
     "aria-invalid"?: boolean | "true" | "false";
-}): import("react").JSX.Element;
+};
+/**
+ * @desc 带视觉容器的 Taro 输入框；用于普通小程序和兴趣卡落地页。
+ * @param {InputProps} props 输入属性；value、onInput 等传给原生输入框，className 和 style 作用于外层 View。
+ * @param {Parameters<typeof Input>[0]["className"]} props.className 外层 View 容器的附加类名，控制边框、尺寸和布局；不会传给内部原生 Input。
+ * @param {Parameters<typeof Input>[0]["style"]} props.style 外层 View 的内联样式；内部 Input 使用固定的透明背景和零内边距样式。
+ * @param {Parameters<typeof Input>[0]["value"]} props.value 原生输入值；在 onInput 中更新可构成受控输入，事件值位于 event.detail.value。省略时沿用 Taro Input 行为。
+ * @param {Parameters<typeof Input>[0]["onInput"]} props.onInput 原生 Input 输入事件，值位于 event.detail.value；与 InputOTP.onChange 接收字符串的协议不同。
+ * @param {Parameters<typeof Input>[0]["disabled"]} props.disabled 是否禁用原生 Input，默认 false；同时对外层添加透明度和 pointer-events-none。
+ * @param {Parameters<typeof Input>[0]["type"]} props.type 输入类型，直接传给原生 Taro Input；此组件不做转换，省略时由平台默认行为决定。
+ * @return {React.JSX.Element} 一个带边框、背景、圆角、横向内边距和原生输入框的 View。
+ * @remarks 默认容器使用 h-11、w-full、rounded-lg、border、bg-background、px-3。通过 className 覆写容器，不要在外层再加相同边框、背景或内边距；横向布局的外层 View 只负责 flex 和间距。className 不会直接改变内部原生输入框的 text-sm。
+ * @example
+ * ```tsx
+ * import { Input } from '@open-dy/vibecoding-sdk-taro/ui/input'
+ * import { View } from '@tarojs/components'
+ * export function TaskInput() {
+ *   return <View className="flex gap-3"><Input placeholder="添加任务" className="flex-1 rounded-none border-4 border-black bg-white" /></View>
+ * }
+ * ```
+ */
+declare function Input({ className, type, disabled, "aria-invalid": ariaInvalid, style, ...props }: InputProps): import("react").JSX.Element;
 export { Input };