@mohasinac/appkit 4.71.0 → 4.72.0

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

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
-import { sortBy } from "@mohasinac/appkit";
+import { SIEVE_OP, sieveFilter } from "../../../utils/sieve-builder.js";
+import { sortBy } from "../../../constants/sort.js";
 import { Div } from "../../../ui/components/Div.js";
 import { Main } from "../../../ui/components/Semantic.js";
 // Deep import, not the `ui` barrel and not `@mohasinac/appkit/client`: this is a
@@ -8,7 +8,10 @@ import { Main } from "../../../ui/components/Semantic.js";
 // client-reference proxy (Root Cause #76). Rendering it as JSX is the supported
 // boundary; importing it from its defining module is Root Cause #18.
 import { TopBannerPortal } from "../../../ui/components/TopBannerPortal.js";
-import { carouselRepository } from "../repository/carousel.repository.js";
+// The homepage hero carousel has no Firestore-backed slide collection — every
+// slide is one event with `showOnCarousel: true`, computed live. See
+// CLAUDE.md "Homepage Hero Carousel".
+import { getHeroCarouselSlides } from "../../../_internal/server/features/events/data.js";
 // Both are React.cache wrappers around a single repository call, shared with
 // other readers in the same request tree (the locale layout for settings,
 // page.tsx's FAQ JSON-LD for the FAQs). Importing the repositories directly
@@ -32,9 +35,9 @@ import { isListingTypeEnabled, isCategoryTypeEnabled, isBrowsePageEnabled, } fro
  * map always renders.
  */
 const HOMEPAGE_SECTION_LISTING_TYPE = {
-    auctions: "auction",
+    "collector-drops": "collector-drop",
     "pre-orders": "pre-order",
-    "prize-draws": "prize-draw",
+    "clearance": "clearance",
 };
 /**
  * The same idea for the CATEGORY types, added 2026-10-20.
@@ -106,7 +109,7 @@ const HOMEPAGE_SECTION_ROUTE = {
     reviews: String(ROUTES.PUBLIC.REVIEWS),
     "featured-bundles": String(ROUTES.PUBLIC.BUNDLES),
 };
-import { getFeaturedProducts, getFeaturedAuctions, getFeaturedPreOrders } from "../../products/actions/product-actions.js";
+import { getFeaturedProducts, getFeaturedCollectorDrops, getFeaturedPreOrders } from "../../products/actions/product-actions.js";
 import { listTopLevelCategories, listBrandCategories } from "../../categories/actions/category-actions.js";
 import { listFeaturedBundles } from "../../../_internal/server/features/bundles/data.js";
 import { listStores } from "../../stores/actions/store-query-actions.js";
@@ -114,24 +117,12 @@ import { toStoreListItem } from "../../../_internal/server/features/stores/adapt
 import { getFeaturedBlogPosts } from "../../blog/actions/blog-actions.js";
 import { listPublicEvents } from "../../events/actions/event-actions.js";
 import { getHomepageCoupons } from "../../../_internal/server/features/promotions/data.js";
-/**
- * Converts Firestore CarouselSlideDocument[] (Date fields) to the API-shaped
- * CarouselSlide[] (string dates) expected by HeroCarousel / useHeroCarousel.
- * The two types share all display-relevant fields; only createdAt/updatedAt
- * and internal-only fields (analytics, createdBy) diverge.
- */
-function toCarouselSlides(docs) {
-    return docs.map(({ createdAt, updatedAt, analytics: _analytics, createdBy: _createdBy, ...rest }) => ({
-        ...rest,
-        createdAt: createdAt instanceof Date ? createdAt.toISOString() : undefined,
-        updatedAt: updatedAt instanceof Date ? updatedAt.toISOString() : undefined,
-    }));
-}
-export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onBannerDismiss, brand, } = {}) {
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
+export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onBannerDismiss, brand, pageRegionCards = [], } = {}) {
     // Every read on this page is a RAIL: the homepage must still render when one
     // fails, but a failure has to be distinguishable from an empty catalogue —
     // that is exactly Root Cause #59, and safeRead is what records it.
-    const slides = await safeRead(() => carouselRepository.getActiveSlides(), {
+    const slides = await safeRead(() => getHeroCarouselSlides(), {
         route: "/", key: "homepage.carouselSlides", fallback: [],
     });
     // getSiteSettingsGlobal, not the repository directly — the locale layout and
@@ -198,11 +189,11 @@ export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onB
         ? undefined
         : siteSettings?.announcementBar?.link;
     // A homepage section must not advertise a listing type the site does not
-    // offer. This gate previously read `featureFlags.{auctions,preOrders,events,
+    // offer. This gate previously read `featureFlags.{collector drops,preOrders,events,
     // blog}`; that group was deleted on 2026-08-29, and only the listing-type
     // half of it had a real successor (`settings.listings.listingTypes`).
     //
-    // So auctions / pre-orders / prize-draws are gated by the same control that
+    // So collector drops / pre-orders / prize-draws are gated by the same control that
     // hides them on every other surface, `featured-bundles` joined them on
     // 2026-10-20 via the category-type half of the same setting, and the
     // `events` / `blog` / `event-raffles` sections stay unconditional — there is
@@ -279,13 +270,13 @@ export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onB
     }));
     // Determine which data-driven section types are active so we only fetch what's needed
     const activeTypes = new Set(orderedSections.map((s) => s.type));
-    const [productsResult, auctionsResult, preOrdersResult, categoriesResult, brandsResult, bundlesResult, storesResult, blogResult, eventsResult, couponsResult,] = await Promise.all([
+    const [productsResult, collectorDropsResult, preOrdersResult, categoriesResult, brandsResult, bundlesResult, storesResult, blogResult, eventsResult, couponsResult,] = await Promise.all([
         // No `.catch(() => null)` on these three: they go through
         // `listPublicProducts`, which already logs a failed query loudly and
         // returns an empty result. Swallowing here would make a broken query
         // indistinguishable from an empty catalogue (Root Cause #59).
         activeTypes.has("products") ? getFeaturedProducts(12) : null,
-        activeTypes.has("auctions") ? getFeaturedAuctions(12) : null,
+        activeTypes.has("collector-drops") ? getFeaturedCollectorDrops(12) : null,
         activeTypes.has("pre-orders") ? getFeaturedPreOrders(12) : null,
         // `welcome` is a second trigger, not a typo: its hero mosaic is built from
         // these categories' cover images. Gating the fetch on `categories` alone
@@ -325,8 +316,8 @@ export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onB
         products: productsResult?.items?.length
             ? productsResult.items
             : undefined,
-        auctions: auctionsResult?.items?.length
-            ? auctionsResult.items
+        collectorDrops: collectorDropsResult?.items?.length
+            ? collectorDropsResult.items
             : undefined,
         preOrders: preOrdersResult?.items?.length
             ? preOrdersResult.items
@@ -364,16 +355,16 @@ export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onB
      * The same "do not advertise what we do not sell" rule the section filter
      * above applies, one level deeper.
      *
-     * `enabledSections` is keyed on `SectionType`, so it can drop the auctions
+     * `enabledSections` is keyed on `SectionType`, so it can drop the collector drops
      * RAIL but is structurally blind to a carousel — a carousel is one section
      * of type `carousel` whatever its slides happen to be about. With
-     * `auction: false` live, the hero still shipped a "Live auctions" card and a
-     * full "Win it at your price" slide, both pointing at `/auctions`.
+     * `collector drop: false` live, the hero still shipped a "Live collector drops" card and a
+     * full "Win it at your price" slide, both pointing at `/collector-drops`.
      *
      * Gated on the LINK rather than the copy: "Win it at your price" names no
      * type, so a keyword scan would miss the worse of the two offenders while
      * eating innocent ones. See `slide-gating.ts`.
      */
-    const carouselSlides = gateCarouselSlides(toCarouselSlides(slides), closedSurfaces);
-    return (_jsx(Main, { children: _jsxs(Div, { className: "relative", children: [showAnnouncement ? (_jsx(TopBannerPortal, { children: _jsx(AnnouncementBar, { message: announcementMessage, link: announcementLink, onDismiss: onBannerDismiss }) })) : null, orderedSections.map((section) => renderSection(section, adSlots, newsletterFormSlot ?? null, faqItems, carouselSlides, liveStats, sectionData, brand))] }) }));
+    const carouselSlides = gateCarouselSlides(slides, closedSurfaces);
+    return (_jsx(Main, { children: _jsxs(Div, { className: "relative", children: [showAnnouncement ? (_jsx(TopBannerPortal, { children: _jsx(AnnouncementBar, { message: announcementMessage, link: announcementLink, onDismiss: onBannerDismiss }) })) : null, orderedSections.map((section) => renderSection(section, adSlots, newsletterFormSlot ?? null, faqItems, carouselSlides, liveStats, sectionData, brand, siteSettings)), _jsx(AdminComposableRegion, { pageId: "home", initialCards: pageRegionCards })] }) }));
 }

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

@@ -8,7 +8,7 @@ import { HorizontalScroller } from "../../../ui/components/HorizontalScroller.js
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { Section } from "../../../ui/components/Semantic.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { CAROUSEL_PER_VIEW } from "../constants/carousel-per-view.js";
 import { useHandMode } from "../../../_internal/client/hand-mode/index.js";
 const __O = {

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

@@ -12,7 +12,7 @@ import { POSTER_CLASS } from "../../../ui/components/PosterCard.js";
 import { Row } from "../../../ui/components/Layout.js";
 import { Section } from "../../../ui/components/Semantic.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
-import { resolveMediaUrl } from "../../../utils/media-url.js";
+import { resolveMediaUrl, SEED_TILE_PREFIX } from "../../../utils/media-url.js";
 import { useTopCategories } from "../hooks/useTopCategories.js";
 import { CAROUSEL_PER_VIEW } from "../constants/carousel-per-view.js";
 function isImageUrl(s) {
@@ -34,7 +34,17 @@ function isImageUrl(s) {
 function CategoryChip({ category }) {
     const iconSrc = category.display?.icon;
     const coverImage = category.display?.coverImage;
-    const resolvedCover = coverImage && isImageUrl(coverImage) ? resolveMediaUrl(coverImage) : undefined;
+    /*
+     * 🛑 `SEED_TILE_PREFIX` covers are flat placeholder SVGs `seedPhoto()`
+     * writes when a category has no real artwork — same rule `WelcomeSection`'s
+     * mosaic already applies (`section-renderer.tsx`'s `heroImages` filter).
+     * Without this, a category with no real cover rendered a coloured
+     * rectangle as if it were a photograph; dropping it falls through to the
+     * existing no-image state below (emoji + name + count, no `<Image>` block).
+     */
+    const resolvedCover = coverImage && isImageUrl(coverImage) && !coverImage.startsWith(SEED_TILE_PREFIX)
+        ? resolveMediaUrl(coverImage)
+        : undefined;
     const productCount = category.metrics?.totalProductCount ?? category.metrics?.productCount ?? 0;
     /*
      * `display.icon` holds an EMOJI in the seed and a URL in other writers —

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

@@ -3,7 +3,7 @@ import { Anchor } from "../../../ui/components/Anchor.js";
 import { Div } from "../../../ui/components/Div.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { Span, Text } from "../../../ui/components/Typography.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 const __P = {
     p3: "p-[var(--appkit-space-3)]",
 };

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

@@ -11,7 +11,17 @@ const CARD_DELAYS = ["delay-0", "delay-100", "delay-200", "delay-300", "delay-[4
 // --- Single cards-variant card -----------------------------------------------
 function TrustFeatureCard({ item, visible, delayClass, }) {
     return (_jsxs(Div, { className: [
-            "flex flex-col items-start text-left p-[var(--appkit-space-4)]",
+            /*
+             * 🛑 Centered below `sm`, left-aligned at `sm` and up. `Grid
+             * cols="statTiles"` collapses to a single column on mobile, where
+             * a left-aligned icon+title+description tile floats at the left
+             * edge of the full-width row with empty space beside it — reading
+             * as unfinished. Centering it on the single-column breakpoint only
+             * (owner's own ask) is the fix; at `sm`+, each tile owns its own
+             * grid column, where left-align reads correctly.
+             */
+            // audit-content-alignment-ok: mobile-only (below sm) centering of a stacked icon+title+description tile, explicitly requested by the owner from a live screenshot — not marketing-copy centering the site-wide convention guards against; sm:+ stays left-aligned per that convention.
+            "flex flex-col items-center text-center sm:items-start sm:text-left p-[var(--appkit-space-4)]",
             "transition-all duration-500",
             delayClass,
             visible ? "opacity-100 translate-y-0" : "opacity-0 translate-y-4",

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

@@ -36,8 +36,8 @@ export type { ShopByCategorySectionProps } from "./ShopByCategorySection";
 export { ShopByCategorySection } from "./ShopByCategorySection";
 export type { FeaturedProductsSectionProps } from "./FeaturedProductsSection";
 export { FeaturedProductsSection } from "./FeaturedProductsSection";
-export type { FeaturedAuctionsSectionProps } from "./FeaturedAuctionsSection";
-export { FeaturedAuctionsSection } from "./FeaturedAuctionsSection";
+export type { FeaturedCollectorDropsSectionProps } from "./FeaturedCollectorDropsSection";
+export { FeaturedCollectorDropsSection } from "./FeaturedCollectorDropsSection";
 export type { FeaturedPreOrdersSectionProps } from "./FeaturedPreOrdersSection";
 export { FeaturedPreOrdersSection } from "./FeaturedPreOrdersSection";
 export type { FeaturedStoresSectionProps } from "./FeaturedStoresSection";

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

@@ -17,7 +17,7 @@ export { WhatsAppCommunitySection } from "./WhatsAppCommunitySection.js";
 export { AnnouncementBar, hashBannerMessage } from "./AnnouncementBar.js";
 export { ShopByCategorySection } from "./ShopByCategorySection.js";
 export { FeaturedProductsSection } from "./FeaturedProductsSection.js";
-export { FeaturedAuctionsSection } from "./FeaturedAuctionsSection.js";
+export { FeaturedCollectorDropsSection } from "./FeaturedCollectorDropsSection.js";
 export { FeaturedPreOrdersSection } from "./FeaturedPreOrdersSection.js";
 export { FeaturedStoresSection } from "./FeaturedStoresSection.js";
 export { EventsSection } from "./EventsSection.js";

package/dist/features/homepage/constants/carousel.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `HeroCarousel` renders the first `MAX_ACTIVE_SLIDES` slides it is given and
+ * silently ignores the rest. Every producer of the hero slide list — the live
+ * events→slides computation (`getHeroCarouselSlides`), the public
+ * `GET /api/carousel` handler — must cap against this same constant so a
+ * truncation decision is made once, not re-guessed per call site.
+ */
+export declare const MAX_ACTIVE_SLIDES: 5;

package/dist/features/homepage/constants/carousel.js

@@ -0,0 +1,8 @@
+/**
+ * `HeroCarousel` renders the first `MAX_ACTIVE_SLIDES` slides it is given and
+ * silently ignores the rest. Every producer of the hero slide list — the live
+ * events→slides computation (`getHeroCarouselSlides`), the public
+ * `GET /api/carousel` handler — must cap against this same constant so a
+ * truncation decision is made once, not re-guessed per call site.
+ */
+export const MAX_ACTIVE_SLIDES = 5;

package/dist/features/homepage/constants/section-copy.d.ts

@@ -30,7 +30,7 @@ export declare const SECTION_TITLE: {
     readonly welcome: "Discover Amazing Products";
     readonly categories: "Shop by Category";
     readonly products: "Featured Products";
-    readonly auctions: "Live Auctions";
+    readonly collectorDrops: "Live Collector Drops";
     readonly preOrders: "Reserve Before It Ships";
     readonly stores: "Featured Stores";
     readonly events: "Events & Offers";
@@ -54,7 +54,7 @@ export declare const SECTION_TITLE: {
 export declare const VIEW_MORE_LABEL: {
     readonly categories: "All categories →";
     readonly products: "View all products →";
-    readonly auctions: "View all auctions →";
+    readonly collectorDrops: "View all collector drops →";
     readonly preOrders: "View all pre-orders →";
     readonly stores: "View all stores →";
     readonly events: "View all events →";

package/dist/features/homepage/constants/section-copy.js

@@ -30,7 +30,7 @@ export const SECTION_TITLE = {
     welcome: "Discover Amazing Products",
     categories: "Shop by Category",
     products: "Featured Products",
-    auctions: "Live Auctions",
+    collectorDrops: "Live Collector Drops",
     preOrders: "Reserve Before It Ships",
     stores: "Featured Stores",
     events: "Events & Offers",
@@ -54,7 +54,7 @@ export const SECTION_TITLE = {
 export const VIEW_MORE_LABEL = {
     categories: "All categories →",
     products: "View all products →",
-    auctions: "View all auctions →",
+    collectorDrops: "View all collector drops →",
     preOrders: "View all pre-orders →",
     stores: "View all stores →",
     events: "View all events →",
@@ -72,10 +72,10 @@ export const SECTION_COPY = {
     featuresLearnMore: "Learn about our security →",
     bannerPrimaryCta: "Shop All Products →",
     /*
-     * 🛑 Not "Browse Auctions →". The CTA banner is NOT in
-     * `HOMEPAGE_SECTION_LISTING_TYPE`, so unlike the auctions rail it is never
+     * 🛑 Not "Browse Collector Drops →". The CTA banner is NOT in
+     * `HOMEPAGE_SECTION_LISTING_TYPE`, so unlike the collector drops rail it is never
      * gated — it renders whatever this says on a site running
-     * `listings.listingTypes.auction: false`, which is a button on the homepage
+     * `listings.listingTypes.collector-drop: false`, which is a button on the homepage
      * leading to a browse page with nothing in it. The `secondaryHref` default in
      * CTABannerSection.tsx moved with it; they are one control in two files.
      */

package/dist/features/homepage/hooks/homepage-query.js

@@ -1,6 +1,6 @@
 /*
  * WHY: The three homepage listing hooks each hand-wrote a pre-URL-encoded
- *      `filters=` Sieve string — `listingType%3D%3Dauction%2Cstatus%3D%3D…`.
+ *      `filters=` Sieve string — `listingType%3D%3Dcollector-drop%2Cstatus%3D%3D…`.
  *      Unreadable, unreviewable, and each one silently omitted any liveness
  *      bound, so all three showed sold-out / ended / closed rows. Worse, they
  *      run AFTER the SSR paint and replace it, so a fix to the server half
@@ -16,7 +16,7 @@
  * @tag layer:hook
  * @tag pattern:none
  * @tag access:client
- * @tag consumers:useFeaturedAuctions,useFeaturedPreOrders,useFeaturedProducts
+ * @tag consumers:useFeaturedCollectorDrops,useFeaturedPreOrders,useFeaturedProducts
  * @tag sideEffects:none
  */
 import { AVAILABILITY_VALUES } from "../../../constants/field-names.js";

package/dist/features/homepage/hooks/useActiveAd.d.ts

@@ -19,7 +19,7 @@ export type ActiveAdRecord = {
  * H3 — fetch the slot's ad only once it is actually NEAR the viewport.
  *
  * 🛑 The gap this closes: every `<AdSlot>` called this on mount unconditionally
- * — four on the homepage alone, more on auctions/blog/promotions/search — so an
+ * — four on the homepage alone, more on collector drops/blog/promotions/search — so an
  * ad slot at the bottom of a page a visitor never scrolls to still fired its
  * request on first paint. `/api/ads` is CDN-cached (`s-maxage=600`), so this was
  * never a Firestore-read problem; it is a wasted-request problem on exactly the

package/dist/features/homepage/hooks/useActiveAd.js

@@ -7,7 +7,7 @@ import { AD_ENDPOINTS } from "../../../constants/api-endpoints.js";
  * H3 — fetch the slot's ad only once it is actually NEAR the viewport.
  *
  * 🛑 The gap this closes: every `<AdSlot>` called this on mount unconditionally
- * — four on the homepage alone, more on auctions/blog/promotions/search — so an
+ * — four on the homepage alone, more on collector drops/blog/promotions/search — so an
  * ad slot at the bottom of a page a visitor never scrolls to still fired its
  * request on first paint. `/api/ads` is CDN-cached (`s-maxage=600`), so this was
  * never a Firestore-read problem; it is a wasted-request problem on exactly the

package/dist/features/homepage/hooks/useFeaturedCollectorDrops.d.ts

@@ -0,0 +1,15 @@
+import type { ProductItem } from "../../products/types";
+/**
+ * The soonest-ending LIVE collector drops, for the homepage strip.
+ *
+ * This runs 30s after the SSR paint and REPLACES it, so it has to ask the
+ * server exactly what `getFeaturedCollectorDrops` asked. It did not: both queries
+ * here were `listingType==collector-drop,status==published` with no end-date bound,
+ * hand-written as a raw pre-encoded `filters=` string. So even once the SSR
+ * half was fixed, the strip would have reverted to showing expired collector drops
+ * half a minute later (Root Cause #30).
+ */
+export declare function useFeaturedCollectorDrops(options?: {
+    filterByBrand?: string;
+    initialData?: ProductItem[];
+}): import("@tanstack/react-query").UseQueryResult<ProductItem[], Error>;

package/dist/features/homepage/hooks/useFeaturedCollectorDrops.js

@@ -0,0 +1,49 @@
+import { useQuery } from "@tanstack/react-query";
+import { apiClient } from "../../../http/index.js";
+import { PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { buildHomepageListingQuery, MIN_HOMEPAGE_COUNT } from "./homepage-query.js";
+import { sortBy } from "../../../constants/sort.js";
+import { PRODUCT_FIELDS } from "../../../constants/field-names.js";
+/**
+ * The soonest-ending LIVE collector drops, for the homepage strip.
+ *
+ * This runs 30s after the SSR paint and REPLACES it, so it has to ask the
+ * server exactly what `getFeaturedCollectorDrops` asked. It did not: both queries
+ * here were `listingType==collector-drop,status==published` with no end-date bound,
+ * hand-written as a raw pre-encoded `filters=` string. So even once the SSR
+ * half was fixed, the strip would have reverted to showing expired collector drops
+ * half a minute later (Root Cause #30).
+ */
+export function useFeaturedCollectorDrops(options) {
+    return useQuery({
+        queryKey: ["collector-drops", "featured", options?.filterByBrand ?? "all"],
+        initialData: options?.initialData,
+        queryFn: async () => {
+            const promotedRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?${buildHomepageListingQuery({
+                listingType: "collector-drop",
+                brand: options?.filterByBrand,
+                isPromoted: true,
+                sorts: sortBy(PRODUCT_FIELDS.COLLECTOR_DROP_END_DATE, "ASC"),
+                pageSize: 18,
+            })}`);
+            const promoted = promotedRes?.items ?? [];
+            if (promoted.length >= MIN_HOMEPAGE_COUNT)
+                return promoted;
+            const remaining = MIN_HOMEPAGE_COUNT - promoted.length;
+            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?${buildHomepageListingQuery({
+                listingType: "collector-drop",
+                brand: options?.filterByBrand,
+                sorts: sortBy(PRODUCT_FIELDS.COLLECTOR_DROP_END_DATE, "ASC"),
+                pageSize: remaining + promoted.length,
+            })}`);
+            const latest = latestRes?.items ?? [];
+            const existingIds = new Set(promoted.map((a) => a.id));
+            const filler = latest
+                .filter((a) => !existingIds.has(a.id))
+                .slice(0, remaining);
+            return [...promoted, ...filler];
+        },
+        staleTime: 30000,
+        gcTime: 2 * 60 * 1000,
+    });
+}

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

@@ -1,7 +1,7 @@
 export * from "./types";
 export * from "./hooks/useHeroCarousel";
 export * from "./hooks/useFeaturedProducts";
-export * from "./hooks/useFeaturedAuctions";
+export * from "./hooks/useFeaturedCollectorDrops";
 export * from "./hooks/useFeaturedPreOrders";
 export * from "./hooks/useTopCategories";
 export * from "./hooks/useTopBrands";

package/dist/features/homepage/index.js

@@ -1,7 +1,7 @@
 export * from "./types/index.js";
 export * from "./hooks/useHeroCarousel.js";
 export * from "./hooks/useFeaturedProducts.js";
-export * from "./hooks/useFeaturedAuctions.js";
+export * from "./hooks/useFeaturedCollectorDrops.js";
 export * from "./hooks/useFeaturedPreOrders.js";
 export * from "./hooks/useTopCategories.js";
 export * from "./hooks/useTopBrands.js";

package/dist/features/homepage/lib/section-gating.d.ts

@@ -7,7 +7,7 @@
  * `MarketplaceHomepageView` has three section gates and they are all keyed on
  * `SectionType`: `HOMEPAGE_SECTION_LISTING_TYPE`,
  * `HOMEPAGE_SECTION_CATEGORY_TYPE`, `HOMEPAGE_SECTION_BROWSE_PAGE`. They work,
- * and they are enough for a section that IS a surface — the auctions rail, the
+ * and they are enough for a section that IS a surface — the collector drops rail, the
  * categories rail, the stores rail.
  *
  * They cannot see a `custom-cards`, `promo-grid`, `banner`, `welcome` or

package/dist/features/homepage/lib/section-gating.js

@@ -7,7 +7,7 @@
  * `MarketplaceHomepageView` has three section gates and they are all keyed on
  * `SectionType`: `HOMEPAGE_SECTION_LISTING_TYPE`,
  * `HOMEPAGE_SECTION_CATEGORY_TYPE`, `HOMEPAGE_SECTION_BROWSE_PAGE`. They work,
- * and they are enough for a section that IS a surface — the auctions rail, the
+ * and they are enough for a section that IS a surface — the collector drops rail, the
  * categories rail, the stores rail.
  *
  * They cannot see a `custom-cards`, `promo-grid`, `banner`, `welcome` or

package/dist/features/homepage/lib/section-renderer.d.ts

@@ -2,6 +2,7 @@ import React from "react";
 import type { LiveStatsMap } from "./live-stats";
 import { AnnouncementBar, hashBannerMessage } from "../components/AnnouncementBar";
 import type { AttachedCoupon } from "../../promotions/constants/attached-coupons";
+import { type ContentFlagSnapshot } from "../../../_internal/shared/content/fragments";
 import type { CarouselSlide } from "../types/index";
 import type { HomepageSectionDocument } from "../schemas";
 import type { ProductItem } from "../../products/types";
@@ -12,7 +13,7 @@ import type { EventItem } from "../../events/types";
 import type { CategoryDocument } from "../../categories/schemas";
 export interface SectionData {
     products?: ProductItem[];
-    auctions?: ProductItem[];
+    collectorDrops?: ProductItem[];
     preOrders?: ProductItem[];
     stores?: StoreListItem[];
     categories?: CategoryItem[];
@@ -75,5 +76,5 @@ export interface HomepageBrand {
  * work that would make them real.
  */
 export type SectionSurface = "homepage" | "category" | "brand" | "product" | "store";
-export declare function renderSection(section: HomepageSectionDocument, adSlots: MarketplaceHomepageViewAdSlots | undefined, newsletterFormSlot: React.ReactNode, faqItems: FaqItem[], slides: CarouselSlide[], liveStats: LiveStatsMap, sectionData?: SectionData, brand?: HomepageBrand): React.ReactNode;
+export declare function renderSection(section: HomepageSectionDocument, adSlots: MarketplaceHomepageViewAdSlots | undefined, newsletterFormSlot: React.ReactNode, faqItems: FaqItem[], slides: CarouselSlide[], liveStats: LiveStatsMap, sectionData?: SectionData, brand?: HomepageBrand, settings?: ContentFlagSnapshot | null): React.ReactNode;
 export { AnnouncementBar, hashBannerMessage };

package/dist/features/homepage/lib/section-renderer.js

@@ -22,7 +22,7 @@ import { StatsCounterSection } from "../components/StatsCounterSection.js";
 import { TrustFeaturesSection } from "../components/TrustFeaturesSection.js";
 import { ShopByCategorySection } from "../components/ShopByCategorySection.js";
 import { FeaturedProductsSection } from "../components/FeaturedProductsSection.js";
-import { FeaturedAuctionsSection } from "../components/FeaturedAuctionsSection.js";
+import { FeaturedCollectorDropsSection } from "../components/FeaturedCollectorDropsSection.js";
 import { FeaturedPreOrdersSection } from "../components/FeaturedPreOrdersSection.js";
 import { FeaturedStoresSection } from "../components/FeaturedStoresSection.js";
 import { EventsSection } from "../components/EventsSection.js";
@@ -43,8 +43,9 @@ import { GoogleReviewsSection } from "../components/GoogleReviewsSection.js";
 // categoryType:"bundle" rows on the categories collection.
 import { FeaturedBundlesSection } from "../components/FeaturedBundlesSection.js";
 import { HomepageSectionBoundary } from "../components/HomepageSectionBoundary.js";
-import { PrizeDrawsSection } from "../../products/components/PrizeDrawsSection.js";
-import { EventRafflesSection } from "../../events/components/EventRafflesSection.js";
+import { resolveGovernedLink, } from "../../../_internal/shared/content/fragments.js";
+import { ClearanceSection } from "../../products/components/ClearanceSection.js";
+import { EventGiveawaysSection } from "../../events/components/EventGiveawaysSection.js";
 import { CollectionCardsSection } from "../components/CollectionCardsSection.js";
 import { HowItWorksSection } from "../components/HowItWorksSection.js";
 import { TestimonialsCarousel } from "../components/TestimonialsCarousel.js";
@@ -78,8 +79,17 @@ const SECTION_REGISTRY = {
     },
     welcome: {
         surfaces: ["homepage"],
-        render: ({ config, brand, sectionData }) => {
+        render: ({ config, brand, sectionData, settings }) => {
             const cfg = config;
+            // 1A-v-b `GovernedLink` — falls back to the pre-existing generic
+            // default (never a dead link) when the configured target is disabled.
+            const secondaryCta = resolveGovernedLink(cfg?.secondaryCtaText && cfg?.secondaryCtaLink
+                ? {
+                    label: cfg.secondaryCtaText,
+                    href: cfg.secondaryCtaLink,
+                    governs: cfg.secondaryCtaGoverns,
+                }
+                : undefined, { label: SECTION_COPY.welcomeSecondaryCta, href: ROUTES.PUBLIC.PRODUCTS }, settings);
             /*
              * Hero imagery, taken from the featured categories' own covers.
              *
@@ -112,7 +122,7 @@ const SECTION_REGISTRY = {
             return (_jsx(WelcomeSection, { heroImages: heroImages, brandCaption: brand?.heroCaption, title: cleanTitle(cfg?.h1) || SECTION_TITLE.welcome, 
                 // A real `subtitle` wins; `description` is the legacy source and is
                 // still parsed for documents that only carry it.
-                subtitle: cfg?.subtitle?.trim() || parseWelcomeDescription(cfg?.description), pillLabel: cfg?.pillLabel || SECTION_COPY.welcomePill, showCTA: cfg?.showCTA ?? true, ctaLabel: cfg?.ctaText || SECTION_COPY.welcomePrimaryCta, ctaHref: cfg?.ctaLink || ROUTES.PUBLIC.PRODUCTS, secondaryCtaLabel: cfg?.secondaryCtaText || SECTION_COPY.welcomeSecondaryCta, secondaryCtaHref: cfg?.secondaryCtaLink || ROUTES.PUBLIC.PRODUCTS, trustChips: [...WELCOME_TRUST_CHIPS], brandLogoText: brand?.shortName, brandTld: brand?.tld }));
+                subtitle: cfg?.subtitle?.trim() || parseWelcomeDescription(cfg?.description), pillLabel: cfg?.pillLabel || SECTION_COPY.welcomePill, showCTA: cfg?.showCTA ?? true, ctaLabel: cfg?.ctaText || SECTION_COPY.welcomePrimaryCta, ctaHref: cfg?.ctaLink || ROUTES.PUBLIC.PRODUCTS, secondaryCtaLabel: secondaryCta.label, secondaryCtaHref: secondaryCta.href, trustChips: [...WELCOME_TRUST_CHIPS], brandLogoText: brand?.shortName, brandTld: brand?.tld }));
         },
     },
     categories: {
@@ -168,11 +178,11 @@ const SECTION_REGISTRY = {
                 maxItems: cfg?.maxItems ?? cfg?.maxProducts, autoScroll: cfg?.autoScroll, scrollInterval: cfg?.scrollInterval, loop: cfg?.loop }));
         },
     },
-    auctions: {
+    "collector-drops": {
         surfaces: ["homepage", "category", "brand"],
         render: ({ config, sectionData }) => {
             const cfg = config;
-            return (_jsx(FeaturedAuctionsSection, { title: cleanTitle(cfg?.title) || SECTION_TITLE.auctions, description: cfg?.subtitle, viewMoreHref: ROUTES.PUBLIC.AUCTIONS, viewMoreLabel: cfg?.viewMoreLabel || VIEW_MORE_LABEL.auctions, filterByBrand: cfg?.filterByBrand, initialItems: sectionData.auctions, rows: cfg?.rows, maxItems: cfg?.maxAuctions, autoScroll: cfg?.autoScroll, scrollInterval: cfg?.scrollInterval, loop: cfg?.loop }));
+            return (_jsx(FeaturedCollectorDropsSection, { title: cleanTitle(cfg?.title) || SECTION_TITLE.collectorDrops, description: cfg?.subtitle, viewMoreHref: ROUTES.PUBLIC.COLLECTOR_DROPS, viewMoreLabel: cfg?.viewMoreLabel || VIEW_MORE_LABEL.collectorDrops, filterByBrand: cfg?.filterByBrand, initialItems: sectionData.collectorDrops, rows: cfg?.rows, maxItems: cfg?.maxCollectorDrops, autoScroll: cfg?.autoScroll, scrollInterval: cfg?.scrollInterval, loop: cfg?.loop }));
         },
     },
     "pre-orders": {
@@ -355,18 +365,18 @@ const SECTION_REGISTRY = {
             return (_jsx(FeaturedBundlesSection, { title: cleanTitle(cfg?.title) || SECTION_TITLE.featuredBundles, description: cfg?.subtitle, initialItems: sectionData.bundles, maxItems: cfg?.maxItems, showSavingsBadge: cfg?.showSavingsBadge, viewMoreLabel: cfg?.viewMoreLabel }));
         },
     },
-    "prize-draws": {
+    "clearance": {
         surfaces: ["homepage", "category", "brand"],
         render: ({ config }) => {
             const cfg = config;
-            return _jsx(PrizeDrawsSection, { config: cfg ?? {} });
+            return _jsx(ClearanceSection, { config: cfg ?? {} });
         },
     },
     "event-raffles": {
         surfaces: ["homepage"],
         render: ({ config }) => {
             const cfg = config;
-            return _jsx(EventRafflesSection, { config: cfg ?? {} });
+            return _jsx(EventGiveawaysSection, { config: cfg ?? {} });
         },
     },
     "collection-cards": {
@@ -419,7 +429,7 @@ const SECTION_REGISTRY = {
         },
     },
 };
-function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liveStats, sectionData, brand) {
+function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liveStats, sectionData, brand, settings) {
     const def = SECTION_REGISTRY[section.type];
     // No `default` arm left to fall through to — an unmapped `SectionType` is a
     // compile error on the registry object above, not a runtime `null`. This
@@ -435,10 +445,11 @@ function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liv
         liveStats,
         sectionData,
         brand,
+        settings,
     });
 }
-export function renderSection(section, adSlots, newsletterFormSlot, faqItems, slides, liveStats, sectionData = {}, brand) {
-    const sectionElement = renderSectionElement(section, newsletterFormSlot, faqItems, slides, liveStats, sectionData, brand);
+export function renderSection(section, adSlots, newsletterFormSlot, faqItems, slides, liveStats, sectionData = {}, brand, settings) {
+    const sectionElement = renderSectionElement(section, newsletterFormSlot, faqItems, slides, liveStats, sectionData, brand, settings);
     if (!sectionElement)
         return null;
     const adSlotKey = AD_SLOT_MAP[section.type];

package/dist/features/homepage/lib/slide-gating.d.ts

@@ -13,13 +13,13 @@
  * `MarketplaceHomepageView` already drops whole SECTIONS whose type maps to a
  * disabled listing type (`HOMEPAGE_SECTION_LISTING_TYPE`). That gate is keyed
  * on `SectionType`, so it can only see sections that ARE a listing type — the
- * auctions rail, the pre-orders rail.
+ * collector drops rail, the pre-orders rail.
  *
  * A carousel is one section of type `carousel` whatever it contains, and what
- * it contains is free-text authored content. With `auction: false` live, the
- * hero still shipped a "Live auctions — place a bid before the timer runs out"
+ * it contains is free-text authored content. With `collector drop: false` live, the
+ * hero still shipped a "Live collector drops — place a bid before the timer runs out"
  * card and a full-screen "Win it at your price" slide, both linking to
- * `/auctions`, which renders nothing. The section gate could not see either:
+ * `/collector-drops`, which renders nothing. The section gate could not see either:
  * the only thing identifying them is where they point.
  *
  * ## Deliberately link-based, not keyword-based
@@ -35,7 +35,7 @@
  * the survivors is NOT done here: the zone grid is a fixed `repeat(3, 1fr)`,
  * so there is no arrangement of two cards that fills it, and silently moving
  * an admin's card is a worse surprise than the gap. The seeded hero therefore
- * replaces its auction card with a real enabled type rather than relying on
+ * replaces its collector drop card with a real enabled type rather than relying on
  * this filter to tidy up after it — this is the safety net for content an
  * admin authors later, where the gap is a visible prompt to go and fix it.
  */