@wakastellar/ui 3.5.0 → 4.0.0-dev.0

package/dist/components/waka-kubernetes-overview/index.d.ts

@@ -0,0 +1,98 @@
+export type NodeStatus = "Ready" | "NotReady" | "Unknown";
+export type PodPhase = "Running" | "Pending" | "Succeeded" | "Failed" | "Unknown";
+export type DeploymentStatus = "Available" | "Progressing" | "Degraded";
+export interface K8sNode {
+    name: string;
+    status: NodeStatus;
+    roles: string[];
+    version: string;
+    cpu: {
+        used: number;
+        total: number;
+    };
+    memory: {
+        used: number;
+        total: number;
+    };
+    pods: {
+        running: number;
+        total: number;
+    };
+    conditions?: Array<{
+        type: string;
+        status: boolean;
+        message?: string;
+    }>;
+}
+export interface K8sPod {
+    name: string;
+    namespace: string;
+    phase: PodPhase;
+    ready: string;
+    restarts: number;
+    age: string;
+    node?: string;
+    labels?: Record<string, string>;
+}
+export interface K8sDeployment {
+    name: string;
+    namespace: string;
+    replicas: {
+        ready: number;
+        desired: number;
+    };
+    status: DeploymentStatus;
+    age: string;
+    image?: string;
+}
+export interface K8sService {
+    name: string;
+    namespace: string;
+    type: "ClusterIP" | "NodePort" | "LoadBalancer" | "ExternalName";
+    clusterIP: string;
+    externalIP?: string;
+    ports: Array<{
+        port: number;
+        targetPort: number;
+        protocol: string;
+    }>;
+    age: string;
+}
+export interface K8sNamespace {
+    name: string;
+    status: "Active" | "Terminating";
+    age: string;
+    labels?: Record<string, string>;
+}
+export interface WakaKubernetesOverviewProps {
+    /** Cluster name */
+    clusterName?: string;
+    /** List of nodes */
+    nodes: K8sNode[];
+    /** List of pods */
+    pods: K8sPod[];
+    /** List of deployments */
+    deployments: K8sDeployment[];
+    /** List of services */
+    services: K8sService[];
+    /** List of namespaces */
+    namespaces: K8sNamespace[];
+    /** Selected namespace filter */
+    selectedNamespace?: string;
+    /** Callback when changing namespace */
+    onNamespaceChange?: (namespace: string) => void;
+    /** Callback when clicking on a resource */
+    onResourceClick?: (type: string, name: string, namespace?: string) => void;
+    /** Callback when refreshing */
+    onRefresh?: () => void;
+    /** Whether data is loading */
+    isLoading?: boolean;
+    /** Custom class name */
+    className?: string;
+}
+export declare function WakaKubernetesOverview({ clusterName, nodes, pods, deployments, services, namespaces, selectedNamespace, onNamespaceChange, onResourceClick, onRefresh, isLoading, className, }: WakaKubernetesOverviewProps): import("react/jsx-runtime").JSX.Element;
+export declare const defaultK8sNodes: K8sNode[];
+export declare const defaultK8sPods: K8sPod[];
+export declare const defaultK8sDeployments: K8sDeployment[];
+export declare const defaultK8sServices: K8sService[];
+export declare const defaultK8sNamespaces: K8sNamespace[];

package/dist/components/waka-leaderboard/index.d.ts

@@ -0,0 +1,85 @@
+export interface LeaderboardEntry {
+    /** Unique identifier */
+    id: string;
+    /** User display name */
+    name: string;
+    /** Avatar URL or initials */
+    avatar?: string;
+    /** Current score/points */
+    score: number;
+    /** Current rank position */
+    rank: number;
+    /** Previous rank (for animation) */
+    previousRank?: number;
+    /** Additional metadata */
+    metadata?: Record<string, string | number>;
+    /** Whether this is the current user */
+    isCurrentUser?: boolean;
+}
+export interface WakaLeaderboardProps {
+    /** Leaderboard entries */
+    entries: LeaderboardEntry[];
+    /** Title of the leaderboard */
+    title?: string;
+    /** Show podium for top 3 */
+    showPodium?: boolean;
+    /** Animate rank changes */
+    animateRankChanges?: boolean;
+    /** Maximum entries to show (excluding podium) */
+    maxEntries?: number;
+    /** Score label (e.g., "points", "XP", "wins") */
+    scoreLabel?: string;
+    /** Format score function */
+    formatScore?: (score: number) => string;
+    /** Current user ID (for highlighting) */
+    currentUserId?: string;
+    /** Callback when entry is clicked */
+    onEntryClick?: (entry: LeaderboardEntry) => void;
+    /** Show rank change indicators */
+    showRankChange?: boolean;
+    /** Size variant */
+    size?: "sm" | "default" | "lg";
+    /** Custom className */
+    className?: string;
+}
+export interface WakaPodiumProps {
+    /** Top 3 entries */
+    entries: LeaderboardEntry[];
+    /** Size variant */
+    size?: "sm" | "default" | "lg";
+    /** Score label */
+    scoreLabel?: string;
+    /** Format score function */
+    formatScore?: (score: number) => string;
+    /** Callback when entry is clicked */
+    onEntryClick?: (entry: LeaderboardEntry) => void;
+    /** Custom className */
+    className?: string;
+}
+export declare function WakaPodium({ entries, size, scoreLabel, formatScore, onEntryClick, className, }: WakaPodiumProps): import("react/jsx-runtime").JSX.Element;
+export declare function WakaLeaderboard({ entries, title, showPodium, animateRankChanges, maxEntries, scoreLabel, formatScore, currentUserId, onEntryClick, showRankChange, size, className, }: WakaLeaderboardProps): import("react/jsx-runtime").JSX.Element;
+export interface WakaMiniLeaderboardProps {
+    entries: LeaderboardEntry[];
+    maxEntries?: number;
+    currentUserId?: string;
+    className?: string;
+}
+export declare function WakaMiniLeaderboard({ entries, maxEntries, currentUserId, className, }: WakaMiniLeaderboardProps): import("react/jsx-runtime").JSX.Element;
+export interface UseLeaderboardOptions {
+    /** Initial entries */
+    entries: LeaderboardEntry[];
+    /** Sort direction */
+    sortDirection?: "asc" | "desc";
+    /** Auto-update rankings when scores change */
+    autoRank?: boolean;
+}
+export declare function useLeaderboard({ entries: initialEntries, sortDirection, autoRank, }: UseLeaderboardOptions): {
+    entries: LeaderboardEntry[];
+    updateScore: (id: string, score: number) => void;
+    addEntry: (entry: Omit<LeaderboardEntry, "rank">) => void;
+    removeEntry: (id: string) => void;
+    refresh: (newEntries: LeaderboardEntry[]) => void;
+    topEntry: LeaderboardEntry;
+    getEntry: (id: string) => LeaderboardEntry;
+    getRank: (id: string) => number;
+};

package/dist/components/waka-level-progress/index.d.ts

@@ -0,0 +1,89 @@
+import * as React from "react";
+export interface LevelMilestone {
+    /** Level number */
+    level: number;
+    /** XP required to reach this level */
+    xpRequired: number;
+    /** Optional label for the milestone */
+    label?: string;
+    /** Optional icon */
+    icon?: React.ReactNode;
+    /** Optional reward description */
+    reward?: string;
+}
+export interface WakaLevelProgressProps {
+    /** Current XP amount */
+    currentXp: number;
+    /** Current level */
+    currentLevel: number;
+    /** XP required for next level */
+    xpForNextLevel: number;
+    /** XP at the start of current level */
+    xpAtCurrentLevel?: number;
+    /** Custom level label */
+    levelLabel?: string;
+    /** Size variant */
+    size?: "sm" | "default" | "lg";
+    /** Show XP numbers */
+    showXpNumbers?: boolean;
+    /** Show percentage */
+    showPercentage?: boolean;
+    /** Milestone markers */
+    milestones?: LevelMilestone[];
+    /** Animate progress changes */
+    animate?: boolean;
+    /** Show level up celebration */
+    showLevelUpCelebration?: boolean;
+    /** Callback when level up occurs */
+    onLevelUp?: (newLevel: number) => void;
+    /** Color theme */
+    theme?: "default" | "gold" | "purple" | "green" | "blue";
+    /** Custom className */
+    className?: string;
+}
+export interface WakaLevelBadgeProps {
+    /** Level number */
+    level: number;
+    /** Size variant */
+    size?: "sm" | "default" | "lg" | "xl";
+    /** Show animated effects */
+    animated?: boolean;
+    /** Color theme */
+    theme?: "default" | "gold" | "purple" | "green" | "blue";
+    /** Custom className */
+    className?: string;
+}
+export declare function WakaLevelBadge({ level, size, animated, theme, className, }: WakaLevelBadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function WakaLevelProgress({ currentXp, currentLevel, xpForNextLevel, xpAtCurrentLevel, levelLabel, size, showXpNumbers, showPercentage, milestones, animate, showLevelUpCelebration, onLevelUp, theme, className, }: WakaLevelProgressProps): import("react/jsx-runtime").JSX.Element;
+export interface WakaCompactLevelProgressProps {
+    currentLevel: number;
+    progressPercent: number;
+    theme?: "default" | "gold" | "purple" | "green" | "blue";
+    className?: string;
+}
+export declare function WakaCompactLevelProgress({ currentLevel, progressPercent, theme, className, }: WakaCompactLevelProgressProps): import("react/jsx-runtime").JSX.Element;
+export interface UseLevelProgressOptions {
+    /** Initial XP */
+    initialXp?: number;
+    /** XP required per level (can be a function for dynamic scaling) */
+    xpPerLevel?: number | ((level: number) => number);
+    /** Maximum level */
+    maxLevel?: number;
+    /** Callback when level changes */
+    onLevelChange?: (level: number, previousLevel: number) => void;
+}
+export declare function useLevelProgress({ initialXp, xpPerLevel, maxLevel, onLevelChange, }?: UseLevelProgressOptions): {
+    totalXp: number;
+    currentLevel: number;
+    currentXp: number;
+    xpAtCurrentLevel: number;
+    xpForNextLevel: number;
+    xpInCurrentLevel: number;
+    xpNeededForLevel: number;
+    xpRemaining: number;
+    progressPercent: number;
+    addXp: (amount: number) => void;
+    setXp: (amount: number) => void;
+    reset: () => void;
+    isMaxLevel: boolean;
+};

package/dist/components/waka-liquid-button/index.d.ts

@@ -0,0 +1,46 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+export type LiquidButtonSize = "sm" | "default" | "lg" | "xl";
+export type LiquidButtonVariant = "default" | "secondary" | "destructive" | "success" | "gradient" | "neon";
+export interface WakaLiquidButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "children">, VariantProps<typeof liquidButtonVariants> {
+    /** Button content */
+    children: React.ReactNode;
+    /** Enable liquid morphing effect */
+    liquidEffect?: boolean;
+    /** Intensity of the liquid effect (0-1) */
+    liquidIntensity?: number;
+    /** Speed of the liquid animation in ms */
+    liquidSpeed?: number;
+    /** Number of blob points for the liquid effect */
+    blobPoints?: number;
+    /** Loading state with liquid animation */
+    loading?: boolean;
+    /** Loading text */
+    loadingText?: string;
+    /** Icon to show before children */
+    leftIcon?: React.ReactNode;
+    /** Icon to show after children */
+    rightIcon?: React.ReactNode;
+    /** Unique ID for SVG filter (auto-generated if not provided) */
+    filterId?: string;
+}
+declare const liquidButtonVariants: (props?: {
+    variant?: "default" | "gradient" | "destructive" | "secondary" | "success" | "neon";
+    size?: "default" | "sm" | "lg" | "xl";
+    rounded?: "default" | "sm" | "lg" | "full";
+} & import("class-variance-authority/types").ClassProp) => string;
+/**
+ * @deprecated Since v3.6 — will be removed in v4.0.
+ * Use `WakaFancyButton variant="liquid"` instead (futur, dans `@wakastellar/ui-effects-decorative`).
+ * See `docs/audit/remove-relocate.md` §2.1.
+ */
+export declare const WakaLiquidButton: React.ForwardRefExoticComponent<WakaLiquidButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export interface WakaLiquidButtonPresetProps extends Omit<WakaLiquidButtonProps, "variant"> {
+}
+export declare const WakaLiquidButtonPrimary: React.ForwardRefExoticComponent<WakaLiquidButtonPresetProps & React.RefAttributes<HTMLButtonElement>>;
+export declare const WakaLiquidButtonSecondary: React.ForwardRefExoticComponent<WakaLiquidButtonPresetProps & React.RefAttributes<HTMLButtonElement>>;
+export declare const WakaLiquidButtonDestructive: React.ForwardRefExoticComponent<WakaLiquidButtonPresetProps & React.RefAttributes<HTMLButtonElement>>;
+export declare const WakaLiquidButtonSuccess: React.ForwardRefExoticComponent<WakaLiquidButtonPresetProps & React.RefAttributes<HTMLButtonElement>>;
+export declare const WakaLiquidButtonGradient: React.ForwardRefExoticComponent<WakaLiquidButtonPresetProps & React.RefAttributes<HTMLButtonElement>>;
+export declare const WakaLiquidButtonNeon: React.ForwardRefExoticComponent<WakaLiquidButtonPresetProps & React.RefAttributes<HTMLButtonElement>>;
+export {};

package/dist/components/waka-loading-orbit/index.d.ts

@@ -0,0 +1,90 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+export interface OrbitConfig {
+    /** Orbit radius relative to container (0-1) */
+    radius: number;
+    /** Orbit duration in seconds */
+    duration: number;
+    /** Planet size in pixels */
+    planetSize: number;
+    /** Planet color */
+    color: string;
+    /** Starting angle offset in degrees */
+    startAngle?: number;
+    /** Orbit direction */
+    direction?: "clockwise" | "counterclockwise";
+    /** Planet opacity */
+    opacity?: number;
+    /** Show orbit path */
+    showPath?: boolean;
+    /** Orbit path opacity */
+    pathOpacity?: number;
+}
+export interface WakaLoadingOrbitProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof orbitVariants> {
+    /** Custom orbit configurations */
+    orbits?: OrbitConfig[];
+    /** Number of orbits (if not using custom config) */
+    orbitCount?: number;
+    /** Base color for planets (used when orbits not specified) */
+    primaryColor?: string;
+    /** Secondary color for planets */
+    secondaryColor?: string;
+    /** Accent color for planets */
+    accentColor?: string;
+    /** Show orbit paths */
+    showPaths?: boolean;
+    /** Center icon/content */
+    centerIcon?: React.ReactNode;
+    /** Center icon color */
+    centerColor?: string;
+    /** Center dot size multiplier */
+    centerScale?: number;
+    /** Pause animation */
+    paused?: boolean;
+}
+declare const orbitVariants: (props?: {
+    size?: "sm" | "md" | "lg" | "xl";
+} & import("class-variance-authority/types").ClassProp) => string;
+export declare const WakaLoadingOrbit: React.ForwardRefExoticComponent<WakaLoadingOrbitProps & React.RefAttributes<HTMLDivElement>>;
+export declare const orbitPresets: {
+    /** Simple two-planet system */
+    simple: ({
+        radius: number;
+        duration: number;
+        planetSize: number;
+        color: string;
+        direction: "clockwise";
+    } | {
+        radius: number;
+        duration: number;
+        planetSize: number;
+        color: string;
+        direction: "counterclockwise";
+    })[];
+    /** Solar system style with many planets */
+    solar: OrbitConfig[];
+    /** Fast spinning atoms style */
+    atom: OrbitConfig[];
+    /** Minimal single orbit */
+    minimal: OrbitConfig[];
+    /** Galaxy spiral effect */
+    galaxy: OrbitConfig[];
+};
+export declare const WakaLoadingOrbitSimple: React.ForwardRefExoticComponent<Omit<WakaLoadingOrbitProps, "orbits"> & React.RefAttributes<HTMLDivElement>>;
+export declare const WakaLoadingOrbitSolar: React.ForwardRefExoticComponent<Omit<WakaLoadingOrbitProps, "orbits"> & React.RefAttributes<HTMLDivElement>>;
+export declare const WakaLoadingOrbitAtom: React.ForwardRefExoticComponent<Omit<WakaLoadingOrbitProps, "orbits"> & React.RefAttributes<HTMLDivElement>>;
+export declare const WakaLoadingOrbitMinimal: React.ForwardRefExoticComponent<Omit<WakaLoadingOrbitProps, "orbits"> & React.RefAttributes<HTMLDivElement>>;
+export declare const WakaLoadingOrbitGalaxy: React.ForwardRefExoticComponent<Omit<WakaLoadingOrbitProps, "orbits"> & React.RefAttributes<HTMLDivElement>>;
+export interface UseLoadingOrbitOptions {
+    count?: number;
+    minRadius?: number;
+    maxRadius?: number;
+    minDuration?: number;
+    maxDuration?: number;
+    colors?: string[];
+    showPaths?: boolean;
+}
+export declare function useLoadingOrbit(options?: UseLoadingOrbitOptions): {
+    orbits: OrbitConfig[];
+};
+export {};

package/dist/components/waka-log-viewer/index.d.ts

@@ -0,0 +1,38 @@
+export type LogLevel = "error" | "warn" | "info" | "debug" | "trace";
+export interface LogEntry {
+    id: string;
+    timestamp: Date;
+    level: LogLevel;
+    message: string;
+    source?: string;
+    metadata?: Record<string, unknown>;
+    stackTrace?: string;
+}
+export interface WakaLogViewerProps {
+    /** Log entries to display */
+    logs: LogEntry[];
+    /** Callback when requesting more logs */
+    onLoadMore?: () => void;
+    /** Callback when clearing logs */
+    onClear?: () => void;
+    /** Callback when exporting logs */
+    onExport?: (logs: LogEntry[]) => void;
+    /** Whether streaming is active */
+    isStreaming?: boolean;
+    /** Callback to toggle streaming */
+    onToggleStreaming?: () => void;
+    /** Maximum number of logs to display */
+    maxLogs?: number;
+    /** Show timestamp */
+    showTimestamp?: boolean;
+    /** Show source */
+    showSource?: boolean;
+    /** Enable auto-scroll to bottom */
+    autoScroll?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Title */
+    title?: string;
+}
+export declare function WakaLogViewer({ logs, onLoadMore, onClear, onExport, isStreaming, onToggleStreaming, maxLogs, showTimestamp, showSource, autoScroll, className, title, }: WakaLogViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare const defaultLogs: LogEntry[];

package/dist/components/waka-loot-box/index.d.ts

@@ -0,0 +1,87 @@
+import * as React from "react";
+export type LootBoxRarity = "common" | "rare" | "epic" | "legendary";
+export interface LootBoxItem {
+    /** Unique identifier */
+    id: string;
+    /** Item name */
+    name: string;
+    /** Item description */
+    description?: string;
+    /** Rarity tier */
+    rarity: LootBoxRarity;
+    /** Custom icon or image */
+    icon?: React.ReactNode;
+    /** Image URL for the item */
+    imageUrl?: string;
+    /** Quantity of this item */
+    quantity?: number;
+    /** Any additional data */
+    value?: unknown;
+}
+export interface WakaLootBoxProps {
+    /** Items contained in the loot box */
+    items: LootBoxItem[];
+    /** Whether the box is open */
+    isOpen?: boolean;
+    /** Callback when box is opened */
+    onOpen?: () => void;
+    /** Callback when reveal sequence completes */
+    onRevealComplete?: (items: LootBoxItem[]) => void;
+    /** Callback when closed */
+    onClose?: () => void;
+    /** Enable sound effects */
+    enableSound?: boolean;
+    /** Audio source for opening sound */
+    openSoundSrc?: string;
+    /** Audio source for reveal sound */
+    revealSoundSrc?: string;
+    /** Box visual style */
+    variant?: "chest" | "crate" | "gift" | "orb";
+    /** Size variant */
+    size?: "sm" | "default" | "lg";
+    /** Custom className */
+    className?: string;
+    /** Disable interaction */
+    disabled?: boolean;
+    /** Auto-reveal all items without navigation */
+    autoReveal?: boolean;
+    /** Delay between auto-reveal items (ms) */
+    autoRevealDelay?: number;
+}
+export interface UseLootBoxOptions {
+    /** Initial items in the box */
+    items?: LootBoxItem[];
+    /** Callback when reveal completes */
+    onRevealComplete?: (items: LootBoxItem[]) => void;
+}
+export interface UseLootBoxReturn {
+    /** Current items in the box */
+    items: LootBoxItem[];
+    /** Whether the box is currently open */
+    isOpen: boolean;
+    /** Current animation phase */
+    phase: LootBoxPhase;
+    /** Current item index being shown */
+    currentItemIndex: number;
+    /** Open the box */
+    open: () => void;
+    /** Close the box and reset */
+    close: () => void;
+    /** Go to next item */
+    nextItem: () => void;
+    /** Go to previous item */
+    prevItem: () => void;
+    /** Skip to reveal all */
+    skipToEnd: () => void;
+    /** Set new items */
+    setItems: (items: LootBoxItem[]) => void;
+    /** Reset state */
+    reset: () => void;
+}
+export type LootBoxPhase = "idle" | "shaking" | "glowing" | "opening" | "revealing" | "complete";
+export declare function useLootBox({ items: initialItems, onRevealComplete, }?: UseLootBoxOptions): UseLootBoxReturn;
+export declare function WakaLootBox({ items, isOpen: controlledIsOpen, onOpen, onRevealComplete, onClose, enableSound, openSoundSrc, revealSoundSrc, variant, size, className, disabled, autoReveal, autoRevealDelay, }: WakaLootBoxProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace WakaLootBox {
+    var displayName: string;
+}
+export default WakaLootBox;

package/dist/components/waka-magic-link/index.d.ts

@@ -0,0 +1,34 @@
+export type MagicLinkState = "idle" | "loading" | "sent" | "error";
+export interface WakaMagicLinkProps {
+    /** Called when email is submitted */
+    onSubmit: (email: string) => Promise<void> | void;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Button text for different states */
+    buttonText?: {
+        idle?: string;
+        loading?: string;
+        sent?: string;
+    };
+    /** Success message */
+    successMessage?: string;
+    /** Error message */
+    errorMessage?: string;
+    /** Countdown duration in seconds (0 to disable) */
+    countdownDuration?: number;
+    /** Allow resend after countdown */
+    onResend?: () => void;
+    /** Custom className */
+    className?: string;
+    /** Size variant */
+    size?: "sm" | "default" | "lg";
+    /** Visual variant */
+    variant?: "default" | "minimal" | "gradient";
+}
+export declare function WakaMagicLink({ onSubmit, placeholder, buttonText, successMessage, errorMessage, countdownDuration, onResend, className, size, variant, }: WakaMagicLinkProps): import("react/jsx-runtime").JSX.Element;
+export declare function useMagicLink(): {
+    state: MagicLinkState;
+    email: string;
+    sendMagicLink: (emailAddress: string, sendFn: (email: string) => Promise<void>) => Promise<void>;
+    reset: () => void;
+};

package/dist/components/waka-magnetic-button/index.d.ts

@@ -0,0 +1,61 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+export type MagneticButtonVariant = "default" | "secondary" | "destructive" | "outline" | "ghost" | "gradient";
+export interface WakaMagneticButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "children">, VariantProps<typeof magneticButtonVariants> {
+    /** Button content */
+    children: React.ReactNode;
+    /** Enable magnetic attraction effect */
+    magneticEnabled?: boolean;
+    /** Attraction radius in pixels */
+    attractionRadius?: number;
+    /** Attraction strength (0-1) */
+    attractionStrength?: number;
+    /** Smooth follow animation duration in ms */
+    followDuration?: number;
+    /** Enable ripple effect on click */
+    rippleEnabled?: boolean;
+    /** Ripple color */
+    rippleColor?: string;
+    /** Ripple duration in ms */
+    rippleDuration?: number;
+    /** Enable content movement with magnetic effect */
+    moveContent?: boolean;
+    /** Content movement strength (0-1) */
+    contentMoveStrength?: number;
+    /** Icon to show before children */
+    leftIcon?: React.ReactNode;
+    /** Icon to show after children */
+    rightIcon?: React.ReactNode;
+    /** Loading state */
+    loading?: boolean;
+}
+declare const magneticButtonVariants: (props?: {
+    variant?: "default" | "gradient" | "outline" | "destructive" | "secondary" | "ghost";
+    size?: "default" | "sm" | "lg" | "xl" | "icon" | "icon-sm" | "icon-lg";
+    rounded?: "default" | "sm" | "lg" | "full";
+} & import("class-variance-authority/types").ClassProp) => string;
+/**
+ * @deprecated Since v3.6 — will be removed in v4.0.
+ * Use `WakaFancyButton variant="magnetic"` instead (futur, dans `@wakastellar/ui-effects-decorative`).
+ * See `docs/audit/remove-relocate.md` §2.1.
+ */
+export declare const WakaMagneticButton: React.ForwardRefExoticComponent<WakaMagneticButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export interface WakaMagneticIconButtonProps extends Omit<WakaMagneticButtonProps, "children" | "leftIcon" | "rightIcon"> {
+    /** Icon to display */
+    icon: React.ReactNode;
+    /** Accessible label */
+    "aria-label": string;
+}
+export declare const WakaMagneticIconButton: React.ForwardRefExoticComponent<WakaMagneticIconButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export interface WakaMagneticLinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    /** Enable magnetic effect */
+    magneticEnabled?: boolean;
+    /** Attraction radius in pixels */
+    attractionRadius?: number;
+    /** Attraction strength (0-1) */
+    attractionStrength?: number;
+    /** Animation duration in ms */
+    followDuration?: number;
+}
+export declare const WakaMagneticLink: React.ForwardRefExoticComponent<WakaMagneticLinkProps & React.RefAttributes<HTMLAnchorElement>>;
+export {};