@wakastellar/ui 1.0.10 → 2.0.0

package/dist/components/waka-budget-burn/index.d.ts

@@ -0,0 +1,154 @@
+import * as React from "react";
+export interface SpendDataPoint {
+    /** Date of the spend */
+    date: Date;
+    /** Amount spent on this day */
+    amount: number;
+    /** Category breakdown (optional) */
+    categories?: Record<string, number>;
+}
+export interface BudgetCategory {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Allocated budget for this category */
+    budget: number;
+    /** Current spend for this category */
+    spent: number;
+    /** Custom color */
+    color?: string;
+}
+export interface BudgetBurnState {
+    /** Total budget amount */
+    totalBudget: number;
+    /** Total amount spent */
+    totalSpent: number;
+    /** Budget period start date */
+    startDate: Date;
+    /** Budget period end date */
+    endDate: Date;
+    /** Daily spending data */
+    spendHistory: SpendDataPoint[];
+    /** Budget categories */
+    categories: BudgetCategory[];
+    /** Current burn rate (spend per day) */
+    burnRate: number;
+    /** Ideal burn rate to stay on budget */
+    idealBurnRate: number;
+    /** Projected depletion date */
+    depletionDate: Date | null;
+    /** Days remaining in period */
+    daysRemaining: number;
+    /** Time elapsed percentage */
+    timeElapsedPercent: number;
+    /** Budget used percentage */
+    budgetUsedPercent: number;
+    /** Danger zone (burn rate is too high) */
+    isDangerZone: boolean;
+    /** Warning zone (burn rate approaching danger) */
+    isWarningZone: boolean;
+}
+export interface WakaBudgetBurnProps {
+    /** Total budget amount */
+    budget: number;
+    /** Budget period start date */
+    startDate: Date;
+    /** Budget period end date */
+    endDate: Date;
+    /** Daily spending history */
+    spendHistory: SpendDataPoint[];
+    /** Budget categories (optional) */
+    categories?: BudgetCategory[];
+    /** Currency symbol */
+    currency?: string;
+    /** Danger threshold (percentage over ideal burn rate) */
+    dangerThreshold?: number;
+    /** Warning threshold (percentage over ideal burn rate) */
+    warningThreshold?: number;
+    /** Show projected burn line */
+    showProjection?: boolean;
+    /** Show ideal burn line */
+    showIdealLine?: boolean;
+    /** Show category breakdown */
+    showCategories?: boolean;
+    /** Show daily/weekly/monthly trends */
+    showTrends?: boolean;
+    /** Enable animations */
+    animated?: boolean;
+    /** Chart height in pixels */
+    height?: number;
+    /** Custom value formatter */
+    formatValue?: (value: number) => string;
+    /** Callback when danger zone is entered */
+    onDangerZone?: () => void;
+    /** Callback when budget is depleted */
+    onBudgetDepleted?: () => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaBudgetBurn({ budget, startDate, endDate, spendHistory, categories, currency, dangerThreshold, warningThreshold, showProjection, showIdealLine, showCategories, showTrends, animated, height, formatValue: customFormatValue, onDangerZone, onBudgetDepleted, className, }: WakaBudgetBurnProps): import("react/jsx-runtime").JSX.Element;
+export interface UseBudgetBurnOptions {
+    /** Total budget amount */
+    budget: number;
+    /** Budget period start date */
+    startDate: Date;
+    /** Budget period end date */
+    endDate: Date;
+    /** Initial spending history */
+    initialHistory?: SpendDataPoint[];
+    /** Initial categories */
+    initialCategories?: BudgetCategory[];
+    /** Danger threshold percentage */
+    dangerThreshold?: number;
+    /** Warning threshold percentage */
+    warningThreshold?: number;
+    /** Callback when danger zone is entered */
+    onDangerZone?: () => void;
+    /** Callback when budget is depleted */
+    onBudgetDepleted?: () => void;
+}
+export declare function useBudgetBurn({ budget, startDate, endDate, initialHistory, initialCategories, dangerThreshold, warningThreshold, onDangerZone, onBudgetDepleted, }: UseBudgetBurnOptions): {
+    spendHistory: SpendDataPoint[];
+    categories: BudgetCategory[];
+    addSpend: (date: Date, amount: number, categoryBreakdown?: Record<string, number>) => void;
+    removeSpend: (date: Date) => void;
+    updateCategory: (id: string, updates: Partial<BudgetCategory>) => void;
+    addCategory: (category: BudgetCategory) => void;
+    removeCategory: (id: string) => void;
+    reset: () => void;
+    setSpendHistory: React.Dispatch<React.SetStateAction<SpendDataPoint[]>>;
+    setCategories: React.Dispatch<React.SetStateAction<BudgetCategory[]>>;
+    getForecast: (days: number) => {
+        projectedSpend: number;
+        projectedRemaining: number;
+        projectedPercentUsed: number;
+        willDeplete: boolean;
+        daysUntilDepletion: number;
+    };
+    /** Total budget amount */
+    totalBudget: number;
+    /** Total amount spent */
+    totalSpent: number;
+    /** Budget period start date */
+    startDate: Date;
+    /** Budget period end date */
+    endDate: Date;
+    /** Current burn rate (spend per day) */
+    burnRate: number;
+    /** Ideal burn rate to stay on budget */
+    idealBurnRate: number;
+    /** Projected depletion date */
+    depletionDate: Date | null;
+    /** Days remaining in period */
+    daysRemaining: number;
+    /** Time elapsed percentage */
+    timeElapsedPercent: number;
+    /** Budget used percentage */
+    budgetUsedPercent: number;
+    /** Danger zone (burn rate is too high) */
+    isDangerZone: boolean;
+    /** Warning zone (burn rate approaching danger) */
+    isWarningZone: boolean;
+};
+export default WakaBudgetBurn;

package/dist/components/waka-capacity-planner/index.d.ts

@@ -0,0 +1,132 @@
+import * as React from "react";
+export type ResourceType = "cpu" | "memory" | "storage" | "network" | "custom";
+export type TimelineRange = "1m" | "3m" | "6m" | "12m";
+export type ThresholdStatus = "safe" | "warning" | "danger" | "critical";
+export interface ResourceData {
+    /** Unique identifier for the resource */
+    id: string;
+    /** Display name of the resource */
+    name: string;
+    /** Resource type for icon selection */
+    type: ResourceType;
+    /** Custom icon component (for custom type) */
+    customIcon?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Current usage value */
+    current: number;
+    /** Total available capacity */
+    total: number;
+    /** Unit of measurement */
+    unit: string;
+    /** Historical usage data points */
+    history?: number[];
+    /** Projected usage at different time ranges */
+    projections: {
+        "1m": number;
+        "3m": number;
+        "6m": number;
+        "12m"?: number;
+    };
+    /** Growth rate per month (percentage) */
+    growthRate?: number;
+}
+export interface Threshold {
+    /** Warning threshold percentage (default: 70) */
+    warning: number;
+    /** Danger threshold percentage (default: 85) */
+    danger: number;
+    /** Critical threshold percentage (default: 95) */
+    critical: number;
+}
+export interface ScalingRecommendation {
+    /** Unique identifier */
+    id: string;
+    /** Resource this recommendation applies to */
+    resourceId: string;
+    /** Type of recommendation */
+    type: "scale_up" | "scale_out" | "optimize" | "monitor";
+    /** Priority level */
+    priority: "low" | "medium" | "high" | "urgent";
+    /** Short title */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** Suggested action */
+    action: string;
+    /** Estimated time until action needed */
+    timeframe?: string;
+    /** Potential cost impact */
+    costImpact?: string;
+}
+export interface WakaCapacityPlannerProps {
+    /** Array of resources to display */
+    resources: ResourceData[];
+    /** Threshold configuration */
+    thresholds?: Threshold;
+    /** Scaling recommendations */
+    recommendations?: ScalingRecommendation[];
+    /** Initial timeline range */
+    initialTimelineRange?: TimelineRange;
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Enable animations */
+    animated?: boolean;
+    /** Show recommendations panel */
+    showRecommendations?: boolean;
+    /** Show timeline slider */
+    showTimeline?: boolean;
+    /** Show projection chart */
+    showProjectionChart?: boolean;
+    /** Callback when timeline range changes */
+    onTimelineChange?: (range: TimelineRange) => void;
+    /** Callback when resource is clicked */
+    onResourceClick?: (resource: ResourceData) => void;
+    /** Callback when recommendation action is triggered */
+    onRecommendationAction?: (recommendation: ScalingRecommendation) => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+export interface UseCapacityPlannerOptions {
+    /** Initial resources */
+    resources: ResourceData[];
+    /** Threshold configuration */
+    thresholds?: Threshold;
+    /** Initial timeline range */
+    initialTimelineRange?: TimelineRange;
+}
+export interface UseCapacityPlannerReturn {
+    /** Current resources state */
+    resources: ResourceData[];
+    /** Selected timeline range */
+    timelineRange: TimelineRange;
+    /** Current thresholds */
+    thresholds: Threshold;
+    /** Resources at risk (warning or above) */
+    resourcesAtRisk: ResourceData[];
+    /** Resources in critical state */
+    criticalResources: ResourceData[];
+    /** Overall health status */
+    overallHealth: ThresholdStatus;
+    /** Set timeline range */
+    setTimelineRange: (range: TimelineRange) => void;
+    /** Update a resource */
+    updateResource: (id: string, updates: Partial<ResourceData>) => void;
+    /** Get projected value for a resource */
+    getProjectedValue: (resource: ResourceData) => number;
+    /** Get status for a resource */
+    getResourceStatus: (resource: ResourceData) => ThresholdStatus;
+    /** Get projected status for a resource */
+    getProjectedStatus: (resource: ResourceData) => ThresholdStatus;
+    /** Calculate time until threshold breach */
+    getTimeUntilBreach: (resource: ResourceData, threshold: ThresholdStatus) => string | null;
+    /** Set thresholds */
+    setThresholds: (thresholds: Threshold) => void;
+    /** Add a new resource */
+    addResource: (resource: ResourceData) => void;
+    /** Remove a resource */
+    removeResource: (id: string) => void;
+}
+export declare function useCapacityPlanner({ resources: initialResources, thresholds: initialThresholds, initialTimelineRange, }: UseCapacityPlannerOptions): UseCapacityPlannerReturn;
+export declare function WakaCapacityPlanner({ resources, thresholds, recommendations, initialTimelineRange, size, animated, showRecommendations, showTimeline, showProjectionChart, onTimelineChange, onResourceClick, onRecommendationAction, className, }: WakaCapacityPlannerProps): import("react/jsx-runtime").JSX.Element;
+export default WakaCapacityPlanner;

package/dist/components/waka-cart-summary/index.d.ts

@@ -0,0 +1,154 @@
+import * as React from "react";
+export interface CartItem {
+    /** Unique identifier for the item */
+    id: string;
+    /** Product name */
+    name: string;
+    /** Product description (optional) */
+    description?: string;
+    /** Product image URL */
+    image?: string;
+    /** Unit price */
+    price: number;
+    /** Quantity in cart */
+    quantity: number;
+    /** Maximum quantity allowed (optional) */
+    maxQuantity?: number;
+    /** Minimum quantity allowed (default: 1) */
+    minQuantity?: number;
+    /** Whether the item is in stock */
+    inStock?: boolean;
+    /** Product variant (e.g., "Red, Large") */
+    variant?: string;
+    /** Original price before discount */
+    originalPrice?: number;
+    /** SKU or product code */
+    sku?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface CartDiscount {
+    /** Discount code */
+    code: string;
+    /** Discount type */
+    type: "percentage" | "fixed" | "shipping";
+    /** Discount value (percentage or fixed amount) */
+    value: number;
+    /** Minimum order amount for discount to apply */
+    minOrderAmount?: number;
+    /** Description of the discount */
+    description?: string;
+}
+export interface CartTotals {
+    /** Subtotal before taxes, shipping, and discounts */
+    subtotal: number;
+    /** Tax amount */
+    tax: number;
+    /** Tax rate (percentage) */
+    taxRate: number;
+    /** Shipping cost */
+    shipping: number;
+    /** Total discount amount */
+    discount: number;
+    /** Grand total */
+    total: number;
+}
+export interface WakaCartSummaryProps {
+    /** Cart items */
+    items: CartItem[];
+    /** Currency code (default: "USD") */
+    currency?: string;
+    /** Tax rate as decimal (e.g., 0.08 for 8%) */
+    taxRate?: number;
+    /** Shipping cost */
+    shippingCost?: number;
+    /** Free shipping threshold (amount) */
+    freeShippingThreshold?: number;
+    /** Applied discount/coupon */
+    discount?: CartDiscount | null;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Show item images */
+    showImages?: boolean;
+    /** Show item descriptions */
+    showDescriptions?: boolean;
+    /** Show SKU/product codes */
+    showSku?: boolean;
+    /** Enable quantity editing */
+    enableQuantityEdit?: boolean;
+    /** Enable item removal */
+    enableRemove?: boolean;
+    /** Custom empty state */
+    emptyState?: React.ReactNode;
+    /** Custom loading state */
+    loadingState?: React.ReactNode;
+    /** Header content */
+    header?: React.ReactNode;
+    /** Footer content (e.g., checkout button) */
+    footer?: React.ReactNode;
+    /** Additional CSS classes */
+    className?: string;
+    /** Item container CSS classes */
+    itemClassName?: string;
+    /** Summary section CSS classes */
+    summaryClassName?: string;
+    /** Callback when item quantity changes */
+    onQuantityChange?: (itemId: string, quantity: number) => void;
+    /** Callback when item is removed */
+    onRemoveItem?: (itemId: string) => void;
+    /** Callback when discount is applied */
+    onApplyDiscount?: (code: string) => Promise<CartDiscount | null>;
+    /** Callback when discount is removed */
+    onRemoveDiscount?: () => void;
+    /** Callback for checkout action */
+    onCheckout?: (totals: CartTotals) => void;
+    /** Custom price formatter */
+    formatPrice?: (price: number, currency: string) => string;
+    /** Animation duration in ms */
+    animationDuration?: number;
+    /** Accessibility label */
+    ariaLabel?: string;
+}
+export declare const WakaCartSummary: React.FC<WakaCartSummaryProps>;
+export interface UseCartSummaryOptions {
+    /** Initial cart items */
+    initialItems?: CartItem[];
+    /** Currency code */
+    currency?: string;
+    /** Tax rate */
+    taxRate?: number;
+    /** Shipping cost */
+    shippingCost?: number;
+    /** Free shipping threshold */
+    freeShippingThreshold?: number;
+    /** Callback when cart changes */
+    onCartChange?: (items: CartItem[]) => void;
+}
+export interface UseCartSummaryReturn {
+    /** Current cart items */
+    items: CartItem[];
+    /** Applied discount */
+    discount: CartDiscount | null;
+    /** Cart totals */
+    totals: CartTotals;
+    /** Total item count */
+    itemCount: number;
+    /** Whether the cart is empty */
+    isEmpty: boolean;
+    /** Add item to cart */
+    addItem: (item: CartItem) => void;
+    /** Remove item from cart */
+    removeItem: (itemId: string) => void;
+    /** Update item quantity */
+    updateQuantity: (itemId: string, quantity: number) => void;
+    /** Clear all items */
+    clearCart: () => void;
+    /** Apply discount code */
+    applyDiscount: (discount: CartDiscount) => void;
+    /** Remove discount */
+    removeDiscount: () => void;
+    /** Set items directly */
+    setItems: (items: CartItem[]) => void;
+}
+export declare function useCartSummary(options?: UseCartSummaryOptions): UseCartSummaryReturn;
+export default WakaCartSummary;

package/dist/components/waka-challenge-timer/index.d.ts

@@ -0,0 +1,86 @@
+import * as React from "react";
+export interface ChallengeTask {
+    /** Unique identifier */
+    id: string;
+    /** Task description */
+    text: string;
+    /** Whether the task is completed */
+    completed: boolean;
+    /** Current progress value (for countable tasks) */
+    current?: number;
+    /** Target value (for countable tasks) */
+    target?: number;
+}
+export interface ChallengeReward {
+    /** Type of reward */
+    type: "xp" | "badge" | "item" | "currency" | "custom";
+    /** Reward label */
+    label: string;
+    /** Reward value */
+    value: number | string;
+    /** Custom icon */
+    icon?: React.ReactNode;
+}
+export interface Challenge {
+    /** Unique identifier */
+    id: string;
+    /** Challenge name */
+    name: string;
+    /** Challenge description */
+    description?: string;
+    /** End date/time */
+    endTime: Date;
+    /** Start date/time (for personal challenges) */
+    startTime?: Date;
+    /** Tasks to complete (optional) */
+    tasks?: ChallengeTask[];
+    /** Rewards for completion */
+    rewards?: ChallengeReward[];
+    /** Whether this is a personal (pausable) challenge */
+    isPersonal?: boolean;
+    /** Challenge category/type */
+    category?: "daily" | "weekly" | "event" | "personal" | "competition";
+}
+export interface WakaChallengeTimerProps {
+    /** Challenge data */
+    challenge: Challenge;
+    /** Size variant */
+    size?: "compact" | "default" | "large";
+    /** Callback when timer reaches zero */
+    onComplete?: (challengeId: string) => void;
+    /** Callback when timer enters urgent mode (< threshold remaining) */
+    onUrgent?: (challengeId: string) => void;
+    /** Callback when pausing (for personal challenges) */
+    onPause?: (challengeId: string) => void;
+    /** Callback when starting/resuming (for personal challenges) */
+    onStart?: (challengeId: string) => void;
+    /** Callback when task is clicked */
+    onTaskClick?: (challengeId: string, taskId: string) => void;
+    /** Whether the timer is paused (for personal challenges) */
+    isPaused?: boolean;
+    /** Threshold in seconds for urgent animation (default: 3600 = 1 hour) */
+    urgentThreshold?: number;
+    /** Custom className */
+    className?: string;
+}
+export interface TimeRemaining {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    totalSeconds: number;
+    isExpired: boolean;
+    isUrgent: boolean;
+}
+export interface UseChallengeTimerOptions {
+    endTime: Date;
+    isPaused?: boolean;
+    urgentThreshold?: number;
+    onComplete?: () => void;
+    onUrgent?: () => void;
+}
+export declare function useChallengeTimer({ endTime, isPaused, urgentThreshold, onComplete, onUrgent, }: UseChallengeTimerOptions): TimeRemaining;
+export declare function WakaChallengeTimer({ challenge, size, onComplete, onUrgent, onPause, onStart, onTaskClick, isPaused, urgentThreshold, className, }: WakaChallengeTimerProps): import("react/jsx-runtime").JSX.Element;
+export declare function WakaChallengeTimerSkeleton({ size }: {
+    size?: "compact" | "default" | "large";
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/waka-chat-bubble/index.d.ts

@@ -0,0 +1,127 @@
+import { VariantProps } from 'class-variance-authority';
+import * as React from "react";
+export type MessageStatus = "sending" | "sent" | "delivered" | "read" | "failed";
+export type ReadReceiptStatus = "sent" | "delivered" | "read";
+export interface MessageReaction {
+    emoji: string;
+    count: number;
+    users: string[];
+    reacted: boolean;
+}
+export interface MessageAttachment {
+    id: string;
+    type: "image" | "file" | "video" | "audio";
+    url: string;
+    name: string;
+    size?: number;
+    mimeType?: string;
+    thumbnail?: string;
+    width?: number;
+    height?: number;
+}
+export interface LinkPreview {
+    url: string;
+    title: string;
+    description?: string;
+    image?: string;
+    favicon?: string;
+    siteName?: string;
+}
+export interface MessageThread {
+    count: number;
+    lastReply?: string;
+    participants: Array<{
+        id: string;
+        name: string;
+        avatar?: string;
+    }>;
+}
+export interface ChatUser {
+    id: string;
+    name: string;
+    avatar?: string;
+    initials?: string;
+}
+export interface WakaChatBubbleProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof bubbleVariants> {
+    /** The message content */
+    message: string;
+    /** Whether the message was sent by the current user */
+    isSent?: boolean;
+    /** User who sent the message */
+    sender?: ChatUser;
+    /** Show avatar */
+    showAvatar?: boolean;
+    /** Message timestamp */
+    timestamp?: Date | string;
+    /** Format for timestamp display */
+    timestampFormat?: "time" | "datetime" | "relative";
+    /** Message status */
+    status?: MessageStatus;
+    /** Read receipt status (for sent messages) */
+    readReceipt?: ReadReceiptStatus;
+    /** Reactions on the message */
+    reactions?: MessageReaction[];
+    /** Thread/reply info */
+    thread?: MessageThread;
+    /** Whether the message was edited */
+    isEdited?: boolean;
+    /** Attachments */
+    attachments?: MessageAttachment[];
+    /** Link preview */
+    linkPreview?: LinkPreview;
+    /** Enable markdown rendering */
+    markdown?: boolean;
+    /** Called when reaction is added */
+    onAddReaction?: (emoji: string) => void;
+    /** Called when existing reaction is toggled */
+    onToggleReaction?: (emoji: string) => void;
+    /** Called when reply button is clicked */
+    onReply?: () => void;
+    /** Called when edit is requested */
+    onEdit?: () => void;
+    /** Called when delete is requested */
+    onDelete?: () => void;
+    /** Called when retry is requested (for failed messages) */
+    onRetry?: () => void;
+    /** Called when thread is clicked */
+    onThreadClick?: () => void;
+    /** Called when attachment is clicked */
+    onAttachmentClick?: (attachment: MessageAttachment) => void;
+    /** Called when link preview is clicked */
+    onLinkPreviewClick?: (url: string) => void;
+    /** Show action menu */
+    showActions?: boolean;
+    /** Emoji picker content (render prop) */
+    emojiPicker?: (onSelect: (emoji: string) => void) => React.ReactNode;
+    /** Quick reaction emojis */
+    quickReactions?: string[];
+    /** Custom timestamp renderer */
+    renderTimestamp?: (timestamp: Date | string) => React.ReactNode;
+    /** Maximum width of the bubble */
+    maxWidth?: string | number;
+}
+declare const bubbleVariants: (props?: ({
+    variant?: "default" | "minimal" | "elevated" | null | undefined;
+    isSent?: boolean | null | undefined;
+} & import('class-variance-authority/dist/types').ClassProp) | undefined) => string;
+export declare const WakaChatBubble: React.ForwardRefExoticComponent<WakaChatBubbleProps & React.RefAttributes<HTMLDivElement>>;
+export interface WakaChatTypingIndicatorProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Users currently typing */
+    users?: ChatUser[];
+    /** Show avatar */
+    showAvatar?: boolean;
+}
+export declare function WakaChatTypingIndicator({ users, showAvatar, className, ...props }: WakaChatTypingIndicatorProps): import("react/jsx-runtime").JSX.Element | null;
+export interface WakaChatDateSeparatorProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Date to display */
+    date: Date | string;
+}
+export declare function WakaChatDateSeparator({ date, className, ...props }: WakaChatDateSeparatorProps): import("react/jsx-runtime").JSX.Element;
+export interface WakaChatSystemMessageProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** System message text */
+    message: string;
+    /** Icon to display */
+    icon?: React.ReactNode;
+}
+export declare function WakaChatSystemMessage({ message, icon, className, ...props }: WakaChatSystemMessageProps): import("react/jsx-runtime").JSX.Element;
+export {};