@mohasinac/appkit 4.71.0 → 4.71.2

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

@@ -1,6 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import Link from "next/link.js";
 import { productRepository } from "../../products/repository/products.repository.js";
+import { getFieldVisibility } from "../../../_internal/server/features/forms/field-visibility.js";
+import { SectionVisibilityGate } from "../../shell/SectionVisibilityGate.js";
 const __P = {
     p3: "p-[var(--appkit-space-3)]",
     p5: "p-[var(--appkit-space-5)]",
@@ -17,6 +19,7 @@ import { formatCurrency, roundRupees } from "../../../utils/number.formatter.js"
 import { toDescriptionHtml } from "../../../utils/string.formatter.js";
 import { safeDisplayName } from "../../../security/index.js";
 import { ProgressBarFill } from "../../../ui/components/ProgressBarFill.js";
+import { Disclaimer } from "../../../ui/components/Disclaimer.js";
 import { Button } from "../../../ui/components/Button.js";
 import { Container, Row, Stack } from "../../../ui/components/Layout.js";
 import { Div } from "../../../ui/components/Div.js";
@@ -29,7 +32,8 @@ import { PreOrderDetailView } from "../../products/components/PreOrderDetailView
 import { PreOrderBottomActions } from "./PreOrderBottomActions.js";
 import { ProductTabsShell } from "../../products/components/ProductTabsShell.js";
 import { toCustomSectionTabs } from "../../products/components/CustomSectionTabContent.js";
-import { PreOrderActionsClient } from "./PreOrderActionsClient.js";
+import { PreOrderActionsClient, PRE_ORDER_TRUST_BADGES } from "./PreOrderActionsClient.js";
+import { TrustBadgeRow } from "../../products/components/TrustBadgeRow.js";
 import { ProductGalleryClient } from "../../products/components/ProductGalleryClient.js";
 import { ProductFeatureBadges } from "../../products/components/ProductFeatureBadges.js";
 import { isFinalSale } from "../../products/constants/final-sale.js";
@@ -45,6 +49,7 @@ import { GroupedListingsCarousel } from "../../grouped/components/GroupedListing
 import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data.js";
 import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
 import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const PRODUCTION_STATUS_LABELS = {
     upcoming: "Coming Soon",
     in_production: "In Production",
@@ -70,13 +75,9 @@ function PreOrderInfoSection({ title, productId, storeId, productionStatus, maxP
                 } }), (categoryName || category || brand) && (_jsxs(Row, { gap: "sm", wrap: true, children: [category && (_jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: categoryName || category })), !category && categoryName && (_jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: categoryName })), brand && brandSlug && (_jsx(Link, { href: String(ROUTES.PUBLIC.BRAND_DETAIL(brandSlug)), className: "inline-flex items-center rounded-full border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-2-5)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-medium text-[var(--appkit-color-text-muted)] transition-colors hover:border-primary-300 hover:bg-primary-surface hover:text-primary-700 dark:hover:border-primary-700/60 dark:hover:text-primary-400", children: brand })), brand && !brandSlug && (_jsx(Span, { layout: "inline-flex", size: "xs", weight: "medium", border: "subtle", rounded: "full", padding: "pill-sm-tall", surface: "muted", color: "muted", children: brand }))] })), productFeatures && features.length > 0 && (_jsx(FeatureBadgeList, { productFeatureIds: features, features: productFeatures })), !productFeatures && features.length > 0 && (_jsxs(Div, { border: "subtle", surface: "muted", padding: "inline", rounded: "xl", children: [_jsx(Text, { className: "mb-2 tracking-wide", color: "muted", size: "xs", weight: "semibold", transform: "uppercase", children: "About this product" }), _jsx(Ul, { spacing: "comfortable", size: "sm", color: "primary", children: features.map((f, i) => (_jsxs(Li, { layout: "flex-start", gap: "2", children: [_jsx(Span, { className: "mt-0.5 flex-shrink-0 text-primary-500", children: "\u2022" }), f] }, i))) })] })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] }));
 }
 function PreOrderBuyBarPanel({ reserveTarget, reservedCount, progressPct, productId, price, currency, depositAmount, depositPercent, isCancellable, tags, onReserveNow, }) {
-    return (_jsxs(Stack, { id: "pre-order-buy-bar", className: `${__P.p5}`, border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [reserveTarget > 0 && (_jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Text, { size: "xs", color: "muted", children: [reservedCount, " of ", reserveTarget, " reserved"] }), _jsxs(Span, { size: "xs", weight: "semibold", className: "text-primary-600 dark:text-primary-400", children: [progressPct, "%"] })] }), _jsx(Div, { className: `h-2 w-full ${__O.hidden}`, rounded: "full", surface: "subtle", children: _jsx(ProgressBarFill, { pct: progressPct, className: "h-full bg-primary transition-all rounded-full" }) })] })), onReserveNow ? (_jsx(PreOrderActionsClient, { productId: productId, price: price, currency: currency, depositAmount: depositAmount, depositPercent: depositPercent, isCancellable: isCancellable, tags: tags, onReserveNow: onReserveNow })) : (_jsxs(_Fragment, { children: [price !== null && (_jsxs(Div, { children: [_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) }), depositAmount !== null && (_jsx(PricesOnly, { children: _jsxs(Text, { className: "mt-0.5", color: "muted", size: "xs", children: ["Reserve with ", formatCurrency(depositAmount, currency), depositPercent !== null ? ` (${depositPercent}% deposit)` : ""] }) }))] })), _jsxs(Stack, { gap: "sm", children: [_jsx(Button, { variant: "primary", size: "md", className: "w-full", children: "Reserve Now" }), isCancellable && (_jsx(Text, { size: "xs", align: "start", color: "muted", children: "\u2713 Free cancellation before production" }))] }), tags.length > 0 && (_jsx(Div, { border: "default", className: "border-t", padding: "t-md", children: _jsx(Row, { wrap: true, gap: "xs", children: tags.map((tag) => (_jsx(Span, { size: "xs", rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", children: tag }, tag))) }) })), _jsx(Div, { border: "default", className: "border-t", padding: "t-md", children: _jsx(Row, { wrap: true, gap: "sm", justify: "center", className: "text-center", children: [
-                                { icon: "🔒", label: "Secure\nPayment" },
-                                { icon: "📅", label: "Guaranteed\nDelivery" },
-                                { icon: "↩", label: "Free\nCancellation" },
-                            ].map(({ icon, label }) => (_jsxs(Stack, { color: "muted", textSize: "xs", className: "min-w-[60px]", align: "center", gap: "xs", children: [_jsx(Span, { size: "base", children: icon }), _jsx(Span, { className: "whitespace-pre-line leading-tight", children: label })] }, label))) }) })] }))] }));
+    return (_jsxs(Stack, { id: "pre-order-buy-bar", className: `${__P.p5}`, border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [reserveTarget > 0 && (_jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Text, { size: "xs", color: "muted", children: [reservedCount, " of ", reserveTarget, " reserved"] }), _jsxs(Span, { size: "xs", weight: "semibold", className: "text-primary-600 dark:text-primary-400", children: [progressPct, "%"] })] }), _jsx(Div, { className: `h-2 w-full ${__O.hidden}`, rounded: "full", surface: "subtle", children: _jsx(ProgressBarFill, { pct: progressPct, className: "h-full bg-primary transition-all rounded-full" }) })] })), onReserveNow ? (_jsx(PreOrderActionsClient, { productId: productId, price: price, currency: currency, depositAmount: depositAmount, depositPercent: depositPercent, isCancellable: isCancellable, tags: tags, onReserveNow: onReserveNow })) : (_jsxs(_Fragment, { children: [price !== null && (_jsxs(Div, { children: [_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) }), depositAmount !== null && (_jsx(PricesOnly, { children: _jsxs(Text, { className: "mt-0.5", color: "muted", size: "xs", children: ["Reserve with ", formatCurrency(depositAmount, currency), depositPercent !== null ? ` (${depositPercent}% deposit)` : ""] }) }))] })), _jsxs(Stack, { gap: "sm", children: [_jsx(Button, { variant: "primary", size: "md", className: "w-full", children: "Reserve Now" }), isCancellable && (_jsx(Text, { size: "xs", align: "start", color: "muted", children: "\u2713 Free cancellation before production" }))] }), tags.length > 0 && (_jsx(Div, { border: "default", className: "border-t", padding: "t-md", children: _jsx(Row, { wrap: true, gap: "xs", children: tags.map((tag) => (_jsx(Span, { size: "xs", rounded: "full", padding: "pill-sm-tall", surface: "subtle", color: "muted", children: tag }, tag))) }) })), _jsx(Div, { border: "default", className: "border-t", padding: "t-md", children: _jsx(TrustBadgeRow, { badges: PRE_ORDER_TRUST_BADGES }) })] })), _jsx(Disclaimer, { id: "pre-order", inline: true })] }));
 }
-export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow, productFeatures }) {
+export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow, productFeatures, pageRegionCards = [] }) {
     const product = initialPreOrder !== undefined
         ? (initialPreOrder ?? undefined)
         // The pre-order IS this page's subject — a read failure must surface rather
@@ -147,6 +148,20 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
     const brandSlug = typeof p.brandSlug === "string" ? p.brandSlug : null;
     const features = Array.isArray(p.features) ? p.features : [];
     const tags = Array.isArray(p.tags) ? p.tags : [];
+    /*
+     * `functionalSlot` (2026-11-05) — `onReserveNow` is a page-level PROP, but
+     * what actually RENDERS in the buy-bar position is `<PreOrderBuyBarPanel
+     * onReserveNow={onReserveNow} .../>`, a composed component that already
+     * returns a `ReactNode` (progress bar + reserve button, or a price/deposit
+     * fallback when `onReserveNow` is absent — same "always renders
+     * something" shape as the standard PDP's primary actions). Hoisting the
+     * whole rendered element needs no new `functionalSlots` value shape or
+     * adapter — confirmed by reading the actual call site, not assumed ahead
+     * of time. Mapped onto `"pdp-primary-actions"`: reserving IS the purchase
+     * path here, same role as elsewhere.
+     */
+    const primaryActionsNode = (_jsx(PreOrderBuyBarPanel, { reserveTarget: reserveTarget, reservedCount: reservedCount, progressPct: progressPct, productId: String(product.id), price: price, currency: currency, depositAmount: depositAmount, depositPercent: depositPercent, isCancellable: isCancellable, tags: tags, onReserveNow: onReserveNow }));
+    const hasPrimaryActionsSlotOverride = pageRegionCards.some((card) => card.elements.some((el) => el.kind === "functionalSlot" && el.slotId === "pdp-primary-actions"));
     const specs = Array.isArray(p.specifications)
         ? p.specifications
         : [];
@@ -155,9 +170,14 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
     const groupId = typeof p.groupId === "string" ? p.groupId : null;
     const isGroupParent = p.isGroupParent === true;
     const groupTitle = typeof p.groupTitle === "string" ? p.groupTitle : undefined;
-    const [{ relatedItems, relatedByBrand, relatedByTags, relatedByStore }, groups] = await Promise.all([
+    const [{ relatedItems, relatedByBrand, relatedByTags, relatedByStore }, groups, pdpSectionVisibility] = await Promise.all([
         computeRelatedItems(product),
         getGroupsWithItemsForProduct(product.id),
+        // Same shared "pdp-sections" surface as the standard-product detail
+        // page — ONE admin decision ("hide the gallery") applies across every
+        // listing type's own detail-page component, matching a template-level
+        // mental model rather than needing N separate per-type configs.
+        getFieldVisibility("pdp-sections"),
     ]);
     return (_jsxs(Main, { children: [_jsx(HistoryTracker, { productId: String(p.id ?? p.slug ?? ""), productType: "preorder", snapshot: {
                     title: typeof p.title === "string" ? p.title : undefined,
@@ -165,9 +185,9 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
                     price: typeof p.price === "number" ? p.price : undefined,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: typeof p.storeName === "string" ? p.storeName : undefined,
-                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRE_ORDERS), className: CLS_BREADCRUMB_LINK, children: "Pre-Orders" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title })), renderInfo: () => (_jsx(PreOrderInfoSection, { title: title, productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined, productionStatus: productionStatus, maxPerUser: maxPerUser, deliveryDate: deliveryDate, featured: featured, freeShipping: freeShipping, condition: condition, isCancellable: isCancellable, finalSale: isFinalSale(p), category: category, categoryName: categoryName, brand: brand, brandSlug: brandSlug, productFeatures: productFeatures, features: features, descriptionHtml: descriptionHtml, safeSeller: safeSeller, storeHref: storeHref })), renderSublistingSection: sublistingCategoryId
+                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRE_ORDERS), className: CLS_BREADCRUMB_LINK, children: "Pre-Orders" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(AdminComposableRegion, { pageId: "pre-orders-id", initialCards: pageRegionCards, functionalSlots: { "pdp-primary-actions": primaryActionsNode } }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "gallery", initialVisible: pdpSectionVisibility.gallery !== false, children: _jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title }) })), renderInfo: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "info", initialVisible: pdpSectionVisibility.info !== false, children: _jsx(PreOrderInfoSection, { title: title, productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined, productionStatus: productionStatus, maxPerUser: maxPerUser, deliveryDate: deliveryDate, featured: featured, freeShipping: freeShipping, condition: condition, isCancellable: isCancellable, finalSale: isFinalSale(p), category: category, categoryName: categoryName, brand: brand, brandSlug: brandSlug, productFeatures: productFeatures, features: features, descriptionHtml: descriptionHtml, safeSeller: safeSeller, storeHref: storeHref }) })), renderSublistingSection: sublistingCategoryId
                             ? () => (_jsx(SublistingCarouselSection, { sublistingCategoryId: sublistingCategoryId, currentListingId: String(product.id) }))
                             : undefined, renderGroupSection: groupId
                             ? () => (_jsx(ShowGroupSection, { groupId: groupId, currentSlug: String(p.slug ?? product.id), isParent: isGroupParent, groupTitle: groupTitle }))
-                            : undefined, renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, customTabs: toCustomSectionTabs(p.customSections) })), renderBuyBar: () => (_jsx(PreOrderBuyBarPanel, { reserveTarget: reserveTarget, reservedCount: reservedCount, progressPct: progressPct, productId: String(product.id), price: price, currency: currency, depositAmount: depositAmount, depositPercent: depositPercent, isCancellable: isCancellable, tags: tags, onReserveNow: onReserveNow })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(PurchaseReviewAffordance, { productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined }), _jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand || undefined, storeLabel: storeName || undefined })] })) }), _jsx(PreOrderBottomActions, { price: price, currency: currency })] })] }));
+                            : undefined, renderTabs: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "tabs", initialVisible: pdpSectionVisibility.tabs !== false, children: _jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, customTabs: toCustomSectionTabs(p.customSections) }) })), renderBuyBar: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "actions", initialVisible: pdpSectionVisibility.actions !== false, children: !hasPrimaryActionsSlotOverride && primaryActionsNode })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(PurchaseReviewAffordance, { productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined }), _jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "grouped-listings", initialVisible: pdpSectionVisibility["grouped-listings"] !== false, children: _jsx(GroupedListingsCarousel, { groups: groups }) }), _jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "related", initialVisible: pdpSectionVisibility.related !== false, children: _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand || undefined, storeLabel: storeName || undefined }) })] })) }), _jsx(PreOrderBottomActions, { price: price, currency: currency })] })] }));
 }

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

@@ -31,7 +31,7 @@ import { useBrands } from "../../products/hooks/useBrands.js";
 import { useBulkSelection } from "../../../react/hooks/useBulkSelection.js";
 import { TABLE_KEYS, VIEW_MODE } from "../../../constants/table-keys.js";
 import { PREORDER_SORT_OPTIONS } from "../../products/constants/sieve.js";
-import { useBottomActions } from "../../layout/hooks/useBottomActions.js";
+import { useBottomActions } from "../../../ui/chrome/useBottomActions.js";
 import { AVAILABILITY_VALUES } from "../../../constants/field-names.js";
 import { AvailabilityTabs } from "../../products/components/AvailabilityTabs.js";
 const PRE_ORDER_LISTING_TYPES = ["pre-order"];

package/dist/features/pre-orders/components/PreOrdersListView.d.ts

@@ -1,6 +1,9 @@
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 type SearchParams = Record<string, string | string[]>;
 export interface PreOrdersListViewProps {
     searchParams?: SearchParams;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function PreOrdersListView({ searchParams }: PreOrdersListViewProps): Promise<import("react").JSX.Element>;
+export declare function PreOrdersListView({ searchParams, pageRegionCards, }: PreOrdersListViewProps): Promise<import("react").JSX.Element>;
 export {};

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

@@ -5,10 +5,11 @@ import { Heading } from "../../../ui/components/Typography.js";
 import { AdSlot } from "../../homepage/components/AdSlot.js";
 import { PreOrdersIndexListing } from "./PreOrdersIndexListing.js";
 import { listPublicProducts, parsePublicProductParams, defaultAvailabilityForListingTypes, } from "../../../_internal/server/features/products/list-public.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const PRE_ORDER_LISTING_TYPES = ["pre-order"];
 const DEFAULT_PAGE_SIZE = 24;
 const DEFAULT_SORT = "-createdAt";
-export async function PreOrdersListView({ searchParams = {} }) {
+export async function PreOrdersListView({ searchParams = {}, pageRegionCards = [], }) {
     // Shared with /api/products, and derived rather than hardcoded. This view
     // carried a literal `hideSoldByDefault: true` until 2026-08-24 even though
     // pre-order's registered hide-default is "closed" — so /pre-orders and
@@ -19,5 +20,5 @@ export async function PreOrdersListView({ searchParams = {} }) {
         sorts: DEFAULT_SORT,
         ...defaultAvailabilityForListingTypes(PRE_ORDER_LISTING_TYPES),
     }));
-    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8", color: "primary", size: "3xl", weight: "semibold", children: "Pre-Orders" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(PreOrdersIndexListing, { initialData: result ?? undefined }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
+    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8", color: "primary", size: "3xl", weight: "semibold", children: "Pre-Orders" }), _jsx(AdminComposableRegion, { pageId: "pre-orders-index", initialCards: pageRegionCards }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(PreOrdersIndexListing, { initialData: result ?? undefined }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }

package/dist/features/pre-orders/schemas/index.d.ts

@@ -23,19 +23,19 @@ export declare const preorderItemSchema: z.ZodObject<{
         youtubeId: z.ZodOptional<z.ZodString>;
         duration: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        type: "image" | "video" | "file";
         url: string;
+        type: "video" | "image" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
         duration?: number | undefined;
     }, {
-        type: "image" | "video" | "file";
         url: string;
+        type: "video" | "image" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
         duration?: number | undefined;
     }>, "many">>;
@@ -60,11 +60,11 @@ export declare const preorderItemSchema: z.ZodObject<{
     images?: string[] | undefined;
     createdAt?: string | undefined;
     media?: {
-        type: "image" | "video" | "file";
         url: string;
+        type: "video" | "image" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
         duration?: number | undefined;
     }[] | undefined;
@@ -82,11 +82,11 @@ export declare const preorderItemSchema: z.ZodObject<{
     active?: boolean | undefined;
     isFeatured?: boolean | undefined;
     media?: {
-        type: "image" | "video" | "file";
         url: string;
+        type: "video" | "image" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
         duration?: number | undefined;
     }[] | undefined;

package/dist/features/price-index/components/PriceIndexToolView.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 /**
  * The realised-price lookup — a SEARCH tool, not a list.
  *
@@ -125,5 +126,7 @@ export interface PriceIndexToolViewProps {
     initialData?: PriceIndexToolResponse | null;
     /** `siteSettings.search?.indexEnabled`. Read as `!== false`. */
     searchIndexEnabled?: boolean;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function PriceIndexToolView({ initialQuery, initialData, searchIndexEnabled, }: PriceIndexToolViewProps): React.JSX.Element;
+export declare function PriceIndexToolView({ initialQuery, initialData, searchIndexEnabled, pageRegionCards, }: PriceIndexToolViewProps): React.JSX.Element;

package/dist/features/price-index/components/PriceIndexToolView.js

@@ -13,7 +13,7 @@ import { Form } from "../../../ui/components/Form.js";
 import { FieldInput } from "../../../ui/forms/FieldInput.js";
 import { PaginatedSelect } from "../../../ui/components/PaginatedSelect.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { TOOL_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { apiClient } from "../../../http/ApiClient.js";
 import { useSiteSearch } from "../../search/hooks/useSiteSearch.js";
@@ -26,6 +26,7 @@ import { normalizeError } from "../../../errors/normalize.js";
 import { toUserMessage } from "../../../errors/error-display-map.js";
 import { PRICE_LOOKUP_INDEX_TYPES, priceLookupTargetFor } from "../lookup-target.js";
 import { getBrandName } from "../../../core/brand-resolver.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /** Human labels. Falls back to the raw value so a new condition still renders. */
 const CONDITION_LABEL = {
     new: "New",
@@ -40,14 +41,13 @@ const CONDITION_LABEL = {
 };
 const LISTING_TYPE_LABEL = {
     standard: "Standard sale",
-    auction: "Auction",
+    "collector-drop": "Collector Drop",
     "pre-order": "Pre-order",
-    "prize-draw": "Prize draw",
+    "clearance": "Clearance",
     classified: "Classified",
     "digital-code": "Digital code",
     live: "Live item",
-    art: "Art print",
-    stickers: "Sticker sheet",
+    "art-and-stickers": "Art & Stickers",
 };
 /*
  * Overflow classes via a local map, matching NavbarLayout's `__O` — the audit
@@ -228,7 +228,7 @@ function ResultCard({ row, threshold, market, canSeeMarket, }) {
 }
 /** Stable identity — a `useMemo` dependency inside `useSiteSearch`. */
 const identityLabel = (typeKey) => typeKey;
-export function PriceIndexToolView({ initialQuery = "", initialData = null, searchIndexEnabled, }) {
+export function PriceIndexToolView({ initialQuery = "", initialData = null, searchIndexEnabled, pageRegionCards = [], }) {
     const [draft, setDraft] = useState(initialQuery);
     /**
      * The SUBMITTED term, distinct from `draft`.
@@ -478,7 +478,7 @@ export function PriceIndexToolView({ initialQuery = "", initialData = null, sear
         : null;
     const threshold = data?.minConfidentSamples ?? 3;
     const hasQuery = (data?.query ?? "").length > 0;
-    return (_jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "lg", children: _jsxs(Stack, { gap: "lg", className: "min-w-0", children: [_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsxs(Row, { gap: "sm", align: "center", children: [_jsx(TrendingUp, { className: "w-5 h-5 text-primary-600", "aria-hidden": "true" }), _jsx(Heading, { level: 1, children: "What it sold for" })] }), _jsxs(Text, { color: "muted", children: ["Pick any bey, part or set to see what it actually sold for on", getBrandName(), " \u2014 the range, the median, the average and the most recent sale, broken down by condition \u2014 alongside what other Indian shops are asking for the same thing."] })] }), dropdownUsable ? (_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsx(PaginatedSelect, { value: picked?.id ?? null, onChange: (value, option) => setPicked(value && option ? { id: value, label: option.label } : null), loadOptions: loadOptions, placeholder: "Pick a bey, part or set\u2026", searchPlaceholder: "Type a name, code or part \u2014 e.g. Dragoon G, 1B, rubber flat", noResultsText: "Nothing in our catalogue matches that.", ariaLabel: "Search the catalogue for a price lookup" }), _jsx(Text, { size: "xs", color: "muted", children: "Models, parts and spares, eras and brands \u2014 straight from our own catalogue, so what you pick is a real thing we can price." })] })) : (
+    return (_jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "lg", children: _jsxs(Stack, { gap: "lg", className: "min-w-0", children: [_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsxs(Row, { gap: "sm", align: "center", children: [_jsx(TrendingUp, { className: "w-5 h-5 text-primary-600", "aria-hidden": "true" }), _jsx(Heading, { level: 1, children: "What it sold for" })] }), _jsxs(Text, { color: "muted", children: ["Pick any bey, part or set to see what it actually sold for on", getBrandName(), " \u2014 the range, the median, the average and the most recent sale, broken down by condition \u2014 alongside what other Indian shops are asking for the same thing."] })] }), _jsx(AdminComposableRegion, { pageId: "tools-price-index", initialCards: pageRegionCards }), dropdownUsable ? (_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsx(PaginatedSelect, { value: picked?.id ?? null, onChange: (value, option) => setPicked(value && option ? { id: value, label: option.label } : null), loadOptions: loadOptions, placeholder: "Pick a bey, part or set\u2026", searchPlaceholder: "Type a name, code or part \u2014 e.g. Dragoon G, 1B, rubber flat", noResultsText: "Nothing in our catalogue matches that.", ariaLabel: "Search the catalogue for a price lookup" }), _jsx(Text, { size: "xs", color: "muted", children: "Models, parts and spares, eras and brands \u2014 straight from our own catalogue, so what you pick is a real thing we can price." })] })) : (
                     /*
                      * 🛑 The fallback, for a disabled or failed search artifact. Without
                      * it a kill-switch flip would leave an empty combobox and no way to

package/dist/features/price-index/lookup-target.js

@@ -23,7 +23,7 @@
  * @tag consumers:PriceIndexToolView
  * @tag sideEffects:none
  */
-import { PART_SLOT_CATEGORY } from "../parts/schemas/firestore.js";
+import { PART_SLOT_CATEGORY } from "../products/schemas/part-slots.js";
 /**
  * The index types the price tool searches.
  *

package/dist/features/print/components/BoxLabelPrintView.d.ts

@@ -1,4 +1,5 @@
 import { type BoxContentsRow } from "./labels";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface PrintableBox {
     id: string;
     code: string;
@@ -21,5 +22,7 @@ export interface BoxLabelPrintViewProps {
      */
     printedAt: string;
     boxesFailed?: boolean;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function BoxLabelPrintView({ boxes, printedAt, boxesFailed, }: BoxLabelPrintViewProps): import("react").JSX.Element;
+export declare function BoxLabelPrintView({ boxes, printedAt, boxesFailed, pageRegionCards, }: BoxLabelPrintViewProps): import("react").JSX.Element;

package/dist/features/print/components/BoxLabelPrintView.js

@@ -26,7 +26,8 @@ import { FieldCheckbox } from "../../../ui/forms/FieldCheckbox.js";
 import { BoxContentsSheet, BoxLabel, LabelPageStyle, LabelSheet, PrintScaleWarning, } from "./labels.js";
 import { LabelProfilePicker } from "./LabelProfilePicker.js";
 import { LABEL_PROFILES, documentPageCss, labelPageCss, } from "../../../_internal/shared/features/print/label-profiles.js";
-export function BoxLabelPrintView({ boxes, printedAt, boxesFailed = false, }) {
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
+export function BoxLabelPrintView({ boxes, printedAt, boxesFailed = false, pageRegionCards = [], }) {
     const [mode, setMode] = useState("labels");
     /*
      * 100 x 50 mm by default, not the 50 x 25 used for products. A box label is
@@ -51,7 +52,7 @@ export function BoxLabelPrintView({ boxes, printedAt, boxesFailed = false, }) {
      * so the warning is about the worst label in the batch rather than the first.
      */
     const longestCodeLength = useMemo(() => chosen.reduce((n, b) => Math.max(n, b.code.length + 4), 0), [chosen]);
-    return (_jsxs(Stack, { gap: "md", padding: "md", children: [_jsx(LabelPageStyle, { css: mode === "labels" ? labelPageCss(profile) : documentPageCss() }), _jsxs(Stack, { className: "no-print", gap: "sm", children: [_jsx(Heading, { level: 1, size: "2xl", children: "Print box labels" }), boxesFailed && (_jsx(Alert, { variant: "warning", children: "Could not load the box list. It is unknown, not empty \u2014 reload before printing, or you will print a subset without knowing it." })), _jsxs(Row, { gap: "xs", children: [_jsx(Button, { variant: mode === "labels" ? "primary" : "secondary", size: "sm", onClick: () => setMode("labels"), children: "Box labels" }), _jsx(Button, { variant: mode === "contents" ? "primary" : "secondary", size: "sm", onClick: () => setMode("contents"), children: "Contents sheets (A4)" })] }), mode === "labels" && (_jsxs(_Fragment, { children: [_jsx(LabelProfilePicker, { value: profileId, onChange: setProfileId, longestCodeLength: longestCodeLength }), _jsx(PrintScaleWarning, {})] })), boxes.length === 0 ? (_jsx(Text, { color: "muted", children: "No boxes registered yet. A box exists here because someone labelled a real one, so an empty list on a fresh install is correct." })) : (_jsx(Stack, { gap: "xs", children: boxes.map((b) => (_jsx(FieldCheckbox, { name: `box-${b.id}`, label: `${b.code}${b.location ? ` — ${b.location}` : ""}`, checked: selected.has(b.id), onChange: () => toggle(b.id) }, b.id))) })), _jsxs(Row, { gap: "sm", align: "center", wrap: true, children: [_jsxs(Button, { disabled: chosen.length === 0, onClick: () => window.print(), children: ["Print ", chosen.length > 0 ? `${chosen.length} selected` : "selected"] }), boxes.length > 0 && (_jsx(Button, { variant: "ghost", onClick: () => setSelected(selected.size === boxes.length
+    return (_jsxs(Stack, { gap: "md", padding: "md", children: [_jsx(LabelPageStyle, { css: mode === "labels" ? labelPageCss(profile) : documentPageCss() }), _jsxs(Stack, { className: "no-print", gap: "sm", children: [_jsx(Heading, { level: 1, size: "2xl", children: "Print box labels" }), _jsx(AdminComposableRegion, { pageId: "admin-inventory-boxes-labels", initialCards: pageRegionCards }), boxesFailed && (_jsx(Alert, { variant: "warning", children: "Could not load the box list. It is unknown, not empty \u2014 reload before printing, or you will print a subset without knowing it." })), _jsxs(Row, { gap: "xs", children: [_jsx(Button, { variant: mode === "labels" ? "primary" : "secondary", size: "sm", onClick: () => setMode("labels"), children: "Box labels" }), _jsx(Button, { variant: mode === "contents" ? "primary" : "secondary", size: "sm", onClick: () => setMode("contents"), children: "Contents sheets (A4)" })] }), mode === "labels" && (_jsxs(_Fragment, { children: [_jsx(LabelProfilePicker, { value: profileId, onChange: setProfileId, longestCodeLength: longestCodeLength }), _jsx(PrintScaleWarning, {})] })), boxes.length === 0 ? (_jsx(Text, { color: "muted", children: "No boxes registered yet. A box exists here because someone labelled a real one, so an empty list on a fresh install is correct." })) : (_jsx(Stack, { gap: "xs", children: boxes.map((b) => (_jsx(FieldCheckbox, { name: `box-${b.id}`, label: `${b.code}${b.location ? ` — ${b.location}` : ""}`, checked: selected.has(b.id), onChange: () => toggle(b.id) }, b.id))) })), _jsxs(Row, { gap: "sm", align: "center", wrap: true, children: [_jsxs(Button, { disabled: chosen.length === 0, onClick: () => window.print(), children: ["Print ", chosen.length > 0 ? `${chosen.length} selected` : "selected"] }), boxes.length > 0 && (_jsx(Button, { variant: "ghost", onClick: () => setSelected(selected.size === boxes.length
                                     ? new Set()
                                     : new Set(boxes.map((b) => b.id))), children: selected.size === boxes.length ? "Clear all" : "Select all" }))] }), mode === "contents" && chosen.some((b) => !b.contents) && (
                     /*

package/dist/features/products/actions/product-actions.d.ts

@@ -17,22 +17,22 @@ export declare function listProducts(params?: ProductListActionParams): Promise<
 export declare function getProductById(id: string): Promise<ProductDocument | null>;
 export declare function getFeaturedProducts(pageSize?: number): Promise<ProductListResult>;
 /**
- * The soonest-ending LIVE auctions.
+ * The soonest-ending LIVE collector drops.
  *
- * This used to be `listingType==auction,status==published` sorted
- * `auctionEndDate ASC` with no lower bound — and ascending order front-loads
- * the OLDEST end dates, so the homepage's "Live Auctions" strip led with the
+ * This used to be `listingType==collector-drop,status==published` sorted
+ * `collectorDropEndDate ASC` with no lower bound — and ascending order front-loads
+ * the OLDEST end dates, so the homepage's "Live Collector Drops" strip led with the
  * most-expired lots in the catalogue. Nothing about it was flagged as wrong
- * because an ended auction still renders as a perfectly normal card.
+ * because an ended collector drop still renders as a perfectly normal card.
  *
  * One listing type, sorted by the same field the scope filters on, means
- * `listPublicProducts` pushes `auctionEndDate >= now` into Firestore rather
+ * `listPublicProducts` pushes `collectorDropEndDate >= now` into Firestore rather
  * than filtering a bounded window in memory.
  */
-export declare function getFeaturedAuctions(pageSize?: number): Promise<ProductListResult>;
+export declare function getFeaturedCollectorDrops(pageSize?: number): Promise<ProductListResult>;
 export declare function getLatestProducts(pageSize?: number): Promise<ProductListResult>;
-export declare function getLatestAuctions(pageSize?: number): Promise<ProductListResult>;
-export declare function listAuctions(params?: ProductListActionParams): Promise<ProductListResult>;
+export declare function getLatestCollectorDrops(pageSize?: number): Promise<ProductListResult>;
+export declare function listCollectorDrops(params?: ProductListActionParams): Promise<ProductListResult>;
 /** Pre-orders still accepting orders, soonest delivery first. */
 export declare function getFeaturedPreOrders(pageSize?: number): Promise<ProductListResult>;
 export declare function getLatestPreOrders(pageSize?: number): Promise<ProductListResult>;

package/dist/features/products/actions/product-actions.js

@@ -1,5 +1,5 @@
-import { sieveAnd, sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
-import { sortBy } from "@mohasinac/appkit";
+import { SIEVE_OP, sieveAnd, sieveFilter } from "../../../utils/sieve-builder.js";
+import { sortBy } from "../../../constants/sort.js";
 import { listPublicProducts } from "../../../_internal/server/features/products/list-public.js";
 import { AVAILABILITY_VALUES, PRODUCT_FIELDS } from "../../../constants/field-names.js";
 import { productRepository } from "../repository/products.repository.js";
@@ -13,7 +13,7 @@ import { hidePublicTestData } from "../../../_internal/server/features/tester/vi
  * never emitted by code under our control any more.
  */
 const PUBLISHED_CLAUSE = sieveFilter("status", SIEVE_OP.EQ, "published");
-const AUCTIONS_PUBLISHED = sieveAnd(sieveFilter("listingType", SIEVE_OP.EQ, "auction"), PUBLISHED_CLAUSE);
+const COLLECTOR_DROPS_PUBLISHED = sieveAnd(sieveFilter("listingType", SIEVE_OP.EQ, "collector-drop"), PUBLISHED_CLAUSE);
 const PREORDERS_PUBLISHED = sieveAnd(sieveFilter("listingType", SIEVE_OP.EQ, "pre-order"), PUBLISHED_CLAUSE);
 export async function listProducts(params = {}) {
     const { filters, sorts = "-createdAt", page = 1, pageSize = 20, listingType, featured, storeId, categoriesIn, } = params;
@@ -68,9 +68,9 @@ function toListResult(result, pageSize) {
  * Featured items for the homepage's generic "Featured Products" strip.
  *
  * Scoped to `GENERIC_PRODUCT_LISTING_TYPES` for the same reason `/products` is:
- * the homepage already has dedicated Live Auctions, Pre-Orders and Prize Draws
+ * the homepage already has dedicated Live Collector Drops, Pre-Orders and Prize Draws
  * sections, so leaving this unscoped put the same item in two strips on one
- * page — and an auction rendered as a generic product card shows Buy-Now chrome
+ * page — and a collector drop rendered as a generic product card shows Buy-Now chrome
  * instead of bid affordances.
  */
 /**
@@ -107,23 +107,23 @@ export async function getFeaturedProducts(pageSize = 8) {
     }), pageSize);
 }
 /**
- * The soonest-ending LIVE auctions.
+ * The soonest-ending LIVE collector drops.
  *
- * This used to be `listingType==auction,status==published` sorted
- * `auctionEndDate ASC` with no lower bound — and ascending order front-loads
- * the OLDEST end dates, so the homepage's "Live Auctions" strip led with the
+ * This used to be `listingType==collector-drop,status==published` sorted
+ * `collectorDropEndDate ASC` with no lower bound — and ascending order front-loads
+ * the OLDEST end dates, so the homepage's "Live Collector Drops" strip led with the
  * most-expired lots in the catalogue. Nothing about it was flagged as wrong
- * because an ended auction still renders as a perfectly normal card.
+ * because an ended collector drop still renders as a perfectly normal card.
  *
  * One listing type, sorted by the same field the scope filters on, means
- * `listPublicProducts` pushes `auctionEndDate >= now` into Firestore rather
+ * `listPublicProducts` pushes `collectorDropEndDate >= now` into Firestore rather
  * than filtering a bounded window in memory.
  */
-export async function getFeaturedAuctions(pageSize = 6) {
+export async function getFeaturedCollectorDrops(pageSize = 6) {
     return toListResult(await listPublicProducts({
-        listingTypes: [PRODUCT_FIELDS.LISTING_TYPE_VALUES.AUCTION],
+        listingTypes: [PRODUCT_FIELDS.LISTING_TYPE_VALUES.COLLECTOR_DROP],
         availability: AVAILABILITY_VALUES.AVAILABLE,
-        sorts: sortBy(PRODUCT_FIELDS.AUCTION_END_DATE, "ASC"),
+        sorts: sortBy(PRODUCT_FIELDS.COLLECTOR_DROP_END_DATE, "ASC"),
         page: 1,
         pageSize,
         windowSize: featuredWindow(pageSize),
@@ -137,18 +137,18 @@ export async function getLatestProducts(pageSize = 12) {
         pageSize,
     });
 }
-export async function getLatestAuctions(pageSize = 12) {
+export async function getLatestCollectorDrops(pageSize = 12) {
     return productRepository.list({
-        filters: AUCTIONS_PUBLISHED,
+        filters: COLLECTOR_DROPS_PUBLISHED,
         sorts: sortBy("createdAt", "DESC"),
         page: 1,
         pageSize,
     });
 }
-export async function listAuctions(params = {}) {
-    const { filters, sorts = "auctionEndDate", page = 1, pageSize = 20 } = params;
+export async function listCollectorDrops(params = {}) {
+    const { filters, sorts = "collectorDropEndDate", page = 1, pageSize = 20 } = params;
     return productRepository.list({
-        filters: filters ? `${AUCTIONS_PUBLISHED},${filters}` : AUCTIONS_PUBLISHED,
+        filters: filters ? `${COLLECTOR_DROPS_PUBLISHED},${filters}` : COLLECTOR_DROPS_PUBLISHED,
         sorts,
         page,
         pageSize,

package/dist/features/products/api/[id]/route.js

@@ -20,7 +20,24 @@ import { storeRepository } from "../../../stores/repository/store.repository.js"
 // `onProductStockChange` Firebase Function (see functions/src/bundle-stock-sync.ts).
 import { sanitizeProductForPublic } from "../../utils/sanitize.js";
 import { printMetaSchema } from "../../schemas/index.js";
-import { isAdminUser, isModeratorUser } from "../../../auth/role-predicates.js";
+/*
+ * ── "Not the owner" is a PERMISSION question, not a role one ──────────────────
+ *
+ * These two gates read `isOwner || isModeratorUser(user) || isAdminUser(user)`
+ * until 2026-11-08. Folding `moderator` into `employee` (A9) made the middle
+ * term true for every employee, so editing and archiving ANY seller's listing
+ * widened to every employee account as a side effect of a role rename.
+ *
+ * Owner's decision: keep the fold, gate on an explicit permission. PATCH now
+ * asks for `admin:products:write` and DELETE for `admin:products:delete` — the
+ * keys that already name those powers and already appear in the admin grant UI,
+ * rather than a parallel `moderation:products` saying the same thing twice.
+ *
+ * `canModerateServer` reads the user document because the per-person grant is
+ * in `permissions[]` and never reaches the session cookie; it is called only
+ * after the cheap ownership test fails, so an owner pays no extra read.
+ */
+import { canModerateServer } from "../../../../_internal/server/features/auth/permissions.js";
 import { normalizeError } from "../../../../errors/normalize.js";
 const ERR_DB_NOT_REGISTERED = "Database provider not registered";
 const ERR_PRODUCT_NOT_FOUND = "Product not found";
@@ -115,23 +132,25 @@ export const PATCH = createRouteHandler({
         }
         const ownerStore = product.storeId ? await storeRepository.findByOwnerId(user?.uid ?? "") : null;
         const isOwner = !!ownerStore && ownerStore.id === product.storeId;
-        const isModerator = isModeratorUser(user);
-        const isAdmin = isAdminUser(user);
-        if (!isOwner && !isModerator && !isAdmin) {
+        const mayModerate = isOwner || (await canModerateServer(user?.uid, "products:moderate"));
+        if (!mayModerate) {
             return NextResponse.json({ success: false, error: "Not authorized to update this product" }, { status: 403 });
         }
-        // SB4 — once any prize in a prize-draw listing has been won, the listing
+        // SB4 — once any prize in a clearance listing has been won, the listing
         // is frozen. Sellers can no longer edit it; admins inherit the same lock
         // (anything they need to change should go through a new listing or a
         // dedicated remediation script).
         const prizeItems = product.prizeDrawItems ??
             [];
         const anyPrizeWon = prizeItems.some((it) => it?.isWon);
-        if (product.listingType === "prize-draw" &&
+        // "prize-draw" kept as a back-compat match for listings written before
+        // the clearance rename.
+        const listingTypeValue = product.listingType;
+        if ((listingTypeValue === "clearance" || listingTypeValue === "prize-draw") &&
             anyPrizeWon) {
             return NextResponse.json({
                 success: false,
-                error: "This prize-draw listing is locked because at least one prize has been revealed. Clone it into a new listing if you want to rerun the draw.",
+                error: "This clearance listing is locked because at least one prize has been revealed. Clone it into a new listing if you want to rerun the draw.",
             }, { status: 409 });
         }
         const updated = await repo.update(id, {
@@ -169,9 +188,11 @@ export const DELETE = createRouteHandler({
         }
         const ownerStore = product.storeId ? await storeRepository.findByOwnerId(user?.uid ?? "") : null;
         const isOwner = !!ownerStore && ownerStore.id === product.storeId;
-        const isModerator = isModeratorUser(user);
-        const isAdmin = isAdminUser(user);
-        if (!isOwner && !isModerator && !isAdmin) {
+        // DELETE asks for `products:remove` (`admin:products:delete`), not the
+        // PATCH key: archiving someone else's listing is a strictly larger power
+        // than editing it, and the two permissions already exist separately.
+        const mayModerate = isOwner || (await canModerateServer(user?.uid, "products:remove"));
+        if (!mayModerate) {
             return NextResponse.json({ success: false, error: "Not authorized to delete this product" }, { status: 403 });
         }
         await repo.update(id, {

package/dist/features/products/api/route.d.ts

@@ -19,8 +19,8 @@ import { NextResponse } from "next/server.js";
  *
  * It used to be an independent copy: its own `buildFilters`, its own
  * `validateSieveFilters`, and its own filter allowlist that omitted
- * `auctionEndDate` / `preOrderDeliveryDate` / `prizeRevealStatus` — so on this
- * path an ended auction could not be filtered out even by a caller that asked
+ * `collectorDropEndDate` / `preOrderDeliveryDate` / `prizeRevealStatus` — so on this
+ * path an ended collector drop could not be filtered out even by a caller that asked
  * for it, and an `inStock=true` became a raw `stockQuantity>0` pushed straight
  * into Firestore, the FAILED_PRECONDITION shape Root Cause #59 documents.
  * Two implementations of one query is the drift itself; there is now one.

package/dist/features/products/api/route.js

@@ -80,8 +80,8 @@ const productMutateSchema = z
  *
  * It used to be an independent copy: its own `buildFilters`, its own
  * `validateSieveFilters`, and its own filter allowlist that omitted
- * `auctionEndDate` / `preOrderDeliveryDate` / `prizeRevealStatus` — so on this
- * path an ended auction could not be filtered out even by a caller that asked
+ * `collectorDropEndDate` / `preOrderDeliveryDate` / `prizeRevealStatus` — so on this
+ * path an ended collector drop could not be filtered out even by a caller that asked
  * for it, and an `inStock=true` became a raw `stockQuantity>0` pushed straight
  * into Firestore, the FAILED_PRECONDITION shape Root Cause #59 documents.
  * Two implementations of one query is the drift itself; there is now one.
@@ -131,10 +131,17 @@ export async function GET(request) {
     }
 }
 // --- POST /api/products -------------------------------------------------------
-// Requires seller, moderator, or admin role.
+// Requires the seller or admin role.
 export const POST = createRouteHandler({
     auth: true,
-    roles: ["seller", "moderator", "admin"],
+    /*
+     * 🛑 Was ["seller", "moderator", "admin"]. `moderator` folds to `employee`
+     * inside `holdsAnyRole`, so naming it let every employee account CREATE
+     * listings — and with no `permission:` declared, this tuple was the only
+     * gate. Creating a listing is a seller act; an employee who genuinely needs
+     * to does it through the permission-gated admin products surface.
+     */
+    roles: ["seller", "admin"],
     schema: productMutateSchema,
     handler: async ({ body }) => {
         const payload = body;

package/dist/features/products/columns/productTableColumns.js

@@ -4,7 +4,7 @@ import { Div } from "../../../ui/components/Div.js";
 import { GatedPrice } from "../../../ui/components/GatedPrice.js";
 import { Row } from "../../../ui/components/Layout.js";
 import { Span } from "../../../ui/components/Typography.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { statusLabel } from "../../../ui/columns/cell-renderers.js";
 import { formatCurrency as defaultFormatCurrency } from "../../../utils/number.formatter.js";
 const __O = {