@mohasinac/appkit 4.55.0 → 4.57.0

package/dist/client.js

@@ -405,6 +405,8 @@ export { couponDraftToPayload } from "./features/seller/schemas/coupon-form.js";
 export { UserAccountHubView, UserOrdersView, UserBidsView, OrderDetailView, UserReturnsView, useNotifications } from "./features/account/index.js";
 export { useOrders, useOrder, OrdersList } from "./features/orders/index.js";
 export { OrderStatusTimeline } from "./features/orders/components/OrderStatusTimeline.js";
+// Buyer-facing EMI schedule with a pay-any-instalment action.
+export { EmiInstallmentsPanel } from "./features/orders/components/EmiInstallmentsPanel.js";
 export { CountdownDisplay } from "./ui/components/CountdownDisplay.js";
 export { OrderAddonBadges } from "./features/orders/components/OrderAddonBadges.js";
 // Manual-payment (cash / UPI / EMI) shared constants — pure data + predicates,
@@ -546,6 +548,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/about/components/PublicProfileView.js

@@ -16,6 +16,7 @@ import { pluginFor } from "../../../_internal/shared/listing-types/_registry.js"
 import { normalizeListingType } from "../../products/utils/listing-type.js";
 import { isAdminUser, isSellerUser } from "../../auth/role-predicates.js";
 import { User, Star, ShoppingBag, Package, Trophy, Globe, MapPin, ExternalLink } from "lucide-react";
+import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
 const __P = {
     p4: "p-[var(--appkit-space-4)]",
     p6: "p-[var(--appkit-space-6)]",
@@ -120,7 +121,7 @@ export async function PublicProfileView({ userId, tab, }) {
     const profileHeroCtx = { displayName, photoURL, memberSince, isSeller, storeSlug, flex, page };
     const statItems = buildProfileStatItems(t, { listingCount, reviewCount, itemsSold, auctionsWon, totalOrders, isSeller });
     const activeTab = tab === "catalogue" ? "catalogue" : "overview";
-    return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [renderProfileHero(t, profileHeroCtx), _jsxs(Stack, { gap: "2xl", className: `${page.container.md}`, paddingY: "y-3xl", children: [_jsxs(Row, { gap: "md", padding: "t-xs", border: "bottom", children: [_jsx(TextLink, { href: `/profile/${userId}/overview`, variant: activeTab === "overview" ? "default" : "muted", weight: activeTab === "overview" ? "semibold" : "normal", children: "Overview" }), _jsx(TextLink, { href: `/profile/${userId}/catalogue`, variant: activeTab === "catalogue" ? "default" : "muted", weight: activeTab === "catalogue" ? "semibold" : "normal", children: "Catalogue" })] }), activeTab === "catalogue" ? (_jsx(PublicCatalogueView, { ownerSlug: userId })) : (_jsxs(_Fragment, { children: [renderProfileStatsRow(flex, statItems), renderProfileBioSection(pub), renderStoreDescriptionSection(isSeller, storeSlug ?? null, storeDescription ?? null, storeName, t), renderProfileListingsSection(t, products, storeSlug ?? null), renderAuthoredReviewsSection(t, reviewsAuthored, displayName), reviewsReceivedAsBuyer.length > 0 && renderBuyerReceivedReviewsSection(t, reviewsReceivedAsBuyer)] })), _jsx(Row, { justify: "center", padding: "t-xs", children: _jsxs(Link, { href: String(ROUTES.HOME), className: "text-[length:var(--appkit-text-sm)] text-[var(--appkit-color-text-faint)] hover:text-[var(--appkit-color-text-muted)]", children: ["\u2190 ", t("backHome")] }) })] })] }));
+    return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [renderProfileHero(t, profileHeroCtx), _jsxs(Stack, { gap: "2xl", className: `${page.container.md}`, paddingY: "y-3xl", children: [_jsx(Row, { justify: "end", children: _jsx(OwnerQuickActions, { resource: "USER", placement: "detail", recordLabel: displayName, editHref: String(ROUTES.ADMIN.USER_EDIT(userId)) }) }), _jsxs(Row, { gap: "md", padding: "t-xs", border: "bottom", children: [_jsx(TextLink, { href: `/profile/${userId}/overview`, variant: activeTab === "overview" ? "default" : "muted", weight: activeTab === "overview" ? "semibold" : "normal", children: "Overview" }), _jsx(TextLink, { href: `/profile/${userId}/catalogue`, variant: activeTab === "catalogue" ? "default" : "muted", weight: activeTab === "catalogue" ? "semibold" : "normal", children: "Catalogue" })] }), activeTab === "catalogue" ? (_jsx(PublicCatalogueView, { ownerSlug: userId })) : (_jsxs(_Fragment, { children: [renderProfileStatsRow(flex, statItems), renderProfileBioSection(pub), renderStoreDescriptionSection(isSeller, storeSlug ?? null, storeDescription ?? null, storeName, t), renderProfileListingsSection(t, products, storeSlug ?? null), renderAuthoredReviewsSection(t, reviewsAuthored, displayName), reviewsReceivedAsBuyer.length > 0 && renderBuyerReceivedReviewsSection(t, reviewsReceivedAsBuyer)] })), _jsx(Row, { justify: "center", padding: "t-xs", children: _jsxs(Link, { href: String(ROUTES.HOME), className: "text-[length:var(--appkit-text-sm)] text-[var(--appkit-color-text-faint)] hover:text-[var(--appkit-color-text-muted)]", children: ["\u2190 ", t("backHome")] }) })] })] }));
 }
 function buildProfileStatItems(t, ctx) {
     const { listingCount, reviewCount, itemsSold, auctionsWon, totalOrders, isSeller } = ctx;

package/dist/features/account/components/UserOrdersView.js

@@ -51,6 +51,27 @@ const ORDER_LANE_TABS = [
     { id: "auction", label: "Auction wins" },
     { id: "offer", label: "Offer wins" },
 ];
+/**
+ * Payment-method tabs — a THIRD axis, independent of the lane tabs above and
+ * the lifecycle scope beside them.
+ *
+ * 🛑 EMI is not a lane and not a status, which is why it could not join
+ * either existing control: `orderType` records how the order was WON
+ * (standard / auction / offer) and the scope records where it IS. How it is
+ * being PAID is orthogonal to both — an auction win can be on an EMI plan.
+ *
+ * Every id is exactly a stored `OrderDocument.paymentMethod` value, and
+ * `paymentMethod` is `canFilter: true` in the orders SIEVE_FIELDS — checked
+ * before wiring this, because an unallowlisted field does not raise: the
+ * clause is silently dropped and the chip returns the ENTIRE order list while
+ * looking like a filter (Root Cause #62).
+ */
+const PAYMENT_METHOD_TABS = [
+    { id: "", label: "Any" },
+    { id: "emi", label: "EMI plans" },
+    { id: "cod", label: "Cash on delivery" },
+    { id: "online", label: "Paid online" },
+];
 const STATUS_OPTIONS = [
     { value: "pending", label: "Pending" },
     { value: "processing", label: "Processing" },
@@ -85,7 +106,7 @@ export function UserOrdersView({ onOrderClick }) {
      * (CLAUDE.md, Root Cause #35).
      */
     const searchParams = useSearchParams();
-    const hasNarrowingFilter = ["q", "search", "status", "orderType", "filters"].some((k) => Boolean(searchParams.get(k)));
+    const hasNarrowingFilter = ["q", "search", "status", "orderType", "paymentMethod", "filters"].some((k) => Boolean(searchParams.get(k)));
     const emptyMessage = hasNarrowingFilter
         ? "No orders match your search or filters."
         : "You haven't placed any orders yet.";
@@ -104,7 +125,7 @@ export function UserOrdersView({ onOrderClick }) {
             fields: ["id", "productTitle"],
         },
         emptyLabel: emptyMessage,
-        filterKeys: ["status", "orderType"],
+        filterKeys: ["status", "orderType", "paymentMethod"],
         defaultSort: sortBy("createdAt", "DESC"),
         queryKey: ["user", "orders", "listing"],
         endpoint: ACCOUNT_ENDPOINTS.ORDERS,
@@ -115,6 +136,7 @@ export function UserOrdersView({ onOrderClick }) {
         buildFilters: (state) => [
             state.status ? sieveFilter("status", SIEVE_OP.EQ, state.status) : null,
             state.orderType ? sieveFilter("orderType", SIEVE_OP.EQ, state.orderType) : null,
+            state.paymentMethod ? sieveFilter("paymentMethod", SIEVE_OP.EQ, state.paymentMethod) : null,
         ]
             .filter(Boolean)
             .join(",") || undefined,
@@ -123,7 +145,7 @@ export function UserOrdersView({ onOrderClick }) {
         // in flight" without those two questions fighting over one control.
         buildExtraParams: () => orderScope.extraParams,
         renderAboveContent: orderScope.renderAboveContent,
-        renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(Stack, { gap: "md", children: [_jsx(FilterChipGroup, { label: "Type", tabs: ORDER_LANE_TABS, value: pendingFilters.orderType ?? "", onChange: (id) => setPendingFilters((prev) => ({ ...prev, orderType: id })) }), _jsx(Div, { children: _jsx(PaginatedSelect, { value: pendingFilters.status || null, onChange: (v) => setPendingFilters((p) => ({ ...p, status: v ?? "" })), options: STATUS_OPTIONS, placeholder: "All statuses", ariaLabel: "Filter by order status" }) })] })),
+        renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(Stack, { gap: "md", children: [_jsx(FilterChipGroup, { label: "Type", tabs: ORDER_LANE_TABS, value: pendingFilters.orderType ?? "", onChange: (id) => setPendingFilters((prev) => ({ ...prev, orderType: id })) }), _jsx(FilterChipGroup, { label: "Payment", tabs: PAYMENT_METHOD_TABS, value: pendingFilters.paymentMethod ?? "", onChange: (id) => setPendingFilters((prev) => ({ ...prev, paymentMethod: id })) }), _jsx(Div, { children: _jsx(PaginatedSelect, { value: pendingFilters.status || null, onChange: (v) => setPendingFilters((p) => ({ ...p, status: v ?? "" })), options: STATUS_OPTIONS, placeholder: "All statuses", ariaLabel: "Filter by order status" }) })] })),
         renderCards: (rows, _view, _selection, isLoading) => {
             if (isLoading) {
                 return (_jsx(Stack, { gap: "md", children: Array.from({ length: 3 }).map((_, i) => (_jsx(Div, { className: "h-24 animate-pulse border border-[var(--appkit-color-border)]", rounded: "xl" }, i))) }));

package/dist/features/admin/components/OwnerQuickActions.d.ts

@@ -1,5 +1,5 @@
 /** Which registry bucket supplies the labels and the confirm copy. */
-export type OwnerQuickActionsResource = "PRODUCT" | "CATEGORY" | "BRAND" | "BUNDLE" | "GROUP" | "SUBLISTING" | "EVENT" | "BLOG" | "REVIEW";
+export type OwnerQuickActionsResource = "PRODUCT" | "CATEGORY" | "BRAND" | "FRANCHISE" | "BUNDLE" | "GROUP" | "SUBLISTING" | "EVENT" | "BLOG" | "REVIEW" | "STORE" | "USER" | "CAROUSEL" | "SECTION";
 export interface OwnerQuickActionsProps {
     resource: OwnerQuickActionsResource;
     /** Where the pencil goes — that record's dashboard editor. */

package/dist/features/admin/components/OwnerQuickActions.js

@@ -54,6 +54,45 @@ import { IconButton } from "../../../ui/components/IconButton.js";
 import { Row, useToast } from "../../../ui/index.js";
 import { normalizeError } from "../../../errors/normalize.js";
 import { toUserMessage } from "../../../errors/error-display-map.js";
+const RESOURCE_LEAVES = {
+    PRODUCT: { bucket: "PRODUCT", edit: "edit", remove: "delete", duplicate: "duplicate" },
+    CATEGORY: { bucket: "CATEGORY", edit: "edit", remove: "delete" },
+    BRAND: { bucket: "BRAND", edit: "edit", remove: "delete" },
+    BUNDLE: { bucket: "BUNDLE", edit: "edit", remove: "delete" },
+    GROUP: { bucket: "GROUP", edit: "edit", remove: "delete" },
+    SUBLISTING: { bucket: "SUBLISTING", edit: "edit", remove: "delete" },
+    EVENT: { bucket: "EVENT", edit: "edit", remove: "delete", duplicate: "duplicate" },
+    REVIEW: { bucket: "REVIEW", edit: "edit", remove: "delete" },
+    /** 🛑 `edit-post` / `delete-post`, not `edit` / `delete`. See the note above. */
+    BLOG: { bucket: "BLOG", edit: "edit-post", remove: "delete-post", duplicate: "duplicate-post" },
+    /**
+     * A franchise row IS a category (`categoryType: "franchise"`), so it reuses
+     * the category leaves rather than duplicating copy that would drift.
+     */
+    FRANCHISE: { bucket: "CATEGORY", edit: "edit", remove: "delete" },
+    /** Carousel slides have no bucket of their own; the leaves live under ADMIN. */
+    CAROUSEL: { bucket: "ADMIN", edit: "edit-carousel", remove: "delete-carousel" },
+    /*
+     * ── The three PENCIL-ONLY resources ─────────────────────────────────────
+     *
+     * `remove` is omitted on purpose for all three. Each is a delete whose blast
+     * radius is far larger than the page the bin would sit on, and a public
+     * surface is the worst possible place to offer it:
+     *
+     * STORE   — deleting a store orphans its products, orders and payouts. The
+     *           dashboard offers `suspend-store` / `verify-store`, which are the
+     *           operations an admin actually wants from a store page.
+     * USER    — deleting a user cascades across orders, reviews, bids and
+     *           addresses. `ADMIN.ban-user` is the reversible tool, and it has
+     *           its own flow with a reason.
+     * SECTION — homepage section `order` is POSITIONAL, so removing one silently
+     *           renumbers its neighbours. There is also no per-section public
+     *           page; the pencil goes to the list that owns them.
+     */
+    STORE: { bucket: "ADMIN", edit: "manage-store" },
+    USER: { bucket: "ADMIN", edit: "manage-user" },
+    SECTION: { bucket: "ADMIN", edit: "edit-section" },
+};
 export function OwnerQuickActions({ resource, editHref, onDelete, onClone, ownerId, storeId, recordLabel, placement = "card", className = "", }) {
     const session = useOptionalSession();
     const isOwnerOrAdmin = useIsOwner(ownerId);
@@ -61,7 +100,8 @@ export function OwnerQuickActions({ resource, editHref, onDelete, onClone, owner
     const { showToast } = useToast();
     const [confirmOpen, setConfirmOpen] = useState(false);
     const [deleting, setDeleting] = useState(false);
-    const bucket = ACTIONS[resource];
+    const leaves = RESOURCE_LEAVES[resource];
+    const bucket = ACTIONS[leaves.bucket];
     const handleConfirmedDelete = useCallback(async () => {
         if (!onDelete)
             return;
@@ -113,10 +153,17 @@ export function OwnerQuickActions({ resource, editHref, onDelete, onClone, owner
      */
     if (!isAdmin && !isOwnerOrAdmin && !ownsStore)
         return null;
-    const editDef = bucket.edit;
-    const deleteDef = bucket.delete;
+    const editDef = bucket[leaves.edit];
+    const deleteDef = leaves.remove ? bucket[leaves.remove] : undefined;
     const confirmation = deleteDef?.confirmation;
-    const showClone = Boolean(onClone) && isAdmin;
+    const showClone = Boolean(onClone) && isAdmin && Boolean(leaves.duplicate);
+    /*
+     * 🛑 `leaves.remove` gates the bin, not just `onDelete`. A resource whose
+     * mapping omits a delete leaf (store, user, homepage section) must render no
+     * bin even if a caller passes `onDelete` — the safety decision belongs to the
+     * resource, not to each of its call sites, or the next call site re-opens it.
+     */
+    const showDelete = Boolean(onDelete) && Boolean(leaves.remove);
     return (_jsxs(_Fragment, { children: [_jsxs(Row, { gap: "xs", align: "center", className: className, 
                 /*
                  * Stops the click reaching an ancestor `<Link>` or the card's own
@@ -135,8 +182,8 @@ export function OwnerQuickActions({ resource, editHref, onDelete, onClone, owner
                              */
                             if (typeof window !== "undefined")
                                 window.location.assign(editHref);
-                        } }), showClone && (_jsx(IconButton, { "aria-label": (bucket.duplicate?.ariaLabel ?? bucket.duplicate?.label) ||
-                            "Duplicate", size: "touch", variant: placement === "card" ? "scrim" : "ghost", icon: _jsx(Icon, { name: "duplicate" }), onClick: () => void onClone?.() })), onDelete && (_jsx(IconButton, { "aria-label": deleteDef?.ariaLabel ?? deleteDef?.label ?? "Delete", size: "touch", variant: placement === "card" ? "scrim" : "danger", icon: _jsx(Icon, { name: "delete" }), onClick: () => setConfirmOpen(true) }))] }), onDelete && (_jsx(ConfirmDeleteModal, { isOpen: confirmOpen, onClose: () => setConfirmOpen(false), onConfirm: handleConfirmedDelete, isDeleting: deleting, title: confirmation?.title ?? "Delete this record?", message: recordLabel && confirmation
+                        } }), showClone && (_jsx(IconButton, { "aria-label": (leaves.duplicate ? bucket[leaves.duplicate]?.ariaLabel ?? bucket[leaves.duplicate]?.label : undefined) ||
+                            "Duplicate", size: "touch", variant: placement === "card" ? "scrim" : "ghost", icon: _jsx(Icon, { name: "duplicate" }), onClick: () => void onClone?.() })), showDelete && (_jsx(IconButton, { "aria-label": deleteDef?.ariaLabel ?? deleteDef?.label ?? "Delete", size: "touch", variant: placement === "card" ? "scrim" : "danger", icon: _jsx(Icon, { name: "delete" }), onClick: () => setConfirmOpen(true) }))] }), showDelete && (_jsx(ConfirmDeleteModal, { isOpen: confirmOpen, onClose: () => setConfirmOpen(false), onConfirm: handleConfirmedDelete, isDeleting: deleting, title: confirmation?.title ?? "Delete this record?", message: recordLabel && confirmation
                     ? `${confirmation.body}\n\nDeleting: ${recordLabel}`
                     : confirmation?.body, confirmText: confirmation?.confirmLabel ?? deleteDef?.label ?? "Delete", variant: "danger" }))] }));
 }

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/blog/components/BlogPostView.js

@@ -11,6 +11,7 @@ import { getMediaUrl } from "../../media/types/index.js";
 import { getDefaultLocale } from "../../../core/baseline-resolver.js";
 import { normalizeRichTextHtml } from "../../../utils/string.formatter.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
+import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
 const __P = {
     p8: "p-[var(--appkit-space-8)]",
 };
@@ -26,7 +27,7 @@ const CATEGORY_BADGE = {
 };
 const CLS_FEATURED_BADGE = "bg-warning-surface text-warning dark:bg-warning-surface dark:text-warning px-[var(--appkit-space-2)] py-[var(--appkit-space-0-5)] rounded-full";
 function renderBlogPostHeader(post, date, labels) {
-    return (_jsxs(Div, { className: "mb-8", children: [_jsxs(Row, { className: "mb-4", gap: "sm", children: [_jsx(Span, { size: "xs", weight: "medium", className: `inline-block capitalize ${CATEGORY_BADGE[post.category] ?? ""}`, rounded: "full", padding: "pill-xs", children: post.category }), post.isFeatured && _jsx(Span, { size: "xs", weight: "medium", className: CLS_FEATURED_BADGE, children: labels?.featured ?? "Featured" })] }), _jsx(Heading, { level: 1, className: "mb-4", size: "3xl", weight: "bold", children: post.title }), post.excerpt && _jsx(Text, { className: "mb-6", color: "muted", size: "lg", children: post.excerpt }), _jsxs(Row, { color: "muted", textSize: "sm", wrap: true, gap: "md", children: [post.authorName && _jsxs(Span, { children: [labels?.author ?? "By", " ", _jsx(Span, { weight: "medium", color: "muted", children: post.authorName })] }), post.readTimeMinutes != null && _jsxs(Span, { children: [post.readTimeMinutes, " ", labels?.readTime ?? "min read"] }), date && _jsxs(Span, { children: [labels?.publishedOn ?? "Published", " ", date] }), post.views != null && _jsxs(Span, { children: [post.views, " ", labels?.viewsLabel ?? "views"] })] })] }));
+    return (_jsxs(Div, { className: "mb-8", children: [_jsxs(Row, { className: "mb-4", gap: "sm", children: [_jsx(Span, { size: "xs", weight: "medium", className: `inline-block capitalize ${CATEGORY_BADGE[post.category] ?? ""}`, rounded: "full", padding: "pill-xs", children: post.category }), post.isFeatured && _jsx(Span, { size: "xs", weight: "medium", className: CLS_FEATURED_BADGE, children: labels?.featured ?? "Featured" })] }), _jsxs(Row, { className: "mb-4", gap: "sm", align: "center", justify: "between", wrap: true, children: [_jsx(Heading, { level: 1, size: "3xl", weight: "bold", children: post.title }), _jsx(OwnerQuickActions, { resource: "BLOG", placement: "detail", editHref: String(ROUTES.ADMIN.BLOG_EDIT(post.id)), recordLabel: post.title })] }), post.excerpt && _jsx(Text, { className: "mb-6", color: "muted", size: "lg", children: post.excerpt }), _jsxs(Row, { color: "muted", textSize: "sm", wrap: true, gap: "md", children: [post.authorName && _jsxs(Span, { children: [labels?.author ?? "By", " ", _jsx(Span, { weight: "medium", color: "muted", children: post.authorName })] }), post.readTimeMinutes != null && _jsxs(Span, { children: [post.readTimeMinutes, " ", labels?.readTime ?? "min read"] }), date && _jsxs(Span, { children: [labels?.publishedOn ?? "Published", " ", date] }), post.views != null && _jsxs(Span, { children: [post.views, " ", labels?.viewsLabel ?? "views"] })] })] }));
 }
 function renderBlogPostRelated(related, title, renderRelatedCard) {
     if (related.length === 0)

package/dist/features/cart/components/CartPriceBreakdown.d.ts

@@ -24,6 +24,7 @@ export interface CartPriceBreakdownStore {
     giftWrapFee: number;
     shipmentProtectionFee: number;
     saleProtectionFee: number;
+    emiSurcharge: number;
     gstAmount: number;
     couponDiscount: number;
     total: number;
@@ -40,6 +41,7 @@ export interface CartPriceBreakdownData {
     giftWrapFee: number;
     shipmentProtectionFee: number;
     saleProtectionFee: number;
+    emiSurcharge: number;
     gstAmount: number;
     couponDiscount: number;
     platformFee: number;

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.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" })))] }));
+    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.emiSurcharge > 0 && (_jsx(Line, { label: "EMI surcharge", amount: money(preview.emiSurcharge) })), 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/categories/components/FranchiseDetailPageView.js

@@ -9,6 +9,8 @@ import { Heading, Text } from "../../../ui/components/Typography.js";
 import { MediaImage } from "../../media/MediaImage.js";
 import { ProductGrid } from "../../products/components/ProductGrid.js";
 import { Alert } from "../../../ui/components/Alert.js";
+import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
+import { ROUTES } from "../../../next/routing/route-map.js";
 const PAGE_SIZE = 24;
 export async function FranchiseDetailPageView({ slug, franchise, }) {
     const result = await safeRead(() => listPublicProducts({
@@ -37,7 +39,7 @@ export async function FranchiseDetailPageView({ slug, franchise, }) {
     const products = rows.map((r) => toProductItem(r));
     const total = reportedTotal ?? products.length;
     const cover = franchise.display?.coverImage;
-    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsxs(Row, { align: "center", gap: "comfortable", className: "mb-8", children: [cover ? (_jsx(MediaImage, { src: cover, alt: franchise.name ?? slug, size: "thumbnail", rounded: "lg" })) : null, _jsxs(Stack, { gap: "dense", children: [_jsx(Heading, { level: 1, color: "primary", size: "3xl", weight: "semibold", children: franchise.name }), franchise.description ? (_jsx(Text, { color: "muted", className: "max-w-2xl", children: franchise.description })) : null] })] }), franchise.isActive === false ? (_jsxs(Alert, { variant: "info", className: "mb-6", children: ["We are not stocking ", franchise.name, " yet. This page is here so the link works \u2014 check back, or browse what we do carry."] })) : null, readFailed ? (_jsxs(Alert, { variant: "warning", children: ["We could not load ", franchise.name, " listings just now. Please try again."] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "muted", className: "mb-4", children: total === 0
+    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsxs(Row, { align: "center", gap: "comfortable", className: "mb-8", children: [cover ? (_jsx(MediaImage, { src: cover, alt: franchise.name ?? slug, size: "thumbnail", rounded: "lg" })) : null, _jsxs(Stack, { gap: "dense", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", wrap: true, children: [_jsx(Heading, { level: 1, color: "primary", size: "3xl", weight: "semibold", children: franchise.name }), franchise.id ? (_jsx(OwnerQuickActions, { resource: "FRANCHISE", placement: "detail", recordLabel: franchise.name ?? slug, editHref: String(ROUTES.ADMIN.CATEGORIES_EDIT(franchise.id)) })) : null] }), franchise.description ? (_jsx(Text, { color: "muted", className: "max-w-2xl", children: franchise.description })) : null] })] }), franchise.isActive === false ? (_jsxs(Alert, { variant: "info", className: "mb-6", children: ["We are not stocking ", franchise.name, " yet. This page is here so the link works \u2014 check back, or browse what we do carry."] })) : null, readFailed ? (_jsxs(Alert, { variant: "warning", children: ["We could not load ", franchise.name, " listings just now. Please try again."] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "muted", className: "mb-4", children: total === 0
                                     ? "No listings yet."
                                     : `${total}${truncated ? "+" : ""} listing${total === 1 ? "" : "s"}` }), _jsx(ProductGrid, { products: products, emptyLabel: "No listings yet." })] }))] }) }) }));
 }

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/faq/components/FAQPageContent.js

@@ -1,12 +1,13 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Alert, Div, EmptyState, Heading, Input, SlottedListingView, Text } from "../../../ui/index.js";
+import { Alert, Div, EmptyState, Heading, Input, Row, SlottedListingView, Text, TextLink } from "../../../ui/index.js";
 import { sortBy } from "../../../constants/sort.js";
 import { FAQCategorySidebar } from "./FAQCategorySidebar.js";
 import { FAQSortDropdown } from "./FAQSortDropdown.js";
 import { FAQAccordion } from "./FAQAccordion.js";
 import { ContactCTA } from "./ContactCTA.js";
 import { useFaqList } from "../hooks/useFaqList.js";
+import { helpGuideFor } from "../constants/help-guides.js";
 export function FAQPageContent({ initialCategory = "all", categories, routeHelpers, labels, contact, searchValue, onSearchChange, sortOption, onSortChange, page = 1, pageSize = 100, renderPagination, renderMobileCategoryTabs, renderAccordion, }) {
     const selectedCategory = initialCategory;
     const sorts = sortOption === "helpful"
@@ -49,9 +50,21 @@ export function FAQPageContent({ initialCategory = "all", categories, routeHelpe
                                 allFaqs: labels.allFaqs,
                                 stillHaveQuestions: labels.stillHaveQuestions,
                                 contactSupport: labels.contactSupport,
-                            } }) }), _jsxs(Div, { className: "col-span-1 lg:col-span-8 xl:col-span-9", children: [_jsx(SlottedListingView, { portal: "public", inlineToolbar: true, className: "space-y-6", renderHeader: () => (_jsxs(Text, { size: "sm", color: "muted", children: [labels.resultCount(total), selectedCategory !== "all"
-                                            ? ` ${labels.inCategory(categories.find((c) => c.key === selectedCategory)?.label ?? selectedCategory)}`
-                                            : ""] })), renderSearch: () => (_jsx(Input, { value: searchValue, onChange: (event) => onSearchChange(event.target.value), placeholder: labels.searchPlaceholder })), renderSort: () => (_jsx(FAQSortDropdown, { selectedSort: sortOption, onSortChange: onSortChange, labels: {
+                            } }) }), _jsxs(Div, { className: "col-span-1 lg:col-span-8 xl:col-span-9", children: [_jsx(SlottedListingView, { portal: "public", inlineToolbar: true, className: "space-y-6", renderHeader: () => {
+                                    /*
+                                     * The fuller answer, next to the short ones.
+                                     *
+                                     * Only on a chosen category: on "all" there is no single guide
+                                     * to offer, and a link to the Help Centre index here would
+                                     * duplicate the footer's for no gain. `helpGuideFor` falls back
+                                     * to the index for the two categories that span the product, so
+                                     * a selected category always has somewhere honest to point.
+                                     */
+                                    const guide = selectedCategory !== "all" ? helpGuideFor(selectedCategory) : null;
+                                    return (_jsxs(Row, { align: "center", justify: "between", gap: "sm", className: "min-w-0", children: [_jsxs(Text, { size: "sm", color: "muted", className: "min-w-0", children: [labels.resultCount(total), selectedCategory !== "all"
+                                                        ? ` ${labels.inCategory(categories.find((c) => c.key === selectedCategory)?.label ?? selectedCategory)}`
+                                                        : ""] }), guide && (_jsxs(TextLink, { href: guide.path, size: "sm", variant: "muted", className: "flex-shrink-0", children: [guide.label, " \u2192"] }))] }));
+                                }, renderSearch: () => (_jsx(Input, { value: searchValue, onChange: (event) => onSearchChange(event.target.value), placeholder: labels.searchPlaceholder })), renderSort: () => (_jsx(FAQSortDropdown, { selectedSort: sortOption, onSortChange: onSortChange, labels: {
                                         label: labels.sortLabel,
                                         helpful: labels.sortHelpful,
                                         newest: labels.sortNewest,

package/dist/features/faq/constants/help-guides.d.ts

@@ -0,0 +1,36 @@
+import type { FAQCategory } from "../types/index";
+/**
+ * The Help Centre guide that answers a FAQ category at length.
+ *
+ * A FAQ is a short answer to one question; a help guide is the surrounding
+ * explanation. They were written as separate surfaces and never linked —
+ * measured 2026-10-20, the FAQ seed contained **zero** `/help/` links across
+ * 91 entries — so a reader who wanted the fuller version had to already know
+ * the Help Centre existed and find the right page in it.
+ *
+ * 🛑 `Record<FAQCategory, …>`, deliberately, so adding a tenth category is a
+ * COMPILE error rather than a category that silently offers no guide. This is
+ * the same decision as `ALL_LISTING_TYPES_MAP` and `EMAIL_ELIGIBLE_TYPES`, and
+ * the reason is Root Cause #61: every hand-written enumeration of a union in
+ * this codebase has eventually fallen behind it.
+ *
+ * `null` is a real answer and not a gap. `technical_support` and `general`
+ * span the whole product, so pointing them at one guide would be arbitrary —
+ * they get the Help Centre index instead, via `HELP_INDEX_PATH`. Writing a
+ * guide to point them at later is a content decision, not a missing entry.
+ *
+ * 🛑 Paths, not `ROUTES`. The Help Centre pages are consumer routes under
+ * `src/app/[locale]/help/`, and `ROUTES` is appkit's own map — adding them
+ * there would make appkit declare pages it does not own. They are stable,
+ * linked from the footer, and covered by `audit-nav-page-wiring`.
+ */
+export declare const HELP_INDEX_PATH: "/help";
+export declare const FAQ_CATEGORY_HELP_GUIDE: Record<FAQCategory, {
+    path: string;
+    label: string;
+} | null>;
+/** The guide for a category, or the Help Centre index when none is specific. */
+export declare function helpGuideFor(category: FAQCategory): {
+    path: string;
+    label: string;
+};

package/dist/features/faq/constants/help-guides.js

@@ -0,0 +1,64 @@
+/**
+ * The Help Centre guide that answers a FAQ category at length.
+ *
+ * A FAQ is a short answer to one question; a help guide is the surrounding
+ * explanation. They were written as separate surfaces and never linked —
+ * measured 2026-10-20, the FAQ seed contained **zero** `/help/` links across
+ * 91 entries — so a reader who wanted the fuller version had to already know
+ * the Help Centre existed and find the right page in it.
+ *
+ * 🛑 `Record<FAQCategory, …>`, deliberately, so adding a tenth category is a
+ * COMPILE error rather than a category that silently offers no guide. This is
+ * the same decision as `ALL_LISTING_TYPES_MAP` and `EMAIL_ELIGIBLE_TYPES`, and
+ * the reason is Root Cause #61: every hand-written enumeration of a union in
+ * this codebase has eventually fallen behind it.
+ *
+ * `null` is a real answer and not a gap. `technical_support` and `general`
+ * span the whole product, so pointing them at one guide would be arbitrary —
+ * they get the Help Centre index instead, via `HELP_INDEX_PATH`. Writing a
+ * guide to point them at later is a content decision, not a missing entry.
+ *
+ * 🛑 Paths, not `ROUTES`. The Help Centre pages are consumer routes under
+ * `src/app/[locale]/help/`, and `ROUTES` is appkit's own map — adding them
+ * there would make appkit declare pages it does not own. They are stable,
+ * linked from the footer, and covered by `audit-nav-page-wiring`.
+ */
+export const HELP_INDEX_PATH = "/help";
+/**
+ * The orders guide, named once because THREE categories share it.
+ *
+ * `orders_payment`, `shipping_delivery` and `returns_refunds` all resolve to
+ * the same page — see the per-entry notes below for why — so the path and the
+ * label were written out three times each. Extracted so a retitle is one edit
+ * rather than three, and so the three cannot drift into disagreeing labels for
+ * one destination.
+ */
+const ORDERS_GUIDE = {
+    path: "/help/orders",
+    label: "Orders, Returns & Support guide",
+};
+export const FAQ_CATEGORY_HELP_GUIDE = {
+    orders_payment: ORDERS_GUIDE,
+    // Shipping questions are about an order in flight, which is what the orders
+    // guide covers end to end. A separate shipping guide does not exist, and a
+    // link to one that did not would be worse than this.
+    shipping_delivery: ORDERS_GUIDE,
+    returns_refunds: ORDERS_GUIDE,
+    // "Is my Beyblade original?" — the vocabulary behind most questions about
+    // what an item actually is.
+    product_information: { path: "/help/authenticity", label: "Is my Beyblade original?" },
+    account_security: { path: "/help/account", label: "Account & Safety guide" },
+    // Safety, not shopping: the account guide is where reporting and blocking
+    // live.
+    scam_awareness: { path: "/help/account", label: "Account & Safety guide" },
+    fees_and_taxes: { path: "/help/shopping", label: "Shopping & Checkout guide" },
+    technical_support: null,
+    general: null,
+};
+/** The guide for a category, or the Help Centre index when none is specific. */
+export function helpGuideFor(category) {
+    return (FAQ_CATEGORY_HELP_GUIDE[category] ?? {
+        path: HELP_INDEX_PATH,
+        label: "Help Centre",
+    });
+}

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

@@ -10,6 +10,8 @@ import { POSITION_FILL, FLEX_CENTER, HERO_PLACEHOLDER_BG } from "../constants/he
 /* The one carousel position/navigation control. The dot and arrow class
    strings this file used to import are deleted — see CarouselNav.style.css. */
 import { CarouselNav } from "../../../ui/components/CarouselNav.js";
+import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
+import { ROUTES } from "../../../next/routing/route-map.js";
 function makeButtonClickHandler(href, openInNewTab, push) {
     return () => {
         if (openInNewTab) {
@@ -88,7 +90,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 +104,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;
 }
@@ -198,7 +202,7 @@ export function HeroCarousel({ initialSlides, push, height, defaultAutoplayDelay
         onMouseEnter: pauseOnHover ? () => setIsPaused(true) : undefined, onMouseLeave: pauseOnHover ? () => setIsPaused(false) : undefined, onFocus: () => setIsPaused(true), onBlur: () => setIsPaused(false), tabIndex: 0, children: [_jsx(Div, { "aria-live": "polite", "aria-atomic": "true", className: "sr-only", children: `Slide ${currentSlide + 1} of ${slides.length}` }), _jsx(Div, { className: POSITION_FILL, children: _jsx(Div, { layout: "flex", ref: slidesRef, onScroll: handleSlidesScroll, className: "h-full overflow-x-auto scroll-smooth snap-x snap-mandatory [scrollbar-width:none] [&::-webkit-scrollbar]:hidden", style: { gap: 0 }, children: slides.map((slide, slideIndex) => {
                         const slideHeightClass = getSlideHeightClass(slide.settings?.height);
                         const hasCards = slide.cards && slide.cards.length > 0;
-                        return (_jsxs(Div, { className: `snap-start flex-none w-full relative self-stretch bg-neutral-900 ${slideHeightClass}`, children: [_jsx(Div, { className: POSITION_FILL, children: _jsx(SlideBackground, { bg: slide.background, legacy: slide.media, mobileLegacy: slide.mobileMedia, isMobile: isMobile, priority: slideIndex === 0 }) }), slide.overlay && (_jsxs(Div, { layout: "flex-col", align: "start", justify: "center", className: `${POSITION_FILL} text-left md:px-[4rem] lg:px-[8rem]`, padding: "x-lg", children: [slide.overlay.subtitle && (_jsx(Text, { color: "inverse", shadow: "sm", className: "stagger-1 opacity-80 mb-1 md:mb-2 tracking-widest", mdSize: "sm", size: "xs", transform: "uppercase", children: slide.overlay.subtitle })), slide.overlay.title && (
+                        return (_jsxs(Div, { className: `snap-start flex-none w-full relative self-stretch bg-neutral-900 ${slideHeightClass}`, children: [_jsx(Div, { className: "absolute bottom-2 left-2 z-10", children: _jsx(OwnerQuickActions, { resource: "CAROUSEL", placement: "card", recordLabel: slide.title ?? `Slide ${slideIndex + 1}`, editHref: String(ROUTES.ADMIN.CAROUSEL_EDIT(slide.id)) }) }), _jsx(Div, { className: POSITION_FILL, children: _jsx(SlideBackground, { bg: slide.background, legacy: slide.media, mobileLegacy: slide.mobileMedia, isMobile: isMobile, priority: slideIndex === 0 }) }), slide.overlay && (_jsxs(Div, { layout: "flex-col", align: "start", justify: "center", className: `${POSITION_FILL} text-left md:px-[4rem] lg:px-[8rem]`, padding: "x-lg", children: [slide.overlay.subtitle && (_jsx(Text, { color: "inverse", shadow: "sm", className: "stagger-1 opacity-80 mb-1 md:mb-2 tracking-widest", mdSize: "sm", size: "xs", transform: "uppercase", children: slide.overlay.subtitle })), slide.overlay.title && (
                                         // level={2}, NOT 1. The welcome section above this
                                         // carousel owns the page's single <h1>; a carousel that
                                         // emits one <h1> per slide gives the document as many

package/dist/features/homepage/components/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;