@wakastellar/ui 4.0.0-dev.0 → 4.0.1

package/dist/src/components/waka-checklist/index.d.ts

@@ -1,123 +0,0 @@
-import * as React from "react";
-export type TaskStatus = "pending" | "completed" | "skipped";
-export interface ChecklistTask {
-    /** Unique identifier */
-    id: string;
-    /** Task title */
-    title: string;
-    /** Task description (shown when expanded) */
-    description?: string;
-    /** Category/group the task belongs to */
-    category?: string;
-    /** Action button label */
-    actionLabel?: string;
-    /** Callback when action is triggered */
-    onAction?: () => void;
-    /** Whether the task can be skipped */
-    skippable?: boolean;
-    /** Custom icon */
-    icon?: React.ReactNode;
-    /** Reward points for completing this task */
-    points?: number;
-    /** Whether this task is required */
-    required?: boolean;
-}
-export interface ChecklistCategory {
-    /** Category identifier */
-    id: string;
-    /** Category label */
-    label: string;
-    /** Category description */
-    description?: string;
-    /** Custom icon */
-    icon?: React.ReactNode;
-}
-export interface ChecklistState {
-    /** Map of task ID to status */
-    tasks: Record<string, TaskStatus>;
-    /** Whether the checklist is collapsed */
-    collapsed: boolean;
-    /** Set of expanded task IDs */
-    expandedTasks: Set<string>;
-}
-export interface WakaChecklistProps {
-    /** Checklist identifier for localStorage persistence */
-    checklistId: string;
-    /** List of tasks */
-    tasks: ChecklistTask[];
-    /** Category definitions */
-    categories?: ChecklistCategory[];
-    /** Title of the checklist */
-    title?: string;
-    /** Subtitle/description */
-    subtitle?: string;
-    /** Show progress bar */
-    showProgress?: boolean;
-    /** Show completion percentage */
-    showPercentage?: boolean;
-    /** Enable localStorage persistence */
-    persistent?: boolean;
-    /** Show celebration on completion */
-    showCelebration?: boolean;
-    /** Callback when all tasks are completed */
-    onComplete?: () => void;
-    /** Callback when a task status changes */
-    onTaskChange?: (taskId: string, status: TaskStatus) => void;
-    /** Initially collapsed */
-    defaultCollapsed?: boolean;
-    /** Allow collapsing the checklist */
-    collapsible?: boolean;
-    /** Size variant */
-    size?: "sm" | "default" | "lg";
-    /** Custom className */
-    className?: string;
-}
-export interface UseChecklistOptions {
-    /** Checklist identifier for localStorage */
-    checklistId: string;
-    /** List of tasks */
-    tasks: ChecklistTask[];
-    /** Enable localStorage persistence */
-    persistent?: boolean;
-    /** Initially collapsed */
-    defaultCollapsed?: boolean;
-    /** Callback when all tasks are completed */
-    onComplete?: () => void;
-    /** Callback when a task status changes */
-    onTaskChange?: (taskId: string, status: TaskStatus) => void;
-}
-export interface UseChecklistReturn {
-    /** Current state of all tasks */
-    taskStates: Record<string, TaskStatus>;
-    /** Whether checklist is collapsed */
-    isCollapsed: boolean;
-    /** Set of expanded task IDs */
-    expandedTasks: Set<string>;
-    /** Mark a task as completed */
-    completeTask: (taskId: string) => void;
-    /** Skip a task */
-    skipTask: (taskId: string) => void;
-    /** Reset a task to pending */
-    resetTask: (taskId: string) => void;
-    /** Toggle task expansion */
-    toggleTaskExpanded: (taskId: string) => void;
-    /** Toggle checklist collapse */
-    toggleCollapsed: () => void;
-    /** Reset entire checklist */
-    resetChecklist: () => void;
-    /** Completion progress (0-100) */
-    progress: number;
-    /** Number of completed tasks */
-    completedCount: number;
-    /** Number of skipped tasks */
-    skippedCount: number;
-    /** Total number of tasks */
-    totalCount: number;
-    /** Whether all tasks are completed or skipped */
-    isComplete: boolean;
-    /** Get status of a specific task */
-    getTaskStatus: (taskId: string) => TaskStatus;
-}
-export declare function useChecklist({ checklistId, tasks, persistent, defaultCollapsed, onComplete, onTaskChange, }: UseChecklistOptions): UseChecklistReturn;
-export declare function WakaChecklist({ checklistId, tasks, categories, title, subtitle, showProgress, showPercentage, persistent, showCelebration, onComplete, onTaskChange, defaultCollapsed, collapsible, size, className, }: WakaChecklistProps): import("react/jsx-runtime").JSX.Element;
-export default WakaChecklist;

package/dist/src/components/waka-checkout-stepper/index.d.ts

@@ -1,154 +0,0 @@
-import { LucideIcon } from 'lucide-react';
-import * as React from "react";
-export type CheckoutStepId = "cart" | "shipping" | "payment" | "review" | "confirmation";
-export type CheckoutStepStatus = "pending" | "current" | "completed" | "error" | "skipped";
-export interface CheckoutStepValidation {
-    /** Whether the step is valid */
-    isValid: boolean;
-    /** Error message if invalid */
-    errorMessage?: string;
-    /** Field-level errors */
-    fieldErrors?: Record<string, string>;
-}
-export interface CheckoutStep {
-    /** Unique step identifier */
-    id: CheckoutStepId | string;
-    /** Step title */
-    title: string;
-    /** Step description */
-    description?: string;
-    /** Custom icon (optional) */
-    icon?: LucideIcon;
-    /** Step content component */
-    content?: React.ReactNode;
-    /** Whether step is optional (can be skipped) */
-    optional?: boolean;
-    /** Whether step is disabled */
-    disabled?: boolean;
-    /** Validation function for the step */
-    validate?: () => CheckoutStepValidation | Promise<CheckoutStepValidation>;
-    /** Summary data for the sidebar */
-    summary?: React.ReactNode;
-}
-export interface CheckoutStepperProps {
-    /** List of checkout steps */
-    steps: CheckoutStep[];
-    /** Current step index (0-indexed) */
-    currentStep?: number;
-    /** Callback when step changes */
-    onStepChange?: (stepIndex: number, stepId: string) => void;
-    /** Callback when checkout is completed */
-    onComplete?: () => void;
-    /** Layout orientation */
-    orientation?: "horizontal" | "vertical";
-    /** Size variant */
-    size?: "sm" | "md" | "lg";
-    /** Allow clicking on steps to navigate */
-    clickable?: boolean;
-    /** Only allow navigation to previous steps */
-    allowPreviousOnly?: boolean;
-    /** Show step content */
-    showContent?: boolean;
-    /** Show summary sidebar */
-    showSummary?: boolean;
-    /** Summary sidebar position */
-    summaryPosition?: "left" | "right";
-    /** Enable animated transitions */
-    animated?: boolean;
-    /** Animation direction */
-    animationDirection?: "slide" | "fade" | "scale";
-    /** Loading state */
-    isLoading?: boolean;
-    /** Custom class name */
-    className?: string;
-    /** Navigation labels */
-    labels?: {
-        back?: string;
-        next?: string;
-        skip?: string;
-        complete?: string;
-        processing?: string;
-    };
-}
-export interface UseCheckoutStepperOptions {
-    /** Initial step index */
-    initialStep?: number;
-    /** List of steps */
-    steps: CheckoutStep[];
-    /** Callback when step changes */
-    onStepChange?: (stepIndex: number, stepId: string) => void;
-    /** Callback when checkout completes */
-    onComplete?: () => void;
-    /** Validate before proceeding */
-    validateOnNext?: boolean;
-}
-export interface UseCheckoutStepperReturn {
-    /** Current step index */
-    currentStep: number;
-    /** Current step data */
-    currentStepData: CheckoutStep | undefined;
-    /** All steps with status */
-    stepsWithStatus: (CheckoutStep & {
-        status: CheckoutStepStatus;
-    })[];
-    /** Total number of steps */
-    totalSteps: number;
-    /** Whether on first step */
-    isFirstStep: boolean;
-    /** Whether on last step */
-    isLastStep: boolean;
-    /** Whether checkout is complete */
-    isComplete: boolean;
-    /** Whether currently validating */
-    isValidating: boolean;
-    /** Current validation error */
-    validationError: string | null;
-    /** Go to specific step */
-    goToStep: (index: number) => Promise<boolean>;
-    /** Go to next step */
-    nextStep: () => Promise<boolean>;
-    /** Go to previous step */
-    prevStep: () => void;
-    /** Skip current step (if optional) */
-    skipStep: () => void;
-    /** Complete checkout */
-    completeCheckout: () => Promise<boolean>;
-    /** Reset stepper */
-    reset: () => void;
-    /** Get step status */
-    getStepStatus: (index: number) => CheckoutStepStatus;
-    /** Skipped steps */
-    skippedSteps: Set<number>;
-    /** Mark step as completed manually */
-    markStepCompleted: (index: number) => void;
-}
-export interface CheckoutStepperContextValue extends UseCheckoutStepperReturn {
-    orientation: "horizontal" | "vertical";
-    size: "sm" | "md" | "lg";
-    clickable: boolean;
-    allowPreviousOnly: boolean;
-    animated: boolean;
-    animationDirection: "slide" | "fade" | "scale";
-    isLoading: boolean;
-}
-export declare function useCheckoutStepper({ initialStep, steps, onStepChange, onComplete, validateOnNext, }: UseCheckoutStepperOptions): UseCheckoutStepperReturn;
-export declare function useCheckoutStepperContext(): CheckoutStepperContextValue;
-export interface CheckoutNavigationProps {
-    /** Custom class name */
-    className?: string;
-    /** Custom labels */
-    labels?: {
-        back?: string;
-        next?: string;
-        skip?: string;
-        complete?: string;
-        processing?: string;
-    };
-}
-export declare function CheckoutNavigation({ className, labels, }: CheckoutNavigationProps): import("react/jsx-runtime").JSX.Element;
-export interface CheckoutProgressBarProps {
-    className?: string;
-}
-export declare function CheckoutProgressBar({ className }: CheckoutProgressBarProps): import("react/jsx-runtime").JSX.Element;
-export declare function WakaCheckoutStepper({ steps, currentStep: controlledStep, onStepChange, onComplete, orientation, size, clickable, allowPreviousOnly, showContent, showSummary, summaryPosition, animated, animationDirection, isLoading, className, labels, }: CheckoutStepperProps): import("react/jsx-runtime").JSX.Element;
-export default WakaCheckoutStepper;

package/dist/src/components/waka-cohort-table/index.d.ts

@@ -1,130 +0,0 @@
-import * as React from "react";
-export type CohortPeriod = "day" | "week" | "month" | "quarter" | "year";
-export type CohortMetric = "retention" | "churn" | "revenue" | "engagement" | "custom";
-export interface CohortDataPoint {
-    /** Value for this period (0-100 for percentages, or raw value) */
-    value: number;
-    /** Number of users/items at this point */
-    count?: number;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-export interface CohortRow {
-    /** Unique identifier for the cohort */
-    id: string;
-    /** Cohort label (e.g., "Jan 2024", "Week 1") */
-    label: string;
-    /** Cohort start date */
-    date: Date;
-    /** Initial cohort size */
-    size: number;
-    /** Data points for each period */
-    data: CohortDataPoint[];
-}
-export interface CohortColorScale {
-    /** Minimum value color (e.g., for 0% retention) */
-    min: string;
-    /** Maximum value color (e.g., for 100% retention) */
-    max: string;
-    /** Optional midpoint color for gradient */
-    mid?: string;
-    /** Midpoint value (defaults to 50) */
-    midValue?: number;
-}
-export interface CohortExportOptions {
-    /** Export format */
-    format: "csv" | "json";
-    /** Include metadata in export */
-    includeMetadata?: boolean;
-    /** Custom filename */
-    filename?: string;
-}
-export interface WakaCohortTableProps {
-    /** Cohort data rows */
-    data: CohortRow[];
-    /** Period type for columns */
-    period?: CohortPeriod;
-    /** Metric being displayed */
-    metric?: CohortMetric;
-    /** Custom metric label */
-    metricLabel?: string;
-    /** Whether to show as percentage */
-    showAsPercentage?: boolean;
-    /** Number of decimal places */
-    decimalPlaces?: number;
-    /** Color scale configuration */
-    colorScale?: CohortColorScale;
-    /** Show cohort size column */
-    showCohortSize?: boolean;
-    /** Show average row */
-    showAverageRow?: boolean;
-    /** Show trend indicators */
-    showTrends?: boolean;
-    /** Enable cell hover highlighting */
-    highlightOnHover?: boolean;
-    /** Show color scale legend */
-    showLegend?: boolean;
-    /** Enable export functionality */
-    enableExport?: boolean;
-    /** Callback when cell is clicked */
-    onCellClick?: (row: CohortRow, periodIndex: number, value: CohortDataPoint) => void;
-    /** Callback when export is triggered */
-    onExport?: (options: CohortExportOptions) => void;
-    /** Custom cell renderer */
-    renderCell?: (value: CohortDataPoint, row: CohortRow, periodIndex: number) => React.ReactNode;
-    /** Custom tooltip renderer */
-    renderTooltip?: (value: CohortDataPoint, row: CohortRow, periodIndex: number) => React.ReactNode;
-    /** Custom className */
-    className?: string;
-    /** Table className */
-    tableClassName?: string;
-    /** Header cell className */
-    headerClassName?: string;
-    /** Body cell className */
-    cellClassName?: string;
-}
-export declare function WakaCohortTable({ data, period, metric, metricLabel, showAsPercentage, decimalPlaces, colorScale, showCohortSize, showAverageRow, showTrends, highlightOnHover, showLegend, enableExport, onCellClick, onExport, renderCell, renderTooltip, className, tableClassName, headerClassName, cellClassName, }: WakaCohortTableProps): import("react/jsx-runtime").JSX.Element;
-export interface UseCohortTableOptions {
-    /** Initial cohort data */
-    initialData?: CohortRow[];
-    /** Default period type */
-    defaultPeriod?: CohortPeriod;
-    /** Default metric */
-    defaultMetric?: CohortMetric;
-}
-export interface CohortStatistics {
-    /** Total number of cohorts */
-    totalCohorts: number;
-    /** Total users across all cohorts */
-    totalUsers: number;
-    /** Average initial cohort size */
-    averageCohortSize: number;
-    /** Average retention at each period */
-    averageRetentionByPeriod: number[];
-    /** Overall average retention */
-    overallAverageRetention: number;
-    /** Best performing cohort */
-    bestCohort: CohortRow | null;
-    /** Worst performing cohort */
-    worstCohort: CohortRow | null;
-}
-export declare function useCohortTable({ initialData, defaultPeriod, defaultMetric, }?: UseCohortTableOptions): {
-    data: CohortRow[];
-    period: CohortPeriod;
-    metric: CohortMetric;
-    selectedCohort: string | null;
-    statistics: CohortStatistics;
-    setData: React.Dispatch<React.SetStateAction<CohortRow[]>>;
-    setPeriod: React.Dispatch<React.SetStateAction<CohortPeriod>>;
-    setMetric: React.Dispatch<React.SetStateAction<CohortMetric>>;
-    setSelectedCohort: React.Dispatch<React.SetStateAction<string | null>>;
-    addCohort: (cohort: CohortRow) => void;
-    updateCohort: (id: string, updates: Partial<CohortRow>) => void;
-    removeCohort: (id: string) => void;
-    updateDataPoint: (cohortId: string, periodIndex: number, value: Partial<CohortDataPoint>) => void;
-    sortCohorts: (sortBy: "date" | "size" | "retention", order?: "asc" | "desc") => void;
-    filterByDateRange: (startDate: Date, endDate: Date) => CohortRow[];
-    getCohortById: (id: string) => CohortRow | undefined;
-    reset: () => void;
-};
-export default WakaCohortTable;

package/dist/src/components/waka-color-picker/index.d.ts

@@ -1,40 +0,0 @@
-import * as React from "react";
-export type ColorFormat = "hex" | "rgb" | "hsl";
-export interface WakaColorPickerProps {
-    /** Valeur de la couleur */
-    value?: string;
-    /** Callback de changement */
-    onChange?: (color: string) => void;
-    /** Format de couleur */
-    format?: ColorFormat;
-    /** Afficher le canal alpha */
-    showAlpha?: boolean;
-    /** Afficher les couleurs prédéfinies */
-    showPresets?: boolean;
-    /** Couleurs prédéfinies personnalisées */
-    presets?: string[];
-    /** Afficher l'outil EyeDropper (si supporté) */
-    showEyeDropper?: boolean;
-    /** Désactivé */
-    disabled?: boolean;
-    /** Placeholder */
-    placeholder?: string;
-    /** Classes CSS additionnelles */
-    className?: string;
-    /** Taille */
-    size?: "sm" | "md" | "lg";
-}
-/**
- * Composant WakaColorPicker
- */
-export declare const WakaColorPicker: React.ForwardRefExoticComponent<WakaColorPickerProps & React.RefAttributes<HTMLButtonElement>>;
-/**
- * Version intégrée avec react-hook-form
- */
-export interface WakaColorPickerFormProps extends WakaColorPickerProps {
-    name: string;
-    error?: string;
-    label?: string;
-}
-export declare const WakaColorPickerForm: React.ForwardRefExoticComponent<WakaColorPickerFormProps & React.RefAttributes<HTMLButtonElement>>;
-export default WakaColorPicker;

package/dist/src/components/waka-combo-counter/index.d.ts

@@ -1,53 +0,0 @@
-export interface WakaComboCounterProps {
-    /** Current combo count */
-    combo: number;
-    /** Current multiplier (e.g., 2 for x2) */
-    multiplier?: number;
-    /** Maximum multiplier cap */
-    maxMultiplier?: number;
-    /** Time remaining to maintain combo (0-100 percentage) */
-    timeRemaining?: number;
-    /** Callback when combo breaks (timer runs out) */
-    onComboBreak?: () => void;
-    /** Milestone numbers to celebrate */
-    milestones?: number[];
-    /** Callback when a milestone is reached */
-    onMilestone?: (milestone: number) => void;
-    /** Size variant */
-    size?: "sm" | "md" | "lg" | "xl";
-    /** Show the timer bar */
-    showTimer?: boolean;
-    /** Show the multiplier badge */
-    showMultiplier?: boolean;
-    /** Visual intensity level */
-    intensity?: "low" | "medium" | "high" | "extreme";
-    /** Enable animations */
-    animated?: boolean;
-    /** Custom className */
-    className?: string;
-    /** Sound effect hooks */
-    onPlayIncrementSound?: () => void;
-    onPlayMilestoneSound?: () => void;
-    onPlayBreakSound?: () => void;
-}
-export declare function WakaComboCounter({ combo, multiplier, maxMultiplier, timeRemaining, onComboBreak, milestones, onMilestone, size, showTimer, showMultiplier, intensity, animated, className, onPlayIncrementSound, onPlayMilestoneSound, onPlayBreakSound, }: WakaComboCounterProps): import("react/jsx-runtime").JSX.Element;
-export interface UseComboCounterOptions {
-    initialCombo?: number;
-    initialMultiplier?: number;
-    maxMultiplier?: number;
-    timerDuration?: number;
-    multiplierThresholds?: number[];
-    autoDecay?: boolean;
-    decayRate?: number;
-}
-export interface UseComboCounterReturn {
-    combo: number;
-    multiplier: number;
-    timeRemaining: number;
-    increment: (amount?: number) => void;
-    reset: () => void;
-    pause: () => void;
-    resume: () => void;
-    isPaused: boolean;
-}
-export declare function useComboCounter({ initialCombo, initialMultiplier, maxMultiplier, timerDuration, multiplierThresholds, autoDecay, decayRate, }?: UseComboCounterOptions): UseComboCounterReturn;

package/dist/src/components/waka-combobox/index.d.ts

@@ -1,81 +0,0 @@
-import * as React from "react";
-export interface ComboboxOption<T = string> {
-    /** Valeur unique de l'option */
-    value: T;
-    /** Libellé affiché */
-    label: string;
-    /** Description secondaire */
-    description?: string;
-    /** Icône */
-    icon?: React.ReactNode;
-    /** Désactiver l'option */
-    disabled?: boolean;
-    /** Groupe de l'option */
-    group?: string;
-}
-export interface WakaComboboxProps<T = string> {
-    /** Options disponibles */
-    options: ComboboxOption<T>[];
-    /** Valeur sélectionnée (single) ou valeurs (multiple) */
-    value?: T | T[];
-    /** Callback lors du changement */
-    onChange?: (value: T | T[] | undefined) => void;
-    /** Placeholder */
-    placeholder?: string;
-    /** Placeholder de recherche */
-    searchPlaceholder?: string;
-    /** Message si aucune option */
-    emptyMessage?: string;
-    /** Mode multiple */
-    multiple?: boolean;
-    /** Permettre la création de nouvelles options */
-    creatable?: boolean;
-    /** Callback lors de la création */
-    onCreate?: (inputValue: string) => ComboboxOption<T> | Promise<ComboboxOption<T>>;
-    /** Texte du bouton de création */
-    createLabel?: string;
-    /** Recherche asynchrone */
-    onSearch?: (query: string) => Promise<ComboboxOption<T>[]>;
-    /** Délai de debounce pour la recherche (ms) */
-    searchDebounce?: number;
-    /** Désactivé */
-    disabled?: boolean;
-    /** Erreur */
-    error?: boolean;
-    /** Chargement */
-    loading?: boolean;
-    /** Taille */
-    size?: "sm" | "md" | "lg";
-    /** Permettre de vider la sélection */
-    clearable?: boolean;
-    /** Nombre maximum de sélections (multiple) */
-    maxSelections?: number;
-    /** Classes CSS additionnelles */
-    className?: string;
-    /** ID pour l'accessibilité */
-    id?: string;
-    /** Nom du champ */
-    name?: string;
-}
-export declare function WakaCombobox<T = string>({ options: initialOptions, value, onChange, placeholder, searchPlaceholder, emptyMessage, multiple, creatable, onCreate, createLabel, onSearch, searchDebounce, disabled, error, loading: externalLoading, size, clearable, maxSelections, className, id, name, }: WakaComboboxProps<T>): import("react/jsx-runtime").JSX.Element;
-export interface UseComboboxOptions<T = string> {
-    /** Options initiales */
-    options?: ComboboxOption<T>[];
-    /** Valeur initiale */
-    initialValue?: T | T[];
-    /** Mode multiple */
-    multiple?: boolean;
-}
-export declare function useCombobox<T = string>(options?: UseComboboxOptions<T>): {
-    value: T | T[] | undefined;
-    onChange: React.Dispatch<React.SetStateAction<T | T[] | undefined>>;
-    options: ComboboxOption<T>[];
-    setOptions: React.Dispatch<React.SetStateAction<ComboboxOption<T>[]>>;
-    clear: () => void;
-    addOption: (option: ComboboxOption<T>) => void;
-    removeOption: (valueToRemove: T) => void;
-    selectAll: () => void;
-    selectNone: () => void;
-    multiple: boolean;
-};
-export default WakaCombobox;

package/dist/src/components/waka-command-bar/index.d.ts

@@ -1,45 +0,0 @@
-import * as React from "react";
-export interface CommandItem {
-    id: string;
-    label: string;
-    description?: string;
-    icon?: React.ReactNode;
-    shortcut?: string[];
-    category?: string;
-    action?: () => void;
-    href?: string;
-    keywords?: string[];
-}
-export interface CommandCategory {
-    id: string;
-    label: string;
-    items: CommandItem[];
-}
-export interface WakaCommandBarProps {
-    /** Whether the command bar is open */
-    open: boolean;
-    /** Callback when open state changes */
-    onOpenChange: (open: boolean) => void;
-    /** Command items or categories */
-    items: CommandItem[] | CommandCategory[];
-    /** Placeholder text */
-    placeholder?: string;
-    /** Called when an item is selected */
-    onSelect?: (item: CommandItem) => void;
-    /** Custom empty state */
-    emptyMessage?: string;
-    /** Show recent items */
-    recentItems?: CommandItem[];
-    /** Custom footer content */
-    footer?: React.ReactNode;
-    /** Keyboard shortcut to open (default: cmd+k) */
-    shortcut?: string[];
-}
-export declare function WakaCommandBar({ open, onOpenChange, items, placeholder, onSelect, emptyMessage, recentItems, footer, shortcut, }: WakaCommandBarProps): import("react/jsx-runtime").JSX.Element | null;
-export declare function useCommandBar(): {
-    open: boolean;
-    onOpenChange: React.Dispatch<React.SetStateAction<boolean>>;
-    openCommandBar: () => void;
-    closeCommandBar: () => void;
-    toggleCommandBar: () => void;
-};