@mohasinac/appkit 4.3.0 → 4.3.2

package/dist/features/pre-orders/components/MarketplacePreorderCard.js

@@ -64,5 +64,5 @@ export function MarketplacePreorderCard({ product, className = "", variant = "gr
                 /* ── Compact list layout ── */
                 _jsxs(_Fragment, { children: [_jsxs(Row, { className: "min-w-0", align: "start", justify: "between", gap: "sm", children: [_jsx(TextLink, { href: detailHref, className: "min-w-0 flex-1", children: _jsx(Text, { size: "sm", weight: "medium", color: "primary", truncate: 2, children: product.title }) }), wishlistActions && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", className: `shrink-0 p-[0.25rem] leading-none ${inWishlist ? "text-primary" : "text-[var(--appkit-color-text-faint)]"}`, onClick: handleWishlist, "aria-label": inWishlist ? mergedLabels.removeFromWishlist : mergedLabels.addToWishlist, children: inWishlist ? "♥" : "♡" }))] }), _jsxs(Row, { align: "center", gap: "sm", wrap: true, children: [_jsx(Text, { className: "text-primary", size: "sm", weight: "bold", children: formatCurrency(product.price, getDefaultCurrency()) }), shipDate && _jsx(PreorderBadge, { shipDate: shipDate })] }), _jsx(Button, { type: "button", variant: "primary", size: "sm", textSize: "xs", className: "self-start mt-0.5", onClick: handleNavigate, children: mergedLabels.reserveNow })] })) : (
                 /* ── Full grid layout ── */
-                _jsxs(_Fragment, { children: [_jsx(TextLink, { href: detailHref, children: _jsx(Text, { size: "sm", weight: "medium", color: "primary", truncate: 2, children: product.title }) }), product.description ? (_jsx(RichText, { html: normalizeRichTextHtml(product.description), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "line-clamp-2 text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)]" })) : null, _jsxs(Row, { justify: "between", className: "mt-1", gap: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: formatCurrency(product.price, getDefaultCurrency()) }), shipDate && _jsx(PreorderBadge, { shipDate: shipDate })] }), _jsxs(Row, { justify: "between", className: "mt-auto pt-2", gap: "sm", children: [_jsx(Button, { type: "button", variant: "primary", size: "sm", textSize: "xs", className: "flex-1", onClick: handleNavigate, children: mergedLabels.reserveNow }), onAddToCart ? (_jsx(Button, { type: "button", variant: "outline", size: "sm", textSize: "xs", className: "flex-1", onClick: (e) => { e.stopPropagation(); onAddToCart(product); }, children: mergedLabels.addToCart })) : null, wishlistActions ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", className: `${inWishlist ? "text-primary" : "text-[var(--appkit-color-text-muted)]"}`, onClick: handleWishlist, "aria-label": inWishlist ? mergedLabels.removeFromWishlist : mergedLabels.addToWishlist, children: inWishlist ? "♥" : "♡" })) : null] })] })) })] }));
+                _jsxs(_Fragment, { children: [_jsx(TextLink, { href: detailHref, children: _jsx(Text, { size: "sm", weight: "medium", color: "primary", truncate: 2, children: product.title }) }), product.description ? (_jsx(RichText, { html: normalizeRichTextHtml(product.description), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "line-clamp-2 text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)]" })) : null, _jsxs(Row, { justify: "between", className: "mt-1", gap: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: formatCurrency(product.price, getDefaultCurrency()) }), shipDate && _jsx(PreorderBadge, { shipDate: shipDate })] }), _jsxs(Row, { justify: "between", className: "mt-auto pt-[var(--appkit-space-2)]", gap: "sm", children: [_jsx(Button, { type: "button", variant: "primary", size: "sm", textSize: "xs", className: "flex-1", onClick: handleNavigate, children: mergedLabels.reserveNow }), onAddToCart ? (_jsx(Button, { type: "button", variant: "outline", size: "sm", textSize: "xs", className: "flex-1", onClick: (e) => { e.stopPropagation(); onAddToCart(product); }, children: mergedLabels.addToCart })) : null, wishlistActions ? (_jsx(Button, { type: "button", variant: "ghost", size: "sm", className: `${inWishlist ? "text-primary" : "text-[var(--appkit-color-text-muted)]"}`, onClick: handleWishlist, "aria-label": inWishlist ? mergedLabels.removeFromWishlist : mergedLabels.addToWishlist, children: inWishlist ? "♥" : "♡" })) : null] })] })) })] }));
 }

package/dist/features/products/components/MarketplaceBundleCard.js

@@ -49,7 +49,7 @@ export function MarketplaceBundleCard({ bundle, className = "", variant = "grid"
         }
         router.push(String(detailHref));
     }, [detailHref, onNavigate, router]);
-    return (_jsxs(BaseListingCard, { isSelected: isSelected, variant: variant, className: className, onMouseDown: !isSelected ? longPress.onMouseDown : undefined, onMouseUp: !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: !isSelected ? longPress.onTouchEnd : undefined, onTouchCancel: !isSelected ? longPress.onTouchCancel : undefined, children: [_jsxs(BaseListingCard.Hero, { aspect: "square", variant: variant, children: [_jsx(TextLink, { href: String(detailHref), className: "absolute inset-0 block", children: showCollage ? (_jsx(Div, { layout: "grid", className: `h-full w-full gap-[0.125rem] bg-[var(--appkit-color-surface-muted)] ${collageTiles.length === 2 ? "grid-cols-2 grid-rows-1" : "grid-cols-2 grid-rows-2"}`, children: collageTiles.map((tile, i) => (_jsxs(Div, { className: "relative overflow-hidden bg-[var(--appkit-color-surface-muted)]", children: [_jsx(MediaImage, { src: tile.imageURL, alt: tile.title ?? `${bundle.name} item ${i + 1}`, size: "card" }), i === collageTiles.length - 1 && overflow > 0 && (_jsxs(Row, { textWeight: "semibold", textSize: "sm", surface: "overlay-md", className: "absolute inset-0 text-white", align: "center", justify: "center", children: ["+", overflow] }))] }, `${tile.productId}-${i}`))) })) : cover ? (_jsx(Div, { className: "absolute inset-0 bg-[var(--appkit-color-surface-muted)]", children: _jsx(MediaImage, { src: cover, alt: bundle.name, size: "card" }) })) : (_jsx(Row, { className: "absolute inset-0 bg-[var(--appkit-color-surface-muted)]", align: "center", justify: "center", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: "No image" }) })) }), discount && (_jsx(Span, { size: "xs", weight: "bold", color: "inverse", className: "absolute left-2 top-2 bg-success-surface", rounded: "full", padding: "pill-xs", children: BUNDLE_COPY.detail.discountBadge(discount.percent) })), _jsxs(Stack, { className: "absolute right-2 top-2", align: "end", gap: "xs", children: [_jsx(Span, { size: "xs", weight: "medium", className: CLS_BUNDLE_PILL, children: mergedLabels.bundleBadge }), _jsx(Span, { layout: "inline-flex", color: "inverse", className: `${stock === "out_of_stock" ? "bg-neutral-500 " : CLS_STOCK_OK}`, rounded: "full", padding: "pill-xs", size: "xs", weight: "medium", children: stock === "out_of_stock" ? mergedLabels.outOfStockBadge : mergedLabels.inStockBadge })] }), stock === "out_of_stock" && (_jsx(Row, { surface: "overlay-xs", className: "absolute inset-0", align: "center", justify: "center", children: _jsx(Span, { color: "inverse", size: "xs", weight: "bold", className: "bg-neutral-900/80 tracking-wider", rounded: "default", padding: "pill-md", transform: "uppercase", children: mergedLabels.outOfStockBadge }) })), onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (event) => {
+    return (_jsxs(BaseListingCard, { isSelected: isSelected, variant: variant, className: className, onMouseDown: !isSelected ? longPress.onMouseDown : undefined, onMouseUp: !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: !isSelected ? longPress.onTouchEnd : undefined, onTouchCancel: !isSelected ? longPress.onTouchCancel : undefined, children: [_jsxs(BaseListingCard.Hero, { aspect: "square", variant: variant, children: [_jsx(TextLink, { href: String(detailHref), className: "absolute inset-0 block", children: showCollage ? (_jsx(Div, { layout: "grid", className: `h-full w-full gap-[0.125rem] bg-[var(--appkit-color-surface-muted)] ${collageTiles.length === 2 ? "grid-cols-2 grid-rows-1" : "grid-cols-2 grid-rows-2"}`, children: collageTiles.map((tile, i) => (_jsxs(Div, { className: "relative overflow-hidden bg-[var(--appkit-color-surface-muted)]", children: [_jsx(MediaImage, { src: tile.imageURL, alt: tile.title ?? `${bundle.name} item ${i + 1}`, size: "card" }), i === collageTiles.length - 1 && overflow > 0 && (_jsxs(Row, { textWeight: "semibold", textSize: "sm", surface: "overlay-md", className: "absolute inset-0 text-white", align: "center", justify: "center", children: ["+", overflow] }))] }, `${tile.productId}-${i}`))) })) : cover ? (_jsx(Div, { className: "absolute inset-0 bg-[var(--appkit-color-surface-muted)]", children: _jsx(MediaImage, { src: cover, alt: bundle.name, size: "card" }) })) : (_jsx(Row, { className: "absolute inset-0 bg-[var(--appkit-color-surface-muted)]", align: "center", justify: "center", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: "No image" }) })) }), discount && (_jsx(Span, { size: "xs", weight: "bold", color: "inverse", surface: "success-surface", className: "absolute left-2 top-2", rounded: "full", padding: "pill-xs", children: BUNDLE_COPY.detail.discountBadge(discount.percent) })), _jsxs(Stack, { className: "absolute right-2 top-2", align: "end", gap: "xs", children: [_jsx(Span, { size: "xs", weight: "medium", className: CLS_BUNDLE_PILL, children: mergedLabels.bundleBadge }), _jsx(Span, { layout: "inline-flex", color: "inverse", className: `${stock === "out_of_stock" ? "bg-neutral-500 " : CLS_STOCK_OK}`, rounded: "full", padding: "pill-xs", size: "xs", weight: "medium", children: stock === "out_of_stock" ? mergedLabels.outOfStockBadge : mergedLabels.inStockBadge })] }), stock === "out_of_stock" && (_jsx(Row, { surface: "overlay-xs", className: "absolute inset-0", align: "center", justify: "center", children: _jsx(Span, { color: "inverse", size: "xs", weight: "bold", className: "bg-neutral-900/80 tracking-wider", rounded: "default", padding: "pill-md", transform: "uppercase", children: mergedLabels.outOfStockBadge }) })), onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (event) => {
                             event.stopPropagation();
                             onSelect(bundle.id, !isSelected);
                         }, className: selectable || isSelected

package/dist/features/products/components/ProductGalleryClient.js

@@ -42,9 +42,9 @@ export function ProductGalleryClient({ images, video, productName }) {
                                 : "Product video"
                             : productName
                                 ? `${productName} — image ${activeIndex + 1}`
-                                : `Product image ${activeIndex + 1}`, size: "gallery", className: "transition-transform duration-300 hover:scale-105" }), activeSlide.kind === "video" && (_jsx(Row, { className: "absolute inset-0 pointer-events-none", align: "center", justify: "center", children: _jsx(Row, { className: "h-16 w-16 rounded-full bg-black/50 text-white", align: "center", justify: "center", children: _jsx(Play, { className: "h-7 w-7 fill-current", "aria-hidden": "true" }) }) }))] }), slides.length > 1 && (_jsx(Div, { layout: "flex", gap: "2", className: `${__O.xAuto}`, padding: "b-2xs", children: slides.map((slide, i) => (_jsxs(Button, { variant: "ghost", type: "button", onClick: () => setActiveIndex(i), rounded: "lg", paddingX: "none", paddingY: "none", className: `relative flex-shrink-0 h-16 w-16 overflow-hidden border-2 transition-all${i === activeIndex
+                                : `Product image ${activeIndex + 1}`, size: "gallery", className: "transition-transform duration-300 hover:scale-105" }), activeSlide.kind === "video" && (_jsx(Row, { className: "absolute inset-0 pointer-events-none", align: "center", justify: "center", children: _jsx(Row, { surface: "overlay-sm", rounded: "full", className: "h-16 w-16 text-white", align: "center", justify: "center", children: _jsx(Play, { className: "h-7 w-7 fill-current", "aria-hidden": "true" }) }) }))] }), slides.length > 1 && (_jsx(Div, { layout: "flex", gap: "2", className: `${__O.xAuto}`, padding: "b-2xs", children: slides.map((slide, i) => (_jsxs(Button, { variant: "ghost", type: "button", onClick: () => setActiveIndex(i), rounded: "lg", paddingX: "none", paddingY: "none", className: `relative flex-shrink-0 h-16 w-16 overflow-hidden border-2 transition-all${i === activeIndex
                         ? " border-primary-500"
-                        : " border-transparent opacity-60 hover:opacity-100"}`, "aria-label": slide.kind === "video" ? "View video" : `View image ${i + 1}`, "aria-current": i === activeIndex ? "true" : undefined, children: [_jsx(MediaImage, { src: slide.kind === "video" ? slide.poster : slide.src, alt: slide.kind === "video" ? "Video thumbnail" : `Thumbnail ${i + 1}`, size: "thumbnail" }), slide.kind === "video" && (_jsx(Row, { className: "absolute inset-0 pointer-events-none bg-black/25", align: "center", justify: "center", children: _jsx(Play, { className: "h-5 w-5 text-white fill-current", "aria-hidden": "true" }) }))] }, i))) })), slides.length > 1 && (
+                        : " border-transparent opacity-60 hover:opacity-100"}`, "aria-label": slide.kind === "video" ? "View video" : `View image ${i + 1}`, "aria-current": i === activeIndex ? "true" : undefined, children: [_jsx(MediaImage, { src: slide.kind === "video" ? slide.poster : slide.src, alt: slide.kind === "video" ? "Video thumbnail" : `Thumbnail ${i + 1}`, size: "thumbnail" }), slide.kind === "video" && (_jsx(Row, { surface: "overlay-xs", className: "absolute inset-0 pointer-events-none", align: "center", justify: "center", children: _jsx(Play, { className: "h-5 w-5 text-white fill-current", "aria-hidden": "true" }) }))] }, i))) })), slides.length > 1 && (
             // audit-content-alignment-ok: functional image-counter label under the gallery, not page content
             _jsxs(Text, { size: "xs", align: "center", color: "faint", children: [activeIndex + 1, " / ", slides.length] })), _jsx(ImageLightbox, { images: lightboxImages, activeIndex: lightboxIndex, onClose: () => setLightboxIndex(null), onNavigate: (i) => setLightboxIndex(i) })] }));
 }

package/dist/features/products/constants/action-defs.d.ts

@@ -286,7 +286,6 @@ export declare const DASHBOARD_QUICK_ACTION_ID: {
     readonly ADMIN_EVENTS: "dqa-admin-events";
     readonly ADMIN_SUPPORT: "dqa-admin-support";
     readonly ADMIN_MODERATION: "dqa-admin-moderation";
-    readonly ADMIN_INTEGRATION_GUIDES: "dqa-admin-integration-guides";
     readonly ADMIN_USERS: "dqa-admin-users";
     readonly ADMIN_CATEGORIES: "dqa-admin-categories";
     readonly ADMIN_REVIEWS: "dqa-admin-reviews";
@@ -333,7 +332,7 @@ export interface DashboardQuickActionMeta {
 }
 export declare const DASHBOARD_QUICK_ACTION_META: Record<DashboardQuickActionId, DashboardQuickActionMeta>;
 export declare const DASHBOARD_QUICK_ACTIONS: {
-    readonly admin: readonly ["dqa-admin-add-product", "dqa-admin-add-user", "dqa-admin-add-store", "dqa-admin-add-coupon", "dqa-admin-add-event", "dqa-admin-add-blog", "dqa-admin-users", "dqa-admin-stores", "dqa-admin-orders", "dqa-admin-payouts", "dqa-admin-analytics", "dqa-admin-categories", "dqa-admin-reviews", "dqa-admin-events", "dqa-admin-faqs", "dqa-admin-carousel", "dqa-admin-sections", "dqa-admin-support", "dqa-admin-moderation", "dqa-admin-integration-guides", "dqa-admin-settings"];
+    readonly admin: readonly ["dqa-admin-add-product", "dqa-admin-add-user", "dqa-admin-add-store", "dqa-admin-add-coupon", "dqa-admin-add-event", "dqa-admin-add-blog", "dqa-admin-users", "dqa-admin-stores", "dqa-admin-orders", "dqa-admin-payouts", "dqa-admin-analytics", "dqa-admin-categories", "dqa-admin-reviews", "dqa-admin-events", "dqa-admin-faqs", "dqa-admin-carousel", "dqa-admin-sections", "dqa-admin-support", "dqa-admin-moderation", "dqa-admin-settings"];
     readonly seller: readonly ["dqa-seller-add-product", "dqa-seller-products", "dqa-seller-view-orders", "dqa-seller-analytics", "dqa-seller-add-coupon", "dqa-seller-auctions", "dqa-seller-payout-request", "dqa-seller-shipping", "dqa-seller-messages", "dqa-seller-whatsapp", "dqa-seller-reviews", "dqa-seller-storefront", "dqa-seller-settings"];
     readonly user: readonly ["dqa-user-view-orders", "dqa-user-view-wishlist", "dqa-user-edit-profile", "dqa-user-add-address", "dqa-user-recently-viewed", "dqa-user-my-catalogue", "dqa-user-my-coupons"];
 };

package/dist/features/products/constants/action-defs.js

@@ -356,7 +356,6 @@ export const DASHBOARD_QUICK_ACTION_ID = {
     ADMIN_EVENTS: "dqa-admin-events",
     ADMIN_SUPPORT: "dqa-admin-support",
     ADMIN_MODERATION: "dqa-admin-moderation",
-    ADMIN_INTEGRATION_GUIDES: "dqa-admin-integration-guides",
     ADMIN_USERS: "dqa-admin-users",
     ADMIN_CATEGORIES: "dqa-admin-categories",
     ADMIN_REVIEWS: "dqa-admin-reviews",
@@ -402,7 +401,6 @@ export const DASHBOARD_QUICK_ACTION_META = {
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_EVENTS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_EVENTS, label: "Events", variant: "outline", iconName: "Calendar", requiresAuth: true, requiredRole: "admin", requiredPermission: "events.read" },
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_SUPPORT]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_SUPPORT, label: "Support Tickets", variant: "outline", iconName: "LifeBuoy", requiresAuth: true, requiredRole: "admin", requiredPermission: "support.read" },
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_MODERATION]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_MODERATION, label: "Moderation", variant: "outline", iconName: "ShieldAlert", requiresAuth: true, requiredRole: "admin", requiredPermission: "moderation.read" },
-    [DASHBOARD_QUICK_ACTION_ID.ADMIN_INTEGRATION_GUIDES]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_INTEGRATION_GUIDES, label: "Integration Guides", variant: "ghost", iconName: "BookOpen", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin:site:read" },
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_USERS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_USERS, label: "Users", variant: "outline", iconName: "Users", requiresAuth: true, requiredRole: "admin", requiredPermission: "admin.users.read" },
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_CATEGORIES]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_CATEGORIES, label: "Categories", variant: "outline", iconName: "Tag", requiresAuth: true, requiredRole: "admin", requiredPermission: "categories.read" },
     [DASHBOARD_QUICK_ACTION_ID.ADMIN_REVIEWS]: { id: DASHBOARD_QUICK_ACTION_ID.ADMIN_REVIEWS, label: "Reviews", variant: "outline", iconName: "Star", requiresAuth: true, requiredRole: "admin", requiredPermission: "reviews.read" },
@@ -452,7 +450,6 @@ export const DASHBOARD_QUICK_ACTIONS = {
         DASHBOARD_QUICK_ACTION_ID.ADMIN_SECTIONS,
         DASHBOARD_QUICK_ACTION_ID.ADMIN_SUPPORT,
         DASHBOARD_QUICK_ACTION_ID.ADMIN_MODERATION,
-        DASHBOARD_QUICK_ACTION_ID.ADMIN_INTEGRATION_GUIDES,
         DASHBOARD_QUICK_ACTION_ID.ADMIN_SETTINGS,
     ],
     seller: [

package/dist/features/products/schemas/firestore.d.ts

@@ -241,7 +241,7 @@ export interface ProductDocument extends BaseDocument {
     sublistingIcon?: string;
     /**
      * Required since Phase 4 dropped the legacy `isAuction` / `isPreOrder`
-     * booleans. Every product document carries this; queries route through
+     * booleans. Every product document carries this — queries route through
      * `where("listingType", "==", X)` against the `listingType+...` composite
      * indexes in `appkit/firebase/base/firestore.indexes.json`.
      * SB-UNI-F — extended with classified | digital-code | live.
@@ -272,9 +272,10 @@ export interface ProductDocument extends BaseDocument {
     prizeRevealWindowEnd?: Date;
     /**
      * "pending" is legacy-only (no longer written by new listings — reveal is
-     * fully automatic, there's no seller-facing delayed-start concept anymore;
+     * fully automatic, there's no seller-facing delayed-start concept anymore —
      * draft→published is how a seller holds a draw back). New listings go
-     * straight to "open"; "closed" once every eligible order has been revealed.
+     * straight to "open", flipping to "closed" once every eligible order has
+     * been revealed.
      */
     prizeRevealStatus?: "pending" | "open" | "closed";
     /**

package/dist/features/seller/components/SellerSidebar.js

@@ -8,6 +8,7 @@ import { MediaImage } from "../../media/MediaImage";
 import { BottomSheet } from "../../layout/BottomSheet";
 import { SidebarCollapseToggle } from "../../../_internal/client/features/layout/SidebarCollapseToggle";
 import { useSidebarSearch } from "../../../_internal/client/features/layout/useSidebarSearch";
+import { findActiveNavGroup, findActiveNavItem } from "../../../_internal/client/features/layout/navActive";
 const __O = {
     hidden: "overflow-hidden",
     yAuto: "overflow-y-auto",
@@ -18,26 +19,36 @@ const CLS_STORE_NAME = "text-[length:var(--appkit-text-sm)] font-semibold text-[
 const CLS_NAV_ACTIVE = "bg-warning-surface dark:bg-warning-surface text-warning dark:text-warning";
 const CLS_NAV_BADGE = "shrink-0 rounded-full bg-warning-surface px-[var(--appkit-space-1-5)] py-[var(--appkit-space-0-5)] text-[10px] text-white leading-none";
 const CLS_NAV_ICON_ACTIVE = "text-warning dark:text-warning";
-function isNavItemActive(item, activeHref) {
-    return activeHref === item.href;
-}
 function NavLink({ item, isActive, onClick }) {
     return (_jsxs(Link, { href: item.href, onClick: onClick, className: `flex items-center justify-end gap-[var(--appkit-space-2-5)] rounded-lg px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[0.8125rem] font-medium leading-tight transition-colors ${isActive
             ? CLS_NAV_ACTIVE
             : "text-[var(--appkit-color-text-muted)] hover:bg-zinc-50 hover:bg-[var(--appkit-color-surface-elevated)]/60 hover:text-zinc-800 hover:text-[var(--appkit-color-text-muted)]"}`, children: [item.icon && _jsx(Span, { size: "base", className: "shrink-0 opacity-60", children: item.icon }), _jsx(Span, { className: "truncate", children: item.label }), item.badge != null && item.badge > 0 && (_jsx(Span, { weight: "bold", className: CLS_NAV_BADGE, children: item.badge }))] }));
 }
 function FlatContent({ items, activeHref, storeName, storeLogoURL, onItemClick, }) {
+    const activeItem = findActiveNavItem(items, activeHref);
     return (_jsxs(_Fragment, { children: [storeName && (_jsxs(Row, { border: "bottom-subtle", gap: "3", padding: "inline", children: [storeLogoURL ? (_jsx(Div, { className: CLS_STORE_AVATAR, children: _jsx(MediaImage, { src: storeLogoURL, alt: storeName, size: "thumbnail" }) })) : (_jsx(Div, { className: CLS_STORE_FALLBACK, children: storeName[0]?.toUpperCase() })), _jsx(Text, { className: CLS_STORE_NAME, children: storeName })] })), _jsx(Nav, { "aria-label": "Store navigation", padding: "y-sm", children: _jsx(Ul, { paddingX: "x-sm", spacing: "2xs", children: items.map((item) => {
-                        const isActive = activeHref === item.href;
+                        const isActive = activeItem?.href === item.href;
                         return (_jsx(Li, { children: _jsx(NavLink, { item: item, isActive: isActive, onClick: onItemClick }) }, item.href));
                     }) }) })] }));
 }
 function GroupsContent({ groups, activeHref, storeName, storeLogoURL, onItemClick, }) {
-    // Accordion — only one group open at a time.
+    // Accordion — only one group open at a time. Initial pick: the group
+    // containing the active path, else the first group with defaultOpen.
     const [openGroup, setOpenGroup] = useState(() => {
-        const match = groups.find((g) => g.defaultOpen ?? g.items.some((i) => activeHref === i.href));
-        return match?.title ?? null;
+        const active = findActiveNavGroup(groups, activeHref);
+        if (active)
+            return active.title;
+        return groups.find((g) => g.defaultOpen)?.title ?? null;
     });
+    // Re-sync whenever the route changes — the sidebar stays mounted across
+    // client-side navigation, so the lazy initializer above only fires once.
+    useEffect(() => {
+        const active = findActiveNavGroup(groups, activeHref);
+        if (active)
+            setOpenGroup(active.title);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [activeHref]);
+    const activeItem = findActiveNavItem(groups.flatMap((g) => g.items), activeHref);
     const { query, setQuery, isSearching, filteredGroups } = useSidebarSearch(groups);
     const toggle = useCallback((title) => {
         if (isSearching)
@@ -46,10 +57,10 @@ function GroupsContent({ groups, activeHref, storeName, storeLogoURL, onItemClic
     }, [isSearching]);
     return (_jsxs(_Fragment, { children: [storeName && (_jsxs(Row, { border: "bottom-subtle", gap: "3", padding: "inline", children: [storeLogoURL ? (_jsx(Div, { className: CLS_STORE_AVATAR, children: _jsx(MediaImage, { src: storeLogoURL, alt: storeName, size: "thumbnail" }) })) : (_jsx(Div, { className: CLS_STORE_FALLBACK, children: storeName[0]?.toUpperCase() })), _jsx(Text, { className: CLS_STORE_NAME, children: storeName })] })), _jsxs(Nav, { "aria-label": "Store navigation", padding: "y-xs", children: [_jsx(Div, { padding: "x-md", paddingY: "y-sm", children: _jsx(Input, { value: query, onChange: (e) => setQuery(e.target.value), placeholder: "Search navigation\u2026", "aria-label": "Search navigation" }) }), isSearching && filteredGroups.length === 0 && (_jsx(Div, { padding: "x-md", paddingY: "y-sm", children: _jsxs(Span, { size: "xs", color: "muted", children: ["No matches for \u201C", query, "\u201D."] }) })), filteredGroups.map((group) => {
                         const isOpen = isSearching || openGroup === group.title;
-                        const hasActive = group.items.some((i) => activeHref === i.href);
+                        const hasActive = !!findActiveNavItem(group.items, activeHref);
                         return (_jsxs(Div, { className: "mb-0.5", children: [_jsx(Button, { type: "button", variant: "ghost", onClick: () => toggle(group.title), paddingX: "md", paddingY: "sm", weight: "semibold", rounded: "none", className: `w-full text-[0.6875rem] uppercase tracking-widest transition-colors ${hasActive && !isOpen
                                         ? CLS_NAV_ICON_ACTIVE
-                                        : "text-[var(--appkit-color-text-faint)] hover:text-[var(--appkit-color-text-muted)]"}`, children: _jsxs(Row, { align: "center", justify: "between", className: "w-full", children: [_jsx(Span, { children: group.title }), _jsx("svg", { className: `w-3 h-3 transition-transform duration-150 ${isOpen ? "rotate-180" : ""}`, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2.5, d: "M19 9l-7 7-7-7" }) })] }) }), isOpen && (_jsx(Ul, { paddingX: "x-sm", paddingY: "y-bottom-xs", spacing: "2xs", children: group.items.map((item) => (_jsx(Li, { children: _jsx(NavLink, { item: item, isActive: isNavItemActive(item, activeHref), onClick: onItemClick }) }, item.href))) }))] }, group.title));
+                                        : "text-[var(--appkit-color-text-faint)] hover:text-[var(--appkit-color-text-muted)]"}`, children: _jsxs(Row, { align: "center", justify: "between", className: "w-full", children: [_jsx(Span, { children: group.title }), _jsx("svg", { className: `w-3 h-3 transition-transform duration-150 ${isOpen ? "rotate-180" : ""}`, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2.5, d: "M19 9l-7 7-7-7" }) })] }) }), isOpen && (_jsx(Ul, { paddingX: "x-sm", paddingY: "y-bottom-xs", spacing: "2xs", children: group.items.map((item) => (_jsx(Li, { children: _jsx(NavLink, { item: item, isActive: activeItem?.href === item.href, onClick: onItemClick }) }, item.href))) }))] }, group.title));
                     })] })] }));
 }
 function DrawerPanel({ title, onClose, children }) {

package/dist/features/stores/components/StoreGuideHubView.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Package, ShoppingBag, Wallet, Settings, Shield, Headphones, CheckCircle2, Circle, BookOpen, } from "lucide-react";
+import { Package, ShoppingBag, Wallet, Settings, Shield, Headphones, CheckCircle2, Circle, BookOpen, MessageSquare, } from "lucide-react";
 import { Div, Heading, Progress, Row, Section, Stack, Text, TextLink } from "../../../ui";
 import { ROUTES } from "../../../next/routing/route-map";
 const CLS_CHECK_ICON = "w-5 h-5 flex-shrink-0 text-emerald-500";
@@ -36,6 +36,12 @@ const GUIDE_CARDS = [
         description: "Admin-granted feature flags — auctions, pre-orders, lower commissions, and more.",
         href: String(ROUTES.STORE.GUIDE_CAPABILITIES),
     },
+    {
+        Icon: MessageSquare,
+        title: "WhatsApp Catalog Sync",
+        description: "Push your product catalog to Meta Commerce Manager for WhatsApp, Facebook, and Instagram Shops.",
+        href: String(ROUTES.STORE.GUIDE_WHATSAPP),
+    },
     {
         Icon: Headphones,
         title: "Support",

package/dist/features/stores/components/StoreNavTabs.js

@@ -2,6 +2,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useRouter } from "next/navigation";
 import { Button, Div, Select, TextLink } from "../../../ui";
+const CLS_ACTIVE_TAB = "border-primary text-primary";
 export function StoreNavTabs({ tabs, dropdownTabs = [], dropdownPlaceholder = "Browse listings", activeValue, onTabChange, renderTabBar, className = "", }) {
     const router = useRouter();
     const handleChange = (v) => onTabChange?.(v);
@@ -17,9 +18,9 @@ export function StoreNavTabs({ tabs, dropdownTabs = [], dropdownPlaceholder = "B
             router.push(tab.href);
         handleChange(tab.value);
     };
-    return (_jsxs(Div, { layout: "flex", gap: "2", role: "tablist", border: "bottom", className: `items-center overflow-x-auto ${className}`, children: [dropdownTabs.length > 0 && (_jsx(Select, { bare: true, "aria-label": dropdownPlaceholder, options: dropdownTabs.map((tab) => ({ value: tab.value, label: tab.label })), value: activeDropdownTab?.value ?? "", placeholder: activeDropdownTab ? undefined : dropdownPlaceholder, onValueChange: handleDropdownChange, className: `max-w-[12rem] flex-shrink-0 whitespace-nowrap ${activeDropdownTab ? "border-primary text-primary" : ""}` })), tabs.map((tab) => tab.href ? (_jsx(TextLink, { variant: "bare", href: tab.href, role: "tab", "aria-selected": activeValue === tab.value, paddingX: "md", paddingY: "xs", size: "sm", weight: "medium", className: `whitespace-nowrap border-b-2 -mb-px transition-colors ${activeValue === tab.value
-                    ? "border-primary text-primary"
+    return (_jsxs(Div, { layout: "flex", gap: "2", align: "center", role: "tablist", border: "bottom", className: `overflow-x-auto ${className}`, children: [dropdownTabs.length > 0 && (_jsx(Select, { bare: true, "aria-label": dropdownPlaceholder, options: dropdownTabs.map((tab) => ({ value: tab.value, label: tab.label })), value: activeDropdownTab?.value ?? "", placeholder: activeDropdownTab ? undefined : dropdownPlaceholder, onValueChange: handleDropdownChange, className: `max-w-[12rem] flex-shrink-0 whitespace-nowrap ${activeDropdownTab ? CLS_ACTIVE_TAB : ""}` })), tabs.map((tab) => tab.href ? (_jsx(TextLink, { variant: "bare", href: tab.href, role: "tab", "aria-selected": activeValue === tab.value, paddingX: "md", paddingY: "xs", size: "sm", weight: "medium", className: `whitespace-nowrap border-b-2 -mb-px transition-colors ${activeValue === tab.value
+                    ? CLS_ACTIVE_TAB
                     : "border-transparent text-[var(--appkit-color-text-muted)] text-[var(--appkit-color-text-muted)] hover:text-neutral-800 hover:text-[var(--appkit-color-text-muted)]"}`, children: tab.label }, tab.value)) : (_jsx(Button, { variant: "ghost", type: "button", role: "tab", "aria-selected": activeValue === tab.value, onClick: () => handleChange(tab.value), paddingX: "md", paddingY: "sm", textSize: "sm", weight: "medium", rounded: "none", className: `whitespace-nowrap border-b-2 -mb-px transition-colors ${activeValue === tab.value
-                    ? "border-primary text-primary"
+                    ? CLS_ACTIVE_TAB
                     : "border-transparent text-[var(--appkit-color-text-muted)] text-[var(--appkit-color-text-muted)] hover:text-neutral-800 hover:text-[var(--appkit-color-text-muted)]"}`, children: tab.label }, tab.value)))] }));
 }

package/dist/features/stores/components/StoreWhatsAppGuideView.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+export type StoreWhatsAppGuideViewProps = Record<string, never>;
+export declare function StoreWhatsAppGuideView(_props: StoreWhatsAppGuideViewProps): React.JSX.Element;

package/dist/features/stores/components/StoreWhatsAppGuideView.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ArrowLeft } from "lucide-react";
+import { Alert, Code, Div, Heading, Li, Section, Span, Stack, Text, TextLink, Ul } from "../../../ui";
+import { ROUTES } from "../../../next/routing/route-map";
+function GuideSection({ title, children, }) {
+    return (_jsxs(Section, { className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "xl", shadow: "sm", padding: "lg", children: [_jsx(Heading, { level: 2, className: "mb-4 text-[var(--appkit-color-text)]", size: "lg", weight: "semibold", children: title }), children] }));
+}
+const LIST_DISC = "list-disc leading-relaxed";
+const TEXT_MUTED = "leading-relaxed text-[var(--appkit-color-text-muted)]";
+export function StoreWhatsAppGuideView(_props) {
+    return (_jsxs(Stack, { gap: "lg", padding: "b-2xl", children: [_jsxs(TextLink, { variant: "bare", href: String(ROUTES.STORE.GUIDE), size: "sm", layout: "inline-flex", align: "center", gap: "sm", className: "text-[var(--appkit-color-text-muted)] hover:text-[var(--appkit-color-text)] transition-colors", children: [_jsx(ArrowLeft, { className: "h-4 w-4" }), "Back to Seller Guide"] }), _jsxs(Div, { children: [_jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)]", size: "2xl", weight: "bold", children: "WhatsApp Catalog Sync" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-muted)]", size: "sm", children: "Push your product catalog to Meta's Commerce Manager for WhatsApp catalog messages and Facebook/Instagram Shops \u2014 and import products back the other way." })] }), _jsx(GuideSection, { title: "1. Create a Commerce Manager catalog", children: _jsxs(Ul, { spacing: "tight", indent: "lg", children: [_jsxs(Li, { className: LIST_DISC, textSize: "sm", color: "muted", children: ["At ", _jsx(Span, { weight: "bold", children: "business.facebook.com/commerce" }), ", create a new catalog for the store (or use an existing one)."] }), _jsxs(Li, { className: LIST_DISC, textSize: "sm", color: "muted", children: ["Note the ", _jsx(Span, { weight: "bold", children: "Catalog ID" }), " shown in the catalog's settings."] })] }) }), _jsx(GuideSection, { title: "2. Generate a catalog-scoped access token", children: _jsxs(Text, { className: TEXT_MUTED, size: "sm", children: ["You need a Meta access token with ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "catalog_management" }), " permission, scoped to that catalog. This is generated the same way as the platform-level WhatsApp System User token (ask your admin \u2014 Admin Guide \u2192 WhatsApp Integration, step 3) but assigned to the ", _jsx(Span, { weight: "bold", children: "catalog" }), " asset instead of the WhatsApp Business Account asset."] }) }), _jsxs(GuideSection, { title: "3. Enter credentials in the seller dashboard", children: [_jsxs(Text, { className: "mb-2 leading-relaxed text-[var(--appkit-color-text-muted)]", size: "sm", children: [_jsx(Span, { weight: "bold", children: "Store \u2192 WhatsApp" }), " settings page:"] }), _jsxs(Ul, { spacing: "tight", indent: "lg", children: [_jsx(Li, { className: LIST_DISC, textSize: "sm", color: "muted", children: "Catalog ID" }), _jsx(Li, { className: LIST_DISC, textSize: "sm", color: "muted", children: "Access Token" })] }), _jsxs(Text, { className: "mt-3 leading-relaxed text-[var(--appkit-color-text-muted)]", size: "sm", children: ["This is a store capability \u2014 it must be enabled for the store (", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "whatsapp_catalog_sync" }), " capability) before the settings page and sync actions are available."] })] }), _jsx(GuideSection, { title: "4. Push products to the catalog", children: _jsxs(Text, { className: TEXT_MUTED, size: "sm", children: ["Once connected, trigger a sync that batches published ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "standard" }), "-listing products (up to 50 per API call) to the Meta catalog via the Commerce API ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "items_batch" }), " endpoint \u2014 title, description, price, image, availability, and condition."] }) }), _jsx(GuideSection, { title: "5. Import products from the catalog", children: _jsxs(Text, { className: TEXT_MUTED, size: "sm", children: ["The reverse flow fetches products already in the Meta catalog and creates them as local ", _jsx(Span, { weight: "bold", children: "draft" }), " listings, deduplicating against existing products by slug/retailer-id matching."] }) }), _jsxs(Alert, { variant: "info", children: ["This is unrelated to the platform-level WhatsApp order-notification credentials \u2014 those are for sending order-status messages to buyers, not catalog sync. Only published ", _jsx(Span, { weight: "bold", children: "standard" }), " listings sync \u2014 auctions, pre-orders, and other listing types are not included."] })] }));
+}

package/dist/features/stores/components/index.d.ts

@@ -47,3 +47,5 @@ export { StoreCapabilitiesGuideView } from "./StoreCapabilitiesGuideView";
 export type { StoreCapabilitiesGuideViewProps } from "./StoreCapabilitiesGuideView";
 export { StoreSettingsGuideView } from "./StoreSettingsGuideView";
 export type { StoreSettingsGuideViewProps } from "./StoreSettingsGuideView";
+export { StoreWhatsAppGuideView } from "./StoreWhatsAppGuideView";
+export type { StoreWhatsAppGuideViewProps } from "./StoreWhatsAppGuideView";

package/dist/features/stores/components/index.js

@@ -20,3 +20,4 @@ export { StoreOrdersGuideView } from "./StoreOrdersGuideView";
 export { StoreFinanceGuideView } from "./StoreFinanceGuideView";
 export { StoreCapabilitiesGuideView } from "./StoreCapabilitiesGuideView";
 export { StoreSettingsGuideView } from "./StoreSettingsGuideView";
+export { StoreWhatsAppGuideView } from "./StoreWhatsAppGuideView";

package/dist/features/tester/seed-data/products-tester-seed-data.js

@@ -25,6 +25,7 @@ import { seedExtMedia } from "../../../seed/_helpers/media";
 import { testDataExpiresAt } from "./tester-ttl";
 const TESTER_STORE_ID = "store-tester-sandbox";
 const TESTER_STORE_NAME = "Tester Sandbox Store";
+const TESTER_GROUP_TITLE = "Tester Sandbox Bundle";
 const GADGETS_CATEGORY_SLUGS = ["category-tester-gadgets", "category-tester-sandbox"];
 const GADGETS_CATEGORY_NAMES = ["Test Gadgets", "Tester Sandbox"];
 const COLLECTIBLES_CATEGORY_SLUGS = ["category-tester-collectibles", "category-tester-sandbox"];
@@ -71,7 +72,7 @@ export const productsTesterSeedData = [
         // resolvable and ShowGroupSection renders nothing (members.length <= 1).
         groupId: "group-tester-sandbox-bundle",
         groupParentSlug: "group-tester-sandbox-bundle",
-        groupTitle: "Tester Sandbox Bundle",
+        groupTitle: TESTER_GROUP_TITLE,
         createdAt: new Date(),
         updatedAt: new Date(),
     }),
@@ -100,7 +101,7 @@ export const productsTesterSeedData = [
         isOnSale: false,
         groupId: "group-tester-sandbox-bundle",
         groupParentSlug: "group-tester-sandbox-bundle",
-        groupTitle: "Tester Sandbox Bundle",
+        groupTitle: TESTER_GROUP_TITLE,
         createdAt: new Date(),
         updatedAt: new Date(),
     }),
@@ -492,7 +493,7 @@ export const productsTesterSeedData = [
         isOnSale: false,
         isGroupParent: true,
         groupId: "group-tester-sandbox-bundle",
-        groupTitle: "Tester Sandbox Bundle",
+        groupTitle: TESTER_GROUP_TITLE,
         groupChildSlugs: ["product-tester-standard-1", "product-tester-standard-2"],
         createdAt: new Date(),
         updatedAt: new Date(),

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -18,6 +18,8 @@
  * @tag sideEffects:none
  */
 import { assignDefaultPhases } from "../utils/phases";
+const ADMIN_TESTING_GROUP_LABEL = "Admin (Testing)";
+const BUG_HUNTER_REWARDS_PAGE_LABEL = "Bug Hunter Rewards";
 function group(groupKey, groupLabel, pages, opts) {
     const items = [];
     pages.forEach((page, pageIdx) => {
@@ -676,7 +678,7 @@ const rawTesterChecklistItems = [
             ],
         },
     ]),
-    ...group("admin", "Admin (Testing)", [
+    ...group("admin", ADMIN_TESTING_GROUP_LABEL, [
         {
             pageKey: "catalog-listings",
             pageLabel: "Catalog & Listings",
@@ -853,7 +855,7 @@ const rawTesterChecklistItems = [
         },
         {
             pageKey: "bug-hunter-rewards",
-            pageLabel: "Bug Hunter Rewards",
+            pageLabel: BUG_HUNTER_REWARDS_PAGE_LABEL,
             cases: [
                 {
                     key: "confirm-bug",
@@ -888,9 +890,9 @@ const rawTesterChecklistItems = [
     {
         id: "checklist-admin-bug-hunter-rewards-demo-fixture",
         groupKey: "admin",
-        groupLabel: "Admin (Testing)",
+        groupLabel: ADMIN_TESTING_GROUP_LABEL,
         pageKey: "bug-hunter-rewards",
-        pageLabel: "Bug Hunter Rewards",
+        pageLabel: BUG_HUNTER_REWARDS_PAGE_LABEL,
         label: "Demo fixture — reported bug, already confirmed and reopened (v1, disabled)",
         description: "Seed-only fixture demonstrating a confirmed bug: this v1 case is disabled (isActive:false) and credited to \"Mock User 18\". Its retest is \"Demo fixture — reported bug, already confirmed and reopened (v2, active)\" in this same page.",
         order: 100,
@@ -906,9 +908,9 @@ const rawTesterChecklistItems = [
     {
         id: "checklist-admin-bug-hunter-rewards-demo-fixture-v2",
         groupKey: "admin",
-        groupLabel: "Admin (Testing)",
+        groupLabel: ADMIN_TESTING_GROUP_LABEL,
         pageKey: "bug-hunter-rewards",
-        pageLabel: "Bug Hunter Rewards",
+        pageLabel: BUG_HUNTER_REWARDS_PAGE_LABEL,
         label: "Demo fixture — reported bug, already confirmed and reopened (v2, active)",
         description: "Seed-only fixture — the retest version reopened from the disabled v1 case in this same page. Active and answerable again; a fresh \"No\" answer here can be used to try Mark as Bug end-to-end.",
         order: 101,

package/dist/index.d.ts

@@ -2900,6 +2900,8 @@ export { AdminSiteConfigGuideView } from "./features/admin/components/AdminSiteC
 export { AdminTeamGuideView } from "./features/admin/components/AdminTeamGuideView";
 export { AdminAnalyticsGuideView } from "./features/admin/components/AdminAnalyticsGuideView";
 export { AdminTrustGuideView } from "./features/admin/components/AdminTrustGuideView";
+export { AdminWhatsAppGuideView } from "./features/admin/components/AdminWhatsAppGuideView";
+export { AdminPaymentsGuideView } from "./features/admin/components/AdminPaymentsGuideView";
 export { BuyerShoppingGuideView } from "./features/account/components/BuyerShoppingGuideView";
 export { BuyerAuctionsGuideView } from "./features/account/components/BuyerAuctionsGuideView";
 export { BuyerOrdersGuideView } from "./features/account/components/BuyerOrdersGuideView";
@@ -2916,6 +2918,8 @@ export { StoreCapabilitiesGuideView } from "./features/stores/components/StoreCa
 export type { StoreCapabilitiesGuideViewProps } from "./features/stores/components/StoreCapabilitiesGuideView";
 export { StoreSettingsGuideView } from "./features/stores/components/StoreSettingsGuideView";
 export type { StoreSettingsGuideViewProps } from "./features/stores/components/StoreSettingsGuideView";
+export { StoreWhatsAppGuideView } from "./features/stores/components/StoreWhatsAppGuideView";
+export type { StoreWhatsAppGuideViewProps } from "./features/stores/components/StoreWhatsAppGuideView";
 export { StorePreOrdersListing } from "./features/stores/components/StorePreOrdersListing";
 export type { StorePreOrdersListingProps } from "./features/stores/components/StorePreOrdersListing";
 export { buildStoreColumns } from "./features/stores/index";

package/dist/index.js

@@ -5218,6 +5218,10 @@ export { AdminTeamGuideView } from "./features/admin/components/AdminTeamGuideVi
 export { AdminAnalyticsGuideView } from "./features/admin/components/AdminAnalyticsGuideView";
 // [CLIENT-SSR]-Admin trust & safety guide — static view, no firebase-admin.
 export { AdminTrustGuideView } from "./features/admin/components/AdminTrustGuideView";
+// [CLIENT-SSR]-Admin WhatsApp integration guide — static view, no firebase-admin.
+export { AdminWhatsAppGuideView } from "./features/admin/components/AdminWhatsAppGuideView";
+// [CLIENT-SSR]-Admin payments (Razorpay) guide — static view, no firebase-admin.
+export { AdminPaymentsGuideView } from "./features/admin/components/AdminPaymentsGuideView";
 // [CLIENT-SSR]-Buyer shopping guide — static view, no firebase-admin.
 export { BuyerShoppingGuideView } from "./features/account/components/BuyerShoppingGuideView";
 // [CLIENT-SSR]-Buyer auctions & pre-orders guide — static view, no firebase-admin.
@@ -5238,6 +5242,8 @@ export { StoreFinanceGuideView } from "./features/stores/components/StoreFinance
 export { StoreCapabilitiesGuideView } from "./features/stores/components/StoreCapabilitiesGuideView";
 // [CLIENT-SSR]-Store settings guide — static view, no firebase-admin.
 export { StoreSettingsGuideView } from "./features/stores/components/StoreSettingsGuideView";
+// [CLIENT-SSR]-Store WhatsApp catalog sync guide — static view, no firebase-admin.
+export { StoreWhatsAppGuideView } from "./features/stores/components/StoreWhatsAppGuideView";
 export { StorePreOrdersListing } from "./features/stores/components/StorePreOrdersListing";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // buildStoreColumns - Helper for build store columns.

package/dist/next/routing/route-map.d.ts

@@ -238,6 +238,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly GUIDE_FINANCE: "/store/guide/finance";
         readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
         readonly GUIDE_SETTINGS: "/store/guide/settings";
+        readonly GUIDE_WHATSAPP: "/store/guide/whatsapp";
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
@@ -249,7 +250,6 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CATALOGUE_APPROVALS: "/admin/catalogue-approvals";
         readonly USERS: "/admin/users";
         readonly SITE: "/admin/site";
-        readonly INTEGRATION_GUIDES: "/admin/integration-guides";
         readonly CAROUSEL: "/admin/carousel";
         readonly CAROUSEL_NEW: "/admin/carousel/new";
         readonly CAROUSEL_EDIT: (id: string) => string;
@@ -360,6 +360,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly GUIDE_TEAM: "/admin/guide/team";
         readonly GUIDE_ANALYTICS: "/admin/guide/analytics";
         readonly GUIDE_TRUST: "/admin/guide/trust";
+        readonly GUIDE_WHATSAPP: "/admin/guide/whatsapp";
+        readonly GUIDE_PAYMENTS: "/admin/guide/payments";
         readonly BANNED_ADDRESSES: "/admin/banned-addresses";
         readonly ADDRESS_CLUSTERS: "/admin/address-clusters";
         readonly PAYMENT_METHODS: "/admin/payment-methods";
@@ -599,6 +601,7 @@ export declare const ROUTES: {
         readonly GUIDE_FINANCE: "/store/guide/finance";
         readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
         readonly GUIDE_SETTINGS: "/store/guide/settings";
+        readonly GUIDE_WHATSAPP: "/store/guide/whatsapp";
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
@@ -610,7 +613,6 @@ export declare const ROUTES: {
         readonly CATALOGUE_APPROVALS: "/admin/catalogue-approvals";
         readonly USERS: "/admin/users";
         readonly SITE: "/admin/site";
-        readonly INTEGRATION_GUIDES: "/admin/integration-guides";
         readonly CAROUSEL: "/admin/carousel";
         readonly CAROUSEL_NEW: "/admin/carousel/new";
         readonly CAROUSEL_EDIT: (id: string) => string;
@@ -721,6 +723,8 @@ export declare const ROUTES: {
         readonly GUIDE_TEAM: "/admin/guide/team";
         readonly GUIDE_ANALYTICS: "/admin/guide/analytics";
         readonly GUIDE_TRUST: "/admin/guide/trust";
+        readonly GUIDE_WHATSAPP: "/admin/guide/whatsapp";
+        readonly GUIDE_PAYMENTS: "/admin/guide/payments";
         readonly BANNED_ADDRESSES: "/admin/banned-addresses";
         readonly ADDRESS_CLUSTERS: "/admin/address-clusters";
         readonly PAYMENT_METHODS: "/admin/payment-methods";
@@ -815,6 +819,7 @@ export declare const SELLER_ROUTES: {
     readonly GUIDE_FINANCE: "/store/guide/finance";
     readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
     readonly GUIDE_SETTINGS: "/store/guide/settings";
+    readonly GUIDE_WHATSAPP: "/store/guide/whatsapp";
 };
 export declare const PUBLIC_ROUTES: readonly ["/", string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, "/unauthorized", "/auth/login", "/auth/register", "/auth/forgot-password", "/auth/reset-password", "/auth/verify-email"];
 export declare const PROTECTED_ROUTES: readonly [string, string, string, string, string, string, string];

package/dist/next/routing/route-map.js

@@ -237,6 +237,7 @@ export const DEFAULT_ROUTE_MAP = {
         GUIDE_FINANCE: "/store/guide/finance",
         GUIDE_CAPABILITIES: "/store/guide/capabilities",
         GUIDE_SETTINGS: "/store/guide/settings",
+        GUIDE_WHATSAPP: "/store/guide/whatsapp",
     },
     ADMIN: {
         DASHBOARD: "/admin/dashboard",
@@ -248,7 +249,6 @@ export const DEFAULT_ROUTE_MAP = {
         CATALOGUE_APPROVALS: "/admin/catalogue-approvals",
         USERS: "/admin/users",
         SITE: "/admin/site",
-        INTEGRATION_GUIDES: "/admin/integration-guides",
         CAROUSEL: "/admin/carousel",
         CAROUSEL_NEW: "/admin/carousel/new",
         CAROUSEL_EDIT: (id) => `/admin/carousel/${id}/edit`,
@@ -364,6 +364,8 @@ export const DEFAULT_ROUTE_MAP = {
         GUIDE_TEAM: "/admin/guide/team",
         GUIDE_ANALYTICS: "/admin/guide/analytics",
         GUIDE_TRUST: "/admin/guide/trust",
+        GUIDE_WHATSAPP: "/admin/guide/whatsapp",
+        GUIDE_PAYMENTS: "/admin/guide/payments",
         BANNED_ADDRESSES: "/admin/banned-addresses",
         ADDRESS_CLUSTERS: "/admin/address-clusters",
         PAYMENT_METHODS: "/admin/payment-methods",

package/dist/seed/products-standard-seed-data.js

@@ -290,8 +290,7 @@ const _rawProductsStandardSeedData = [
             seedExtMedia("https://picsum.photos/seed/product-image-beyblade-original-dragoon-f-video-demo-2-20260819/900/900"),
         ],
         video: {
-            // audit-seed-external-url-ok: raw <video> src, /api/media/ext is image-only (Root Cause #27)
-            url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4",
+            url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4", // audit-seed-external-url-ok: raw <video> src, /api/media/ext is image-only (Root Cause #27)
             thumbnailUrl: seedExtMedia("https://picsum.photos/seed/product-video-thumb-beyblade-original-dragoon-f-video-demo-20260819/800/450"),
             duration: 15,
         },
@@ -324,8 +323,7 @@ const _rawProductsStandardSeedData = [
             seedExtMedia("https://picsum.photos/seed/product-image-beyblade-x-dran-sword-video-demo-2-20260819/900/900"),
         ],
         video: {
-            // audit-seed-external-url-ok: raw <video> src, /api/media/ext is image-only (Root Cause #27)
-            url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ElephantsDream.mp4",
+            url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ElephantsDream.mp4", // audit-seed-external-url-ok: raw <video> src, /api/media/ext is image-only (Root Cause #27)
             thumbnailUrl: seedExtMedia("https://picsum.photos/seed/product-video-thumb-beyblade-x-dran-sword-video-demo-20260819/800/450"),
             duration: 20,
         },