@s-hirano-ist/s-ui 1.2.0 → 1.3.0

package/dist/display/loading.d.ts

@@ -1,3 +1,17 @@
+/**
+ * A centered loading spinner component.
+ *
+ * @remarks
+ * Displays an animated spinner using Lucide's Loader icon.
+ * Used for loading states throughout the application.
+ *
+ * @returns A centered loading indicator
+ *
+ * @example
+ * ```tsx
+ * {isLoading ? <Loading /> : <Content />}
+ * ```
+ */
 declare function Loading(): import("react/jsx-runtime").JSX.Element;
 export default Loading;
 //# sourceMappingURL=loading.d.ts.map

package/dist/display/loading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../../display/loading.tsx"],"names":[],"mappings":"AAEA,iBAAS,OAAO,4CAMf;AAED,eAAe,OAAO,CAAC"}
+{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../../display/loading.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,iBAAS,OAAO,4CAMf;AAED,eAAe,OAAO,CAAC"}

package/dist/display/loading.js

@@ -1,5 +1,19 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Loader } from "lucide-react";
+/**
+ * A centered loading spinner component.
+ *
+ * @remarks
+ * Displays an animated spinner using Lucide's Loader icon.
+ * Used for loading states throughout the application.
+ *
+ * @returns A centered loading indicator
+ *
+ * @example
+ * ```tsx
+ * {isLoading ? <Loading /> : <Content />}
+ * ```
+ */
 function Loading() {
     return (_jsx("div", { className: "flex h-full items-center justify-center p-16", children: _jsx(Loader, { className: "animate-spin", size: 48 }) }));
 }

package/dist/display/loading.js.map

@@ -1 +1 @@
-{"version":3,"file":"loading.js","sourceRoot":"","sources":["../../display/loading.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,SAAS,OAAO;IACf,OAAO,CACN,cAAK,SAAS,EAAC,8CAA8C,YAC5D,KAAC,MAAM,IAAC,SAAS,EAAC,cAAc,EAAC,IAAI,EAAE,EAAE,GAAI,GACxC,CACN,CAAC;AACH,CAAC;AAED,eAAe,OAAO,CAAC"}
+{"version":3,"file":"loading.js","sourceRoot":"","sources":["../../display/loading.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,SAAS,OAAO;IACf,OAAO,CACN,cAAK,SAAS,EAAC,8CAA8C,YAC5D,KAAC,MAAM,IAAC,SAAS,EAAC,cAAc,EAAC,IAAI,EAAE,EAAE,GAAI,GACxC,CACN,CAAC;AACH,CAAC;AAED,eAAe,OAAO,CAAC"}

package/dist/display/status/status-code-view.d.ts

@@ -1,7 +1,34 @@
-type StatusCode = "000" | "204" | "403" | "404" | "500";
+/**
+ * HTTP status codes supported by StatusCodeView.
+ *
+ * @remarks
+ * - `000` - Custom status (e.g., no results)
+ * - `204` - No Content
+ * - `403` - Forbidden
+ * - `404` - Not Found
+ * - `500` - Internal Server Error
+ */
+export type StatusCode = "000" | "204" | "403" | "404" | "500";
+/**
+ * A stylized display for HTTP status codes.
+ *
+ * @remarks
+ * Shows the status code prominently with a gradient effect
+ * and an accompanying description text.
+ *
+ * @param props - Status code and description string
+ * @returns A styled status code display
+ *
+ * @example
+ * ```tsx
+ * <StatusCodeView
+ *   statusCode="404"
+ *   statusCodeString="Page Not Found"
+ * />
+ * ```
+ */
 export declare function StatusCodeView({ statusCode, statusCodeString, }: {
     statusCode: StatusCode;
     statusCodeString: string;
 }): import("react/jsx-runtime").JSX.Element;
-export {};
 //# sourceMappingURL=status-code-view.d.ts.map

package/dist/display/status/status-code-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-code-view.d.ts","sourceRoot":"","sources":["../../../display/status/status-code-view.tsx"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAExD,wBAAgB,cAAc,CAAC,EAC9B,UAAU,EACV,gBAAgB,GAChB,EAAE;IACF,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CACzB,2CAcA"}
+{"version":3,"file":"status-code-view.d.ts","sourceRoot":"","sources":["../../../display/status/status-code-view.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,EAC9B,UAAU,EACV,gBAAgB,GAChB,EAAE;IACF,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CACzB,2CAcA"}

package/dist/display/status/status-code-view.js

@@ -1,5 +1,23 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * A stylized display for HTTP status codes.
+ *
+ * @remarks
+ * Shows the status code prominently with a gradient effect
+ * and an accompanying description text.
+ *
+ * @param props - Status code and description string
+ * @returns A styled status code display
+ *
+ * @example
+ * ```tsx
+ * <StatusCodeView
+ *   statusCode="404"
+ *   statusCodeString="Page Not Found"
+ * />
+ * ```
+ */
 export function StatusCodeView({ statusCode, statusCodeString, }) {
     return (_jsxs("div", { className: "w-full bg-linear-to-r from-primary to-primary-grad bg-clip-text p-2 text-center font-extrabold text-transparent", "data-testid": "status-code-view", children: [_jsxs("div", { className: "text-9xl", children: [_jsx("span", { className: "hidden font-light sm:inline", children: "---" }), String(statusCode), _jsx("span", { className: "hidden font-light sm:inline", children: "---" })] }), _jsxs("div", { className: "text-sm", children: ["------", statusCodeString, "------"] })] }));
 }

package/dist/display/status/status-code-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"status-code-view.js","sourceRoot":"","sources":["../../../display/status/status-code-view.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAIb,MAAM,UAAU,cAAc,CAAC,EAC9B,UAAU,EACV,gBAAgB,GAIhB;IACA,OAAO,CACN,eACC,SAAS,EAAC,iHAAiH,iBAC/G,kBAAkB,aAE9B,eAAK,SAAS,EAAC,UAAU,aACxB,eAAM,SAAS,EAAC,6BAA6B,oBAAW,EACvD,MAAM,CAAC,UAAU,CAAC,EACnB,eAAM,SAAS,EAAC,6BAA6B,oBAAW,IACnD,EACN,eAAK,SAAS,EAAC,SAAS,uBAAQ,gBAAgB,cAAa,IACxD,CACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"status-code-view.js","sourceRoot":"","sources":["../../../display/status/status-code-view.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAcb;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAC,EAC9B,UAAU,EACV,gBAAgB,GAIhB;IACA,OAAO,CACN,eACC,SAAS,EAAC,iHAAiH,iBAC/G,kBAAkB,aAE9B,eAAK,SAAS,EAAC,UAAU,aACxB,eAAM,SAAS,EAAC,6BAA6B,oBAAW,EACvD,MAAM,CAAC,UAAU,CAAC,EACnB,eAAM,SAAS,EAAC,6BAA6B,oBAAW,IACnD,EACN,eAAK,SAAS,EAAC,SAAS,uBAAQ,gBAAgB,cAAa,IACxD,CACN,CAAC;AACH,CAAC"}

package/dist/forms/fields/form-dropdown-input.d.ts

@@ -1,15 +1,69 @@
-import { type ComponentProps, type RefObject } from "react";
-import { Input } from "../../ui/input";
-type Props = {
+import { type RefObject } from "react";
+/**
+ * Props for the FormDropdownInput component.
+ *
+ * @remarks
+ * This component provides a searchable dropdown with support for custom values.
+ * It integrates with the generic form wrapper for form state management.
+ *
+ * @see {@link FormDropdownInput} for the component
+ */
+export type Props = {
+    /** The label text displayed above the dropdown */
     label: string;
+    /** The HTML id for the input element */
     htmlFor: string;
+    /** Array of options with id and display name */
     options: {
         id: string;
         name: string;
     }[];
-    triggerIcon: React.ReactNode;
+    /** Optional ref to access the hidden input element */
     inputRef?: RefObject<HTMLInputElement | null>;
-} & Omit<ComponentProps<typeof Input>, "ref">;
-export declare function FormDropdownInput({ label, htmlFor, options, triggerIcon, inputRef, defaultValue, ...inputProps }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
+    /** Placeholder text when no value is selected */
+    placeholder?: string;
+    /** The form field name (defaults to htmlFor if not provided) */
+    name?: string;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Message shown when no options match the search */
+    emptyMessage?: string;
+    /** Placeholder text for the search input */
+    searchPlaceholder?: string;
+    /** Function to generate the label for custom values */
+    customValueLabel?: (value: string) => string;
+};
+/**
+ * A searchable dropdown input component for forms.
+ *
+ * @remarks
+ * Combines Popover and Command components for a combobox experience.
+ * Supports:
+ * - Searchable options
+ * - Custom value entry
+ * - Form state preservation via GenericFormWrapper
+ * - Keyboard navigation
+ *
+ * @param props - Dropdown configuration including options and labels
+ * @returns A searchable dropdown field with hidden input for form submission
+ *
+ * @example
+ * ```tsx
+ * <FormDropdownInput
+ *   label="Category"
+ *   htmlFor="category"
+ *   name="category"
+ *   options={[
+ *     { id: "1", name: "Technology" },
+ *     { id: "2", name: "Business" },
+ *   ]}
+ *   placeholder="Select a category"
+ * />
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for form integration
+ */
+export declare function FormDropdownInput({ label, htmlFor, options, inputRef, placeholder, name, required, disabled, emptyMessage, searchPlaceholder, customValueLabel, }: Props): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=form-dropdown-input.d.ts.map

package/dist/forms/fields/form-dropdown-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-dropdown-input.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-dropdown-input.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAQvE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC,KAAK,KAAK,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAC9C,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,OAAO,EACP,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,GAAG,UAAU,EACb,EAAE,KAAK,2CA6CP"}
+{"version":3,"file":"form-dropdown-input.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-dropdown-input.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAe5D;;;;;;;;GAQG;AACH,MAAM,MAAM,KAAK,GAAG;IACnB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,YAAiC,EACjC,iBAA+B,EAC/B,gBAAsC,GACtC,EAAE,KAAK,2CA4GP"}

package/dist/forms/fields/form-dropdown-input.js

@@ -1,23 +1,76 @@
+"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect } from "react";
+import { CheckIcon, ChevronsUpDownIcon } from "lucide-react";
+import { useEffect, useState } from "react";
 import { Button } from "../../ui/button";
-import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, } from "../../ui/dropdown-menu";
-import { Input } from "../../ui/input";
+import { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, } from "../../ui/command";
 import { Label } from "../../ui/label";
+import { Popover, PopoverContent, PopoverTrigger } from "../../ui/popover";
+import { cn } from "../../utils/cn";
 import { useFormValues } from "../generic-form-wrapper";
-export function FormDropdownInput({ label, htmlFor, options, triggerIcon, inputRef, defaultValue, ...inputProps }) {
+/**
+ * A searchable dropdown input component for forms.
+ *
+ * @remarks
+ * Combines Popover and Command components for a combobox experience.
+ * Supports:
+ * - Searchable options
+ * - Custom value entry
+ * - Form state preservation via GenericFormWrapper
+ * - Keyboard navigation
+ *
+ * @param props - Dropdown configuration including options and labels
+ * @returns A searchable dropdown field with hidden input for form submission
+ *
+ * @example
+ * ```tsx
+ * <FormDropdownInput
+ *   label="Category"
+ *   htmlFor="category"
+ *   name="category"
+ *   options={[
+ *     { id: "1", name: "Technology" },
+ *     { id: "2", name: "Business" },
+ *   ]}
+ *   placeholder="Select a category"
+ * />
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for form integration
+ */
+export function FormDropdownInput({ label, htmlFor, options, inputRef, placeholder, name, required, disabled, emptyMessage = "No results found", searchPlaceholder = "Search...", customValueLabel = (v) => `Use "${v}"`, }) {
+    const [open, setOpen] = useState(false);
+    const [value, setValue] = useState("");
+    const [searchValue, setSearchValue] = useState("");
     const formValues = useFormValues();
-    const preservedValue = formValues[inputProps.name || htmlFor];
-    const handleSelectedValueChange = (value) => {
+    const preservedValue = formValues[name || htmlFor];
+    useEffect(() => {
+        if (preservedValue) {
+            setValue(preservedValue);
+        }
+    }, [preservedValue]);
+    useEffect(() => {
         if (inputRef?.current) {
             inputRef.current.value = value;
         }
+    }, [value, inputRef]);
+    const handleSelect = (selectedValue) => {
+        setValue(selectedValue);
+        setSearchValue("");
+        setOpen(false);
     };
-    useEffect(() => {
-        if (preservedValue && inputRef?.current) {
-            inputRef.current.value = preservedValue;
+    const handleCustomValue = () => {
+        if (searchValue) {
+            setValue(searchValue);
+            setSearchValue("");
+            setOpen(false);
         }
-    }, [preservedValue, inputRef]);
-    return (_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: htmlFor, children: label }), _jsxs("div", { className: "flex", children: [_jsx(Input, { defaultValue: preservedValue || defaultValue, id: htmlFor, ref: inputRef, ...inputProps }), _jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: "ghost", children: triggerIcon }) }), _jsx(DropdownMenuContent, { children: options.map((option) => (_jsx(DropdownMenuItem, { onClick: () => handleSelectedValueChange(option.name), textValue: String(option.name), children: option.name }, option.id))) })] })] })] }));
+    };
+    return (_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: htmlFor, children: label }), _jsxs(Popover, { onOpenChange: setOpen, open: open, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { "aria-expanded": open, className: "w-full justify-between", disabled: disabled, role: "combobox", variant: "outline", children: [value || placeholder || "Select...", _jsx(ChevronsUpDownIcon, { className: "ml-2 h-4 w-4 shrink-0 opacity-50" })] }) }), _jsx(PopoverContent, { className: "w-[var(--radix-popover-trigger-width)] p-0", children: _jsxs(Command, { shouldFilter: true, children: [_jsx(CommandInput, { onKeyDown: (e) => {
+                                        if (e.key === "Enter" && searchValue) {
+                                            e.preventDefault();
+                                            handleCustomValue();
+                                        }
+                                    }, onValueChange: setSearchValue, placeholder: searchPlaceholder, value: searchValue }), _jsxs(CommandList, { children: [_jsx(CommandEmpty, { children: searchValue ? (_jsx("button", { className: "w-full text-left hover:underline", onClick: handleCustomValue, type: "button", children: customValueLabel(searchValue) })) : (emptyMessage) }), _jsx(CommandGroup, { children: options.map((option) => (_jsxs(CommandItem, { onSelect: () => handleSelect(option.name), value: option.name, children: [_jsx(CheckIcon, { className: cn("mr-2 h-4 w-4", value === option.name ? "opacity-100" : "opacity-0") }), option.name] }, option.id))) })] })] }) })] }), _jsx("input", { id: htmlFor, name: name || htmlFor, ref: inputRef, required: required, type: "hidden", value: value })] }));
 }
 //# sourceMappingURL=form-dropdown-input.js.map

package/dist/forms/fields/form-dropdown-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-dropdown-input.js","sourceRoot":"","sources":["../../../forms/fields/form-dropdown-input.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAuC,SAAS,EAAE,MAAM,OAAO,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EACN,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAUxD,MAAM,UAAU,iBAAiB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,OAAO,EACP,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,GAAG,UAAU,EACN;IACP,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAE9D,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAAE,EAAE;QACnD,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC;YACvB,QAAQ,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QAChC,CAAC;IACF,CAAC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,cAAc,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC;YACzC,QAAQ,CAAC,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC;QACzC,CAAC;IACF,CAAC,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE/B,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,eAAK,SAAS,EAAC,MAAM,aACpB,KAAC,KAAK,IACL,YAAY,EAAE,cAAc,IAAI,YAAY,EAC5C,EAAE,EAAE,OAAO,EACX,GAAG,EAAE,QAAQ,KACT,UAAU,GACb,EACF,MAAC,YAAY,eACZ,KAAC,mBAAmB,IAAC,OAAO,kBAC3B,KAAC,MAAM,IAAC,OAAO,EAAC,OAAO,YAAE,WAAW,GAAU,GACzB,EACtB,KAAC,mBAAmB,cAClB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACxB,KAAC,gBAAgB,IAEhB,OAAO,EAAE,GAAG,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,IAAI,CAAC,EACrD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAE7B,MAAM,CAAC,IAAI,IAJP,MAAM,CAAC,EAAE,CAKI,CACnB,CAAC,GACmB,IACR,IACV,IACD,CACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"form-dropdown-input.js","sourceRoot":"","sources":["../../../forms/fields/form-dropdown-input.tsx"],"names":[],"mappings":"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"}

package/dist/forms/fields/form-file-input.d.ts

@@ -1,9 +1,36 @@
 import type { ComponentProps } from "react";
 import { Input } from "../../ui/input";
-type Props = {
+/**
+ * Props for the FormFileInput component.
+ *
+ * @see {@link FormFileInput} for the component
+ */
+export type FormFileInputProps = {
+    /** The label text displayed above the file input */
     label: string;
+    /** The HTML id for the input element */
     htmlFor: string;
 } & ComponentProps<typeof Input>;
-export declare function FormFileInput({ label, htmlFor, ...inputProps }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * A labeled file input component for forms.
+ *
+ * @remarks
+ * Provides a styled file upload field.
+ * Note: File inputs don't preserve values on form errors due to browser security.
+ *
+ * @param props - File input props including label and standard input attributes
+ * @returns A labeled file input field
+ *
+ * @example
+ * ```tsx
+ * <FormFileInput
+ *   label="Upload Image"
+ *   htmlFor="image"
+ *   name="image"
+ *   accept="image/*"
+ *   required
+ * />
+ * ```
+ */
+export declare function FormFileInput({ label, htmlFor, ...inputProps }: FormFileInputProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=form-file-input.d.ts.map

package/dist/forms/fields/form-file-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-file-input.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-file-input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,KAAK,KAAK,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAAC,OAAO,KAAK,CAAC,CAAC;AAEjC,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,EAAE,KAAK,2CAOrE"}
+{"version":3,"file":"form-file-input.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-file-input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAAC,OAAO,KAAK,CAAC,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,EAC7B,KAAK,EACL,OAAO,EACP,GAAG,UAAU,EACb,EAAE,kBAAkB,2CAOpB"}

package/dist/forms/fields/form-file-input.js

@@ -1,6 +1,27 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Input } from "../../ui/input";
 import { Label } from "../../ui/label";
+/**
+ * A labeled file input component for forms.
+ *
+ * @remarks
+ * Provides a styled file upload field.
+ * Note: File inputs don't preserve values on form errors due to browser security.
+ *
+ * @param props - File input props including label and standard input attributes
+ * @returns A labeled file input field
+ *
+ * @example
+ * ```tsx
+ * <FormFileInput
+ *   label="Upload Image"
+ *   htmlFor="image"
+ *   name="image"
+ *   accept="image/*"
+ *   required
+ * />
+ * ```
+ */
 export function FormFileInput({ label, htmlFor, ...inputProps }) {
     return (_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: htmlFor, children: label }), _jsx(Input, { id: htmlFor, type: "file", ...inputProps })] }));
 }

package/dist/forms/fields/form-file-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-file-input.js","sourceRoot":"","sources":["../../../forms/fields/form-file-input.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAOvC,MAAM,UAAU,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,EAAS;IACrE,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,KAAC,KAAK,IAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAC,MAAM,KAAK,UAAU,GAAI,IAC7C,CACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"form-file-input.js","sourceRoot":"","sources":["../../../forms/fields/form-file-input.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAcvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CAAC,EAC7B,KAAK,EACL,OAAO,EACP,GAAG,UAAU,EACO;IACpB,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,KAAC,KAAK,IAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAC,MAAM,KAAK,UAAU,GAAI,IAC7C,CACN,CAAC;AACH,CAAC"}

package/dist/forms/fields/form-input-with-button.d.ts

@@ -1,13 +1,51 @@
 import { type ComponentProps, type RefObject } from "react";
 import { Input } from "../../ui/input";
-type Props = {
+/**
+ * Props for the FormInputWithButton component.
+ *
+ * @see {@link FormInputWithButton} for the component
+ */
+export type FormInputWithButtonProps = {
+    /** The label text displayed above the input */
     label: string;
+    /** The HTML id for the input element */
     htmlFor: string;
+    /** Icon or content for the action button */
     buttonIcon: React.ReactNode;
+    /** Callback when the button is clicked */
     onButtonClick: () => void;
+    /** Optional ref to access the input element */
     inputRef?: RefObject<HTMLInputElement | null>;
+    /** Test id for the button element */
     buttonTestId?: string;
 } & Omit<ComponentProps<typeof Input>, "ref">;
-export declare function FormInputWithButton({ label, htmlFor, buttonIcon, onButtonClick, inputRef, buttonTestId, defaultValue, ...inputProps }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * A text input with an adjacent action button.
+ *
+ * @remarks
+ * Useful for inputs that need an associated action like:
+ * - URL input with fetch button
+ * - Search input with clear button
+ * - Password input with visibility toggle
+ *
+ * Integrates with GenericFormWrapper for form state preservation.
+ *
+ * @param props - Input and button configuration
+ * @returns An input field with an action button
+ *
+ * @example
+ * ```tsx
+ * <FormInputWithButton
+ *   label="URL"
+ *   htmlFor="url"
+ *   name="url"
+ *   buttonIcon={<FetchIcon />}
+ *   onButtonClick={handleFetch}
+ *   placeholder="https://example.com"
+ * />
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for form integration
+ */
+export declare function FormInputWithButton({ label, htmlFor, buttonIcon, onButtonClick, inputRef, buttonTestId, defaultValue, ...inputProps }: FormInputWithButtonProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=form-input-with-button.d.ts.map

package/dist/forms/fields/form-input-with-button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-input-with-button.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-input-with-button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAEvE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC,KAAK,KAAK,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,EACnC,KAAK,EACL,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,GAAG,UAAU,EACb,EAAE,KAAK,2CA+BP"}
+{"version":3,"file":"form-input-with-button.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-input-with-button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAEvE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACtC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,EACnC,KAAK,EACL,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,GAAG,UAAU,EACb,EAAE,wBAAwB,2CA+B1B"}

package/dist/forms/fields/form-input-with-button.js

@@ -4,6 +4,34 @@ import { Button } from "../../ui/button";
 import { Input } from "../../ui/input";
 import { Label } from "../../ui/label";
 import { useFormValues } from "../generic-form-wrapper";
+/**
+ * A text input with an adjacent action button.
+ *
+ * @remarks
+ * Useful for inputs that need an associated action like:
+ * - URL input with fetch button
+ * - Search input with clear button
+ * - Password input with visibility toggle
+ *
+ * Integrates with GenericFormWrapper for form state preservation.
+ *
+ * @param props - Input and button configuration
+ * @returns An input field with an action button
+ *
+ * @example
+ * ```tsx
+ * <FormInputWithButton
+ *   label="URL"
+ *   htmlFor="url"
+ *   name="url"
+ *   buttonIcon={<FetchIcon />}
+ *   onButtonClick={handleFetch}
+ *   placeholder="https://example.com"
+ * />
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for form integration
+ */
 export function FormInputWithButton({ label, htmlFor, buttonIcon, onButtonClick, inputRef, buttonTestId, defaultValue, ...inputProps }) {
     const formValues = useFormValues();
     const preservedValue = formValues[inputProps.name || htmlFor];

package/dist/forms/fields/form-input-with-button.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-input-with-button.js","sourceRoot":"","sources":["../../../forms/fields/form-input-with-button.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAuC,SAAS,EAAE,MAAM,OAAO,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAWxD,MAAM,UAAU,mBAAmB,CAAC,EACnC,KAAK,EACL,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,GAAG,UAAU,EACN;IACP,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAE9D,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,cAAc,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC;YACzC,QAAQ,CAAC,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC;QACzC,CAAC;IACF,CAAC,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE/B,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,eAAK,SAAS,EAAC,MAAM,aACpB,KAAC,KAAK,IACL,YAAY,EAAE,cAAc,IAAI,YAAY,EAC5C,EAAE,EAAE,OAAO,EACX,GAAG,EAAE,QAAQ,KACT,UAAU,GACb,EACF,KAAC,MAAM,mBACO,YAAY,EACzB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,OAAO,YAEd,UAAU,GACH,IACJ,IACD,CACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"form-input-with-button.js","sourceRoot":"","sources":["../../../forms/fields/form-input-with-button.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAuC,SAAS,EAAE,MAAM,OAAO,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAsBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,mBAAmB,CAAC,EACnC,KAAK,EACL,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,GAAG,UAAU,EACa;IAC1B,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAE9D,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,cAAc,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC;YACzC,QAAQ,CAAC,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC;QACzC,CAAC;IACF,CAAC,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE/B,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,eAAK,SAAS,EAAC,MAAM,aACpB,KAAC,KAAK,IACL,YAAY,EAAE,cAAc,IAAI,YAAY,EAC5C,EAAE,EAAE,OAAO,EACX,GAAG,EAAE,QAAQ,KACT,UAAU,GACb,EACF,KAAC,MAAM,mBACO,YAAY,EACzB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,OAAO,YAEd,UAAU,GACH,IACJ,IACD,CACN,CAAC;AACH,CAAC"}

package/dist/forms/fields/form-input.d.ts

@@ -1,9 +1,38 @@
 import type { ComponentProps } from "react";
 import { Input } from "../../ui/input";
-type Props = {
+/**
+ * Props for the FormInput component.
+ *
+ * @see {@link FormInput} for the component
+ */
+export type FormInputProps = {
+    /** The label text displayed above the input */
     label: string;
+    /** The HTML id for the input element */
     htmlFor: string;
 } & ComponentProps<typeof Input>;
-export declare function FormInput({ label, htmlFor, defaultValue, ...inputProps }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * A labeled text input component for forms.
+ *
+ * @remarks
+ * Integrates with GenericFormWrapper for form state preservation.
+ * Automatically restores value on form errors.
+ *
+ * @param props - Input props including label and standard input attributes
+ * @returns A labeled input field
+ *
+ * @example
+ * ```tsx
+ * <FormInput
+ *   label="Email"
+ *   htmlFor="email"
+ *   name="email"
+ *   type="email"
+ *   required
+ * />
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for form integration
+ */
+export declare function FormInput({ label, htmlFor, defaultValue, ...inputProps }: FormInputProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=form-input.d.ts.map

package/dist/forms/fields/form-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-input.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC,KAAK,KAAK,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAAC,OAAO,KAAK,CAAC,CAAC;AAEjC,wBAAgB,SAAS,CAAC,EACzB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,UAAU,EACb,EAAE,KAAK,2CAcP"}
+{"version":3,"file":"form-input.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAAC,OAAO,KAAK,CAAC,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,EACzB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,UAAU,EACb,EAAE,cAAc,2CAchB"}

package/dist/forms/fields/form-input.js

@@ -2,6 +2,29 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Input } from "../../ui/input";
 import { Label } from "../../ui/label";
 import { useFormValues } from "../generic-form-wrapper";
+/**
+ * A labeled text input component for forms.
+ *
+ * @remarks
+ * Integrates with GenericFormWrapper for form state preservation.
+ * Automatically restores value on form errors.
+ *
+ * @param props - Input props including label and standard input attributes
+ * @returns A labeled input field
+ *
+ * @example
+ * ```tsx
+ * <FormInput
+ *   label="Email"
+ *   htmlFor="email"
+ *   name="email"
+ *   type="email"
+ *   required
+ * />
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for form integration
+ */
 export function FormInput({ label, htmlFor, defaultValue, ...inputProps }) {
     const formValues = useFormValues();
     const preservedValue = formValues[inputProps.name || htmlFor];

package/dist/forms/fields/form-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-input.js","sourceRoot":"","sources":["../../../forms/fields/form-input.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOxD,MAAM,UAAU,SAAS,CAAC,EACzB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,UAAU,EACN;IACP,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAE9D,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,KAAC,KAAK,IACL,YAAY,EAAE,cAAc,IAAI,YAAY,EAC5C,EAAE,EAAE,OAAO,KACP,UAAU,GACb,IACG,CACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"form-input.js","sourceRoot":"","sources":["../../../forms/fields/form-input.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAcxD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CAAC,EACzB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,UAAU,EACG;IAChB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAE9D,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,KAAC,KAAK,IACL,YAAY,EAAE,cAAc,IAAI,YAAY,EAC5C,EAAE,EAAE,OAAO,KACP,UAAU,GACb,IACG,CACN,CAAC;AACH,CAAC"}

package/dist/forms/fields/form-textarea.d.ts

@@ -1,9 +1,37 @@
 import type { ComponentProps } from "react";
 import { Textarea } from "../../ui/textarea";
-type Props = {
+/**
+ * Props for the FormTextarea component.
+ *
+ * @see {@link FormTextarea} for the component
+ */
+export type FormTextareaProps = {
+    /** The label text displayed above the textarea */
     label: string;
+    /** The HTML id for the textarea element */
     htmlFor: string;
 } & ComponentProps<typeof Textarea>;
-export declare function FormTextarea({ label, htmlFor, defaultValue, ...textareaProps }: Props): import("react/jsx-runtime").JSX.Element;
-export {};
+/**
+ * A labeled multi-line text input component for forms.
+ *
+ * @remarks
+ * Integrates with GenericFormWrapper for form state preservation.
+ * Automatically restores value on form errors.
+ *
+ * @param props - Textarea props including label and standard textarea attributes
+ * @returns A labeled textarea field
+ *
+ * @example
+ * ```tsx
+ * <FormTextarea
+ *   label="Description"
+ *   htmlFor="description"
+ *   name="description"
+ *   rows={5}
+ * />
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for form integration
+ */
+export declare function FormTextarea({ label, htmlFor, defaultValue, ...textareaProps }: FormTextareaProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=form-textarea.d.ts.map

package/dist/forms/fields/form-textarea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-textarea.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,KAAK,KAAK,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEpC,wBAAgB,YAAY,CAAC,EAC5B,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,aAAa,EAChB,EAAE,KAAK,2CAcP"}
+{"version":3,"file":"form-textarea.d.ts","sourceRoot":"","sources":["../../../forms/fields/form-textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAC5B,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,aAAa,EAChB,EAAE,iBAAiB,2CAcnB"}