@arkyn/components 3.0.1-beta.95 → 3.0.2

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

@@ -1,83 +1,41 @@
-import { HTMLAttributes, ReactNode } from "react";
+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 component - used as a wrapper for CardTabButton components to create tabbed navigation
+ * CardTabContainer — wrapper that manages active state for a group of `CardTabButton` components.
  *
- * @param props - CardTabContainer component properties
- * @param props.children - CardTabButton components and other content (required)
- * @param props.disabled - Whether all tab buttons are disabled. Default: false
- * @param props.defaultValue - Initial tab value to be selected
- * @param props.onChange - Callback function called when tab changes, receives the tab value
+ * Renders as a `<nav>` element. Provides context consumed by each `CardTabButton`.
  *
- * **...Other valid HTML nav properties except onClick, children, and ref**
+ * @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.
  *
- * @returns CardTabContainer JSX element
+ * **...Other valid HTML `<nav>` properties**
  *
- * @example
- * ```tsx
- * // Basic tab container
- * <CardTabContainer>
- *   <CardTabButton value="home">Home</CardTabButton>
- *   <CardTabButton value="about">About</CardTabButton>
- *   <CardTabButton value="contact">Contact</CardTabButton>
- * </CardTabContainer>
- * ```
+ * @returns CardTabContainer JSX element.
  *
  * @example
  * ```tsx
- * // Tab container with default value and change handler
- * <CardTabContainer
- *   defaultValue="dashboard"
- *   onChange={(value) => console.log('Active tab:', value)}
- * >
- *   <CardTabButton value="dashboard">Dashboard</CardTabButton>
+ * <CardTabContainer defaultValue="overview" onChange={setActiveTab}>
+ *   <CardTabButton value="overview">Overview</CardTabButton>
  *   <CardTabButton value="analytics">Analytics</CardTabButton>
  *   <CardTabButton value="settings">Settings</CardTabButton>
  * </CardTabContainer>
- * ```
- *
- * @example
- * ```tsx
- * // Disabled all tabs
- * <CardTabContainer disabled>
- *   <CardTabButton value="tab1">Tab 1</CardTabButton>
- *   <CardTabButton value="tab2">Tab 2</CardTabButton>
- * </CardTabContainer>
- * ```
- *
- * @example
- * ```tsx
- * // Tab container with custom styling and state management
- * function MyTabs() {
- *   const [activeTab, setActiveTab] = useState('profile');
- *
- *   return (
- *     <div>
- *       <CardTabContainer
- *         defaultValue={activeTab}
- *         onChange={setActiveTab}
- *         className="custom-tabs"
- *         role="tablist"
- *       >
- *         <CardTabButton value="profile">Profile</CardTabButton>
- *         <CardTabButton value="account">Account</CardTabButton>
- *         <CardTabButton value="notifications">Notifications</CardTabButton>
- *       </CardTabContainer>
  *
- *       {activeTab === 'profile' && <ProfileContent />}
- *       {activeTab === 'account' && <AccountContent />}
- *       {activeTab === 'notifications' && <NotificationsContent />}
- *     </div>
- *   );
- * }
+ * {activeTab === 'overview' && <OverviewPanel />}
+ * {activeTab === 'analytics' && <AnalyticsPanel />}
  * ```
  */
-declare function CardTabContainer(props: CardTabContainerProps): import("react/jsx-runtime").JSX.Element;
+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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/cardTab/cardTabContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAY,MAAM,OAAO,CAAC;AAG5D,OAAO,cAAc,CAAC;AAEtB,KAAK,qBAAqB,GAAG,IAAI,CAC/B,cAAc,CAAC,WAAW,CAAC,EAC3B,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,CAC5C,GAAG;IACF,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AAEH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CA8BrD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"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

@@ -1,16 +1,16 @@
-import { ReactNode } from "react";
+import { type ReactNode } from "react";
 type CardTabContextProps = {
     disabled: boolean;
     currentTab: string;
     changeCurrentTab: (tab: string) => void;
 };
-type TabProviderProps = {
+type CardTabProviderProps = {
     children: ReactNode;
     disabled: boolean;
     currentTab: string;
     changeCurrentTab: (tab: string) => void;
 };
 declare function useCardTab(): CardTabContextProps;
-declare function TabProvider(props: TabProviderProps): import("react/jsx-runtime").JSX.Element;
-export { TabProvider, useCardTab };
+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

@@ -1 +1 @@
-{"version":3,"file":"cardTabContext.d.ts","sourceRoot":"","sources":["../../../src/components/cardTab/cardTabContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAc,MAAM,OAAO,CAAC;AAE7D,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,CAAC;AAIF,iBAAS,UAAU,wBAElB;AAED,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAM3C;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"cardTabContext.d.ts","sourceRoot":"","sources":["../../../src/components/cardTab/cardTabContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAE3E,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,+BAanD;AAED,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC"}

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

@@ -1,40 +1,63 @@
-import { ButtonHTMLAttributes } from "react";
+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 component - used for creating interactive checkbox inputs with customizable styling and validation
+ * Checkbox — interactive checkbox input with label, validation, and form integration.
  *
- * @param props - Checkbox component properties
- * @param props.name - Required field name for form handling and hidden input identification
- * @param props.label - Optional label text to display next to the checkbox
- * @param props.errorMessage - Error state indicator to display validation errors
- * @param props.size - Size variant of the checkbox. Default: "md"
- * @param props.value - Optional value to be used when checkbox is checked. Default: "checked"
- * @param props.checked - Controlled checked state of the checkbox
- * @param props.defaultChecked - Default checked state for uncontrolled usage. Default: false
- * @param props.onCheck - Callback function called when checkbox state changes, receives the value or empty string
- * @param props.orientation - Orientation of the checkbox and label. Default: "horizontalReverse"
+ * Stores value in a hidden `<input>` for native form submission.
+ * Integrates with `useForm` to display validation errors by field name.
  *
- * **...Other valid HTML properties for button element (except type, name, defaultValue, value, onChange, onSelect, onClick)**
+ * @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
  *
- * @returns Checkbox JSX element wrapped in FieldWrapper with optional label and error
+ * **...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
+ * // Basic
  * <Checkbox name="terms" label="I agree to the terms and conditions" />
  *
- * // Checkbox with custom value and validation
+ * // With custom value and error
  * <Checkbox
  *   name="newsletter"
  *   label="Subscribe to newsletter"
@@ -42,34 +65,16 @@ type CheckboxProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "size" | "pre
  *   errorMessage={errors.newsletter}
  * />
  *
- * // Large checkbox with controlled state
+ * // Controlled
  * <Checkbox
  *   name="premium"
  *   label="Enable premium features"
  *   size="lg"
  *   checked={isPremium}
- *   onCheck={(value) => setIsPremium(!!value)}
- * />
- *
- * // Small checkbox with default checked state
- * <Checkbox
- *   name="remember"
- *   label="Remember me"
- *   size="sm"
- *   defaultChecked={true}
- *   value="remember_user"
- * />
- *
- * // Checkbox with custom styling and callback
- * <Checkbox
- *   name="notifications"
- *   label="Enable notifications"
- *   className="custom-checkbox"
- *   onCheck={(value) => console.log('Notification setting:', value)}
- *   disabled={isLoading}
+ *   onCheck={(v) => setIsPremium(!!v)}
  * />
  * ```
  */
-declare function Checkbox(props: CheckboxProps): import("react/jsx-runtime").JSX.Element;
+declare function Checkbox(props: CheckboxProps): import("react").JSX.Element;
 export { Checkbox };
 //# sourceMappingURL=index.d.ts.map

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,oBAAoB,EAA2B,MAAM,OAAO,CAAC;AAOtE,OAAO,cAAc,CAAC;AAEtB,KAAK,aAAa,GAAG,IAAI,CACvB,oBAAoB,CAAC,iBAAiB,CAAC,EACrC,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,cAAc,GACd,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,CACZ,GAAG;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAE1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,2CA8DrC;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,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

@@ -1,86 +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 component - renders children only after hydration on the client side
+ * ClientOnly — renders its children only after client-side hydration.
  *
- * This component prevents hydration mismatches by rendering different content during SSR
- * and after client-side hydration. It's useful for components that rely on browser APIs
- * or need to render differently on server and client.
+ * Prevents React hydration mismatches for components that rely on browser-only APIs
+ * (e.g. `window`, `navigator`, `document`). Uses `useHydrated` internally.
  *
- * @param props - ClientOnly component properties
- * @param props.children - Function that returns React nodes to render after hydration
- * @param props.fallback - Optional React node to render during SSR or before hydration
+ * @param props.children - Render function executed after hydration. Required.
+ * @param props.fallback - Content shown during SSR / before hydration. Default: null
  *
- * @returns React fragment containing either fallback content or children based on hydration state
+ * @returns `children()` after hydration, otherwise `fallback`.
  *
  * @example
  * ```tsx
- * // Basic usage with loading fallback
- * <ClientOnly fallback={<div>Loading...</div>}>
+ * // With a skeleton fallback
+ * <ClientOnly fallback={<Skeleton />}>
  *   {() => <InteractiveWidget />}
  * </ClientOnly>
  *
- * // Client-only component without fallback
- * <ClientOnly>
- *   {() => (
- *     <div>
- *       <p>This content only appears on the client</p>
- *       <p>Current time: {new Date().toLocaleString()}</p>
- *     </div>
- *   )}
+ * // Using browser APIs safely
+ * <ClientOnly fallback={<p>Loading...</p>}>
+ *   {() => <p>Current time: {new Date().toLocaleString()}</p>}
  * </ClientOnly>
- *
- * // Using with browser APIs
- * <ClientOnly fallback={<div>Preparing location services...</div>}>
- *   {() => <GeolocationComponent />}
- * </ClientOnly>
- *
- * // Complex interactive component
- * <ClientOnly fallback={<StaticPlaceholder />}>
- *   {() => (
- *     <div>
- *       <Chart data={chartData} />
- *       <InteractiveControls />
- *       <RealtimeUpdates />
- *     </div>
- *   )}
- * </ClientOnly>
- *
- * // Conditional rendering based on client capabilities
- * <ClientOnly fallback={<BasicTable data={data} />}>
- *   {() => (
- *     <AdvancedDataGrid
- *       data={data}
- *       features={['sorting', 'filtering', 'virtualization']}
- *     />
- *   )}
- * </ClientOnly>
- *
- * // Using with dynamic imports
- * <ClientOnly fallback={<div>Loading editor...</div>}>
- *   {() => <LazyCodeEditor />}
- * </ClientOnly>
- *
- * // Preventing layout shift
- * <ClientOnly fallback={<div className="skeleton-loader" />}>
- *   {() => <UserDashboard />}
- * </ClientOnly>
- *
- * // Multiple client-only sections
- * <div>
- *   <Header />
- *   <ClientOnly fallback={<div>Loading navigation...</div>}>
- *     {() => <InteractiveNavigation />}
- *   </ClientOnly>
- *   <MainContent />
- *   <ClientOnly>
- *     {() => <ChatWidget />}
- *   </ClientOnly>
- * </div>
  * ```
  */
-declare function ClientOnly(props: ClientOnlyProps): import("react/jsx-runtime").JSX.Element;
+declare function ClientOnly(props: ClientOnlyProps): import("react").ReactNode;
 export { ClientOnly };
 //# sourceMappingURL=clientOnly.d.ts.map

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;IACrB,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,2CAGzC;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,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

@@ -1,56 +1,101 @@
-import { LucideIcon } from "lucide-react";
-import { ChangeEvent, InputHTMLAttributes } from "react";
+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;
-    value?: number | null;
-    defaultValue?: number | null;
+    /** 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 component - used for currency input fields with automatic formatting based on locale
+ * CurrencyInput — numeric input that automatically formats the displayed value according to a currency locale.
  *
- * @param props - CurrencyInput component properties
- * @param props.name - Required field name for form handling
- * @param props.locale - Currency locale for formatting (e.g., "USD", "EUR", "BRL", etc.)
- * @param props.label - Optional label text to display above the input
- * @param props.errorMessage - Error message to display below the input
- * @param props.isLoading - Controls loading state with spinner. Default: false
- * @param props.size - Input size. Default: "md"
- * @param props.variant - Visual variant of the input. Default: "solid"
- * @param props.prefix - Text or icon to display at the beginning of the input
- * @param props.suffix - Text or icon to display at the end of the input
- * @param props.showAsterisk - Whether to show asterisk on label for required fields
- * @param props.leftIcon - Optional icon to display on the left side
- * @param props.rightIcon - Optional icon to display on the right side
- * @param props.max - Maximum allowed value for the currency input
- * @param props.value - Controlled value (number) for the input
- * @param props.defaultValue - Default value (number) for uncontrolled usage
- * @param props.onChange - Callback function called when value changes, receives event, original value and masked value
+ * The raw numeric value is stored in a hidden `<input>` for form submission.
+ * Integrates with `useForm` to display validation errors by field name.
  *
- * **...Other valid HTML properties for input element (except type, max, defaultValue, value, onChange)**
+ * @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
  *
- * @returns CurrencyInput JSX element wrapped in FieldGroup with optional label and error
+ * **...Other valid HTML properties for `<input>` (except `type`, `max`, `value`, `defaultValue`, `onChange`, `placeholder`)**
+ *
+ * @returns CurrencyInput JSX element wrapped in `FieldTemplate`.
  *
  * @example
  * ```tsx
- * // Basic currency input
- * <CurrencyInput name="price" locale="USD" placeholder="Enter price" />
+ * // Basic
+ * <CurrencyInput name="price" locale="USD" />
  *
- * // Currency input with label and validation
+ * // With label and validation
  * <CurrencyInput
  *   name="salary"
  *   locale="BRL"
@@ -59,40 +104,17 @@ type CurrencyInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "
  *   errorMessage="Please enter a valid amount"
  * />
  *
- * // Currency input with icons and loading state
- * <CurrencyInput
- *   name="budget"
- *   locale="EUR"
- *   label="Budget"
- *   leftIcon={DollarSignIcon}
- *   rightIcon={CalculatorIcon}
- *   isLoading
- * />
- *
- * // Currency input with max value and controlled state
+ * // With max value and controlled state
  * <CurrencyInput
  *   name="limit"
  *   locale="USD"
  *   label="Credit Limit"
  *   max={10000}
  *   value={creditLimit}
- *   onChange={(e, original, masked) => setCreditLimit(Number(original))}
- *   variant="outline"
- * />
- *
- * // Large currency input with prefix/suffix
- * <CurrencyInput
- *   name="investment"
- *   locale="GBP"
- *   label="Investment Amount"
- *   size="lg"
- *   variant="underline"
- *   prefix="£"
- *   suffix="GBP"
- *   placeholder="Enter investment amount"
+ *   onChange={(e, original) => setCreditLimit(Number(original))}
  * />
  * ```
  */
-declare function CurrencyInput(props: CurrencyInputProps): import("react/jsx-runtime").JSX.Element;
+declare function CurrencyInput(props: CurrencyInputProps): import("react").JSX.Element;
 export { CurrencyInput };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/currencyInput/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,WAAW,EACX,mBAAmB,EAMpB,MAAM,OAAO,CAAC;AAaf,OAAO,aAAa,CAAC;AAErB,KAAK,MAAM,GACP,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;AAEV,KAAK,kBAAkB,GAAG,IAAI,CAC5B,mBAAmB,CAAC,gBAAgB,CAAC,EACnC,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,KAAK,GACL,cAAc,GACd,OAAO,GACP,UAAU,GACV,aAAa,CAChB,GAAG;IACF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IAEf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAE5C,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,EACpC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;CACX,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AAEH,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAgK/C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"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

@@ -1,45 +1,32 @@
-import { HTMLAttributes } from "react";
+import type { HTMLAttributes } from "react";
 import "./styles.css";
 type DividerProps = HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Divider orientation.
+     * @default "horizontal"
+     */
     orientation?: "horizontal" | "vertical";
 };
 /**
- * Divider component - used to visually separate content sections
+ * Divider — visually separates content sections.
  *
- * @param props - Divider component properties
- * @param props.orientation - Divider orientation. Default: "horizontal"
+ * @param props.orientation - Line direction (`horizontal` | `vertical`). Default: "horizontal"
  *
- * **...Other valid HTML properties for div**
+ * **...Other valid HTML properties for `<div>`**
  *
- * @returns Divider JSX element
+ * @returns Divider JSX element.
  *
  * @example
  * ```tsx
- * // Basic horizontal divider
+ * // Between sections
+ * <h2>Section 1</h2>
  * <Divider />
+ * <h2>Section 2</h2>
  *
- * // Explicit horizontal divider
- * <Divider orientation="horizontal" />
- *
- * // Vertical divider
+ * // Vertical (e.g. between sidebar and content)
  * <Divider orientation="vertical" />
- *
- * // Custom styled divider
- * <Divider
- *   orientation="horizontal"
- *   className="my-custom-divider"
- * />
- *
- * // Usage in layout
- * <div>
- *   <h2>Section 1</h2>
- *   <p>Content for section 1</p>
- *   <Divider />
- *   <h2>Section 2</h2>
- *   <p>Content for section 2</p>
- * </div>
  * ```
  */
-declare function Divider(props: DividerProps): import("react/jsx-runtime").JSX.Element;
+declare function Divider(props: DividerProps): import("react").JSX.Element;
 export { Divider };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/divider/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,YAAY,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG;IACnD,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CACzC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,iBAAS,OAAO,CAAC,KAAK,EAAE,YAAY,2CAUnC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"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"}