@arkyn/components 3.0.3 → 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/index.d.ts

@@ -105,7 +105,7 @@ type RangeDatePickerProps = BaseDatePickerProps & {
  */
 type DatePickerProps = SingleDatePickerProps | RangeDatePickerProps;
 /**
- * DatePicker — date input field with a popover `Calendar`, supporting single-date
+ * 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

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.
  *

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

@@ -5,7 +5,7 @@ type FieldLabelProps = LabelHTMLAttributes<HTMLLabelElement> & {
     showAsterisk?: boolean;
 };
 /**
- * FieldLabel — label for form fields, with an optional required-field asterisk.
+ * FieldLabel, label for form fields, with an optional required-field asterisk.
  *
  * @param props.showAsterisk - Appends `*` to the label. Default: false
  *

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

@@ -10,7 +10,7 @@ type FieldWrapperProps = HTMLAttributes<HTMLElement> & {
     orientation?: "vertical" | "horizontal" | "horizontalReverse";
 };
 /**
- * FieldWrapper — `<section>` container that groups a form field with its label and error message.
+ * FieldWrapper, `<section>` container that groups a form field with its label and error message.
  *
  * @param props.children - Field elements (label, input, error, etc.).
  * @param props.orientation - Layout direction. Default: "vertical"

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

@@ -28,7 +28,7 @@ type FileUploadProps = {
     onChange?: (url?: string) => void;
 };
 /**
- * FileUpload — drag-and-drop file uploader with server upload and file-name preview.
+ * FileUpload, drag-and-drop file uploader with server upload and file-name preview.
  *
  * Sends the file via `fetch` as `multipart/form-data` and stores the returned URL
  * in a hidden `<input>` for form submission.
@@ -43,7 +43,7 @@ type FileUploadProps = {
  * @param props.method - HTTP method. Default: "POST"
  * @param props.fileName - Form-data field name for the file. Default: "file"
  * @param props.fileResponseName - Server response property containing the URL. Default: "url"
- * @param props.onChange - Callback fired after a successful upload — receives the file URL.
+ * @param props.onChange - Callback fired after a successful upload, receives the file URL.
  *
  * @returns FileUpload JSX element wrapped in `FieldWrapper`.
  *

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

@@ -6,7 +6,7 @@ type GoogleAnalyticsProps = {
     showInDevMode?: boolean;
 };
 /**
- * GoogleAnalytics — injects the Google Analytics 4 script into the page client-side.
+ * GoogleAnalytics, injects the Google Analytics 4 script into the page client-side.
  *
  * Renders nothing in development mode unless `showInDevMode` is `true`.
  * Wrapped in `ClientOnly` to avoid SSR errors.

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

@@ -15,7 +15,7 @@ type GoogleTagManagerProps = {
     showInDevMode?: boolean;
 };
 /**
- * GoogleTagManager — injects the GTM `<script>` and `<noscript>` snippets into the page client-side.
+ * GoogleTagManager, injects the GTM `<script>` and `<noscript>` snippets into the page client-side.
  *
  * Renders nothing in development mode unless `showInDevMode` is `true`.
  * Wrapped in `ClientOnly` to avoid SSR errors.

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

@@ -29,7 +29,7 @@ type IconButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"
     scheme?: "primary" | "secondary" | "success" | "warning" | "danger" | "info";
 };
 /**
- * IconButton — compact button that renders a single icon without a text label.
+ * IconButton, compact button that renders a single icon without a text label.
  *
  * Always requires `aria-label` for accessibility.
  *

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

@@ -39,7 +39,7 @@ type ImageUploadProps = {
     orientation?: "horizontal" | "vertical" | "horizontalReverse";
 };
 /**
- * ImageUpload — drag-and-drop image uploader with server upload and image preview.
+ * ImageUpload, drag-and-drop image uploader with server upload and image preview.
  *
  * Sends the file via `fetch` as `multipart/form-data` and stores the returned URL
  * in a hidden `<input>` for form submission.
@@ -55,7 +55,7 @@ type ImageUploadProps = {
  * @param props.method - HTTP method. Default: "POST"
  * @param props.fileName - Form-data field name for the file. Default: "file"
  * @param props.fileResponseName - Server response property containing the URL. Default: "url"
- * @param props.onChange - Callback fired after a successful upload — receives the image URL.
+ * @param props.onChange - Callback fired after a successful upload, receives the image URL.
  * @param props.orientation - Layout direction. Default: "horizontal"
  * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
  *

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

@@ -46,7 +46,7 @@ type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix"
     defaultValue?: string;
 };
 /**
- * Input — text input field with label, validation, icons, prefix/suffix, and loading state.
+ * Input, text input field with label, validation, icons, prefix/suffix, and loading state.
  *
  * Integrates with `useForm` to display validation errors by field name.
  *

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

@@ -6,7 +6,7 @@ type Coordinate = {
     lat: number;
     /** Longitude of the marker position. */
     lng: number;
-    /** Arbitrary data attached to the marker — available in `onMarkerClick`. */
+    /** Arbitrary data attached to the marker, available in `onMarkerClick`. */
     data?: any;
     /** Custom React node rendered inside the marker popup on click. */
     popUp?: ReactNode;
@@ -22,7 +22,7 @@ type MapViewProps = {
     onMarkerClick?: (coordinate: Coordinate) => void;
 } & HtmlHTMLAttributes<HTMLDivElement>;
 /**
- * MapView — interactive Mapbox map with optional click-able markers.
+ * 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.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/mapView/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3D,OAAO,cAAc,CAAC;AAGtB,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"}
+{"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,2EAA2E;IAE3E,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/maskedInput/index.d.ts

@@ -13,8 +13,8 @@ type MaskedInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "pr
     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.
+     * - String: `"_"`, every `_` in the mask becomes editable.
+     * - Object: `{ _: /\d/ }`, only accepts digits in those positions.
      * Required.
      */
     replacement: string | Replacement;
@@ -60,7 +60,7 @@ type MaskedInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "pr
     defaultValue?: string;
 };
 /**
- * MaskedInput — text input with a configurable mask for structured values (phones, CPF, credit cards, etc.).
+ * 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.
  *

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

@@ -7,7 +7,7 @@ type ModalContainerProps = HTMLAttributes<HTMLElement> & {
     makeInvisible: () => void;
 };
 /**
- * ModalContainer — animated centered modal rendered over a backdrop overlay.
+ * 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).

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

@@ -11,7 +11,7 @@ type ModalFooterProps = HTMLAttributes<HTMLElement> & {
     alignment?: "left" | "center" | "right" | "between" | "around";
 };
 /**
- * ModalFooter — action bar at the bottom of a modal dialog.
+ * ModalFooter, action bar at the bottom of a modal dialog.
  *
  * @param props.alignment - Horizontal alignment of children. Default: `"right"`
  *

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

@@ -5,7 +5,7 @@ type ModalHeaderProps = HTMLAttributes<HTMLElement> & {
     showCloseButton?: boolean;
 };
 /**
- * ModalHeader — header section for a `ModalContainer`, with an optional close button.
+ * 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`.

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

@@ -72,7 +72,7 @@ type MultiSelectProps = {
     orientation?: "horizontal" | "vertical" | "horizontalReverse";
 };
 /**
- * MultiSelect — multi-option dropdown with optional search, label, validation, and form integration.
+ * 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.

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

@@ -29,7 +29,7 @@ type PaginationProps = {
     onChange?: (page: number) => void;
 } & Omit<HTMLAttributes<HTMLDivElement>, "onChange">;
 /**
- * Pagination — navigation control for paginated data sets.
+ * Pagination, navigation control for paginated data sets.
  *
  * Renders page number buttons, prev/next arrows, and spread indicators (…)
  * when the page count exceeds the visible range.

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

@@ -51,7 +51,7 @@ type PhoneInputProps = {
     orientation?: "horizontal" | "vertical" | "horizontalReverse";
 };
 /**
- * PhoneInput — phone number field with an integrated country selector and automatic mask formatting.
+ * PhoneInput, phone number field with an integrated country selector and automatic mask formatting.
  *
  * The visible input is masked according to the selected country's phone format.
  * The hidden `<input>` stores a numeric string prefixed with the country dial code for form submission.
@@ -68,7 +68,7 @@ type PhoneInputProps = {
  * @param props.isLoading - Shows loading state and disables interactions. Default: false
  * @param props.defaultValue - Uncontrolled default phone value.
  * @param props.value - Controlled phone value (without country code).
- * @param props.onChange - Callback fired on change — receives numeric string with country code.
+ * @param props.onChange - Callback fired on change, receives numeric string with country code.
  * @param props.defaultCountryIso - ISO code of the initially selected country. Default: "BR"
  * @param props.searchCountryPlaceholder - Placeholder for country search. Default: "Pesquisar país"
  * @param props.notFoundCountryText - Text shown when no country matches. Default: "Nenhum país encontrado"

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/phoneInput/index.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAsB7C,KAAK,eAAe,GAAG;IACtB,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IACtD,qGAAqG;IACrG,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;CAC9D,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,+BA4KzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/phoneInput/index.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAsB7C,KAAK,eAAe,GAAG;IACtB,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IACtD,qGAAqG;IACrG,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;CAC9D,CAAC;AAoBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,+BA4KzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -4,7 +4,7 @@ type OrientationProps = "bottomLeft" | "bottomRight" | "topLeft" | "topRight" |
 type PopoverProps = {
     /** Content rendered inside the floating panel. Required. */
     children: ReactNode;
-    /** Trigger element — clicking it opens the popover. Required. */
+    /** Trigger element, clicking it opens the popover. Required. */
     button: ReactNode;
     /** When true, clicking the popover content also closes it. @default false */
     closeOnClick?: boolean;
@@ -18,7 +18,7 @@ type PopoverProps = {
     className?: string;
 };
 /**
- * Popover — floating panel that appears relative to a trigger element.
+ * Popover, floating panel that appears relative to a trigger element.
  *
  * Clicking outside the popover (or clicking the content when `closeOnClick` is set)
  * dismisses it. Locks body scroll while open.