@arkyn/components 3.0.1-beta.99 → 3.0.3

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"}

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

@@ -1,78 +1,38 @@
-import { HTMLAttributes } from "react";
+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 component - animated overlay modal for dialogs and content
+ * ModalContainer — animated centered modal rendered over a backdrop overlay.
  *
- * @param props - ModalContainer component properties
- * @param props.isVisible - Controls modal visibility state
- * @param props.makeInvisible - Callback function to hide the modal
+ * Locks body scroll while open. Closes when the overlay is clicked.
+ * Provides context consumed by `ModalHeader` (close button).
  *
- * **...Other valid HTML properties for aside element**
+ * @param props.isVisible - Whether the modal is open. Required.
+ * @param props.makeInvisible - Called when the overlay is clicked. Required.
  *
- * @returns ModalContainer JSX element
+ * **...Other valid HTML `<aside>` properties**
+ *
+ * @returns ModalContainer JSX element.
  *
  * @example
  * ```tsx
- * // Basic modal
  * const [isOpen, setIsOpen] = useState(false);
- * <ModalContainer
- *   isVisible={isOpen}
- *   makeInvisible={() => setIsOpen(false)}
- * >
- *   <p>Modal content</p>
- * </ModalContainer>
  *
- * // Modal with custom styling
- * <ModalContainer
- *   isVisible={isOpen}
- *   makeInvisible={() => setIsOpen(false)}
- *   className="custom-modal"
- * >
- *   <div className="modal-content">
- *     <h2>Confirmation</h2>
- *     <p>Are you sure you want to proceed?</p>
- *   </div>
+ * <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>
- *
- * // Complete modal example
- * function ModalExample() {
- *   const [isModalOpen, setIsModalOpen] = useState(false);
- *
- *   return (
- *     <>
- *       <button onClick={() => setIsModalOpen(true)}>
- *         Open Modal
- *       </button>
- *
- *       <ModalContainer
- *         isVisible={isModalOpen}
- *         makeInvisible={() => setIsModalOpen(false)}
- *       >
- *         <div className="modal-dialog">
- *           <header>
- *             <h2>Modal Title</h2>
- *           </header>
- *
- *           <main>
- *             <p>This is the modal content.</p>
- *           </main>
- *
- *           <footer>
- *             <button onClick={() => setIsModalOpen(false)}>
- *               Close
- *             </button>
- *           </footer>
- *         </div>
- *       </ModalContainer>
- *     </>
- *   );
- * }
  * ```
  */
-declare function ModalContainer(args: ModalContainerProps): import("react/jsx-runtime").JSX.Element;
+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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/modal/modalContainer/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAEH,iBAAS,cAAc,CAAC,IAAI,EAAE,mBAAmB,2CA0ChD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"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

@@ -1,4 +1,4 @@
-import { ReactNode } from "react";
+import { type ReactNode } from "react";
 type ModalContextProps = {
     makeInvisible: () => void;
 };
@@ -6,7 +6,7 @@ type ModalProviderProps = {
     children: ReactNode;
     makeInvisible: () => void;
 };
-declare function ModalProvider(props: ModalProviderProps): import("react/jsx-runtime").JSX.Element;
+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

@@ -1 +1 @@
-{"version":3,"file":"modalContext.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modalContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAc,MAAM,OAAO,CAAC;AAE7D,KAAK,iBAAiB,GAAG;IACvB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAIF,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAM/C;AAED,iBAAS,QAAQ,sBAEhB;AAED,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"modalContext.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modalContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAE3E,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,+BAW/C;AAED,iBAAS,QAAQ,sBAEhB;AAED,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC"}

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

@@ -1,72 +1,39 @@
-import { HTMLAttributes } from "react";
+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 component - footer section for modals with flexible alignment options
+ * ModalFooter — action bar at the bottom of a modal dialog.
  *
- * @param props - ModalFooter component properties
- * @param props.alignment - Content alignment within the footer. Default: "right"
+ * @param props.alignment - Horizontal alignment of children. Default: `"right"`
  *
- * **...Other valid HTML properties for footer element**
+ * **...Other valid HTML `<footer>` properties**
  *
- * @returns ModalFooter JSX element
+ * @returns ModalFooter JSX element.
  *
  * @example
  * ```tsx
- * // Basic footer with right alignment (default)
+ * // Confirm / cancel pattern (right-aligned by default)
  * <ModalFooter>
- *   <button>Cancel</button>
- *   <button>Save</button>
+ *   <Button variant="ghost" onClick={onClose}>Cancel</Button>
+ *   <Button scheme="danger" onClick={onConfirm}>Delete</Button>
  * </ModalFooter>
  *
- * // Left aligned footer
- * <ModalFooter alignment="left">
- *   <button>Delete</button>
- * </ModalFooter>
- *
- * // Center aligned footer
- * <ModalFooter alignment="center">
- *   <button>OK</button>
- * </ModalFooter>
- *
- * // Space between buttons
+ * // Space-between layout (e.g. back / next in a wizard)
  * <ModalFooter alignment="between">
- *   <button>Cancel</button>
- *   <button>Confirm</button>
+ *   <Button variant="outline" onClick={onBack}>Back</Button>
+ *   <Button onClick={onNext}>Next</Button>
  * </ModalFooter>
- *
- * // Space around buttons
- * <ModalFooter alignment="around">
- *   <button>Previous</button>
- *   <button>Next</button>
- *   <button>Finish</button>
- * </ModalFooter>
- *
- * // Complete modal example
- * <ModalContainer isVisible={isOpen} makeInvisible={() => setIsOpen(false)}>
- *   <div className="modal-content">
- *     <header>
- *       <h2>Confirm Action</h2>
- *     </header>
- *
- *     <main>
- *       <p>Are you sure you want to delete this item?</p>
- *     </main>
- *
- *     <ModalFooter alignment="right">
- *       <button onClick={() => setIsOpen(false)}>
- *         Cancel
- *       </button>
- *       <button onClick={handleDelete}>
- *         Delete
- *       </button>
- *     </ModalFooter>
- *   </div>
- * </ModalContainer>
  * ```
  */
-declare function ModalFooter(args: ModalFooterProps): import("react/jsx-runtime").JSX.Element;
+declare function ModalFooter(args: ModalFooterProps): import("react").JSX.Element;
 export { ModalFooter };
 //# sourceMappingURL=index.d.ts.map