@mohasinac/appkit 4.71.0 → 4.72.0

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

@@ -0,0 +1,68 @@
+/**
+ * Giveaway feature shared types
+ *
+ * Used by both event-type giveaway and prize-draw-mode giveaway.
+ * Weight + price fields are server-only — never sent to client consumers.
+ */
+export class GiveawayError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "GiveawayError";
+    }
+}
+/**
+ * Compute the weight for a slot given its price.
+ * Lower price → higher weight → more likely to be selected.
+ * Weight is always at least 1 (never 0).
+ * For uniform pricing: all slots get weight 50.
+ */
+export function computeWeight(price, maxPrice) {
+    if (maxPrice === 0)
+        return 50;
+    return Math.max(1, Math.round((1 - price / maxPrice) * 99) + 1);
+}
+/**
+ * Cryptographically-random integer in [0, maxExclusive) via the Web Crypto
+ * API — available in both Node (globalThis.crypto, Node 19+) and browsers,
+ * unlike `node:crypto`'s `randomInt` which would leak a Node-only import
+ * into any client bundle that pulls in this shared types module.
+ */
+function secureRandomInt(maxExclusive) {
+    const buf = new Uint32Array(1);
+    crypto.getRandomValues(buf);
+    return buf[0] % maxExclusive;
+}
+/**
+ * Pick a slot using weighted random selection. Uses the Web Crypto API, not
+ * `Math.random()`, so the fairness claim shown to users (PrizeRevealModal's
+ * "provably fair" copy) is actually true for this path too.
+ * @throws {GiveawayError} GIVEAWAY_FULL when unclaimed is empty.
+ */
+export function pickWeightedSlot(unclaimed) {
+    if (unclaimed.length === 0) {
+        throw new GiveawayError("GIVEAWAY_FULL", "No unclaimed slots remain.");
+    }
+    const total = unclaimed.reduce((s, sl) => s + sl.weight, 0);
+    let r = secureRandomInt(total);
+    for (const sl of unclaimed) {
+        r -= sl.weight;
+        if (r < 0)
+            return sl;
+    }
+    return unclaimed[unclaimed.length - 1];
+}
+/**
+ * Assign weights to slots based on pricing mode.
+ * Returns a new array with weight populated on every slot.
+ */
+export function assignSlotWeights(config) {
+    if (config.pricingMode === "uniform") {
+        return config.slots.map((sl) => ({ ...sl, weight: 50 }));
+    }
+    const maxPrice = Math.max(...config.slots.map((sl) => sl.price), 0);
+    return config.slots.map((sl) => ({
+        ...sl,
+        weight: computeWeight(sl.price, maxPrice),
+    }));
+}

package/dist/features/grouped/components/GroupedListingDetailView.d.ts

@@ -13,9 +13,12 @@
 import React from "react";
 import { type GroupPickerMember } from "../../products/components/GroupMemberPicker";
 import type { GroupedListingDocument } from "../schemas/firestore";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface GroupedListingDetailViewProps {
     group: GroupedListingDocument;
     /** Members, already projected for public consumption. */
     members: GroupPickerMember[];
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function GroupedListingDetailView({ group, members }: GroupedListingDetailViewProps): React.JSX.Element;
+export declare function GroupedListingDetailView({ group, members, pageRegionCards }: GroupedListingDetailViewProps): React.JSX.Element;

package/dist/features/grouped/components/GroupedListingDetailView.js

@@ -4,10 +4,11 @@ import { Container, Stack } from "../../../ui/components/Layout.js";
 import { Div } from "../../../ui/components/Div.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Section } from "../../../ui/components/Semantic.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { GroupMemberPicker } from "../../products/components/GroupMemberPicker.js";
 import { readGroupRules } from "../../../_internal/shared/features/products/group-rules.js";
 import { RecordOwnerQuickActions } from "../../../features/admin/components/RecordOwnerQuickActions.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const __O = { hidden: "overflow-hidden" };
 /** Human label per theme — mirrors GROUP_THEME_TITLE on the carousel. */
 const THEME_LABEL = {
@@ -17,7 +18,7 @@ const THEME_LABEL = {
     set: "Complete the set",
     generic: "Grouped listing",
 };
-export function GroupedListingDetailView({ group, members }) {
+export function GroupedListingDetailView({ group, members, pageRegionCards = [] }) {
     return (_jsx(Section, { padding: "section", children: _jsx(Container, { children: _jsxs(Stack, { gap: "comfortable", children: [group.coverImage && (_jsx(Div, { className: `relative h-48 w-full md:h-64 ${__O.hidden}`, rounded: "xl", surface: "muted", children: _jsx(MediaImage, { src: group.coverImage, alt: group.title, size: "banner" }) })), _jsxs(Stack, { gap: "xs", children: [_jsx(Span, { size: "xs", color: "muted", transform: "uppercase", weight: "semibold", children: THEME_LABEL[group.groupTheme] }), _jsx(Heading, { level: 1, children: group.title }), _jsx(RecordOwnerQuickActions, { resource: "GROUP", recordId: String(group.id), placement: "detail", recordLabel: String(group.title), storeId: group.storeId ? String(group.storeId) : undefined }), group.description && (_jsx(Text, { color: "muted", children: group.description })), _jsxs(Text, { size: "sm", color: "muted", children: [members.length, " item", members.length === 1 ? "" : "s", " in this group"] })] }), members.length > 0 ? (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, size: "lg", children: "Pick what you want" }), _jsx(Text, { size: "sm", color: "muted", children: "Choose a quantity for each item \u2014 they'll go into your cart as a single line you can edit later." }), _jsx(GroupMemberPicker, { groupId: group.id, groupSource: "grouped-listing", members: members, 
                                 /*
                                  * Off the group document this view already loaded. The picker
@@ -25,5 +26,5 @@ export function GroupedListingDetailView({ group, members }) {
                                  * passing them here only changes WHEN the buyer learns a
                                  * selection is invalid — not whether it is refused.
                                  */
-                                rules: readGroupRules(group) })] })) : (_jsx(Text, { color: "muted", children: "Nothing in this group is available right now." }))] }) }) }));
+                                rules: readGroupRules(group) })] })) : (_jsx(Text, { color: "muted", children: "Nothing in this group is available right now." })), _jsx(AdminComposableRegion, { pageId: "groups-slug", initialCards: pageRegionCards })] }) }) }));
 }

package/dist/features/grouped/components/GroupedListingEditorView.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 type Scope = "admin" | "store";
 export interface GroupedListingEditorViewProps {
     scope: Scope;
@@ -11,8 +12,16 @@ export interface GroupedListingEditorViewProps {
      * seller file a group under someone else's store.
      */
     fixedStoreId?: string;
+    /**
+     * Page-region id for this screen (Phase 12) — required because this View
+     * is mounted from FOUR different routes (admin/store x new/edit), each
+     * with its own id.
+     */
+    pageId: string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
     onSaved?: (id: string) => void;
     onCancel?: () => void;
 }
-export declare function GroupedListingEditorView({ scope, groupId, fixedStoreId, onSaved, onCancel, }: GroupedListingEditorViewProps): React.JSX.Element;
+export declare function GroupedListingEditorView({ scope, groupId, fixedStoreId, pageId, pageRegionCards, onSaved, onCancel, }: GroupedListingEditorViewProps): React.JSX.Element;
 export {};

package/dist/features/grouped/components/GroupedListingEditorView.js

@@ -52,6 +52,7 @@ import { normalizeError } from "../../../errors/normalize.js";
 import { toUserMessage } from "../../../errors/error-display-map.js";
 import { ProductInlineSelect } from "../../seller/components/ProductInlineSelect.js";
 import { groupedListingFormSchema, } from "../schemas/grouped-listing-form.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const EMPTY = {
     title: "",
     description: "",
@@ -62,7 +63,7 @@ const EMPTY = {
     isActive: true,
     isFeatured: false,
 };
-export function GroupedListingEditorView({ scope, groupId, fixedStoreId, onSaved, onCancel, }) {
+export function GroupedListingEditorView({ scope, groupId, fixedStoreId, pageId, pageRegionCards = [], onSaved, onCancel, }) {
     const router = useRouter();
     const { showToast } = useToast();
     const isEdit = Boolean(groupId);
@@ -201,7 +202,7 @@ export function GroupedListingEditorView({ scope, groupId, fixedStoreId, onSaved
     if (isEdit && !existing.isLoading && !existing.data) {
         return (_jsx(EmptyState, { title: "Grouped listing not found", description: "This group may have been deleted, or the link may be wrong." }));
     }
-    return (_jsxs(Stack, { gap: "md", children: [needsStorePicker ? (_jsx(FieldSelect, { name: "storeId", label: "Store", required: true, value: storeId, onChange: setStoreId, options: [
+    return (_jsxs(Stack, { gap: "md", children: [_jsx(AdminComposableRegion, { pageId: pageId, initialCards: pageRegionCards }), needsStorePicker ? (_jsx(FieldSelect, { name: "storeId", label: "Store", required: true, value: storeId, onChange: setStoreId, options: [
                     { value: "", label: "Select a store…" },
                     ...(stores.data ?? []).map((s) => ({
                         value: s.id,

package/dist/features/grouped/schemas/index.d.ts

@@ -34,8 +34,8 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
     categorySlug: z.ZodOptional<z.ZodString>;
     createdBy: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    id: string;
     title: string;
+    id: string;
     slug: string;
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
@@ -57,8 +57,8 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
     storeId?: string | undefined;
     coverImage?: string | undefined;
 }, {
-    id: string;
     title: string;
+    id: string;
     slug: string;
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;

package/dist/features/history/repository/user-history.repository.d.ts

@@ -9,7 +9,7 @@
  * - re-visit semantics: removes existing entry for productId and unshifts new at position 0
  * - all mutations run inside a Firestore transaction (concurrent-write safe)
  */
-export type HistoryProductType = "product" | "auction" | "preorder" | "prize-draw";
+export type HistoryProductType = "product" | "collector-drop" | "preorder" | "clearance" | "auction" | "prize-draw";
 export interface HistoryItemSnapshot {
     title?: string;
     thumb?: string;

package/dist/features/history/utils/guest-history.d.ts

@@ -1,4 +1,4 @@
-export type GuestHistoryType = "product" | "auction" | "preorder" | "prize-draw";
+export type GuestHistoryType = "product" | "collector-drop" | "preorder" | "clearance" | "auction" | "prize-draw";
 export interface GuestHistoryItem {
     productId: string;
     productType: GuestHistoryType;

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

@@ -1,2 +1 @@
 export * from "./homepage-section-actions";
-export * from "./carousel-actions";

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

@@ -1,2 +1 @@
 export * from "./homepage-section-actions.js";
-export * from "./carousel-actions.js";

package/dist/features/homepage/api/carousel/route.d.ts

@@ -1,15 +1,21 @@
 /**
- * feat-homepage — Next.js App Router API handler (GET/POST /api/carousel)
+ * feat-homepage — Next.js App Router API handler (GET /api/carousel)
  *
  * Pure stub:
  * ```ts
  * // app/api/carousel/route.ts
- * export { carouselGET as GET, carouselPOST as POST } from "@mohasinac/feat-homepage";
+ * export { carouselGET as GET } from "@mohasinac/feat-homepage";
  * ```
+ *
+ * 🛑 No more POST here, and no more `carouselSlides` collection to read from.
+ * The hero carousel has no standalone slide document any more — every slide
+ * is one event with `showOnCarousel: true`, computed live by
+ * `getHeroCarouselSlides()`. This is the SAME function the SSR render in
+ * `MarketplaceHomepageView` calls; the two must never diverge into two
+ * implementations of "what shows on the homepage" again (that is exactly how
+ * the client-side refetch used to read an entirely different, ungated
+ * `db.getRepository("carouselSlides")` path than the SSR render did).
  */
 import { NextResponse } from "next/server.js";
-export declare function GET(request: Request): Promise<NextResponse>;
+export declare function GET(): Promise<NextResponse>;
 export { GET as carouselGET };
-export declare const carouselPOST: (request: Request, context?: {
-    params: Promise<Record<string, string>>;
-} | undefined) => Promise<Response>;

package/dist/features/homepage/api/carousel/route.js

@@ -1,81 +1,30 @@
 /**
- * feat-homepage — Next.js App Router API handler (GET/POST /api/carousel)
+ * feat-homepage — Next.js App Router API handler (GET /api/carousel)
  *
  * Pure stub:
  * ```ts
  * // app/api/carousel/route.ts
- * export { carouselGET as GET, carouselPOST as POST } from "@mohasinac/feat-homepage";
+ * export { carouselGET as GET } from "@mohasinac/feat-homepage";
  * ```
+ *
+ * 🛑 No more POST here, and no more `carouselSlides` collection to read from.
+ * The hero carousel has no standalone slide document any more — every slide
+ * is one event with `showOnCarousel: true`, computed live by
+ * `getHeroCarouselSlides()`. This is the SAME function the SSR render in
+ * `MarketplaceHomepageView` calls; the two must never diverge into two
+ * implementations of "what shows on the homepage" again (that is exactly how
+ * the client-side refetch used to read an entirely different, ungated
+ * `db.getRepository("carouselSlides")` path than the SSR render did).
  */
 import { NextResponse } from "next/server.js";
-import { z } from "zod";
-import { mediaUrlSchema } from "../../../../validation/schemas.js";
-import { getProviders } from "../../../../contracts/index.js";
-import { createRouteHandler } from "../../../../next/api/routeHandler.js";
-/** Read `__session` cookie from request headers (HTTP cookie string). */
+import { getHeroCarouselSlides } from "../../../../_internal/server/features/events/data.js";
 import { normalizeError } from "../../../../errors/normalize.js";
-function getSessionCookie(request) {
-    const cookieHeader = request.headers.get("cookie") ?? "";
-    const match = cookieHeader.match(/(?:^|;\s*)__session=([^;]+)/);
-    return match ? match[1] : null;
-}
-/** Returns the role from the session cookie, or null if invalid / no session provider. */
-async function getRoleFromSession(request) {
-    try {
-        const { session } = getProviders();
-        if (!session)
-            return null;
-        const cookie = getSessionCookie(request);
-        if (!cookie)
-            return null;
-        const payload = await session.verifySession(cookie);
-        return payload.role ?? null;
-    }
-    catch (_err) {
-        void normalizeError(_err);
-        return null;
-    }
-}
-const MAX_ACTIVE_SLIDES = 5;
 // --- GET /api/carousel --------------------------------------------------------
-export async function GET(request) {
+export async function GET() {
     try {
-        const url = new URL(request.url);
-        const includeInactive = url.searchParams.get("includeInactive") === "true";
-        // Admin auth guard for includeInactive
-        if (includeInactive) {
-            const role = await getRoleFromSession(request);
-            if (role !== "admin") {
-                return NextResponse.json({ success: false, error: "Admin access required" }, { status: 403 });
-            }
-        }
-        const { db } = getProviders();
-        if (!db) {
-            return NextResponse.json({ success: false, error: "Database provider not registered" }, { status: 503 });
-        }
-        const repo = db.getRepository("carouselSlides");
-        let slides;
-        if (includeInactive) {
-            const result = await repo.findAll({
-                sort: "order",
-                order: "asc",
-                pageSize: 100,
-            });
-            slides = result.data;
-        }
-        else {
-            const result = await repo.findAll({
-                filters: "active==true",
-                sort: "order",
-                order: "asc",
-                pageSize: MAX_ACTIVE_SLIDES,
-            });
-            slides = result.data.slice(0, MAX_ACTIVE_SLIDES);
-        }
+        const slides = await getHeroCarouselSlides();
         const response = NextResponse.json({ success: true, data: slides });
-        response.headers.set("Cache-Control", includeInactive
-            ? "private, no-cache"
-            : "public, max-age=300, s-maxage=600, stale-while-revalidate=120");
+        response.headers.set("Cache-Control", "public, max-age=300, s-maxage=600, stale-while-revalidate=120");
         return response;
     }
     catch (error) {
@@ -85,74 +34,3 @@ export async function GET(request) {
     }
 }
 export { GET as carouselGET };
-// ---------------------------------------------------------------------------
-// POST /api/carousel — create a new slide (admin only)
-// ---------------------------------------------------------------------------
-const carouselSlideCreateSchema = z
-    .object({
-    title: z.string().min(1).max(200),
-    order: z.number().int().min(0).optional(),
-    active: z.boolean().optional(),
-    media: z.object({
-        type: z.enum(["image", "video"]),
-        url: mediaUrlSchema,
-        alt: z.string(),
-        thumbnail: mediaUrlSchema.optional(),
-    }),
-    link: z
-        .object({
-        url: z.string().url(),
-        openInNewTab: z.boolean(),
-    })
-        .optional(),
-    mobileMedia: z
-        .object({
-        type: z.enum(["image", "video"]),
-        url: mediaUrlSchema,
-        alt: z.string(),
-    })
-        .optional(),
-    cards: z.array(z.object({}).passthrough()).optional(),
-    overlay: z.object({}).passthrough().optional(),
-})
-    .passthrough();
-export const carouselPOST = createRouteHandler({
-    auth: true,
-    roles: ["admin"],
-    schema: carouselSlideCreateSchema,
-    handler: async ({ body }) => {
-        const { db } = getProviders();
-        if (!db) {
-            return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });
-        }
-        const repo = db.getRepository("carouselSlides");
-        // Guard: max 5 active slides
-        const active = await repo.findAll({
-            filters: "active==true",
-            pageSize: MAX_ACTIVE_SLIDES + 1,
-        });
-        const incoming = body;
-        if (incoming.active !== false && active.data.length >= MAX_ACTIVE_SLIDES) {
-            return NextResponse.json({
-                success: false,
-                error: `Maximum ${MAX_ACTIVE_SLIDES} active slides allowed`,
-            }, { status: 409 });
-        }
-        const existing = await repo.findAll({
-            sort: "order",
-            order: "desc",
-            pageSize: 1,
-        });
-        const maxOrder = existing.data[0]?.order ?? -1;
-        const now = new Date().toISOString();
-        const created = await repo.create({
-            ...body,
-            order: body.order ?? maxOrder + 1,
-            active: incoming.active ?? false,
-            cards: body.cards ?? [],
-            createdAt: now,
-            updatedAt: now,
-        });
-        return NextResponse.json({ success: true, data: created }, { status: 201 });
-    },
-});

package/dist/features/homepage/components/AdSlot.js

@@ -7,7 +7,7 @@ import { useActiveAd } from "../hooks/useActiveAd.js";
 import { Anchor } from "../../../ui/components/Anchor.js";
 import { Div } from "../../../ui/components/Div.js";
 import { Span, Text } from "../../../ui/components/Typography.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 // ---------------------------------------------------------------------------
 // Sub-renderers
 // ---------------------------------------------------------------------------

package/dist/features/homepage/components/CTABannerSection.js

@@ -6,7 +6,7 @@ import { Icon } from "../../../ui/components/Icon.js";
 import { Row } from "../../../ui/components/Layout.js";
 import { Scrim } from "../../../ui/components/Scrim.js";
 import { Section } from "../../../ui/components/Semantic.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
 import { SECTION_TITLE, SECTION_COPY } from "../constants/section-copy.js";
 /**
@@ -27,7 +27,7 @@ const HEIGHT_PADDING_Y = {
 };
 export function CTABannerSection({ title = SECTION_TITLE.banner, eyebrow = SECTION_COPY.bannerEyebrow, subtitle, description, primaryLabel = SECTION_COPY.bannerPrimaryCta, primaryHref = String(ROUTES.PUBLIC.PRODUCTS), secondaryLabel = SECTION_COPY.bannerSecondaryCta, 
 // Pairs with SECTION_COPY.bannerSecondaryCta — see the note there for why
-// this banner must not default to /auctions.
+// this banner must not default to /collector-drops.
 secondaryHref = String(ROUTES.PUBLIC.CATEGORIES), height = "md", backgroundImage, className = "", }) {
     return (_jsxs(Section, { tone: "accent-banner", className: `relative ${className}`, overflow: "hidden", paddingY: HEIGHT_PADDING_Y[height], paddingX: "x-md", children: [backgroundImage && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: backgroundImage, alt: "", size: "banner", objectFit: "cover", fill: true }) }), _jsx(Scrim, { direction: "left-to-right", intensity: "strong", className: "absolute inset-0" })] })), _jsxs(Div, { className: "relative mx-auto max-w-3xl text-left", children: [_jsxs(Div, { layout: "inline-flex", align: "center", gap: "2", surface: "frost", rounded: "full", padding: "x-sm", className: "mb-4 py-[var(--appkit-space-1-5)] backdrop-blur-sm", children: [_jsx(Icon, { name: "deals", size: "sm", tone: "on-solid" }), _jsx(Span, { color: "inverse", size: "xs", weight: "semibold", transform: "uppercase", className: "tracking-[0.18em]", children: eyebrow })] }), _jsx(Heading, { color: "inverse", level: 2, mdSize: "3xl", lgSize: "4xl", size: "2xl", weight: "bold", children: title }), subtitle && (_jsx(Text, { color: "inverse-muted", className: "mt-3", size: "base", children: subtitle })), description && (_jsx(Text, { color: "inverse-muted", className: "mt-2 max-w-2xl", size: "sm", children: description })), _jsxs(Row, { className: "mt-8", align: "center", justify: "start", gap: "md", wrap: true, children: [_jsx(Link, { href: primaryHref, className: "inline-flex items-center rounded-full bg-white px-[var(--appkit-space-8)] py-[var(--appkit-space-3)] text-[length:var(--appkit-text-sm)] font-semibold text-primary-700 shadow-sm transition-all hover:bg-surface-hover hover:shadow-md focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-primary-600", children: primaryLabel }), secondaryHref && (_jsx(Link, { href: secondaryHref, className: "inline-flex items-center rounded-full border-2 border-white/80 px-[var(--appkit-space-8)] py-[var(--appkit-space-3)] text-[length:var(--appkit-text-sm)] font-semibold text-white transition-all hover:bg-white/10 focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-primary-600", children: secondaryLabel }))] })] })] }));
 }

package/dist/features/homepage/components/CollectionCardsSection.d.ts

@@ -23,9 +23,9 @@ export interface CollectionCardsSectionProps {
  * costs zero extra round-trips (Rule #6). Those three were chosen first
  * because they are the PERMANENT axes: populated independently of the
  * product catalogue's size, so a `collection-cards` section built from them
- * can never go empty the way a `"products"`/`"auctions"` entry could.
+ * can never go empty the way a `"products"`/`"collector-drops"` entry could.
  *
- * Every other entry type (`products`, `auctions`, `pre-orders`, `events`,
+ * Every other entry type (`products`, `collector drops`, `pre-orders`, `events`,
  * `blog-posts`, `reviews`) still renders the honest placeholder — a real
  * "not wired yet" state is correct here, not a bug to paper over with
  * fabricated data, and the earlier revision's "data wiring lands with the

package/dist/features/homepage/components/CollectionCardsSection.js

@@ -4,7 +4,7 @@ import { Container, Grid, Row, Stack } from "../../../ui/components/Layout.js";
 import { Div } from "../../../ui/components/Div.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Section } from "../../../ui/components/Semantic.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
 const DEFAULT_ITEMS_PER_ROW = 4;
 const DEFAULT_MAX_ITEMS = 12;
@@ -13,7 +13,7 @@ function entryLabel(entry) {
         return entry.label;
     switch (entry.type) {
         case "products": return "Products";
-        case "auctions": return "Auctions";
+        case "collector-drops": return "Collector Drops";
         case "pre-orders": return "Pre-orders";
         case "stores": return "Stores";
         case "events": return "Events";
@@ -33,9 +33,9 @@ function entryLabel(entry) {
  * costs zero extra round-trips (Rule #6). Those three were chosen first
  * because they are the PERMANENT axes: populated independently of the
  * product catalogue's size, so a `collection-cards` section built from them
- * can never go empty the way a `"products"`/`"auctions"` entry could.
+ * can never go empty the way a `"products"`/`"collector-drops"` entry could.
  *
- * Every other entry type (`products`, `auctions`, `pre-orders`, `events`,
+ * Every other entry type (`products`, `collector drops`, `pre-orders`, `events`,
  * `blog-posts`, `reviews`) still renders the honest placeholder — a real
  * "not wired yet" state is correct here, not a bug to paper over with
  * fabricated data, and the earlier revision's "data wiring lands with the

package/dist/features/homepage/components/CustomCardsSection.js

@@ -11,7 +11,7 @@ import { THEMED_TEXT_PRIMARY } from "../../../_internal/shared/styles/themed.js"
 /* Not re-exported from `ui/index` — import from the defining module (Root Cause #18). */
 import { Iframe } from "../../../ui/components/Iframe.js";
 import { SectionCarousel } from "./SectionCarousel.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 // --- Constants ---------------------------------------------------------------
 const CLS_CONTAINER = "w-full max-w-7xl mx-auto px-[var(--appkit-space-4)]";
 function isKeyChip(variant) {

package/dist/features/homepage/components/FeaturedCollectorDropsSection.d.ts

@@ -0,0 +1,18 @@
+import React from "react";
+import type { ProductItem } from "../../products/types";
+export interface FeaturedCollectorDropsSectionProps {
+    title?: string;
+    description?: string;
+    viewMoreHref?: string;
+    viewMoreLabel?: string;
+    className?: string;
+    filterByBrand?: string;
+    initialItems?: ProductItem[];
+    rows?: number;
+    /** Cap the rendered cards, mirroring FeaturedProductsSection. */
+    maxItems?: number;
+    autoScroll?: boolean;
+    scrollInterval?: number;
+    loop?: boolean;
+}
+export declare function FeaturedCollectorDropsSection({ title, description, viewMoreHref, viewMoreLabel, className, filterByBrand, initialItems, rows, maxItems, autoScroll, scrollInterval, loop, }: FeaturedCollectorDropsSectionProps): React.JSX.Element;

package/dist/features/homepage/components/FeaturedCollectorDropsSection.js

@@ -0,0 +1,12 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { SectionCarousel } from "./SectionCarousel.js";
+import { useFeaturedCollectorDrops } from "../hooks/useFeaturedCollectorDrops.js";
+import { MarketplaceCollectorDropCard } from "../../collector-drops/components/MarketplaceCollectorDropCard.js";
+import { CAROUSEL_PER_VIEW } from "../constants/carousel-per-view.js";
+import { SECTION_TITLE, VIEW_MORE_LABEL } from "../constants/section-copy.js";
+export function FeaturedCollectorDropsSection({ title = SECTION_TITLE.collectorDrops, description, viewMoreHref, viewMoreLabel = VIEW_MORE_LABEL.collectorDrops, className = "", filterByBrand, initialItems, rows = 1, maxItems, autoScroll = false, scrollInterval = 5000, loop = true, }) {
+    const { data: fetched = [], isLoading } = useFeaturedCollectorDrops({ filterByBrand, initialData: initialItems });
+    const items = maxItems && maxItems > 0 ? fetched.slice(0, maxItems) : fetched;
+    return (_jsx(SectionCarousel, { title: title, description: description, pillLabel: SECTION_TITLE.collectorDrops, headingVariant: "editorial", viewMoreHref: viewMoreHref, viewMoreLabel: viewMoreLabel, items: items, isLoading: isLoading, skeletonCount: 4, perView: CAROUSEL_PER_VIEW.standard, gap: 16, rows: Math.min(Math.max(rows, 1), 4), autoScroll: autoScroll, autoScrollInterval: scrollInterval, loop: loop, keyExtractor: (product) => product.id, renderItem: (product) => (_jsx(MarketplaceCollectorDropCard, { product: product })), className: className }));
+}

package/dist/features/homepage/components/GoogleReviewsSection.js

@@ -7,7 +7,7 @@ import { GRID_MAP, Row, Stack } from "../../../ui/components/Layout.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { HandModeRow } from "../../../ui/components/HandModeRow.js";
 import { Section } from "../../../ui/components/Semantic.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { siteSettingsRepository } from "../../admin/repository/site-settings.repository.js";
 import { fetchGoogleReviews } from "../lib/google-reviews-fetcher.js";
 const __P = {

package/dist/features/homepage/components/HeroCarousel.js

@@ -8,8 +8,8 @@ import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { Scrim } from "../../../ui/components/Scrim.js";
 import { Section } from "../../../ui/components/Semantic.js";
-import { MediaImage } from "../../media/MediaImage.js";
-import { MediaVideo } from "../../media/MediaVideo.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
+import { MediaVideo } from "../../../ui/components/MediaVideo.js";
 import { useHeroCarousel } from "../hooks/useHeroCarousel.js";
 import { POSITION_FILL, FLEX_CENTER, HERO_PLACEHOLDER_BG } from "../constants/hero-carousel-styles.js";
 /* The one carousel position/navigation control. The dot and arrow class
@@ -104,7 +104,7 @@ function SlideBackground({ bg, legacy, mobileLegacy, isMobile, priority, }) {
     if (effectiveBg.type === "video") {
         return (_jsxs(_Fragment, { children: [_jsx(MediaVideo, { src: src, thumbnailUrl: effectiveBg.thumbnail ?? legacy?.thumbnail, alt: "", autoPlayMuted: true, loop: true, controls: false }), effectiveBg.dimOverlay?.enabled && (_jsx(Div, { className: POSITION_FILL, style: { backgroundColor: `rgba(0,0,0,${(effectiveBg.dimOverlay.opacity ?? 0) / 100})` } }))] }));
     }
-    return (_jsxs(_Fragment, { children: [_jsx(MediaImage, { src: src, alt: "", size: "hero", objectFit: "cover", fill: true, priority: priority, fetchPriority: priority ? "high" : "low" }), effectiveBg.dimOverlay?.enabled && (_jsx(Div, { className: POSITION_FILL, style: { backgroundColor: `rgba(0,0,0,${(effectiveBg.dimOverlay.opacity ?? 0) / 100})` } }))] }));
+    return (_jsxs(_Fragment, { children: [_jsx(MediaImage, { src: src, alt: "", size: "hero", objectFit: "cover", fill: true, fallback: "", priority: priority, fetchPriority: priority ? "high" : "low" }), effectiveBg.dimOverlay?.enabled && (_jsx(Div, { className: POSITION_FILL, style: { backgroundColor: `rgba(0,0,0,${(effectiveBg.dimOverlay.opacity ?? 0) / 100})` } }))] }));
 }
 /** Renders the background of a card (image, video, color, gradient). */
 function CardBackground({ bg }) {
@@ -120,7 +120,8 @@ function CardBackground({ bg }) {
     if (bg.type === "image" && bg.url) {
         // `cover` for the same reason as the slide backdrop above — this sits
         // behind the card's eyebrow/title/description, not beside them.
-        return _jsx(MediaImage, { src: bg.url, alt: "", size: "card", objectFit: "cover", fill: true });
+        // `fallback=""` for the same reason too — see that comment.
+        return _jsx(MediaImage, { src: bg.url, alt: "", size: "card", objectFit: "cover", fill: true, fallback: "" });
     }
     return null;
 }
@@ -224,12 +225,12 @@ export function HeroCarousel({ initialSlides, push, height, defaultAutoplayDelay
         onMouseEnter: pauseOnHover ? () => setIsPaused(true) : undefined, onMouseLeave: pauseOnHover ? () => setIsPaused(false) : undefined, onFocus: () => setIsPaused(true), onBlur: () => setIsPaused(false), tabIndex: 0, children: [_jsx(Div, { "aria-live": "polite", "aria-atomic": "true", className: "sr-only", children: `Slide ${currentSlide + 1} of ${slides.length}` }), _jsx(Div, { className: POSITION_FILL, children: _jsx(Div, { layout: "flex", ref: slidesRef, onScroll: handleSlidesScroll, className: "h-full overflow-x-auto scroll-smooth snap-x snap-mandatory [scrollbar-width:none] [&::-webkit-scrollbar]:hidden", style: { gap: 0 }, children: slides.map((slide, slideIndex) => {
                         const slideHeightClass = getSlideHeightClass(slide.settings?.height);
                         const hasCards = slide.cards && slide.cards.length > 0;
-                        return (_jsxs(Div, { className: `snap-start flex-none w-full relative self-stretch bg-neutral-900 ${slideHeightClass}`, children: [_jsx(Div, { className: "absolute bottom-2 left-2 z-10", children: _jsx(OwnerQuickActions, { resource: "CAROUSEL", placement: "card", 
+                        return (_jsxs(Div, { className: `snap-start flex-none w-full relative self-stretch bg-neutral-900 ${slideHeightClass}`, children: [_jsx(Div, { className: "absolute bottom-2 left-2 z-10", children: _jsx(OwnerQuickActions, { resource: "EVENT", placement: "card", 
                                         /* Sits on the slide photograph — without this it renders
                                          * the light `surface-elevated` chip, a pale rounded box
                                          * floating on the artwork. `onMedia` selects the dark
                                          * translucent backdrop that variant exists for. */
-                                        onMedia: true, recordLabel: slide.title ?? `Slide ${slideIndex + 1}`, editHref: String(ROUTES.ADMIN.CAROUSEL_EDIT(slide.id)) }) }), _jsx(Div, { className: POSITION_FILL, children: _jsx(SlideBackground, { bg: slide.background, legacy: slide.media, mobileLegacy: slide.mobileMedia, isMobile: isMobile, priority: slideIndex === 0 }) }), slide.overlay && slide.overlay.enabled !== false && (_jsxs(Div, { layout: "flex-col", align: "start", justify: "center", className: `${POSITION_FILL} text-left md:px-[4rem] lg:px-[8rem]`, padding: "x-lg", children: [slide.overlay.subtitle && (_jsx(Text, { color: "inverse", shadow: "sm", className: "stagger-1 opacity-80 mb-1 md:mb-2 tracking-widest", mdSize: "sm", size: "xs", transform: "uppercase", children: slide.overlay.subtitle })), slide.overlay.title && (
+                                        onMedia: true, recordLabel: slide.title ?? `Slide ${slideIndex + 1}`, editHref: String(ROUTES.ADMIN.EVENTS_EDIT(slide.id)) }) }), _jsx(Div, { className: POSITION_FILL, children: _jsx(SlideBackground, { bg: slide.background, legacy: slide.media, mobileLegacy: slide.mobileMedia, isMobile: isMobile, priority: slideIndex === 0 }) }), slide.overlay && slide.overlay.enabled !== false && (_jsxs(Div, { layout: "flex-col", align: "start", justify: "center", className: `${POSITION_FILL} text-left md:px-[4rem] lg:px-[8rem]`, padding: "x-lg", children: [slide.overlay.subtitle && (_jsx(Text, { color: "inverse", shadow: "sm", className: "stagger-1 opacity-80 mb-1 md:mb-2 tracking-widest", mdSize: "sm", size: "xs", transform: "uppercase", children: slide.overlay.subtitle })), slide.overlay.title && (
                                         // level={2}, NOT 1. The welcome section above this
                                         // carousel owns the page's single <h1>; a carousel that
                                         // emits one <h1> per slide gives the document as many

package/dist/features/homepage/components/HomepageSectionBoundary.d.ts

@@ -4,7 +4,7 @@
  * The homepage renders ~26 independently-fetched sections. Before this existed,
  * a throw inside ANY one of them propagated to `[locale]/error.tsx` and replaced
  * the entire page with "Something went wrong" — which is exactly what one bad
- * import in `PrizeDrawsSection` did in production on 2026-08-26.
+ * import in `ClearanceSection` did in production on 2026-08-26.
  *
  * A section is not load-bearing for the page. Losing one should cost that strip
  * and nothing else, so the fallback renders NOTHING: a visitor sees a homepage

package/dist/features/homepage/components/HomepageSectionBoundary.js

@@ -5,7 +5,7 @@
  * The homepage renders ~26 independently-fetched sections. Before this existed,
  * a throw inside ANY one of them propagated to `[locale]/error.tsx` and replaced
  * the entire page with "Something went wrong" — which is exactly what one bad
- * import in `PrizeDrawsSection` did in production on 2026-08-26.
+ * import in `ClearanceSection` did in production on 2026-08-26.
  *
  * A section is not load-bearing for the page. Losing one should cost that strip
  * and nothing else, so the fallback renders NOTHING: a visitor sees a homepage

package/dist/features/homepage/components/MarketplaceHomepageView.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export type { MarketplaceHomepageViewAdSlots } from "../lib/section-renderer";
 export interface MarketplaceHomepageViewProps {
     adSlots?: import("../lib/section-renderer").MarketplaceHomepageViewAdSlots;
@@ -13,5 +14,7 @@ export interface MarketplaceHomepageViewProps {
      * renderer no longer hardcodes "LIR" or "LetItRip".
      */
     brand?: import("../lib/section-renderer").HomepageBrand;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onBannerDismiss, brand, }?: MarketplaceHomepageViewProps): Promise<React.JSX.Element>;
+export declare function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onBannerDismiss, brand, pageRegionCards, }?: MarketplaceHomepageViewProps): Promise<React.JSX.Element>;