@mohasinac/appkit 4.70.0 → 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/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;

package/dist/features/layout/AppLayoutShell.js

@@ -189,7 +189,7 @@ function SidebarContent({ sidebarItems, sidebarSections, renderSidebarItemAction
                     ].join(" "), children: action.label }, `${action.href}-${action.label}`))) })), isAuthenticated && (_jsx(CollapsibleNavGroup, { title: labels.sectionTitle, hasActive: !!activeProfileLink, children: _jsxs(Ul, { spacing: "2xs", children: [_jsx(Li, { children: _jsx(TextLink, { href: profileHref, variant: "none", className: activeProfileLink?.href === profileHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === profileHref ? "page" : undefined, children: labels.profile }) }), userOrdersHref && (_jsx(Li, { children: _jsx(TextLink, { href: userOrdersHref, variant: "none", className: activeProfileLink?.href === userOrdersHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userOrdersHref ? "page" : undefined, children: labels.orders }) })), userWishlistHref && (_jsx(Li, { children: _jsx(TextLink, { href: userWishlistHref, variant: "none", className: activeProfileLink?.href === userWishlistHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userWishlistHref ? "page" : undefined, children: labels.wishlist }) })), userSettingsHref && (_jsx(Li, { children: _jsx(TextLink, { href: userSettingsHref, variant: "none", className: activeProfileLink?.href === userSettingsHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userSettingsHref ? "page" : undefined, children: labels.settings }) }))] }) })), isAuthenticated && user?.stats && (_jsxs(Div, { layout: "grid", gap: "2", className: "grid-cols-2", children: [user.stats.totalOrders != null && userOrdersHref && (_jsxs(TextLink, { href: userOrdersHref, variant: "none", className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.totalOrders }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Orders" })] })), user.stats.reviewsCount != null && userReviewsHref && (_jsxs(TextLink, { href: userReviewsHref, variant: "none", className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.reviewsCount }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Reviews" })] })), auctionsEnabled && user.stats.auctionsWon != null && userOrdersHref && (_jsxs(TextLink, { href: `${userOrdersHref}?orderType=auction`, variant: "none", className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.auctionsWon }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Auctions Won" })] }))] })), isAuthenticated && isAdminOrSeller && (adminHref || resolvedStoreHref) && (_jsx(CollapsibleNavGroup, { title: labels.dashboardSectionTitle, hasActive: !!activeDashboardLink, children: _jsxs(Ul, { spacing: "2xs", children: [adminHref && role === "admin" && (_jsx(Li, { children: _jsx(TextLink, { href: adminHref, variant: "none", className: activeDashboardLink?.href === adminHref ? navItemActiveClass : navItemClass, "aria-current": activeDashboardLink?.href === adminHref ? "page" : undefined, children: labels.adminDashboard }) })), resolvedStoreHref && isAdminOrSeller && (_jsx(Li, { children: _jsx(TextLink, { href: resolvedStoreHref, variant: "none", className: activeDashboardLink?.href === resolvedStoreHref ? navItemActiveClass : navItemClass, "aria-current": activeDashboardLink?.href === resolvedStoreHref ? "page" : undefined, children: labels.storeDashboard }) }))] }) })), normalizedSections.map((section, sectionIndex) => (_jsx(CollapsibleSidebarSection, { section: section, navItemClass: navItemClass, navItemActiveClass: navItemActiveClass, activeHref: activeHref, renderItemAction: renderSidebarItemAction }, `sidebar-section-${sectionIndex}`))), (sidebarLocaleSlot || showThemeToggleInSidebar || (isAuthenticated && onLogout)) && (_jsxs(Stack, { border: "default", className: "border-t border-[var(--appkit-color-border-subtle)]", padding: "t-md", gap: "3", children: [sidebarLocaleSlot, showThemeToggleInSidebar && (_jsxs("button", { type: "button", onClick: toggleTheme, className: "flex w-full items-center justify-end gap-[var(--appkit-space-3)] rounded-lg px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] text-[var(--appkit-color-text-muted)] transition-colors hover:bg-primary-surface hover:text-primary-800 dark:hover:text-primary-200", children: [_jsx(Span, { "aria-hidden": "true", children: theme === "dark" ? "☀️" : "🌙" }), activeThemeName] })), isAuthenticated && onLogout && (_jsx("button", { type: "button", onClick: () => { onLogout(); onAfterLogout(); }, className: CLS_LOGOUT_BTN, children: labels.logout }))] }))] }));
 }
 // ─── Main component ────────────────────────────────────────────────────────────
-export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarSections, renderSidebarItemAction, sidebarPrimaryActions, sidebarTitle = "Navigation", hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, messagesHref, unreadMessageCount, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, showFooter = true, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle = false, suppressDashboardNav = false, hideSidebarToggle = false, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, userReviewsHref, sidebarLocaleSlot, showThemeToggleInSidebar = false, sidebarProfileLabels, eventBannerSlot, showBottomNav = true, contentClassName, lightBackground = DEFAULT_LIGHT_BG, darkBackground = DEFAULT_DARK_BG, }) {
+export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarSections, renderSidebarItemAction, sidebarPrimaryActions, sidebarTitle = "Navigation", hiddenNavItems, user, brandName, brandTld, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, messagesHref, unreadMessageCount, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, showFooter = true, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle = false, suppressDashboardNav = false, hideSidebarToggle = false, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, userReviewsHref, sidebarLocaleSlot, showThemeToggleInSidebar = false, sidebarProfileLabels, eventBannerSlot, showBottomNav = true, contentClassName, lightBackground = DEFAULT_LIGHT_BG, darkBackground = DEFAULT_DARK_BG, }) {
     // QueryClientProvider used to be created here so AppLayoutShell could stand
     // alone. The real cause of the 2026-06-10/11 "No QueryClient set" prod crash
     // turned out to be a peer-dep duplicate of @tanstack/query-core under
@@ -256,7 +256,7 @@ export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarS
             opacity: darkBackground.overlay?.opacity ?? 0,
         },
     };
-    return (_jsx(_Fragment, { children: _jsxs(Stack, { className: "min-h-screen w-full overflow-x-clip transition-colors duration-300", children: [_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: normalizedLightBackground, darkMode: normalizedDarkBackground }), _jsx(Div, { id: TOP_BANNER_SLOT_ID, className: "w-full" }), _jsxs(Div, { ref: headerRef, className: "sticky top-0 z-50 w-full", children: [_jsx(TitleBar, { onToggleSidebar: handleTogglePublicSidebar, sidebarOpen: sidebarOpen, onSearchToggle: () => setSearchOpen((prev) => !prev), searchOpen: searchOpen, brandName: brandName, brandShortName: brandShortName, siteLogoUrl: siteLogoUrl, logoHref: logoHref, promotionsHref: promotionsHref, cartHref: cartHref, wishlistHref: wishlistHref, messagesHref: messagesHref, unreadMessageCount: unreadMessageCount, userId: userId, profileHref: profileHref, loginHref: loginHref, registerHref: registerHref, user: user, navSlot: titleBarNavSlot, notificationSlot: titleBarNotificationSlot, devSlot: titleBarDevSlot, promoStripText: titleBarPromoStripText, isDark: theme === "dark", onToggleTheme: showThemeToggle ? toggleTheme : undefined, onBeforeToggleDashboardNav: handleBeforeDashboardNavToggle, suppressDashboardNav: suppressDashboardNav, hideSidebarToggle: hideSidebarToggle }), _jsx(NavbarWithSettings, { navItems: navItems, hiddenNavItems: hiddenNavItems, permissions: authUser?.permissions }), searchOpen && (searchSlotRenderer ? searchSlotRenderer(() => setSearchOpen(false)) : searchSlot), eventBannerSlot] }), _jsx(AutoBreadcrumbs, {}), _jsxs(Div, { layout: "flex", className: "relative w-full flex-1 overflow-x-clip", children: [_jsx(SidebarLayout, { isOpen: sidebarOpen, ariaLabel: "Secondary navigation", header: user ? (_jsx(SidebarUserHeader, { user: user, onClose: () => setSidebarOpen(false), profileHref: profileHref })) : (_jsx(SidebarGuestHeader, { sidebarTitle: sidebarTitle, onClose: () => setSidebarOpen(false) })), onClose: () => setSidebarOpen(false), children: sidebarContent }), _jsx(Main, { id: "main-content", 
+    return (_jsx(_Fragment, { children: _jsxs(Stack, { className: "min-h-screen w-full overflow-x-clip transition-colors duration-300", children: [_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: normalizedLightBackground, darkMode: normalizedDarkBackground }), _jsx(Div, { id: TOP_BANNER_SLOT_ID, className: "w-full" }), _jsxs(Div, { ref: headerRef, className: "sticky top-0 z-50 w-full", children: [_jsx(TitleBar, { onToggleSidebar: handleTogglePublicSidebar, sidebarOpen: sidebarOpen, onSearchToggle: () => setSearchOpen((prev) => !prev), searchOpen: searchOpen, brandName: brandName, brandTld: brandTld, brandShortName: brandShortName, siteLogoUrl: siteLogoUrl, logoHref: logoHref, promotionsHref: promotionsHref, cartHref: cartHref, wishlistHref: wishlistHref, messagesHref: messagesHref, unreadMessageCount: unreadMessageCount, userId: userId, profileHref: profileHref, loginHref: loginHref, registerHref: registerHref, user: user, navSlot: titleBarNavSlot, notificationSlot: titleBarNotificationSlot, devSlot: titleBarDevSlot, promoStripText: titleBarPromoStripText, isDark: theme === "dark", onToggleTheme: showThemeToggle ? toggleTheme : undefined, onBeforeToggleDashboardNav: handleBeforeDashboardNavToggle, suppressDashboardNav: suppressDashboardNav, hideSidebarToggle: hideSidebarToggle }), _jsx(NavbarWithSettings, { navItems: navItems, hiddenNavItems: hiddenNavItems, permissions: authUser?.permissions }), searchOpen && (searchSlotRenderer ? searchSlotRenderer(() => setSearchOpen(false)) : searchSlot), eventBannerSlot] }), _jsx(AutoBreadcrumbs, {}), _jsxs(Div, { layout: "flex", className: "relative w-full flex-1 overflow-x-clip", children: [_jsx(SidebarLayout, { isOpen: sidebarOpen, ariaLabel: "Secondary navigation", header: user ? (_jsx(SidebarUserHeader, { user: user, onClose: () => setSidebarOpen(false), profileHref: profileHref })) : (_jsx(SidebarGuestHeader, { sidebarTitle: sidebarTitle, onClose: () => setSidebarOpen(false) })), onClose: () => setSidebarOpen(false), children: sidebarContent }), _jsx(Main, { id: "main-content", 
                             // Bottom-chrome clearance belongs to whichever element is LAST.
                             //
                             // With the footer rendered it is the footer's, and a margin here

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

@@ -14,6 +14,13 @@ export interface TitleBarLayoutProps {
     searchOpen: boolean;
     brandName: string;
     brandShortName?: string;
+    /**
+     * TLD badge for the SVG wordmark, e.g. `"in"`. Omitted renders no badge.
+     *
+     * A5 — the badge used to be a hardcoded `.in` inside `SiteLogo`, so every
+     * consumer of appkit got one marketplace's TLD drawn into its header.
+     */
+    brandTld?: string;
     /** Admin-uploaded site logo URL. Falls back to the SVG wordmark when empty. */
     siteLogoUrl?: string;
     logoHref: string;
@@ -74,4 +81,4 @@ export interface TitleBarLayoutProps {
  *
  * Receives all domain data as props — zero domain imports.
  */
-export declare function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, compareHref, wishlistHref, wishlistCount, cartHref, cartCount, profileHref, unreadNotificationCount, notificationsHref, messagesHref, unreadMessageCount, loginHref, registerHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark, onToggleTheme, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle, id, className, }: TitleBarLayoutProps): React.JSX.Element;
+export declare function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen, brandName, brandTld, brandShortName, siteLogoUrl, logoHref, promotionsHref, compareHref, wishlistHref, wishlistCount, cartHref, cartCount, profileHref, unreadNotificationCount, notificationsHref, messagesHref, unreadMessageCount, loginHref, registerHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark, onToggleTheme, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle, id, className, }: TitleBarLayoutProps): React.JSX.Element;