@wakastellar/ui 3.5.2 → 4.0.0

package/dist/components/waka-doc-renderer/index.d.ts

@@ -0,0 +1,7 @@
+import type { TocItem } from "../waka-doc-toc";
+export interface WakaDocRendererProps {
+    content: string;
+    onHeadingsExtracted?: (headings: TocItem[]) => void;
+    className?: string;
+}
+export declare function WakaDocRenderer({ content, onHeadingsExtracted, className }: WakaDocRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/waka-doc-search/index.d.ts

@@ -0,0 +1,23 @@
+export interface DocSearchPage {
+    id: string;
+    title: string;
+    content: string;
+    category?: string;
+    href?: string;
+}
+export interface DocSearchResult {
+    page: DocSearchPage;
+    snippet: string;
+}
+export interface WakaDocSearchProps {
+    pages: DocSearchPage[];
+    onSelect?: (page: DocSearchPage) => void;
+    placeholder?: string;
+    className?: string;
+}
+/**
+ * @deprecated Since v3.6 — will be removed in v4.0.
+ * Use the `@wakastellar/ui-docs` sub-package (`<DocSearch>` with shared provider) instead.
+ * See `docs/audit/remove-relocate.md` §2.2.
+ */
+export declare function WakaDocSearch({ pages, onSelect, placeholder, className, }: WakaDocSearchProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/waka-doc-toc/index.d.ts

@@ -0,0 +1,11 @@
+export interface TocItem {
+    id: string;
+    text: string;
+    level: number;
+}
+export interface WakaDocTocProps {
+    items: TocItem[];
+    activeId?: string;
+    className?: string;
+}
+export declare function WakaDocToc({ items, activeId, className }: WakaDocTocProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/waka-doc-toolbar/index.d.ts

@@ -0,0 +1,15 @@
+export type SaveStatus = "idle" | "saving" | "saved" | "error";
+export interface WakaDocToolbarProps {
+    content: string;
+    mode?: "view" | "edit";
+    canEdit?: boolean;
+    onModeChange?: (mode: "view" | "edit") => void;
+    saveStatus?: SaveStatus;
+    className?: string;
+}
+/**
+ * @deprecated Since v3.6 — will be removed in v4.0.
+ * Use the `@wakastellar/ui-docs` sub-package (`<DocToolbar>` with shared provider) instead.
+ * See `docs/audit/remove-relocate.md` §2.2.
+ */
+export declare function WakaDocToolbar({ content, mode, canEdit, onModeChange, saveStatus, className, }: WakaDocToolbarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,49 @@
+import * as React from "react";
+export interface DockItem {
+    id: string;
+    icon: React.ReactNode;
+    label: string;
+    onClick?: () => void;
+    href?: string;
+    badge?: number | string;
+    active?: boolean;
+}
+export interface WakaDockProps {
+    /** Dock items */
+    items: DockItem[];
+    /** Position of the dock */
+    position?: "bottom" | "left" | "right";
+    /** Size of icons */
+    size?: "sm" | "default" | "lg";
+    /** Magnification factor */
+    magnification?: number;
+    /** Distance for magnification effect */
+    magnificationDistance?: number;
+    /** Show labels on hover */
+    showLabels?: boolean;
+    /** Use fixed positioning (default: true) */
+    fixed?: boolean;
+    /** Custom className */
+    className?: string;
+}
+/**
+ * @deprecated Since v3.6 — will be removed in v4.0.
+ * Use the `@wakastellar/ui-docs` sub-package (`<DocDock>` with shared provider) instead.
+ * See `docs/audit/remove-relocate.md` §2.2.
+ */
+export declare function WakaDock({ items, position, size, magnification, magnificationDistance, showLabels, fixed, className, }: WakaDockProps): import("react/jsx-runtime").JSX.Element;
+export interface WakaFloatingDockProps extends WakaDockProps {
+    /** Show after scrolling this many pixels */
+    showAfter?: number;
+    /** Auto-hide after inactivity (ms) */
+    autoHideDelay?: number;
+}
+export declare function WakaFloatingDock({ showAfter, autoHideDelay, ...props }: WakaFloatingDockProps): import("react/jsx-runtime").JSX.Element;
+export interface AppDockSection {
+    items: DockItem[];
+}
+export interface WakaAppDockProps extends Omit<WakaDockProps, "items"> {
+    /** Sections of items (separated by dividers) */
+    sections: AppDockSection[];
+}
+export declare function WakaAppDock({ sections, ...props }: WakaAppDockProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/waka-error-shake/index.d.ts

@@ -0,0 +1,49 @@
+import * as React from "react";
+export type ShakeIntensity = "light" | "medium" | "strong";
+export interface WakaErrorShakeProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Trigger the shake animation */
+    trigger?: boolean;
+    /** Shake animation intensity */
+    intensity?: ShakeIntensity;
+    /** Duration of the shake animation in ms */
+    duration?: number;
+    /** Enable glitch/distortion effect */
+    glitchEffect?: boolean;
+    /** Enable red flash effect */
+    flashEffect?: boolean;
+    /** Flash color (CSS color value) */
+    flashColor?: string;
+    /** Callback when animation completes */
+    onComplete?: () => void;
+    /** Children to wrap */
+    children: React.ReactNode;
+}
+export interface WakaErrorShakeRef {
+    /** Trigger the shake animation */
+    shake: () => void;
+    /** Reset the component */
+    reset: () => void;
+}
+export declare const WakaErrorShake: React.ForwardRefExoticComponent<WakaErrorShakeProps & React.RefAttributes<WakaErrorShakeRef>>;
+export interface UseErrorShakeOptions {
+    intensity?: ShakeIntensity;
+    duration?: number;
+    glitchEffect?: boolean;
+    flashEffect?: boolean;
+    flashColor?: string;
+    onComplete?: () => void;
+}
+export declare function useErrorShake(options?: UseErrorShakeOptions): {
+    ref: React.MutableRefObject<WakaErrorShakeRef>;
+    isShaking: boolean;
+    shake: () => void;
+    reset: () => void;
+    ShakeWrapper: ({ children }: {
+        children: React.ReactNode;
+    }) => import("react/jsx-runtime").JSX.Element;
+};
+export interface WakaFormFieldShakeProps extends Omit<WakaErrorShakeProps, "trigger"> {
+    /** Error state - triggers shake when transitioning from false to true */
+    hasError?: boolean;
+}
+export declare const WakaFormFieldShake: React.ForwardRefExoticComponent<WakaFormFieldShakeProps & React.RefAttributes<WakaErrorShakeRef>>;

package/dist/components/waka-feature-announcement/index.d.ts

@@ -0,0 +1,112 @@
+export interface FeatureMedia {
+    /** Media type */
+    type: "image" | "video";
+    /** Media URL */
+    src: string;
+    /** Alt text for accessibility */
+    alt: string;
+    /** Poster image for video */
+    poster?: string;
+}
+export interface FeatureData {
+    /** Unique identifier */
+    id: string;
+    /** Feature title */
+    title: string;
+    /** Feature description */
+    description: string;
+    /** Screenshot or video preview */
+    media?: FeatureMedia;
+    /** Version number (e.g., "2.0.0") */
+    version?: string;
+    /** Release date */
+    releaseDate?: Date | string;
+    /** Learn more link */
+    learnMoreUrl?: string;
+    /** Learn more link text */
+    learnMoreText?: string;
+    /** Custom badge text (defaults to "What's New") */
+    badgeText?: string;
+    /** Custom badge color */
+    badgeVariant?: "default" | "primary" | "success" | "warning";
+}
+export type FeatureAnnouncementMode = "modal" | "banner";
+export interface WakaFeatureAnnouncementProps {
+    /** Array of features to display */
+    features: FeatureData[];
+    /** Display mode - modal or inline banner */
+    mode?: FeatureAnnouncementMode;
+    /** Whether the announcement is open/visible */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Callback when a feature is viewed */
+    onFeatureView?: (feature: FeatureData, index: number) => void;
+    /** Callback when learn more is clicked */
+    onLearnMore?: (feature: FeatureData) => void;
+    /** Callback when dismissed */
+    onDismiss?: () => void;
+    /** Dismiss button text */
+    dismissText?: string;
+    /** Show navigation dots */
+    showDots?: boolean;
+    /** Show navigation arrows */
+    showArrows?: boolean;
+    /** Auto-advance through features */
+    autoAdvance?: boolean;
+    /** Auto-advance interval in milliseconds */
+    autoAdvanceInterval?: number;
+    /** Close on overlay click (modal mode only) */
+    closeOnOverlayClick?: boolean;
+    /** Close on escape key */
+    closeOnEscape?: boolean;
+    /** Size variant (modal mode only) */
+    size?: "sm" | "md" | "lg";
+    /** Custom className */
+    className?: string;
+    /** Custom className for overlay (modal mode only) */
+    overlayClassName?: string;
+}
+export interface UseFeatureAnnouncementOptions {
+    /** Initial open state */
+    defaultOpen?: boolean;
+    /** Storage key for dismissed state */
+    storageKey?: string;
+    /** Features to display */
+    features?: FeatureData[];
+    /** Version to track for dismissal */
+    currentVersion?: string;
+    /** Callback when opened */
+    onOpen?: () => void;
+    /** Callback when closed */
+    onClose?: () => void;
+}
+export interface UseFeatureAnnouncementReturn {
+    /** Whether the announcement is open */
+    isOpen: boolean;
+    /** Open the announcement */
+    open: () => void;
+    /** Close the announcement */
+    close: () => void;
+    /** Toggle the announcement */
+    toggle: () => void;
+    /** Handle open change from component */
+    onOpenChange: (open: boolean) => void;
+    /** Mark as seen/dismissed */
+    markAsSeen: () => void;
+    /** Check if has been seen */
+    hasBeenSeen: boolean;
+    /** Current feature index */
+    currentIndex: number;
+    /** Set current feature index */
+    setCurrentIndex: (index: number) => void;
+    /** Go to next feature */
+    nextFeature: () => void;
+    /** Go to previous feature */
+    previousFeature: () => void;
+    /** Total number of features */
+    totalFeatures: number;
+}
+export declare function WakaFeatureAnnouncement({ features, mode, open, onOpenChange, onFeatureView, onLearnMore, onDismiss, dismissText, showDots, showArrows, autoAdvance, autoAdvanceInterval, closeOnOverlayClick, closeOnEscape, size, className, overlayClassName, }: WakaFeatureAnnouncementProps): import("react/jsx-runtime").JSX.Element;
+export declare function useFeatureAnnouncement({ defaultOpen, storageKey, features, currentVersion, onOpen, onClose, }?: UseFeatureAnnouncementOptions): UseFeatureAnnouncementReturn;
+export default WakaFeatureAnnouncement;

package/dist/components/waka-flow-diagram/index.d.ts

@@ -0,0 +1,71 @@
+import * as React from "react";
+export interface FlowNode {
+    id: string;
+    type: "start" | "end" | "action" | "decision" | "process" | "custom";
+    label: string;
+    description?: string;
+    icon?: React.ReactNode;
+    position: {
+        x: number;
+        y: number;
+    };
+    data?: Record<string, unknown>;
+}
+export interface FlowConnection {
+    id: string;
+    from: string;
+    to: string;
+    label?: string;
+    animated?: boolean;
+    color?: string;
+}
+export interface WakaFlowDiagramProps {
+    /** Flow nodes */
+    nodes: FlowNode[];
+    /** Connections between nodes */
+    connections: FlowConnection[];
+    /** Called when nodes change */
+    onNodesChange?: (nodes: FlowNode[]) => void;
+    /** Called when connections change */
+    onConnectionsChange?: (connections: FlowConnection[]) => void;
+    /** Called when a node is clicked */
+    onNodeClick?: (node: FlowNode) => void;
+    /** Called when a node is double-clicked */
+    onNodeDoubleClick?: (node: FlowNode) => void;
+    /** Enable drag and drop */
+    draggable?: boolean;
+    /** Enable editing (add/remove nodes) */
+    editable?: boolean;
+    /** Zoom level (1 = 100%) */
+    zoom?: number;
+    /** Grid size for snapping */
+    gridSize?: number;
+    /** Show grid */
+    showGrid?: boolean;
+    /** Custom className */
+    className?: string;
+}
+export declare function WakaFlowDiagram({ nodes: initialNodes, connections: initialConnections, onNodesChange, onConnectionsChange, onNodeClick, onNodeDoubleClick, draggable, editable, zoom, gridSize, showGrid, className, }: WakaFlowDiagramProps): import("react/jsx-runtime").JSX.Element;
+export declare function useFlowDiagram(initialNodes?: FlowNode[], initialConnections?: FlowConnection[]): {
+    nodes: FlowNode[];
+    connections: FlowConnection[];
+    setNodes: React.Dispatch<React.SetStateAction<FlowNode[]>>;
+    setConnections: React.Dispatch<React.SetStateAction<FlowConnection[]>>;
+    addNode: (node: Omit<FlowNode, "id">) => {
+        id: string;
+        data?: Record<string, unknown>;
+        description?: string;
+        type: "start" | "end" | "action" | "decision" | "process" | "custom";
+        label: string;
+        icon?: React.ReactNode;
+        position: {
+            x: number;
+            y: number;
+        };
+    };
+    removeNode: (nodeId: string) => void;
+    updateNode: (nodeId: string, updates: Partial<FlowNode>) => void;
+    addConnection: (from: string, to: string, options?: Partial<FlowConnection>) => FlowConnection;
+    removeConnection: (connectionId: string) => void;
+    clear: () => void;
+};

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

@@ -0,0 +1,50 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+export type HapticPattern = "light" | "medium" | "heavy" | "success" | "warning" | "error" | "selection" | number[];
+export interface WakaHapticButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof hapticButtonVariants> {
+    /** Render as child component */
+    asChild?: boolean;
+    /** Haptic pattern on press */
+    hapticPattern?: HapticPattern;
+    /** Enable/disable haptic feedback */
+    hapticEnabled?: boolean;
+    /** Enable ripple effect */
+    ripple?: boolean;
+    /** Ripple color (CSS color value) */
+    rippleColor?: string;
+    /** Ripple duration in ms */
+    rippleDuration?: number;
+    /** Enable press scale animation */
+    pressScale?: boolean;
+    /** Scale factor on press (0-1) */
+    pressScaleFactor?: number;
+    /** Enable glow effect on press */
+    glowOnPress?: boolean;
+    /** Glow color (CSS color value) */
+    glowColor?: string;
+    /** Loading state */
+    loading?: boolean;
+    /** Icon to show before children */
+    leftIcon?: React.ReactNode;
+    /** Icon to show after children */
+    rightIcon?: React.ReactNode;
+}
+declare const hapticButtonVariants: (props?: {
+    variant?: "default" | "gradient" | "outline" | "glass" | "destructive" | "secondary" | "ghost" | "neon";
+    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="haptic"` instead (futur, dans `@wakastellar/ui-effects-decorative`).
+ * See `docs/audit/remove-relocate.md` §2.1.
+ */
+export declare const WakaHapticButton: React.ForwardRefExoticComponent<WakaHapticButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export interface WakaHapticIconButtonProps extends Omit<WakaHapticButtonProps, "children" | "leftIcon" | "rightIcon"> {
+    /** Icon to display */
+    icon: React.ReactNode;
+    /** Accessible label */
+    "aria-label": string;
+}
+export declare const WakaHapticIconButton: React.ForwardRefExoticComponent<WakaHapticIconButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export {};

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

@@ -0,0 +1,111 @@
+import * as React from "react";
+export type HotspotVariant = "dot" | "icon" | "badge";
+export type HotspotSize = "sm" | "default" | "lg";
+export type HotspotPosition = "top" | "bottom" | "left" | "right" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type HotspotTrigger = "click" | "hover" | "both";
+export type HotspotIconType = "help" | "info" | "lightbulb" | "star" | "zap" | "alert";
+export interface WakaHotspotProps {
+    /** Unique identifier for seen state persistence */
+    id: string;
+    /** Tooltip content */
+    content: React.ReactNode;
+    /** Optional title for the tooltip */
+    title?: string;
+    /** Hotspot variant */
+    variant?: HotspotVariant;
+    /** Icon type for icon/badge variants */
+    iconType?: HotspotIconType;
+    /** Custom icon element */
+    customIcon?: React.ReactNode;
+    /** Size of the hotspot */
+    size?: HotspotSize;
+    /** Tooltip position relative to hotspot */
+    position?: HotspotPosition;
+    /** How to trigger the tooltip */
+    trigger?: HotspotTrigger;
+    /** Auto-dismiss tooltip after ms (0 to disable) */
+    autoDismissMs?: number;
+    /** Show only once (remember seen state in localStorage) */
+    showOnce?: boolean;
+    /** Storage key prefix for seen state */
+    storageKeyPrefix?: string;
+    /** Primary color for the hotspot */
+    color?: "primary" | "secondary" | "destructive" | "warning" | "success" | "info";
+    /** Custom color (CSS color value) */
+    customColor?: string;
+    /** Z-index for the hotspot and tooltip */
+    zIndex?: number;
+    /** Disable pulse animation */
+    disablePulse?: boolean;
+    /** Disable appear animation */
+    disableAppearAnimation?: boolean;
+    /** Called when hotspot is shown */
+    onShow?: () => void;
+    /** Called when hotspot is hidden */
+    onHide?: () => void;
+    /** Called when tooltip is dismissed */
+    onDismiss?: () => void;
+    /** Called when seen for first time (showOnce mode) */
+    onFirstSeen?: () => void;
+    /** Custom className for hotspot */
+    className?: string;
+    /** Custom className for tooltip */
+    tooltipClassName?: string;
+    /** Badge text (for badge variant) */
+    badgeText?: string;
+    /** Children to wrap (hotspot will be positioned relative to this) */
+    children?: React.ReactNode;
+}
+export interface HotspotState {
+    isVisible: boolean;
+    hasSeen: boolean;
+}
+/**
+ * @deprecated Since v3.6 — will be removed in v4.0.
+ * Use `WakaFancyButton variant="hotspot"` instead (futur, dans `@wakastellar/ui-effects-decorative`).
+ * See `docs/audit/remove-relocate.md` §2.1.
+ */
+export declare function WakaHotspot({ id, content, title, variant, iconType, customIcon, size, position, trigger, autoDismissMs, showOnce, storageKeyPrefix, color, customColor, zIndex, disablePulse, disableAppearAnimation, onShow, onHide, onDismiss, onFirstSeen, className, tooltipClassName, badgeText, children, }: WakaHotspotProps): import("react/jsx-runtime").JSX.Element;
+export interface UseHotspotOptions {
+    /** Unique identifier for the hotspot */
+    id: string;
+    /** Show only once (remember seen state) */
+    showOnce?: boolean;
+    /** Storage key prefix */
+    storageKeyPrefix?: string;
+    /** Auto-show on mount */
+    autoShow?: boolean;
+    /** Delay before auto-show (ms) */
+    autoShowDelay?: number;
+}
+export declare function useHotspot({ id, showOnce, storageKeyPrefix, autoShow, autoShowDelay, }: UseHotspotOptions): HotspotState & {
+    show: () => void;
+    hide: () => void;
+    dismiss: () => void;
+    reset: () => void;
+};
+export interface HotspotStep {
+    id: string;
+    content: React.ReactNode;
+    title?: string;
+    position?: HotspotPosition;
+}
+export interface WakaHotspotGroupProps {
+    /** Steps to show in sequence */
+    steps: HotspotStep[];
+    /** Whether the tour is active */
+    active: boolean;
+    /** Current step index */
+    currentStep?: number;
+    /** Called when step changes */
+    onStepChange?: (step: number) => void;
+    /** Called when tour completes */
+    onComplete?: () => void;
+    /** Called when tour is skipped */
+    onSkip?: () => void;
+    /** Show step indicator */
+    showStepIndicator?: boolean;
+    /** Common props for all hotspots */
+    hotspotProps?: Partial<WakaHotspotProps>;
+}
+export declare function WakaHotspotGroup({ steps, active, currentStep: controlledStep, onStepChange, onComplete, onSkip, showStepIndicator, hotspotProps, }: WakaHotspotGroupProps): import("react/jsx-runtime").JSX.Element;

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-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 {};