@arkyn/components 3.0.1-beta.142 → 3.0.1-beta.144

package/dist/components/imageUpload/index.d.ts

@@ -1,117 +1,89 @@
 import "./styles.css";
 type ImageUploadProps = {
+    /** Field name for form submission (stores the uploaded image URL). Required. */
     name: string;
+    /** Server endpoint URL that receives the `multipart/form-data` upload request. Required. */
     action: string;
+    /** Pre-populated image URL displayed as a preview (e.g. an existing avatar). @default "" */
     defaultValue?: string | null;
+    /** Additional CSS class applied to the wrapper element. */
     className?: string;
+    /** Disables file selection and upload. @default false */
     disabled?: boolean;
+    /** Optional label text displayed above the upload area. */
     label?: string;
+    /** Displays an asterisk on the label to signal a required field. @default false */
     showAsterisk?: boolean;
+    /** Label for the file-picker button after an image is selected. @default "Alterar imagem" */
     changeImageButtonText?: string;
+    /** Label for the file-picker button before an image is selected. @default "Selecionar imagem" */
     selectImageButtonText?: string;
+    /** Text displayed in the drag-and-drop zone. @default "Ou arraste e solte a imagem aqui" */
     dropImageText?: string;
+    /** HTTP method for the upload request. @default "POST" */
     method?: string;
+    /** Form-data field name used for the file. @default "file" */
     fileName?: string;
+    /** Property name in the server response that contains the image URL. @default "url" */
     fileResponseName?: string;
+    /** Accepted image MIME types or extensions (e.g. `"image/jpeg,image/png"`). @default "image/*" */
     acceptImage?: string;
+    /** Callback fired after a successful upload. Receives the image URL returned by the server. */
     onChange?: (url: string) => void;
+    /** When true, skips `FieldTemplate` wrapper (label and error text). @default false */
     unShowFieldTemplate?: boolean;
+    /**
+     * Layout direction forwarded to `FieldTemplate`.
+     * @default "horizontal"
+     */
     orientation?: "horizontal" | "vertical" | "horizontalReverse";
 };
 /**
- * ImageUpload component - specialized file upload component for image files with preview functionality
+ * ImageUpload — drag-and-drop image uploader with server upload and image preview.
  *
- * @param props - ImageUpload component properties
- * @param props.name - Required field name for form handling
- * @param props.defaultValue - Initial image URL to display as preview. Default: ""
- * @param props.disabled - Whether the image upload is disabled. Default: false
- * @param props.className - Additional class name(s) for the wrapper element
- * @param props.label - Optional label text to display above the image upload area
- * @param props.showAsterisk - Whether to show asterisk on label for required fields. Default: false
- * @param props.changeImageButtonText - Text for the button to change/replace an uploaded image. Default: "Alterar imagem"
- * @param props.selectImageButtonText - Text for the button to select an image. Default: "Selecionar imagem"
- * @param props.dropImageText - Text displayed in the drop zone area. Default: "Ou arraste e solte a imagem aqui"
- * @param props.action - Required endpoint URL where the image will be uploaded
- * @param props.method - HTTP method for the upload request. Default: "POST"
- * @param props.fileName - Form data field name for the image file. Default: "file"
- * @param props.fileResponseName - Property name in the response object containing the image URL. Default: "url"
- * @param props.acceptImage - Image file types accepted by the input (e.g., "image/*", ".jpg,.png"). Default: "image/*"
- * @param props.onChange - Callback function called when image upload completes successfully, receives the image URL
- * @param props.unShowFieldTemplate - When true, skips `FieldTemplate` structure (wrapper, label and error text) and renders only the checkbox button content.
- * @param props.orientation - Layout direction forwarded to `FieldTemplate`/`FieldWrapper` (`horizontal`, `vertical`, `horizontalReverse`). Default: "horizontalReverse"
+ * Sends the file via `fetch` as `multipart/form-data` and stores the returned URL
+ * in a hidden `<input>` for form submission.
+ * Integrates with `useForm` to display validation errors by field name.
  *
- * @returns ImageUpload JSX element wrapped in FieldGroup with optional label, image preview, and error handling
+ * @param props.name - Field name for form submission. Required.
+ * @param props.action - Upload endpoint URL. Required.
+ * @param props.defaultValue - Pre-populated image URL displayed as preview.
+ * @param props.disabled - Disables file selection and upload. Default: false
+ * @param props.label - Label text displayed above the upload area.
+ * @param props.showAsterisk - Appends `*` to the label. Default: false
+ * @param props.acceptImage - Accepted MIME types or extensions. Default: "image/*"
+ * @param props.method - HTTP method. Default: "POST"
+ * @param props.fileName - Form-data field name for the file. Default: "file"
+ * @param props.fileResponseName - Server response property containing the URL. Default: "url"
+ * @param props.onChange - Callback fired after a successful upload — receives the image URL.
+ * @param props.orientation - Layout direction. Default: "horizontal"
+ * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
+ *
+ * @returns ImageUpload JSX element wrapped in `FieldTemplate`.
  *
  * @example
  * ```tsx
- * // Basic image upload
- * <ImageUpload
- *   name="avatar"
- *   action="/api/upload/image"
- * />
+ * // Basic
+ * <ImageUpload name="avatar" action="/api/upload/image" />
  *
- * // Image upload with label and custom text
+ * // Profile picture with existing image and label
  * <ImageUpload
  *   name="profilePicture"
  *   action="/api/upload/avatar"
  *   label="Profile Picture"
  *   showAsterisk
- *   selectImageButtonText="Choose Photo"
- *   changeImageButtonText="Change Photo"
- *   dropImageText="Drop your photo here"
+ *   defaultValue={user.avatarUrl}
+ *   selectImageButtonText="Choose photo"
+ *   onChange={(url) => updateProfile({ avatarUrl: url })}
  * />
  *
- * // Image upload with default value and restrictions
+ * // Restricted to JPEG/PNG
  * <ImageUpload
  *   name="productImage"
  *   action="/api/upload/product"
  *   label="Product Image"
- *   defaultValue="https://example.com/default-image.jpg"
- *   acceptImage=".jpg,.jpeg,.png,.webp"
- *   fileName="productImage"
- *   fileResponseName="imageUrl"
- *   onChange={(url) => console.log('Image uploaded:', url)}
- * />
- *
- * // Disabled image upload with existing image
- * <ImageUpload
- *   name="banner"
- *   action="/api/upload/banner"
- *   label="Banner Image"
- *   defaultValue="https://example.com/banner.jpg"
- *   disabled
- * />
- *
- * // Image upload with custom HTTP method and response handling
- * <ImageUpload
- *   name="gallery"
- *   action="/api/images"
- *   method="PUT"
- *   fileName="galleryImage"
- *   fileResponseName="imageUrl"
- *   label="Gallery Image"
  *   acceptImage="image/jpeg,image/png"
- *   onChange={(url) => {
- *     if (url) {
- *       setImageUrl(url);
- *       console.log('Upload successful:', url);
- *     }
- *   }}
- * />
- *
- * // Image upload for user avatar with form integration
- * <ImageUpload
- *   name="userAvatar"
- *   action="/api/users/avatar"
- *   label="User Avatar"
- *   showAsterisk
- *   defaultValue={user?.avatarUrl}
- *   selectImageButtonText="Select Avatar"
- *   changeImageButtonText="Update Avatar"
- *   dropImageText="Drop avatar image here"
- *   onChange={(avatarUrl) => {
- *     updateUserProfile({ avatarUrl });
- *   }}
+ *   fileResponseName="imageUrl"
  * />
  * ```
  */

package/dist/components/imageUpload/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/imageUpload/index.tsx"],"names":[],"mappings":"AAOA,OAAO,cAAc,CAAC;AAEtB,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CA2G3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/imageUpload/index.tsx"],"names":[],"mappings":"AAOA,OAAO,cAAc,CAAC;AAEtB,KAAK,gBAAgB,GAAG;IACtB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6FAA6F;IAC7F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iGAAiG;IACjG,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kGAAkG;IAClG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CA2G3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/imageUpload/index.js

@@ -6,99 +6,51 @@ import { HasFileContent } from "./hasFileContent";
 import { NoFileContent } from "./noFileContent";
 import "./styles.css";
 /**
- * ImageUpload component - specialized file upload component for image files with preview functionality
+ * ImageUpload — drag-and-drop image uploader with server upload and image preview.
  *
- * @param props - ImageUpload component properties
- * @param props.name - Required field name for form handling
- * @param props.defaultValue - Initial image URL to display as preview. Default: ""
- * @param props.disabled - Whether the image upload is disabled. Default: false
- * @param props.className - Additional class name(s) for the wrapper element
- * @param props.label - Optional label text to display above the image upload area
- * @param props.showAsterisk - Whether to show asterisk on label for required fields. Default: false
- * @param props.changeImageButtonText - Text for the button to change/replace an uploaded image. Default: "Alterar imagem"
- * @param props.selectImageButtonText - Text for the button to select an image. Default: "Selecionar imagem"
- * @param props.dropImageText - Text displayed in the drop zone area. Default: "Ou arraste e solte a imagem aqui"
- * @param props.action - Required endpoint URL where the image will be uploaded
- * @param props.method - HTTP method for the upload request. Default: "POST"
- * @param props.fileName - Form data field name for the image file. Default: "file"
- * @param props.fileResponseName - Property name in the response object containing the image URL. Default: "url"
- * @param props.acceptImage - Image file types accepted by the input (e.g., "image/*", ".jpg,.png"). Default: "image/*"
- * @param props.onChange - Callback function called when image upload completes successfully, receives the image URL
- * @param props.unShowFieldTemplate - When true, skips `FieldTemplate` structure (wrapper, label and error text) and renders only the checkbox button content.
- * @param props.orientation - Layout direction forwarded to `FieldTemplate`/`FieldWrapper` (`horizontal`, `vertical`, `horizontalReverse`). Default: "horizontalReverse"
+ * Sends the file via `fetch` as `multipart/form-data` and stores the returned URL
+ * in a hidden `<input>` for form submission.
+ * Integrates with `useForm` to display validation errors by field name.
  *
- * @returns ImageUpload JSX element wrapped in FieldGroup with optional label, image preview, and error handling
+ * @param props.name - Field name for form submission. Required.
+ * @param props.action - Upload endpoint URL. Required.
+ * @param props.defaultValue - Pre-populated image URL displayed as preview.
+ * @param props.disabled - Disables file selection and upload. Default: false
+ * @param props.label - Label text displayed above the upload area.
+ * @param props.showAsterisk - Appends `*` to the label. Default: false
+ * @param props.acceptImage - Accepted MIME types or extensions. Default: "image/*"
+ * @param props.method - HTTP method. Default: "POST"
+ * @param props.fileName - Form-data field name for the file. Default: "file"
+ * @param props.fileResponseName - Server response property containing the URL. Default: "url"
+ * @param props.onChange - Callback fired after a successful upload — receives the image URL.
+ * @param props.orientation - Layout direction. Default: "horizontal"
+ * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
+ *
+ * @returns ImageUpload JSX element wrapped in `FieldTemplate`.
  *
  * @example
  * ```tsx
- * // Basic image upload
- * <ImageUpload
- *   name="avatar"
- *   action="/api/upload/image"
- * />
+ * // Basic
+ * <ImageUpload name="avatar" action="/api/upload/image" />
  *
- * // Image upload with label and custom text
+ * // Profile picture with existing image and label
  * <ImageUpload
  *   name="profilePicture"
  *   action="/api/upload/avatar"
  *   label="Profile Picture"
  *   showAsterisk
- *   selectImageButtonText="Choose Photo"
- *   changeImageButtonText="Change Photo"
- *   dropImageText="Drop your photo here"
+ *   defaultValue={user.avatarUrl}
+ *   selectImageButtonText="Choose photo"
+ *   onChange={(url) => updateProfile({ avatarUrl: url })}
  * />
  *
- * // Image upload with default value and restrictions
+ * // Restricted to JPEG/PNG
  * <ImageUpload
  *   name="productImage"
  *   action="/api/upload/product"
  *   label="Product Image"
- *   defaultValue="https://example.com/default-image.jpg"
- *   acceptImage=".jpg,.jpeg,.png,.webp"
- *   fileName="productImage"
- *   fileResponseName="imageUrl"
- *   onChange={(url) => console.log('Image uploaded:', url)}
- * />
- *
- * // Disabled image upload with existing image
- * <ImageUpload
- *   name="banner"
- *   action="/api/upload/banner"
- *   label="Banner Image"
- *   defaultValue="https://example.com/banner.jpg"
- *   disabled
- * />
- *
- * // Image upload with custom HTTP method and response handling
- * <ImageUpload
- *   name="gallery"
- *   action="/api/images"
- *   method="PUT"
- *   fileName="galleryImage"
- *   fileResponseName="imageUrl"
- *   label="Gallery Image"
  *   acceptImage="image/jpeg,image/png"
- *   onChange={(url) => {
- *     if (url) {
- *       setImageUrl(url);
- *       console.log('Upload successful:', url);
- *     }
- *   }}
- * />
- *
- * // Image upload for user avatar with form integration
- * <ImageUpload
- *   name="userAvatar"
- *   action="/api/users/avatar"
- *   label="User Avatar"
- *   showAsterisk
- *   defaultValue={user?.avatarUrl}
- *   selectImageButtonText="Select Avatar"
- *   changeImageButtonText="Update Avatar"
- *   dropImageText="Drop avatar image here"
- *   onChange={(avatarUrl) => {
- *     updateUserProfile({ avatarUrl });
- *   }}
+ *   fileResponseName="imageUrl"
  * />
  * ```
  */

package/dist/components/input/index.d.ts

@@ -2,50 +2,78 @@ import { LucideIcon } from "lucide-react";
 import { InputHTMLAttributes } from "react";
 import "./style.css";
 type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix" | "name" | "value" | "defaultValue"> & {
+    /** Field name for form submission. Required. */
     name: string;
+    /** Optional label text displayed above the input. */
     label?: string;
+    /** Validation error message displayed below the input. */
     errorMessage?: string;
+    /** Shows a spinner and disables the input during async operations. @default false */
     isLoading?: boolean;
+    /** When true, skips `FieldTemplate` wrapper (label and error text). @default false */
     unShowFieldTemplate?: boolean;
+    /**
+     * Input size.
+     * @default "md"
+     */
     size?: "md" | "lg";
+    /**
+     * Visual style variant.
+     * - `solid`: filled background.
+     * - `outline`: bordered, transparent background.
+     * - `underline`: bottom border only.
+     * @default "solid"
+     */
     variant?: "solid" | "outline" | "underline";
+    /** Text or icon rendered at the far left, outside the input area (e.g. `"https://"`). */
     prefix?: string | LucideIcon;
+    /** Text or icon rendered at the far right, outside the input area (e.g. `".com"`). */
     suffix?: string | LucideIcon;
+    /** Displays an asterisk on the label to signal a required field. */
     showAsterisk?: boolean;
+    /**
+     * Layout direction forwarded to `FieldTemplate`.
+     * @default "horizontal"
+     */
     orientation?: "horizontal" | "vertical" | "horizontalReverse";
+    /** Lucide icon rendered inside the input on the left. */
     leftIcon?: LucideIcon;
+    /** Lucide icon rendered inside the input on the right. */
     rightIcon?: LucideIcon;
+    /** Controlled value. */
     value?: string;
+    /** Uncontrolled default value. */
     defaultValue?: string;
 };
 /**
- * Input component - used for text input fields with support for labels, validation, icons, and loading states
+ * Input — text input field with label, validation, icons, prefix/suffix, and loading state.
  *
- * @param props - Input component properties
- * @param props.name - Required field name for form handling
- * @param props.label - Optional label text to display above the input
- * @param props.errorMessage - Error message to display below the input
- * @param props.isLoading - Controls loading state with spinner. Default: false
- * @param props.size - Input size. Default: "md"
- * @param props.variant - Visual variant of the input. Default: "solid"
- * @param props.prefix - Text or icon to display at the beginning of the input
- * @param props.suffix - Text or icon to display at the end of the input
- * @param props.showAsterisk - Whether to show asterisk on label for required fields
- * @param props.leftIcon - Optional icon to display on the left side
- * @param props.rightIcon - Optional icon to display on the right side
- * @param props.unShowFieldTemplate - When true, skips `FieldTemplate` structure (wrapper, label and error text) and renders only the checkbox button content.
- * @param props.orientation - Layout direction forwarded to `FieldTemplate`/`FieldWrapper` (`horizontal`, `vertical`, `horizontalReverse`). Default: "horizontalReverse"
+ * Integrates with `useForm` to display validation errors by field name.
  *
- * **...Other valid HTML properties for input element**
+ * @param props.name - Field name for form submission. Required.
+ * @param props.label - Label text displayed above the input.
+ * @param props.errorMessage - Validation error message.
+ * @param props.isLoading - Shows a spinner and disables the input. Default: false
+ * @param props.size - Input size (`md` | `lg`). Default: "md"
+ * @param props.variant - Visual style variant. Default: "solid"
+ * @param props.prefix - Text or icon at the far left (outside the input).
+ * @param props.suffix - Text or icon at the far right (outside the input).
+ * @param props.leftIcon - Lucide icon inside the input on the left.
+ * @param props.rightIcon - Lucide icon inside the input on the right.
+ * @param props.showAsterisk - Appends `*` to the label.
+ * @param props.orientation - Layout direction (`horizontal` | `vertical` | `horizontalReverse`). Default: "horizontal"
+ * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
  *
- * @returns Input JSX element wrapped in FieldGroup with optional label and error
+ * **...Other valid HTML properties for `<input>`**
+ *
+ * @returns Input JSX element wrapped in `FieldTemplate`.
  *
  * @example
  * ```tsx
- * // Basic input
+ * // Basic
  * <Input name="username" placeholder="Enter username" />
  *
- * // Input with label and validation
+ * // With label and validation
  * <Input
  *   name="email"
  *   label="Email Address"
@@ -54,32 +82,11 @@ type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix"
  *   errorMessage="Please enter a valid email"
  * />
  *
- * // Input with icons and loading state
- * <Input
- *   name="search"
- *   label="Search"
- *   leftIcon={SearchIcon}
- *   rightIcon={FilterIcon}
- *   isLoading
- * />
- *
- * // Input with prefix/suffix
- * <Input
- *   name="website"
- *   label="Website"
- *   prefix="https://"
- *   suffix=".com"
- *   variant="outline"
- * />
+ * // With icons and loading state
+ * <Input name="search" label="Search" leftIcon={SearchIcon} isLoading />
  *
- * // Large input with underline variant
- * <Input
- *   name="title"
- *   label="Article Title"
- *   size="lg"
- *   variant="underline"
- *   placeholder="Enter article title"
- * />
+ * // With prefix/suffix
+ * <Input name="website" label="Website" prefix="https://" suffix=".com" variant="outline" />
  * ```
  */
 declare function Input(props: InputProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/input/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/input/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,mBAAmB,EAKpB,MAAM,OAAO,CAAC;AAMf,OAAO,aAAa,CAAC;AAErB,KAAK,UAAU,GAAG,IAAI,CACpB,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CACtD,GAAG;IACF,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAE5C,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;IAE9D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,iBAAS,KAAK,CAAC,KAAK,EAAE,UAAU,2CAyI/B;AAED,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/input/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,mBAAmB,EAKpB,MAAM,OAAO,CAAC;AAMf,OAAO,aAAa,CAAC;AAErB,KAAK,UAAU,GAAG,IAAI,CACpB,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CACtD,GAAG;IACF,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;IAC9D,yDAAyD;IACzD,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,iBAAS,KAAK,CAAC,KAAK,EAAE,UAAU,2CAyI/B;AAED,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,CAAC"}

package/dist/components/input/index.js

@@ -6,33 +6,34 @@ import { FieldTemplate } from "../../services/fieldTemplate";
 import { IconRenderer } from "../../services/iconRenderer";
 import "./style.css";
 /**
- * Input component - used for text input fields with support for labels, validation, icons, and loading states
+ * Input — text input field with label, validation, icons, prefix/suffix, and loading state.
  *
- * @param props - Input component properties
- * @param props.name - Required field name for form handling
- * @param props.label - Optional label text to display above the input
- * @param props.errorMessage - Error message to display below the input
- * @param props.isLoading - Controls loading state with spinner. Default: false
- * @param props.size - Input size. Default: "md"
- * @param props.variant - Visual variant of the input. Default: "solid"
- * @param props.prefix - Text or icon to display at the beginning of the input
- * @param props.suffix - Text or icon to display at the end of the input
- * @param props.showAsterisk - Whether to show asterisk on label for required fields
- * @param props.leftIcon - Optional icon to display on the left side
- * @param props.rightIcon - Optional icon to display on the right side
- * @param props.unShowFieldTemplate - When true, skips `FieldTemplate` structure (wrapper, label and error text) and renders only the checkbox button content.
- * @param props.orientation - Layout direction forwarded to `FieldTemplate`/`FieldWrapper` (`horizontal`, `vertical`, `horizontalReverse`). Default: "horizontalReverse"
+ * Integrates with `useForm` to display validation errors by field name.
  *
- * **...Other valid HTML properties for input element**
+ * @param props.name - Field name for form submission. Required.
+ * @param props.label - Label text displayed above the input.
+ * @param props.errorMessage - Validation error message.
+ * @param props.isLoading - Shows a spinner and disables the input. Default: false
+ * @param props.size - Input size (`md` | `lg`). Default: "md"
+ * @param props.variant - Visual style variant. Default: "solid"
+ * @param props.prefix - Text or icon at the far left (outside the input).
+ * @param props.suffix - Text or icon at the far right (outside the input).
+ * @param props.leftIcon - Lucide icon inside the input on the left.
+ * @param props.rightIcon - Lucide icon inside the input on the right.
+ * @param props.showAsterisk - Appends `*` to the label.
+ * @param props.orientation - Layout direction (`horizontal` | `vertical` | `horizontalReverse`). Default: "horizontal"
+ * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
  *
- * @returns Input JSX element wrapped in FieldGroup with optional label and error
+ * **...Other valid HTML properties for `<input>`**
+ *
+ * @returns Input JSX element wrapped in `FieldTemplate`.
  *
  * @example
  * ```tsx
- * // Basic input
+ * // Basic
  * <Input name="username" placeholder="Enter username" />
  *
- * // Input with label and validation
+ * // With label and validation
  * <Input
  *   name="email"
  *   label="Email Address"
@@ -41,32 +42,11 @@ import "./style.css";
  *   errorMessage="Please enter a valid email"
  * />
  *
- * // Input with icons and loading state
- * <Input
- *   name="search"
- *   label="Search"
- *   leftIcon={SearchIcon}
- *   rightIcon={FilterIcon}
- *   isLoading
- * />
- *
- * // Input with prefix/suffix
- * <Input
- *   name="website"
- *   label="Website"
- *   prefix="https://"
- *   suffix=".com"
- *   variant="outline"
- * />
+ * // With icons and loading state
+ * <Input name="search" label="Search" leftIcon={SearchIcon} isLoading />
  *
- * // Large input with underline variant
- * <Input
- *   name="title"
- *   label="Article Title"
- *   size="lg"
- *   variant="underline"
- *   placeholder="Enter article title"
- * />
+ * // With prefix/suffix
+ * <Input name="website" label="Website" prefix="https://" suffix=".com" variant="outline" />
  * ```
  */
 function Input(props) {

package/dist/components/mapView/index.d.ts

@@ -1,17 +1,61 @@
 import type { HtmlHTMLAttributes, ReactNode } from "react";
 import "./styles.css";
+/** Data for a single map marker. */
 type Coordinate = {
+    /** Latitude of the marker position. */
     lat: number;
+    /** Longitude of the marker position. */
     lng: number;
+    /** Arbitrary data attached to the marker — available in `onMarkerClick`. */
     data?: any;
+    /** Custom React node rendered inside the marker popup on click. */
     popUp?: ReactNode;
 };
 type MapViewProps = {
+    /** Mapbox GL public access token from your Mapbox account. Required. */
     accessToken: string;
+    /** Initial zoom level. @default 18 */
     zoom?: number;
+    /** Single coordinate or array of coordinates to display as markers. */
     coordinates?: Coordinate | Coordinate[];
+    /** Callback fired when the user clicks a marker. Receives the coordinate's data. */
     onMarkerClick?: (coordinate: Coordinate) => void;
 } & HtmlHTMLAttributes<HTMLDivElement>;
+/**
+ * MapView — interactive Mapbox map with optional click-able markers.
+ *
+ * Renders client-side only (via `ClientOnly`). Displays a placeholder icon
+ * when `coordinates` is absent or empty, or before the component hydrates.
+ *
+ * @param props.accessToken - Mapbox GL public access token. Required.
+ * @param props.zoom - Initial zoom level. Default: 18
+ * @param props.coordinates - Marker(s) to display on the map.
+ * @param props.onMarkerClick - Callback fired when a marker is clicked.
+ *
+ * **...Other valid HTML properties for `<div>`**
+ *
+ * @returns MapView JSX element, or a placeholder icon when no coordinates are provided.
+ *
+ * @example
+ * ```tsx
+ * // Single marker
+ * <MapView
+ *   accessToken="pk.your-mapbox-token"
+ *   coordinates={{ lat: -23.5505, lng: -46.6333 }}
+ * />
+ *
+ * // Multiple markers with popup and click handler
+ * <MapView
+ *   accessToken="pk.your-mapbox-token"
+ *   zoom={12}
+ *   coordinates={[
+ *     { lat: -23.55, lng: -46.63, data: { id: 1 }, popUp: <p>Store A</p> },
+ *     { lat: -23.56, lng: -46.64, data: { id: 2 }, popUp: <p>Store B</p> },
+ *   ]}
+ *   onMarkerClick={(coord) => selectStore(coord.data.id)}
+ * />
+ * ```
+ */
 declare function MapView(props: MapViewProps): import("react/jsx-runtime").JSX.Element;
 export { MapView };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/mapView/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/mapView/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3D,OAAO,cAAc,CAAC;AAGtB,KAAK,UAAU,GAAG;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IACxC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CAClD,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;AAcvC,iBAAS,OAAO,CAAC,KAAK,EAAE,YAAY,2CA4BnC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/mapView/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3D,OAAO,cAAc,CAAC;AAGtB,oCAAoC;AACpC,KAAK,UAAU,GAAG;IAChB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IACxC,oFAAoF;IACpF,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CAClD,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;AAcvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,iBAAS,OAAO,CAAC,KAAK,EAAE,YAAY,2CA4BnC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/components/mapView/index.js

@@ -6,6 +6,41 @@ import { ClientOnly } from "../clientOnly";
 function EmptyMap({ className }) {
     return (_jsx("div", { className: "arkynMapViewPinnedEmpty " + className, children: _jsx(MapPinned, {}) }));
 }
+/**
+ * MapView — interactive Mapbox map with optional click-able markers.
+ *
+ * Renders client-side only (via `ClientOnly`). Displays a placeholder icon
+ * when `coordinates` is absent or empty, or before the component hydrates.
+ *
+ * @param props.accessToken - Mapbox GL public access token. Required.
+ * @param props.zoom - Initial zoom level. Default: 18
+ * @param props.coordinates - Marker(s) to display on the map.
+ * @param props.onMarkerClick - Callback fired when a marker is clicked.
+ *
+ * **...Other valid HTML properties for `<div>`**
+ *
+ * @returns MapView JSX element, or a placeholder icon when no coordinates are provided.
+ *
+ * @example
+ * ```tsx
+ * // Single marker
+ * <MapView
+ *   accessToken="pk.your-mapbox-token"
+ *   coordinates={{ lat: -23.5505, lng: -46.6333 }}
+ * />
+ *
+ * // Multiple markers with popup and click handler
+ * <MapView
+ *   accessToken="pk.your-mapbox-token"
+ *   zoom={12}
+ *   coordinates={[
+ *     { lat: -23.55, lng: -46.63, data: { id: 1 }, popUp: <p>Store A</p> },
+ *     { lat: -23.56, lng: -46.64, data: { id: 2 }, popUp: <p>Store B</p> },
+ *   ]}
+ *   onMarkerClick={(coord) => selectStore(coord.data.id)}
+ * />
+ * ```
+ */
 function MapView(props) {
     const { coordinates, zoom = 18, accessToken, className, onMarkerClick, ...rest } = props;
     if (!coordinates)