@mohasinac/appkit 4.55.0-next.0 → 4.56.0

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

@@ -352,6 +352,26 @@ export interface SiteSettingsDocument extends BaseDocument {
         phonepeEnabled: boolean;
         upiManualEnabled: boolean;
         codEnabled: boolean;
+        /**
+         * Cart total (rupees) ABOVE which cash on delivery is refused. Default
+         * 3000.
+         *
+         * 🛑 Measured against the CART TOTAL, not an item price. COD risk is the
+         * cash a courier carries and the value at stake on a refusal at the door,
+         * and neither cares how many lines the order has — a ₹2,000 item ordered
+         * three times is a ₹6,000 exposure exactly like one ₹6,000 item. Gating
+         * per item would pass that order straight through.
+         *
+         * 🛑 It is a MAXIMUM, so the comparison is `subtotal > value` — strictly
+         * greater. `otpCheckoutThreshold` beside it is a MINIMUM and fires
+         * at/above its value. Two money thresholds on one settings block with
+         * opposite senses is a genuine trap; the names carry it (`Max` vs
+         * `Threshold`) and both comparisons are spelled out at their call sites.
+         *
+         * `0` disables COD outright at any value, which is a real configuration
+         * rather than a bug — `undefined` is what means "no cap".
+         */
+        codMaxOrderValue?: number;
         /** Tier PP — cart total (rupees) at/above which checkout requires OTP verification. Applies to all payment methods except COD. Optional — falls back to no OTP gate when unset. */
         otpCheckoutThreshold?: number;
         /**
@@ -411,8 +431,13 @@ export interface SiteSettingsDocument extends BaseDocument {
         /** Razorpay gateway cost % (absorbed by platform, not passed through separately). */
         gatewayFeePercent: number;
         codDepositPercent: number;
-        /** COD handling fee charged to the buyer: max(codHandlingFeeMin, subtotal × codHandlingFeePercent / 100). */
-        codHandlingFeeMin: number;
+        /**
+         * COD handling fee charged to the buyer:
+         * min(subtotal × codHandlingFeePercent / 100, codHandlingFeeCap).
+         *
+         * 🛑 A CEILING. It was `codHandlingFeeMin` applied as a floor, which billed
+         * ₹2,000 of "handling" on a ₹20,000 order — see `computeCodHandlingFee`.
+         */ codHandlingFeeCap: number;
         codHandlingFeePercent: number;
         /** Admin master toggle — whether the gift-wrap addon is offered at checkout at all. */
         giftWrapFeeEnabled: boolean;
@@ -793,6 +818,16 @@ export declare const SITE_SETTINGS_INDEXED_FIELDS: readonly [];
  * and switch the active default with `defaultLightThemeId` / `defaultDarkThemeId`.
  */
 export declare const DEFAULT_SITE_SETTINGS_THEME: SiteSettingsTheme;
+/**
+ * Cart total (rupees) above which cash on delivery is refused, when the
+ * settings document does not say.
+ *
+ * 🛑 ONE number, consumed by both the default document below and every reader
+ * that has to cope with a settings document written before the field existed.
+ * Two spellings of a money limit is how a cap ends up enforced at one value
+ * and displayed at another.
+ */
+export declare const COD_MAX_ORDER_VALUE_FALLBACK = 3000;
 export declare const DEFAULT_SITE_SETTINGS_DATA: Partial<SiteSettingsDocument>;
 /**
  * 🛑 DEAD, AND IT DISAGREES WITH THE REAL PROJECTION. Do not add to it.

package/dist/features/admin/schemas/firestore.js

@@ -224,6 +224,16 @@ export const DEFAULT_SITE_SETTINGS_THEME = {
     defaultLightThemeId: "default-light",
     defaultDarkThemeId: "default-dark",
 };
+/**
+ * Cart total (rupees) above which cash on delivery is refused, when the
+ * settings document does not say.
+ *
+ * 🛑 ONE number, consumed by both the default document below and every reader
+ * that has to cope with a settings document written before the field existed.
+ * Two spellings of a money limit is how a cap ends up enforced at one value
+ * and displayed at another.
+ */
+export const COD_MAX_ORDER_VALUE_FALLBACK = 3000;
 export const DEFAULT_SITE_SETTINGS_DATA = {
     id: "global",
     siteName: "My Store",
@@ -234,6 +244,7 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         phonepeEnabled: false,
         upiManualEnabled: true,
         codEnabled: true,
+        codMaxOrderValue: COD_MAX_ORDER_VALUE_FALLBACK,
         otpCheckoutThreshold: 5000,
         smsVerification: false,
         adminCheckoutBypass: false,
@@ -261,7 +272,7 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         platformFeeMax: 10,
         gatewayFeePercent: 2,
         codDepositPercent: 10,
-        codHandlingFeeMin: 200,
+        codHandlingFeeCap: 200,
         codHandlingFeePercent: 10,
         // The buyer add-ons ship ENABLED. They were `false`, which made
         // StoreAddonsPicker return null on both the cart and checkout, so a fresh

package/dist/features/auctions/components/AuctionDetailPageView.js

@@ -43,6 +43,7 @@ import { getGroupsWithItemsForProduct } from "../../../_internal/server/features
 import { SublistingCarouselSection } from "../../products/components/SublistingCarouselSection.js";
 import { isFinalSale } from "../../products/constants/final-sale.js";
 import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
+import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
 function toDescriptionHtml(raw) {
     if (!raw)
         return "";
@@ -235,6 +236,6 @@ export async function AuctionDetailPageView({ id, initialAuction, onPlaceBid, on
                             return (_jsx(CollapsibleBidHistory, { productId: String(product.id), initialData: bidsResult, currency: currency }));
                         }, renderRelated: () => {
                             const related = toRelatedAuctionCards(relatedDocs, product.id, new Date());
-                            return (_jsxs(Stack, { gap: "xl", children: [related.length > 0 && (_jsx(RelatedProducts, { labels: { title: "Similar Auctions" }, renderGrid: () => (_jsx(MarketplaceAuctionGrid, { auctions: related })) })), _jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand || undefined, storeLabel: storeName || undefined })] }));
+                            return (_jsxs(Stack, { gap: "xl", children: [related.length > 0 && (_jsx(RelatedProducts, { labels: { title: "Similar Auctions" }, renderGrid: () => (_jsx(MarketplaceAuctionGrid, { auctions: related })) })), _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 })] }));
                         } }), renderAuctionStoreReviews(storeId), onPlaceBid && (_jsx(AuctionBottomActions, { productId: String(product.id), currentBid: currentBid, startingBid: startingBid, tiers: bidIncrementTiers, minBidIncrementOverride: minBidIncrementOverride, currency: currency, isEnded: isEnded, auctionEndDate: endDate, buyNowPrice: buyNowPrice, bidCount: bidCount, tags: tags, onPlaceBid: onPlaceBid, onBuyNow: onBuyNow }))] })] }));
 }

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

@@ -84,6 +84,21 @@ export interface UserDocument extends BaseDocument {
     storeId?: string;
     storeSlug?: string;
     storeStatus?: "pending" | "approved" | "rejected";
+    /**
+     * Denormalised sum of this user's `pointsLedger` entries. 1 point = ₹1.
+     *
+     * 🛑 A MIRROR, and `pointsRepository` is the only thing allowed to write it —
+     * always in the same transaction as the ledger entry that moved it. Root
+     * Cause #42: a mirror maintained by more than one write path drifts, and this
+     * one guards money-shaped value, so drift either invents points or swallows
+     * earned ones.
+     *
+     * 🛑 Absence means "never computed", NOT zero. `getBalance` falls back to
+     * summing the ledger rather than answering 0, because every user document
+     * written before this field existed has no value here and answering zero
+     * would quietly deny people credits they hold.
+     */
+    pointsBalance?: number;
     isTester?: boolean;
     canTestAdmin?: boolean;
     publicProfile?: {

package/dist/features/cart/components/CartPriceBreakdown.js

@@ -21,5 +21,5 @@ export function CartPriceBreakdown({ preview, itemCount, currency = "INR", unava
     const subtotalLabel = itemCount !== undefined
         ? `Subtotal (${itemCount} item${itemCount !== 1 ? "s" : ""}${storeCount > 1 ? `, ${storeCount} stores` : ""})`
         : "Subtotal";
-    return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: subtotalLabel, amount: money(preview.subtotal) }), preview.shippingFee > 0 && (_jsx(Line, { label: withStoreCount("Shipping", storeCount), amount: money(preview.shippingFee) })), preview.codHandlingFee > 0 && (_jsx(Line, { label: "COD handling fee", amount: money(preview.codHandlingFee) })), preview.giftWrapFee > 0 && (_jsx(Line, { label: withStoreCount("Gift wrap", countCharged((s) => s.giftWrapFee)), amount: money(preview.giftWrapFee) })), preview.shipmentProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Shipment protection", countCharged((s) => s.shipmentProtectionFee)), amount: money(preview.shipmentProtectionFee) })), preview.saleProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Sale protection", countCharged((s) => s.saleProtectionFee)), amount: money(preview.saleProtectionFee) })), preview.platformFee > 0 && _jsx(Line, { label: "Platform fee", amount: money(preview.platformFee) }), (preview.gstAmount > 0 || preview.gstOnFee > 0) && (_jsx(Line, { label: "GST", amount: money(preview.gstAmount + preview.gstOnFee) })), preview.couponDiscount > 0 && (_jsx(Line, { label: "Coupon discount", amount: `−${money(preview.couponDiscount)}`, tone: "success" })), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Total", amount: money(preview.total), tone: "primary", strong: true }) }), errorNote ? (_jsx(Text, { size: "xs", color: "error", children: errorNote })) : (isLoading && (_jsx(Text, { size: "xs", color: "muted", children: "Updating\u2026" })))] }));
+    return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: subtotalLabel, amount: money(preview.subtotal) }), preview.shippingFee > 0 && (_jsx(Line, { label: withStoreCount("Shipping", storeCount), amount: money(preview.shippingFee) })), preview.codHandlingFee > 0 && (_jsx(Line, { label: "COD handling fee", amount: money(preview.codHandlingFee) })), preview.giftWrapFee > 0 && (_jsx(Line, { label: withStoreCount("Gift wrap", countCharged((s) => s.giftWrapFee)), amount: money(preview.giftWrapFee) })), preview.shipmentProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Shipment protection", countCharged((s) => s.shipmentProtectionFee)), amount: money(preview.shipmentProtectionFee) })), preview.saleProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Sale protection", countCharged((s) => s.saleProtectionFee)), amount: money(preview.saleProtectionFee) })), preview.platformFee > 0 && _jsx(Line, { label: "Platform fee", amount: money(preview.platformFee) }), preview.gstOnFee > 0 && (_jsx(Line, { label: "GST on platform fee", amount: money(preview.gstOnFee) })), preview.couponDiscount > 0 && (_jsx(Line, { label: "Coupon discount", amount: `−${money(preview.couponDiscount)}`, tone: "success" })), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Total", amount: money(preview.total), tone: "primary", strong: true }) }), preview.gstAmount > 0 && (_jsxs(Text, { size: "xs", color: "muted", children: ["Includes GST of ", money(preview.gstAmount)] })), errorNote ? (_jsx(Text, { size: "xs", color: "error", children: errorNote })) : (isLoading && (_jsx(Text, { size: "xs", color: "muted", children: "Updating\u2026" })))] }));
 }

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

@@ -2,7 +2,18 @@
  * Checkout Feature Firestore Document Types & Constants
  * Covers: failed checkouts, failed payments
  */
-export type FailedCheckoutReason = "stock_failed" | "address_not_found" | "cart_empty" | "validation_error" | "unknown";
+export type FailedCheckoutReason = "stock_failed" | "address_not_found" | "cart_empty"
+/**
+ * The cart exceeded `siteSettings.payment.codMaxOrderValue` and COD was
+ * refused server-side.
+ *
+ * 🛑 Its own reason rather than `validation_error`, because it is the only
+ * one here that is a BUSINESS rule an admin can change rather than a
+ * malformed request. Folded into `validation_error` it would be invisible,
+ * and "how often does the COD cap turn buyers away" is the question that
+ * decides whether ₹3,000 is the right number.
+ */
+ | "cod_over_limit" | "validation_error" | "unknown";
 export type FailedPaymentReason = "signature_mismatch" | "payment_cancelled" | "amount_mismatch" | "product_unavailable" | "stock_insufficient" | "unknown";
 export type FailedCheckoutDocument = {
     id: string;

package/dist/features/digital-codes/components/DigitalCodeDetailPageView.js

@@ -23,6 +23,7 @@ import { getGroupsWithItemsForProduct } from "../../../_internal/server/features
 import { ReviewsListingPanel } from "../../reviews/components/ReviewsListingPanel.js";
 import { ListingBottomActions } from "../../products/components/ListingBottomActions.js";
 import { productImageUrls } from "../../products/schemas/firestore.js";
+import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
 function toDescriptionHtml(raw) {
     if (!raw)
         return "";
@@ -84,5 +85,5 @@ export async function DigitalCodeDetailPageView({ slug, initialProduct, renderPr
                                 storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                                 storeName: storeName ?? undefined,
                                 inStock: codesLeft > 0,
-                            }) })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand, storeLabel: storeName ?? undefined })] })) }), _jsx(ListingBottomActions, { listingType: "digital-code", anchorId: "digital-code-buy-bar", price: price, currency: currency, unavailable: codesLeft <= 0 })] })] }));
+                            }) })), 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, storeLabel: storeName ?? undefined })] })) }), _jsx(ListingBottomActions, { listingType: "digital-code", anchorId: "digital-code-buy-bar", price: price, currency: currency, unavailable: codesLeft <= 0 })] })] }));
 }

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

@@ -88,7 +88,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", 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", 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 }) {
@@ -102,7 +102,9 @@ function CardBackground({ bg }) {
         return (_jsx(Div, { className: POSITION_FILL, style: { background: `linear-gradient(${angle}deg, ${from}, ${to})` } }));
     }
     if (bg.type === "image" && bg.url) {
-        return _jsx(MediaImage, { src: bg.url, alt: "", size: "card" });
+        // `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" });
     }
     return null;
 }

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

@@ -17,6 +17,7 @@ import { getHomepageFaqsCached } from "../../faq/utils/getHomepageFaqsCached.js"
 import { safeRead } from "../../../errors/safe-read.js";
 import { fetchLiveStats } from "../lib/live-stats.js";
 import { renderSection, AnnouncementBar } from "../lib/section-renderer.js";
+import { gateCarouselSlides } from "../lib/slide-gating.js";
 import { SECTION_COPY } from "../constants/section-copy.js";
 import { homepageSectionsRepository } from "../repository/homepage-sections.repository.js";
 import { isListingTypeEnabled, isCategoryTypeEnabled, } from "../../../_internal/shared/listing-types/feature-flags.js";
@@ -215,6 +216,20 @@ export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onB
             ? eventsResult.items
             : undefined,
     };
-    const carouselSlides = toCarouselSlides(slides);
+    /*
+     * 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
+     * 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`.
+     *
+     * 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), siteSettings);
     return (_jsx(Main, { children: _jsxs(Div, { className: "relative", children: [showAnnouncement ? (_jsx(TopBannerPortal, { children: _jsx(AnnouncementBar, { message: announcementMessage, link: siteSettings?.announcementBar?.link, onDismiss: onBannerDismiss }) })) : null, orderedSections.map((section) => renderSection(section, adSlots, newsletterFormSlot ?? null, faqItems, carouselSlides, liveStats, sectionData, brand))] }) }));
 }

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

@@ -19,8 +19,13 @@ export interface WelcomeSectionProps {
     onSecondaryCtaClick?: () => void;
     trustChips?: WelcomeSectionChip[];
     /**
-     * Decorative hero imagery, MOST IMPORTANT FIRST — the first takes the large
-     * mosaic cell. Below `MOSAIC_MIN` (3) the brand-mark panel is used instead.
+     * Decorative hero imagery for the mosaic's SMALL cells — the large cell is
+     * always the brand panel now, so these no longer compete for it.
+     *
+     * 🛑 Pass REAL images only. A caller sourcing these from
+     * `display.coverImage` must drop `SEED_TILE_PREFIX` values first: those are
+     * six flat generated SVGs, and a hero built from them is four coloured
+     * rectangles claiming to be a product preview.
      *
      * Must be deterministic: `ImageMosaic` is explicit that `Math.random()` here
      * would break SSR/hydration agreement, so the caller passes a stable
@@ -29,6 +34,14 @@ export interface WelcomeSectionProps {
     heroImages?: readonly string[];
     isLoading?: boolean;
     brandLogoText?: string;
+    /**
+     * Wordmark caption under the hero logo, e.g. "Let It Rip India".
+     *
+     * Consumer-supplied, never defaulted to a literal here: appkit is a library
+     * and a brand string baked into it is the encapsulation break
+     * `audit-ssr-in-appkit` Rule 3 exists to prevent. Omitted = no caption.
+     */
+    brandCaption?: string;
     className?: string;
 }
-export declare function WelcomeSection({ title, subtitle, pillLabel, showCTA, ctaLabel, ctaHref, onCtaClick, secondaryCtaLabel, secondaryCtaHref, onSecondaryCtaClick, trustChips, heroImages, isLoading, brandLogoText, className, }: WelcomeSectionProps): React.JSX.Element;
+export declare function WelcomeSection({ title, subtitle, pillLabel, showCTA, ctaLabel, ctaHref, onCtaClick, secondaryCtaLabel, secondaryCtaHref, onSecondaryCtaClick, trustChips, heroImages, isLoading, brandLogoText, brandCaption, className, }: WelcomeSectionProps): React.JSX.Element;

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

@@ -1,13 +1,13 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { THEMED_TEXT_SECONDARY, FLEX_CENTER } from "../../../_internal/shared/styles/themed.js";
-import { Button, Div, Grid, Heading, Icon, ImageMosaic, MOSAIC_MIN, Row, Section, SiteLogo, SiteMark, Span, Stack, Text, TextLink } from "../../../ui/index.js";
+import { Button, Div, Grid, Heading, Icon, ImageMosaic, Row, Section, SiteLogo, SiteMark, Span, Stack, Text, TextLink } from "../../../ui/index.js";
 // --- Component ---------------------------------------------------------------
-export function WelcomeSection({ title, subtitle, pillLabel, showCTA = true, ctaLabel = "Shop now", ctaHref, onCtaClick, secondaryCtaLabel = "Browse products", secondaryCtaHref, onSecondaryCtaClick, trustChips = [], heroImages, isLoading = false, brandLogoText = "", className = "", }) {
+export function WelcomeSection({ title, subtitle, pillLabel, showCTA = true, ctaLabel = "Shop now", ctaHref, onCtaClick, secondaryCtaLabel = "Browse products", secondaryCtaHref, onSecondaryCtaClick, trustChips = [], heroImages, isLoading = false, brandLogoText = "", brandCaption, className = "", }) {
     const themed = { textSecondary: THEMED_TEXT_SECONDARY };
     const flex = { center: FLEX_CENTER };
     if (isLoading) {
         return (_jsx(Section, { className: `relative overflow-hidden pt-[0px] pb-[var(--appkit-space-16)] md:pt-[0px] md:pb-[6rem] ${className}`, paddingX: "x-md", children: _jsxs(Div, { className: "animate-pulse max-w-4xl mx-auto text-left", children: [_jsx(Div, { className: "h-6 w-52 mb-6", surface: "subtle", rounded: "full" }), _jsx(Div, { className: "h-20 mb-4 max-w-2xl", surface: "subtle", rounded: "lg" }), _jsx(Div, { className: "h-6 mb-8 max-w-lg", surface: "subtle", rounded: "lg" }), _jsxs(Row, { justify: "start", gap: "md", children: [_jsx(Div, { className: "h-12 w-36", surface: "subtle", rounded: "xl" }), _jsx(Div, { className: "h-12 w-36", surface: "subtle", rounded: "xl" })] })] }) }));
     }
-    return (_jsxs(Section, { className: `relative overflow-hidden pt-[0px] pb-[var(--appkit-space-20)] md:pt-[0px] md:pb-[7rem] ${className}`, paddingX: "x-md", children: [_jsx(Div, { className: "pointer-events-none absolute -top-32 -left-32 w-[28rem] h-[28rem] bg-primary/10 blur-3xl", rounded: "full", "aria-hidden": "true" }), _jsx(Div, { className: "pointer-events-none absolute -bottom-40 -right-40 w-[36rem] h-[36rem] bg-secondary/10 dark:bg-secondary/15 blur-3xl", rounded: "full", "aria-hidden": "true" }), _jsx(Div, { className: "relative z-10 max-w-7xl mx-auto", children: _jsxs(Grid, { align: "center", gap: "2xl", className: "grid-cols-1 lg:grid-cols-2 xl:grid-cols-2 2xl:grid-cols-2", children: [_jsxs(Div, { className: "text-left", children: [pillLabel && (_jsx(Div, { children: _jsxs(Span, { layout: "inline-flex", gap: "md", size: "xs", weight: "medium", className: /* audit-variant-ok: colour+alpha border (primary-500/30); the `border` variant takes a token name, not an rgba step */ "border border-primary-500/30 bg-primary-500/10 px-[1.25rem] py-[0.375rem] tracking-[0.2em] text-primary-700 dark:text-primary-400 backdrop-blur-sm", rounded: "full", transform: "uppercase", children: [_jsx(Span, { className: "w-1.5 h-1.5 bg-primary-500 inline-block", rounded: "full", "aria-hidden": "true" }), pillLabel, _jsx(Span, { className: "w-1.5 h-1.5 bg-primary-500 inline-block", rounded: "full", "aria-hidden": "true" })] }) })), _jsx(Heading, { level: 1, variant: "none", gradient: "brand-tri", className: "mt-4 font-display leading-[1.1] tracking-tight break-words", size: "5xl", mdSize: "6xl", lgSize: "7xl", xlSize: "7xl", children: title }), subtitle && (_jsx(Text, { className: `mt-4 ${themed.textSecondary} max-w-xl leading-relaxed`, size: "xl", children: subtitle })), showCTA && (_jsxs(Row, { wrap: true, gap: "md", className: "mt-8", justify: "start", children: [ctaHref ? (_jsx(TextLink, { rounded: "xl", href: ctaHref, layout: "inline-flex", align: "center", justify: "center", className: "px-[2rem] py-[0.875rem] !bg-primary hover:!bg-primary-600 text-white dark:!bg-primary dark:hover:!bg-primary-600 dark:text-white btn-glow transition-all hover:scale-[1.02]", size: "base", weight: "bold", children: ctaLabel })) : (_jsx(Button, { variant: "primary", size: "lg", onClick: onCtaClick, children: ctaLabel })), secondaryCtaHref ? (_jsx(TextLink, { rounded: "xl", href: secondaryCtaHref, layout: "inline-flex", align: "center", justify: "center", className: "border-2 border-cobalt/40 dark:border-cobalt-400/40 px-[2rem] py-[0.875rem] text-cobalt-700 dark:text-cobalt-300 hover:bg-primary-surface transition-all hover:scale-[1.02]", size: "base", weight: "semibold", children: secondaryCtaLabel })) : (_jsx(Button, { variant: "outline", size: "lg", onClick: onSecondaryCtaClick, children: secondaryCtaLabel }))] })), trustChips.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mt-6", justify: "start", children: trustChips.map((chip) => (_jsxs(Row, { align: "center", gap: "xs", surface: "default", border: "subtle", rounded: "full", shadow: "sm", className: "px-[0.875rem] py-[0.375rem]", children: [_jsx(Icon, { name: chip.iconName, size: "sm", tone: "success" }), _jsx(Span, { size: "xs", weight: "medium", color: "muted", children: chip.label })] }, chip.key))) }))] }), _jsx(Div, { className: "hidden lg:block", children: heroImages && heroImages.length >= MOSAIC_MIN ? (_jsx(ImageMosaic, { size: "hero", images: heroImages, alt: `${brandLogoText || "Marketplace"} collection highlights` })) : (_jsxs(Div, { className: `relative overflow-hidden aspect-[4/3] bg-[image:var(--appkit-gradient-section-mesh)]`, shadow: "2xl", border: "default", rounded: "3xl", children: [_jsx(Div, { className: "absolute inset-0 bg-[image:var(--appkit-gradient-glass)]" }), _jsxs(Stack, { centered: true, gap: "sm", className: `absolute inset-0 ${flex.center} p-[2.5rem]`, children: [_jsx(SiteMark, { title: brandLogoText || "LetItRip.in", size: "xl" }), _jsx(SiteLogo, { title: brandLogoText || "LetItRip.in", size: "xl" })] })] })) })] }) })] }));
+    return (_jsxs(Section, { className: `relative overflow-hidden pt-[0px] pb-[var(--appkit-space-20)] md:pt-[0px] md:pb-[7rem] ${className}`, paddingX: "x-md", children: [_jsx(Div, { className: "pointer-events-none absolute -top-32 -left-32 w-[28rem] h-[28rem] bg-primary/10 blur-3xl", rounded: "full", "aria-hidden": "true" }), _jsx(Div, { className: "pointer-events-none absolute -bottom-40 -right-40 w-[36rem] h-[36rem] bg-secondary/10 dark:bg-secondary/15 blur-3xl", rounded: "full", "aria-hidden": "true" }), _jsx(Div, { className: "relative z-10 max-w-7xl mx-auto", children: _jsxs(Grid, { align: "center", gap: "2xl", className: "grid-cols-1 lg:grid-cols-2 xl:grid-cols-2 2xl:grid-cols-2", children: [_jsxs(Div, { className: "text-left", children: [pillLabel && (_jsx(Div, { children: _jsxs(Span, { layout: "inline-flex", gap: "md", size: "xs", weight: "medium", className: /* audit-variant-ok: colour+alpha border (primary-500/30); the `border` variant takes a token name, not an rgba step */ "border border-primary-500/30 bg-primary-500/10 px-[1.25rem] py-[0.375rem] tracking-[0.2em] text-primary-700 dark:text-primary-400 backdrop-blur-sm", rounded: "full", transform: "uppercase", children: [_jsx(Span, { className: "w-1.5 h-1.5 bg-primary-500 inline-block", rounded: "full", "aria-hidden": "true" }), pillLabel, _jsx(Span, { className: "w-1.5 h-1.5 bg-primary-500 inline-block", rounded: "full", "aria-hidden": "true" })] }) })), _jsx(Heading, { level: 1, variant: "none", gradient: "brand-tri", className: "mt-4 font-display leading-[1.1] tracking-tight break-words", size: "5xl", mdSize: "6xl", lgSize: "7xl", xlSize: "7xl", children: title }), subtitle && (_jsx(Text, { className: `mt-4 ${themed.textSecondary} max-w-xl leading-relaxed`, size: "xl", children: subtitle })), showCTA && (_jsxs(Row, { wrap: true, gap: "md", className: "mt-8", justify: "start", children: [ctaHref ? (_jsx(TextLink, { rounded: "xl", href: ctaHref, layout: "inline-flex", align: "center", justify: "center", className: "px-[2rem] py-[0.875rem] !bg-primary hover:!bg-primary-600 text-white dark:!bg-primary dark:hover:!bg-primary-600 dark:text-white btn-glow transition-all hover:scale-[1.02]", size: "base", weight: "bold", children: ctaLabel })) : (_jsx(Button, { variant: "primary", size: "lg", onClick: onCtaClick, children: ctaLabel })), secondaryCtaHref ? (_jsx(TextLink, { rounded: "xl", href: secondaryCtaHref, layout: "inline-flex", align: "center", justify: "center", className: "border-2 border-cobalt/40 dark:border-cobalt-400/40 px-[2rem] py-[0.875rem] text-cobalt-700 dark:text-cobalt-300 hover:bg-primary-surface transition-all hover:scale-[1.02]", size: "base", weight: "semibold", children: secondaryCtaLabel })) : (_jsx(Button, { variant: "outline", size: "lg", onClick: onSecondaryCtaClick, children: secondaryCtaLabel }))] })), trustChips.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mt-6", justify: "start", children: trustChips.map((chip) => (_jsxs(Row, { align: "center", gap: "xs", surface: "default", border: "subtle", rounded: "full", shadow: "sm", className: "px-[0.875rem] py-[0.375rem]", children: [_jsx(Icon, { name: chip.iconName, size: "sm", tone: "success" }), _jsx(Span, { size: "xs", weight: "medium", color: "muted", children: chip.label })] }, chip.key))) }))] }), _jsx(Div, { className: "hidden lg:block", children: _jsx(ImageMosaic, { size: "hero", images: heroImages ?? [], alt: `${brandLogoText || "Marketplace"} collection highlights`, leadSlot: _jsxs(Div, { className: "absolute inset-0 bg-[image:var(--appkit-gradient-section-mesh)]", children: [_jsx(Div, { className: "absolute inset-0 bg-[image:var(--appkit-gradient-glass)]" }), _jsxs(Stack, { centered: true, gap: "sm", padding: "xl", className: `absolute inset-0 ${flex.center}`, children: [_jsx(SiteMark, { title: brandLogoText || "LetItRip.in", size: "xl" }), _jsx(SiteLogo, { title: brandLogoText || "LetItRip.in", size: "xl" }), brandCaption && (_jsx(Text, { align: "center", size: "sm", weight: "semibold", transform: "uppercase", className: "tracking-widest text-primary-700 dark:text-primary-300", children: brandCaption }))] })] }) }) })] }) })] }));
 }

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

@@ -46,6 +46,15 @@ export interface HomepageBrand {
     name?: string;
     /** Short mark shown in the hero panel, e.g. "LT". */
     shortName?: string;
+    /**
+     * Caption under the hero brand panel's logo, e.g. "Let It Rip India".
+     *
+     * Separate from `name` because that one is a sentence ingredient ("Why
+     * Buyers Trust LetItRip") and this one is a standalone lockup line — they
+     * are spelled differently on purpose and collapsing them would force one of
+     * the two to read wrong.
+     */
+    heroCaption?: string;
 }
 /**
  * Every surface a `SectionDef` may be mounted on.

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

@@ -1,6 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
 import { ROUTES } from "../../../next/routing/route-map.js";
+/* Defining module, not the `ui`/root barrel — Root Cause #18. This is the one
+   owner of "what a generated placeholder tile looks like"; the seed helper's
+   `isSeedPlaceholderImage` reads the same prefix from its own copy, and both
+   are documented as mirrors of `public/images/seed-tiles/`. */
+import { SEED_TILE_PREFIX } from "../../../utils/media-url.js";
 import { cleanTitle, parseWelcomeDescription } from "./section-helpers.js";
 import { DEFAULT_TRUST_FEATURES, DEFAULT_SECURITY_ITEMS } from "./section-defaults.js";
 import { SECTION_TITLE, SECTION_COPY, VIEW_MORE_LABEL, WELCOME_TRUST_CHIPS, } from "../constants/section-copy.js";
@@ -76,21 +81,33 @@ const SECTION_REGISTRY = {
             /*
              * Hero imagery, taken from the featured categories' own covers.
              *
-             * Deterministic — the first five in CONFIGURED order, never shuffled, so
+             * Deterministic — the first few in CONFIGURED order, never shuffled, so
              * the server and client render the same mosaic (ImageMosaic's header is
              * explicit about why `Math.random()` is wrong here).
              *
+             * 🛑 PLACEHOLDERS ARE DROPPED, and on this install that is most of them.
+             * `seedPhoto()` returns one of six flat SVG tiles under
+             * `SEED_TILE_PREFIX` whenever the seed has no real artwork, and
+             * `listTopLevelCategories` returns exactly the rows that have none —
+             * measured against production, 4 of the first 12 covers were tiles and
+             * the hero's large cell was `/images/seed-tiles/312e81.svg`. Those are
+             * not photographs of anything; passing them through meant the hero
+             * advertised the catalogue with coloured rectangles.
+             *
+             * Four, not five: the brand panel now owns the large cell, so the mosaic
+             * has one fewer slot to fill (see `ImageMosaic.leadSlot`).
+             *
              * 🛑 `sectionData.categories` is only populated when the page also has a
              * `categories` section enabled, because MarketplaceHomepageView gates
              * each fetch on `activeTypes`. `welcome` is registered as a trigger for
              * that fetch for exactly this reason; without it the mosaic silently
-             * falls back to the brand panel and nothing says why.
+             * collapses to the brand panel alone and nothing says why.
              */
             const heroImages = (sectionData.categories ?? [])
                 .map((c) => c.display?.coverImage)
-                .filter((src) => Boolean(src))
-                .slice(0, 5);
-            return (_jsx(WelcomeSection, { heroImages: heroImages, title: cleanTitle(cfg?.h1) || SECTION_TITLE.welcome, 
+                .filter((src) => Boolean(src) && !src.startsWith(SEED_TILE_PREFIX))
+                .slice(0, 4);
+            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 }));

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

@@ -0,0 +1,52 @@
+/**
+ * Carousel gating — strip slides and cards that advertise a disabled listing
+ * type.
+ *
+ * ## The gap this closes
+ *
+ * `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.
+ *
+ * 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"
+ * 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:
+ * the only thing identifying them is where they point.
+ *
+ * ## Deliberately link-based, not keyword-based
+ *
+ * Nothing here reads the copy. "Win it at your price" names no type, and a
+ * word search would be both incomplete (it misses that slide) and
+ * over-eager (it would eat the authenticity slide for saying "bid" in passing).
+ * A destination is checkable; prose is not.
+ *
+ * ## What survives
+ *
+ * A slide keeps its authored `zone` values when a card is removed. Re-packing
+ * 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
+ * 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.
+ */
+import type { CarouselSlide } from "../types/index";
+import type { ListingType } from "../../products/types/index";
+interface ListingFlagSnapshot {
+    listings?: {
+        listingTypes?: Partial<Record<ListingType, boolean>>;
+    };
+}
+/**
+ * Filter a slide list for the current listing-type flags.
+ *
+ * Returns a new array; input is not mutated. Fails OPEN — with no settings
+ * document every `isListingTypeEnabled` call returns `true` and nothing is
+ * removed, which is the right failure for a read that errored (Root Cause
+ * #72: an unknown must never be read as "zero").
+ */
+export declare function gateCarouselSlides<T extends CarouselSlide>(slides: readonly T[], settings: ListingFlagSnapshot | null | undefined): T[];
+export {};

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

@@ -0,0 +1,98 @@
+/**
+ * Carousel gating — strip slides and cards that advertise a disabled listing
+ * type.
+ *
+ * ## The gap this closes
+ *
+ * `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.
+ *
+ * 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"
+ * 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:
+ * the only thing identifying them is where they point.
+ *
+ * ## Deliberately link-based, not keyword-based
+ *
+ * Nothing here reads the copy. "Win it at your price" names no type, and a
+ * word search would be both incomplete (it misses that slide) and
+ * over-eager (it would eat the authenticity slide for saying "bid" in passing).
+ * A destination is checkable; prose is not.
+ *
+ * ## What survives
+ *
+ * A slide keeps its authored `zone` values when a card is removed. Re-packing
+ * 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
+ * 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.
+ */
+import { isDisabledListingHref } from "../../../_internal/shared/listing-types/route-gating.js";
+/**
+ * Every destination a card offers. A card with no buttons is still clickable
+ * through nothing — it has no link of its own — so it is never gated.
+ */
+function cardHrefs(card) {
+    return (card.buttons ?? []).map((b) => b.href).filter(Boolean);
+}
+/**
+ * A card is dropped when it HAS destinations and every one of them is
+ * disabled.
+ *
+ * 🛑 "every", not "any", and the empty case matters: `[].every()` is `true`,
+ * so a card with no buttons at all would be dropped by the predicate alone.
+ * That is why the length check is separate rather than folded in — an
+ * image-only card advertises no type and must survive.
+ */
+function isCardDisabled(card, settings) {
+    const hrefs = cardHrefs(card);
+    if (hrefs.length === 0)
+        return false;
+    return hrefs.every((href) => isDisabledListingHref(href, settings));
+}
+/**
+ * A slide is dropped when the thing it is ABOUT is disabled — its overlay CTA
+ * or its own whole-slide link.
+ *
+ * Both are checked because they are set independently: the seeded auction
+ * slide carries `overlay.button.link` AND `link.url`, while a slide can
+ * legitimately have only one.
+ */
+function isSlideDisabled(slide, settings) {
+    if (isDisabledListingHref(slide.overlay?.button?.link, settings))
+        return true;
+    if (isDisabledListingHref(slide.link?.url, settings))
+        return true;
+    return false;
+}
+/**
+ * Filter a slide list for the current listing-type flags.
+ *
+ * Returns a new array; input is not mutated. Fails OPEN — with no settings
+ * document every `isListingTypeEnabled` call returns `true` and nothing is
+ * removed, which is the right failure for a read that errored (Root Cause
+ * #72: an unknown must never be read as "zero").
+ */
+export function gateCarouselSlides(slides, settings) {
+    const kept = [];
+    for (const slide of slides) {
+        if (isSlideDisabled(slide, settings))
+            continue;
+        const cards = (slide.cards ?? []).filter((card) => !isCardDisabled(card, settings));
+        const hadCards = (slide.cards ?? []).length > 0;
+        // A cards-slide that lost ALL its cards renders as a bare background with
+        // no copy and no call to action — the exact "renders blank" failure the
+        // carousel seed file's own header warns about. Drop it rather than ship an
+        // empty frame the visitor can swipe to.
+        if (hadCards && cards.length === 0 && !slide.overlay)
+            continue;
+        kept.push(cards.length === (slide.cards ?? []).length ? slide : { ...slide, cards });
+    }
+    return kept;
+}