@mohasinac/appkit 4.69.1 → 4.71.0

package/dist/features/auth/hooks/useAuth.js

@@ -4,6 +4,13 @@ import { useCallback, useEffect, useRef, useState } from "react";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { getClientAuthProvider } from "../../../contracts/client-auth.js";
 import { getClientSessionAdapter } from "../../../contracts/client-session.js";
+/*
+ * 🛑 The auth-popup message type is a CROSS-PACKAGE contract: appkit listens
+ * here, the consumer's /auth/close page posts. Both must read this constant —
+ * namespacing one side only makes the popup post a message nobody hears, and
+ * OAuth login fails silently with no type error anywhere.
+ */
+import { MESSAGE_TYPES, STORAGE_KEYS } from "../../../constants/storage-keys.js";
 import { apiClient } from "../../../http/index.js";
 import { useAuthEvent } from "./useAuthEvent.js";
 import { RealtimeEventStatus } from "../../../react/hooks/useRealtimeEvent.js";
@@ -113,7 +120,7 @@ export function useGoogleLogin(options) {
         const handleMessage = (event) => {
             if (event.origin !== window.location.origin)
                 return;
-            if (!event.data || event.data.type !== "letitrip_auth_close")
+            if (!event.data || event.data.type !== MESSAGE_TYPES.authClose)
                 return;
             if (calledRef.current)
                 return;
@@ -159,7 +166,7 @@ export function useGoogleLogin(options) {
             authEvent.reset();
             const { eventId, customToken, rtdbEnabled } = await apiClient.post(AUTH_ENDPOINTS.EVENT_INIT, {});
             const url = `${window.location.origin}${AUTH_ENDPOINTS.GOOGLE_START}?eventId=${encodeURIComponent(eventId)}`;
-            localStorage.setItem("letitrip_oauth_redirect", url);
+            localStorage.setItem(STORAGE_KEYS.oauthRedirect, url);
             // Only subscribe to RTDB if it's available — skipping avoids an immediate
             // FAILED status (token sign-in error) that would block the postMessage fallback.
             if (rtdbEnabled !== false) {
@@ -229,7 +236,7 @@ export function useLinkGoogleAccount(options) {
         const handleMessage = (event) => {
             if (event.origin !== window.location.origin)
                 return;
-            if (!event.data || event.data.type !== "letitrip_auth_close")
+            if (!event.data || event.data.type !== MESSAGE_TYPES.authClose)
                 return;
             if (calledRef.current)
                 return;
@@ -270,7 +277,7 @@ export function useLinkGoogleAccount(options) {
             authEvent.reset();
             const { eventId, customToken, rtdbEnabled } = await apiClient.post(AUTH_ENDPOINTS.EVENT_INIT, { mode: "link" });
             const url = `${window.location.origin}${AUTH_ENDPOINTS.GOOGLE_START}?eventId=${encodeURIComponent(eventId)}`;
-            localStorage.setItem("letitrip_oauth_redirect", url);
+            localStorage.setItem(STORAGE_KEYS.oauthRedirect, url);
             if (rtdbEnabled !== false) {
                 authEvent.subscribe(eventId, customToken);
             }

package/dist/features/cart/utils/pending-ops.js

@@ -6,9 +6,22 @@
  * The sync manager replays these and clears them after a successful push.
  */
 import { normalizeError } from "../../../errors/normalize.js";
-const APP_ID = () => typeof process !== "undefined" && process.env.NEXT_PUBLIC_APP_ID
-    ? process.env.NEXT_PUBLIC_APP_ID
-    : "letitrip";
+import { getStorageNamespace } from "../../../constants/storage-keys.js";
+/*
+ * 🛑 A SECOND storage-key namespace owner, now removed.
+ *
+ * A1 made `constants/storage-keys.ts` the one namespace, injected by the
+ * consumer via `setStorageNamespace()`. This file had its own parallel
+ * mechanism reading a DIFFERENT env var (`NEXT_PUBLIC_APP_ID`) with a
+ * hardcoded `"letitrip"` fallback — so two modules decided what prefixes a
+ * browser key, and only one of them was configurable.
+ *
+ * The resolved value is unchanged for this install (the namespace is also
+ * "letitrip"), which matters: changing the prefix would ORPHAN every queued
+ * cart/wishlist op already sitting in a returning visitor's localStorage
+ * rather than migrating it.
+ */
+const APP_ID = () => getStorageNamespace();
 const CART_OPS_KEY = () => `${APP_ID()}_cart_ops`;
 const WL_OPS_KEY = () => `${APP_ID()}_wl_ops`;
 /** Fired whenever the pending cart/wishlist op queue changes, so a badge

package/dist/features/catalogue/utils/product-from-item.d.ts

@@ -1,8 +1,24 @@
 import type { CatalogueItemDocument } from "../schemas/firestore";
 import type { ProductDocument } from "../../products/schemas/firestore";
-/** The platform's own consignment store — used whenever a catalogue item is
+/**
+ * The platform's own consignment store — used whenever a catalogue item is
  * listed by someone with no personal seller store of their own (buyer
- * approval path, admin direct-list path). */
+ * approval path, admin direct-list path).
+ *
+ * 🛑 DERIVED, no longer its own literal. `store-letitrip-official` was written
+ * out three times: here, as `PLATFORM_STORE_ID` in
+ * `features/stores/schemas/firestore.ts`, and again in the consumer's
+ * shipment-link route. And the comment on `PLATFORM_STORE_ID` justified its
+ * copy by pointing AT this one — "the same literal already lives legitimately
+ * (`CONSIGNMENT_STORE_ID` …)". That argument is about WHERE a brand-bearing
+ * literal may live (`audit-ssr-in-appkit` Rule 3 bars `_internal/`); it says
+ * nothing about how many copies there may be, and reading it as permission
+ * gave one id three owners (Root Cause #42).
+ *
+ * They are the same store, in two roles. If a consumer ever needs a separate
+ * consignment storefront, that is a deliberate second configured value — not
+ * a literal that drifted from this one.
+ */
 export declare const CONSIGNMENT_STORE_ID = "store-letitrip-official";
 /**
  * Shared field mapping from a catalogue item to a new product — used by

package/dist/features/catalogue/utils/product-from-item.js

@@ -1,8 +1,26 @@
 import { productRepository } from "../../products/repository/products.repository.js";
-/** The platform's own consignment store — used whenever a catalogue item is
+import { getBrandName } from "../../../core/brand-resolver.js";
+import { PLATFORM_STORE_ID } from "../../stores/schemas/firestore.js";
+/**
+ * The platform's own consignment store — used whenever a catalogue item is
  * listed by someone with no personal seller store of their own (buyer
- * approval path, admin direct-list path). */
-export const CONSIGNMENT_STORE_ID = "store-letitrip-official";
+ * approval path, admin direct-list path).
+ *
+ * 🛑 DERIVED, no longer its own literal. `store-letitrip-official` was written
+ * out three times: here, as `PLATFORM_STORE_ID` in
+ * `features/stores/schemas/firestore.ts`, and again in the consumer's
+ * shipment-link route. And the comment on `PLATFORM_STORE_ID` justified its
+ * copy by pointing AT this one — "the same literal already lives legitimately
+ * (`CONSIGNMENT_STORE_ID` …)". That argument is about WHERE a brand-bearing
+ * literal may live (`audit-ssr-in-appkit` Rule 3 bars `_internal/`); it says
+ * nothing about how many copies there may be, and reading it as permission
+ * gave one id three owners (Root Cause #42).
+ *
+ * They are the same store, in two roles. If a consumer ever needs a separate
+ * consignment storefront, that is a deliberate second configured value — not
+ * a literal that drifted from this one.
+ */
+export const CONSIGNMENT_STORE_ID = PLATFORM_STORE_ID;
 /**
  * Shared field mapping from a catalogue item to a new product — used by
  * both the direct-listing path (seller/admin) and the admin-approval path
@@ -14,7 +32,8 @@ export const CONSIGNMENT_STORE_ID = "store-letitrip-official";
 export async function createProductFromCatalogueItem(item, storeId) {
     return productRepository.create({
         title: item.title,
-        description: item.description || "Listed via LetItRip's personal catalogue.",
+        description: item.description ||
+            `Listed via ${getBrandName()}'s personal catalogue.`,
         categorySlugs: item.categorySlugs ?? [],
         brandSlug: item.brandSlug,
         price: item.price ?? 0,

package/dist/features/categories/components/BundleItemsPicker.js

@@ -25,6 +25,7 @@ import { BUNDLE_MAX_ITEMS, BUNDLE_MIN_ITEMS, } from "../../../_internal/shared/f
 import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy.js";
 import { PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { productImageUrls } from "../../products/schemas/firestore.js";
+import { formatMoney } from "../../../utils/number.formatter.js";
 const __P = {
     p3: "p-[var(--appkit-space-3)]",
 };
@@ -48,7 +49,7 @@ function renderBundleSearchResults(props) {
     return (_jsxs(_Fragment, { children: [searchError && _jsx(Text, { size: "sm", color: "danger", children: searchError }), isSearching && _jsx(Text, { size: "sm", color: "muted", children: BUNDLE_COPY.picker.searchingHint }), !isSearching && debouncedQuery.length >= 2 && results.length === 0 && !searchError && (_jsx(Text, { size: "sm", color: "muted", children: BUNDLE_COPY.picker.noMatches(debouncedQuery) })), results.length > 0 && (_jsx(Div, { className: `max-h-72 ${__O.yAuto}`, rounded: "lg", border: "default", children: results.map((r) => {
                     const isSelected = selectedSet.has(r.id);
                     const atCap = !isSelected && value.length >= maxItems;
-                    return (_jsxs(Row, { border: "subtle", gap: "sm", align: "center", className: `border-b last:border-b-0 ${isSelected ? CLS_ROW_SELECTED : ""} ${atCap ? "opacity-50" : ""}`, padding: "inlineSm", children: [_jsx(Checkbox, { checked: isSelected, disabled: atCap, onChange: () => toggle(r.id), "aria-label": BUNDLE_COPY.picker.toggleAria(r.title) }), _jsxs(Stack, { gap: "xs", className: "flex-1", children: [_jsx(Text, { size: "sm", weight: "medium", children: r.title }), _jsxs(Row, { gap: "sm", children: [_jsx(Text, { size: "xs", color: "muted", children: r.id }), typeof r.price === "number" && _jsxs(Text, { size: "xs", color: "muted", children: ["\u00B7 \u20B9", r.price.toLocaleString("en-IN")] })] })] })] }, r.id));
+                    return (_jsxs(Row, { border: "subtle", gap: "sm", align: "center", className: `border-b last:border-b-0 ${isSelected ? CLS_ROW_SELECTED : ""} ${atCap ? "opacity-50" : ""}`, padding: "inlineSm", children: [_jsx(Checkbox, { checked: isSelected, disabled: atCap, onChange: () => toggle(r.id), "aria-label": BUNDLE_COPY.picker.toggleAria(r.title) }), _jsxs(Stack, { gap: "xs", className: "flex-1", children: [_jsx(Text, { size: "sm", weight: "medium", children: r.title }), _jsxs(Row, { gap: "sm", children: [_jsx(Text, { size: "xs", color: "muted", children: r.id }), typeof r.price === "number" && _jsxs(Text, { size: "xs", color: "muted", children: ["\u00B7 ", formatMoney(r.price)] })] })] })] }, r.id));
                 }) }))] }));
 }
 export function BundleItemsPicker({ value, onChange, fetchProducts, minItems = BUNDLE_MIN_ITEMS, maxItems = BUNDLE_MAX_ITEMS, initialMetadata = {}, }) {

package/dist/features/categories/components/CategoryDetailPageView.js

@@ -36,6 +36,7 @@ import { breadcrumbJsonLd, collectionPageJsonLd, faqJsonLd, } from "../../../seo
 import { toStoreListItem } from "../../../_internal/server/features/stores/adapters.js";
 import { hidePublicTestData } from "../../../_internal/server/features/tester/visibility.js";
 import { productImageUrls } from "../../products/schemas/firestore.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 const __O = {
     hidden: "overflow-hidden",
 };
@@ -603,7 +604,7 @@ export async function CategoryDetailPageView({ slug }) {
     const ldFaq = category?.faqs && category.faqs.length > 0
         ? faqJsonLd(category.faqs.map((f) => ({ question: f.question, answer: f.answer })))
         : null;
-    return (_jsxs(Main, { children: [_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldBreadcrumb) } }), _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldCollection) } }), ldFaq && (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldFaq) } })), _jsxs(Section, { className: `relative ${__O.hidden} ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-[var(--appkit-color-bg)]"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: coverImage, alt: "", size: "banner" }) }), _jsx(Div, { surface: "overlay-md", className: "absolute inset-0" })] })), !hasCover && hasMosaic && (_jsx(Div, { className: "relative z-10 max-w-7xl mx-auto", padding: "x-md", children: _jsx(Div, { padding: "t-lg", children: _jsx(ImageMosaic, { images: mosaicImages, alt: `${category?.name ?? slug} on LetItRip` }) }) })), _jsxs(Div, { className: "relative z-10 max-w-7xl mx-auto", paddingY: hasCover ? "y-3xl" : "y-xl", padding: "x-md", children: [_jsx(BreadcrumbTrail, { crumbs: trail, className: "mb-4", tone: hasCover ? "on-media" : "default" }), category?.id && _jsx(LastCategoryBeacon, { categoryId: category.id }), _jsx(Heading, { color: "inverse", level: 1, className: `mb-2 ${hasCover ? "" : "text-[var(--appkit-color-text)]"}`, size: "3xl", mdSize: "4xl", weight: "bold", children: category?.name ?? slug }), category?.id && (_jsx(RecordOwnerQuickActions, { resource: "CATEGORY", recordId: category.id, placement: "detail", 
+    return (_jsxs(Main, { children: [_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldBreadcrumb) } }), _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldCollection) } }), ldFaq && (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ldFaq) } })), _jsxs(Section, { className: `relative ${__O.hidden} ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-[var(--appkit-color-bg)]"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: coverImage, alt: "", size: "banner" }) }), _jsx(Div, { surface: "overlay-md", className: "absolute inset-0" })] })), !hasCover && hasMosaic && (_jsx(Div, { className: "relative z-10 max-w-7xl mx-auto", padding: "x-md", children: _jsx(Div, { padding: "t-lg", children: _jsx(ImageMosaic, { images: mosaicImages, alt: `${category?.name ?? slug} on ${getBrandName()}` }) }) })), _jsxs(Div, { className: "relative z-10 max-w-7xl mx-auto", paddingY: hasCover ? "y-3xl" : "y-xl", padding: "x-md", children: [_jsx(BreadcrumbTrail, { crumbs: trail, className: "mb-4", tone: hasCover ? "on-media" : "default" }), category?.id && _jsx(LastCategoryBeacon, { categoryId: category.id }), _jsx(Heading, { color: "inverse", level: 1, className: `mb-2 ${hasCover ? "" : "text-[var(--appkit-color-text)]"}`, size: "3xl", mdSize: "4xl", weight: "bold", children: category?.name ?? slug }), category?.id && (_jsx(RecordOwnerQuickActions, { resource: "CATEGORY", recordId: category.id, placement: "detail", 
                                 /*
                                  * Same flag the rest of this hero branches on. Without it the
                                  * pencil renders `ghost` (zinc-600) on the dark cover and is

package/dist/features/categories/components/ContextualTrail.d.ts

@@ -41,8 +41,15 @@ import type { BreadcrumbCrumb } from "../utils/breadcrumb-chain";
  * @tag layer:client-component
  * @tag access:client-only
  */
-/** The `sessionStorage` key. Read here, written by `<LastCategoryBeacon>`. */
-export declare const LAST_CATEGORY_KEY = "letitrip:last-category";
+/**
+ * The `sessionStorage` key. Read here, written by `<LastCategoryBeacon>`.
+ *
+ * 🛑 A getter, not a `const` — the namespace is configured by the consumer's
+ * bootstrap, which runs after this module is evaluated, so a value captured at
+ * import time would freeze the default. Kept as a named export because
+ * `<LastCategoryBeacon>` writes through the same key.
+ */
+export declare const getLastCategoryKey: () => string;
 export interface ContextualTrailProps {
     /**
      * One entry per assignment, DEFAULT FIRST. Each carries the assignment's

package/dist/features/categories/components/ContextualTrail.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import React from "react";
 import { storageManager } from "../../../core/StorageManager.js";
+import { STORAGE_KEYS } from "../../../constants/storage-keys.js";
 import { BreadcrumbTrail } from "./BreadcrumbTrail.js";
 /**
  * I5b — the visible trail follows the path the visitor actually took, when
@@ -44,8 +45,15 @@ import { BreadcrumbTrail } from "./BreadcrumbTrail.js";
  * @tag layer:client-component
  * @tag access:client-only
  */
-/** The `sessionStorage` key. Read here, written by `<LastCategoryBeacon>`. */
-export const LAST_CATEGORY_KEY = "letitrip:last-category";
+/**
+ * The `sessionStorage` key. Read here, written by `<LastCategoryBeacon>`.
+ *
+ * 🛑 A getter, not a `const` — the namespace is configured by the consumer's
+ * bootstrap, which runs after this module is evaluated, so a value captured at
+ * import time would freeze the default. Kept as a named export because
+ * `<LastCategoryBeacon>` writes through the same key.
+ */
+export const getLastCategoryKey = () => STORAGE_KEYS.lastCategory;
 export function ContextualTrail({ trails, alternates, className }) {
     // Index 0 is the default chain and is what the server rendered.
     const [index, setIndex] = React.useState(0);
@@ -63,7 +71,7 @@ export function ContextualTrail({ trails, alternates, className }) {
          * component needs no catch at all and there is one implementation of
          * "storage might not exist" rather than a second, quieter copy.
          */
-        const last = storageManager.get(LAST_CATEGORY_KEY, { type: "session" });
+        const last = storageManager.get(getLastCategoryKey(), { type: "session" });
         if (!last)
             return;
         const match = trails.findIndex((t) => t.categoryId === last);

package/dist/features/categories/components/LastCategoryBeacon.js

@@ -1,7 +1,7 @@
 "use client";
 import React from "react";
 import { storageManager } from "../../../core/StorageManager.js";
-import { LAST_CATEGORY_KEY } from "./ContextualTrail.js";
+import { getLastCategoryKey } from "./ContextualTrail.js";
 /**
  * Record which category page the visitor is on, for `<ContextualTrail>`.
  *
@@ -27,7 +27,7 @@ export function LastCategoryBeacon({ categoryId }) {
          * and no second copy of that logic. A `false` return means the visitor
          * keeps the default trail, which is a correct answer.
          */
-        storageManager.set(LAST_CATEGORY_KEY, categoryId, { type: "session" });
+        storageManager.set(getLastCategoryKey(), categoryId, { type: "session" });
     }, [categoryId]);
     return null;
 }

package/dist/features/checkout/actions/checkout-value-otp-actions.js

@@ -20,6 +20,7 @@ import { sendWhatsAppBusinessMessage } from "../../whatsapp-bot/helpers/whatsapp
 import { isChannelHealthy, withChannelRetry } from "../../../_internal/server/notifications/channel-health.js";
 import { guardSend, logSuppressedSend } from "../../../_internal/server/notifications/send-guard.js";
 import { CHECKOUT_VALUE_OTP_EXPIRY_MS, CHECKOUT_VALUE_OTP_MAX_ATTEMPTS, hashOtp, generateOtpCode, checkoutValueOtpRef, enforceCheckoutValueOtpRateLimit, buildCheckoutValueOtpMessage, } from "../../auth/checkout-value-otp.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 function maskEmail(userEmail) {
     const [local, domain] = userEmail.split("@");
     return domain
@@ -44,7 +45,14 @@ export async function sendCheckoutValueOtp(userId, userEmail, channel = "email",
     const code = generateOtpCode();
     const codeHash = hashOtp(code);
     const expiresAt = new Date(Date.now() + CHECKOUT_VALUE_OTP_EXPIRY_MS);
-    const siteName = process.env.NEXT_PUBLIC_SITE_NAME || "LetItRip";
+    /*
+     * 🛑 Was `process.env.NEXT_PUBLIC_SITE_NAME || "LetItRip"`, and the env var
+     * holds `"Let It Rip India"` — which is `appkit.config.js → brand.heroCaption`,
+     * not `brand.name`. So every high-value checkout OTP named the site something
+     * the brand owner does not call it, and an unconfigured install of appkit
+     * named it this marketplace.
+     */
+    const siteName = getBrandName();
     if (channel === "whatsapp") {
         if (!addressId) {
             throw new ValidationError("Select a delivery address before sending the code via WhatsApp.");

package/dist/features/contact/email.js

@@ -1,16 +1,9 @@
 import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import "server-only";
-// Lazy-load `renderToStaticMarkup` via `require()` to avoid Next.js's
-// Server-Component static-trace error. Even with the `server-only`
-// directive above, a top-level `import { renderToStaticMarkup } from
-// "react-dom/server"` is flagged by Next.js when any module in the
-// re-export chain is reachable from a Server Component (e.g. layout.tsx
-// → providers.config.ts → @mohasinac/appkit/server → ... → email.tsx).
-// `require()` is opaque to Next's static analyser so the chain stops here.
-function renderToStaticMarkup(el) {
-    const m = require("react-dom/server");
-    return m.renderToStaticMarkup(el);
-}
+// The lazy `require("react-dom/server")` this file used to carry inline now
+// lives in ONE place — see render-static-markup.ts for why it cannot be a
+// top-level import, and why there is exactly one copy of it.
+import { renderStaticMarkup as renderToStaticMarkup } from "../email/render-static-markup.js";
 import { normalizeError } from "../../errors/normalize.js";
 import { guardSend, logSuppressedSend } from "../../_internal/server/notifications/send-guard.js";
 import { recordSendAttempt } from "../../_internal/server/notifications/send-recorder.js";
@@ -20,8 +13,14 @@ import { siteSettingsRepository } from "../admin/repository/site-settings.reposi
 import { serverLogger } from "../../monitoring/index.js";
 import { currentYear, formatCurrency } from "../../utils/index.js";
 import { EmailBold, EmailButton, EmailContainer, EmailDivider, EmailDoc, EmailFooter, EmailHeader, EmailRow } from "../email/primitives.js";
+import { getBrandName } from "../../core/brand-resolver.js";
+/*
+ * One of the five `NEXT_PUBLIC_SITE_NAME` readers with five different
+ * fallbacks that `core/brand-resolver.ts` was written to replace. Kept as a
+ * local function so the two call sites below are untouched.
+ */
 function getSiteName() {
-    return process.env.NEXT_PUBLIC_SITE_NAME?.trim() || "App";
+    return getBrandName();
 }
 function getSiteUrl() {
     return process.env.NEXTAUTH_URL?.trim() || "http://localhost:3000";

package/dist/features/email/notification-templates.js

@@ -31,11 +31,10 @@ import { EmailBold, EmailButton, EmailContainer, EmailDivider, EmailDoc, EmailFo
  *    inline-styled markup email clients actually render; hand-rolled markup
  *    is what `audit-email-raw-html` blocks.
  */
-// See constraint (1) above — this MUST stay a lazy require.
-function renderToStaticMarkup(el) {
-    const m = require("react-dom/server");
-    return m.renderToStaticMarkup(el);
-}
+// See constraint (1) above. The lazy require now lives in ONE place —
+// `render-static-markup.ts` — because two more call sites needed it and a third
+// identical copy would trip `audit-duplicate-helpers`.
+import { renderStaticMarkup as renderToStaticMarkup } from "./render-static-markup.js";
 /**
  * 🛑 Every notification type, no exceptions.
  *

package/dist/features/email/render-static-markup.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `renderToStaticMarkup`, behind a lazy `require` — the ONE definition.
+ *
+ * ## Why this is not a plain import
+ *
+ * A top-level `import { renderToStaticMarkup } from "react-dom/server"` is
+ * flagged by Next's static tracer the moment any module in the re-export chain
+ * is reachable from a Server Component — and these are, via
+ * `@mohasinac/appkit/server` → `providers.config.ts` → `src/app/layout.tsx`:
+ *
+ *   Error: You're importing a component that imports react-dom/server.
+ *
+ * `require()` is opaque to that analyser, so the chain stops here. The
+ * specifier MUST stay BARE: a relative one resolves against the emitted chunk
+ * and fails only in production (Root Cause #86).
+ *
+ * ## 🛑 Why it is a module rather than a local helper per file
+ *
+ * It was a local copy in `features/contact/email.tsx` and
+ * `features/email/notification-templates.tsx`, which worked — but
+ * `courier-block` and `dailyStatusDigest` imported `react-dom/server` DIRECTLY
+ * and broke `next build` outright. Giving each of those a fourth and fifth copy
+ * of the shim would have traded a build error for an `audit-duplicate-helpers`
+ * failure, which fires at THREE byte-identical top-level bodies. One definition
+ * is the only answer that satisfies both.
+ *
+ * 🛑 The build error was INVISIBLE on the registry pin, because a package in
+ * `node_modules` is not traversed as first-party source. It surfaced only when
+ * the consumer was switched to `file:./appkit`. So "it builds" was a property
+ * of where appkit was installed, not of appkit being correct — which matters
+ * for Tier AK, where the whole point is that appkit must stand on its own.
+ */
+import type { ReactElement } from "react";
+export declare function renderStaticMarkup(el: ReactElement): string;

package/dist/features/email/render-static-markup.js

@@ -0,0 +1,4 @@
+export function renderStaticMarkup(el) {
+    const m = require("react-dom/server");
+    return m.renderToStaticMarkup(el);
+}

package/dist/features/events/utils/event-charts.js

@@ -16,6 +16,7 @@
  * @tag layer:utils
  */
 import { calculateDiscount } from "../../promotions/schemas/firestore.js";
+import { formatMoney } from "../../../utils/number.formatter.js";
 /** A poll needs at least one real vote before a bar chart means anything. */
 const MIN_VOTES = 1;
 /**
@@ -121,7 +122,7 @@ export function buildCouponSavingsChart(coupons) {
     return {
         kind: "groupedBar",
         title: "What each code saves",
-        categories: BASKET_SIZES.map((b) => `₹${INR.format(b)}`),
+        categories: BASKET_SIZES.map((b) => formatMoney(b)),
         series,
         unit: "₹",
         caption: captionParts.join(" "),

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

@@ -6,7 +6,9 @@ import { X } from "lucide-react";
 import { useAuth } from "../../../react/contexts/SessionContext.js";
 import { Div } from "../../../ui/components/Div.js";
 import { IconButton, Row, Span, TextLink } from "@mohasinac/appkit/client";
-const STORAGE_KEY = "letitrip:announcement-dismissed";
+import { STORAGE_KEYS } from "../../../constants/storage-keys.js";
+// 🛑 Read at USE time — the namespace is set by the consumer's bootstrap, which
+// runs after this module is evaluated.
 const ONE_WEEK_MS = 7 * 24 * 60 * 60 * 1000;
 export function hashBannerMessage(msg) {
     let h = 0;
@@ -17,7 +19,7 @@ export function hashBannerMessage(msg) {
 }
 function isLocallyDismissed(message) {
     try {
-        const raw = localStorage.getItem(STORAGE_KEY);
+        const raw = localStorage.getItem(STORAGE_KEYS.announcementDismissed);
         if (!raw)
             return false;
         const { hash, at } = JSON.parse(raw);
@@ -32,7 +34,7 @@ function isLocallyDismissed(message) {
 }
 function saveLocalDismissal(message) {
     try {
-        localStorage.setItem(STORAGE_KEY, JSON.stringify({ hash: hashBannerMessage(message), at: Date.now() }));
+        localStorage.setItem(STORAGE_KEYS.announcementDismissed, JSON.stringify({ hash: hashBannerMessage(message), at: Date.now() }));
     }
     catch (_err) {
         void normalizeError(_err); /* quota exceeded — ignore */

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

@@ -65,7 +65,7 @@ export function FAQSection({ title, subtitle, items, tabs: tabsProp, showCategor
             return items;
         return items.filter((i) => (i.category ?? "general") === activeTab);
     }, [items, showTabs, activeTab]);
-    return (_jsx(Section, { paddingX: "x-md-2xl", className: className, surface: "subtle", paddingY: "y-4xl", children: _jsxs(Div, { className: "w-full max-w-4xl mx-auto", children: [_jsxs(Div, { className: "text-left mb-10", children: [_jsx(Heading, { level: 2, variant: "none", gradient: "brand", className: "mb-3", mdSize: "4xl", size: "3xl", weight: "bold", children: title }), subtitle && (_jsx(Text, { className: `max-w-xl ${themed.textSecondary}`, size: "base", children: subtitle }))] }), showTabs && (_jsx(Tabs, { value: activeTab, onChange: setActiveTab, className: "mb-8", children: _jsxs(TabsList, { children: [_jsx(TabsTrigger, { value: "all", children: "All" }), derivedTabs.map((tab) => (_jsx(TabsTrigger, { value: tab.value, children: tab.label }, tab.value)))] }) })), _jsxs(Stack, { gap: "none", rounded: "xl", className: `${themed.bgPrimary} ${__O.hidden} border ${themed.border}`, children: [visibleItems.length === 0 && (_jsx(Text, { paddingY: "3xl", align: "start", className: themed.textSecondary, children: "No FAQs in this category yet." })), visibleItems.map((faq, index) => {
+    return (_jsx(Section, { paddingX: "x-md-2xl", className: className, surface: "subtle", paddingY: "y-4xl", children: _jsxs(Div, { className: "w-full max-w-4xl mx-auto", children: [_jsxs(Div, { className: "text-left mb-10", children: [_jsx(Heading, { level: 2, variant: "none", gradient: "brand", className: "mb-3", mdSize: "4xl", size: "3xl", weight: "bold", children: title }), subtitle && (_jsx(Text, { className: `max-w-xl ${themed.textSecondary}`, size: "base", children: subtitle }))] }), showTabs && (_jsx(Tabs, { value: activeTab, onChange: setActiveTab, className: "mb-8", children: _jsxs(TabsList, { wrap: true, children: [_jsx(TabsTrigger, { value: "all", children: "All" }), derivedTabs.map((tab) => (_jsx(TabsTrigger, { value: tab.value, children: tab.label }, tab.value)))] }) })), _jsxs(Stack, { gap: "none", rounded: "xl", className: `${themed.bgPrimary} ${__O.hidden} border ${themed.border}`, children: [visibleItems.length === 0 && (_jsx(Text, { paddingY: "3xl", align: "start", className: themed.textSecondary, children: "No FAQs in this category yet." })), visibleItems.map((faq, index) => {
                             const isOpen = openIds.has(faq.id);
                             return (_jsxs(Div, { className: `transition-colors duration-200 ${index < visibleItems.length - 1 ? "border-b border-[var(--appkit-color-border)]" : ""} ${isOpen ? "bg-[var(--appkit-color-surface-elevated)]" : ""}`, children: [_jsxs(Button, { variant: "ghost", rounded: "none", className: `w-full text-left px-[1.25rem] py-[1rem] ${flex.between} gap-[1rem] hover:${themed.bgTertiary} transition-colors`, onClick: () => toggle(faq.id), "aria-expanded": isOpen, children: [_jsx(Span, { size: "sm", weight: "medium", className: `flex-1 leading-snug ${isOpen ? "text-primary" : themed.textPrimary}`, children: faq.question }), _jsx(ChevronDown, { className: `w-4 h-4 flex-shrink-0 transition-transform duration-250 ${isOpen ? "rotate-180 text-primary" : themed.textSecondary}` })] }), _jsx(Div, { layout: "grid", className: `transition-all duration-300 ease-out ${isOpen ? "grid-rows-[1fr] opacity-100" : "grid-rows-[0fr] opacity-0"}`, children: _jsx(Div, { className: `${__O.hidden}`, children: _jsx(Div, { paddingY: "b-md-lg", padding: "x-md", children: isHtml(faq.answer) ? (_jsx(RichText, { html: faq.answer, proseClass: "prose prose-sm max-w-none dark:prose-invert" })) : (_jsx(Text, { className: `leading-relaxed ${themed.textSecondary}`, size: "sm", children: faq.answer })) }) }) })] }, faq.id));
                         })] }), viewMoreHref && (_jsx(Div, { className: "text-left mt-10", children: _jsxs(TextLink, { rounded: "full", paddingX: "xl", paddingY: "sm", href: viewMoreHref, layout: "inline-flex", align: "center", className: "gap-[0.5rem] bg-primary/10 text-primary hover:bg-primary/20 dark:bg-primary/15 transition-colors", size: "sm", weight: "medium", children: [viewMoreLabel, hasMore && moreCount > 0 && (_jsxs(Span, { color: "inverse", size: "xs", className: "bg-primary", rounded: "full", padding: "pill-xs", children: ["+", moreCount] }))] }) }))] }) }));

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

@@ -22,6 +22,7 @@ import { gateCarouselSlides } from "../lib/slide-gating.js";
 import { gateHomepageSections } from "../lib/section-gating.js";
 import { closedSurfaceContext, isClosedHref } from "../../../_internal/shared/listing-types/route-gating.js";
 import { getSurfaceCounts } from "../../../_internal/server/features/products/surface-counts.js";
+import { ROUTES } from "../../../next/routing/route-map.js";
 import { SECTION_COPY } from "../constants/section-copy.js";
 import { homepageSectionsRepository } from "../repository/homepage-sections.repository.js";
 import { isListingTypeEnabled, isCategoryTypeEnabled, isBrowsePageEnabled, } from "../../../_internal/shared/listing-types/feature-flags.js";
@@ -75,6 +76,36 @@ const HOMEPAGE_SECTION_BROWSE_PAGE = {
     brands: "brands",
     stores: "stores",
 };
+/**
+ * The FOURTH axis — a section that funnels into a route closed by
+ * `closedPaths` or `disabledRoutes`, neither of which the three maps above
+ * can see.
+ *
+ * 🛑 THIS ONE EXISTS BECAUSE A SEED LOAD RE-ENABLED A SECTION. The blog rail
+ * was switched off per-document, `appkit-seed load` writes `set(merge: true)`
+ * over `enabled`, and the seed still said `true` — so the rail came back and
+ * the homepage shipped FIVE dead links (`/blog` plus four post URLs) into a
+ * section closed via `disabledRoutes`.
+ *
+ * A per-document `enabled: false` is a value a reseed can overwrite. A gate
+ * keyed on whether the destination is OPEN cannot be: the section stays dark
+ * for exactly as long as the route is shut, however the flag got flipped.
+ * That is the difference between fixing this instance and fixing the class.
+ */
+/*
+ * 🛑 `coupons` is NOT here. Its "View all offers" button points at
+ * `/promotions`, which is a real offers page with a live coupon behind it —
+ * so the fix was to REOPEN that route, not to hide a working rail. Closing a
+ * page and then hiding everything that links to it is the wrong direction
+ * when the page is one a shop wants.
+ */
+const HOMEPAGE_SECTION_ROUTE = {
+    "blog-articles": String(ROUTES.BLOG.LIST),
+    events: String(ROUTES.PUBLIC.EVENTS),
+    "event-raffles": String(ROUTES.PUBLIC.EVENTS),
+    reviews: String(ROUTES.PUBLIC.REVIEWS),
+    "featured-bundles": String(ROUTES.PUBLIC.BUNDLES),
+};
 import { getFeaturedProducts, getFeaturedAuctions, getFeaturedPreOrders } from "../../products/actions/product-actions.js";
 import { listTopLevelCategories, listBrandCategories } from "../../categories/actions/category-actions.js";
 import { listFeaturedBundles } from "../../../_internal/server/features/bundles/data.js";
@@ -189,6 +220,9 @@ export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onB
         const gatedBrowse = HOMEPAGE_SECTION_BROWSE_PAGE[type];
         if (gatedBrowse && !isBrowsePageEnabled(gatedBrowse, siteSettings))
             return false;
+        const gatedRoute = HOMEPAGE_SECTION_ROUTE[type];
+        if (gatedRoute && isClosedHref(gatedRoute, closedSurfaces))
+            return false;
         return true;
     });
     /*

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

@@ -34,6 +34,8 @@ export interface WelcomeSectionProps {
     heroImages?: readonly string[];
     isLoading?: boolean;
     brandLogoText?: string;
+    /** TLD badge for the wordmark, e.g. "in". Omitted renders no badge. */
+    brandTld?: string;
     /**
      * Wordmark caption under the hero logo, e.g. "Let It Rip India".
      *
@@ -44,4 +46,4 @@ export interface WelcomeSectionProps {
     brandCaption?: string;
     className?: string;
 }
-export declare function WelcomeSection({ title, subtitle, pillLabel, showCTA, ctaLabel, ctaHref, onCtaClick, secondaryCtaLabel, secondaryCtaHref, onSecondaryCtaClick, trustChips, heroImages, isLoading, brandLogoText, brandCaption, className, }: WelcomeSectionProps): React.JSX.Element;
+export declare function WelcomeSection({ title, subtitle, pillLabel, showCTA, ctaLabel, ctaHref, onCtaClick, secondaryCtaLabel, secondaryCtaHref, onSecondaryCtaClick, trustChips, heroImages, isLoading, brandLogoText, brandTld, brandCaption, className, }: WelcomeSectionProps): React.JSX.Element;

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

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

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

@@ -48,6 +48,14 @@ export interface HomepageBrand {
     name?: string;
     /** Short mark shown in the hero panel, e.g. "LT". */
     shortName?: string;
+    /**
+     * TLD badge drawn after the hero wordmark, e.g. `"in"`.
+     *
+     * Consumer-supplied for the same reason as `caption` below: a library must
+     * not assume its consumer's domain. It was a hardcoded `.in` inside
+     * `SiteLogo` until A5.
+     */
+    tld?: string;
     /**
      * Caption under the hero brand panel's logo, e.g. "Let It Rip India".
      *

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

@@ -112,7 +112,7 @@ const SECTION_REGISTRY = {
             return (_jsx(WelcomeSection, { heroImages: heroImages, brandCaption: brand?.heroCaption, title: cleanTitle(cfg?.h1) || SECTION_TITLE.welcome, 
                 // A real `subtitle` wins; `description` is the legacy source and is
                 // still parsed for documents that only carry it.
-                subtitle: cfg?.subtitle?.trim() || parseWelcomeDescription(cfg?.description), pillLabel: cfg?.pillLabel || SECTION_COPY.welcomePill, showCTA: cfg?.showCTA ?? true, ctaLabel: cfg?.ctaText || SECTION_COPY.welcomePrimaryCta, ctaHref: cfg?.ctaLink || ROUTES.PUBLIC.PRODUCTS, secondaryCtaLabel: cfg?.secondaryCtaText || SECTION_COPY.welcomeSecondaryCta, secondaryCtaHref: cfg?.secondaryCtaLink || ROUTES.PUBLIC.PRODUCTS, trustChips: [...WELCOME_TRUST_CHIPS], brandLogoText: brand?.shortName }));
+                subtitle: cfg?.subtitle?.trim() || parseWelcomeDescription(cfg?.description), pillLabel: cfg?.pillLabel || SECTION_COPY.welcomePill, showCTA: cfg?.showCTA ?? true, ctaLabel: cfg?.ctaText || SECTION_COPY.welcomePrimaryCta, ctaHref: cfg?.ctaLink || ROUTES.PUBLIC.PRODUCTS, secondaryCtaLabel: cfg?.secondaryCtaText || SECTION_COPY.welcomeSecondaryCta, secondaryCtaHref: cfg?.secondaryCtaLink || ROUTES.PUBLIC.PRODUCTS, trustChips: [...WELCOME_TRUST_CHIPS], brandLogoText: brand?.shortName, brandTld: brand?.tld }));
         },
     },
     categories: {

package/dist/features/layout/AppLayoutShell.d.ts

@@ -63,6 +63,8 @@ export interface AppLayoutShellProps {
     hiddenNavItems?: string[];
     user?: BottomNavbarUser | null;
     brandName: string;
+    /** TLD badge for the wordmark, forwarded to TitleBarLayout (A5). */
+    brandTld?: string;
     brandShortName?: string;
     /** Admin-uploaded site logo URL. Falls back to the SVG wordmark when empty. */
     siteLogoUrl?: string;
@@ -178,4 +180,4 @@ export interface AppLayoutShellProps {
         };
     };
 }
-export declare function AppLayoutShell({ children, navItems, sidebarItems, sidebarSections, renderSidebarItemAction, sidebarPrimaryActions, sidebarTitle, hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, messagesHref, unreadMessageCount, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, showFooter, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle, suppressDashboardNav, hideSidebarToggle, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, userReviewsHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, eventBannerSlot, showBottomNav, contentClassName, lightBackground, darkBackground, }: AppLayoutShellProps): React.JSX.Element;
+export declare function AppLayoutShell({ children, navItems, sidebarItems, sidebarSections, renderSidebarItemAction, sidebarPrimaryActions, sidebarTitle, hiddenNavItems, user, brandName, brandTld, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, messagesHref, unreadMessageCount, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, showFooter, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle, suppressDashboardNav, hideSidebarToggle, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, userReviewsHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, eventBannerSlot, showBottomNav, contentClassName, lightBackground, darkBackground, }: AppLayoutShellProps): React.JSX.Element;