@wakastellar/ui 3.5.0 → 4.0.0-dev.0

package/dist/components/waka-dependency-tree/index.d.ts

@@ -0,0 +1,38 @@
+export type DependencyType = "direct" | "transitive" | "dev" | "peer" | "optional";
+export type VulnSeverity = "critical" | "high" | "medium" | "low" | "none";
+export interface Dependency {
+    id: string;
+    name: string;
+    version: string;
+    latestVersion?: string;
+    type: DependencyType;
+    license?: string;
+    vulnerabilities?: {
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+    };
+    outdated?: boolean;
+    children?: Dependency[];
+    size?: number;
+    repository?: string;
+}
+export interface WakaDependencyTreeProps {
+    /** Root dependencies */
+    dependencies: Dependency[];
+    /** Callback when clicking on a dependency */
+    onDependencyClick?: (dep: Dependency) => void;
+    /** Callback when upgrading a dependency */
+    onUpgrade?: (dep: Dependency) => void;
+    /** Title */
+    title?: string;
+    /** Show dev dependencies */
+    showDevDeps?: boolean;
+    /** Show only vulnerable */
+    showVulnerableOnly?: boolean;
+    /** Custom class name */
+    className?: string;
+}
+export declare function WakaDependencyTree({ dependencies, onDependencyClick, onUpgrade, title, showDevDeps, showVulnerableOnly, className, }: WakaDependencyTreeProps): import("react/jsx-runtime").JSX.Element;
+export declare const defaultDependencies: Dependency[];

package/dist/components/waka-deployment-lane/index.d.ts

@@ -0,0 +1,43 @@
+import * as React from "react";
+export type DeploymentStatus = "running" | "stopped" | "deploying" | "failed";
+export interface Deployment {
+    id: string;
+    version: string;
+    commit?: string;
+    status: DeploymentStatus;
+    deployedAt: Date;
+    deployedBy?: string;
+}
+export interface Environment {
+    id: string;
+    name: string;
+    deployments: Deployment[];
+    requiresApproval?: boolean;
+    approvers?: string[];
+}
+export interface WakaDeploymentLaneProps {
+    /** Array of environments with their deployments */
+    environments: Environment[];
+    /** Callback when a deployment is promoted to the next environment */
+    onPromote?: (deploymentId: string, fromEnv: string, toEnv: string) => void;
+    /** Callback when a deployment is rolled back */
+    onRollback?: (deploymentId: string, envId: string) => void;
+    /** Callback when a deployment is approved */
+    onApprove?: (deploymentId: string, envId: string) => void;
+    /** Enable drag and drop between environments */
+    draggable?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaDeploymentLane({ environments, onPromote, onRollback, onApprove, draggable, className, }: WakaDeploymentLaneProps): import("react/jsx-runtime").JSX.Element;
+export declare function useDeploymentLane(initialEnvironments: Environment[]): {
+    environments: Environment[];
+    setEnvironments: React.Dispatch<React.SetStateAction<Environment[]>>;
+    promoteDeployment: (deploymentId: string, fromEnvId: string, toEnvId: string) => void;
+    rollbackDeployment: (deploymentId: string, envId: string) => void;
+    approveDeployment: (deploymentId: string, envId: string) => void;
+    updateDeploymentStatus: (deploymentId: string, envId: string, status: Deployment["status"]) => void;
+    addDeployment: (envId: string, deployment: Omit<Deployment, "id">) => void;
+    removeDeployment: (deploymentId: string, envId: string) => void;
+};
+export default WakaDeploymentLane;

package/dist/components/waka-device-trust/index.d.ts

@@ -0,0 +1,95 @@
+import * as React from "react";
+export type DeviceType = "desktop" | "laptop" | "mobile" | "tablet" | "unknown";
+export type TrustStatus = "trusted" | "pending" | "expired" | "revoked";
+export type ExpiryPeriod = "7d" | "30d" | "90d" | "365d" | "never";
+export interface TrustedDevice {
+    /** Unique device identifier */
+    id: string;
+    /** Device display name */
+    name: string;
+    /** Device type */
+    type: DeviceType;
+    /** Operating system */
+    os?: string;
+    /** Browser name */
+    browser?: string;
+    /** Trust status */
+    status: TrustStatus;
+    /** When the device was trusted */
+    trustedAt: Date;
+    /** When the device was last used */
+    lastUsedAt?: Date;
+    /** When the trust expires (undefined means never) */
+    expiresAt?: Date;
+    /** Whether this is the current device */
+    isCurrentDevice?: boolean;
+    /** Device fingerprint (optional, for display) */
+    fingerprint?: string;
+    /** IP address of last access */
+    lastIpAddress?: string;
+    /** Location of last access */
+    lastLocation?: string;
+}
+export interface DeviceTrustConfig {
+    /** Maximum number of trusted devices allowed */
+    maxDevices: number;
+    /** Default expiry period for new devices */
+    defaultExpiryPeriod: ExpiryPeriod;
+    /** Whether verification is required for adding/removing devices */
+    requireVerification: boolean;
+}
+export interface WakaDeviceTrustProps {
+    /** List of trusted devices */
+    devices: TrustedDevice[];
+    /** Current device ID (to highlight) */
+    currentDeviceId?: string;
+    /** Configuration for device trust */
+    config?: DeviceTrustConfig;
+    /** Callback when adding a new device */
+    onAddDevice?: () => void;
+    /** Callback when removing a device */
+    onRemoveDevice?: (deviceId: string) => Promise<boolean>;
+    /** Callback when verification is needed */
+    onVerificationRequired?: (action: "add" | "remove", deviceId?: string) => Promise<boolean>;
+    /** Callback when expiry is updated */
+    onUpdateExpiry?: (deviceId: string, expiryPeriod: ExpiryPeriod) => Promise<boolean>;
+    /** Callback to refresh device list */
+    onRefresh?: () => Promise<void>;
+    /** Whether the component is in loading state */
+    loading?: boolean;
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Show detailed device information */
+    showDetails?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaDeviceTrust({ devices, currentDeviceId, config, onAddDevice, onRemoveDevice, onVerificationRequired, onUpdateExpiry, onRefresh, loading, size, showDetails, className, }: WakaDeviceTrustProps): import("react/jsx-runtime").JSX.Element;
+export interface UseDeviceTrustOptions {
+    /** Initial list of devices */
+    initialDevices?: TrustedDevice[];
+    /** Current device ID */
+    currentDeviceId?: string;
+    /** Device trust configuration */
+    config?: DeviceTrustConfig;
+    /** Callback when device list changes */
+    onChange?: (devices: TrustedDevice[]) => void;
+}
+export declare function useDeviceTrust({ initialDevices, currentDeviceId, config, onChange, }?: UseDeviceTrustOptions): {
+    devices: TrustedDevice[];
+    loading: boolean;
+    error: string;
+    addDevice: (device: Omit<TrustedDevice, "id" | "trustedAt" | "status">) => Promise<boolean>;
+    removeDevice: (deviceId: string) => Promise<boolean>;
+    updateDeviceStatus: (deviceId: string, status: TrustStatus) => Promise<boolean>;
+    updateDeviceExpiry: (deviceId: string, expiryPeriod: ExpiryPeriod) => Promise<boolean>;
+    refreshDevices: (fetcher?: () => Promise<TrustedDevice[]>) => Promise<void>;
+    getCurrentDevice: () => TrustedDevice;
+    getTrustedDevices: () => TrustedDevice[];
+    getExpiredDevices: () => TrustedDevice[];
+    clearAllDevices: () => Promise<boolean>;
+    canAddDevice: boolean;
+    setLoading: React.Dispatch<React.SetStateAction<boolean>>;
+    setError: React.Dispatch<React.SetStateAction<string>>;
+};
+export default WakaDeviceTrust;

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

@@ -0,0 +1,11 @@
+export interface DocBreadcrumbItem {
+    id: string;
+    label: string;
+    href?: string;
+}
+export interface WakaDocBreadcrumbProps {
+    items: DocBreadcrumbItem[];
+    onItemClick?: (item: DocBreadcrumbItem) => void;
+    className?: string;
+}
+export declare function WakaDocBreadcrumb({ items, onItemClick, className }: WakaDocBreadcrumbProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,9 @@
+import * as React from "react";
+export type CalloutType = "info" | "warning" | "danger" | "tip";
+export interface WakaDocCalloutProps {
+    type?: CalloutType;
+    title?: string;
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function WakaDocCallout({ type, title, children, className, }: WakaDocCalloutProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/waka-doc-code-block/index.d.ts

@@ -0,0 +1,23 @@
+import "prismjs/components/prism-typescript";
+import "prismjs/components/prism-javascript";
+import "prismjs/components/prism-jsx";
+import "prismjs/components/prism-tsx";
+import "prismjs/components/prism-css";
+import "prismjs/components/prism-json";
+import "prismjs/components/prism-bash";
+import "prismjs/components/prism-python";
+import "prismjs/components/prism-go";
+import "prismjs/components/prism-rust";
+import "prismjs/components/prism-sql";
+import "prismjs/components/prism-yaml";
+import "prismjs/components/prism-docker";
+import "prismjs/components/prism-markdown";
+export interface WakaDocCodeBlockProps {
+    code: string;
+    language?: string;
+    filename?: string;
+    showLineNumbers?: boolean;
+    highlightLines?: number[];
+    className?: string;
+}
+export declare function WakaDocCodeBlock({ code, language, filename, showLineNumbers, highlightLines, className, }: WakaDocCodeBlockProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,16 @@
+import * as React from "react";
+export interface DocNavItem {
+    id: string;
+    label: string;
+    href?: string;
+    icon?: React.ReactNode;
+    children?: DocNavItem[];
+    badge?: string;
+}
+export interface WakaDocNavProps {
+    items: DocNavItem[];
+    activeId?: string;
+    onItemClick?: (item: DocNavItem) => void;
+    className?: string;
+}
+export declare function WakaDocNav({ items, activeId, onItemClick, className }: WakaDocNavProps): import("react/jsx-runtime").JSX.Element;

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-table/index.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+export interface WakaDocTableProps {
+    children: React.ReactNode;
+    stickyHeader?: boolean;
+    striped?: boolean;
+    className?: string;
+}
+export declare function WakaDocTable({ children, stickyHeader, striped, className, }: WakaDocTableProps): 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-doc-version/index.d.ts

@@ -0,0 +1,13 @@
+export type VersionStatus = "latest" | "stable" | "beta" | "deprecated" | "rc";
+export interface DocVersion {
+    id: string;
+    label: string;
+    status?: VersionStatus;
+}
+export interface WakaDocVersionProps {
+    versions: DocVersion[];
+    current: string;
+    onVersionChange: (versionId: string) => void;
+    className?: string;
+}
+export declare function WakaDocVersion({ versions, current, onVersionChange, className }: WakaDocVersionProps): 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-drawer/index.d.ts

@@ -0,0 +1,59 @@
+import * as React from "react";
+import * as DialogPrimitive from "@radix-ui/react-dialog";
+export type DrawerPosition = "left" | "right" | "top" | "bottom";
+export type DrawerSize = "sm" | "md" | "lg" | "xl" | "full";
+export interface WakaDrawerProps {
+    /** État d'ouverture */
+    open: boolean;
+    /** Callback de fermeture */
+    onOpenChange: (open: boolean) => void;
+    /** Position du drawer */
+    position?: DrawerPosition;
+    /** Taille du drawer */
+    size?: DrawerSize;
+    /** Titre du drawer */
+    title?: string;
+    /** Description du drawer */
+    description?: string;
+    /** Afficher le bouton de fermeture */
+    showCloseButton?: boolean;
+    /** Fermer en cliquant sur l'overlay */
+    closeOnOverlayClick?: boolean;
+    /** Fermer avec la touche Escape */
+    closeOnEscape?: boolean;
+    /** Afficher l'overlay */
+    showOverlay?: boolean;
+    /** Contenu du drawer */
+    children?: React.ReactNode;
+    /** Footer avec actions */
+    footer?: React.ReactNode;
+    /** Classes CSS additionnelles */
+    className?: string;
+    /** Classes CSS pour le contenu */
+    contentClassName?: string;
+}
+export declare const DrawerHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+export declare const DrawerBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+export declare const DrawerFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+export declare const DrawerTitle: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+export declare const DrawerDescription: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+export declare function WakaDrawer({ open, onOpenChange, position, size, title, description, showCloseButton, closeOnOverlayClick, closeOnEscape, showOverlay, children, footer, className, contentClassName, }: WakaDrawerProps): import("react/jsx-runtime").JSX.Element;
+export interface UseDrawerOptions {
+    /** État initial */
+    defaultOpen?: boolean;
+    /** Callback lors de l'ouverture */
+    onOpen?: () => void;
+    /** Callback lors de la fermeture */
+    onClose?: () => void;
+}
+export interface UseDrawerReturn {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    openDrawer: () => void;
+    closeDrawer: () => void;
+    toggleDrawer: () => void;
+}
+export declare function useDrawer(options?: UseDrawerOptions): UseDrawerReturn;
+export declare const DrawerTrigger: React.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+export declare const DrawerClose: React.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React.RefAttributes<HTMLButtonElement>>;
+export default WakaDrawer;

package/dist/components/waka-empty-state/index.d.ts

@@ -0,0 +1,85 @@
+import * as React from "react";
+export type EmptyStateVariant = "default" | "search" | "error";
+export type EmptyStateSize = "sm" | "md" | "lg";
+export type EmptyStateLayout = "vertical" | "horizontal";
+export type BuiltInIllustration = "inbox" | "search" | "error" | "folder" | "users" | "cart" | "calendar" | "mail" | "image";
+export interface EmptyStateAction {
+    /** Button label */
+    label: string;
+    /** Click handler */
+    onClick: () => void;
+    /** Button variant */
+    variant?: "primary" | "secondary";
+    /** Disabled state */
+    disabled?: boolean;
+    /** Loading state */
+    loading?: boolean;
+    /** Icon to display */
+    icon?: React.ReactNode;
+}
+export interface WakaEmptyStateProps {
+    /** Title text */
+    title?: string;
+    /** Description text */
+    description?: string;
+    /** Built-in illustration to use */
+    illustration?: BuiltInIllustration;
+    /** Custom icon component (overrides illustration) */
+    icon?: React.ReactNode;
+    /** Custom illustration element (overrides icon and illustration) */
+    customIllustration?: React.ReactNode;
+    /** Primary action button */
+    primaryAction?: EmptyStateAction;
+    /** Secondary action button */
+    secondaryAction?: EmptyStateAction;
+    /** Variant style */
+    variant?: EmptyStateVariant;
+    /** Size of the component */
+    size?: EmptyStateSize;
+    /** Layout direction */
+    layout?: EmptyStateLayout;
+    /** Enable animated entrance */
+    animated?: boolean;
+    /** Additional content below actions */
+    children?: React.ReactNode;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaEmptyState({ title, description, illustration, icon, customIllustration, primaryAction, secondaryAction, variant, size, layout, animated, children, className, }: WakaEmptyStateProps): import("react/jsx-runtime").JSX.Element;
+export interface WakaEmptyStateSearchProps extends Omit<WakaEmptyStateProps, "variant" | "illustration"> {
+    /** Search query that was used */
+    searchQuery?: string;
+    /** Callback to clear search */
+    onClearSearch?: () => void;
+}
+export declare function WakaEmptyStateSearch({ searchQuery, onClearSearch, title, description, ...props }: WakaEmptyStateSearchProps): import("react/jsx-runtime").JSX.Element;
+export interface WakaEmptyStateErrorProps extends Omit<WakaEmptyStateProps, "variant" | "illustration"> {
+    /** Error message */
+    error?: string | Error;
+    /** Callback to retry the operation */
+    onRetry?: () => void;
+}
+export declare function WakaEmptyStateError({ error, onRetry, title, description, ...props }: WakaEmptyStateErrorProps): import("react/jsx-runtime").JSX.Element;
+export interface UseEmptyStateOptions<T> {
+    /** Data array to check */
+    data: T[] | undefined | null;
+    /** Whether data is currently loading */
+    isLoading?: boolean;
+    /** Error object if any */
+    error?: Error | string | null;
+    /** Search query if in search mode */
+    searchQuery?: string;
+}
+export interface UseEmptyStateReturn {
+    /** Whether to show empty state */
+    showEmptyState: boolean;
+    /** Which variant to display */
+    variant: EmptyStateVariant;
+    /** Whether data is empty (not loading, no error) */
+    isEmpty: boolean;
+    /** Whether there was an error */
+    hasError: boolean;
+    /** Whether currently searching */
+    isSearching: boolean;
+}
+export declare function useEmptyState<T>({ data, isLoading, error, searchQuery, }: UseEmptyStateOptions<T>): UseEmptyStateReturn;

package/dist/components/waka-env-var-editor/index.d.ts

@@ -0,0 +1,30 @@
+export interface EnvVariable {
+    key: string;
+    value: string;
+    isSecret?: boolean;
+    isRequired?: boolean;
+    description?: string;
+    source?: string;
+}
+export interface WakaEnvVarEditorProps {
+    /** List of environment variables */
+    variables: EnvVariable[];
+    /** Callback when variables change */
+    onChange?: (variables: EnvVariable[]) => void;
+    /** Callback when saving */
+    onSave?: (variables: EnvVariable[]) => void;
+    /** Callback when importing */
+    onImport?: (content: string) => void;
+    /** Callback when exporting */
+    onExport?: () => void;
+    /** Read-only mode */
+    readOnly?: boolean;
+    /** Show source column */
+    showSource?: boolean;
+    /** Title */
+    title?: string;
+    /** Custom class name */
+    className?: string;
+}
+export declare function WakaEnvVarEditor({ variables: initialVariables, onChange, onSave, onImport, onExport, readOnly, showSource, title, className, }: WakaEnvVarEditorProps): import("react/jsx-runtime").JSX.Element;
+export declare const defaultEnvVariables: EnvVariable[];

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