@arkyn/components 3.0.2 → 3.0.4

package/README.md

@@ -8,22 +8,22 @@ A modern React component library featuring 40+ UI components, smooth animations,
 
 ## ✨ What it solves
 
-Every React/Remix/React Router/Next app ends up rebuilding the same UI primitives — buttons, inputs, modals, drawers, tables, tabs, alerts — with slightly different accessibility, validation, and animation behavior each time. `@arkyn/components` packages a complete, accessible, TypeScript-first set of these primitives (40+ components, plus supporting hooks and providers) so teams can compose screens instead of rebuilding foundations. Components integrate with a shared form-validation context (`FormProvider`/`useForm`), share consistent styling and motion, and cover everything from basic inputs to rich text editing, calendars, maps, and third-party tracking scripts.
+Every React/Remix/React Router/Next app ends up rebuilding the same UI primitives, buttons, inputs, modals, drawers, tables, tabs, alerts, with slightly different accessibility, validation, and animation behavior each time. `@arkyn/components` packages a complete, accessible, TypeScript-first set of these primitives (40+ components, plus supporting hooks and providers) so teams can compose screens instead of rebuilding foundations. Components integrate with a shared form-validation context (`FormProvider`/`useForm`), share consistent styling and motion, and cover everything from basic inputs to rich text editing, calendars, maps, and third-party tracking scripts.
 
 ## 🧩 Features
 
-- 🧱 **Forms & inputs** — `Input`, `Textarea`, `Checkbox`, `Switch`, `Select`, `MultiSelect`, `RadioGroup`/`RadioBox`, `CurrencyInput`, `MaskedInput`, `PhoneInput`, `Slider`, `FieldWrapper`/`FieldLabel`/`FieldError` for labeled, validated fields with consistent layout
-- 📁 **Uploads** — `FileUpload`, `ImageUpload`, and `AudioUpload` with drag-and-drop, server upload, and preview built in
-- 🧭 **Layout & navigation** — `TabContainer`/`TabButton`, `CardTabContainer`/`CardTabButton`, `Pagination`, `Divider`, `Badge`
-- 🪟 **Overlays** — `ModalContainer`/`ModalHeader`/`ModalFooter` + `ModalProvider`/`useModal`, `DrawerContainer`/`DrawerHeader` + `DrawerProvider`/`useDrawer`, `Popover`, `Tooltip`
-- 🔔 **Feedback** — `AlertContainer`/`AlertTitle`/`AlertDescription`/`AlertIcon`/`AlertContent`, `ToastProvider`/`useToast`
-- 📊 **Data display** — `TableContainer`/`TableHeader`/`TableBody`/`TableFooter`/`TableCaption`
-- 📅 **Calendars & media** — `Calendar` (single/range date picking), `FullCalendar` (day/week/month views with events), `AudioPlayer`
-- 🗺️ **Google Places & Maps** — `SearchPlaces`, `PlacesProvider`, and Mapbox-powered `MapView`
-- 📈 **Tracking integrations** — `GoogleAnalytics`, `GoogleTagManager`, `FacebookPixel`, all dev-mode aware
-- ✍️ **Rich text editing** — `RichText` (Slate.js-based WYSIWYG editor) with `toHtml`/`toRichTextValue` conversion services
-- 🪝 **Hooks** — `useForm`, `useModal`, `useDrawer`, `useToast`, `useSlider`, `useHydrated`, `useScopedParams`, `useScrollLock`, `useAutomation`, `useSearchAutomation`
-- 🧑‍💻 **SSR-safe** — `ClientOnly` and `useHydrated` guard against hydration mismatches for browser-only UI
+- 🧱 **Forms & inputs**, `Input`, `Textarea`, `Checkbox`, `Switch`, `Select`, `MultiSelect`, `RadioGroup`/`RadioBox`, `CurrencyInput`, `MaskedInput`, `PhoneInput`, `Slider`, `FieldWrapper`/`FieldLabel`/`FieldError` for labeled, validated fields with consistent layout
+- 📁 **Uploads**, `FileUpload`, `ImageUpload`, and `AudioUpload` with drag-and-drop, server upload, and preview built in
+- 🧭 **Layout & navigation**, `TabContainer`/`TabButton`, `CardTabContainer`/`CardTabButton`, `Pagination`, `Divider`, `Badge`
+- 🪟 **Overlays**, `ModalContainer`/`ModalHeader`/`ModalFooter` + `ModalProvider`/`useModal`, `DrawerContainer`/`DrawerHeader` + `DrawerProvider`/`useDrawer`, `Popover`, `Tooltip`
+- 🔔 **Feedback**, `AlertContainer`/`AlertTitle`/`AlertDescription`/`AlertIcon`/`AlertContent`, `ToastProvider`/`useToast`
+- 📊 **Data display**, `TableContainer`/`TableHeader`/`TableBody`/`TableFooter`/`TableCaption`
+- 📅 **Calendars & media**, `Calendar` (single/range date picking), `FullCalendar` (day/week/month views with events), `AudioPlayer`
+- 🗺️ **Google Places & Maps**, `SearchPlaces`, `PlacesProvider`, and Mapbox-powered `MapView`
+- 📈 **Tracking integrations**, `GoogleAnalytics`, `GoogleTagManager`, `FacebookPixel`, all dev-mode aware
+- ✍️ **Rich text editing**, `RichText` (Slate.js-based WYSIWYG editor) with `toHtml`/`toRichTextValue` conversion services
+- 🪝 **Hooks**, `useForm`, `useModal`, `useDrawer`, `useToast`, `useSlider`, `useHydrated`, `useScopedParams`, `useScrollLock`, `useAutomation`, `useSearchAutomation`
+- 🧑‍💻 **SSR-safe**, `ClientOnly` and `useHydrated` guard against hydration mismatches for browser-only UI
 
 ## 📋 Prerequisites
 
@@ -31,24 +31,24 @@ Every React/Remix/React Router/Next app ends up rebuilding the same UI primitive
 - Always-required peer dependencies:
   - `react >=18.0.0`
   - `react-dom >=18.0.0`
-  - `lucide-react >=1.14.0` — used for icons across most components
+  - `lucide-react >=1.14.0`, used for icons across most components
 
 ### Optional peer dependencies
 
 Only install these if you use the specific component/hook that needs them:
 
-- `mapbox-gl >=3.0.0` — required by `MapView`
-- `is-hotkey >=0.2.0` — required by `RichText`
-- `slate >=0.100.0`, `slate-history >=0.100.0`, `slate-react >=0.100.0` — required by `RichText`
-- `@react-google-maps/api >=2.0.0` — required by `PlacesProvider` and `SearchPlaces`
-- `react-scroll >=1.8.0` — required by `useAutomation`
-- `@react-input/mask >=2.0.0` — required by `MaskedInput` and `PhoneInput`
-- `html-react-parser >=5.0.0` — required by the `toRichTextValue` service
-- `react-hot-toast >=2.0.0` — required by `ToastProvider` / `useToast`
+- `mapbox-gl >=3.0.0`, required by `MapView`
+- `is-hotkey >=0.2.0`, required by `RichText`
+- `slate >=0.100.0`, `slate-history >=0.100.0`, `slate-react >=0.100.0`, required by `RichText`
+- `@react-google-maps/api >=2.0.0`, required by `PlacesProvider` and `SearchPlaces`
+- `react-scroll >=1.8.0`, required by `useAutomation`
+- `@react-input/mask >=2.0.0`, required by `MaskedInput` and `PhoneInput`
+- `html-react-parser >=5.0.0`, required by the `toRichTextValue` service
+- `react-hot-toast >=2.0.0`, required by `ToastProvider` / `useToast`
 
 ## 📦 Installation
 
-> **ESM only.** This package ships as native ES modules with no CommonJS build — use `import`, not `require()`.
+> **ESM only.** This package ships as native ES modules with no CommonJS build, use `import`, not `require()`.
 
 ```bash
 npm install @arkyn/components react react-dom lucide-react
@@ -84,7 +84,7 @@ import { Button } from "@arkyn/components/button";
 import "@arkyn/components/button.css";
 ```
 
-Each `<name>.css` file is self-contained — safe to import on its own without the aggregate `@arkyn/components/styles`. If you use several components, importing the aggregate stylesheet once is usually simpler and avoids any duplicate CSS between per-component files that share internals (e.g. `FileUpload` and `Button`).
+Each `<name>.css` file is self-contained, safe to import on its own without the aggregate `@arkyn/components/styles`. If you use several components, importing the aggregate stylesheet once is usually simpler and avoids any duplicate CSS between per-component files that share internals (e.g. `FileUpload` and `Button`).
 
 ## 🚀 Quick Start
 

package/dist/components/alert/alertContainer/index.d.ts

@@ -3,17 +3,17 @@ import "./styles.css";
 type AlertContainerProps = {
     /**
      * Visual style and semantic meaning.
-     * - `success`: green — operation completed.
-     * - `danger`: red — error or destructive action.
-     * - `warning`: yellow — caution required.
-     * - `info`: blue — informational message.
+     * - `success`: green, operation completed.
+     * - `danger`: red, error or destructive action.
+     * - `warning`: yellow, caution required.
+     * - `info`: blue, informational message.
      */
     scheme: "success" | "danger" | "warning" | "info";
 } & HTMLAttributes<HTMLDivElement>;
 /** @internal Accesses the schema and HTML props of the enclosing `AlertContainer`. */
 declare function useAlertContainer(): AlertContainerProps;
 /**
- * AlertContainer — root wrapper for the Alert component set. Provides schema context to child components.
+ * AlertContainer, root wrapper for the Alert component set. Provides schema context to child components.
  *
  * Automatically detects whether an `AlertTitle` is present among children and adjusts layout:
  * centered when no title, left-aligned when a title is present.
@@ -27,13 +27,13 @@ declare function useAlertContainer(): AlertContainerProps;
  *
  * @example
  * ```tsx
- * // Inline alert — no title, centered layout
+ * // Inline alert, no title, centered layout
  * <AlertContainer scheme="success">
  *   <AlertIcon />
  *   <AlertContent>Your subscription has been activated.</AlertContent>
  * </AlertContainer>
  *
- * // Full alert with title and description — left-aligned layout
+ * // Full alert with title and description, left-aligned layout
  * <AlertContainer scheme="danger">
  *   <AlertIcon />
  *   <AlertContent>

package/dist/components/alert/alertContent/index.d.ts

@@ -2,7 +2,7 @@ import type { HTMLAttributes, JSX } from "react";
 import "./styles.css";
 type AlertContentProps = HTMLAttributes<HTMLDivElement>;
 /**
- * AlertContent — text/content area inside an `AlertContainer`. Wraps `AlertTitle` and `AlertDescription`.
+ * AlertContent, text/content area inside an `AlertContainer`. Wraps `AlertTitle` and `AlertDescription`.
  *
  * Accepts all standard `<div>` HTML attributes.
  *

package/dist/components/alert/alertDescription/index.d.ts

@@ -2,7 +2,7 @@ import type { HTMLAttributes, JSX } from "react";
 import "./styles.css";
 type AlertDescriptionProps = HTMLAttributes<HTMLDivElement>;
 /**
- * AlertDescription — body text for an alert. Place inside `AlertContent`.
+ * AlertDescription, body text for an alert. Place inside `AlertContent`.
  *
  * Accepts all standard `<div>` HTML attributes.
  *

package/dist/components/alert/alertIcon/index.d.ts

@@ -3,7 +3,7 @@ import type { JSX } from "react";
 import "./styles.css";
 type AlertIconProps = LucideProps;
 /**
- * AlertIcon — renders a scheme-appropriate icon from `AlertContainer` context.
+ * AlertIcon, renders a scheme-appropriate icon from `AlertContainer` context.
  *
  * - `success` → `CheckCircle2`
  * - `danger` → `XCircle`

package/dist/components/alert/alertTitle/index.d.ts

@@ -2,7 +2,7 @@ import type { HTMLAttributes, JSX } from "react";
 import "./styles.css";
 type AlertTitleProps = HTMLAttributes<HTMLDivElement>;
 /**
- * AlertTitle — bold heading for an alert. Place inside `AlertContent`.
+ * AlertTitle, bold heading for an alert. Place inside `AlertContent`.
  *
  * Its presence is detected by `AlertContainer` to switch the layout from centered to left-aligned.
  * Accepts all standard `<div>` HTML attributes.

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

@@ -22,7 +22,7 @@ type AudioPlayerProps = Omit<AudioHTMLAttributes<HTMLAudioElement>, "onEnded" |
     onPauseAudio?: (props: AudioInformationProps) => void;
 };
 /**
- * AudioPlayer — play/pause controls, a scrubable progress bar, and elapsed/total time display.
+ * AudioPlayer, play/pause controls, a scrubable progress bar, and elapsed/total time display.
  *
  * @param props.src - Audio file URL. Required.
  * @param props.disabled - Disables controls. Default: false

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

@@ -30,7 +30,7 @@ type AudioUploadProps = {
     defaultValue?: string;
 };
 /**
- * AudioUpload — drag-and-drop audio file uploader with server upload and playback preview.
+ * AudioUpload, drag-and-drop audio file uploader with server upload and playback preview.
  *
  * Sends the file via `fetch` as `multipart/form-data` and stores the returned URL
  * in a hidden `<input>` for form submission.
@@ -41,7 +41,7 @@ type AudioUploadProps = {
  * @param props.fileName - Form-data field name for the file. Default: "file"
  * @param props.method - HTTP method. Default: "POST"
  * @param props.acceptAudio - Accepted MIME types / extensions. Default: "audio/*"
- * @param props.onChange - Callback fired after a successful upload — receives the audio URL.
+ * @param props.onChange - Callback fired after a successful upload, receives the audio URL.
  * @param props.fileResponseName - Server response property containing the URL. Default: "url"
  * @param props.label - Label text displayed above the upload area.
  * @param props.showAsterisk - Appends `*` to the label. Default: false

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

@@ -26,7 +26,7 @@ type BadgeProps = HTMLAttributes<HTMLDivElement> & {
     rightIcon?: LucideIcon;
 };
 /**
- * Badge — displays labels, statuses, and categorization tags.
+ * Badge, displays labels, statuses, and categorization tags.
  *
  * @param props.size - Badge size (`md` | `lg`). Default: "lg"
  * @param props.variant - Visual style variant. Default: "ghost"

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

@@ -31,7 +31,7 @@ type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
     rightIcon?: LucideIcon;
 };
 /**
- * Button — used for user interactions and form submissions.
+ * Button, used for user interactions and form submissions.
  *
  * @param props.isLoading - Shows a spinner and disables the button. Default: false
  * @param props.loadingText - Text displayed beside the spinner when loading.

package/dist/components/cardTab/cardTabButton/index.d.ts

@@ -7,7 +7,7 @@ type CardTabButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "childre
     value: string;
 };
 /**
- * CardTabButton — individual tab button inside a `CardTabContainer`.
+ * CardTabButton, individual tab button inside a `CardTabContainer`.
  *
  * Reads active state and disabled state from `CardTabContainer` context.
  * The button's own `disabled` prop is ORed with the container's `disabled`.

package/dist/components/cardTab/cardTabContainer/index.d.ts

@@ -11,7 +11,7 @@ type CardTabContainerProps = Omit<HTMLAttributes<HTMLElement>, "onClick" | "chil
     onChange?: (index: string) => void;
 };
 /**
- * CardTabContainer — wrapper that manages active state for a group of `CardTabButton` components.
+ * CardTabContainer, wrapper that manages active state for a group of `CardTabButton` components.
  *
  * Renders as a `<nav>` element. Provides context consumed by each `CardTabButton`.
  *

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

@@ -22,7 +22,7 @@ type CheckboxProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "size" | "pre
     checked?: boolean;
     /** Uncontrolled initial checked state. @default false */
     defaultChecked?: boolean;
-    /** Callback fired on toggle — receives the value string (or `""` when unchecked). */
+    /** Callback fired on toggle, receives the value string (or `""` when unchecked). */
     onCheck?: (value: string) => void;
     /**
      * Layout direction forwarded to `FieldTemplate`.
@@ -31,7 +31,7 @@ type CheckboxProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "size" | "pre
     orientation?: "horizontal" | "vertical" | "horizontalReverse";
 };
 /**
- * Checkbox — interactive checkbox input with label, validation, and form integration.
+ * Checkbox, interactive checkbox input with label, validation, and form integration.
  *
  * Stores value in a hidden `<input>` for native form submission.
  * Integrates with `useForm` to display validation errors by field name.
@@ -42,7 +42,7 @@ type CheckboxProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "size" | "pre
  * @param props.value - Value stored when checked. Default: "checked"
  * @param props.checked - Controlled checked state.
  * @param props.defaultChecked - Uncontrolled initial checked state. Default: false
- * @param props.onCheck - Callback fired on toggle — receives value or `""` when unchecked.
+ * @param props.onCheck - Callback fired on toggle, receives value or `""` when unchecked.
  * @param props.errorMessage - Validation error message.
  * @param props.showAsterisk - Appends `*` to the label.
  * @param props.orientation - Layout direction (`horizontal` | `vertical` | `horizontalReverse`). Default: "horizontalReverse"

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/checkbox/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,oBAAoB,EAA2B,MAAM,OAAO,CAAC;AAK3E,OAAO,cAAc,CAAC;AAEtB,KAAK,aAAa,GAAG,IAAI,CACxB,oBAAoB,CAAC,iBAAiB,CAAC,EACrC,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,cAAc,GACd,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,CACX,GAAG;IACH,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;CAC9D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,+BAuErC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/checkbox/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,oBAAoB,EAA2B,MAAM,OAAO,CAAC;AAK3E,OAAO,cAAc,CAAC;AAEtB,KAAK,aAAa,GAAG,IAAI,CACxB,oBAAoB,CAAC,iBAAiB,CAAC,EACrC,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,cAAc,GACd,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,CACX,GAAG;IACH,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oFAAoF;IACpF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;CAC9D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,+BAuErC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/components/clientOnly.d.ts

@@ -1,11 +1,11 @@
 type ClientOnlyProps = {
-    /** Render function — called after hydration on the client. Required. */
+    /** Render function, called after hydration on the client. Required. */
     children(): React.ReactNode;
     /** Content rendered during SSR or before hydration. @default null */
     fallback?: React.ReactNode;
 };
 /**
- * ClientOnly — renders its children only after client-side hydration.
+ * ClientOnly, renders its children only after client-side hydration.
  *
  * Prevents React hydration mismatches for components that rely on browser-only APIs
  * (e.g. `window`, `navigator`, `document`). Uses `useHydrated` internally.

package/dist/components/clientOnly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clientOnly.d.ts","sourceRoot":"","sources":["../../src/components/clientOnly.tsx"],"names":[],"mappings":"AAEA,KAAK,eAAe,GAAG;IACtB,wEAAwE;IACxE,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,6BAGzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"clientOnly.d.ts","sourceRoot":"","sources":["../../src/components/clientOnly.tsx"],"names":[],"mappings":"AAEA,KAAK,eAAe,GAAG;IACtB,uEAAuE;IACvE,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,6BAGzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -62,7 +62,7 @@ type CurrencyInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "
     onChange?: (event: ChangeEvent<HTMLInputElement>, originalValue: string, maskedValue: string) => void;
 };
 /**
- * CurrencyInput — numeric input that automatically formats the displayed value according to a currency locale.
+ * CurrencyInput, numeric input that automatically formats the displayed value according to a currency locale.
  *
  * The raw numeric value is stored in a hidden `<input>` for form submission.
  * Integrates with `useForm` to display validation errors by field name.
@@ -77,7 +77,7 @@ type CurrencyInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "
  * @param props.max - Maximum numeric value allowed. Default: 1_000_000_000
  * @param props.value - Controlled numeric value.
  * @param props.defaultValue - Uncontrolled default numeric value.
- * @param props.onChange - Callback fired on change — receives the event, the raw numeric string, and the formatted string.
+ * @param props.onChange - Callback fired on change, receives the event, the raw numeric string, and the formatted string.
  * @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.

package/dist/components/datePicker/datePickerCalendarContainer/index.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+import "./styles.css";
+type DatePickerCalendarContainerProps = {
+    isFocused: boolean;
+    children: ReactNode;
+};
+declare function DatePickerCalendarContainer(props: DatePickerCalendarContainerProps): import("react").JSX.Element | null;
+export { DatePickerCalendarContainer };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/datePicker/datePickerCalendarContainer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/datePicker/datePickerCalendarContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAIpE,OAAO,cAAc,CAAC;AAEtB,KAAK,gCAAgC,GAAG;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,iBAAS,2BAA2B,CAAC,KAAK,EAAE,gCAAgC,sCA8C3E;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/components/datePicker/datePickerChevron/index.d.ts

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

package/dist/components/datePicker/datePickerChevron/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/datePicker/datePickerChevron/index.tsx"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,KAAK,sBAAsB,GAAG;IAC7B,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,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,sCAqBvD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/components/datePicker/datePickerContainer/index.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from "react";
+import "./styles.css";
+type DatePickerContainerProps = {
+    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 DatePickerContainer(props: DatePickerContainerProps): import("react").JSX.Element;
+export { DatePickerContainer };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/datePicker/datePickerContainer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/datePicker/datePickerContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,wBAAwB,GAAG;IAC/B,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,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,+BA8B3D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/components/datePicker/datePickerContent/index.d.ts

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

package/dist/components/datePicker/datePickerContent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/datePicker/datePickerContent/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,sBAAsB,GAAG;IAC7B,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAClB,CAAC;AAEF,iBAAS,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,+BAIvD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/components/datePicker/datePickerOverlay/index.d.ts

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

package/dist/components/datePicker/datePickerOverlay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/datePicker/datePickerOverlay/index.tsx"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAEtB,KAAK,sBAAsB,GAAG;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF,iBAAS,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,sCAIvD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/components/datePicker/datePickerSpinner/index.d.ts

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

package/dist/components/datePicker/datePickerSpinner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/datePicker/datePickerSpinner/index.tsx"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,KAAK,sBAAsB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,iBAAS,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,sCAWvD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

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

@@ -0,0 +1,155 @@
+import type { LucideIcon } from "lucide-react";
+import { type FocusEvent } from "react";
+type BaseDatePickerProps = {
+    /** Field name for form submission. Required. */
+    name: string;
+    /** Optional HTML id for the underlying hidden input. */
+    id?: string;
+    /** Displays an asterisk on the label to signal a required field. */
+    showAsterisk?: boolean;
+    /** Optional label text displayed above the date picker. */
+    label?: string;
+    /** Validation error message displayed below the date picker. */
+    errorMessage?: string;
+    /** Placeholder text shown when no date is selected. @default "Selecione uma data..." */
+    placeholder?: 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 value visible. @default false */
+    readOnly?: boolean;
+    /** Shows a loading spinner and disables interactions. @default false */
+    isLoading?: boolean;
+    /**
+     * Closes the calendar after a date is picked.
+     * @default true for `single`, `false` for `range`.
+     */
+    closeOnSelect?: boolean;
+    /** Callback fired when the date picker gains focus. */
+    onFocus?: () => void;
+    /** Callback fired when the date picker loses focus. */
+    onBlur?: (e: FocusEvent<HTMLDivElement>) => void;
+    /**
+     * DatePicker 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 date picker area. */
+    prefix?: string | LucideIcon;
+    /** Lucide icon rendered inside the date picker on the left. */
+    leftIcon?: LucideIcon;
+    /** When true, skips `FieldTemplate` wrapper (label and error text). @default false */
+    unShowFieldTemplate?: boolean;
+    /**
+     * Layout direction forwarded to `FieldTemplate`.
+     * @default "vertical"
+     */
+    orientation?: "horizontal" | "vertical" | "horizontalReverse";
+    /**
+     * Visual/behavioral variant forwarded to the internal `Calendar`.
+     * @default "complete"
+     */
+    calendarVariant?: "basic" | "complete";
+};
+/**
+ * Props for DatePicker single-date selection mode.
+ */
+type SingleDatePickerProps = BaseDatePickerProps & {
+    /** Sets single-date selection mode. */
+    type: "single";
+    /** Controlled selected date. */
+    value?: Date;
+    /** Uncontrolled default selected date. */
+    defaultValue?: Date;
+    /** Callback fired when the selected date changes. */
+    onChange?: (date: Date) => void;
+    /** Currently focused calendar view date. */
+    viewValue?: Date;
+    /** Initial focused calendar view date. */
+    defaultViewValue?: Date;
+    /** Callback fired when the calendar view (month/year) changes. */
+    onChangeView?: (date: Date) => void;
+};
+/**
+ * Props for DatePicker range selection mode.
+ */
+type RangeDatePickerProps = BaseDatePickerProps & {
+    /** Sets range selection mode. */
+    type: "range";
+    /** Controlled selected range in `[start, end]` format. */
+    value?: [Date, Date];
+    /** Uncontrolled default range in `[start, end]` format. */
+    defaultValue?: [Date, Date];
+    /** Callback fired when the selected range changes. */
+    onChange?: (date: [Date, Date]) => void;
+    /** Currently focused calendar view date. */
+    viewValue?: Date;
+    /** Initial focused calendar view date. */
+    defaultViewValue?: Date;
+    /** Callback fired when the calendar view (month/year) changes. */
+    onChangeView?: (date: Date) => void;
+    /** Text placed between the start and end dates. @default " até " */
+    rangeSeparator?: string;
+};
+/**
+ * Discriminated union of DatePicker props.
+ */
+type DatePickerProps = SingleDatePickerProps | RangeDatePickerProps;
+/**
+ * DatePicker, date input field with a popover `Calendar`, supporting single-date
+ * (`single`) and range (`range`) selection modes.
+ *
+ * Opens the calendar on click, the same way `Select` opens its options list, flipping
+ * upward or downward depending on the available viewport space so it never renders
+ * off-screen. Integrates with `useForm` to display validation errors by field name.
+ *
+ * @param props.name - Field name for form submission. Required.
+ * @param props.type - Selection mode (`single` | `range`). Required.
+ * @param props.value - Controlled selected date (`single`) or range (`range`).
+ * @param props.defaultValue - Uncontrolled default date or range.
+ * @param props.label - Label text displayed above the date picker.
+ * @param props.placeholder - Placeholder shown when nothing is selected. Default: "Selecione uma data..."
+ * @param props.errorMessage - Validation error message.
+ * @param props.isLoading - Shows a loading spinner and disables interactions. Default: false
+ * @param props.closeOnSelect - Closes the calendar after picking. Default: `true` for `single`, `false` for `range`.
+ * @param props.onChange - Callback fired when the selected date/range changes.
+ * @param props.calendarVariant - Visual/behavioral variant of the internal `Calendar`. Default: "complete"
+ * @param props.size - DatePicker size (`md` | `lg`). Default: "md"
+ * @param props.variant - Visual style variant. Default: "solid"
+ * @param props.orientation - Layout direction. Default: "vertical"
+ * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
+ *
+ * @returns DatePicker JSX element wrapped in `FieldTemplate`.
+ *
+ * @example
+ * ```tsx
+ * // Single date
+ * <DatePicker
+ *   type="single"
+ *   name="birthDate"
+ *   label="Data de nascimento"
+ *   onChange={(date) => console.log("Selected date:", date)}
+ * />
+ *
+ * // Range
+ * <DatePicker
+ *   type="range"
+ *   name="stay"
+ *   label="Período da estadia"
+ *   calendarVariant="basic"
+ *   onChange={([start, end]) => console.log("Range:", start, end)}
+ * />
+ * ```
+ */
+declare function DatePicker(props: DatePickerProps): import("react").JSX.Element;
+export { DatePicker };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/datePicker/index.tsx"],"names":[],"mappings":"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"}

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

@@ -8,7 +8,7 @@ type DividerProps = HTMLAttributes<HTMLDivElement> & {
     orientation?: "horizontal" | "vertical";
 };
 /**
- * Divider — visually separates content sections.
+ * Divider, visually separates content sections.
  *
  * @param props.orientation - Line direction (`horizontal` | `vertical`). Default: "horizontal"
  *

package/dist/components/drawer/drawerContainer/index.d.ts

@@ -9,7 +9,7 @@ type DrawerContainerProps = HTMLAttributes<HTMLElement> & {
     orientation?: "left" | "right";
 };
 /**
- * DrawerContainer — animated slide-in panel rendered over an overlay backdrop.
+ * DrawerContainer, animated slide-in panel rendered over an overlay backdrop.
  *
  * Locks body scroll while open. Closes when the overlay is clicked.
  * Provides context consumed by `DrawerHeader` (close button).

package/dist/components/drawer/drawerHeader/index.d.ts

@@ -5,7 +5,7 @@ type DrawerHeaderProps = HTMLAttributes<HTMLElement> & {
     showCloseButton?: boolean;
 };
 /**
- * DrawerHeader — header section for a `DrawerContainer`, with an optional close button.
+ * DrawerHeader, header section for a `DrawerContainer`, with an optional close button.
  *
  * The close button calls `makeInvisible` from the nearest `DrawerContainer` context.
  * Must be rendered inside a `DrawerContainer`.

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

@@ -26,7 +26,7 @@ type FacebookPixelProps = {
     trackSingleCustom?: [string, any?];
 };
 /**
- * FacebookPixel — injects the Facebook Pixel tracking script client-side.
+ * FacebookPixel, injects the Facebook Pixel tracking script client-side.
  *
  * Renders nothing in development mode unless `showInDevMode` is `true`.
  * Wrapped in `ClientOnly` to avoid SSR errors.

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

@@ -2,7 +2,7 @@ import type { HTMLAttributes } from "react";
 import "./styles.css";
 type FieldErrorProps = HTMLAttributes<HTMLElement>;
 /**
- * FieldError — displays a validation error message below a form field.
+ * FieldError, displays a validation error message below a form field.
  *
  * Renders nothing when `children` is empty or falsy.
  *