@mohasinac/appkit 2.2.0 → 2.3.0

package/dist/features/homepage/types/index.d.ts

@@ -1,163 +0,0 @@
-export type HomepageSectionType = "hero" | "featured_categories" | "featured_products" | "banner" | "testimonials" | "promotions" | "blog_posts" | "sellers" | "custom";
-export interface HomepageSectionContent {
-    title?: string;
-    subtitle?: string;
-    ctaLabel?: string;
-    ctaUrl?: string;
-    imageUrl?: string;
-    videoUrl?: string;
-    itemIds?: string[];
-    html?: string;
-}
-export interface HomepageSection {
-    id: string;
-    type: HomepageSectionType;
-    title?: string;
-    /** Primary enable/disable flag stored in Firestore as `enabled` */
-    enabled?: boolean;
-    /** Alias kept for older consumers */
-    isVisible?: boolean;
-    order?: number;
-    content?: HomepageSectionContent;
-    mobile?: Partial<HomepageSectionContent>;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface HomepageData {
-    sections: HomepageSection[];
-}
-export interface HotspotPin {
-    id: string;
-    name: string;
-    universe: string;
-    description: string;
-    href: string;
-    /** Percentage from left edge, 0–100 */
-    xPct: number;
-    /** Percentage from top edge, 0–100 */
-    yPct: number;
-    /** Hex accent colour for popup header/button */
-    accent: string;
-    /** Small label on pin (optional) */
-    badge?: string;
-    /** CTA button label */
-    buyText: string;
-}
-export interface CharacterHotspotConfig {
-    imageUrl: string;
-    imageAlt: string;
-    active: boolean;
-    pins: HotspotPin[];
-    updatedAt?: string;
-}
-export interface Banner {
-    id: string;
-    title: string;
-    subtitle?: string;
-    ctaLabel?: string;
-    ctaUrl?: string;
-    backgroundImage?: string;
-    backgroundColor?: string;
-    textColor?: string;
-    sortOrder: number;
-    active: boolean;
-}
-export interface PromoBanner {
-    id: string;
-    title: string;
-    ctaLabel: string;
-    ctaUrl: string;
-    image: string;
-    sortOrder: number;
-    active: boolean;
-}
-export type TrustBadgeIconKey = "shipping" | "support" | "rewards" | "secure";
-export interface TrustBadge {
-    id: string;
-    title: string;
-    sub: string;
-    iconKey: TrustBadgeIconKey;
-    sortOrder: number;
-    active: boolean;
-}
-export interface Testimonial {
-    id: string;
-    name: string;
-    rating: 1 | 2 | 3 | 4 | 5;
-    text: string;
-    avatarUrl?: string;
-    featured: boolean;
-    sortOrder: number;
-    active: boolean;
-}
-export interface BeforeAfterItem {
-    id: string;
-    beforeImage: string;
-    afterImage: string;
-    productId?: string;
-    caption: string;
-    sortOrder: number;
-}
-export interface CarouselSlideCard {
-    id: string;
-    gridRow: 1 | 2;
-    gridCol: 1 | 2 | 3;
-    background: {
-        type: "color" | "gradient" | "image" | "transparent";
-        value: string;
-    };
-    content?: {
-        title?: string;
-        subtitle?: string;
-        description?: string;
-    };
-    buttons?: Array<{
-        id: string;
-        text: string;
-        link: string;
-        variant: "primary" | "secondary" | "outline";
-        openInNewTab: boolean;
-    }>;
-    isButtonOnly: boolean;
-    sizing?: {
-        widthPct?: 25 | 50 | 75 | 100;
-        heightPct?: 25 | 50 | 75 | 100;
-        padding?: "none" | "sm" | "md" | "lg";
-    };
-}
-export interface CarouselSlide {
-    id: string;
-    title: string;
-    order: number;
-    active: boolean;
-    media: {
-        type: "image" | "video";
-        url: string;
-        alt: string;
-        thumbnail?: string;
-    };
-    link?: {
-        url: string;
-        openInNewTab: boolean;
-    };
-    mobileMedia?: {
-        type: "image" | "video";
-        url: string;
-        alt: string;
-    };
-    cards: CarouselSlideCard[];
-    overlay?: {
-        title?: string;
-        subtitle?: string;
-        description?: string;
-        button?: {
-            id: string;
-            text: string;
-            link: string;
-            variant: "primary" | "secondary" | "outline";
-            openInNewTab: boolean;
-        };
-    };
-    createdAt?: string;
-    updatedAt?: string;
-}

package/dist/features/homepage/types/index.js

@@ -1 +0,0 @@
-export {};

package/dist/features/layout/AutoBreadcrumbs.d.ts

@@ -1,15 +0,0 @@
-import React from "react";
-export interface AutoBreadcrumbsProps {
-    /** Additional path segment → label overrides. Merged with defaults. */
-    pathLabels?: Record<string, string>;
-    /** Custom separator. Defaults to "/" */
-    separator?: React.ReactNode;
-    className?: string;
-    /** Custom link renderer — defaults to a plain `<a>`. */
-    renderLink?: (href: string, label: string) => React.ReactNode;
-}
-/**
- * AutoBreadcrumbs — generates breadcrumb navigation automatically from the
- * current URL path. Zero props required for basic use.
- */
-export declare function AutoBreadcrumbs({ pathLabels, separator, className, renderLink, }: AutoBreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/features/layout/AutoBreadcrumbs.js

@@ -1,84 +0,0 @@
-"use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import Link from "next/link";
-import { usePathname } from "next/navigation";
-import { Li, Nav, Ol, Span } from "../../ui";
-/** Map of path segments → human-readable labels. */
-const DEFAULT_PATH_LABELS = {
-    auth: "Authentication",
-    login: "Login",
-    register: "Register",
-    "forgot-password": "Forgot Password",
-    "reset-password": "Reset Password",
-    "verify-email": "Verify Email",
-    profile: "Profile",
-    settings: "Settings",
-    admin: "Admin",
-    users: "Users",
-    dashboard: "Dashboard",
-    products: "Products",
-    cart: "Cart",
-    wishlist: "Wishlist",
-    orders: "Orders",
-    addresses: "Addresses",
-    categories: "Categories",
-    search: "Search",
-    checkout: "Checkout",
-    blog: "Blog",
-    view: "View",
-    add: "Add",
-    edit: "Edit",
-};
-// Common locale codes filtered out of path segments
-const LOCALE_CODES = new Set([
-    "en",
-    "hi",
-    "fr",
-    "de",
-    "es",
-    "pt",
-    "zh",
-    "ja",
-    "ko",
-    "ar",
-    "mr",
-    "bn",
-    "ta",
-    "te",
-    "gu",
-    "kn",
-    "ml",
-    "pa",
-    "ur",
-]);
-function capitalize(s) {
-    return s.charAt(0).toUpperCase() + s.slice(1).replace(/-/g, " ");
-}
-/**
- * AutoBreadcrumbs — generates breadcrumb navigation automatically from the
- * current URL path. Zero props required for basic use.
- */
-export function AutoBreadcrumbs({ pathLabels, separator = "/", className = "", renderLink, }) {
-    const pathname = usePathname();
-    const labels = { ...DEFAULT_PATH_LABELS, ...pathLabels };
-    const rawSegments = pathname.split("/").filter(Boolean);
-    const leadingSegment = rawSegments[0]?.toLowerCase();
-    const hasLocalePrefix = !!leadingSegment &&
-        (LOCALE_CODES.has(leadingSegment) ||
-            /^[a-z]{2}-[a-z]{2}$/.test(leadingSegment));
-    const localePrefix = hasLocalePrefix ? `/${rawSegments[0]}` : "";
-    const segments = rawSegments.filter((seg) => !LOCALE_CODES.has(seg.toLowerCase()) &&
-        !/^[0-9a-f-]{8,}$/.test(seg) &&
-        !/^\d+$/.test(seg));
-    if (segments.length === 0)
-        return null;
-    const crumbs = segments.map((seg, i) => ({
-        label: labels[seg] ?? capitalize(seg),
-        href: `${localePrefix}/${segments.slice(0, i + 1).join("/")}`,
-    }));
-    const allCrumbs = [{ label: "Home", href: localePrefix || "/" }, ...crumbs];
-    return (_jsx(Nav, { "aria-label": "Breadcrumb", className: className, children: _jsx(Ol, { className: "flex items-center gap-2 text-sm flex-wrap", children: allCrumbs.map((crumb, index) => {
-                const isLast = index === allCrumbs.length - 1;
-                return (_jsxs(Li, { className: "flex items-center gap-2", children: [isLast ? (_jsx(Span, { "aria-current": "page", className: "text-zinc-500 dark:text-zinc-400", children: crumb.label })) : renderLink ? (renderLink(crumb.href, crumb.label)) : (_jsx(Link, { href: crumb.href, className: "text-zinc-600 dark:text-zinc-400 hover:text-zinc-900 dark:hover:text-zinc-100 transition-colors", children: crumb.label })), !isLast && (_jsx(Span, { className: "text-zinc-400 dark:text-zinc-500 select-none", "aria-hidden": "true", children: separator }))] }, crumb.href));
-            }) }) }));
-}

package/dist/features/layout/BackToTop.d.ts

@@ -1,16 +0,0 @@
-import "client-only";
-export interface BackToTopProps {
-    /** Scroll distance (px) before the button appears. Defaults to 400. */
-    threshold?: number;
-    ariaLabel?: string;
-    className?: string;
-}
-/**
- * BackToTop — floating scroll-to-top button.
- * Appears after the page has scrolled past `threshold` pixels.
- */
-export declare function BackToTop({ threshold, ariaLabel, className, }: BackToTopProps): import("react/jsx-runtime").JSX.Element | null;
-/** SkipToMain — visually hidden link that becomes visible on focus for keyboard users. */
-export declare function SkipToMain({ mainId }: {
-    mainId?: string;
-}): import("react/jsx-runtime").JSX.Element;

package/dist/features/layout/BackToTop.js

@@ -1,26 +0,0 @@
-"use client";
-import { jsx as _jsx } from "react/jsx-runtime";
-import "client-only";
-import Link from "next/link";
-import { useEffect, useState } from "react";
-import { ChevronUp } from "lucide-react";
-import { Button } from "../../ui";
-/**
- * BackToTop — floating scroll-to-top button.
- * Appears after the page has scrolled past `threshold` pixels.
- */
-export function BackToTop({ threshold = 400, ariaLabel = "Back to top", className = "", }) {
-    const [visible, setVisible] = useState(false);
-    useEffect(() => {
-        const handleScroll = () => setVisible(window.scrollY > threshold);
-        window.addEventListener("scroll", handleScroll, { passive: true });
-        return () => window.removeEventListener("scroll", handleScroll);
-    }, [threshold]);
-    if (!visible)
-        return null;
-    return (_jsx(Button, { type: "button", variant: "outline", size: "sm", "aria-label": ariaLabel, onClick: () => window.scrollTo({ top: 0, behavior: "smooth" }), className: `fixed bottom-20 right-4 z-40 flex items-center justify-center w-10 h-10 rounded-full bg-white dark:bg-slate-800 border border-zinc-200 dark:border-slate-700 shadow-md text-zinc-600 dark:text-zinc-300 hover:bg-zinc-100 dark:hover:bg-slate-700 transition-colors ${className}`, children: _jsx(ChevronUp, { className: "w-5 h-5", "aria-hidden": "true" }) }));
-}
-/** SkipToMain — visually hidden link that becomes visible on focus for keyboard users. */
-export function SkipToMain({ mainId = "main-content" }) {
-    return (_jsx(Link, { href: `#${mainId}`, className: "sr-only focus:not-sr-only focus:fixed focus:top-4 focus:left-4 focus:z-[100] focus:px-4 focus:py-2 focus:rounded-lg focus:bg-white dark:focus:bg-slate-900 focus:text-zinc-900 dark:focus:text-zinc-100 focus:shadow-lg focus:ring-2 focus:ring-primary-500 focus:outline-none text-sm font-medium", children: "Skip to main content" }));
-}

package/dist/features/layout/BottomActions.d.ts

@@ -1 +0,0 @@
-export default function BottomActions(): import("react/jsx-runtime").JSX.Element;

package/dist/features/layout/BottomActions.js

@@ -1,153 +0,0 @@
-"use client";
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/**
- * BottomActions Component
- *
- * A fixed-bottom mobile action bar rendered **above** BottomNavbar (bottom-14).
- * Reads from `BottomActionsContext` — features register their actions via the
- * `useBottomActions` hook; this component just renders whatever is registered.
- *
- * Two modes:
- *  - **Page mode** — shows registered page-level actions inline (Add to Cart,
- *    Buy Now, Place Bid, Proceed to Checkout, etc.) with an optional info label.
- *  - **Bulk mode** — activates when `bulk.selectedCount > 0`; shows:
- *      • Selection count pill on the left (tap to deselect all)
- *      • An upward-opening type-picker dropdown (middle, flex-1) — tap to
- *        choose WHICH action to run; the chosen label is always visible.
- *      • An "Apply" submit button on the right — executes the selected action,
- *        styled with the selected action's variant (danger = red, etc.).
- *
- * Layout rules:
- *  - Hidden on lg+ screens (`lg:hidden`) — desktop shows inline action panels.
- *  - The bar slides up with a 300 ms ease-out transition; `pointer-events-none`
- *    while off-screen.
- *
- * @component
- * @example
- * // Automatically rendered by LayoutClient — no manual usage required.
- * // Features use `useBottomActions` to register their actions.
- */
-import { useState, useRef, useEffect } from "react";
-import { useTranslations } from "next-intl";
-import { X, ChevronUp, ChevronDown, Check } from "lucide-react";
-import { useBottomActionsContext } from "./BottomActionsContext";
-import { useClickOutside } from "../../react";
-import { Row, Span, Text, Button } from "../../ui";
-// Token values inlined from @mohasinac/appkit/tokens
-const BOTTOM_NAV_BG = "bg-white/90 dark:bg-slate-950/90 backdrop-blur-md border-t border-zinc-200/80 dark:border-slate-800/80";
-const Z_BOTTOM_ACTIONS = "z-40";
-const BOTTOM_NAV_HEIGHT = "h-14";
-const FLEX_CENTER = "flex items-center justify-center";
-export default function BottomActions() {
-    const tActions = useTranslations("actions");
-    const tBottom = useTranslations("bottomActions");
-    const { state, actionCallbacksRef, bulkCallbacksRef, bulkClearRef } = useBottomActionsContext();
-    const [pickerOpen, setPickerOpen] = useState(false);
-    const [selectedActionId, setSelectedActionId] = useState(null);
-    const containerRef = useRef(null);
-    useClickOutside(containerRef, () => setPickerOpen(false));
-    const { actions, bulk, infoLabel } = state;
-    const isBulkMode = !!(bulk && bulk.selectedCount > 0);
-    const bulkActions = bulk?.actions ?? [];
-    const pageActions = actions;
-    const isVisible = (isBulkMode ? bulkActions.length > 0 || !!bulk : pageActions.length > 0) ||
-        !!infoLabel;
-    // Keep selectedActionId in sync with available bulk actions
-    useEffect(() => {
-        if (!isBulkMode) {
-            setPickerOpen(false);
-            setSelectedActionId(null);
-            return;
-        }
-        setSelectedActionId((prev) => {
-            const ids = bulkActions.map((a) => a.id);
-            if (prev && ids.includes(prev))
-                return prev;
-            return ids[0] ?? null;
-        });
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [isBulkMode, bulkActions.map((a) => a.id).join(",")]);
-    const selectedAction = bulkActions.find((a) => a.id === selectedActionId);
-    const dispatchAction = (id) => actionCallbacksRef.current.get(id)?.();
-    const dispatchBulkClear = () => {
-        bulkClearRef.current?.();
-        setPickerOpen(false);
-    };
-    const handleApply = () => {
-        if (!selectedActionId)
-            return;
-        bulkCallbacksRef.current.get(selectedActionId)?.();
-        setPickerOpen(false);
-    };
-    return (_jsxs("div", { ref: containerRef, role: "toolbar", "aria-label": isBulkMode ? tBottom("bulkActionsLabel") : tBottom("pageActionsLabel"), "aria-hidden": !isVisible, className: [
-            "fixed bottom-14 left-0 right-0 lg:hidden",
-            Z_BOTTOM_ACTIONS,
-            BOTTOM_NAV_BG,
-            "shadow-[0_-4px_20px_rgba(0,0,0,0.08)] dark:shadow-[0_-4px_20px_rgba(0,0,0,0.30)]",
-            "will-change-transform transition-transform duration-300 ease-out",
-            isVisible ? "translate-y-0" : "translate-y-full pointer-events-none",
-        ]
-            .filter(Boolean)
-            .join(" "), children: [isBulkMode && (_jsx("div", { role: "listbox", "aria-label": tBottom("bulkActionsLabel"), className: [
-                    "absolute bottom-full left-0 right-0 overflow-hidden",
-                    BOTTOM_NAV_BG,
-                    "border-t border-zinc-200/80 dark:border-slate-700/80",
-                    "shadow-[0_-8px_24px_rgba(0,0,0,0.10)] dark:shadow-[0_-8px_24px_rgba(0,0,0,0.35)]",
-                    "transition-[max-height,opacity] duration-200 ease-out",
-                    pickerOpen
-                        ? "max-h-64 opacity-100"
-                        : "max-h-0 opacity-0 pointer-events-none",
-                ]
-                    .filter(Boolean)
-                    .join(" "), children: bulkActions.map((action, i) => {
-                    const isSelected = action.id === selectedActionId;
-                    return (_jsxs(Button, { role: "option", "aria-selected": isSelected, type: "button", variant: "ghost", disabled: action.disabled || action.loading, onClick: () => {
-                            setSelectedActionId(action.id);
-                            setPickerOpen(false);
-                        }, className: [
-                            "w-full flex items-center gap-3 px-5 py-3.5 text-left text-sm font-medium transition-colors rounded-none",
-                            i > 0
-                                ? "border-t border-zinc-100/80 dark:border-slate-800/80"
-                                : "",
-                            isSelected ? "bg-zinc-50 dark:bg-slate-800/60" : "",
-                            action.variant === "danger"
-                                ? "text-red-600 dark:text-red-400 hover:bg-red-50 dark:hover:bg-red-950/30"
-                                : "text-zinc-800 dark:text-zinc-100 hover:bg-zinc-50 dark:hover:bg-slate-800/60",
-                            action.disabled || action.loading
-                                ? "opacity-50 cursor-not-allowed"
-                                : "",
-                        ]
-                            .filter(Boolean)
-                            .join(" "), children: [action.icon && (_jsx(Span, { className: `flex-shrink-0 w-5 h-5 ${FLEX_CENTER}`, "aria-hidden": "true", children: action.icon })), _jsx(Span, { className: "flex-1 truncate", children: action.label }), isSelected && (_jsx(Check, { className: "w-4 h-4 flex-shrink-0 text-primary-600 dark:text-primary-400", "aria-hidden": "true" }))] }, action.id));
-                }) })), isBulkMode && (_jsx("div", { className: "h-[3px] w-full bg-gradient-to-r from-primary-600 via-primary-400 to-primary-600 dark:from-secondary-600 dark:via-secondary-400 dark:to-secondary-600" })), infoLabel && !isBulkMode && (_jsx("div", { className: "px-4 pt-2 pb-0 border-b border-zinc-100/80 dark:border-slate-800/80", children: _jsx(Text, { className: "text-xs font-semibold text-zinc-500 dark:text-zinc-400 leading-5 truncate", children: infoLabel }) })), _jsx(Row, { className: `gap-2 px-3 ${BOTTOM_NAV_HEIGHT}`, children: isBulkMode && bulk ? (_jsxs(_Fragment, { children: [_jsxs(Button, { type: "button", variant: "ghost", onClick: dispatchBulkClear, className: "inline-flex items-center gap-1.5 flex-shrink-0 bg-primary-50 hover:bg-primary-100 active:bg-primary-200 dark:bg-primary-950/30 dark:hover:bg-primary-900/50 text-primary-700 dark:text-primary-300 rounded-full pl-2 pr-3 h-8 border border-primary-200/70 dark:border-primary-800/50 transition-colors min-h-0", "aria-label": tActions("clearSelection"), children: [_jsx(X, { className: "w-3.5 h-3.5 flex-shrink-0", "aria-hidden": "true" }), _jsx(Span, { className: "text-xs font-semibold tabular-nums whitespace-nowrap leading-none", children: bulk.noun
-                                        ? `${bulk.selectedCount} ${bulk.noun}`
-                                        : tBottom("selectedCount", { count: bulk.selectedCount }) })] }), bulkActions.length > 0 && (_jsxs(Button, { type: "button", variant: "ghost", onClick: () => setPickerOpen((o) => !o), "aria-haspopup": "listbox", "aria-expanded": pickerOpen, className: [
-                                "flex-1 min-w-0 h-10 flex items-center gap-2 px-3 rounded-lg border text-sm font-medium transition-colors",
-                                "bg-zinc-50 hover:bg-zinc-100 active:bg-zinc-200 dark:bg-slate-800/60 dark:hover:bg-slate-700/60",
-                                "border-zinc-200 dark:border-slate-700",
-                                selectedAction?.variant === "danger"
-                                    ? "text-red-600 dark:text-red-400"
-                                    : "text-zinc-800 dark:text-zinc-100",
-                            ]
-                                .filter(Boolean)
-                                .join(" "), children: [selectedAction?.icon && (_jsx(Span, { className: `flex-shrink-0 w-4 h-4 ${FLEX_CENTER}`, "aria-hidden": "true", children: selectedAction.icon })), _jsx(Span, { className: "flex-1 truncate text-left leading-none", children: selectedAction?.label ?? tBottom("bulkActionsLabel") }), pickerOpen ? (_jsx(ChevronDown, { className: "w-4 h-4 flex-shrink-0 text-zinc-400", "aria-hidden": "true" })) : (_jsx(ChevronUp, { className: "w-4 h-4 flex-shrink-0 text-zinc-400", "aria-hidden": "true" }))] })), bulkActions.length > 0 && (_jsx(Button, { type: "button", variant: selectedAction?.variant ?? "primary", size: "sm", isLoading: selectedAction?.loading, disabled: !selectedActionId ||
-                                selectedAction?.disabled ||
-                                selectedAction?.loading, onClick: handleApply, className: "h-10 flex-shrink-0", children: _jsx(Span, { className: "leading-none", children: tBottom("apply") }) }))] })) : (
-                /* Page mode — action buttons inline ────────────────────────────── */
-                pageActions.map((action) => {
-                    const isIconOnly = !action.label;
-                    const growClass = isIconOnly || action.grow === false
-                        ? "flex-shrink-0 w-11"
-                        : "flex-1 min-w-0";
-                    return (_jsxs(Button, { type: "button", variant: action.variant ?? "primary", size: "sm", isLoading: action.loading, disabled: action.disabled, onClick: () => dispatchAction(action.id), className: [
-                            "h-10 relative",
-                            growClass,
-                            isIconOnly ? "px-0 justify-center" : "",
-                        ]
-                            .filter(Boolean)
-                            .join(" "), children: [action.icon && (_jsx(Span, { className: [
-                                    "flex-shrink-0",
-                                    action.label ? "mr-1.5" : "",
-                                ].join(" "), "aria-hidden": "true", children: action.icon })), action.label && (_jsx(Span, { className: "truncate leading-none", children: action.label })), action.badge !== undefined && (_jsx(Span, { className: `absolute -top-1.5 -right-1.5 min-w-[18px] h-[18px] bg-red-500 text-white text-[10px] font-bold rounded-full ${FLEX_CENTER} px-1 pointer-events-none select-none`, "aria-hidden": "true", children: action.badge }))] }, action.id));
-                })) })] }));
-}

package/dist/features/layout/BottomActionsContext.d.ts

@@ -1,107 +0,0 @@
-/**
- * BottomActionsContext
- *
- * Provides a context for registering page-level mobile action bars.
- * Features call `useBottomActions` to push actions; the `<BottomActions>`
- * layout component reads this context and renders the bar above BottomNavbar.
- *
- * Supports two modes:
- *  - Page mode: primary page actions (Add to Cart, Buy Now, Place Bid, etc.)
- *  - Bulk mode: activated when `bulk.selectedCount > 0` — shows selection
- *    count + custom bulk action buttons (Delete, Archive, Export, etc.)
- *
- * @example — product detail page
- * ```tsx
- * useBottomActions({
- *   actions: [
- *     { id: "wishlist", icon: <Heart className="w-4 h-4" />, label: t("wishlist"), variant: "ghost", grow: false, onClick: handleWishlist },
- *     { id: "cart",    label: t("addToCart"), variant: "outline", onClick: handleAddToCart },
- *     { id: "buy",     label: t("buyNow"),    variant: "primary", onClick: handleBuyNow },
- *   ],
- * });
- * ```
- *
- * @example — admin listing with bulk select
- * ```tsx
- * useBottomActions({
- *   bulk: {
- *     selectedCount: selectedIds.length,
- *     onClearSelection: () => setSelectedIds([]),
- *     actions: [
- *       { id: "delete", label: t("bulkDelete", { count: selectedIds.length }), variant: "danger", onClick: handleBulkDelete },
- *     ],
- *   },
- * });
- * ```
- */
-import React from "react";
-import type { ButtonProps } from "../../ui";
-export interface BottomAction {
-    /** Stable unique key (used as React key). */
-    id: string;
-    /** Button label — use `useTranslations()` output. */
-    label?: string;
-    /** Optional leading icon (e.g., `<Heart className="w-4 h-4" />`). */
-    icon?: React.ReactNode;
-    /** Button variant — defaults to "primary". */
-    variant?: ButtonProps["variant"];
-    /** Small count/badge overlay rendered in the top-right corner of the button. */
-    badge?: string | number;
-    /** Called when the user taps the action. */
-    onClick: () => void;
-    /** Whether the button is disabled. */
-    disabled?: boolean;
-    /** Show spinner inside the button. */
-    loading?: boolean;
-    /**
-     * When true (default) the button grows to fill remaining space.
-     * Set to false for compact icon-only buttons.
-     */
-    grow?: boolean;
-}
-export interface BottomBulkConfig {
-    /** Number of currently selected items. Bar activates when > 0. */
-    selectedCount: number;
-    /** Optional noun shown next to count, e.g. "products". Defaults to "selected". */
-    noun?: string;
-    /** Called when the user taps the ✕ pill to deselect all. */
-    onClearSelection: () => void;
-    /** Bulk action buttons, rendered right of the selection pill. */
-    actions: BottomAction[];
-}
-export interface BottomActionsState {
-    /** Page-level primary actions. */
-    actions: BottomAction[];
-    /** Bulk-selection config. Bulk mode activates when selectedCount > 0. */
-    bulk?: BottomBulkConfig;
-    /**
-     * Optional single-line info label rendered above the action row.
-     * Useful for contextual data like "Current bid: ₹1,200" on auction pages.
-     */
-    infoLabel?: string;
-}
-interface BottomActionsContextValue {
-    state: BottomActionsState;
-    /** Replace the page-level actions. Pass empty array to clear. */
-    setActions: (actions: BottomAction[]) => void;
-    /**
-     * Store current onClick handlers for actions without triggering a re-render.
-     * The component dispatches clicks via this ref to avoid stale closures.
-     */
-    actionCallbacksRef: React.MutableRefObject<Map<string, () => void>>;
-    /** Set or clear the bulk config. */
-    setBulkConfig: (config: BottomBulkConfig | undefined) => void;
-    /** Ref mirror for bulk callbacks. */
-    bulkCallbacksRef: React.MutableRefObject<Map<string, () => void>>;
-    /** Set or clear the bulk clear handler. */
-    bulkClearRef: React.MutableRefObject<(() => void) | undefined>;
-    /** Set or clear the contextual info label. */
-    setInfoLabel: (label: string | undefined) => void;
-    /** Clear all state (called on feature unmount). */
-    clearAll: () => void;
-}
-export declare function BottomActionsProvider({ children, }: {
-    children: React.ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function useBottomActionsContext(): BottomActionsContextValue;
-export {};