@mohasinac/appkit 4.55.0 → 4.56.0

package/dist/_internal/shared/shipping/quote.js

@@ -0,0 +1,124 @@
+/**
+ * What the buyer is quoted for shipping, what the seller actually spent, and
+ * who wears the difference.
+ *
+ * Pure and synchronous — no I/O, no Firestore, no provider. Every surface that
+ * touches a shipping figure resolves through here so the quote shown at
+ * checkout, the amount charged, the order record and the reconciliation can
+ * never disagree (Root Cause #75: a rule reachable by copy-paste WILL be
+ * copied, and the copy never learns about the branch added later).
+ *
+ * ## The model
+ *
+ * 1. Shiprocket returns per-courier rates for the buyer's pincode.
+ * 2. Each rate is ROUNDED UP to the nearest ₹50 and that is what the buyer
+ *    sees and is charged. The raw rate is never shown and never billed.
+ * 3. The seller ships. If their courier is dearer than the charged figure they
+ *    absorb the difference; if it is cheaper the buyer is credited the
+ *    difference in points, 1 point = ₹1.
+ *
+ * ## 🛑 Reconciliation measures against the CHARGED figure, not the raw rate
+ *
+ * This is the decision that makes the whole thing coherent, and it is worth
+ * stating because the obvious alternative is defensible and wrong.
+ *
+ * Measuring against the raw rate would let the platform keep the round-up
+ * (₹70 raw → ₹100 charged → a silent ₹30 margin on every parcel) while still
+ * calling the ₹50 step a "rounding". Measuring against the charged figure
+ * means the buyer is made whole for every rupee they handed over that did not
+ * become postage: ₹100 charged, shipped at ₹47, 53 points back. The round-up
+ * stops being a margin and becomes a BUFFER that absorbs ordinary courier
+ * variance before the seller has to.
+ *
+ * It also makes the rule explainable in one sentence to both sides — "you pay
+ * the rounded quote and get back whatever we did not spend", "you keep the
+ * quote and cover any overage" — and a rule a seller can predict is a rule
+ * they do not dispute.
+ */
+/**
+ * Shipping is always billed in whole ₹50 steps.
+ *
+ * 🛑 Not a formatting choice. A courier rate is a volatile per-parcel number
+ * (fuel, zone, weight slab, surcharge) and quoting it to the rupee invites a
+ * dispute every time the actual differs by ₹3. A coarse step makes the quote
+ * stable, makes it look like a price rather than a machine reading, and buys
+ * the headroom that keeps most orders off the reconciliation path entirely.
+ */
+export const SHIPPING_ROUND_UP_TO = 50;
+/**
+ * Round a raw carrier rate up to the next ₹50.
+ *
+ * `Math.ceil`, so ₹70 → ₹100 and ₹100 → ₹100 — a rate exactly on a step is NOT
+ * pushed to the next one. ₹0 stays ₹0: free shipping must survive the rounding
+ * or every free-shipping order silently acquires a ₹50 charge.
+ *
+ * Negative input is clamped to 0 rather than rounded "up" toward zero, which
+ * would otherwise turn a bad provider response into a credit.
+ */
+export function roundShippingUp(rawRate) {
+    if (!Number.isFinite(rawRate) || rawRate <= 0)
+        return 0;
+    return Math.ceil(rawRate / SHIPPING_ROUND_UP_TO) * SHIPPING_ROUND_UP_TO;
+}
+/**
+ * Compare the charged quote against the real spend.
+ *
+ * 🛑 Works on the CHARGED figure (see the header). The worked examples from the
+ * spec, with the ₹70 Ekart quote billed at ₹100:
+ *
+ *   shipped Delhivery ₹100 → sellerAbsorbs 0,   buyerPoints 0
+ *   shipped Delhivery ₹120 → sellerAbsorbs 20,  buyerPoints 0
+ *   shipped India Post ₹47 → sellerAbsorbs 0,   buyerPoints 53
+ *
+ * Points are the EXACT rupee difference and are deliberately not rounded to a
+ * ₹50 step. The round-up exists to make a *quote* stable; applying it to a
+ * credit would either invent money (rounding up) or quietly keep some of the
+ * buyer's (rounding down).
+ */
+export function reconcileShipping(quote, actual) {
+    const charged = Number.isFinite(quote.chargedRate) ? Math.max(0, quote.chargedRate) : 0;
+    const spent = Number.isFinite(actual.actualRate) ? Math.max(0, actual.actualRate) : 0;
+    const delta = roundPaise(charged - spent);
+    return {
+        sellerAbsorbs: delta < 0 ? Math.abs(delta) : 0,
+        buyerPoints: delta > 0 ? delta : 0,
+        courierChanged: quote.courierId !== actual.courierId,
+    };
+}
+/**
+ * Two decimal places.
+ *
+ * Money here is decimal rupees (the paise→rupees migration, Root Cause #31), so
+ * a subtraction can leave a float artefact — `100 - 47.1` is `52.900000000000006`,
+ * and that would become a points credit with eleven decimal places on a user's
+ * balance.
+ */
+function roundPaise(value) {
+    return Math.round(value * 100) / 100;
+}
+/**
+ * Turn carrier serviceability results into offerable options.
+ *
+ * 🛑 Drops any courier whose rate is not a usable number instead of charging
+ * ₹0 for it. `resolveShippingCost` already carries this lesson in its
+ * `shippingUnavailable` flag: a zero there "would ship every parcel free at
+ * our expense, silently, until somebody noticed". A malformed row from a
+ * provider is missing data, never free postage.
+ *
+ * Sorted cheapest-first, then fastest — the buyer is choosing, so the default
+ * reading order should be the one most of them want.
+ */
+export function toQuoteOptions(couriers) {
+    return couriers
+        .filter((c) => Number.isFinite(c.rate) && c.rate > 0 && Boolean(c.name))
+        .map((c) => ({
+        // Providers do not all return an id. Falling back to the name keeps the
+        // pick round-trippable; it is only ever compared against itself.
+        courierId: c.courierId ?? c.name,
+        courierName: c.name,
+        rawRate: c.rate,
+        chargedRate: roundShippingUp(c.rate),
+        estimatedDays: c.estimatedDays,
+    }))
+        .sort((a, b) => a.chargedRate - b.chargedRate || a.estimatedDays - b.estimatedDays);
+}

package/dist/client.d.ts

@@ -534,6 +534,7 @@ export { SELLER_LISTING_TABS, type SellerListingTabId, } from "./features/produc
 export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs";
 export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS, STORE_FIELDS, CATEGORY_FIELDS, BLOG_FIELDS, USER_FIELDS, ADDRESS_FIELDS, BRAND_FIELDS, CART_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, NOTIFICATION_FIELDS, SESSION_FIELDS, COUPON_USAGE_FIELDS, SCAMMER_FIELDS, SUPPORT_TICKET_FIELDS, CAROUSEL_FIELDS, COUPON_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
 export { CART_LANE, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane, laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane, canAddNewItems, type CartLane, type LaneAssignable, } from "./_internal/shared/checkout/lanes";
+export { roundShippingUp, toQuoteOptions, reconcileShipping, SHIPPING_ROUND_UP_TO, type ShippingQuoteOption, type SelectedShippingQuote, type ActualShipmentCost, type ShippingReconciliation, } from "./_internal/shared/shipping/quote";
 export { getCartLineMembers, isMultiMemberLine, } from "./_internal/shared/checkout/line-members";
 export { newsletterSubscribeSchema, quickCreateTaxonomySchema, payoutMarkPaidSchema, } from "./features/admin/schemas/small-forms";
 export { raffleEntrySchema } from "./features/contact/schemas/inquiry-forms";

package/dist/client.js

@@ -546,6 +546,14 @@ export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS
 // Checkout lanes — the derived auction > offer > standard partition of the
 // cart, and the priority rule that decides which one may be checked out.
 export { CART_LANE, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane, laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane, canAddNewItems, } from "./_internal/shared/checkout/lanes.js";
+/*
+ * Shipping quote model. Public because the CONSUMER owns the route that asks
+ * the carrier for rates (`/api/shipping/quote`) and the checkout UI that
+ * renders them — the rounding rule has to be reachable from both, and it must
+ * be the same rule the server-side reconciliation uses, or the buyer is
+ * credited against a figure they were never charged.
+ */
+export { roundShippingUp, toQuoteOptions, reconcileShipping, SHIPPING_ROUND_UP_TO, } from "./_internal/shared/shipping/quote.js";
 /*
  * The cart page needs these to tell a multi-member line from an ordinary one: a
  * group/bundle line's `productId` is a group or category id, not a product id,

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/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;
+}

package/dist/features/live/components/LiveItemDetailPageView.js

@@ -26,6 +26,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 "";
@@ -79,5 +80,5 @@ export async function LiveItemDetailPageView({ slug, initialProduct, renderActio
                     price: price ?? undefined,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: storeName ?? undefined,
-                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.LIVE), className: CLS_BREADCRUMB_LINK, children: "Live" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => _jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title }), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_ITEM_BADGE, children: "Live Item" }), meta?.vendorVerified && (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Verified Seller" })), meta?.cites && (_jsxs(Span, { color: "warning", surface: "warning-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: ["CITES: ", meta.cites] }))] }), _jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(p.title ?? p.slug ?? p.id), storeId: p.storeId ? String(p.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(p.id))) }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title }), meta?.species && (_jsxs(Text, { className: "italic mt-1", color: "muted", size: "sm", children: [meta.species, meta.sex && meta.sex !== "n/a" && ` · ${meta.sex}`, meta.ageMonths !== undefined && ` · ${meta.ageMonths}mo`] }))] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) })), jurisdictions.length > 0 && (_jsxs(Div, { className: CLS_WARN_BOX, children: [_jsx(Text, { className: CLS_WARN_TITLE, children: "Delivery restrictions" }), _jsxs(Text, { className: CLS_WARN_BODY, children: ["This item can only be shipped to: ", jurisdictions.join(", ")] })] })), transport && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Transport" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Method: ", transport.method, transport.handlingFee !== undefined && (_jsx(PricesOnly, { children: ` · Handling: ${formatCurrency(transport.handlingFee, "INR")}` })), transport.insuranceIncluded && " · Insurance included"] })] })), meta?.careInfo && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Care information" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-muted)]", children: meta.careInfo })] })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, reviewsContent: _jsx(ReviewsListingPanel, { source: { kind: "product", productId: product.id }, stateMode: "local", context: "listing", initialData: initialReviews, emptyLabel: "No reviews yet \u2014 be the first to review this product." }), customTabs: toCustomSectionTabs(p.customSections) })), renderBuyBar: () => _jsx(Div, { id: "live-item-buy-bar", children: renderActions?.(product) }), 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: "live", anchorId: "live-item-buy-bar", price: price, currency: currency })] })] }));
+                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.LIVE), className: CLS_BREADCRUMB_LINK, children: "Live" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => _jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title }), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_LIVE_ITEM_BADGE, children: "Live Item" }), meta?.vendorVerified && (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Verified Seller" })), meta?.cites && (_jsxs(Span, { color: "warning", surface: "warning-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: ["CITES: ", meta.cites] }))] }), _jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(p.title ?? p.slug ?? p.id), storeId: p.storeId ? String(p.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(p.id))) }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title }), meta?.species && (_jsxs(Text, { className: "italic mt-1", color: "muted", size: "sm", children: [meta.species, meta.sex && meta.sex !== "n/a" && ` · ${meta.sex}`, meta.ageMonths !== undefined && ` · ${meta.ageMonths}mo`] }))] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) })), jurisdictions.length > 0 && (_jsxs(Div, { className: CLS_WARN_BOX, children: [_jsx(Text, { className: CLS_WARN_TITLE, children: "Delivery restrictions" }), _jsxs(Text, { className: CLS_WARN_BODY, children: ["This item can only be shipped to: ", jurisdictions.join(", ")] })] })), transport && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Transport" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Method: ", transport.method, transport.handlingFee !== undefined && (_jsx(PricesOnly, { children: ` · Handling: ${formatCurrency(transport.handlingFee, "INR")}` })), transport.insuranceIncluded && " · Insurance included"] })] })), meta?.careInfo && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Care information" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-muted)]", children: meta.careInfo })] })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, reviewsContent: _jsx(ReviewsListingPanel, { source: { kind: "product", productId: product.id }, stateMode: "local", context: "listing", initialData: initialReviews, emptyLabel: "No reviews yet \u2014 be the first to review this product." }), customTabs: toCustomSectionTabs(p.customSections) })), renderBuyBar: () => _jsx(Div, { id: "live-item-buy-bar", children: renderActions?.(product) }), 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: "live", anchorId: "live-item-buy-bar", price: price, currency: currency })] })] }));
 }

package/dist/features/media/MediaAvatar.js

@@ -8,6 +8,6 @@ const sizeClasses = {
     xl: "w-20 h-20",
 };
 export function MediaAvatar({ src, alt, size = "md", className = "", }) {
-    return (_jsx(Div, { className: `relative ${sizeClasses[size]} overflow-hidden flex-shrink-0 ${className}`, rounded: "full", children: _jsx(MediaImage, { src: src, alt: alt, size: "avatar" }) }));
+    return (_jsx(Div, { className: `relative ${sizeClasses[size]} overflow-hidden flex-shrink-0 ${className}`, rounded: "full", children: _jsx(MediaImage, { src: src, alt: alt, size: "avatar", objectFit: "cover" }) }));
 }
 export default MediaAvatar;