@mohasinac/appkit 4.70.0 → 4.71.2

package/dist/features/categories/components/CategoryDetailTabs.js

@@ -5,12 +5,12 @@ import { EmptyState } from "../../../ui/components/EmptyState.js";
 import { Tabs, TabsList, TabsTrigger } from "../../../ui/components/Tabs.js";
 import { AvailabilityScopeHint } from "../../products/components/AvailabilityScopeHint.js";
 import { CategoryProductsListing } from "./CategoryProductsListing.js";
-import { AuctionsIndexListing } from "../../products/components/AuctionsIndexListing.js";
+import { CollectorDropsIndexListing } from "../../products/components/CollectorDropsIndexListing.js";
 import { PreOrdersIndexListing } from "../../pre-orders/components/PreOrdersIndexListing.js";
-import { PrizeDrawsIndexListing } from "../../products/components/PrizeDrawsIndexListing.js";
+import { ClearanceIndexListing } from "../../products/components/ClearanceIndexListing.js";
 import { CategoryBundlesListing } from "./CategoryBundlesListing.js";
 import { CategoryStoresListing } from "./CategoryStoresListing.js";
-import { CATEGORY_PAGE_TABS, ART_STICKERS_LISTING_TYPES, } from "../../products/constants/listing-tabs.js";
+import { CATEGORY_PAGE_TABS, ART_AND_STICKERS_LISTING_TYPES, } from "../../products/constants/listing-tabs.js";
 import { ALL_LISTING_TYPES } from "../../../_internal/shared/listing-types/feature-flags.js";
 import { pluginFor } from "../../../_internal/shared/listing-types/_registry.js";
 /**
@@ -52,11 +52,11 @@ const GENERIC_TAB_LISTING_TYPES = {
     [pluginFor("classified").tabSlug]: ["classified"],
     [pluginFor("digital-code").tabSlug]: ["digital-code"],
     [pluginFor("live").tabSlug]: ["live"],
-    // The combined Art & Stickers tab spans both types under the `art` slug.
-    [pluginFor("art").tabSlug]: ART_STICKERS_LISTING_TYPES,
+    // The Art & Stickers tab, under the unchanged `art` slug (1.34).
+    [pluginFor("art-and-stickers").tabSlug]: ART_AND_STICKERS_LISTING_TYPES,
     /*
      * Spares render generically — there is nothing type-specific to show beyond
-     * a product grid, unlike an auction (countdown, bid history) or a prize draw
+     * a product grid, unlike a collector drop (countdown, bid history) or a prize draw
      * (entries remaining).
      *
      * 🛑 This map is hand-written and a missing entry is a tab you can CLICK that
@@ -67,7 +67,7 @@ const GENERIC_TAB_LISTING_TYPES = {
      */
     [pluginFor("spares").tabSlug]: ["spares"],
 };
-export function CategoryDetailTabs({ categorySlug, categoryId, initialProductsData, initialBundles = [], initialStores = [], counts, totals, enabledListingTypes, enabledCategoryTypes, }) {
+export function CategoryDetailTabs({ categorySlug, categoryId, initialProductsData, initialBundles = [], initialStores = [], counts, totals, listedListingTypes, enabledCategoryTypes, }) {
     const countFor = (id) => counts?.[id];
     // Falls back to the badge when no totals map is supplied, so a caller that
     // has not been migrated keeps today's hide behaviour rather than hiding
@@ -76,8 +76,8 @@ export function CategoryDetailTabs({ categorySlug, categoryId, initialProductsDa
     const visibleTabs = CATEGORY_PAGE_TABS.filter((t) => {
         const mapping = TAB_TYPE_MAP[t.id];
         if (mapping) {
-            if (mapping.kind === "listing" && enabledListingTypes) {
-                if (!enabledListingTypes.includes(mapping.type))
+            if (mapping.kind === "listing" && listedListingTypes) {
+                if (!listedListingTypes.includes(mapping.type))
                     return false;
             }
             if (mapping.kind === "category" && enabledCategoryTypes) {
@@ -101,5 +101,5 @@ export function CategoryDetailTabs({ categorySlug, categoryId, initialProductsDa
     if (visibleTabs.length === 0) {
         return (_jsx(EmptyState, { title: "Nothing listed here yet", description: "This category has no active listings right now. Check back soon." }));
     }
-    return (_jsxs(_Fragment, { children: [_jsx(Tabs, { value: activeTab, onChange: (v) => setActiveTab(v), className: "mb-6", children: _jsx(TabsList, { children: visibleTabs.map((t) => (_jsx(TabsTrigger, { value: t.id, badge: countFor(t.id), children: t.label }, t.id))) }) }), _jsx(AvailabilityScopeHint, { total: totalFor(activeTab), available: countFor(activeTab), types: typesForTab(activeTab) }), GENERIC_TAB_LISTING_TYPES[activeTab] && (_jsx(CategoryProductsListing, { categorySlug: categorySlug, categoryId: categoryId, listingTypes: GENERIC_TAB_LISTING_TYPES[activeTab], initialData: activeTab === pluginFor("standard").tabSlug ? initialProductsData : undefined })), activeTab === pluginFor("auction").tabSlug && (_jsx(AuctionsIndexListing, { categorySlug: categorySlug })), activeTab === pluginFor("pre-order").tabSlug && (_jsx(PreOrdersIndexListing, { categorySlug: categorySlug })), activeTab === pluginFor("prize-draw").tabSlug && (_jsx(PrizeDrawsIndexListing, { categorySlug: categorySlug })), activeTab === "bundles" && (_jsx(CategoryBundlesListing, { initialBundles: initialBundles })), activeTab === "stores" && (_jsx(CategoryStoresListing, { stores: initialStores }))] }));
+    return (_jsxs(_Fragment, { children: [_jsx(Tabs, { value: activeTab, onChange: (v) => setActiveTab(v), className: "mb-6", children: _jsx(TabsList, { children: visibleTabs.map((t) => (_jsx(TabsTrigger, { value: t.id, badge: countFor(t.id), children: t.label }, t.id))) }) }), _jsx(AvailabilityScopeHint, { total: totalFor(activeTab), available: countFor(activeTab), types: typesForTab(activeTab) }), GENERIC_TAB_LISTING_TYPES[activeTab] && (_jsx(CategoryProductsListing, { categorySlug: categorySlug, categoryId: categoryId, listingTypes: GENERIC_TAB_LISTING_TYPES[activeTab], initialData: activeTab === pluginFor("standard").tabSlug ? initialProductsData : undefined })), activeTab === pluginFor("collector-drop").tabSlug && (_jsx(CollectorDropsIndexListing, { categorySlug: categorySlug })), activeTab === pluginFor("pre-order").tabSlug && (_jsx(PreOrdersIndexListing, { categorySlug: categorySlug })), activeTab === pluginFor("clearance").tabSlug && (_jsx(ClearanceIndexListing, { categorySlug: categorySlug })), activeTab === "bundles" && (_jsx(CategoryBundlesListing, { initialBundles: initialBundles })), activeTab === "stores" && (_jsx(CategoryStoresListing, { stores: initialStores }))] }));
 }

package/dist/features/categories/components/CategoryForm.js

@@ -6,7 +6,8 @@ import { Label, Text } from "../../../ui/components/Typography.js";
 import { Checkbox } from "../../../ui/components/Checkbox.js";
 import { RichTextEditor } from "../../../ui/components/RichTextEditor.js";
 import { FieldLabel } from "../../../ui/forms/index.js";
-import { ImageUpload, MediaImage, useMediaUpload } from "../../media/index.js";
+import { ImageUpload, useMediaUpload } from "../../media/index.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { FormField } from "../../../ui/index.js";
 import { flattenCategories } from "../types/index.js";
 import { normalizeRichTextHtml, slugify } from "../../../utils/string.formatter.js";

package/dist/features/categories/components/CategoryGrid.js

@@ -5,7 +5,7 @@ import { Div } from "../../../ui/components/Div.js";
 import { Grid, Row, Stack } from "../../../ui/components/Layout.js";
 import { Span, Text } from "../../../ui/components/Typography.js";
 import { DynamicBgDiv } from "../../../ui/components/DynamicBgDiv.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { ImageMosaic, MOSAIC_MIN } from "../../../ui/components/ImageMosaic.js";
 import { RecordOwnerQuickActions } from "../../admin/components/RecordOwnerQuickActions.js";
 const __P = {

package/dist/features/categories/components/CategoryProductsListing.d.ts

@@ -7,7 +7,7 @@ export interface CategoryProductsListingProps {
     /**
      * Listing types this tab spans. Defaults to `["standard"]` — the original,
      * only behaviour. Category/brand pages pass a single non-standard type (or
-     * the `["art","stickers"]` pair) so the classifieds / digital-codes / live /
+     * the `["art-and-stickers"]` set) so the classifieds / digital-codes / live /
      * art tabs render real content instead of a blank panel: those four tabs
      * existed in CATEGORY_PAGE_TABS but had no render branch at all.
      */

package/dist/features/categories/components/CategoryProductsListing.js

@@ -6,6 +6,7 @@ import { useState, useCallback } from "react";
 import { useUrlTable } from "../../../react/hooks/useUrlTable.js";
 import { usePendingTable } from "../../../react/hooks/usePendingTable.js";
 import { useProducts } from "../../products/hooks/useProducts.js";
+import { Button } from "../../../ui/components/Button.js";
 import { Div } from "../../../ui/components/Div.js";
 import { Grid, Row, Stack } from "../../../ui/components/Layout.js";
 import { FilterDrawer } from "../../../ui/components/FilterDrawer.js";
@@ -126,9 +127,9 @@ export function CategoryProductsListing({ categorySlug, categoryId, brandName, l
     }, [localCart, showToast]);
     return (_jsxs(Div, { className: "min-h-[200px]", children: [_jsx(ListingToolbar, { filterCount: filterActiveCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: `Search in ${categorySlug.replace(/-/g, " ")}...`, onSearchChange: setSearchInput, onSearchCommit: commitSearch, sortValue: table.get("sort") || "-createdAt", sortOptions: withoutPriceSorts(PRODUCT_PUBLIC_SORT_OPTIONS, canSeePrices), onSortChange: (v) => {
                     table.set("sort", v);
-                }, view: view === "card" ? "grid" : "list", onViewChange: (v) => handleViewToggle(v === "grid" ? "card" : "list"), onResetAll: resetAll, hasActiveState: hasActiveState }), _jsx(Div, { padding: "y-sm", children: _jsx(AvailabilityTabs, { types: listingTypes }) }), totalPages > 1 && (_jsx(StickyToolbar, { offset: "header+pagination", tone: "translucent", border: true, padding: "toolbar", children: _jsx(Row, { justify: "center", children: _jsx(Pagination, { currentPage: page, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) }) })), _jsx(Div, { padding: "y-lg", children: renderCategoryProductGrid({
-                    isLoading, products: products, view,
-                    getProductHref: (p) => String(ROUTES.PUBLIC.PRODUCT_DETAIL(p.slug || p.id)),
-                    onWishlistToggle: handleWishlistToggle, wishlistedIds, onAddToCart: handleAddToCart,
-                }) }), _jsx(FilterDrawer, { open: filterOpen, onOpen: openFilters, onClose: () => setFilterOpen(false), onApply: applyFilters, onReset: onFilterClear, activeCount: filterActiveCount, hideTrigger: true, children: _jsx(ProductFilters, { table: pendingTable, currencyPrefix: "\u20B9" }) }), _jsx(LoginRequiredModal, { isOpen: modalOpen, onClose: closeModal, message: modalMessage })] }));
+                }, view: view === "card" ? "grid" : "list", onViewChange: (v) => handleViewToggle(v === "grid" ? "card" : "list"), onResetAll: resetAll, hasActiveState: hasActiveState }), _jsx(Div, { padding: "y-sm", children: _jsx(AvailabilityTabs, { types: listingTypes }) }), totalPages > 1 && (_jsx(StickyToolbar, { offset: "header+pagination", tone: "translucent", border: true, padding: "toolbar", children: _jsx(Row, { justify: "center", children: _jsx(Pagination, { currentPage: page, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) }) })), _jsxs(Div, { layout: "grid", gap: "8", className: "lg:grid-cols-12", children: [_jsx(Div, { className: "hidden lg:col-span-4 lg:block xl:col-span-3", children: _jsxs(Div, { rounded: "xl", border: "default", padding: "lg", children: [_jsx(ProductFilters, { table: pendingTable, currencyPrefix: "\u20B9" }), _jsxs(Row, { gap: "sm", className: "mt-4", justify: "end", children: [_jsx(Button, { type: "button", variant: "ghost", onClick: onFilterClear, children: "Reset all" }), _jsx(Button, { type: "button", variant: "primary", onClick: applyFilters, children: filterActiveCount > 0 ? `Apply (${filterActiveCount})` : "Apply" })] })] }) }), _jsx(Div, { className: "lg:col-span-8 xl:col-span-9", children: _jsx(Div, { padding: "y-lg", children: renderCategoryProductGrid({
+                                isLoading, products: products, view,
+                                getProductHref: (p) => String(ROUTES.PUBLIC.PRODUCT_DETAIL(p.slug || p.id)),
+                                onWishlistToggle: handleWishlistToggle, wishlistedIds, onAddToCart: handleAddToCart,
+                            }) }) })] }), _jsx(FilterDrawer, { open: filterOpen, onOpen: openFilters, onClose: () => setFilterOpen(false), onApply: applyFilters, onReset: onFilterClear, activeCount: filterActiveCount, hideTrigger: true, children: _jsx(ProductFilters, { table: pendingTable, currencyPrefix: "\u20B9" }) }), _jsx(LoginRequiredModal, { isOpen: modalOpen, onClose: closeModal, message: modalMessage })] }));
 }

package/dist/features/categories/components/CategoryTableColumns.js

@@ -5,7 +5,7 @@ import { Div } from "../../../ui/components/Div.js";
 import { Row } from "../../../ui/components/Layout.js";
 import { Span } from "../../../ui/components/Typography.js";
 import { StatusBadge } from "../../../ui/components/StatusBadge.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { DynamicBgDiv } from "../../../ui/components/DynamicBgDiv.js";
 const __O = {
     hidden: "overflow-hidden",

package/dist/features/categories/components/ConcernCard.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Button } from "../../../ui/components/Button.js";
 import { Div } from "../../../ui/components/Div.js";
 import { Heading, Text } from "../../../ui/components/Typography.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 export function ConcernCard({ concern, onClick, className = "", }) {
     return (_jsxs(Button, { type: "button", variant: "outline", onClick: () => onClick?.(concern), 
         // No bare `flex` here: globals.css declares `.flex` un-layered + !important,

package/dist/features/categories/components/ContextualTrail.d.ts

@@ -41,8 +41,15 @@ import type { BreadcrumbCrumb } from "../utils/breadcrumb-chain";
  * @tag layer:client-component
  * @tag access:client-only
  */
-/** The `sessionStorage` key. Read here, written by `<LastCategoryBeacon>`. */
-export declare const LAST_CATEGORY_KEY = "letitrip:last-category";
+/**
+ * The `sessionStorage` key. Read here, written by `<LastCategoryBeacon>`.
+ *
+ * 🛑 A getter, not a `const` — the namespace is configured by the consumer's
+ * bootstrap, which runs after this module is evaluated, so a value captured at
+ * import time would freeze the default. Kept as a named export because
+ * `<LastCategoryBeacon>` writes through the same key.
+ */
+export declare const getLastCategoryKey: () => string;
 export interface ContextualTrailProps {
     /**
      * One entry per assignment, DEFAULT FIRST. Each carries the assignment's

package/dist/features/categories/components/ContextualTrail.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import React from "react";
 import { storageManager } from "../../../core/StorageManager.js";
+import { STORAGE_KEYS } from "../../../constants/storage-keys.js";
 import { BreadcrumbTrail } from "./BreadcrumbTrail.js";
 /**
  * I5b — the visible trail follows the path the visitor actually took, when
@@ -44,8 +45,15 @@ import { BreadcrumbTrail } from "./BreadcrumbTrail.js";
  * @tag layer:client-component
  * @tag access:client-only
  */
-/** The `sessionStorage` key. Read here, written by `<LastCategoryBeacon>`. */
-export const LAST_CATEGORY_KEY = "letitrip:last-category";
+/**
+ * The `sessionStorage` key. Read here, written by `<LastCategoryBeacon>`.
+ *
+ * 🛑 A getter, not a `const` — the namespace is configured by the consumer's
+ * bootstrap, which runs after this module is evaluated, so a value captured at
+ * import time would freeze the default. Kept as a named export because
+ * `<LastCategoryBeacon>` writes through the same key.
+ */
+export const getLastCategoryKey = () => STORAGE_KEYS.lastCategory;
 export function ContextualTrail({ trails, alternates, className }) {
     // Index 0 is the default chain and is what the server rendered.
     const [index, setIndex] = React.useState(0);
@@ -63,7 +71,7 @@ export function ContextualTrail({ trails, alternates, className }) {
          * component needs no catch at all and there is one implementation of
          * "storage might not exist" rather than a second, quieter copy.
          */
-        const last = storageManager.get(LAST_CATEGORY_KEY, { type: "session" });
+        const last = storageManager.get(getLastCategoryKey(), { type: "session" });
         if (!last)
             return;
         const match = trails.findIndex((t) => t.categoryId === last);

package/dist/features/categories/components/FranchiseDetailPageView.d.ts

@@ -1,4 +1,5 @@
 import type { CategoryDocument } from "../schemas";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 /**
  * A FRANCHISE page — every listing from one IP.
  *
@@ -21,5 +22,7 @@ import type { CategoryDocument } from "../schemas";
 export interface FranchiseDetailPageViewProps {
     slug: string;
     franchise: CategoryDocument;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function FranchiseDetailPageView({ slug, franchise, }: FranchiseDetailPageViewProps): Promise<import("react").JSX.Element>;
+export declare function FranchiseDetailPageView({ slug, franchise, pageRegionCards, }: FranchiseDetailPageViewProps): Promise<import("react").JSX.Element>;

package/dist/features/categories/components/FranchiseDetailPageView.js

@@ -4,14 +4,17 @@ import { toProductItem } from "../../../_internal/shared/features/products/to-pr
 import { safeRead } from "../../../errors/safe-read.js";
 import { hidePublicTestData } from "../../../_internal/server/features/tester/visibility.js";
 import { Container, Row, Stack } from "../../../ui/components/Layout.js";
+import { Div } from "../../../ui/components/Div.js";
 import { Main, Section } from "../../../ui/components/Semantic.js";
 import { Heading, Text } from "../../../ui/components/Typography.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { ProductGrid } from "../../products/components/ProductGrid.js";
 import { Alert } from "../../../ui/components/Alert.js";
+import { DetailViewShell } from "../../../ui/components/DetailViewShell.js";
 import { RecordOwnerQuickActions } from "../../admin/components/RecordOwnerQuickActions.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const PAGE_SIZE = 24;
-export async function FranchiseDetailPageView({ slug, franchise, }) {
+export async function FranchiseDetailPageView({ slug, franchise, pageRegionCards = [], }) {
     const result = await safeRead(() => listPublicProducts({
         franchiseSlug: slug,
         page: 1,
@@ -38,7 +41,23 @@ export async function FranchiseDetailPageView({ slug, franchise, }) {
     const products = rows.map((r) => toProductItem(r));
     const total = reportedTotal ?? products.length;
     const cover = franchise.display?.coverImage;
-    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsxs(Row, { align: "center", gap: "comfortable", className: "mb-8", children: [cover ? (_jsx(MediaImage, { src: cover, alt: franchise.name ?? slug, size: "thumbnail", rounded: "lg" })) : null, _jsxs(Stack, { gap: "dense", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", wrap: true, children: [_jsx(Heading, { level: 1, color: "primary", size: "3xl", weight: "semibold", children: franchise.name }), franchise.id ? (_jsx(RecordOwnerQuickActions, { resource: "FRANCHISE", recordId: franchise.id, placement: "detail", recordLabel: franchise.name ?? slug })) : null] }), franchise.description ? (_jsx(Text, { color: "muted", className: "max-w-2xl", children: franchise.description })) : null] })] }), franchise.isActive === false ? (_jsxs(Alert, { variant: "info", className: "mb-6", children: ["We are not stocking ", franchise.name, " yet. This page is here so the link works \u2014 check back, or browse what we do carry."] })) : null, readFailed ? (_jsxs(Alert, { variant: "warning", children: ["We could not load ", franchise.name, " listings just now. Please try again."] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "muted", className: "mb-4", children: total === 0
-                                    ? "No listings yet."
-                                    : `${total}${truncated ? "+" : ""} listing${total === 1 ? "" : "s"}` }), _jsx(ProductGrid, { products: products, emptyLabel: "No listings yet." })] }))] }) }) }));
+    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsx(Container, { size: "xl", children: _jsx(DetailViewShell, { layout: "hub", mainSlots: [
+                        () => (_jsxs(Row, { align: "center", gap: "comfortable", className: "mb-8", children: [cover ? (_jsx(MediaImage, { src: cover, alt: franchise.name ?? slug, size: "thumbnail", rounded: "lg" })) : null, _jsxs(Stack, { gap: "dense", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", wrap: true, children: [_jsx(Heading, { level: 1, color: "primary", size: "3xl", weight: "semibold", children: franchise.name }), franchise.id ? (_jsx(RecordOwnerQuickActions, { resource: "FRANCHISE", recordId: franchise.id, placement: "detail", recordLabel: franchise.name ?? slug })) : null] }), franchise.description ? (_jsx(Text, { color: "muted", className: "max-w-2xl", children: franchise.description })) : null] })] })),
+                        /*
+                          An inactive franchise is one we have not stocked yet, and saying so
+                          is better than an unexplained empty grid — the visitor arrived from
+                          a real link and deserves to know it is coming, not that something
+                          broke.
+                        */
+                        franchise.isActive === false
+                            ? () => (_jsxs(Alert, { variant: "info", className: "mb-6", children: ["We are not stocking ", franchise.name, " yet. This page is here so the link works \u2014 check back, or browse what we do carry."] }))
+                            : undefined,
+                        /* 🛑 `readFailed` is a READ FAILURE, not an empty catalogue.
+                            `safeRead` already recorded it; saying "no products" here would
+                            turn an outage into a confident, wrong statement about stock. */
+                        () => readFailed ? (_jsxs(Alert, { variant: "warning", children: ["We could not load ", franchise.name, " listings just now. Please try again."] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "muted", className: "mb-4", children: total === 0
+                                        ? "No listings yet."
+                                        : `${total}${truncated ? "+" : ""} listing${total === 1 ? "" : "s"}` }), _jsx(ProductGrid, { products: products, emptyLabel: "No listings yet." })] })),
+                        () => (_jsx(Div, { className: "mt-8", children: _jsx(AdminComposableRegion, { pageId: "franchise-slug", initialCards: pageRegionCards }) })),
+                    ] }) }) }) }));
 }

package/dist/features/categories/components/FranchisesIndexView.d.ts

@@ -1,3 +1,8 @@
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface FranchisesIndexViewProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
 /**
  * The FRANCHISE index — the IPs we carry.
  *
@@ -11,4 +16,4 @@
  * @tag layer:view
  * @tag access:server-only
  */
-export declare function FranchisesIndexView(): Promise<import("react").JSX.Element>;
+export declare function FranchisesIndexView({ pageRegionCards }?: FranchisesIndexViewProps): Promise<import("react").JSX.Element>;

package/dist/features/categories/components/FranchisesIndexView.js

@@ -7,9 +7,10 @@ import { Main, Section } from "../../../ui/components/Semantic.js";
 import { Heading, Text } from "../../../ui/components/Typography.js";
 import { Div } from "../../../ui/components/Div.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { Alert } from "../../../ui/components/Alert.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /**
  * The FRANCHISE index — the IPs we carry.
  *
@@ -23,11 +24,11 @@ import { ROUTES } from "../../../next/routing/route-map.js";
  * @tag layer:view
  * @tag access:server-only
  */
-export async function FranchisesIndexView() {
+export async function FranchisesIndexView({ pageRegionCards = [] } = {}) {
     const franchises = await safeRead(() => listActiveFranchises().then(hidePublicTestData), {
         route: "/franchise",
         key: "franchises.list",
         fallback: null,
     });
-    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-2", color: "primary", size: "3xl", weight: "semibold", children: "Franchises" }), _jsx(Text, { color: "muted", className: "mb-8", children: "The universes we stock. A franchise is what a collectible is from \u2014 a brand is who made it." }), franchises === null ? (_jsx(Alert, { variant: "warning", children: "We could not load the franchise list just now. Please try again." })) : franchises.length === 0 ? (_jsx(Alert, { variant: "info", children: "No franchises are live yet." })) : (_jsx(Grid, { cols: "cards", gap: "comfortable", children: franchises.map((f) => (_jsx(TextLink, { href: ROUTES.PUBLIC.FRANCHISE_DETAIL(String(f.slug ?? f.id)), children: _jsxs(Div, { surface: "card", padding: "card", rounded: "lg", border: "default", children: [f.display?.coverImage ? (_jsx(MediaImage, { src: f.display.coverImage, alt: f.name ?? "", size: "card", rounded: "md", className: "mb-3" })) : null, _jsx(Heading, { level: 2, size: "lg", weight: "semibold", children: f.name }), f.description ? (_jsx(Text, { color: "muted", size: "sm", className: "mt-1", truncate: 2, children: f.description })) : null] }) }, f.id))) }))] }) }) }));
+    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-2", color: "primary", size: "3xl", weight: "semibold", children: "Franchises" }), _jsx(Text, { color: "muted", className: "mb-8", children: "The universes we stock. A franchise is what a collectible is from \u2014 a brand is who made it." }), _jsx(AdminComposableRegion, { pageId: "franchise-index", initialCards: pageRegionCards }), franchises === null ? (_jsx(Alert, { variant: "warning", children: "We could not load the franchise list just now. Please try again." })) : franchises.length === 0 ? (_jsx(Alert, { variant: "info", children: "No franchises are live yet." })) : (_jsx(Grid, { cols: "cards", gap: "comfortable", children: franchises.map((f) => (_jsx(TextLink, { href: ROUTES.PUBLIC.FRANCHISE_DETAIL(String(f.slug ?? f.id)), children: _jsxs(Div, { surface: "card", padding: "card", rounded: "lg", border: "default", children: [f.display?.coverImage ? (_jsx(MediaImage, { src: f.display.coverImage, alt: f.name ?? "", size: "card", rounded: "md", className: "mb-3" })) : null, _jsx(Heading, { level: 2, size: "lg", weight: "semibold", children: f.name }), f.description ? (_jsx(Text, { color: "muted", size: "sm", className: "mt-1", truncate: 2, children: f.description })) : null] }) }, f.id))) }))] }) }) }));
 }

package/dist/features/categories/components/LastCategoryBeacon.js

@@ -1,7 +1,7 @@
 "use client";
 import React from "react";
 import { storageManager } from "../../../core/StorageManager.js";
-import { LAST_CATEGORY_KEY } from "./ContextualTrail.js";
+import { getLastCategoryKey } from "./ContextualTrail.js";
 /**
  * Record which category page the visitor is on, for `<ContextualTrail>`.
  *
@@ -27,7 +27,7 @@ export function LastCategoryBeacon({ categoryId }) {
          * and no second copy of that logic. A `false` return means the visitor
          * keeps the default trail, which is a correct answer.
          */
-        storageManager.set(LAST_CATEGORY_KEY, categoryId, { type: "session" });
+        storageManager.set(getLastCategoryKey(), categoryId, { type: "session" });
     }, [categoryId]);
     return null;
 }

package/dist/features/categories/components/SubcategoryCardRow.js

@@ -46,7 +46,7 @@ import { HorizontalScroller } from "../../../ui/components/HorizontalScroller.js
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { Span, Text } from "../../../ui/components/Typography.js";
 import { FieldInput } from "../../../ui/forms/index.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
 /**
  * The filter appears once this many NAMES are searchable — cards plus the

package/dist/features/categories/hooks/useCategorySelector.d.ts

@@ -1,4 +1,4 @@
-import type { JsonValue } from "@mohasinac/appkit";
+import type { JsonValue } from "../../../schemas/types";
 import type { Category, CategoryItem } from "../types";
 export interface UseCategorySelectorOptions {
     categoriesEndpoint?: string;

package/dist/features/categories/hooks/useCategoryTree.js

@@ -23,7 +23,7 @@ export function useCategoryTree(opts) {
              * alone and `dfs(null)` emits tier-0 only.
              *
              * Measured against production data before this fix: the category
-             * facet on /products, /auctions, /pre-orders and /prize-draws showed
+             * facet on /products, /collector-drops, /pre-orders and /prize-draws showed
              * **11 options instead of 47** — and 9 of those 11 were not categories
              * at all. It listed "Takara-Tomy", "Hasbro", "Burst Battlers Pack" and
              * "X-Series Starter Set", because brand and bundle rows live in the

package/dist/features/categories/repository/categories.repository.d.ts

@@ -1,8 +1,26 @@
 import { type CategoryCountsDocument } from "../schemas/category-counts";
 import { BaseRepository, type FirebaseSieveFields, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
 import { type CategoryCreateInput, type CategoryDocument, type CategoryMoveInput, type CategoryTreeNode } from "../schemas";
-import type { FirestoreDocument, JsonValue } from "@mohasinac/appkit";
+import type { FirestoreDocument, JsonValue } from "../../../schemas/types";
 export declare class CategoriesRepository extends BaseRepository<CategoryDocument> {
+    /**
+     * Normalise the 2026-11-07 `hasbroName` → `altRegionName` rename on READ.
+     *
+     * 🛑 This belongs at the repository boundary, not in a view or an adapter.
+     * The public-projection adapter (`toCategoryListItem`) only runs on the LIST
+     * route; `getCategoryBySlug` / `findById` hand the RAW document straight to
+     * server components, so `CategoryDetailPageView` was reading `altRegionName`
+     * off a document that still only had `hasbroName` — the "Also known as" block
+     * silently stopped rendering. Verified live before this override existed.
+     *
+     * Overriding `mapDoc` fixes every read path at once (slug, id, list,
+     * children, tree) because they all map through it — which is exactly what
+     * `BaseRepository.mapDoc` documents it is there for.
+     *
+     * Remove once `scripts/backfill-alt-region-name.mjs --apply --drop-old` has
+     * run and no stored document carries the old keys.
+     */
+    protected mapDoc<D = CategoryDocument>(snap: Parameters<BaseRepository<CategoryDocument>["mapDoc"]>[0]): D;
     static readonly SIEVE_FIELDS: FirebaseSieveFields;
     constructor();
     /** Derived on every write path via `applyWriteHooks`. */
@@ -190,7 +208,7 @@ export declare class CategoriesRepository extends BaseRepository<CategoryDocumen
      * Cloud Functions: stage metric increments into a caller-owned WriteBatch.
      * The caller must have already fetched `parentIds` for the category.
      */
-    updateMetricsInBatch(batch: import("firebase-admin/firestore").WriteBatch, categoryId: string, parentIds: string[], productDelta: number, auctionDelta: number, productId?: string): void;
+    updateMetricsInBatch(batch: import("firebase-admin/firestore").WriteBatch, categoryId: string, parentIds: string[], productDelta: number, collectorDropDelta: number, productId?: string): void;
     /**
      * I3 — the same live metric update, for a product filed under SEVERAL
      * categories at once.
@@ -218,7 +236,7 @@ export declare class CategoriesRepository extends BaseRepository<CategoryDocumen
     updateMetricsForAssignmentsInBatch(batch: import("firebase-admin/firestore").WriteBatch, assignments: Array<{
         id: string;
         parentIds: string[];
-    }>, productDelta: number, auctionDelta: number, productId?: string, 
+    }>, productDelta: number, collectorDropDelta: number, productId?: string, 
     /** A brand row: flat, so own and rollup move together. */
     brandId?: string | null): void;
     /**
@@ -262,13 +280,13 @@ export declare class CategoriesRepository extends BaseRepository<CategoryDocumen
     setMetrics(categoryId: string, m: {
         /** Items filed DIRECTLY under this category. */
         productCount: number;
-        auctionCount: number;
+        collectorDropCount: number;
         /** Own + every descendant's. Equals the own count on a leaf. */
         totalProductCount: number;
-        totalAuctionCount: number;
+        totalCollectorDropCount: number;
         /** Own only — the ids are used for spot-checking, never for the rollup. */
         productIds: string[];
-        auctionIds: string[];
+        collectorDropIds: string[];
     }): Promise<void>;
     /** SB-UNI — discriminator-keyed listing (sublistings, brands, bundles). */
     listByType(type: import("../types").CategoryType, opts?: {
@@ -331,6 +349,25 @@ export declare class CategoriesRepository extends BaseRepository<CategoryDocumen
      * one.
      */
     findActiveFranchises(): Promise<CategoryDocument[]>;
+    /**
+     * EVERY category/brand/franchise/sublisting/bundle row — active or not —
+     * the flat corpus for 4B part 2's entity-search index
+     * (`_internal/server/features/search/entity-index.ts`).
+     *
+     * 🛑 Deliberately NO `isActive` clause, unlike `findActiveBrands`/
+     * `findActiveFranchises` above. Those two serve PUBLIC browse pages,
+     * where an inactive row is a dead facet that must not render. This
+     * serves an ADMIN jumping straight to a row's own editor — and 7 of the
+     * 8 seeded franchises are inactive precisely because nobody has stocked
+     * them yet (§ "Franchise" in CLAUDE.md), which is exactly the row an
+     * admin most needs to find and fix. Filtering to active-only here would
+     * make most franchises permanently unreachable from the one search meant
+     * to reach them.
+     *
+     * The caller caches this result (30-min TTL, matching `getFlagSnapshot`'s
+     * own precedent), so this is not a per-request scan.
+     */
+    findAllForEntitySearch(): Promise<CategoryDocument[]>;
     /**
      * SB-UNI-B — derive the canonical `sublisting-{slug}` ID from a
      * human-entered category name.