@mohasinac/appkit 4.56.0 → 4.57.0

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/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/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) {
@@ -200,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/lib/section-renderer.js

@@ -48,6 +48,7 @@ import { CollectionCardsSection } from "../components/CollectionCardsSection.js"
 import { HowItWorksSection } from "../components/HowItWorksSection.js";
 import { TestimonialsCarousel } from "../components/TestimonialsCarousel.js";
 import { PromoGrid } from "../components/PromoGrid.js";
+import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
 const AD_SLOT_MAP = {
     carousel: "afterHero",
     products: "afterFeaturedProducts",
@@ -433,6 +434,6 @@ export function renderSection(section, adSlots, newsletterFormSlot, faqItems, sl
     if (!sectionElement)
         return null;
     const adSlotKey = AD_SLOT_MAP[section.type];
-    return (_jsxs(React.Fragment, { children: [_jsx(HomepageSectionBoundary, { sectionId: section.id, sectionType: section.type, children: sectionElement }), adSlots && adSlotKey !== undefined && adSlotKey in adSlots && adSlots[adSlotKey]] }, section.id));
+    return (_jsxs(React.Fragment, { children: [_jsx(OwnerQuickActions, { resource: "SECTION", placement: "detail", className: "justify-end", recordLabel: section.type, editHref: String(ROUTES.ADMIN.SECTIONS) }), _jsx(HomepageSectionBoundary, { sectionId: section.id, sectionType: section.type, children: sectionElement }), adSlots && adSlotKey !== undefined && adSlotKey in adSlots && adSlots[adSlotKey]] }, section.id));
 }
 export { AnnouncementBar, hashBannerMessage };

package/dist/features/orders/components/EmiInstallmentsPanel.d.ts

@@ -0,0 +1,19 @@
+import React from "react";
+import type { EmiInstallment } from "../schemas/firestore";
+export interface EmiInstallmentsPanelProps {
+    orderId: string;
+    installments: readonly EmiInstallment[];
+    /** Sum of unpaid instalments, as recorded on the order. */
+    remainingBalance?: number;
+    currency?: string;
+    /**
+     * Submits one instalment. Supplied by the consumer so this component does
+     * no fetching of its own — the same slot shape the rest of the orders
+     * feature uses.
+     */
+    onSubmit: (input: {
+        installmentIndex: number;
+        transactionId: string;
+    }) => Promise<void>;
+}
+export declare function EmiInstallmentsPanel({ orderId, installments, remainingBalance, currency, onSubmit, }: EmiInstallmentsPanelProps): React.JSX.Element;

package/dist/features/orders/components/EmiInstallmentsPanel.js

@@ -0,0 +1,57 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Badge, Button, Div, Form, Row, Stack, Text, useToast } from "../../../ui/index.js";
+import { FieldInput } from "../../../ui/forms/index.js";
+import { formatCurrency } from "../../../utils/number.formatter.js";
+import { normalizeError } from "../../../errors/normalize.js";
+function stateOf(i) {
+    if (i.status === "paid")
+        return "paid";
+    // A reference the buyer submitted but nobody has confirmed. The status
+    // field cannot express this: an instalment is created "pending" and stays
+    // "pending" until it is paid, so the presence of a reference is the signal.
+    if (i.transactionId)
+        return "awaiting-review";
+    return "payable";
+}
+const STATE_LABEL = {
+    paid: "Paid",
+    "awaiting-review": "Awaiting confirmation",
+    payable: "Due",
+};
+export function EmiInstallmentsPanel({ orderId, installments, remainingBalance, currency = "INR", onSubmit, }) {
+    const { showToast } = useToast();
+    const [openIndex, setOpenIndex] = useState(null);
+    const [reference, setReference] = useState("");
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    const money = (value) => formatCurrency(value, currency);
+    const ordered = [...installments].sort((a, b) => a.index - b.index);
+    const outstanding = ordered.filter((i) => i.status !== "paid").length;
+    const submit = async (index) => {
+        setIsSubmitting(true);
+        try {
+            await onSubmit({ installmentIndex: index, transactionId: reference.trim() });
+            showToast("Payment reference submitted — the seller will confirm it.", "success");
+            setOpenIndex(null);
+            setReference("");
+        }
+        catch (err) {
+            void normalizeError(err);
+            // The action's own message is surfaced by the caller's error mapping;
+            // this only has to stop the panel pretending the submission landed.
+            showToast("Couldn't submit that payment. Please try again.", "error");
+        }
+        finally {
+            setIsSubmitting(false);
+        }
+    };
+    return (_jsx(Div, { surface: "card", border: "default", rounded: "lg", padding: "md", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { align: "center", justify: "between", gap: "sm", children: [_jsx(Text, { weight: "semibold", children: "Your EMI plan" }), remainingBalance !== undefined && remainingBalance > 0 && (_jsxs(Text, { size: "sm", color: "muted", children: [money(remainingBalance), " outstanding across ", outstanding, " instalment", outstanding === 1 ? "" : "s"] }))] }), _jsx(Text, { size: "xs", color: "muted", children: "You can pay any instalment whenever you like, including ahead of its due date \u2014 paying early settles the plan sooner and does not cost more." }), _jsx(Stack, { gap: "xs", children: ordered.map((inst) => {
+                        const state = stateOf(inst);
+                        const due = inst.dueDate ? new Date(inst.dueDate) : null;
+                        return (_jsxs(Div, { border: "default", rounded: "md", padding: "sm", children: [_jsxs(Row, { align: "center", justify: "between", gap: "sm", className: "min-w-0", children: [_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsxs(Text, { size: "sm", weight: "medium", children: ["Instalment ", inst.index, " \u00B7 ", money(inst.amount)] }), _jsx(Text, { size: "xs", color: "muted", children: due ? `Due ${due.toLocaleDateString()}` : "No due date recorded" })] }), _jsxs(Row, { align: "center", gap: "xs", className: "flex-shrink-0", children: [_jsx(Badge, { variant: state === "paid" ? "success" : state === "awaiting-review" ? "warning" : "default", children: STATE_LABEL[state] }), state === "payable" && (_jsx(Button, { type: "button", size: "sm", variant: "secondary", onClick: () => {
+                                                        setOpenIndex(openIndex === inst.index ? null : inst.index);
+                                                        setReference("");
+                                                    }, children: openIndex === inst.index ? "Cancel" : "Pay now" }))] })] }), openIndex === inst.index && (_jsx(Div, { className: "mt-3", children: _jsx(Form, { onSubmit: (e) => e.preventDefault(), children: () => (_jsxs(Stack, { gap: "sm", children: [_jsxs(Text, { size: "xs", color: "muted", children: ["Transfer ", money(inst.amount), " to the seller, then enter the UTR or reference number so they can confirm it."] }), _jsx(FieldInput, { name: `emi-reference-${orderId}-${inst.index}`, label: "UTR / reference number", required: true, value: reference, onChange: setReference }), _jsx(Button, { type: "submit", size: "sm", isLoading: isSubmitting, disabled: reference.trim().length === 0 || isSubmitting, onClick: () => { void submit(inst.index); }, children: "Submit payment reference" })] })) }) }))] }, inst.index));
+                    }) })] }) }));
+}

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

@@ -14,3 +14,4 @@ export { RefundRequestView } from "./RefundRequestView";
 export type { RefundRequestViewProps } from "./RefundRequestView";
 export { YourPurchaseStrip } from "./YourPurchaseStrip";
 export type { YourPurchaseStripProps, PurchaseContext } from "./YourPurchaseStrip";
+export { EmiInstallmentsPanel, type EmiInstallmentsPanelProps, } from "./EmiInstallmentsPanel";

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

@@ -7,3 +7,4 @@ export { OrderStatusTimeline } from "./OrderStatusTimeline.js";
 export { RefundHistoryTable } from "./RefundHistoryTable.js";
 export { RefundRequestView } from "./RefundRequestView.js";
 export { YourPurchaseStrip } from "./YourPurchaseStrip.js";
+export { EmiInstallmentsPanel, } from "./EmiInstallmentsPanel.js";

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

@@ -614,6 +614,7 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     } | undefined;
     offerId?: string | undefined;
     orderType?: string | undefined;
+    isNonRefundable?: boolean | undefined;
     imageUrls?: string[] | undefined;
     refundFeeDeducted?: number | undefined;
     refundNetAmount?: number | undefined;
@@ -650,7 +651,6 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     }[] | undefined;
     emiRemainingBalance?: number | undefined;
     emiComplete?: boolean | undefined;
-    isNonRefundable?: boolean | undefined;
     paymentBatchId?: string | undefined;
     refunds?: {
         type: "full" | "partial";
@@ -762,6 +762,7 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     } | undefined;
     offerId?: string | undefined;
     orderType?: string | undefined;
+    isNonRefundable?: boolean | undefined;
     imageUrls?: string[] | undefined;
     refundFeeDeducted?: number | undefined;
     refundNetAmount?: number | undefined;
@@ -798,7 +799,6 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     }[] | undefined;
     emiRemainingBalance?: number | undefined;
     emiComplete?: boolean | undefined;
-    isNonRefundable?: boolean | undefined;
     paymentBatchId?: string | undefined;
     refunds?: {
         type: "full" | "partial";

package/dist/features/orders/types/index.d.ts

@@ -1,3 +1,4 @@
+import type { EmiInstallment } from "../schemas/firestore";
 import type { ListingType } from "../../products/types/index";
 import type { OrderType } from "../utils/order-splitter";
 import type { AppliedOrderDiscount, OrderSourceContext } from "../schemas/firestore";
@@ -183,6 +184,20 @@ export interface Order {
      * read it from site settings, because `gst` is in `PRIVATE_SITE_FIELDS`
      * after an earlier deny-list projection shipped it publicly (Root Cause #70).
      */
+    /**
+     * ── EMI, buyer-facing ─────────────────────────────────────────────────
+     *
+     * 🛑 Declared here because `EmiInstallmentsPanel` is useless without it,
+     * and the absence was Root Cause #57's exact shape: the whole EMI schedule
+     * sat on `OrderDocument` and `orderDocumentToOrder` mapped none of it, so
+     * every buyer surface would have rendered its "no EMI plan" fallback with
+     * a real plan on the record. That reads as "this order isn't on EMI"
+     * rather than as a bug, which is why it survives.
+     */
+    emiEnabled?: boolean;
+    emiInstallments?: EmiInstallment[];
+    /** Sum of unpaid instalments. 0 once the plan is settled. */
+    emiRemainingBalance?: number;
     supplierGstin?: string;
     supplierLegalName?: string;
     supplierAddress?: string;

package/dist/features/points/repository/points.repository.js

@@ -1,5 +1,5 @@
 import { getAdminDb } from "../../../providers/db-firebase/index.js";
-import { POINTS_LEDGER_COLLECTION, isPointsEntryWellFormed, } from "../schemas/firestore.js";
+import { POINTS_FIELDS, POINTS_LEDGER_COLLECTION, isPointsEntryWellFormed, } from "../schemas/firestore.js";
 import { USER_COLLECTION } from "../../auth/schemas/firestore.js";
 /**
  * The points ledger: append-only entries, and a balance that is their sum.
@@ -51,8 +51,8 @@ export class PointsRepository {
         const db = getAdminDb();
         const rows = await db
             .collection(POINTS_LEDGER_COLLECTION)
-            .where("userId", "==", userId)
-            .select("amount")
+            .where(POINTS_FIELDS.USER_ID, "==", userId)
+            .select(POINTS_FIELDS.AMOUNT)
             .get();
         const total = rows.docs.reduce((sum, d) => sum + (Number(d.data().amount) || 0), 0);
         return Math.round(total * 100) / 100;
@@ -145,8 +145,8 @@ export class PointsRepository {
         const db = getAdminDb();
         const rows = await db
             .collection(POINTS_LEDGER_COLLECTION)
-            .where("userId", "==", userId)
-            .orderBy("createdAt", "desc")
+            .where(POINTS_FIELDS.USER_ID, "==", userId)
+            .orderBy(POINTS_FIELDS.CREATED_AT, "desc")
             .limit(limit)
             .get();
         return rows.docs.map((d) => d.data());

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

@@ -81,6 +81,22 @@ export interface PointsLedgerEntry extends BaseDocument {
  */
 export declare function isPointsEntryWellFormed(entry: Pick<PointsLedgerEntry, "kind" | "amount" | "adminReason">): boolean;
 export declare const POINTS_LEDGER_COLLECTION = "pointsLedger";
+/**
+ * Firestore field names for this collection.
+ *
+ * Declared rather than written as string literals at the query site, matching
+ * every other collection here: a typo in a raw `where("userID", ...)` is a
+ * query that returns nothing and raises nothing, which on a points balance
+ * reads as "you have no points" rather than as a bug.
+ */
+export declare const POINTS_FIELDS: {
+    readonly ID: "id";
+    readonly USER_ID: "userId";
+    readonly KIND: "kind";
+    readonly AMOUNT: "amount";
+    readonly ORDER_ID: "orderId";
+    readonly CREATED_AT: "createdAt";
+};
 /**
  * 🛑 Points cannot pay for the whole order, and this is the cap that enforces
  * it.

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

@@ -71,6 +71,22 @@ export function isPointsEntryWellFormed(entry) {
     }
 }
 export const POINTS_LEDGER_COLLECTION = "pointsLedger";
+/**
+ * Firestore field names for this collection.
+ *
+ * Declared rather than written as string literals at the query site, matching
+ * every other collection here: a typo in a raw `where("userID", ...)` is a
+ * query that returns nothing and raises nothing, which on a points balance
+ * reads as "you have no points" rather than as a bug.
+ */
+export const POINTS_FIELDS = {
+    ID: "id",
+    USER_ID: "userId",
+    KIND: "kind",
+    AMOUNT: "amount",
+    ORDER_ID: "orderId",
+    CREATED_AT: "createdAt",
+};
 /**
  * 🛑 Points cannot pay for the whole order, and this is the cap that enforces
  * it.
@@ -94,6 +110,7 @@ export function maxRedeemablePoints(orderTotal, balance) {
         return 0;
     if (!Number.isFinite(balance) || balance <= 0)
         return 0;
+    // audit-money-units-ok: a percentage of an order total, not a paise/rupee conversion
     const cap = Math.floor((orderTotal * POINTS_MAX_REDEMPTION_PERCENT) / 100);
     return Math.max(0, Math.min(Math.floor(balance), cap));
 }

package/dist/features/reviews/components/ReviewDetailPageView.js

@@ -2,10 +2,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Link from "next/link.js";
 import { reviewRepository } from "../../../repositories/index.js";
 import { safeRead } from "../../../errors/safe-read.js";
-import { Container, Div, Grid, Heading, Main, Nav, Section, Span, Text } from "../../../ui/index.js";
+import { Container, Div, Grid, Heading, Main, Nav, Row, Section, Span, Text } from "../../../ui/index.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
 import { ReviewDetailShell } from "./ReviewDetailShell.js";
 import { ReviewCard } from "./ReviewsList.js";
+import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
 export async function ReviewDetailPageView({ id }) {
     // The review IS this page's subject — a read failure must surface rather than
     // become the same `null` a removed review produces, which the "Review not
@@ -42,5 +43,5 @@ export async function ReviewDetailPageView({ id }) {
     ]);
     const sameProductReviews = sameProductDocs.filter((r) => r.id !== review.id).slice(0, 6);
     const sameStoreReviews = sameStoreDocs.filter((r) => r.id !== review.id).slice(0, 6);
-    return (_jsxs(Main, { children: [_jsx(Div, { paddingY: "y-xs-tall", className: "border-b border-neutral-100 bg-neutral-50", padding: "x-md", children: _jsxs(Nav, { layout: "flex", gap: "2xs", textSize: "xs", color: "faint", className: "mx-auto max-w-3xl", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: "hover:text-primary transition-colors", children: "Home" }), _jsx(Span, { children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.REVIEWS), className: "hover:text-primary transition-colors", children: "Reviews" }), _jsx(Span, { children: "/" }), _jsx(Span, { className: "text-neutral-700 truncate max-w-[200px]", children: review.title ?? review.id })] }) }), _jsx(ReviewDetailShell, { review: review, storeHref: storeSlug ? String(ROUTES.PUBLIC.STORE_DETAIL(storeSlug)) : null }), sameProductReviews.length > 0 && (_jsx(Section, { padding: "y-lg", border: "subtle", className: "border-t", children: _jsxs(Container, { size: "sm", children: [_jsxs(Heading, { level: 2, className: "mb-4", size: "lg", weight: "semibold", children: ["More reviews for ", review.productTitle ?? "this product"] }), _jsx(Grid, { cols: "cardsWide", gap: "md", children: sameProductReviews.map((r) => (_jsx(ReviewCard, { review: r, context: "listing" }, r.id))) })] }) })), sameStoreReviews.length > 0 && (_jsx(Section, { padding: "y-lg", border: "subtle", className: "border-t", children: _jsxs(Container, { size: "sm", children: [_jsxs(Heading, { level: 2, className: "mb-4", size: "lg", weight: "semibold", children: ["More reviews for ", review.storeName ?? "this store"] }), _jsx(Grid, { cols: "cardsWide", gap: "md", children: sameStoreReviews.map((r) => (_jsx(ReviewCard, { review: r, context: "store" }, r.id))) })] }) }))] }));
+    return (_jsxs(Main, { children: [_jsx(Div, { paddingY: "y-xs-tall", className: "border-b border-neutral-100 bg-neutral-50", padding: "x-md", children: _jsxs(Nav, { layout: "flex", gap: "2xs", textSize: "xs", color: "faint", className: "mx-auto max-w-3xl", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: "hover:text-primary transition-colors", children: "Home" }), _jsx(Span, { children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.REVIEWS), className: "hover:text-primary transition-colors", children: "Reviews" }), _jsx(Span, { children: "/" }), _jsx(Span, { className: "text-neutral-700 truncate max-w-[200px]", children: review.title ?? review.id })] }) }), _jsx(Row, { justify: "end", className: "mb-2", children: _jsx(OwnerQuickActions, { resource: "REVIEW", placement: "detail", ownerId: review.userId, recordLabel: review.title ?? review.id, editHref: String(ROUTES.USER.REVIEW_EDIT(review.id)) }) }), _jsx(ReviewDetailShell, { review: review, storeHref: storeSlug ? String(ROUTES.PUBLIC.STORE_DETAIL(storeSlug)) : null }), sameProductReviews.length > 0 && (_jsx(Section, { padding: "y-lg", border: "subtle", className: "border-t", children: _jsxs(Container, { size: "sm", children: [_jsxs(Heading, { level: 2, className: "mb-4", size: "lg", weight: "semibold", children: ["More reviews for ", review.productTitle ?? "this product"] }), _jsx(Grid, { cols: "cardsWide", gap: "md", children: sameProductReviews.map((r) => (_jsx(ReviewCard, { review: r, context: "listing" }, r.id))) })] }) })), sameStoreReviews.length > 0 && (_jsx(Section, { padding: "y-lg", border: "subtle", className: "border-t", children: _jsxs(Container, { size: "sm", children: [_jsxs(Heading, { level: 2, className: "mb-4", size: "lg", weight: "semibold", children: ["More reviews for ", review.storeName ?? "this store"] }), _jsx(Grid, { cols: "cardsWide", gap: "md", children: sameStoreReviews.map((r) => (_jsx(ReviewCard, { review: r, context: "store" }, r.id))) })] }) }))] }));
 }