@arkyn/components 3.0.1-beta.20 → 3.0.1-beta.200

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

@@ -0,0 +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.Element;
+export { MapView };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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

@@ -0,0 +1,120 @@
+import { type Replacement } from "@react-input/mask";
+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;
+    /** Controlled value. */
+    value?: string;
+    /** Uncontrolled default value. */
+    defaultValue?: string;
+};
+/**
+ * MaskedInput — text input with a configurable mask for structured values (phones, CPF, credit cards, etc.).
+ *
+ * Built on `@react-input/mask`. Integrates with `useForm` to display validation errors by field name.
+ *
+ * @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.
+ *
+ * **...Other valid HTML properties for `<input>` (except `type`)**
+ *
+ * @returns MaskedInput JSX element wrapped in `FieldWrapper`.
+ *
+ * @example
+ * ```tsx
+ * // Brazilian mobile phone
+ * <MaskedInput
+ *   name="phone"
+ *   mask="(__) _____-____"
+ *   replacement={{ _: /\d/ }}
+ *   label="Phone"
+ * />
+ *
+ * // CPF with mask visible and validation
+ * <MaskedInput
+ *   name="cpf"
+ *   label="CPF"
+ *   mask="___.___.___-__"
+ *   replacement="_"
+ *   showMask
+ *   showAsterisk
+ *   errorMessage="Invalid CPF"
+ * />
+ *
+ * // Credit card
+ * <MaskedInput
+ *   name="card"
+ *   label="Credit Card"
+ *   mask="____ ____ ____ ____"
+ *   replacement={{ _: /\d/ }}
+ *   leftIcon={CreditCard}
+ * />
+ * ```
+ */
+declare function MaskedInput(props: MaskedInputProps): import("react").JSX.Element;
+export { MaskedInput };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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"}

package/dist/components/modal/modalContainer/index.d.ts

@@ -0,0 +1,38 @@
+import { type HTMLAttributes } from "react";
+import "./styles.css";
+type ModalContainerProps = HTMLAttributes<HTMLElement> & {
+    /** Controls whether the modal is visible. */
+    isVisible: boolean;
+    /** Callback invoked when the backdrop overlay is clicked. */
+    makeInvisible: () => void;
+};
+/**
+ * ModalContainer — animated centered modal rendered over a backdrop overlay.
+ *
+ * Locks body scroll while open. Closes when the overlay is clicked.
+ * Provides context consumed by `ModalHeader` (close button).
+ *
+ * @param props.isVisible - Whether the modal is open. Required.
+ * @param props.makeInvisible - Called when the overlay is clicked. Required.
+ *
+ * **...Other valid HTML `<aside>` properties**
+ *
+ * @returns ModalContainer JSX element.
+ *
+ * @example
+ * ```tsx
+ * const [isOpen, setIsOpen] = useState(false);
+ *
+ * <ModalContainer isVisible={isOpen} makeInvisible={() => setIsOpen(false)}>
+ *   <ModalHeader><h2>Confirm deletion</h2></ModalHeader>
+ *   <main><p>This action cannot be undone.</p></main>
+ *   <ModalFooter>
+ *     <Button onClick={() => setIsOpen(false)}>Cancel</Button>
+ *     <Button scheme="danger" onClick={handleDelete}>Delete</Button>
+ *   </ModalFooter>
+ * </ModalContainer>
+ * ```
+ */
+declare function ModalContainer(args: ModalContainerProps): import("react").JSX.Element | null;
+export { ModalContainer };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/modal/modalContainer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/modal/modalContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,cAAc,EAGnB,MAAM,OAAO,CAAC;AAIf,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACxD,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,iBAAS,cAAc,CAAC,IAAI,EAAE,mBAAmB,sCAqDhD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/components/modal/modalContext.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from "react";
+type ModalContextProps = {
+    makeInvisible: () => void;
+};
+type ModalProviderProps = {
+    children: ReactNode;
+    makeInvisible: () => void;
+};
+declare function ModalProvider(props: ModalProviderProps): import("react").JSX.Element;
+declare function useModal(): ModalContextProps;
+export { ModalProvider, useModal };
+//# sourceMappingURL=modalContext.d.ts.map

package/dist/components/modal/modalContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalContext.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modalContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AAElE,KAAK,iBAAiB,GAAG;IACxB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACzB,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAIF,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAM/C;AAED,iBAAS,QAAQ,sBAEhB;AAED,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC"}

package/dist/components/modal/modalFooter/index.d.ts

@@ -0,0 +1,39 @@
+import type { HTMLAttributes } from "react";
+import "./styles.css";
+type ModalFooterProps = HTMLAttributes<HTMLElement> & {
+    /**
+     * Horizontal alignment of footer content.
+     * - `left` / `center` / `right`: flex-start, center, flex-end.
+     * - `between`: space-between.
+     * - `around`: space-around.
+     * @default "right"
+     */
+    alignment?: "left" | "center" | "right" | "between" | "around";
+};
+/**
+ * ModalFooter — action bar at the bottom of a modal dialog.
+ *
+ * @param props.alignment - Horizontal alignment of children. Default: `"right"`
+ *
+ * **...Other valid HTML `<footer>` properties**
+ *
+ * @returns ModalFooter JSX element.
+ *
+ * @example
+ * ```tsx
+ * // Confirm / cancel pattern (right-aligned by default)
+ * <ModalFooter>
+ *   <Button variant="ghost" onClick={onClose}>Cancel</Button>
+ *   <Button scheme="danger" onClick={onConfirm}>Delete</Button>
+ * </ModalFooter>
+ *
+ * // Space-between layout (e.g. back / next in a wizard)
+ * <ModalFooter alignment="between">
+ *   <Button variant="outline" onClick={onBack}>Back</Button>
+ *   <Button onClick={onNext}>Next</Button>
+ * </ModalFooter>
+ * ```
+ */
+declare function ModalFooter(args: ModalFooterProps): import("react").JSX.Element;
+export { ModalFooter };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/modal/modalFooter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/modal/modalFooter/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,cAAc,CAAC;AAEtB,KAAK,gBAAgB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACrD;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iBAAS,WAAW,CAAC,IAAI,EAAE,gBAAgB,+BAK1C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/modal/modalHeader/index.d.ts

@@ -0,0 +1,32 @@
+import type { HTMLAttributes } from "react";
+import "./styles.css";
+type ModalHeaderProps = HTMLAttributes<HTMLElement> & {
+    /** Whether to render the X close button. @default true */
+    showCloseButton?: boolean;
+};
+/**
+ * ModalHeader — header section for a `ModalContainer`, with an optional close button.
+ *
+ * The close button calls `makeInvisible` from the nearest `ModalContainer` context.
+ * Must be rendered inside a `ModalContainer`.
+ *
+ * @param props.showCloseButton - Renders the X close button. Default: true
+ *
+ * **...Other valid HTML `<header>` properties**
+ *
+ * @returns ModalHeader JSX element.
+ *
+ * @example
+ * ```tsx
+ * <ModalContainer isVisible={isOpen} makeInvisible={() => setIsOpen(false)}>
+ *   <ModalHeader>
+ *     <h2>Edit profile</h2>
+ *   </ModalHeader>
+ *   <main>...</main>
+ *   <ModalFooter><Button onClick={onSave}>Save</Button></ModalFooter>
+ * </ModalContainer>
+ * ```
+ */
+declare function ModalHeader(args: ModalHeaderProps): import("react").JSX.Element;
+export { ModalHeader };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/modal/modalHeader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/modal/modalHeader/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,cAAc,CAAC;AAEtB,KAAK,gBAAgB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACrD,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,iBAAS,WAAW,CAAC,IAAI,EAAE,gBAAgB,+BA2B1C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

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

@@ -0,0 +1,134 @@
+import type { LucideIcon } from "lucide-react";
+import { type FocusEvent } from "react";
+type MultiSelectProps = {
+    /** Field name for form submission. Required. */
+    name: string;
+    /** Array of selectable options. Required. */
+    options: {
+        label: string;
+        value: string;
+    }[];
+    /** Optional HTML id for the underlying hidden input. */
+    id?: string;
+    /** Controlled array of selected values. */
+    value?: string[];
+    /** Uncontrolled default array of selected values. @default [] */
+    defaultValue?: string[];
+    /** Displays an asterisk on the label to signal a required field. */
+    showAsterisk?: boolean;
+    /** Optional label text displayed above the multiselect. */
+    label?: string;
+    /** Validation error message displayed below the multiselect. */
+    errorMessage?: string;
+    /** Placeholder text shown when no options are selected. @default "Selecione..." */
+    placeholder?: string;
+    /** Text shown when no options match the search query. @default "Sem opções disponíveis" */
+    notFoundText?: string;
+    /** Additional CSS class applied to the wrapper element. */
+    className?: string;
+    /** Disables all interactions. @default false */
+    disabled?: boolean;
+    /** Prevents value changes while keeping the current selection visible. @default false */
+    readOnly?: boolean;
+    /** Shows a loading spinner and disables interactions. @default false */
+    isLoading?: boolean;
+    /** Enables search/filter within the dropdown. @default false */
+    isSearchable?: boolean;
+    /** Closes the dropdown after an option is selected or deselected. @default false */
+    closeOnSelect?: boolean;
+    /** Callback fired when the search query changes. Use for async option loading. */
+    onSearch?: (value: string) => void;
+    /** Callback fired when the selected values array changes. */
+    onChange?: (value: string[]) => void;
+    /** Callback fired when the multiselect gains focus. */
+    onFocus?: () => void;
+    /** Callback fired when the multiselect loses focus. */
+    onBlur?: (e: FocusEvent<HTMLDivElement>) => void;
+    /**
+     * MultiSelect 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 select area. */
+    prefix?: string | LucideIcon;
+    /** Lucide icon rendered inside the select on the left. */
+    leftIcon?: LucideIcon;
+    /** Maximum height (in px) of the options dropdown. */
+    optionMaxHeight?: number;
+    /** When true, skips `FieldTemplate` wrapper (label and error text). @default false */
+    unShowFieldTemplate?: boolean;
+    /**
+     * Layout direction forwarded to `FieldTemplate`.
+     * @default "horizontal"
+     */
+    orientation?: "horizontal" | "vertical" | "horizontalReverse";
+};
+/**
+ * MultiSelect — multi-option dropdown with optional search, label, validation, and form integration.
+ *
+ * Selected values are stored as a JSON array in a hidden `<input>` for form submission.
+ * Integrates with `useForm` to display validation errors by field name.
+ *
+ * @param props.name - Field name for form submission. Required.
+ * @param props.options - Array of selectable options (`{ label, value }`). Required.
+ * @param props.value - Controlled array of selected values.
+ * @param props.defaultValue - Uncontrolled default selection. Default: []
+ * @param props.label - Label text displayed above the multiselect.
+ * @param props.placeholder - Placeholder shown when nothing is selected. Default: "Selecione..."
+ * @param props.errorMessage - Validation error message.
+ * @param props.isSearchable - Enables search/filter within the dropdown. Default: false
+ * @param props.isLoading - Shows a loading spinner and disables interactions. Default: false
+ * @param props.closeOnSelect - Closes the dropdown after toggling an option. Default: false
+ * @param props.onChange - Callback fired when the selection changes.
+ * @param props.onSearch - Callback fired when the search query changes.
+ * @param props.size - MultiSelect size (`md` | `lg`). Default: "md"
+ * @param props.variant - Visual style variant. Default: "solid"
+ * @param props.orientation - Layout direction. Default: "horizontal"
+ * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
+ *
+ * @returns MultiSelect JSX element wrapped in `FieldTemplate`.
+ *
+ * @example
+ * ```tsx
+ * // Basic
+ * <MultiSelect
+ *   name="categories"
+ *   options={[
+ *     { label: "Technology", value: "tech" },
+ *     { label: "Design", value: "design" },
+ *   ]}
+ * />
+ *
+ * // With label, validation, and searchable
+ * <MultiSelect
+ *   name="skills"
+ *   label="Skills"
+ *   showAsterisk
+ *   isSearchable
+ *   options={skillOptions}
+ *   errorMessage={errors.skills}
+ * />
+ *
+ * // Controlled with async search
+ * <MultiSelect
+ *   name="tags"
+ *   label="Tags"
+ *   value={selectedTags}
+ *   onChange={setSelectedTags}
+ *   onSearch={fetchTagOptions}
+ *   isLoading={isLoadingTags}
+ *   options={tagOptions}
+ * />
+ * ```
+ */
+declare function MultiSelect(props: MultiSelectProps): import("react").JSX.Element;
+export { MultiSelect };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/multiSelect/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,KAAK,UAAU,EAA2B,MAAM,OAAO,CAAC;AAejE,KAAK,gBAAgB,GAAG;IACvB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,wDAAwD;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACrC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,uDAAuD;IACvD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACjD;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;CAC9D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BA8K3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/multiSelect/multiSelectChevron/index.d.ts

@@ -0,0 +1,11 @@
+import "./styles.css";
+type MultiSelectChevronProps = {
+    isLoading: boolean;
+    iconSize: number;
+    disabled: boolean;
+    readOnly: boolean;
+    isFocused: boolean;
+};
+declare function MultiSelectChevron(props: MultiSelectChevronProps): import("react").JSX.Element | null;
+export { MultiSelectChevron };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multiSelect/multiSelectChevron/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/multiSelect/multiSelectChevron/index.tsx"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,KAAK,uBAAuB,GAAG;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,iBAAS,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,sCAqBzD;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/components/multiSelect/multiSelectContainer/index.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from "react";
+import "./styles.css";
+type MultiSelectContainerProps = {
+    children: ReactNode;
+    handleContainerFocus: () => void;
+    prefixExists: boolean;
+    isError: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+    isLoading: boolean;
+    isFocused: boolean;
+    className?: string;
+    id: string;
+    variant: "solid" | "outline" | "underline";
+    size: "md" | "lg";
+};
+declare function MultiSelectContainer(props: MultiSelectContainerProps): import("react").JSX.Element;
+export { MultiSelectContainer };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multiSelect/multiSelectContainer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/multiSelect/multiSelectContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,yBAAyB,GAAG;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3C,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAClB,CAAC;AAEF,iBAAS,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,+BA8B7D;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/components/multiSelect/multiSelectContent/index.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+import "./styles.css";
+type MultiSelectContentProps = {
+    children: ReactNode;
+    size: "md" | "lg";
+};
+declare function MultiSelectContent(props: MultiSelectContentProps): import("react").JSX.Element;
+export { MultiSelectContent };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multiSelect/multiSelectContent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/multiSelect/multiSelectContent/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,uBAAuB,GAAG;IAC9B,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAClB,CAAC;AAEF,iBAAS,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,+BAIzD;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/components/multiSelect/multiSelectMark/index.d.ts

@@ -0,0 +1,10 @@
+import "./styles.css";
+type MultiSelectMarkProps = {
+    label: string;
+    disabled: boolean;
+    value: string;
+    handleChangeValue: (value: string) => void;
+};
+declare function MultiSelectMark(props: MultiSelectMarkProps): import("react").JSX.Element;
+export { MultiSelectMark };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multiSelect/multiSelectMark/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/multiSelect/multiSelectMark/index.tsx"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,KAAK,oBAAoB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,iBAAS,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAmBnD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/components/multiSelect/multiSelectOption/index.d.ts

@@ -0,0 +1,11 @@
+import "./styles.css";
+type MultiSelectOptionProps = {
+    value: string;
+    label: string;
+    size: "md" | "lg";
+    optionHasSelected: (value: string) => boolean;
+    handleChangeValue: (value: string) => void;
+};
+declare function MultiSelectOption(props: MultiSelectOptionProps): import("react").JSX.Element;
+export { MultiSelectOption };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multiSelect/multiSelectOption/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/multiSelect/multiSelectOption/index.tsx"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,KAAK,sBAAsB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,iBAAS,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,+BAWvD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/components/multiSelect/multiSelectOptionsContainer/index.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from "react";
+import "./styles.css";
+type MultiSelectOptionsContainerProps = {
+    isFocused: boolean;
+    isSearchable: boolean;
+    children: ReactNode;
+    search: string;
+    onSearch: (value: string) => void;
+};
+declare function MultiSelectOptionsContainer(props: MultiSelectOptionsContainerProps): import("react").JSX.Element | null;
+export { MultiSelectOptionsContainer };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multiSelect/multiSelectOptionsContainer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/multiSelect/multiSelectOptionsContainer/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,SAAS,EAId,MAAM,OAAO,CAAC;AAKf,OAAO,cAAc,CAAC;AAEtB,KAAK,gCAAgC,GAAG;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,iBAAS,2BAA2B,CAAC,KAAK,EAAE,gCAAgC,sCA8D3E;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/components/multiSelect/multiSelectOverlay/index.d.ts

@@ -0,0 +1,8 @@
+import "./styles.css";
+type MultiSelectOverlayProps = {
+    isFocused: boolean;
+    handleBlur: () => void;
+};
+declare function MultiSelectOverlay(props: MultiSelectOverlayProps): import("react").JSX.Element | null;
+export { MultiSelectOverlay };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multiSelect/multiSelectOverlay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/multiSelect/multiSelectOverlay/index.tsx"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAEtB,KAAK,uBAAuB,GAAG;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF,iBAAS,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,sCAIzD;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/components/multiSelect/multiSelectSpinner/index.d.ts

@@ -0,0 +1,8 @@
+import "./styles.css";
+type MultiSelectSpinnerProps = {
+    iconSize: number;
+    isLoading: boolean;
+};
+declare function MultiSelectSpinner(props: MultiSelectSpinnerProps): import("react").JSX.Element | null;
+export { MultiSelectSpinner };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/multiSelect/multiSelectSpinner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/multiSelect/multiSelectSpinner/index.tsx"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,KAAK,uBAAuB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,iBAAS,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,sCAWzD;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/components/pagination/chevronButton/index.d.ts

@@ -0,0 +1,9 @@
+import "./styles.css";
+type ChevronButtonProps = {
+    orientation: "left" | "right";
+    disabled: boolean;
+    handlePageChange: () => void;
+};
+declare function ChevronButton(props: ChevronButtonProps): import("react").JSX.Element;
+export { ChevronButton };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/pagination/chevronButton/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/pagination/chevronButton/index.tsx"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,KAAK,kBAAkB,GAAG;IACzB,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC7B,CAAC;AAEF,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAc/C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}