@arkyn/components 3.0.1-beta.20 → 3.0.1-beta.201

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

@@ -0,0 +1,70 @@
+import { type LucideIcon } from "lucide-react";
+import type { ButtonHTMLAttributes } from "react";
+import "./styles.css";
+type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    /** Shows a spinner and disables the button during async operations. @default false */
+    isLoading?: boolean;
+    /** Text displayed beside the spinner when `isLoading` is true. */
+    loadingText?: string;
+    /**
+     * Button size.
+     * @default "md"
+     */
+    size?: "xs" | "sm" | "md" | "lg";
+    /**
+     * Visual style variant.
+     * - `solid`: filled background.
+     * - `outline`: bordered, transparent background.
+     * - `ghost`: no border, subtle hover.
+     * - `invisible`: no visual styling.
+     * @default "solid"
+     */
+    variant?: "solid" | "outline" | "ghost" | "invisible";
+    /**
+     * Color scheme applied to the button.
+     * @default "primary"
+     */
+    scheme?: "primary" | "secondary" | "success" | "warning" | "danger" | "info";
+    /** Lucide icon rendered to the left of the label. */
+    leftIcon?: LucideIcon;
+    /** Lucide icon rendered to the right of the label. */
+    rightIcon?: LucideIcon;
+};
+/**
+ * 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.
+ * @param props.size - Button size (`xs` | `sm` | `md` | `lg`). Default: "md"
+ * @param props.variant - Visual style variant. Default: "solid"
+ * @param props.scheme - Color scheme. Default: "primary"
+ * @param props.leftIcon - Lucide icon rendered to the left of the label.
+ * @param props.rightIcon - Lucide icon rendered to the right of the label.
+ *
+ * **...Other valid HTML properties for `<button>`**
+ *
+ * @returns Button JSX element.
+ *
+ * @example
+ * ```tsx
+ * // Basic button
+ * <Button>Click me</Button>
+ *
+ * // With color scheme
+ * <Button scheme="success">Save</Button>
+ *
+ * // With loading state
+ * <Button isLoading loadingText="Saving...">Save</Button>
+ *
+ * // With icons
+ * <Button leftIcon={SaveIcon} scheme="success">Save</Button>
+ *
+ * // Custom size, variant and scheme
+ * <Button size="lg" variant="outline" scheme="danger" rightIcon={TrashIcon}>
+ *   Delete
+ * </Button>
+ * ```
+ */
+declare function Button(props: ButtonProps): import("react").JSX.Element;
+export { Button };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/button/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAGlD,OAAO,cAAc,CAAC;AAEtB,KAAK,WAAW,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,GAAG;IAC5D,sFAAsF;IACtF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACtD;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7E,qDAAqD;IACrD,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,UAAU,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,iBAAS,MAAM,CAAC,KAAK,EAAE,WAAW,+BAqCjC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

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

@@ -0,0 +1,52 @@
+import { type ReactNode } from "react";
+import { type CalendarMatrix } from "./_viewService";
+type CalendarContextProps = {
+    valueDate: Date[];
+    viewDate: Date;
+    currentDate: string;
+    currentDay: string;
+    currentMonth: string;
+    currentYear: string;
+    listWeek: string[];
+    listMonths: {
+        label: string;
+        value: string;
+    }[];
+    listYears: {
+        label: string;
+        value: string;
+    }[];
+    listMatrix: CalendarMatrix;
+    changeDay: (day: number, month: number, year: number) => void;
+    changeMonth: (month: number) => void;
+    changeYear: (year: number) => void;
+    nextMonth: () => void;
+    previousMonth: () => void;
+};
+type SingleCalendarProviderProps = {
+    children: ReactNode;
+    calendarType: "single";
+    language?: string;
+    onChangeView?: (date: Date) => void;
+    defaultValue?: Date;
+    onChange?: (date: Date) => void;
+    value?: Date;
+    viewValue?: Date;
+    defaultViewValue?: Date;
+};
+type RangeCalendarProviderProps = {
+    children: ReactNode;
+    calendarType: "range";
+    language?: string;
+    onChangeView?: (date: Date) => void;
+    defaultValue?: [Date, Date];
+    onChange?: (date: [Date, Date]) => void;
+    value?: [Date, Date];
+    viewValue?: Date;
+    defaultViewValue?: Date;
+};
+type CalendarProviderProps = SingleCalendarProviderProps | RangeCalendarProviderProps;
+declare function useCalendar(): CalendarContextProps;
+declare function CalendarProvider(props: CalendarProviderProps): import("react").JSX.Element;
+export { CalendarProvider, useCalendar };
+//# sourceMappingURL=_calendarProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_calendarProvider.d.ts","sourceRoot":"","sources":["../../../src/components/calendar/_calendarProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAC;AAC5E,OAAO,EAAE,KAAK,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAElE,KAAK,oBAAoB,GAAG;IAC3B,SAAS,EAAE,IAAI,EAAE,CAAC;IAClB,QAAQ,EAAE,IAAI,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF,KAAK,2BAA2B,GAAG;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACpC,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,gBAAgB,CAAC,EAAE,IAAI,CAAC;CACxB,CAAC;AAEF,KAAK,0BAA0B,GAAG;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACpC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,gBAAgB,CAAC,EAAE,IAAI,CAAC;CACxB,CAAC;AAEF,KAAK,qBAAqB,GACvB,2BAA2B,GAC3B,0BAA0B,CAAC;AAI9B,iBAAS,WAAW,yBAEnB;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,+BAsFrD;AAED,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC"}

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

@@ -0,0 +1,32 @@
+type CalendarCell = {
+    day: number;
+    month: number;
+    year: number;
+    dayType: "checkedDay" | "middleDay" | "uncheckedDay";
+    dayOwner: "previous" | "current" | "next";
+};
+type CalendarMatrix = CalendarCell[][];
+declare class ViewService {
+    currentDay(viewDate: Date): string;
+    currentMonth(viewDate: Date): string;
+    currentYear(viewDate: Date): string;
+    capitalize(text: string): string;
+    parseDayType(day: number, month: number, year: number, valueDate: [Date, Date]): "checkedDay" | "middleDay" | "uncheckedDay";
+    listWeek(language: string): string[];
+    listMonths(viewDate: Date, language: string): {
+        label: string;
+        value: string;
+    }[];
+    listYears(lastYears: number): {
+        label: string;
+        value: string;
+    }[];
+    listMatrix(viewDate: Date, valueDate: [Date, Date]): CalendarMatrix;
+    changeDay(day: number, month: number, year: number, calendarType: "single" | "range", valueDate: [Date, Date], setValueDate: (date: [Date, Date]) => void, setViewDate: (date: Date) => void): void;
+    changeMonth(month: number, viewDate: Date, setViewDate: (date: Date) => void): void;
+    changeYear(year: number, viewDate: Date, setViewDate: (date: Date) => void): void;
+    nextMonth(viewDate: Date, setViewDate: (date: Date) => void): void;
+    previousMonth(viewDate: Date, setViewDate: (date: Date) => void): void;
+}
+export { type CalendarMatrix, ViewService };
+//# sourceMappingURL=_viewService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_viewService.d.ts","sourceRoot":"","sources":["../../../src/components/calendar/_viewService.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,GAAG;IACnB,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,KAAK,cAAc,GAAG,YAAY,EAAE,EAAE,CAAC;AAEvC,cAAM,WAAW;IAChB,UAAU,CAAC,QAAQ,EAAE,IAAI;IAIzB,YAAY,CAAC,QAAQ,EAAE,IAAI;IAI3B,WAAW,CAAC,QAAQ,EAAE,IAAI;IAI1B,UAAU,CAAC,IAAI,EAAE,MAAM;IAIvB,YAAY,CACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,GACrB,YAAY,GAAG,WAAW,GAAG,cAAc;IAmB9C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAiBzB,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM;;;;IAe3C,SAAS,CAAC,SAAS,EAAE,MAAM;;;;IAS3B,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAgElD,SAAS,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,QAAQ,GAAG,OAAO,EAChC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EACvB,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,EAC1C,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI;IAmDlC,WAAW,CACV,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,IAAI,EACd,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI;IAOlC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI;IAM1E,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI;IAO3D,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI;CAM/D;AAED,OAAO,EAAE,KAAK,cAAc,EAAE,WAAW,EAAE,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+import "./styles.css";
+type CalendarContainerProps = {
+    children?: ReactNode;
+};
+declare function CalendarContainer({ children }: CalendarContainerProps): import("react").JSX.Element;
+export { CalendarContainer };
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,7 @@
+import "./styles.css";
+type CalendarHeaderProps = {
+    basicMode: boolean;
+};
+declare function CalendarHeader({ basicMode }: CalendarHeaderProps): import("react").JSX.Element;
+export { CalendarHeader };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/calendar/calendarHeader/index.tsx"],"names":[],"mappings":"AAIA,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG;IAC1B,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,EAAE,mBAAmB,+BAoEzD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

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

@@ -0,0 +1,4 @@
+import "./styles.css";
+declare function CalendarTableBody(): import("react").JSX.Element;
+export { CalendarTableBody };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/calendar/calendarTableBody/index.tsx"],"names":[],"mappings":"AAEA,OAAO,cAAc,CAAC;AAEtB,iBAAS,iBAAiB,gCAgBzB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+import "./styles.css";
+type CalendarTableContainerProps = {
+    children: ReactNode;
+};
+declare function CalendarTableContainer({ children }: CalendarTableContainerProps): import("react").JSX.Element;
+export { CalendarTableContainer };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/calendar/calendarTableContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,2BAA2B,GAAG;IAClC,QAAQ,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,iBAAS,sBAAsB,CAAC,EAAE,QAAQ,EAAE,EAAE,2BAA2B,+BAExE;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

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

@@ -0,0 +1,4 @@
+import "./styles.css";
+declare function CalendarTableHeader(): import("react").JSX.Element;
+export { CalendarTableHeader };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/calendar/calendarTableHeader/index.tsx"],"names":[],"mappings":"AAEA,OAAO,cAAc,CAAC;AAEtB,iBAAS,mBAAmB,gCAY3B;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

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