@mohasinac/appkit 4.71.0 → 4.72.0

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

@@ -8,6 +8,7 @@ import { Heading, Text } from "../../../ui/components/Typography.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { Section } from "../../../ui/components/Semantic.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const __P = {
     p5: "p-[var(--appkit-space-5)]",
 };
@@ -37,7 +38,7 @@ const __P = {
  * weight" without somewhere to check it against would be advice shaped like
  * help, so each signal links to the surface that answers it.
  */
-export async function SpotAFakeView({} = {}) {
+export async function SpotAFakeView({ pageRegionCards = [] } = {}) {
     const page = { container: PAGE_CONTAINER };
     const themed = { bgPrimary: THEMED_BG_PRIMARY, bgSecondary: THEMED_BG_SECONDARY };
     const { getTranslations } = await import("next-intl/server");
@@ -50,5 +51,5 @@ export async function SpotAFakeView({} = {}) {
         { n: 5, title: t("signal5Title"), text: t("signal5Text"), href: null },
         { n: 6, title: t("signal6Title"), text: t("signal6Text"), href: null },
     ];
-    return (_jsxs(Div, { children: [_jsx(Section, { className: themed.bgPrimary, padding: "y-2xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsx(Heading, { level: 1, size: "3xl", mdSize: "4xl", weight: "bold", className: "mb-3", children: t("title") }), _jsx(Text, { size: "lg", color: "muted", className: "max-w-3xl", children: t("intro") })] }) }), _jsx(Section, { padding: "y-xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsxs(Alert, { variant: "warning", className: "mb-8", children: [_jsx(Text, { weight: "semibold", children: t("whyTitle") }), _jsx(Text, { size: "sm", children: t("whyText") })] }), _jsx(Heading, { level: 2, size: "xl", weight: "semibold", className: "mb-4", children: t("signalsTitle") }), _jsx(Stack, { gap: "md", children: SIGNALS.map((s) => (_jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-1", children: `${s.n}. ${s.title}` }), _jsx(Text, { color: "muted", children: s.text }), s.href && (_jsx(Div, { padding: "t-xs", children: _jsx(TextLink, { href: s.href, size: "sm", children: s.n === 1 ? t("linkTools") : t("linkParts") }) }))] }, s.n))) })] }) }), _jsx(Section, { className: themed.bgSecondary, padding: "y-xl", children: _jsx(Div, { className: page.container.lg, children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("authenticityTitle") }), _jsx(Text, { color: "muted", children: t("authenticityText") })] }), _jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("reportTitle") }), _jsx(Text, { color: "muted", children: t("reportText") }), _jsxs(Row, { gap: "md", wrap: true, className: "mt-3", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.REPORT_ENTITY), children: t("linkReport") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.SCAMS), children: t("linkScams") })] })] })] }) }) })] }));
+    return (_jsxs(Div, { children: [_jsx(Section, { className: themed.bgPrimary, padding: "y-2xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsx(Heading, { level: 1, size: "3xl", mdSize: "4xl", weight: "bold", className: "mb-3", children: t("title") }), _jsx(Text, { size: "lg", color: "muted", className: "max-w-3xl", children: t("intro") })] }) }), _jsx(Section, { padding: "y-lg", children: _jsx(Div, { className: page.container.lg, children: _jsx(AdminComposableRegion, { pageId: "spot-a-fake", initialCards: pageRegionCards }) }) }), _jsx(Section, { padding: "y-xl", children: _jsxs(Div, { className: page.container.lg, children: [_jsxs(Alert, { variant: "warning", className: "mb-8", children: [_jsx(Text, { weight: "semibold", children: t("whyTitle") }), _jsx(Text, { size: "sm", children: t("whyText") })] }), _jsx(Heading, { level: 2, size: "xl", weight: "semibold", className: "mb-4", children: t("signalsTitle") }), _jsx(Stack, { gap: "md", children: SIGNALS.map((s) => (_jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-1", children: `${s.n}. ${s.title}` }), _jsx(Text, { color: "muted", children: s.text }), s.href && (_jsx(Div, { padding: "t-xs", children: _jsx(TextLink, { href: s.href, size: "sm", children: s.n === 1 ? t("linkTools") : t("linkParts") }) }))] }, s.n))) })] }) }), _jsx(Section, { className: themed.bgSecondary, padding: "y-xl", children: _jsx(Div, { className: page.container.lg, children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("authenticityTitle") }), _jsx(Text, { color: "muted", children: t("authenticityText") })] }), _jsxs(Div, { className: __P.p5, surface: "card", rounded: "xl", border: "subtle", children: [_jsx(Heading, { level: 3, size: "lg", weight: "semibold", className: "mb-2", children: t("reportTitle") }), _jsx(Text, { color: "muted", children: t("reportText") }), _jsxs(Row, { gap: "md", wrap: true, className: "mt-3", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.REPORT_ENTITY), children: t("linkReport") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.SCAMS), children: t("linkScams") })] })] })] }) }) })] }));
 }

package/dist/features/about/components/TrackOrderView.d.ts

@@ -1,3 +1,6 @@
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface TrackOrderViewProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function TrackOrderView({}?: TrackOrderViewProps): Promise<import("react").JSX.Element>;
+export declare function TrackOrderView({ pageRegionCards, }?: TrackOrderViewProps): Promise<import("react").JSX.Element>;

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

@@ -10,7 +10,8 @@ import { Grid, Stack } from "../../../ui/components/Layout.js";
 import { Section } from "../../../ui/components/Semantic.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
 import { ShoppingBag, Truck, MapPin, CheckCircle2 } from "lucide-react";
-export async function TrackOrderView({} = {}) {
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
+export async function TrackOrderView({ pageRegionCards = [], } = {}) {
     const themed = {
         bgPrimary: THEMED_BG_PRIMARY,
         bgSecondary: THEMED_BG_SECONDARY,
@@ -51,5 +52,5 @@ export async function TrackOrderView({} = {}) {
             bg: "bg-emerald-100 dark:bg-emerald-900/40",
         },
     ];
-    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", title: t("title"), subtitle: t("subtitle") }), _jsx(Div, { className: page.container.md, padding: "y-4xl", children: _jsxs(Stack, { gap: "hero", children: [_jsxs(Section, { className: `text-center`, border: "default", surface: "subtle", rounded: "2xl", padding: "xl", children: [_jsx(Row, { align: "center", justify: "center", className: `w-16 h-16 bg-primary/10 dark:bg-primary/15 mx-auto mb-4`, rounded: "full", children: _jsx(ShoppingBag, { className: "w-8 h-8 text-primary" }) }), _jsx(Heading, { level: 2, className: "mb-3", children: t("signInPrompt") }), _jsxs(Stack, { direction: "sm-row", justify: "center", className: "mt-6", gap: "3", children: [_jsx(TextLink, { rounded: "lg", paddingX: "xl", paddingY: "md", layout: "inline-flex", align: "center", justify: "center", gap: "sm", href: String(ROUTES.AUTH.LOGIN), className: `bg-primary hover:bg-primary/90 text-white transition-colors`, weight: "medium", children: t("signIn") }), _jsx(TextLink, { rounded: "lg", paddingX: "xl", paddingY: "md", layout: "inline-flex", align: "center", justify: "center", gap: "sm", href: String(ROUTES.USER.ORDERS), className: `${themed.bgPrimary} border ${themed.border} ${themed.textPrimary} hover:opacity-80 transition-opacity`, weight: "medium", children: t("viewOrders") })] })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-10", align: "center", children: t("howItWorksTitle") }), _jsx(Grid, { className: "grid-cols-1 sm:grid-cols-2 xl:grid-cols-4", gap: "lg", children: STEPS.map(({ icon: Icon, title, text, color, bg }, index) => (_jsxs(Div, { rounded: "xl", padding: "lg", className: `${themed.bgSecondary} border ${themed.border} relative`, children: [_jsx(Caption, { className: "absolute top-4 right-4", weight: "bold", children: String(index + 1).padStart(2, "0") }), _jsx(Row, { align: "center", justify: "center", className: `w-12 h-12 ${bg} mb-4`, rounded: "xl", children: _jsx(Icon, { className: `w-6 h-6 ${color}` }) }), _jsx(Heading, { level: 3, className: "mb-2", children: title }), _jsx(Text, { variant: "secondary", size: "sm", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { layout: "flex-sm-row-between", gap: "md", border: "default", surface: "subtle", rounded: "xl", padding: "lg", children: [_jsxs(Div, { children: [_jsx(Heading, { level: 2, className: "mb-1", children: t("needHelpTitle") }), _jsx(Text, { variant: "secondary", size: "sm", children: t("needHelpText") })] }), _jsxs(Row, { gap: "3", className: "flex-shrink-0", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.HELP), className: `${themed.textSecondary} hover:text-primary underline underline-offset-4 transition-colors`, size: "sm", children: t("helpCenter") }), _jsx(TextLink, { rounded: "lg", paddingX: "md", paddingY: "xs", href: String(ROUTES.PUBLIC.CONTACT), className: "bg-primary hover:bg-primary/90 text-white transition-colors", size: "sm", children: t("contactSupport") })] })] })] }) })] }));
+    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", title: t("title"), subtitle: t("subtitle") }), _jsx(Div, { className: page.container.md, padding: "y-4xl", children: _jsxs(Stack, { gap: "hero", children: [_jsx(AdminComposableRegion, { pageId: "track", initialCards: pageRegionCards }), _jsxs(Section, { className: `text-center`, border: "default", surface: "subtle", rounded: "2xl", padding: "xl", children: [_jsx(Row, { align: "center", justify: "center", className: `w-16 h-16 bg-primary/10 dark:bg-primary/15 mx-auto mb-4`, rounded: "full", children: _jsx(ShoppingBag, { className: "w-8 h-8 text-primary" }) }), _jsx(Heading, { level: 2, className: "mb-3", children: t("signInPrompt") }), _jsxs(Stack, { direction: "sm-row", justify: "center", className: "mt-6", gap: "3", children: [_jsx(TextLink, { rounded: "lg", paddingX: "xl", paddingY: "md", layout: "inline-flex", align: "center", justify: "center", gap: "sm", href: String(ROUTES.AUTH.LOGIN), className: `bg-primary hover:bg-primary/90 text-white transition-colors`, weight: "medium", children: t("signIn") }), _jsx(TextLink, { rounded: "lg", paddingX: "xl", paddingY: "md", layout: "inline-flex", align: "center", justify: "center", gap: "sm", href: String(ROUTES.USER.ORDERS), className: `${themed.bgPrimary} border ${themed.border} ${themed.textPrimary} hover:opacity-80 transition-opacity`, weight: "medium", children: t("viewOrders") })] })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-10", align: "center", children: t("howItWorksTitle") }), _jsx(Grid, { className: "grid-cols-1 sm:grid-cols-2 xl:grid-cols-4", gap: "lg", children: STEPS.map(({ icon: Icon, title, text, color, bg }, index) => (_jsxs(Div, { rounded: "xl", padding: "lg", className: `${themed.bgSecondary} border ${themed.border} relative`, children: [_jsx(Caption, { className: "absolute top-4 right-4", weight: "bold", children: String(index + 1).padStart(2, "0") }), _jsx(Row, { align: "center", justify: "center", className: `w-12 h-12 ${bg} mb-4`, rounded: "xl", children: _jsx(Icon, { className: `w-6 h-6 ${color}` }) }), _jsx(Heading, { level: 3, className: "mb-2", children: title }), _jsx(Text, { variant: "secondary", size: "sm", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { layout: "flex-sm-row-between", gap: "md", border: "default", surface: "subtle", rounded: "xl", padding: "lg", children: [_jsxs(Div, { children: [_jsx(Heading, { level: 2, className: "mb-1", children: t("needHelpTitle") }), _jsx(Text, { variant: "secondary", size: "sm", children: t("needHelpText") })] }), _jsxs(Row, { gap: "3", className: "flex-shrink-0", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.HELP), className: `${themed.textSecondary} hover:text-primary underline underline-offset-4 transition-colors`, size: "sm", children: t("helpCenter") }), _jsx(TextLink, { rounded: "lg", paddingX: "md", paddingY: "xs", href: String(ROUTES.PUBLIC.CONTACT), className: "bg-primary hover:bg-primary/90 text-white transition-colors", size: "sm", children: t("contactSupport") })] })] })] }) })] }));
 }

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

@@ -29,8 +29,8 @@ export { FAQPageView } from "./components/FAQPageView";
 export type { FAQPageViewProps } from "./components/FAQPageView";
 export { HelpPageView } from "./components/HelpPageView";
 export type { HelpPageViewProps } from "./components/HelpPageView";
-export { HowAuctionsWorkView } from "./components/HowAuctionsWorkView";
-export type { HowAuctionsWorkViewProps } from "./components/HowAuctionsWorkView";
+export { HowCollectorDropsWorkView } from "./components/HowCollectorDropsWorkView";
+export type { HowCollectorDropsWorkViewProps } from "./components/HowCollectorDropsWorkView";
 export { HowPayoutsWorkView } from "./components/HowPayoutsWorkView";
 export type { HowPayoutsWorkViewProps } from "./components/HowPayoutsWorkView";
 export { HowPreOrdersWorkView } from "./components/HowPreOrdersWorkView";

package/dist/features/about/index.js

@@ -17,7 +17,7 @@ export { PolicyPageView } from "./components/PolicyPageView.js";
 export { DeveloperView } from "./components/DeveloperView.js";
 export { FAQPageView } from "./components/FAQPageView.js";
 export { HelpPageView } from "./components/HelpPageView.js";
-export { HowAuctionsWorkView } from "./components/HowAuctionsWorkView.js";
+export { HowCollectorDropsWorkView } from "./components/HowCollectorDropsWorkView.js";
 export { HowPayoutsWorkView } from "./components/HowPayoutsWorkView.js";
 export { HowPreOrdersWorkView } from "./components/HowPreOrdersWorkView.js";
 export { PublicProfileView } from "./components/PublicProfileView.js";

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

@@ -7,13 +7,13 @@ export declare const aboutHowItemSchema: z.ZodObject<{
     tone: z.ZodOptional<z.ZodEnum<["indigo", "teal", "amber", "rose"]>>;
 }, "strip", z.ZodTypeAny, {
     title: string;
-    icon: string;
     text: string;
+    icon: string;
     tone?: "indigo" | "teal" | "amber" | "rose" | undefined;
 }, {
     title: string;
-    icon: string;
     text: string;
+    icon: string;
     tone?: "indigo" | "teal" | "amber" | "rose" | undefined;
 }>;
 export declare const aboutValueItemSchema: z.ZodObject<{
@@ -22,12 +22,12 @@ export declare const aboutValueItemSchema: z.ZodObject<{
     icon: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     title: string;
-    icon: string;
     text: string;
+    icon: string;
 }, {
     title: string;
-    icon: string;
     text: string;
+    icon: string;
 }>;
 export declare const aboutMilestoneSchema: z.ZodObject<{
     year: z.ZodString;
@@ -47,15 +47,15 @@ export declare const aboutTeamMemberSchema: z.ZodObject<{
     isFounder: z.ZodOptional<z.ZodBoolean>;
     isDeveloper: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     role: string;
+    name: string;
     bio: string;
     photoUrl?: string | undefined;
     isFounder?: boolean | undefined;
     isDeveloper?: boolean | undefined;
 }, {
-    name: string;
     role: string;
+    name: string;
     bio: string;
     photoUrl?: string | undefined;
     isFounder?: boolean | undefined;
@@ -74,13 +74,13 @@ export declare const aboutContentSchema: z.ZodObject<{
         tone: z.ZodOptional<z.ZodEnum<["indigo", "teal", "amber", "rose"]>>;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        icon: string;
         text: string;
+        icon: string;
         tone?: "indigo" | "teal" | "amber" | "rose" | undefined;
     }, {
         title: string;
-        icon: string;
         text: string;
+        icon: string;
         tone?: "indigo" | "teal" | "amber" | "rose" | undefined;
     }>, "many">;
     valuesTitle: z.ZodString;
@@ -90,12 +90,12 @@ export declare const aboutContentSchema: z.ZodObject<{
         icon: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        icon: string;
         text: string;
+        icon: string;
     }, {
         title: string;
-        icon: string;
         text: string;
+        icon: string;
     }>, "many">;
     milestonesTitle: z.ZodString;
     milestones: z.ZodArray<z.ZodObject<{
@@ -118,15 +118,15 @@ export declare const aboutContentSchema: z.ZodObject<{
         isFounder: z.ZodOptional<z.ZodBoolean>;
         isDeveloper: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        name: string;
         role: string;
+        name: string;
         bio: string;
         photoUrl?: string | undefined;
         isFounder?: boolean | undefined;
         isDeveloper?: boolean | undefined;
     }, {
-        name: string;
         role: string;
+        name: string;
         bio: string;
         photoUrl?: string | undefined;
         isFounder?: boolean | undefined;
@@ -154,18 +154,18 @@ export declare const aboutContentSchema: z.ZodObject<{
     ctaShop: string;
     howItems: {
         title: string;
-        icon: string;
         text: string;
+        icon: string;
         tone?: "indigo" | "teal" | "amber" | "rose" | undefined;
     }[];
     valueItems: {
         title: string;
-        icon: string;
         text: string;
+        icon: string;
     }[];
     teamMembers: {
-        name: string;
         role: string;
+        name: string;
         bio: string;
         photoUrl?: string | undefined;
         isFounder?: boolean | undefined;
@@ -190,18 +190,18 @@ export declare const aboutContentSchema: z.ZodObject<{
     ctaShop: string;
     howItems: {
         title: string;
-        icon: string;
         text: string;
+        icon: string;
         tone?: "indigo" | "teal" | "amber" | "rose" | undefined;
     }[];
     valueItems: {
         title: string;
-        icon: string;
         text: string;
+        icon: string;
     }[];
     teamMembers: {
-        name: string;
         role: string;
+        name: string;
         bio: string;
         photoUrl?: string | undefined;
         isFounder?: boolean | undefined;

package/dist/features/account/components/AddressBook.d.ts

@@ -1,5 +1,5 @@
 import type { UserAddress } from "../types";
-import type { JsonValue } from "@mohasinac/appkit";
+import type { JsonValue } from "../../../schemas/types";
 export interface AddressCardAddress {
     id: string;
     label?: string;

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

@@ -30,10 +30,21 @@ import { FormErrorSummary, applyZodIssues } from "../../../ui/forms/index.js";
 import { FormShellContext, useFormShellState } from "../../../ui/forms/FormShell.js";
 import { buildSectionsFromSchema, visibleValues } from "../../shell/build-sections.js";
 import { SectionForm, useSectionFormNav } from "../../shell/SectionForm.js";
+import { useFieldVisibility } from "../../shell/useFieldVisibility.js";
 import { addressFormSchema } from "../../addresses/schemas/address-form.js";
 import { usePostalLookup } from "../../addresses/hooks/usePostalLookup.js";
 import { AddressLocationFields } from "../../addresses/components/AddressLocationFields.js";
 import { COUNTRIES, DEFAULT_COUNTRY } from "../../../constants/geo/countries.js";
+import { useEditMode } from "../../../edit-mode/index.js";
+/**
+ * Admin field-visibility surface id (3B hard gate — PII-forms migration,
+ * 2026-11-05). One shared id, deliberately, matching this component's own
+ * "purely presentational, reused as-is" contract (see `StoreAddressClients`'s
+ * header comment) — buyer address book and seller pickup address are both
+ * this same component with no per-caller config today, so a per-caller
+ * surface id would contradict that existing design rather than extend it.
+ */
+const FIELD_VISIBILITY_SURFACE_ID = "address-form";
 const COUNTRY_OPTIONS = Object.values(COUNTRIES).map((c) => ({
     value: c.code,
     label: c.name,
@@ -66,21 +77,34 @@ export function AddressForm({ initialData, onSubmit, onCancel, isLoading = false
         })),
         enabled: !isLoading,
     });
+    const { editMode } = useEditMode();
+    const { fields: visibilityFields, setVisible: setFieldVisible } = useFieldVisibility(FIELD_VISIBILITY_SURFACE_ID);
     const sections = React.useMemo(() => buildSectionsFromSchema(addressFormSchema, {
         options: { country: COUNTRY_OPTIONS },
+        fieldVisibility: visibilityFields,
+        editMode,
+        onToggleFieldVisibility: setFieldVisible,
         renderers: {
             /*
              * State, postal code and country move together: the country decides
              * whether state is a picker or free text AND what a valid postal
              * code looks like, so one component owns all three rather than three
              * renderers each re-deriving the same country.
+             *
+             * 🛑 Hiding `state` via the admin field-visibility toggle hides this
+             * whole combined control — postal code and country included — since
+             * they render `null` on their own and have nothing to show
+             * independently. Toggling `postalCode`/`country` individually is
+             * therefore a no-op; `state` is the one toggle that does anything.
+             * Same property `StoreCreateForm`'s own proven wiring has for any
+             * multi-field custom renderer — not a new limitation.
              */
             state: ({ values, onChange, errors }) => (_jsx(AddressLocationFields, { country: values.country, state: values.state, postalCode: values.postalCode, errors: errors, isLooking: isLooking, onChange: onChange, onPostalSettled: lookup })),
             // Rendered by the component above.
             postalCode: () => null,
             country: () => null,
         },
-    }), [isLooking, lookup]);
+    }), [isLooking, lookup, visibilityFields, editMode, setFieldVisible]);
     const nav = useSectionFormNav(sections, form, { scope: "user:address" });
     const { shellCtx, setFieldError, clearErrors } = useFormShellState(addressFormSchema, {
         sections: nav.sectionMeta,

package/dist/features/account/components/BecomeSellerView.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface BecomeSellerViewLabels {
     title?: string;
     applyButton?: string;
@@ -24,5 +25,7 @@ export interface BecomeSellerViewProps {
     /** Which state to render. Shell exposes all four slots; consumer controls which is active. */
     state?: BecomeSellerState;
     className?: string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function BecomeSellerView({ labels, renderGuide, renderSuccess, renderCreateStore, renderAlreadySeller, state, className, }: BecomeSellerViewProps): React.JSX.Element;
+export declare function BecomeSellerView({ labels, renderGuide, renderSuccess, renderCreateStore, renderAlreadySeller, state, className, pageRegionCards, }: BecomeSellerViewProps): React.JSX.Element;

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

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Div } from "../../../ui/components/Div.js";
 import { Heading } from "../../../ui/components/Typography.js";
-export function BecomeSellerView({ labels = {}, renderGuide, renderSuccess, renderCreateStore, renderAlreadySeller, state = "guide", className = "", }) {
-    return (_jsxs(Div, { className: className, children: [labels.title && state === "guide" && (_jsx(Heading, { level: 1, className: "mb-6", size: "2xl", weight: "bold", children: labels.title })), state === "guide" && renderGuide?.(), state === "success" && renderSuccess?.(), state === "create-store" && renderCreateStore?.(), state === "already-seller" && renderAlreadySeller?.()] }));
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
+export function BecomeSellerView({ labels = {}, renderGuide, renderSuccess, renderCreateStore, renderAlreadySeller, state = "guide", className = "", pageRegionCards = [], }) {
+    return (_jsxs(Div, { className: className, children: [labels.title && state === "guide" && (_jsx(Heading, { level: 1, className: "mb-6", size: "2xl", weight: "bold", children: labels.title })), state === "guide" && renderGuide?.(), state === "success" && renderSuccess?.(), state === "create-store" && renderCreateStore?.(), state === "already-seller" && renderAlreadySeller?.(), _jsx(AdminComposableRegion, { pageId: "user-become-seller", initialCards: pageRegionCards })] }));
 }

package/dist/features/account/components/BuyerAccountGuideView.d.ts

@@ -1,2 +1,7 @@
 import React from "react";
-export declare function BuyerAccountGuideView(): React.JSX.Element;
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface BuyerAccountGuideViewProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function BuyerAccountGuideView({ pageRegionCards }?: BuyerAccountGuideViewProps): React.JSX.Element;

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

@@ -9,6 +9,7 @@ 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";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const SECTIONS = [
     {
         Icon: UserCheck, title: "Your Profile",
@@ -16,7 +17,7 @@ const SECTIONS = [
     },
     {
         Icon: Bell, title: "Notifications",
-        content: (_jsxs(Stack, { gap: "3", children: [_jsx(Text, { className: GC.textMuted, children: "You'll receive in-app notifications for:" }), _jsxs(Ul, { className: GC.listDiscMuted, children: [_jsx(Li, { children: "Order status changes (Processing, Shipped, Delivered)" }), _jsx(Li, { children: "Outbid alerts on auctions you're participating in" }), _jsx(Li, { children: "Auction win notification" }), _jsx(Li, { children: "Review request after a delivered order" }), _jsx(Li, { children: "Support ticket replies" })] }), _jsxs(Text, { className: GC.textMuted, children: ["Manage notification preferences at ", _jsx(Span, { weight: "bold", children: "My Account \u2192 Settings \u2192 Notifications" }), "."] })] })),
+        content: (_jsxs(Stack, { gap: "3", children: [_jsx(Text, { className: GC.textMuted, children: "You'll receive in-app notifications for:" }), _jsxs(Ul, { className: GC.listDiscMuted, children: [_jsx(Li, { children: "Order status changes (Processing, Shipped, Delivered)" }), _jsx(Li, { children: "Outbid alerts on collectorDrops you're participating in" }), _jsx(Li, { children: "Collector Drop win notification" }), _jsx(Li, { children: "Review request after a delivered order" }), _jsx(Li, { children: "Support ticket replies" })] }), _jsxs(Text, { className: GC.textMuted, children: ["Manage notification preferences at ", _jsx(Span, { weight: "bold", children: "My Account \u2192 Settings \u2192 Notifications" }), "."] })] })),
     },
     {
         Icon: Heart, iconCls: "w-5 h-5 text-rose-500", title: "Wishlist",
@@ -39,7 +40,6 @@ const SECTIONS = [
         content: (_jsxs(Div, { layout: "grid", gap: "6", textSize: "sm", className: "sm:grid-cols-2", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[var(--appkit-color-text)] mb-2", weight: "semibold", children: "Report a seller (scam, fake item, harassment)" }), _jsx(Text, { className: `${GC.textMuted} mb-2`, children: "Use the Scam Registry report form. Our Trust & Safety team reviews within 48 hours." }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.SCAMS), size: "sm", weight: "medium", className: "text-[var(--appkit-color-primary)] underline hover:no-underline", children: "Go to Scam Registry \u2192" })] }), _jsxs(Div, { children: [_jsx(Text, { className: "text-[var(--appkit-color-text)] mb-2", weight: "semibold", children: "Open a support ticket (order dispute, billing, account)" }), _jsx(Text, { className: `${GC.textMuted} mb-2`, children: "Go to My Account \u2192 Support Tickets. Choose the right category for a faster response." }), _jsx(TextLink, { href: String(ROUTES.USER.SUPPORT), size: "sm", weight: "medium", className: "text-[var(--appkit-color-primary)] underline hover:no-underline", children: "Open Support Ticket \u2192" })] })] })),
     },
 ];
-// ─── 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" }), _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)))] }));
+export function BuyerAccountGuideView({ pageRegionCards = [] } = {}) {
+    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))), _jsx(AdminComposableRegion, { pageId: "help-account", initialCards: pageRegionCards })] }));
 }

package/dist/features/account/components/BuyerCollectorDropsGuideView.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface BuyerCollectorDropsGuideViewProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function BuyerCollectorDropsGuideView({ pageRegionCards }?: BuyerCollectorDropsGuideViewProps): React.JSX.Element;

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

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Gavel, TrendingUp, Trophy, AlertTriangle, Package, XCircle, ShieldCheck } from "lucide-react";
+import { Alert } from "../../../ui/components/Alert.js";
+import { Div } from "../../../ui/components/Div.js";
+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 { resolvePublishedValues } from "../../../_internal/shared/content/published-values.js";
+import { getBrandName } from "../../../core/brand-resolver.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.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 = [
+    {
+        Icon: Gavel, title: "How Collector Drops Work",
+        content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Reserve price" }), " \u2014 the minimum amount the seller will accept. If bidding ends below the reserve, no sale occurs. You'll see \"Reserve not met\" on the listing."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Bid increment" }), " \u2014 each new bid must exceed the current highest bid by at least the set increment. The increment is shown on the listing."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Collector Drop end time" }), " \u2014 displayed in your local timezone. Countdown timer shows hours and minutes remaining."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Auto-extend" }), " \u2014 if a bid is placed within the last 5 minutes of a collector drop, the end time extends by 5 minutes. This prevents last-second sniping and gives all bidders a fair chance."] })] })),
+    },
+    {
+        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. ", 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 a Collector Drop",
+        content: (_jsxs(_Fragment, { children: [_jsx(Text, { className: `${GC.textMuted} mb-3`, children: "When an collectorDrop ends and you're the highest bidder (above the reserve), you've won." }), _jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Payment window" }), " \u2014 you have ", _jsx(Span, { weight: "bold", children: "48 hours" }), " from the collector drop end time to complete payment."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "No payment" }), " \u2014 the order auto-cancels after 48 hours, you may receive a bid restriction, and the item may be offered to the next highest bidder."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Winner badge" }), " \u2014 your winning order gets an \"CollectorDrop Winner\" badge in My Orders."] })] })] })),
+    },
+    {
+        Icon: AlertTriangle, iconCls: "w-5 h-5 text-amber-500", title: "Bid Retraction Policy",
+        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",
+        content: (_jsxs(_Fragment, { children: [_jsx(Text, { className: `${GC.textMuted} mb-3`, children: "A pre-order is an item not yet in stock. The seller takes deposits or full payment upfront and orders from their supplier in bulk once demand is confirmed." }), _jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Deposit vs full price" }), " \u2014 check the listing. Some sellers take a partial deposit; others require full payment."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Expected delivery date" }), " \u2014 shown on the listing. This is the seller's estimate based on supplier timelines \u2014 not a guaranteed date."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "\"Confirmed supplier\" status" }), " \u2014 some listings show this badge, meaning the seller has placed the order with their supplier and stock is secured."] })] })] })),
+    },
+    {
+        Icon: XCircle, iconCls: "w-5 h-5 text-rose-500", title: "Pre-order Cancellations",
+        content: (_jsxs(_Fragment, { children: [_jsxs(Text, { className: `${GC.textMuted} mb-3`, children: ["To cancel a pre-order before the item is shipped, open a support ticket with category ", _jsx(Span, { weight: "bold", children: "Billing & Payment" }), " or ", _jsx(Span, { weight: "bold", children: "Order Issue" }), " and reference your order ID."] }), _jsxs(Text, { className: GC.textMuted, children: ["After cancellation is accepted, refunds follow the standard timeline:", " ", REFUND_DAYS_MIN, "\u2013", REFUND_DAYS_MAX, " business days to your original payment method."] })] })),
+    },
+    {
+        Icon: ShieldCheck, iconCls: "w-5 h-5 text-emerald-500", title: "Bidding Safety Tips",
+        content: (_jsx(Alert, { variant: "info", children: _jsxs(Ul, { spacing: "tight", size: "sm", children: [_jsx(Li, { children: "\u2713 Check the seller's rating and number of completed orders before bidding." }), _jsx(Li, { children: "\u2713 Read every product photo carefully \u2014 look for condition issues, especially on graded card slabs." }), _jsx(Li, { children: "\u2713 If authenticity is unclear, contact support before placing a bid \u2014 not after." }), _jsx(Li, { children: "\u2713 Set a max bid and stick to it. Bid heat is real \u2014 don't let excitement push you past your budget." })] }) })),
+    },
+];
+export function BuyerCollectorDropsGuideView({ pageRegionCards = [] } = {}) {
+    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: "CollectorDrops & 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))), _jsx(AdminComposableRegion, { pageId: "help-collector-drops", initialCards: pageRegionCards })] }));
+}

package/dist/features/account/components/BuyerOrdersGuideView.d.ts

@@ -1,2 +1,7 @@
 import React from "react";
-export declare function BuyerOrdersGuideView(): React.JSX.Element;
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface BuyerOrdersGuideViewProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function BuyerOrdersGuideView({ pageRegionCards }?: BuyerOrdersGuideViewProps): React.JSX.Element;

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

@@ -7,6 +7,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 { getBrandName } from "../../../core/brand-resolver.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 // ─── Section data ─────────────────────────────────────────────────────────────
 const ORDER_STATUSES = [
     { status: "PENDING", desc: "Payment received. Seller has been notified. You can cancel at this stage." },
@@ -47,7 +48,6 @@ const SECTIONS = [
         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" }), _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)))] }));
+export function BuyerOrdersGuideView({ pageRegionCards = [] } = {}) {
+    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))), _jsx(AdminComposableRegion, { pageId: "help-orders", initialCards: pageRegionCards })] }));
 }

package/dist/features/account/components/BuyerShoppingGuideView.d.ts

@@ -1,2 +1,7 @@
 import React from "react";
-export declare function BuyerShoppingGuideView(): React.JSX.Element;
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface BuyerShoppingGuideViewProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function BuyerShoppingGuideView({ pageRegionCards }?: BuyerShoppingGuideViewProps): React.JSX.Element;

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

@@ -7,10 +7,11 @@ 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";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const SECTIONS = [
     {
         Icon: ShoppingBag, title: "Browsing & Search",
-        content: (_jsxs(_Fragment, { children: [_jsx(Text, { className: `${GC.textMuted} mb-3`, children: "Use the search bar at the top of any page to find items by keyword \u2014 e.g. \"Charizard Base Set\", \"Hot Wheels Redline\", or \"Beyblade Burst\". Combine keywords for best results." }), _jsx(Text, { className: "text-[var(--appkit-color-text)] mb-2", size: "sm", weight: "semibold", children: "Available filters:" }), _jsxs(Ul, { className: GC.listDiscMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Category" }), " \u2014 Trading Cards, Action Figures, Diecast, Spinning Tops, Model Kits, Vintage & Rare"] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Brand" }), " \u2014 Pok\u00E9mon Company, Bandai, Hot Wheels, Hasbro, Funko, and more"] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Price range" }), " \u2014 set a minimum and maximum in rupees"] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Condition" }), " \u2014 grades 1\u201310 (10 = Gem Mint, 1 = Poor)"] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Listing type" }), " \u2014 Standard / Auction / Pre-order"] })] }), _jsx(Text, { className: `${GC.textMuted} mt-3`, children: "Sort options: Relevance, Price (Low to High), Price (High to Low), Newest First. On mobile, tap the Filter icon to open the filter drawer." })] })),
+        content: (_jsxs(_Fragment, { children: [_jsx(Text, { className: `${GC.textMuted} mb-3`, children: "Use the search bar at the top of any page to find items by keyword \u2014 e.g. \"Charizard Base Set\", \"Hot Wheels Redline\", or \"Beyblade Burst\". Combine keywords for best results." }), _jsx(Text, { className: "text-[var(--appkit-color-text)] mb-2", size: "sm", weight: "semibold", children: "Available filters:" }), _jsxs(Ul, { className: GC.listDiscMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Category" }), " \u2014 Trading Cards, Action Figures, Diecast, Spinning Tops, Model Kits, Vintage & Rare"] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Brand" }), " \u2014 Pok\u00E9mon Company, Bandai, Hot Wheels, Hasbro, Funko, and more"] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Price range" }), " \u2014 set a minimum and maximum in rupees"] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Condition" }), " \u2014 grades 1\u201310 (10 = Gem Mint, 1 = Poor)"] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Listing type" }), " \u2014 Standard / Collector Drop / Pre-order"] })] }), _jsx(Text, { className: `${GC.textMuted} mt-3`, children: "Sort options: Relevance, Price (Low to High), Price (High to Low), Newest First. On mobile, tap the Filter icon to open the filter drawer." })] })),
     },
     {
         Icon: ShoppingBag, title: "Reading a Product Page",
@@ -18,7 +19,7 @@ const SECTIONS = [
     },
     {
         Icon: ShoppingCart, title: "Cart",
-        content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Adding items" }), " \u2014 click \"Add to Cart\" on any standard product or pre-order. Auctions have a \"Place Bid\" flow instead."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Guest cart" }), " \u2014 saved in your browser (localStorage); cleared after 30 days of inactivity."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Logged-in cart" }), " \u2014 synced to your account via Firestore; persists across all your devices."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Item limit" }), " \u2014 up to 20 items per cart. Remove items before adding more."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Updating" }), " \u2014 use the quantity selector or click the trash icon to remove. Changes sync instantly."] })] })),
+        content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Adding items" }), " \u2014 click \"Add to Cart\" on any standard product or pre-order. CollectorDrops have a \"Place Bid\" flow instead."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Guest cart" }), " \u2014 saved in your browser (localStorage); cleared after 30 days of inactivity."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Logged-in cart" }), " \u2014 synced to your account via Firestore; persists across all your devices."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Item limit" }), " \u2014 up to 20 items per cart. Remove items before adding more."] }), _jsxs(Li, { children: [_jsx(Span, { weight: "bold", className: GC.textStrong, children: "Updating" }), " \u2014 use the quantity selector or click the trash icon to remove. Changes sync instantly."] })] })),
     },
     {
         Icon: CreditCard, title: "Checkout",
@@ -37,7 +38,6 @@ const SECTIONS = [
         content: (_jsxs(Alert, { variant: "info", title: "Browsing as a guest?", children: ["You can browse listings and add items to your cart as a guest. However, to ", _jsx(Span, { weight: "bold", children: "complete checkout" }), ", save your wishlist, or contact support you must be signed in. Creating an account takes under 30 seconds \u2014 just an email and a password."] })),
     },
 ];
-// ─── 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" }), _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)))] }));
+export function BuyerShoppingGuideView({ pageRegionCards = [] } = {}) {
+    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))), _jsx(AdminComposableRegion, { pageId: "help-shopping", initialCards: pageRegionCards })] }));
 }

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

@@ -30,7 +30,7 @@ const DEFAULT_ICONS = {
     bid_outbid: "⚡",
     bid_won: "🏆",
     bid_lost: "😔",
-    auction_ended: "🔚",
+    collector_drop_ended: "🔚",
     review_approved: "⭐",
     review_replied: "💬",
     product_available: "🔔",

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

@@ -16,7 +16,7 @@ const __O = {
 // ─── type-row config ────────────────────────────────────────────────────────
 const TYPE_ROWS = [
     { key: "orderUpdates", label: "Order updates", description: "Placed, shipped, delivered, cancelled, refunded" },
-    { key: "bids", label: "Auction bids", description: "Outbid alerts and auction win/loss" },
+    { key: "bids", label: "Collector Drop bids", description: "Outbid alerts and collector drop win/loss" },
     { key: "offers", label: "Offers", description: "New offers received, counter-offers, responses" },
     { key: "reviews", label: "Reviews", description: "Review approved, seller reply" },
     { key: "messages", label: "Messages", description: "New buyer-seller chat messages" },

package/dist/features/account/components/OrderDetailView.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import type { StackedViewShellProps } from "../../../ui/components/StackedViewShell";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface OrderDetailViewLabels {
     title?: string;
     backLabel?: string;
@@ -14,5 +15,7 @@ export interface OrderDetailViewProps extends Omit<StackedViewShellProps, "secti
     renderActions?: () => React.ReactNode;
     isLoading?: boolean;
     isNotFound?: boolean;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function OrderDetailView({ labels, renderBack, renderHeader, renderItems, renderAddress, renderPayment, renderActions, ...rest }: OrderDetailViewProps): React.JSX.Element;
+export declare function OrderDetailView({ labels, renderBack, renderHeader, renderItems, renderAddress, renderPayment, renderActions, pageRegionCards, ...rest }: OrderDetailViewProps): React.JSX.Element;

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

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { StackedViewShell } from "../../../ui/components/StackedViewShell.js";
-export function OrderDetailView({ labels = {}, renderBack, renderHeader, renderItems, renderAddress, renderPayment, renderActions, ...rest }) {
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
+export function OrderDetailView({ labels = {}, renderBack, renderHeader, renderItems, renderAddress, renderPayment, renderActions, pageRegionCards = [], ...rest }) {
     return (_jsx(StackedViewShell, { portal: "user", ...rest, title: labels.title, sections: [
             renderBack?.(),
             renderHeader?.(),
@@ -8,5 +9,6 @@ export function OrderDetailView({ labels = {}, renderBack, renderHeader, renderI
             renderItems?.(),
             renderAddress?.(),
             renderPayment?.(),
+            _jsx(AdminComposableRegion, { pageId: "user-orders-id", initialCards: pageRegionCards }, "page-region"),
         ] }));
 }