@arkyn/components 3.0.1-beta.170 → 3.0.1-beta.173

package/dist/components/calendar/calendarTableTd/index.d.ts

@@ -0,0 +1,11 @@
+import "./styles.css";
+type CalendarTableTdProps = {
+    day: number;
+    month: number;
+    year: number;
+    dayType: "checkedDay" | "middleDay" | "uncheckedDay";
+    dayOwner: "previous" | "current" | "next";
+};
+declare function CalendarTableTd(props: CalendarTableTdProps): import("react").JSX.Element;
+export { CalendarTableTd };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/calendar/calendarTableTd/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/calendar/calendarTableTd/index.tsx"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,KAAK,oBAAoB,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;IACrD,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;CAC1C,CAAC;AAEF,iBAAS,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAwBnD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

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

@@ -0,0 +1,100 @@
+/**
+ * Props for Calendar single-date selection mode.
+ */
+type SingleCalendarProps = {
+    /** Sets single-date selection mode. */
+    type: "single";
+    /**
+     * Defines the visual/behavioral variant.
+     * - `basic`: simplified header.
+     * - `complete`: full navigation experience.
+     *
+     * @default "complete"
+     */
+    variant?: "basic" | "complete";
+    /** Currently selected date. */
+    value?: Date;
+    /** Initial selected date. */
+    defaultValue?: Date;
+    /** Callback fired when the selected date changes. */
+    onChange?: (date: Date) => void;
+    /** Currently focused view date. */
+    viewValue?: Date;
+    /** Initial focused view date. */
+    defaultViewValue?: Date;
+    /** Callback fired when the view (month/year) changes. */
+    onChangeView?: (date: Date) => void;
+};
+/**
+ * Props for Calendar range selection mode.
+ */
+type RangeCalendarProps = {
+    /** Sets range selection mode. */
+    type: "range";
+    /**
+     * Defines the visual/behavioral variant.
+     * - `basic`: simplified header.
+     * - `complete`: full navigation experience.
+     *
+     * @default "complete"
+     */
+    variant?: "basic" | "complete";
+    /** Currently selected range in `[start, end]` format. */
+    value?: [Date, Date];
+    /** Initial selected range in `[start, end]` format. */
+    defaultValue?: [Date, Date];
+    /** Callback fired when the selected range changes. */
+    onChange?: (date: [Date, Date]) => void;
+    /** Currently focused view date. */
+    viewValue?: Date;
+    /** Initial focused view date. */
+    defaultViewValue?: Date;
+    /** Callback fired when the view (month/year) changes. */
+    onChangeView?: (date: Date) => void;
+};
+/**
+ * Discriminated union of Calendar props.
+ */
+type CalendarProps = SingleCalendarProps | RangeCalendarProps;
+/**
+ * Reusable calendar component with support for two selection modes:
+ * single date (`single`) and range (`range`).
+ *
+ * The component encapsulates calendar state and navigation rules through
+ * `CalendarProvider`, exposing a simple API for forms, filters,
+ * and scheduling flows.
+ *
+ * @param props Calendar properties (`single` or `range` mode).
+ * @returns Calendar UI structure with header and date grid.
+ *
+ * @example
+ * // Single-date selection
+ * <Calendar
+ *   type="single"
+ *   variant="complete"
+ *   defaultValue={new Date()}
+ *   onChange={(date) => {
+ *     console.log("Selected date:", date);
+ *   }}
+ *   onChangeView={(viewDate) => {
+ *     console.log("Current view:", viewDate);
+ *   }}
+ * />
+ *
+ * @example
+ * // Range selection
+ * <Calendar
+ *   type="range"
+ *   variant="basic"
+ *   defaultValue={[new Date(2026, 5, 1), new Date(2026, 5, 15)]}
+ *   onChange={([start, end]) => {
+ *     console.log("Range:", start, end);
+ *   }}
+ *   onChangeView={(viewDate) => {
+ *     console.log("Focused month:", viewDate);
+ *   }}
+ * />
+ */
+declare function Calendar(props: CalendarProps): import("react").JSX.Element;
+export { Calendar };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/calendar/index.tsx"],"names":[],"mappings":"AAOA;;GAEG;AACH,KAAK,mBAAmB,GAAG;IAC1B,uCAAuC;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC/B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,6BAA6B;IAC7B,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAChC,mCAAmC;IACnC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,IAAI,CAAC;IACxB,yDAAyD;IACzD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,KAAK,kBAAkB,GAAG;IACzB,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC/B,yDAAyD;IACzD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrB,uDAAuD;IACvD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;IACxC,mCAAmC;IACnC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,IAAI,CAAC;IACxB,yDAAyD;IACzD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,KAAK,aAAa,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,+BA4CrC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

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

@@ -0,0 +1,34 @@
+import type { ButtonHTMLAttributes, ReactNode } from "react";
+import "./styles.css";
+type CardTabButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "value" | "type"> & {
+    /** Content displayed inside the tab button. */
+    children: ReactNode;
+    /** Unique identifier for this tab; matched against the container's active value. */
+    value: string;
+};
+/**
+ * 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`.
+ *
+ * @param props.children - Tab label content. Required.
+ * @param props.value - Tab identifier. Required.
+ * @param props.disabled - Disables this tab individually (container can also disable all tabs).
+ *
+ * **...Other valid HTML `<button>` properties except `type`**
+ *
+ * @returns CardTabButton JSX element.
+ *
+ * @example
+ * ```tsx
+ * <CardTabContainer defaultValue="details" onChange={setTab}>
+ *   <CardTabButton value="details">Details</CardTabButton>
+ *   <CardTabButton value="history">History</CardTabButton>
+ *   <CardTabButton value="settings" disabled>Settings</CardTabButton>
+ * </CardTabContainer>
+ * ```
+ */
+declare function CardTabButton(props: CardTabButtonProps): import("react").JSX.Element;
+export { CardTabButton };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/cardTab/cardTabButton/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAc,SAAS,EAAE,MAAM,OAAO,CAAC;AAGzE,OAAO,cAAc,CAAC;AAEtB,KAAK,kBAAkB,GAAG,IAAI,CAC7B,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,UAAU,GAAG,OAAO,GAAG,MAAM,CAC7B,GAAG;IACH,+CAA+C;IAC/C,QAAQ,EAAE,SAAS,CAAC;IACpB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAkC/C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

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

@@ -0,0 +1,41 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+import "./styles.css";
+type CardTabContainerProps = Omit<HTMLAttributes<HTMLElement>, "onClick" | "children" | "ref" | "onChange"> & {
+    /** `CardTabButton` components to render as tabs. Required. */
+    children: ReactNode;
+    /** Disables all tab buttons at once. @default false */
+    disabled?: boolean;
+    /** Initially selected tab value. */
+    defaultValue?: string;
+    /** Callback fired when the active tab changes, receiving the new value. */
+    onChange?: (index: string) => void;
+};
+/**
+ * CardTabContainer — wrapper that manages active state for a group of `CardTabButton` components.
+ *
+ * Renders as a `<nav>` element. Provides context consumed by each `CardTabButton`.
+ *
+ * @param props.children - `CardTabButton` elements. Required.
+ * @param props.defaultValue - Initially selected tab value.
+ * @param props.disabled - Disables all buttons. Default: false
+ * @param props.onChange - Called with the new value whenever the active tab changes.
+ *
+ * **...Other valid HTML `<nav>` properties**
+ *
+ * @returns CardTabContainer JSX element.
+ *
+ * @example
+ * ```tsx
+ * <CardTabContainer defaultValue="overview" onChange={setActiveTab}>
+ *   <CardTabButton value="overview">Overview</CardTabButton>
+ *   <CardTabButton value="analytics">Analytics</CardTabButton>
+ *   <CardTabButton value="settings">Settings</CardTabButton>
+ * </CardTabContainer>
+ *
+ * {activeTab === 'overview' && <OverviewPanel />}
+ * {activeTab === 'analytics' && <AnalyticsPanel />}
+ * ```
+ */
+declare function CardTabContainer(props: CardTabContainerProps): import("react").JSX.Element;
+export { CardTabContainer };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/cardTab/cardTabContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAGtE,OAAO,cAAc,CAAC;AAEtB,KAAK,qBAAqB,GAAG,IAAI,CAChC,cAAc,CAAC,WAAW,CAAC,EAC3B,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,CAC3C,GAAG;IACH,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,CAAC;IACpB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,+BA8BrD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/cardTab/cardTabContext.d.ts

@@ -0,0 +1,16 @@
+import { type ReactNode } from "react";
+type CardTabContextProps = {
+    disabled: boolean;
+    currentTab: string;
+    changeCurrentTab: (tab: string) => void;
+};
+type CardTabProviderProps = {
+    children: ReactNode;
+    disabled: boolean;
+    currentTab: string;
+    changeCurrentTab: (tab: string) => void;
+};
+declare function useCardTab(): CardTabContextProps;
+declare function CardTabProvider(props: CardTabProviderProps): import("react").JSX.Element;
+export { CardTabProvider, useCardTab };
+//# sourceMappingURL=cardTabContext.d.ts.map

package/dist/components/cardTab/cardTabContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardTabContext.d.ts","sourceRoot":"","sources":["../../../src/components/cardTab/cardTabContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AAElE,KAAK,mBAAmB,GAAG;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AAIF,iBAAS,UAAU,wBAElB;AAED,iBAAS,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAMnD;AAED,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC"}

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

@@ -0,0 +1,80 @@
+import { type ButtonHTMLAttributes } from "react";
+import "./styles.css";
+type CheckboxProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "size" | "prefix" | "type" | "name" | "defaultValue" | "value" | "onChange" | "onSelect" | "onClick"> & {
+    /** Optional label text displayed beside the checkbox. */
+    label?: string;
+    /** Displays an asterisk on the label to signal a required field. */
+    showAsterisk?: boolean;
+    /** When true, skips `FieldTemplate` wrapper (label and error text). @default false */
+    unShowFieldTemplate?: boolean;
+    /** Validation error message displayed below the checkbox. */
+    errorMessage?: string;
+    /**
+     * Checkbox size.
+     * @default "md"
+     */
+    size?: "md" | "lg" | "sm";
+    /** Field name for form submission. Required. */
+    name: string;
+    /** Value stored in the hidden input when checked. @default "checked" */
+    value?: string;
+    /** Controlled checked state. */
+    checked?: boolean;
+    /** Uncontrolled initial checked state. @default false */
+    defaultChecked?: boolean;
+    /** Callback fired on toggle — receives the value string (or `""` when unchecked). */
+    onCheck?: (value: string) => void;
+    /**
+     * Layout direction forwarded to `FieldTemplate`.
+     * @default "horizontalReverse"
+     */
+    orientation?: "horizontal" | "vertical" | "horizontalReverse";
+};
+/**
+ * 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.
+ *
+ * @param props.name - Field name for form submission. Required.
+ * @param props.label - Label text displayed beside the checkbox.
+ * @param props.size - Checkbox size (`sm` | `md` | `lg`). Default: "md"
+ * @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.errorMessage - Validation error message.
+ * @param props.showAsterisk - Appends `*` to the label.
+ * @param props.orientation - Layout direction (`horizontal` | `vertical` | `horizontalReverse`). Default: "horizontalReverse"
+ * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
+ *
+ * **...Other valid HTML properties for `<button>` (except `type`, `name`, `defaultValue`, `value`, `onChange`, `onSelect`, `onClick`)**
+ *
+ * @returns Checkbox JSX element wrapped in `FieldTemplate`.
+ *
+ * @example
+ * ```tsx
+ * // Basic
+ * <Checkbox name="terms" label="I agree to the terms and conditions" />
+ *
+ * // With custom value and error
+ * <Checkbox
+ *   name="newsletter"
+ *   label="Subscribe to newsletter"
+ *   value="subscribed"
+ *   errorMessage={errors.newsletter}
+ * />
+ *
+ * // Controlled
+ * <Checkbox
+ *   name="premium"
+ *   label="Enable premium features"
+ *   size="lg"
+ *   checked={isPremium}
+ *   onCheck={(v) => setIsPremium(!!v)}
+ * />
+ * ```
+ */
+declare function Checkbox(props: CheckboxProps): import("react").JSX.Element;
+export { Checkbox };
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/components/clientOnly.d.ts

@@ -0,0 +1,33 @@
+type ClientOnlyProps = {
+    /** 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.
+ *
+ * Prevents React hydration mismatches for components that rely on browser-only APIs
+ * (e.g. `window`, `navigator`, `document`). Uses `useHydrated` internally.
+ *
+ * @param props.children - Render function executed after hydration. Required.
+ * @param props.fallback - Content shown during SSR / before hydration. Default: null
+ *
+ * @returns `children()` after hydration, otherwise `fallback`.
+ *
+ * @example
+ * ```tsx
+ * // With a skeleton fallback
+ * <ClientOnly fallback={<Skeleton />}>
+ *   {() => <InteractiveWidget />}
+ * </ClientOnly>
+ *
+ * // Using browser APIs safely
+ * <ClientOnly fallback={<p>Loading...</p>}>
+ *   {() => <p>Current time: {new Date().toLocaleString()}</p>}
+ * </ClientOnly>
+ * ```
+ */
+declare function ClientOnly(props: ClientOnlyProps): import("react").ReactNode;
+export { ClientOnly };
+//# sourceMappingURL=clientOnly.d.ts.map

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

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

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

@@ -0,0 +1,120 @@
+import { type LucideIcon } from "lucide-react";
+import { type ChangeEvent, type InputHTMLAttributes } from "react";
+import "./style.css";
+type Locale = "USD" | "EUR" | "JPY" | "GBP" | "AUD" | "CAD" | "CHF" | "CNY" | "SEK" | "NZD" | "BRL" | "INR" | "RUB" | "ZAR" | "MXN" | "SGD" | "HKD" | "NOK" | "KRW" | "TRY" | "IDR" | "THB";
+type CurrencyInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix" | "name" | "type" | "max" | "defaultValue" | "value" | "onChange" | "placeholder"> & {
+    /** Field name for form submission. Required. */
+    name: string;
+    /**
+     * Currency locale used to format the displayed value.
+     * Supported: `"USD"` | `"EUR"` | `"BRL"` | `"JPY"` | `"GBP"` | … (22 locales).
+     * Required.
+     */
+    locale: Locale;
+    /** 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";
+    /**
+     * Layout direction forwarded to `FieldTemplate`.
+     * @default "horizontal"
+     */
+    orientation?: "horizontal" | "vertical" | "horizontalReverse";
+    /** 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;
+    /** Maximum numeric value allowed. @default 1_000_000_000 */
+    max?: number;
+    /** Controlled numeric value. */
+    value?: number;
+    /** Uncontrolled default numeric value. */
+    defaultValue?: number;
+    /**
+     * Callback fired on value change.
+     * @param event - Native change event.
+     * @param originalValue - Raw numeric string (e.g. `"1234.56"`).
+     * @param maskedValue - Formatted display string (e.g. `"$ 1,234.56"`).
+     */
+    onChange?: (event: ChangeEvent<HTMLInputElement>, originalValue: string, maskedValue: string) => void;
+};
+/**
+ * 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.
+ *
+ * @param props.name - Field name for form submission. Required.
+ * @param props.locale - Currency locale (e.g. `"USD"`, `"BRL"`, `"EUR"`). 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.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.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.
+ * @param props.orientation - Layout direction. Default: "horizontal"
+ * @param props.unShowFieldTemplate - Skips wrapper, label, and error rendering. Default: false
+ *
+ * **...Other valid HTML properties for `<input>` (except `type`, `max`, `value`, `defaultValue`, `onChange`, `placeholder`)**
+ *
+ * @returns CurrencyInput JSX element wrapped in `FieldTemplate`.
+ *
+ * @example
+ * ```tsx
+ * // Basic
+ * <CurrencyInput name="price" locale="USD" />
+ *
+ * // With label and validation
+ * <CurrencyInput
+ *   name="salary"
+ *   locale="BRL"
+ *   label="Monthly Salary"
+ *   showAsterisk
+ *   errorMessage="Please enter a valid amount"
+ * />
+ *
+ * // With max value and controlled state
+ * <CurrencyInput
+ *   name="limit"
+ *   locale="USD"
+ *   label="Credit Limit"
+ *   max={10000}
+ *   value={creditLimit}
+ *   onChange={(e, original) => setCreditLimit(Number(original))}
+ * />
+ * ```
+ */
+declare function CurrencyInput(props: CurrencyInputProps): import("react").JSX.Element;
+export { CurrencyInput };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/currencyInput/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACN,KAAK,WAAW,EAEhB,KAAK,mBAAmB,EAKxB,MAAM,OAAO,CAAC;AAUf,OAAO,aAAa,CAAC;AAErB,KAAK,MAAM,GACR,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,CAAC;AAET,KAAK,kBAAkB,GAAG,IAAI,CAC7B,mBAAmB,CAAC,gBAAgB,CAAC,EACnC,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,KAAK,GACL,cAAc,GACd,OAAO,GACP,UAAU,GACV,aAAa,CACf,GAAG;IACH,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,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;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;IAC9D,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,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CACV,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,EACpC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,KACf,IAAI,CAAC;CACV,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAwK/C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

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

@@ -0,0 +1,32 @@
+import type { HTMLAttributes } from "react";
+import "./styles.css";
+type DividerProps = HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Divider orientation.
+     * @default "horizontal"
+     */
+    orientation?: "horizontal" | "vertical";
+};
+/**
+ * Divider — visually separates content sections.
+ *
+ * @param props.orientation - Line direction (`horizontal` | `vertical`). Default: "horizontal"
+ *
+ * **...Other valid HTML properties for `<div>`**
+ *
+ * @returns Divider JSX element.
+ *
+ * @example
+ * ```tsx
+ * // Between sections
+ * <h2>Section 1</h2>
+ * <Divider />
+ * <h2>Section 2</h2>
+ *
+ * // Vertical (e.g. between sidebar and content)
+ * <Divider orientation="vertical" />
+ * ```
+ */
+declare function Divider(props: DividerProps): import("react").JSX.Element;
+export { Divider };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/divider/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,cAAc,CAAC;AAEtB,KAAK,YAAY,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG;IACpD;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iBAAS,OAAO,CAAC,KAAK,EAAE,YAAY,+BAUnC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { HTMLAttributes } from "react";
+import "./styles.css";
+type DrawerContainerProps = HTMLAttributes<HTMLElement> & {
+    /** Controls whether the drawer is visible. */
+    isVisible: boolean;
+    /** Callback invoked when the overlay is clicked to close the drawer. */
+    makeInvisible: () => void;
+    /** Side from which the drawer slides in. @default "left" */
+    orientation?: "left" | "right";
+};
+/**
+ * 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).
+ *
+ * @param props.isVisible - Whether the drawer is open. Required.
+ * @param props.makeInvisible - Called when the overlay or close button is clicked. Required.
+ * @param props.orientation - Slide direction. Default: `"left"`
+ *
+ * **...Other valid HTML `<aside>` properties**
+ *
+ * @returns DrawerContainer JSX element.
+ *
+ * @example
+ * ```tsx
+ * const [isOpen, setIsOpen] = useState(false);
+ *
+ * <DrawerContainer isVisible={isOpen} makeInvisible={() => setIsOpen(false)} orientation="right">
+ *   <DrawerHeader><h2>Navigation</h2></DrawerHeader>
+ *   <nav>...</nav>
+ * </DrawerContainer>
+ * ```
+ */
+declare function DrawerContainer(props: DrawerContainerProps): import("react").JSX.Element;
+export { DrawerContainer };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/drawer/drawerContainer/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAI5C,OAAO,cAAc,CAAC;AAEtB,KAAK,oBAAoB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACzD,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iBAAS,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BA6CnD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/components/drawer/drawerContext.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from "react";
+type DrawerContextProps = {
+    makeInvisible: () => void;
+};
+type DrawerProviderProps = {
+    children: ReactNode;
+    makeInvisible: () => void;
+};
+declare function DrawerProvider(props: DrawerProviderProps): import("react").JSX.Element;
+declare function useDrawer(): DrawerContextProps;
+export { DrawerProvider, useDrawer };
+//# sourceMappingURL=drawerContext.d.ts.map

package/dist/components/drawer/drawerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawerContext.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/drawerContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AAElE,KAAK,kBAAkB,GAAG;IACzB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF,KAAK,mBAAmB,GAAG;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAIF,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,+BAMjD;AAED,iBAAS,SAAS,uBAEjB;AAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { HTMLAttributes } from "react";
+import "./styles.css";
+type DrawerHeaderProps = HTMLAttributes<HTMLElement> & {
+    /** Whether to render the X close button. @default true */
+    showCloseButton?: boolean;
+};
+/**
+ * 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`.
+ *
+ * @param props.showCloseButton - Renders the X close button. Default: true
+ *
+ * **...Other valid HTML `<header>` properties**
+ *
+ * @returns DrawerHeader JSX element.
+ *
+ * @example
+ * ```tsx
+ * <DrawerContainer isVisible={isOpen} makeInvisible={() => setIsOpen(false)}>
+ *   <DrawerHeader>
+ *     <h2>Navigation</h2>
+ *   </DrawerHeader>
+ *   <nav>...</nav>
+ * </DrawerContainer>
+ * ```
+ */
+declare function DrawerHeader(props: DrawerHeaderProps): import("react").JSX.Element;
+export { DrawerHeader };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/drawer/drawerHeader/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,cAAc,CAAC;AAEtB,KAAK,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACtD,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,iBAAS,YAAY,CAAC,KAAK,EAAE,iBAAiB,+BA2B7C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { FacebookPixelProps } from ".";
+declare function FacebookPixelClient(props: FacebookPixelProps): null;
+export { FacebookPixelClient };
+//# sourceMappingURL=facebookPixel.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facebookPixel.client.d.ts","sourceRoot":"","sources":["../../../src/components/facebookPixel/facebookPixel.client.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,GAAG,CAAC;AAG5C,iBAAS,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,QA2BrD;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}