@mohasinac/appkit 4.69.1 → 4.71.0

package/dist/core/hooks/useNewsletterSubscribe.js

@@ -0,0 +1,121 @@
+"use client";
+/**
+ * useNewsletterSubscribe — the one newsletter submit path.
+ *
+ * ## Why this exists (A5b)
+ *
+ * Two consumer newsletter boxes — homepage and footer — had independently
+ * hand-written the same submit flow: `useFormShellState(newsletterSubscribeSchema)`,
+ * `clearErrors()`, `validate()`, `useApiMutation` posting `{ email, source }`,
+ * and an `isPending` label swap. Roughly 25 lines each, identical in substance.
+ *
+ * 🛑 The argument for merging is not the line count — it is that **both files
+ * carried comments describing the SAME TWO BUGS, each fixed separately**:
+ *
+ *  1. *"the Button carried `type="submit"` AND an `onClick`, while
+ *     `<Form onSubmit={e => e.preventDefault()}>` swallowed the native
+ *     submit — so pressing Enter in the email field fired `submit`, not
+ *     `click`, and nothing at all happened. Only the mouse worked."*
+ *  2. *"`<Form schema={…}>` was passed here before but nothing ever ran it —
+ *     the only guard was `!email.trim()`, so `not-an-email` round-tripped to
+ *     the server and came back as a toast instead of an inline field error."*
+ *
+ * That is the Duplication Framework's bug-fix multiplier having already fired
+ * twice, which the framework treats as decisive regardless of the Rule of
+ * Three. Keyboard submission silently not working is also exactly the class of
+ * defect nobody reports — it looks like the user simply did not click.
+ *
+ * ## 🛑 A HOOK, not a shared component
+ *
+ * The two boxes differ in seven ways and every one is presentational: layout
+ * (inline row vs stacked), the label, the button variant, the pending label
+ * ("Subscribing..." vs "…"), the toast wording, and — the real one — what
+ * success looks like. The footer REPLACES itself with a thank-you; the
+ * homepage keeps the field mounted and adds a `role="status"` line beneath.
+ *
+ * A single component would need ~7 conditional props, which the framework
+ * lists as a reason to KEEP duplication rather than remove it. So the
+ * mechanism is shared and the JSX stays at each call site, where the
+ * differences actually live.
+ *
+ * 🛑 `<FormErrorSummary>` is rendered by the CALLER, not here — this is a hook
+ * and renders nothing. Both consumers (`HomepageNewsletterForm`,
+ * `FooterNewsletterSlot`) mount it beside their own `<Form shellCtx={…}>`,
+ * which is the only place it can go: the summary reads the shell context this
+ * hook creates and the caller provides.
+ *
+ * @tag domain:newsletter
+ * @tag layer:client
+ * @tag access:client
+ * @tag sideEffects:network
+ */
+// audit-form-error-summary-ok: a hook renders nothing; both call sites mount
+// <FormErrorSummary> beside their own <Form shellCtx={…}> — see the header.
+import { useCallback, useState } from "react";
+import { useApiMutation } from "../../client/api/useApiMutation.js";
+import { apiClient } from "../../http/ApiClient.js";
+import { normalizeError } from "../../errors/normalize.js";
+import { newsletterSubscribeSchema } from "../../features/admin/schemas/small-forms.js";
+import { useFormShellState } from "../../ui/forms/FormShell.js";
+import { useToast } from "../../ui/components/Toast.js";
+export function useNewsletterSubscribe({ endpoint, source, successToast, errorMessage = "Could not subscribe. Please try again.", onSuccess, }) {
+    const [email, setEmail] = useState("");
+    const { showToast } = useToast();
+    /*
+     * State is hoisted here and handed back as `shellCtx` for `<Form shellCtx=…>`
+     * rather than left to `<Form>`'s own internal instance.
+     *
+     * That is load-bearing, not tidiness: it is what lets `submit` live outside
+     * the render prop, which is what makes bug 1 above fixable. The caller must
+     * pass `shellCtx` to its `<Form>` or the inline field errors land in a
+     * different context than the one this hook writes to.
+     */
+    const form = useFormShellState(newsletterSubscribeSchema);
+    const mutation = useApiMutation({
+        errorMessage,
+        /*
+         * The server sends per-field `issues` and `surfaceError` knows how to
+         * apply them — but only when the caller supplies a sink. Without this the
+         * paths are parsed off the wire and discarded, and the user sees one
+         * generic sentence with no indication of which field.
+         */
+        setFieldError: form.setFieldError,
+        mutationFn: (payload) => apiClient.post(endpoint, { ...payload, source }),
+        onSuccess: () => {
+            showToast(successToast, "success");
+            setEmail("");
+            onSuccess?.();
+        },
+    });
+    const submit = useCallback(async () => {
+        if (mutation.isPending)
+            return;
+        form.clearErrors();
+        /*
+         * `validate` runs the schema AND pipes any issues to the inline field
+         * errors itself, so there is no bare `safeParse` result to forget to use
+         * (`audit-unvalidated-safeparse`). This is bug 2's fix.
+         */
+        const parsed = form.validate({ email: email.trim() });
+        if (!parsed)
+            return;
+        try {
+            await mutation.mutateAsync(parsed);
+        }
+        catch (err) {
+            void normalizeError(err);
+            // Inline on the field as well — the mutation already toasted, and a
+            // toast that has faded leaves the user staring at a form with no
+            // indication of what went wrong.
+            form.setFieldError("email", errorMessage);
+        }
+    }, [email, errorMessage, form, mutation]);
+    return {
+        email,
+        setEmail,
+        submit,
+        isPending: mutation.isPending,
+        /** Pass to `<Form shellCtx={…}>` — see the note on `form` above. */
+        shellCtx: form.shellCtx,
+    };
+}

package/dist/features/about/components/DeveloperView.js

@@ -14,6 +14,7 @@ import { TextLink } from "../../../ui/components/TextLink.js";
 import { ROUTES } from "../../../constants/index.js";
 import { PAGE_CONTAINER } from "../../../_internal/shared/styles/page.js";
 import { siteSettingsRepository } from "../../admin/repository/site-settings.repository.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 /**
  * Reuses the existing `siteSettings.aboutContent.teamMembers` /
  * `.milestones` data (already admin-editable via Site Settings → About) —
@@ -39,5 +40,5 @@ export async function DeveloperView({ labels = {} }) {
         });
     }
     const developers = teamMembers.filter((m) => m.isDeveloper);
-    return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(ProseHero, { width: "sm", centered: false, subtitleSize: "sm", title: labels.title ?? "Meet the Developer", subtitle: labels.subtitle ?? "The person building LetItRip, one feature at a time." }), _jsxs(Div, { className: `${page.container.sm}`, padding: "content-banner", children: [developers.length === 0 ? (_jsx(Text, { variant: "secondary", children: labels.empty ?? "Developer profile coming soon." })) : (_jsx(Stack, { gap: "xl", children: developers.map((dev) => (_jsxs(Stack, { gap: "md", surface: "default", padding: "lg", rounded: "xl", border: "default", children: [_jsxs(Row, { gap: "md", align: "center", children: [_jsx(Avatar, { src: dev.photoUrl, name: dev.name, alt: dev.name, size: "lg" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, children: dev.name }), _jsxs(Row, { gap: "xs", wrap: true, children: [_jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: dev.role }), dev.isFounder && _jsx(Badge, { variant: "primary", size: "xs", children: "Founder" }), _jsx(Badge, { variant: "secondary", size: "xs", children: "Developer" })] })] })] }), _jsx(Text, { variant: "secondary", className: "leading-relaxed", children: dev.bio }), dev.githubUrl && (_jsx(Anchor, { href: dev.githubUrl, tone: "brand", size: "sm", underline: "hover", children: "GitHub \u2197" }))] }, dev.name))) })), milestones.length > 0 && (_jsxs(Div, { className: "mt-14 border-t", border: "default", padding: "t-xl", children: [_jsx(Heading, { level: 3, className: "mb-6", color: "muted", size: "sm", weight: "semibold", transform: "uppercase", children: labels.journeyTitle ?? "The Journey" }), _jsx(Stack, { className: "relative border-l-2 border-primary/30 max-w-2xl pl-[2rem]", gap: "lg", children: milestones.map(({ year, text }) => (_jsxs(Div, { className: "relative", children: [_jsx(Div, { className: "absolute -left-10 top-1 w-4 h-4 bg-primary border-2 border-white", rounded: "full" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] })), _jsx(Div, { className: "mt-10", children: _jsx(TextLink, { href: String(ROUTES.PUBLIC.ABOUT), variant: "muted", size: "sm", children: labels.backToTeam ?? "← Meet the whole team" }) })] })] }));
+    return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(ProseHero, { width: "sm", centered: false, subtitleSize: "sm", title: labels.title ?? "Meet the Developer", subtitle: labels.subtitle ?? `The person building ${getBrandName()}, one feature at a time.` }), _jsxs(Div, { className: `${page.container.sm}`, padding: "content-banner", children: [developers.length === 0 ? (_jsx(Text, { variant: "secondary", children: labels.empty ?? "Developer profile coming soon." })) : (_jsx(Stack, { gap: "xl", children: developers.map((dev) => (_jsxs(Stack, { gap: "md", surface: "default", padding: "lg", rounded: "xl", border: "default", children: [_jsxs(Row, { gap: "md", align: "center", children: [_jsx(Avatar, { src: dev.photoUrl, name: dev.name, alt: dev.name, size: "lg" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, children: dev.name }), _jsxs(Row, { gap: "xs", wrap: true, children: [_jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: dev.role }), dev.isFounder && _jsx(Badge, { variant: "primary", size: "xs", children: "Founder" }), _jsx(Badge, { variant: "secondary", size: "xs", children: "Developer" })] })] })] }), _jsx(Text, { variant: "secondary", className: "leading-relaxed", children: dev.bio }), dev.githubUrl && (_jsx(Anchor, { href: dev.githubUrl, tone: "brand", size: "sm", underline: "hover", children: "GitHub \u2197" }))] }, dev.name))) })), milestones.length > 0 && (_jsxs(Div, { className: "mt-14 border-t", border: "default", padding: "t-xl", children: [_jsx(Heading, { level: 3, className: "mb-6", color: "muted", size: "sm", weight: "semibold", transform: "uppercase", children: labels.journeyTitle ?? "The Journey" }), _jsx(Stack, { className: "relative border-l-2 border-primary/30 max-w-2xl pl-[2rem]", gap: "lg", children: milestones.map(({ year, text }) => (_jsxs(Div, { className: "relative", children: [_jsx(Div, { className: "absolute -left-10 top-1 w-4 h-4 bg-primary border-2 border-white", rounded: "full" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] })), _jsx(Div, { className: "mt-10", children: _jsx(TextLink, { href: String(ROUTES.PUBLIC.ABOUT), variant: "muted", size: "sm", children: labels.backToTeam ?? "← Meet the whole team" }) })] })] }));
 }

package/dist/features/about/index.d.ts

@@ -1,5 +1,3 @@
-export { AboutView } from "./components/AboutView";
-export type { AboutViewProps, AboutHowItem, AboutValueItem, AboutMilestone, AboutTeamMember, } from "./components/AboutView";
 export type { AboutContentDocument } from "./schemas/firestore";
 export { TrackOrderView } from "./components/TrackOrderView";
 export type { TrackOrderViewProps } from "./components/TrackOrderView";

package/dist/features/about/index.js

@@ -1,4 +1,3 @@
-export { AboutView } from "./components/AboutView.js";
 export { TrackOrderView } from "./components/TrackOrderView.js";
 /*
  * The shared prose-page banner. Exported because it is the one thing all

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

@@ -8,6 +8,7 @@ import { Row, Stack } from "../../../ui/components/Layout.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
 import { ROUTES } from "../../../constants/index.js";
 import { GC } from "../../_guide-cls.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 const SECTIONS = [
     {
         Icon: UserCheck, title: "Your Profile",
@@ -40,5 +41,5 @@ const SECTIONS = [
 ];
 // ─── Component ────────────────────────────────────────────────────────────────
 export function BuyerAccountGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: `flex-shrink-0 w-10 h-10 ${GC.iconBg}`, align: "center", justify: "center", rounded: "xl", children: _jsx(UserCheck, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Buyer Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Account & Safety" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Manage your LetItRip profile, stay safe from scams, and know how to report problems." })] }), SECTIONS.map(({ Icon, iconCls, title, content }) => (_jsxs(Section, { className: GC.sectionWrap, children: [_jsxs(Div, { className: GC.sectionHeader, children: [_jsx(Icon, { className: iconCls ?? GC.iconPrimary }), _jsx(Heading, { level: 2, className: GC.sectionTitle, children: title })] }), _jsx(Div, { className: GC.sectionBody, children: content })] }, title)))] }));
+    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: `flex-shrink-0 w-10 h-10 ${GC.iconBg}`, align: "center", justify: "center", rounded: "xl", children: _jsx(UserCheck, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Buyer Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Account & Safety" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Manage your ", getBrandName(), " profile, stay safe from scams, and know how to report problems."] })] }), SECTIONS.map(({ Icon, iconCls, title, content }) => (_jsxs(Section, { className: GC.sectionWrap, children: [_jsxs(Div, { className: GC.sectionHeader, children: [_jsx(Icon, { className: iconCls ?? GC.iconPrimary }), _jsx(Heading, { level: 2, className: GC.sectionTitle, children: title })] }), _jsx(Div, { className: GC.sectionBody, children: content })] }, title)))] }));
 }

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

@@ -7,6 +7,7 @@ import { Li, Section, Ul } from "../../../ui/components/Semantic.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { GC } from "../../_guide-cls.js";
 import { resolvePublishedValues } from "../../../_internal/shared/content/published-values.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 /* Phase 9 — one definition of the refund timeline. See the 🛑 at the call site. */
 const { refundBusinessDaysMin: REFUND_DAYS_MIN, refundBusinessDaysMax: REFUND_DAYS_MAX } = resolvePublishedValues();
 const SECTIONS = [
@@ -16,7 +17,7 @@ const SECTIONS = [
     },
     {
         Icon: TrendingUp, title: "Placing a Bid",
-        content: (_jsxs(_Fragment, { children: [_jsxs(Text, { className: `${GC.textMuted} mb-3`, children: ["Enter your bid amount \u2014 it must be at least the current high bid plus the increment \u2014 and click ", _jsx(Span, { weight: "bold", children: "Place Bid" }), ". You'll be asked to confirm."] }), _jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Outbid notification" }), " \u2014 you'll receive an in-app notification and email if someone outbids you."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Max bid (proxy bidding)" }), " \u2014 enter the maximum you're willing to pay. LetItRip will automatically bid on your behalf up to that amount, in the minimum increments needed to keep you in the lead. Your max bid is never revealed to other bidders."] })] }), _jsxs(Text, { className: `${GC.textMuted} mt-3`, children: [_jsx(Span, { weight: "bold", children: "Example:" }), " Current bid is \u20B9500, increment is \u20B950. You set a max bid of \u20B9800. Your bid is placed at \u20B9550. If someone bids \u20B9600, the system auto-bids \u20B9650 for you \u2014 up to \u20B9800."] })] })),
+        content: (_jsxs(_Fragment, { children: [_jsxs(Text, { className: `${GC.textMuted} mb-3`, children: ["Enter your bid amount \u2014 it must be at least the current high bid plus the increment \u2014 and click ", _jsx(Span, { weight: "bold", children: "Place Bid" }), ". You'll be asked to confirm."] }), _jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Outbid notification" }), " \u2014 you'll receive an in-app notification and email if someone outbids you."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Max bid (proxy bidding)" }), " \u2014 enter the maximum you're willing to pay. ", getBrandName(), " will automatically bid on your behalf up to that amount, in the minimum increments needed to keep you in the lead. Your max bid is never revealed to other bidders."] })] }), _jsxs(Text, { className: `${GC.textMuted} mt-3`, children: [_jsx(Span, { weight: "bold", children: "Example:" }), " Current bid is \u20B9500, increment is \u20B950. You set a max bid of \u20B9800. Your bid is placed at \u20B9550. If someone bids \u20B9600, the system auto-bids \u20B9650 for you \u2014 up to \u20B9800."] })] })),
     },
     {
         Icon: Trophy, title: "Winning an Auction",
@@ -24,7 +25,7 @@ const SECTIONS = [
     },
     {
         Icon: AlertTriangle, iconCls: "w-5 h-5 text-amber-500", title: "Bid Retraction Policy",
-        content: (_jsxs(Alert, { variant: "warning", children: ["Bids on LetItRip are ", _jsx(Span, { weight: "bold", children: "binding" }), ". Only place a bid if you intend to pay. Retraction requires contacting support with a valid reason. Repeated retractions may result in a temporary restriction on placing new bids."] })),
+        content: (_jsxs(Alert, { variant: "warning", children: ["Bids on ", getBrandName(), " are ", _jsx(Span, { weight: "bold", children: "binding" }), ". Only place a bid if you intend to pay. Retraction requires contacting support with a valid reason. Repeated retractions may result in a temporary restriction on placing new bids."] })),
     },
     {
         Icon: Package, title: "Pre-orders",
@@ -41,5 +42,5 @@ const SECTIONS = [
 ];
 // ─── Component ────────────────────────────────────────────────────────────────
 export function BuyerAuctionsGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: `flex-shrink-0 w-10 h-10 ${GC.iconBg}`, align: "center", justify: "center", rounded: "xl", children: _jsx(Gavel, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Buyer Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Auctions & Pre-orders" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "How bidding works, how to win, and everything you need to know about pre-orders on LetItRip." })] }), SECTIONS.map(({ Icon, iconCls, title, content }) => (_jsxs(Section, { className: GC.sectionWrap, children: [_jsxs(Div, { className: GC.sectionHeader, children: [_jsx(Icon, { className: iconCls ?? GC.iconPrimary }), _jsx(Heading, { level: 2, className: GC.sectionTitle, children: title })] }), _jsx(Div, { className: GC.sectionBody, children: content })] }, title)))] }));
+    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: `flex-shrink-0 w-10 h-10 ${GC.iconBg}`, align: "center", justify: "center", rounded: "xl", children: _jsx(Gavel, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Buyer Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Auctions & Pre-orders" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["How bidding works, how to win, and everything you need to know about pre-orders on ", getBrandName(), "."] })] }), SECTIONS.map(({ Icon, iconCls, title, content }) => (_jsxs(Section, { className: GC.sectionWrap, children: [_jsxs(Div, { className: GC.sectionHeader, children: [_jsx(Icon, { className: iconCls ?? GC.iconPrimary }), _jsx(Heading, { level: 2, className: GC.sectionTitle, children: title })] }), _jsx(Div, { className: GC.sectionBody, children: content })] }, title)))] }));
 }

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

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { PackageCheck, Truck, Camera, RotateCcw, Clock, Headphones, Scale } from "lucide-react";
 import { Alert } from "../../../ui/components/Alert.js";
 import { Code, Li, Section, Ul } from "../../../ui/components/Semantic.js";
@@ -6,6 +6,7 @@ import { Div } from "../../../ui/components/Div.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { GC } from "../../_guide-cls.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 // ─── Section data ─────────────────────────────────────────────────────────────
 const ORDER_STATUSES = [
     { status: "PENDING", desc: "Payment received. Seller has been notified. You can cancel at this stage." },
@@ -19,7 +20,7 @@ const ORDER_STATUSES = [
 const SECTIONS = [
     {
         Icon: PackageCheck, title: "Order Lifecycle",
-        content: (_jsxs(Stack, { textSize: "sm", gap: "md", children: [_jsx(Text, { className: GC.textMuted, children: "Every order on LetItRip moves through these statuses:" }), _jsx(Stack, { gap: "sm", children: ORDER_STATUSES.map(({ status, desc }) => (_jsxs(Row, { gap: "3", children: [_jsx(Text, { className: "flex-shrink-0 font-mono text-[var(--appkit-color-primary)] w-36", size: "xs", weight: "semibold", children: status }), _jsx(Text, { className: GC.textMuted, children: desc })] }, status))) })] })),
+        content: (_jsxs(Stack, { textSize: "sm", gap: "md", children: [_jsxs(Text, { className: GC.textMuted, children: ["Every order on ", getBrandName(), " moves through these statuses:"] }), _jsx(Stack, { gap: "sm", children: ORDER_STATUSES.map(({ status, desc }) => (_jsxs(Row, { gap: "3", children: [_jsx(Text, { className: "flex-shrink-0 font-mono text-[var(--appkit-color-primary)] w-36", size: "xs", weight: "semibold", children: status }), _jsx(Text, { className: GC.textMuted, children: desc })] }, status))) })] })),
     },
     {
         Icon: Truck, title: "Tracking Your Order",
@@ -35,7 +36,7 @@ const SECTIONS = [
     },
     {
         Icon: Clock, title: "Refund Timeline",
-        content: (_jsxs(Stack, { gap: "3", children: [_jsx(Text, { className: GC.textMuted, children: "After the seller accepts your return and confirms receipt of the item:" }), _jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Credit/debit card" }), " \u2014 3\u20137 business days back to your card via Razorpay."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "UPI" }), " \u2014 typically 1\u20132 business days."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Net banking" }), " \u2014 3\u20135 business days."] })] }), _jsx(Text, { className: GC.textMuted, children: "Refunds go back to the original payment method. LetItRip does not issue platform credits in lieu of a refund unless both parties agree." })] })),
+        content: (_jsxs(Stack, { gap: "3", children: [_jsx(Text, { className: GC.textMuted, children: "After the seller accepts your return and confirms receipt of the item:" }), _jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Credit/debit card" }), " \u2014 3\u20137 business days back to your card via Razorpay."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "UPI" }), " \u2014 typically 1\u20132 business days."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Net banking" }), " \u2014 3\u20135 business days."] })] }), _jsxs(Text, { className: GC.textMuted, children: ["Refunds go back to the original payment method. ", getBrandName(), " does not issue platform credits in lieu of a refund unless both parties agree."] })] })),
     },
     {
         Icon: Headphones, title: "Opening a Support Ticket",
@@ -43,10 +44,10 @@ const SECTIONS = [
     },
     {
         Icon: Scale, title: "Dispute Escalation",
-        content: (_jsxs(Stack, { gap: "3", children: [_jsxs(Text, { className: GC.textMuted, children: ["If the seller does not respond to your return request within ", _jsx(Span, { weight: "bold", children: "3 days" }), ", LetItRip's support team steps in to mediate."] }), _jsxs(Text, { className: GC.textMuted, children: ["If mediation cannot resolve the dispute, LetItRip issues a ", _jsx(Span, { weight: "bold", children: "full platform-funded refund" }), " to the buyer. The seller's payout for that order is withheld."] }), _jsx(Alert, { variant: "info", children: "All dispute decisions are final. False dispute claims may result in account restrictions. Always provide accurate, photographic evidence when raising a dispute." })] })),
+        content: (_jsxs(Stack, { gap: "3", children: [_jsxs(Text, { className: GC.textMuted, children: ["If the seller does not respond to your return request within ", _jsx(Span, { weight: "bold", children: "3 days" }), ", ", getBrandName(), "'s support team steps in to mediate."] }), _jsxs(Text, { className: GC.textMuted, children: ["If mediation cannot resolve the dispute, ", getBrandName(), " issues a ", _jsx(Span, { weight: "bold", children: "full platform-funded refund" }), " to the buyer. The seller's payout for that order is withheld."] }), _jsx(Alert, { variant: "info", children: "All dispute decisions are final. False dispute claims may result in account restrictions. Always provide accurate, photographic evidence when raising a dispute." })] })),
     },
 ];
 // ─── Component ────────────────────────────────────────────────────────────────
 export function BuyerOrdersGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: `flex-shrink-0 w-10 h-10 ${GC.iconBg}`, align: "center", justify: "center", rounded: "xl", children: _jsx(PackageCheck, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Buyer Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Orders, Returns & Support" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "From placing an order to getting a refund \u2014 everything you need to know about managing your orders on LetItRip." })] }), SECTIONS.map(({ Icon, iconCls, title, content }) => (_jsxs(Section, { className: GC.sectionWrap, children: [_jsxs(Div, { className: GC.sectionHeader, children: [_jsx(Icon, { className: iconCls ?? GC.iconPrimary }), _jsx(Heading, { level: 2, className: GC.sectionTitle, children: title })] }), _jsx(Div, { className: GC.sectionBody, children: content })] }, title)))] }));
+    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: `flex-shrink-0 w-10 h-10 ${GC.iconBg}`, align: "center", justify: "center", rounded: "xl", children: _jsx(PackageCheck, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Buyer Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Orders, Returns & Support" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["From placing an order to getting a refund \u2014 everything you need to know about managing your orders on ", getBrandName(), "."] })] }), SECTIONS.map(({ Icon, iconCls, title, content }) => (_jsxs(Section, { className: GC.sectionWrap, children: [_jsxs(Div, { className: GC.sectionHeader, children: [_jsx(Icon, { className: iconCls ?? GC.iconPrimary }), _jsx(Heading, { level: 2, className: GC.sectionTitle, children: title })] }), _jsx(Div, { className: GC.sectionBody, children: content })] }, title)))] }));
 }

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

@@ -6,6 +6,7 @@ import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Li, Section, Ul } from "../../../ui/components/Semantic.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { GC } from "../../_guide-cls.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 const SECTIONS = [
     {
         Icon: ShoppingBag, title: "Browsing & Search",
@@ -21,7 +22,7 @@ const SECTIONS = [
     },
     {
         Icon: CreditCard, title: "Checkout",
-        content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Shipping address" }), " \u2014 enter or select a saved address. All fields required: full name, phone, address line, city, state, pin code."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Payment methods" }), " \u2014 UPI, credit/debit card (Visa, Mastercard, Rupay), net banking \u2014 all processed via Razorpay."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Secure checkout" }), " \u2014 LetItRip never stores your card details. All payment data is handled by Razorpay's PCI-DSS compliant gateway."] })] })),
+        content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Shipping address" }), " \u2014 enter or select a saved address. All fields required: full name, phone, address line, city, state, pin code."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Payment methods" }), " \u2014 UPI, credit/debit card (Visa, Mastercard, Rupay), net banking \u2014 all processed via Razorpay."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Secure checkout" }), " \u2014 ", getBrandName(), " never stores your card details. All payment data is handled by Razorpay's PCI-DSS compliant gateway."] })] })),
     },
     {
         Icon: Tag, title: "Coupons",
@@ -38,5 +39,5 @@ const SECTIONS = [
 ];
 // ─── Component ────────────────────────────────────────────────────────────────
 export function BuyerShoppingGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: `flex-shrink-0 w-10 h-10 ${GC.iconBg}`, align: "center", justify: "center", rounded: "xl", children: _jsx(ShoppingBag, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Buyer Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Shopping & Checkout" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Everything you need to know about finding, evaluating, and buying collectibles on LetItRip." })] }), SECTIONS.map(({ Icon, title, content }) => (_jsxs(Section, { className: GC.sectionWrap, children: [_jsxs(Div, { className: GC.sectionHeader, children: [_jsx(Icon, { className: GC.iconPrimary }), _jsx(Heading, { level: 2, className: GC.sectionTitle, children: title })] }), _jsx(Div, { className: GC.sectionBody, children: content })] }, title)))] }));
+    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: `flex-shrink-0 w-10 h-10 ${GC.iconBg}`, align: "center", justify: "center", rounded: "xl", children: _jsx(ShoppingBag, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Buyer Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Shopping & Checkout" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Everything you need to know about finding, evaluating, and buying collectibles on ", getBrandName(), "."] })] }), SECTIONS.map(({ Icon, title, content }) => (_jsxs(Section, { className: GC.sectionWrap, children: [_jsxs(Div, { className: GC.sectionHeader, children: [_jsx(Icon, { className: GC.iconPrimary }), _jsx(Heading, { level: 2, className: GC.sectionTitle, children: title })] }), _jsx(Div, { className: GC.sectionBody, children: content })] }, title)))] }));
 }

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

@@ -16,11 +16,12 @@ import { ACTIONS } from "../../../_internal/shared/actions/action-registry.js";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { normalizeError } from "../../../errors/normalize.js";
 import { toUserMessage } from "../../../errors/error-display-map.js";
+import { formatMoney } from "../../../utils/number.formatter.js";
 const CLS_COUNTER_AMOUNT = "text-[length:var(--appkit-text-sm)] font-semibold text-info dark:text-info";
 function formatRupees(amount) {
     if (amount === undefined || amount === null)
         return "—";
-    return `₹${amount.toLocaleString("en-IN")}`;
+    return formatMoney(amount);
 }
 function relativeTime(date) {
     if (!date)

package/dist/features/account/hooks/useCollapsedSections.js

@@ -1,9 +1,11 @@
 "use client";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { normalizeError } from "../../../errors/normalize.js";
+import { STORAGE_KEYS } from "../../../constants/storage-keys.js";
 import { useCurrentProfile, useUpdateCurrentProfile } from "./useProfile.js";
 const PERSIST_DEBOUNCE_MS = 600;
-const LOCAL_KEY = "letitrip:section-state";
+// 🛑 Read at USE time, not captured in a const — the namespace is set by the
+// consumer's bootstrap, which runs after this module is evaluated.
 /**
  * ─────────────────────────────────────────────────────────────────────────────
  * Persisted, per-user, per-surface open/closed state for collapsible sections.
@@ -50,7 +52,7 @@ function readLocalScopes() {
     if (typeof window === "undefined")
         return {};
     try {
-        const raw = window.localStorage.getItem(LOCAL_KEY);
+        const raw = window.localStorage.getItem(STORAGE_KEYS.sectionState);
         if (!raw)
             return {};
         const parsed = JSON.parse(raw);
@@ -82,7 +84,7 @@ function writeLocalScope(scope, openIds) {
     try {
         const all = readLocalScopes();
         all[scope] = openIds;
-        window.localStorage.setItem(LOCAL_KEY, JSON.stringify(all));
+        window.localStorage.setItem(STORAGE_KEYS.sectionState, JSON.stringify(all));
         // setItem throws on quota exhaustion and in private mode. Same reasoning as
         // readLocalScopes — the debounced profile PATCH is the durable write, so
         // losing the mirror costs one frame of default layout and nothing else.

package/dist/features/account/schemas/index.js

@@ -63,7 +63,7 @@ export const updateProfileSchema = z.object({
     profileIsPublic: annotate(z.boolean().optional(), {
         section: "visibility", sectionLabel: "Visibility", order: 1, row: "full",
         label: "Public profile",
-        help: "When on, your profile is visible to other LetItRip users.",
+        help: "When on, your profile is visible to other members.",
     }),
 });
 /**

package/dist/features/admin/actions/notification-actions.js

@@ -34,6 +34,7 @@ function absoluteActionUrl(path) {
     return base ? `${base}${path}` : path;
 }
 import { DEFAULT_NOTIFICATION_CHANNELS, meetsMinPriority, } from "../schemas/firestore.js";
+import { getBrandName, getBrandNoreplyEmail } from "../../../core/brand-resolver.js";
 /**
  * Notification types whose WhatsApp send is gated behind the SELLER's
  * standing WhatsApp-notifications subscription — see `storeId` on
@@ -304,8 +305,14 @@ export async function sendNotification(input) {
         meetsMinPriority(priority, channels.email.minPriority) &&
         (!channels.email.types?.length || channels.email.types.includes(type))) {
         const apiKey = creds.resendApiKey?.trim() ?? "";
-        const fromEmail = settings.emailSettings?.fromEmail ?? "noreply@letitrip.in";
-        const fromName = settings.emailSettings?.fromName ?? "LetItRip";
+        /*
+         * 🛑 These were `?? "noreply@letitrip.in"` and `?? "LetItRip"` — not
+         * placeholders but live ENVELOPE VALUES, so an install that had not filled
+         * in its email settings sent real mail as this marketplace. The admin
+         * setting still wins; only the fallback changed owner.
+         */
+        const fromEmail = settings.emailSettings?.fromEmail ?? getBrandNoreplyEmail();
+        const fromName = settings.emailSettings?.fromName ?? getBrandName();
         if (apiKey && !apiKey.includes("PLACEHOLDER") && (await isChannelHealthy("email"))) {
             try {
                 const emailProvider = createResendProvider({ apiKey, fromEmail, fromName });

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

@@ -6,8 +6,9 @@ import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Li, Section, Ul } from "../../../ui/components/Semantic.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { GC } from "../../_guide-cls.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 export function AdminAnalyticsGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(BarChart2, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Analytics" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Revenue, order funnel, product performance, and store metrics on LetItRip." })] }), [
+    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(BarChart2, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Analytics" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Revenue, order funnel, product performance, and store metrics on ", getBrandName(), "."] })] }), [
                 {
                     title: "Revenue Dashboard",
                     content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "GMV (Gross Merchandise Value)" }), ": Total order subtotals across all stores. Does not deduct platform commission or refunds."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Net Revenue" }), ": GMV \u00D7 platformFee \u2014 refunded orders excluded."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Period filter" }), ": Last 7 / 30 / 90 days, or custom date range. All monetary values shown in INR."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Payout total" }), ": Total disbursed to sellers in the same period. Revenue - Payout = Platform earnings."] })] })),

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

@@ -17,10 +17,11 @@ import { DataListingView } from "./DataListingView.js";
 import { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "../../../_internal/shared/features/categories/bundle-copy.js";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry.js";
 import { ADMIN_BULK_ACTIONS, ROW_ACTION_META, ROW_ACTION_ID } from "../../products/constants/action-defs.js";
+import { formatMoney } from "../../../utils/number.formatter.js";
 function formatPrice(value) {
     if (typeof value !== "number" || value <= 0)
         return "—";
-    return `₹${value.toLocaleString("en-IN")}`;
+    return formatMoney(value);
 }
 const COLUMNS = [
     {

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

@@ -6,9 +6,10 @@ import { Div } from "../../../ui/components/Div.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { GC } from "../../_guide-cls.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 const CLS_CODE = "text-[length:var(--appkit-text-xs)] bg-amber-100 dark:bg-amber-900/30 px-[var(--appkit-space-1)] rounded";
 export function AdminCatalogGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(Package, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Catalog" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Products, categories, brands, and reviews \u2014 how the LetItRip catalog is structured and managed." })] }), [
+    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(Package, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Catalog" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Products, categories, brands, and reviews \u2014 how the ", getBrandName(), " catalog is structured and managed."] })] }), [
                 {
                     Icon: Package, title: "Product Management",
                     content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Listing types" }), ": ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "standard" }), " (prefix ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "product-" }), "), ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "auction" }), " (prefix ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "auction-" }), "), ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "pre-order" }), " (prefix ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "preorder-" }), ")."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Admin vs store creation" }), ": Admins can create products on behalf of any store via the store picker in AdminProductEditorView."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Status lifecycle" }), ": DRAFT \u2192 PUBLISHED \u2192 ARCHIVED. Published products appear in search. Archived products are hidden but not deleted."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "J13 rule" }), ": Always use ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "listingType" }), " field \u2014 the legacy ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "isAuction" }), "/", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "isPreOrder" }), " booleans have been removed. All queries use ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "where(\"listingType\", \"==\", x)" }), "."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Media URLs" }), ": Never write raw Firebase Storage URLs to Firestore. All product image URLs must use the ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "/api/media/[slug]" }), " proxy format."] })] })),

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

@@ -6,8 +6,9 @@ import { Div } from "../../../ui/components/Div.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { GC } from "../../_guide-cls.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 export function AdminContentGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(FileText, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Content & Marketing" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Blog posts, events, FAQs, carousel, homepage sections, ads, and newsletter on LetItRip." })] }), [
+    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(FileText, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Content & Marketing" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Blog posts, events, FAQs, carousel, homepage sections, ads, and newsletter on ", getBrandName(), "."] })] }), [
                 {
                     Icon: FileText, title: "Blog Posts",
                     content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Statuses" }), ": ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "draft" }), " (not public), ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "published" }), " (live, indexed)."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "readTimeMinutes" }), ": Auto-calculated from content word count (200 wpm). Override manually if the post has heavy media."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "youtubeId" }), ": Optional embedded YouTube video. Use only the video ID (e.g. ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "dQw4w9WgXcQ" }), "), not the full URL."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Media in body" }), ": All images in rich text must use the ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "/api/media/" }), " proxy URL, not raw Firebase Storage links."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "isFeatured" }), ": Sets the post as featured in the blog listing. Different from the homepage featured section \u2014 that is driven by a separate ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "homepageSections" }), " config."] })] })),

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

@@ -20,6 +20,7 @@ import { SectionForm, useSectionFormNav } from "../../shell/SectionForm.js";
 import { apiClient } from "../../../http/index.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { FAQ_CATEGORY_LABELS } from "../../faq/schemas/firestore.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 /**
  * Matches the draft this form actually holds, and the payload it actually
  * sends.
@@ -194,7 +195,7 @@ export function AdminFaqEditorView({ faqId, onSaved, onDeleted, embedded, ...res
             fields: ["question", "slug", "answer"],
             // The rich-text editor holds an uncommitted buffer.
             keepMounted: true,
-            render: ({ values: v, onChange, errors }) => (_jsxs(Stack, { gap: "md", children: [_jsx(FieldInput, { name: "question", label: "Question", value: String(v.question ?? ""), onChange: (val) => onChange({ question: val }), required: true, placeholder: "e.g. How does bidding work on LetItRip?", error: errors.question }), _jsx(Input, { label: "Slug", value: String(v.slug ?? ""), onChange: (e) => {
+            render: ({ values: v, onChange, errors }) => (_jsxs(Stack, { gap: "md", children: [_jsx(FieldInput, { name: "question", label: "Question", value: String(v.question ?? ""), onChange: (val) => onChange({ question: val }), required: true, placeholder: `e.g. How does bidding work on ${getBrandName()}?`, error: errors.question }), _jsx(Input, { label: "Slug", value: String(v.slug ?? ""), onChange: (e) => {
                             setSlugManual(true);
                             onChange({ slug: e.target.value });
                         }, placeholder: "faq-how-does-bidding-work", helperText: "Auto-generated from the question until you edit it. Must start with 'faq-'.", error: errors.slug }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "sm", weight: "medium", color: "muted", children: "Answer" }), _jsx(RichTextEditor, { ariaLabel: "Answer", value: String(v.answer ?? ""), onChange: (val) => onChange({ answer: val }), placeholder: "Write a clear, helpful answer...", minHeightClassName: "min-h-[200px]" }), errors.answer && (_jsx(Text, { size: "xs", color: "error", role: "alert", children: errors.answer }))] })] })),

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

@@ -63,6 +63,7 @@ import { Button } from "../../../ui/components/Button.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { ADMIN_GATEWAY_EVENT_KIND_TABS, ADMIN_GATEWAY_EVENT_STATUS_TABS, } from "../constants/filter-tabs.js";
 import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData.js";
+import { formatMoney } from "../../../utils/number.formatter.js";
 import { DataListingView } from "./DataListingView.js";
 /** Operator-facing status names — see the 🛑 about `ignored` and `conflict`. */
 const STATUS_LABEL = {
@@ -194,7 +195,7 @@ export function AdminGatewayEventsView({ children, ...props }) {
                         { label: "Body SHA-256", value: toStringValue(detail.bodySha256, "") },
                         { label: "Gateway order", value: toStringValue(detail.gatewayOrderId, "") || "—" },
                         { label: "Gateway payment", value: toStringValue(detail.gatewayPaymentId, "") || "—" },
-                        { label: "Amount", value: typeof detail.amount === "number" ? `₹${detail.amount.toFixed(2)}` : "—" },
+                        { label: "Amount", value: typeof detail.amount === "number" ? formatMoney(detail.amount) : "—" },
                         { label: "Orders placed", value: Array.isArray(detail.orderIds) ? detail.orderIds.join(", ") : "—" },
                         { label: "Received", value: toStringValue(detail.receivedAt, "") },
                         { label: "Settled", value: toStringValue(detail.processedAt, "") || "— not settled" },

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

@@ -7,6 +7,7 @@ import { Heading, Text } from "../../../ui/components/Typography.js";
 import { Section } from "../../../ui/components/Semantic.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 const CLS_WARN_PANEL = "rounded-2xl border border-amber-200 bg-warning-surface dark:border-amber-800 p-[var(--appkit-space-6)]";
 const CLS_WARN_HEAD = "font-semibold text-amber-800 dark:text-amber-300 mb-1";
 const CLS_WARN_BODY = "text-[length:var(--appkit-text-sm)] text-amber-700 dark:text-amber-400";
@@ -86,5 +87,5 @@ export function AdminGuideHubView({ permissions = [], isFullAdmin = false }) {
     const hasPermission = (perm) => isFullAdmin || permissions.includes(perm);
     const visibleCards = GUIDE_CARDS.filter((c) => hasPermission(c.permission));
     const hasAny = visibleCards.length > 0;
-    return (_jsxs(Stack, { gap: "xl", padding: "b-2xl", children: [_jsx(Section, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "2xl", shadow: "sm", children: _jsxs(Div, { paddingX: "x-md-xl", paddingY: "y-xl", className: "[background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_60%,var(--appkit-color-secondary-400)_100%)]", children: [_jsxs(Row, { className: "mb-3", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10", surface: "default", align: "center", justify: "center", rounded: "xl", children: _jsx(BookOpen, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { color: "inverse-muted", className: "tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin & Employee Guide" })] }), _jsx(Heading, { color: "inverse", level: 1, className: "mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "LetItRip Internal Guide" }), _jsx(Text, { color: "inverse-muted", size: "base", children: "Everything you need to operate and manage LetItRip \u2014 India's largest collectibles marketplace." })] }) }), _jsx(Alert, { variant: "info", compact: true, children: "These guides describe expected platform behaviour. Real access to each section is enforced independently by the permission system \u2014 this page is reference only." }), !hasAny && (_jsx(Alert, { variant: "info", title: "Limited access", children: "Your permission set doesn't include read access to any admin sections yet. Contact your admin to request the permissions you need." })), hasAny && (_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text)] mb-4", size: "lg", weight: "semibold", children: "Guides" }), _jsx(Grid, { cols: "cards", gap: "md", children: visibleCards.map(({ Icon, title, description, href }) => (_jsxs(TextLink, { variant: "bare", href: href, rounded: "xl", layout: "flex-col", gap: "md", paddingX: "lg", paddingY: "lg", shadow: "hover-md", className: "group border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] hover:border-[var(--appkit-color-primary)] transition-all", children: [_jsxs(Row, { align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-9 h-9 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "lg", children: _jsx(Icon, { className: "w-4 h-4 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text)] group-hover:text-[var(--appkit-color-primary)] transition-colors", weight: "semibold", children: title })] }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] leading-relaxed", size: "sm", children: description }), _jsx(Text, { className: "text-[var(--appkit-color-primary)] mt-auto", size: "xs", weight: "medium", children: "Read guide \u2192" })] }, title))) })] })), _jsx(Section, { className: CLS_WARN_PANEL, children: _jsxs(Row, { align: "start", gap: "3", children: [_jsx(AlertTriangle, { className: "w-5 h-5 text-warning flex-shrink-0 mt-0.5" }), _jsxs(Div, { children: [_jsx(Text, { className: CLS_WARN_HEAD, children: "Remember: with great access comes responsibility" }), _jsx(Text, { className: CLS_WARN_BODY, children: "Admin actions are logged. Never access user PII (email, phone) without a legitimate support reason. Never grant capabilities or permissions without documented approval. When in doubt, escalate to a senior admin." })] })] }) })] }));
+    return (_jsxs(Stack, { gap: "xl", padding: "b-2xl", children: [_jsx(Section, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "2xl", shadow: "sm", children: _jsxs(Div, { paddingX: "x-md-xl", paddingY: "y-xl", className: "[background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_60%,var(--appkit-color-secondary-400)_100%)]", children: [_jsxs(Row, { className: "mb-3", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10", surface: "default", align: "center", justify: "center", rounded: "xl", children: _jsx(BookOpen, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { color: "inverse-muted", className: "tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin & Employee Guide" })] }), _jsxs(Heading, { color: "inverse", level: 1, className: "mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: [getBrandName(), " Internal Guide"] }), _jsxs(Text, { color: "inverse-muted", size: "base", children: ["Everything you need to operate and manage ", getBrandName(), " \u2014 India's largest collectibles marketplace."] })] }) }), _jsx(Alert, { variant: "info", compact: true, children: "These guides describe expected platform behaviour. Real access to each section is enforced independently by the permission system \u2014 this page is reference only." }), !hasAny && (_jsx(Alert, { variant: "info", title: "Limited access", children: "Your permission set doesn't include read access to any admin sections yet. Contact your admin to request the permissions you need." })), hasAny && (_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text)] mb-4", size: "lg", weight: "semibold", children: "Guides" }), _jsx(Grid, { cols: "cards", gap: "md", children: visibleCards.map(({ Icon, title, description, href }) => (_jsxs(TextLink, { variant: "bare", href: href, rounded: "xl", layout: "flex-col", gap: "md", paddingX: "lg", paddingY: "lg", shadow: "hover-md", className: "group border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] hover:border-[var(--appkit-color-primary)] transition-all", children: [_jsxs(Row, { align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-9 h-9 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "lg", children: _jsx(Icon, { className: "w-4 h-4 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text)] group-hover:text-[var(--appkit-color-primary)] transition-colors", weight: "semibold", children: title })] }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] leading-relaxed", size: "sm", children: description }), _jsx(Text, { className: "text-[var(--appkit-color-primary)] mt-auto", size: "xs", weight: "medium", children: "Read guide \u2192" })] }, title))) })] })), _jsx(Section, { className: CLS_WARN_PANEL, children: _jsxs(Row, { align: "start", gap: "3", children: [_jsx(AlertTriangle, { className: "w-5 h-5 text-warning flex-shrink-0 mt-0.5" }), _jsxs(Div, { children: [_jsx(Text, { className: CLS_WARN_HEAD, children: "Remember: with great access comes responsibility" }), _jsx(Text, { className: CLS_WARN_BODY, children: "Admin actions are logged. Never access user PII (email, phone) without a legitimate support reason. Never grant capabilities or permissions without documented approval. When in doubt, escalate to a senior admin." })] })] }) })] }));
 }

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

@@ -68,6 +68,7 @@ import { Text } from "../../../ui/components/Typography.js";
 import { RecordStatusTimeline } from "../../status-history/components/RecordStatusTimeline.js";
 import { ReviewDecisionModal } from "../../store-extensions/components/ReviewDecisionModal.js";
 import { paymentCaseResolveFormSchema, } from "../../payment-cases/schemas/resolve-form.js";
+import { formatMoney } from "../../../utils/number.formatter.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { ADMIN_PAYMENT_CASE_KIND_TABS, ADMIN_PAYMENT_CASE_SEVERITY_TABS, ADMIN_PAYMENT_CASE_STATUS_TABS, } from "../constants/filter-tabs.js";
 import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData.js";
@@ -95,7 +96,7 @@ const KIND_LABEL = {
 };
 /** Rupees, for a row. Plain `toFixed` — these are already decimal rupees. */
 function money(value) {
-    return typeof value === "number" ? `₹${value.toFixed(2)}` : null;
+    return typeof value === "number" ? formatMoney(value) : null;
 }
 /**
  * Narrow a JSON value to status-history entries.

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

@@ -6,6 +6,7 @@ import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { GC } from "../../_guide-cls.js";
 import { resolvePublishedValues } from "../../../_internal/shared/content/published-values.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
 /*
  * Phase 9 — read from the published-value registry rather than restated.
  *
@@ -16,7 +17,7 @@ import { resolvePublishedValues } from "../../../_internal/shared/content/publis
  */
 const { returnRespondHours: RETURN_RESPOND_HOURS, refundBusinessDaysMin: REFUND_DAYS_MIN, refundBusinessDaysMax: REFUND_DAYS_MAX, } = resolvePublishedValues();
 export function AdminOrdersGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(ShoppingBag, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Orders & Finance" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Order statuses, payouts, disputes, returns, and commission math on LetItRip." })] }), [
+    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(ShoppingBag, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "Orders & Finance" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Order statuses, payouts, disputes, returns, and commission math on ", getBrandName(), "."] })] }), [
                 {
                     Icon: ShoppingBag, title: "Order Statuses",
                     content: (_jsxs(Stack, { textSize: "sm", gap: "sm", children: [[