@arkyn/components 3.0.1-beta.99 → 3.0.2

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

@@ -1,116 +1,92 @@
 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;
-    onChange?: (url?: string) => void;
+    /** 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
+ * 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"
  * />
  * ```
  */
-declare function ImageUpload(props: ImageUploadProps): import("react/jsx-runtime").JSX.Element;
+declare function ImageUpload(props: ImageUploadProps): import("react").JSX.Element;
 export { ImageUpload };
 //# sourceMappingURL=index.d.ts.map

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":"AASA,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,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAqG3C;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;IACvB,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;CAC9D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BA2G3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

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

@@ -7,6 +7,6 @@ type NoFileContentProps = {
     dropImageText: string;
     handleSelectFile: (file: File) => void;
 };
-declare function NoFileContent(props: NoFileContentProps): import("react/jsx-runtime").JSX.Element;
+declare function NoFileContent(props: NoFileContentProps): import("react").JSX.Element;
 export { NoFileContent };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/imageUpload/noFileContent/index.tsx"],"names":[],"mappings":"AAGA,OAAO,cAAc,CAAC;AAEtB,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAkD/C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/imageUpload/noFileContent/index.tsx"],"names":[],"mappings":"AAGA,OAAO,cAAc,CAAC;AAEtB,KAAK,kBAAkB,GAAG;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAkD/C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

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

@@ -1,47 +1,79 @@
-import { LucideIcon } from "lucide-react";
-import { InputHTMLAttributes } from "react";
+import { type LucideIcon } from "lucide-react";
+import { type 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;
-    value?: string | null;
-    defaultValue?: string | null;
+    /** 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
+ * 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"
@@ -50,34 +82,13 @@ 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;
+declare function Input(props: InputProps): import("react").JSX.Element;
 export { Input, type InputProps };
 //# sourceMappingURL=index.d.ts.map

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;AASf,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;IAEpB,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;IAEvB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,iBAAS,KAAK,CAAC,KAAK,EAAE,UAAU,2CAuI/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,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAEN,KAAK,mBAAmB,EAIxB,MAAM,OAAO,CAAC;AAMf,OAAO,aAAa,CAAC;AAErB,KAAK,UAAU,GAAG,IAAI,CACrB,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CACrD,GAAG;IACH,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;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,iBAAS,KAAK,CAAC,KAAK,EAAE,UAAU,+BA0I/B;AAED,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,CAAC"}

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

@@ -1,13 +1,61 @@
-import { HtmlHTMLAttributes } from "react";
+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;
-    draggable?: boolean;
-    coordinates?: {
-        lat: number;
-        lng: 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>;
-declare function MapView(props: MapViewProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * 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.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":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,cAAc,CAAC;AAEtB,KAAK,YAAY,GAAG;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;AAEvC,iBAAS,OAAO,CAAC,KAAK,EAAE,YAAY,2CAgCnC;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;IACjB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAE5E,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,KAAK,YAAY,GAAG;IACnB,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;CACjD,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;AAcvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,iBAAS,OAAO,CAAC,KAAK,EAAE,YAAY,+BA4BnC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

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

@@ -0,0 +1,17 @@
+import "./mapbox.css";
+import { type HtmlHTMLAttributes, type ReactNode } from "react";
+type Coordinate = {
+    lat: number;
+    lng: number;
+    data?: any;
+    popUp?: ReactNode;
+};
+type ClientMapViewProps = {
+    center?: Coordinate;
+    coordinates: Coordinate[];
+    onMarkerClick?: (coordinate: Coordinate) => void;
+    accessToken: string;
+} & HtmlHTMLAttributes<HTMLDivElement>;
+declare function ClientMapView({ center: rawCenter, coordinates, onMarkerClick, accessToken, ...rest }: ClientMapViewProps): import("react").JSX.Element;
+export { ClientMapView };
+//# sourceMappingURL=mapView.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapView.client.d.ts","sourceRoot":"","sources":["../../../src/components/mapView/mapView.client.tsx"],"names":[],"mappings":"AAEA,OAAO,cAAc,CAAC;AACtB,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,SAAS,EAGd,MAAM,OAAO,CAAC;AAEf,KAAK,UAAU,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACzB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;CACpB,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;AAEvC,iBAAS,aAAa,CAAC,EACtB,MAAM,EAAE,SAAS,EACjB,WAAW,EACX,aAAa,EACb,WAAW,EACX,GAAG,IAAI,EACP,EAAE,kBAAkB,+BA8DpB;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

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

@@ -1,105 +1,120 @@
 import { type Replacement } from "@react-input/mask";
-import { LucideIcon } from "lucide-react";
-import { InputHTMLAttributes } from "react";
+import { type LucideIcon } from "lucide-react";
+import { type InputHTMLAttributes } from "react";
 import "./style.css";
 type MaskedInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix" | "name" | "type"> & {
+    /** Field name for form submission. Required. */
     name: string;
+    /**
+     * Mask pattern string. Use the replacement character as an editable placeholder.
+     * Example: `"(__) _____-____"` for a Brazilian mobile phone number.
+     * Required.
+     */
     mask: string;
+    /**
+     * Character or replacement map that marks editable positions in the mask.
+     * - String: `"_"` — every `_` in the mask becomes editable.
+     * - Object: `{ _: /\d/ }` — only accepts digits in those positions.
+     * Required.
+     */
     replacement: string | Replacement;
+    /**
+     * When true, strips mask characters from the underlying value,
+     * keeping only the user-typed characters.
+     */
     separate?: boolean;
+    /** When true, shows the full mask pattern in the input before the user types. */
     showMask?: boolean;
+    /** 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;
+    /**
+     * 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. */
     prefix?: string | LucideIcon;
+    /** Text or icon rendered at the far right, outside the input area. */
     suffix?: string | LucideIcon;
+    /** Displays an asterisk on the label to signal a required field. */
     showAsterisk?: boolean;
+    /** Lucide icon rendered inside the input on the left. */
     leftIcon?: LucideIcon;
+    /** Lucide icon rendered inside the input on the right. */
     rightIcon?: LucideIcon;
-    value?: string | null;
-    defaultValue?: string | null;
+    /** Controlled value. */
+    value?: string;
+    /** Uncontrolled default value. */
+    defaultValue?: string;
 };
 /**
- * MaskedInput component - used for text input fields with input masking support, labels, validation, icons, and loading states
+ * MaskedInput — text input with a configurable mask for structured values (phones, CPF, credit cards, etc.).
  *
- * @param props - MaskedInput component properties
- * @param props.name - Required field name for form handling
- * @param props.mask - Input mask pattern (e.g., "___.___.___-__" for CPF)
- * @param props.replacement - Character or replacement configuration for mask positions
- * @param props.separate - Whether to separate mask characters from input value. Default: undefined
- * @param props.showMask - Whether to show the mask placeholder. Default: undefined
- * @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
+ * Built on `@react-input/mask`. Integrates with `useForm` to display validation errors by field name.
  *
- * **...Other valid HTML properties for input element (except 'type' which is controlled by the mask)**
+ * @param props.name - Field name for form submission. Required.
+ * @param props.mask - Mask pattern string. Required.
+ * @param props.replacement - Character or map that marks editable positions. Required.
+ * @param props.separate - Strips mask chars from the value, keeping only typed characters.
+ * @param props.showMask - Shows the full mask pattern before the user types.
+ * @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.
+ * @param props.suffix - Text or icon at the far right.
+ * @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.
  *
- * @returns MaskedInput JSX element wrapped in FieldGroup with optional label and error
+ * **...Other valid HTML properties for `<input>` (except `type`)**
+ *
+ * @returns MaskedInput JSX element wrapped in `FieldWrapper`.
  *
  * @example
  * ```tsx
- * // Basic masked input for phone number
+ * // Brazilian mobile phone
  * <MaskedInput
  *   name="phone"
  *   mask="(__) _____-____"
  *   replacement={{ _: /\d/ }}
- *   placeholder="(00) 00000-0000"
+ *   label="Phone"
  * />
  *
- * // CPF input with label and validation
+ * // CPF with mask visible and validation
  * <MaskedInput
  *   name="cpf"
  *   label="CPF"
  *   mask="___.___.___-__"
  *   replacement="_"
- *   showAsterisk
- *   errorMessage="Please enter a valid CPF"
  *   showMask
+ *   showAsterisk
+ *   errorMessage="Invalid CPF"
  * />
  *
- * // Credit card input with icons and loading state
+ * // Credit card
  * <MaskedInput
- *   name="creditCard"
+ *   name="card"
  *   label="Credit Card"
  *   mask="____ ____ ____ ____"
  *   replacement={{ _: /\d/ }}
- *   leftIcon={CreditCardIcon}
- *   rightIcon={ShieldIcon}
- *   isLoading
- * />
- *
- * // Date input with prefix/suffix
- * <MaskedInput
- *   name="birthDate"
- *   label="Birth Date"
- *   mask="__/__/____"
- *   replacement="_"
- *   prefix="📅"
- *   variant="outline"
- *   separate
- * />
- *
- * // Large masked input with underline variant
- * <MaskedInput
- *   name="zipCode"
- *   label="ZIP Code"
- *   mask="_____-___"
- *   replacement={{ _: /\d/ }}
- *   size="lg"
- *   variant="underline"
- *   placeholder="00000-000"
+ *   leftIcon={CreditCard}
  * />
  * ```
  */
-declare function MaskedInput(props: MaskedInputProps): import("react/jsx-runtime").JSX.Element;
+declare function MaskedInput(props: MaskedInputProps): import("react").JSX.Element;
 export { MaskedInput };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/maskedInput/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAEL,mBAAmB,EAKpB,MAAM,OAAO,CAAC;AASf,OAAO,aAAa,CAAC;AAErB,KAAK,gBAAgB,GAAG,IAAI,CAC1B,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CACpC,GAAG;IACF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,WAAW,CAAC;IAElC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,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;IAEvB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AASF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAmI3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/maskedInput/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAGN,KAAK,mBAAmB,EAIxB,MAAM,OAAO,CAAC;AASf,OAAO,aAAa,CAAC;AAErB,KAAK,gBAAgB,GAAG,IAAI,CAC3B,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CACnC,GAAG;IACH,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,WAAW,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,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;CACtB,CAAC;AASF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BAoI3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}