@mohasinac/appkit 4.70.0 → 4.71.2

package/dist/features/admin/components/AdminBrandsView.d.ts

@@ -1,4 +1,8 @@
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui/components/ListingLayout";
-export type AdminBrandsViewProps = ListingLayoutProps;
-export declare function AdminBrandsView({ children, ...props }: AdminBrandsViewProps): React.JSX.Element;
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface AdminBrandsViewProps extends ListingLayoutProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function AdminBrandsView({ children, pageRegionCards, ...props }: AdminBrandsViewProps): React.JSX.Element;

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

@@ -12,6 +12,7 @@ import { DataListingView } from "./DataListingView.js";
 import { AdminBrandEditorView } from "./AdminBrandEditorView.js";
 import { ADMIN_BULK_ACTIONS, ROW_ACTION_META } from "../../products/constants/action-defs.js";
 import { Span } from "../../../ui/components/Typography.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const COLUMNS = [
     {
         key: "primary",
@@ -98,13 +99,16 @@ const ADMIN_BRANDS_CONFIG = {
             { id: "true", label: "Active" },
             { id: "false", label: "Inactive" },
         ], value: pendingFilters.isActive || "", onChange: (v) => setPendingFilters((p) => ({ ...p, isActive: v })) })),
-    renderEditor: ({ editId, closePanel }) => (_jsx(AdminBrandEditorView, { brandId: editId ?? undefined, onSaved: closePanel, onDeleted: closePanel, embedded: true })),
+    renderEditor: ({ editId, closePanel }) => (_jsx(AdminBrandEditorView, { brandId: editId ?? undefined, onSaved: closePanel, onDeleted: closePanel, embedded: true, pageId: editId ? "admin-brands-id-edit" : "admin-brands-new" })),
     resolveEditorTitle: ({ isCreate }) => (isCreate ? "Add Brand" : "Edit Brand"),
 };
-export function AdminBrandsView({ children, ...props }) {
+export function AdminBrandsView({ children, pageRegionCards = [], ...props }) {
     // Backward-compat passthrough — some page shims wrap with custom children.
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
-    return _jsx(DataListingView, { config: ADMIN_BRANDS_CONFIG });
+    return (_jsx(DataListingView, { config: {
+            ...ADMIN_BRANDS_CONFIG,
+            renderAboveContent: () => _jsx(AdminComposableRegion, { pageId: "admin-brands", initialCards: pageRegionCards }),
+        } }));
 }

package/dist/features/admin/components/AdminBundleEditorView.d.ts

@@ -19,9 +19,18 @@
  */
 import React from "react";
 import type { StackedViewShellProps } from "../../../ui/components/StackedViewShell";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface AdminBundleEditorViewProps extends Omit<StackedViewShellProps, "sections"> {
     /** When set, the form loads an existing bundle; otherwise it runs as "new". */
     bundleId?: string;
+    /**
+     * Page-region id for this screen (Phase 12) — required because this View
+     * is mounted from FOUR distinct routes across two portals (admin new/edit,
+     * store new/edit), each with its own id.
+     */
+    pageId: string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
     /** Called after a successful create with the new bundle id. */
     onSaved?: (id: string) => void;
     /** Called after a successful delete. */
@@ -36,4 +45,4 @@ export interface AdminBundleEditorViewProps extends Omit<StackedViewShellProps,
     /** Render bare, for a drawer that supplies its own chrome. */
     embedded?: boolean;
 }
-export declare function AdminBundleEditorView({ bundleId, onSaved, onDeleted, scope, embedded, ...rest }: AdminBundleEditorViewProps): React.JSX.Element;
+export declare function AdminBundleEditorView({ bundleId, pageId, pageRegionCards, onSaved, onDeleted, scope, embedded, ...rest }: AdminBundleEditorViewProps): React.JSX.Element;

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

@@ -37,6 +37,7 @@ import { ProductInlineSelect } from "../../seller/components/ProductInlineSelect
 import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy.js";
 import { BUNDLE_KIND_SPECIAL } from "../../../_internal/shared/features/categories/bundle-config.js";
 import { bundleFormSchema, BUNDLE_RULE_TYPE_OPTIONS, } from "../../categories/schemas/bundle-form.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const __P = {
     p4: "p-[var(--appkit-space-4)]",
 };
@@ -82,7 +83,7 @@ function bundleToForm(bundle) {
         isActive: bundle.isActive !== false,
     };
 }
-export function AdminBundleEditorView({ bundleId, onSaved, onDeleted, scope = "admin", embedded, ...rest }) {
+export function AdminBundleEditorView({ bundleId, pageId, pageRegionCards = [], onSaved, onDeleted, scope = "admin", embedded, ...rest }) {
     const isEdit = Boolean(bundleId);
     const endpoints = React.useMemo(() => scope === "admin"
         ? { collection: ADMIN_ENDPOINTS.BUNDLES, byId: ADMIN_ENDPOINTS.BUNDLE_BY_ID }
@@ -247,5 +248,8 @@ export function AdminBundleEditorView({ bundleId, onSaved, onDeleted, scope = "a
     }
     return (_jsx(StackedViewShell, { portal: scope === "store" ? "seller" : "admin", ...rest, title: isEdit
             ? BUNDLE_COPY.adminEditorTitleEdit
-            : BUNDLE_COPY.adminEditorTitleNew, sections: [formSection] }));
+            : BUNDLE_COPY.adminEditorTitleNew, sections: [
+            _jsx(AdminComposableRegion, { pageId: pageId, initialCards: pageRegionCards }, "page-region"),
+            formSection,
+        ] }));
 }

package/dist/features/admin/components/AdminBundlesView.d.ts

@@ -1,7 +1,10 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface AdminBundlesViewProps {
     /** Plain string with an `{id}` placeholder — safe to build in a Server Component page.tsx. */
     editHrefTemplate: string;
     newHref: string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function AdminBundlesView({ editHrefTemplate, newHref }: AdminBundlesViewProps): React.JSX.Element;
+export declare function AdminBundlesView({ editHrefTemplate, newHref, pageRegionCards }: AdminBundlesViewProps): React.JSX.Element;

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

@@ -7,7 +7,8 @@ import { useState, useCallback } from "react";
 import { Badge } from "../../../ui/components/Badge.js";
 import { Button } from "../../../ui/components/Button.js";
 import { FilterChipGroup } from "../../../ui/components/FilterChipGroup.js";
-import { Stack } from "../../../ui/components/Layout.js";
+import { Stack, Row } from "../../../ui/components/Layout.js";
+import { useRecentlyVisited } from "../../dashboard/hooks/useRecentlyVisited.js";
 import { Text } from "../../../ui/components/Typography.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
 import { useToast } from "../../../ui/components/toast-context.js";
@@ -17,10 +18,12 @@ 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";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 function formatPrice(value) {
     if (typeof value !== "number" || value <= 0)
         return "—";
-    return `₹${value.toLocaleString("en-IN")}`;
+    return formatMoney(value);
 }
 const COLUMNS = [
     {
@@ -46,9 +49,13 @@ const COLUMNS = [
     },
     { key: "updatedAt", header: "Updated", className: "w-28" },
 ];
-export function AdminBundlesView({ editHrefTemplate, newHref }) {
+export function AdminBundlesView({ editHrefTemplate, newHref, pageRegionCards = [] }) {
     const [rebuildingId, setRebuildingId] = useState(null);
     const toast = useToast();
+    // Phase 10 ("widget descriptors") — BUNDLE is one of the 5 real
+    // AdminRowResource values; see recent-entry.ts's doc comment for why most
+    // admin resources are NOT eligible (renderEditor/onRowClick, no real URL).
+    const { recordVisit } = useRecentlyVisited("admin:hub");
     const handleRebuild = useCallback(async (bundleId) => {
         setRebuildingId(bundleId);
         try {
@@ -110,6 +117,7 @@ export function AdminBundlesView({ editHrefTemplate, newHref }) {
             return parts.join(",") || undefined;
         },
         rowHrefTemplate: editHrefTemplate,
+        renderAboveContent: () => _jsx(AdminComposableRegion, { pageId: "admin-bundles", initialCards: pageRegionCards }),
         toolbarExtra: (_jsx(Button, { asChild: true, size: "sm", variant: "primary", children: _jsxs(TextLink, { href: newHref, layout: "flex", align: "center", gap: "xs", children: ["+ ", BUNDLE_COPY.adminList.newButton] }) })),
         // Rule #7: bulk-action array sourced from the ADMIN_BULK_ACTIONS preset.
         buildBulkActions: (selection) => {
@@ -142,7 +150,7 @@ export function AdminBundlesView({ editHrefTemplate, newHref }) {
                 onClick: handlers[id],
             }));
         },
-        renderRowActions: (row) => (_jsx(Button, { variant: "ghost", size: "sm", isLoading: rebuildingId === row.id, disabled: rebuildingId === row.id, onClick: () => void handleRebuild(row.id), children: ACTIONS.ADMIN["rebuild-bundle"].label })),
+        renderRowActions: (row) => (_jsxs(Row, { gap: "xs", children: [_jsx(Button, { variant: "ghost", size: "sm", isLoading: rebuildingId === row.id, disabled: rebuildingId === row.id, onClick: () => void handleRebuild(row.id), children: ACTIONS.ADMIN["rebuild-bundle"].label }), _jsx(Button, { action: ACTIONS.BUNDLE["pin-to-dashboard"], variant: "ghost", size: "sm", onClick: () => recordVisit({ kind: "adminRow", resource: "BUNDLE", rowId: row.id, label: row.primary }) })] })),
         renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(_Fragment, { children: [_jsx(FilterChipGroup, { label: "Status", tabs: [
                         { id: "All", label: "All" },
                         { id: "true", label: "Active" },

package/dist/features/admin/components/AdminCartsView.d.ts

@@ -1,4 +1,8 @@
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui/components/ListingLayout";
-export type AdminCartsViewProps = ListingLayoutProps;
-export declare function AdminCartsView({ children, ...props }: AdminCartsViewProps): React.JSX.Element;
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface AdminCartsViewProps extends ListingLayoutProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function AdminCartsView({ children, pageRegionCards, ...props }: AdminCartsViewProps): React.JSX.Element;

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

@@ -10,6 +10,7 @@ import { formatCurrency } from "../../../utils/number.formatter.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData.js";
 import { DataListingView } from "./DataListingView.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /**
  * The cart's `items[]` is already in the list response — mapRows only ever
  * read `.length` for the row subtitle and discarded the rest, leaving no way
@@ -74,14 +75,18 @@ const ADMIN_CARTS_CONFIG = {
             { id: "guest", label: "Guest only" },
         ], value: pendingFilters.ownership ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, ownership: id })), allId: "" })),
 };
-export function AdminCartsView({ children, ...props }) {
+export function AdminCartsView({ children, pageRegionCards = [], ...props }) {
     const [selected, setSelected] = useState(null);
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
     const raw = selected?._raw ?? {};
     const isGuest = !raw.userId;
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: { ...ADMIN_CARTS_CONFIG, onRowClick: (row) => setSelected(row) } }), _jsx(RecordDetailModal, { isOpen: Boolean(selected), onClose: () => setSelected(null), title: "Cart Details", badges: [{ label: isGuest ? "Guest" : "Authenticated", variant: isGuest ? "default" : "info" }], fields: [
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: {
+                    ...ADMIN_CARTS_CONFIG,
+                    onRowClick: (row) => setSelected(row),
+                    renderAboveContent: () => _jsx(AdminComposableRegion, { pageId: "admin-carts", initialCards: pageRegionCards }),
+                } }), _jsx(RecordDetailModal, { isOpen: Boolean(selected), onClose: () => setSelected(null), title: "Cart Details", badges: [{ label: isGuest ? "Guest" : "Authenticated", variant: isGuest ? "default" : "info" }], fields: [
                     { label: isGuest ? "Session" : "User", value: String(raw.sessionId ?? raw.userId ?? "—") },
                     { label: "Last updated", value: selected?.updatedAt ?? "—" },
                     { label: "Cart ID", value: selected?.id ?? "—" },

package/dist/features/admin/components/AdminCatalogGuideView.d.ts

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

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

@@ -6,12 +6,14 @@ 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";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.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." })] }), [
+export function AdminCatalogGuideView({ 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(Package, { className: GC.iconPrimary }) }), _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."] })] }), _jsx(AdminComposableRegion, { pageId: "admin-guide-catalog", initialCards: pageRegionCards }), [
                 {
                     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."] })] })),
+                    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: "collector drop" }), " (prefix ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "collectordrop-" }), "), ", _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: "isCollectorDrop" }), "/", _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."] })] })),
                 },
                 {
                     Icon: FolderTree, title: "Category Taxonomy",

package/dist/features/admin/components/AdminCategoriesView.d.ts

@@ -1,4 +1,8 @@
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui/components/ListingLayout";
-export type AdminCategoriesViewProps = ListingLayoutProps;
-export declare function AdminCategoriesView({ children, ...props }: AdminCategoriesViewProps): React.JSX.Element;
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface AdminCategoriesViewProps extends ListingLayoutProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function AdminCategoriesView({ children, pageRegionCards, ...props }: AdminCategoriesViewProps): React.JSX.Element;

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

@@ -11,6 +11,7 @@ import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdmin
 import { DataListingView } from "./DataListingView.js";
 import { AdminCategoryEditorView } from "./AdminCategoryEditorView.js";
 import { ADMIN_BULK_ACTIONS, ROW_ACTION_META } from "../../products/constants/action-defs.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /** Rows, whichever of the three shapes the endpoint returns. */
 function extractCategoryRows(response) {
     if (Array.isArray(response))
@@ -147,12 +148,15 @@ const ADMIN_CATEGORIES_CONFIG = {
                     { id: "All", label: "All" },
                     { id: "true", label: "Featured only" },
                 ], value: pendingFilters.isFeatured || "", onChange: (v) => setPendingFilters((p) => ({ ...p, isFeatured: v })) })] })),
-    renderEditor: ({ editId, closePanel }) => (_jsx(AdminCategoryEditorView, { categoryId: editId ?? undefined, onSaved: closePanel, onDeleted: closePanel, embedded: true })),
+    renderEditor: ({ editId, closePanel }) => (_jsx(AdminCategoryEditorView, { categoryId: editId ?? undefined, pageId: editId ? "admin-categories-id-edit" : "admin-categories-new", onSaved: closePanel, onDeleted: closePanel, embedded: true })),
     resolveEditorTitle: ({ isCreate }) => (isCreate ? "Add Category" : "Edit Category"),
 };
-export function AdminCategoriesView({ children, ...props }) {
+export function AdminCategoriesView({ children, pageRegionCards = [], ...props }) {
     if (React.Children.count(children) > 0) {
         return (_jsxs(ListingLayout, { portal: "admin", ...props, children: [_jsx(Heading, { level: 1, className: "sr-only", children: "Categories" }), children] }));
     }
-    return _jsx(DataListingView, { config: ADMIN_CATEGORIES_CONFIG });
+    return (_jsx(DataListingView, { config: {
+            ...ADMIN_CATEGORIES_CONFIG,
+            renderAboveContent: () => _jsx(AdminComposableRegion, { pageId: "admin-categories", initialCards: pageRegionCards }),
+        } }));
 }

package/dist/features/admin/components/AdminCategoryEditorView.d.ts

@@ -1,9 +1,14 @@
 import React from "react";
 import type { StackedViewShellProps } from "../../../ui/components/StackedViewShell";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface AdminCategoryEditorViewProps extends Omit<StackedViewShellProps, "sections"> {
     categoryId?: string;
+    /** Page-region id for this screen (Phase 12) — required because this View is mounted from two different routes (new vs edit), each with its own id. */
+    pageId: string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
     onSaved?: (id: string) => void;
     onDeleted?: () => void;
     embedded?: boolean;
 }
-export declare function AdminCategoryEditorView({ categoryId, onSaved, onDeleted, embedded, ...rest }: AdminCategoryEditorViewProps): React.JSX.Element;
+export declare function AdminCategoryEditorView({ categoryId, pageId, pageRegionCards, onSaved, onDeleted, embedded, ...rest }: AdminCategoryEditorViewProps): React.JSX.Element;

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

@@ -14,6 +14,7 @@ import { ImageUpload } from "../../media/upload/ImageUpload.js";
 import { Repeater } from "../../../ui/components/Repeater.js";
 import { FieldInput, FormErrorSummary, FormShellContext, useFormShellState } from "../../../ui/forms/index.js";
 import { SectionForm, useSectionFormNav } from "../../shell/SectionForm.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /*
  * ── Content & Templates (C2c) ────────────────────────────────────────────────
  *
@@ -138,13 +139,13 @@ const categoryFormSchema = z.object({
         .or(z.literal("")),
     highlightsText: z.string().optional().or(z.literal("")),
     /*
-     * The Hasbro / international-market name for a generation wave, rendered on
+     * The alternate regional / international-market name for a release, rendered on
      * the category page as "Also known as". Editable here because wave naming is
      * editorial and gets corrected — the seed deliberately leaves it unset
      * wherever a divergence is not evidenced, and this is how one gets filled in
      * later without a reseed.
      */
-    hasbroName: z.string().max(120, "Keep the name under 120 characters").optional().or(z.literal("")),
+    altRegionName: z.string().max(120, "Keep the name under 120 characters").optional().or(z.literal("")),
     taxCodeId: z.string().optional().or(z.literal("")),
     defaultCondition: z.string().optional().or(z.literal("")),
     defaultAuthenticity: z.string().optional().or(z.literal("")),
@@ -182,7 +183,7 @@ const EMPTY_VALUES = {
     coverImage: "",
     contentBody: "",
     highlightsText: "",
-    hasbroName: "",
+    altRegionName: "",
     taxCodeId: "",
     defaultCondition: "",
     defaultAuthenticity: "",
@@ -289,7 +290,7 @@ function buildContentPayload(v, faqs, specs, templates, carriedPriceGuidance) {
          * to mean "do not write it", not "write an empty string every reader then
          * has to treat as absent".
          */
-        ...(String(v.hasbroName ?? "").trim() ? { hasbroName: String(v.hasbroName).trim() } : {}),
+        ...(String(v.altRegionName ?? "").trim() ? { altRegionName: String(v.altRegionName).trim() } : {}),
         descriptionTemplates: templates
             .filter((t) => t.label.trim() !== "" && t.body.trim() !== "")
             .map((t) => ({ ...t, id: t.id || toCategorySlug(t.label) || "template" })),
@@ -303,7 +304,7 @@ function toCategorySlug(str) {
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-+|-+$/g, "");
 }
-export function AdminCategoryEditorView({ categoryId, onSaved, onDeleted, embedded, ...rest }) {
+export function AdminCategoryEditorView({ categoryId, pageId, pageRegionCards = [], onSaved, onDeleted, embedded, ...rest }) {
     const isEdit = Boolean(categoryId);
     const [deleteOpen, setDeleteOpen] = React.useState(false);
     const { upload } = useMediaUpload();
@@ -367,7 +368,7 @@ export function AdminCategoryEditorView({ categoryId, onSaved, onDeleted, embedd
             coverImage: cat.display?.coverImage ?? "",
             contentBody: cat.contentBody ?? "",
             highlightsText: listToLines(cat.highlights),
-            hasbroName: cat.hasbroName ?? "",
+            altRegionName: cat.altRegionName ?? "",
             taxCodeId: cat.productDefaults?.taxCodeId ?? "",
             defaultCondition: cat.productDefaults?.defaultCondition ?? "",
             defaultAuthenticity: cat.productDefaults?.defaultAuthenticity ?? "",
@@ -503,8 +504,8 @@ export function AdminCategoryEditorView({ categoryId, onSaved, onDeleted, embedd
                 {
                     id: "content",
                     label: "Content & Templates",
-                    fields: ["contentBody", "highlightsText", "hasbroName"],
-                    render: ({ values: v, onChange, errors }) => (_jsxs(Stack, { gap: "md", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Textarea, { label: "Category page body", value: String(v.contentBody ?? ""), onChange: (e) => onChange({ contentBody: e.target.value }), rows: 8, placeholder: "400\u2013900 characters of keyword-rich HTML with links to sibling and parent categories\u2026" }), errors.contentBody ? (_jsx(Text, { size: "sm", variant: "error", role: "alert", children: errors.contentBody })) : (_jsx(Text, { size: "xs", color: "muted", children: "Rendered on the category page. Distinct from the short Description above, which also feeds the SEO meta and every card. 36 of worldhobbyshop's 46 categories carry one of these and it is their actual ranking mechanism; no Shopify competitor in the crawl has any." }))] }), _jsx(FieldInput, { name: "hasbroName", label: "Hasbro / international name", value: String(v.hasbroName ?? ""), onChange: (val) => onChange({ hasbroName: val }), placeholder: "e.g. Beyblade Burst Turbo", error: errors.hasbroName, hint: "Only when the Hasbro season name genuinely differs from the Takara-Tomy one \u2014 Cho-Z ships as Turbo, God as Evolution. Rendered on the category page as 'Also known as'. Leave blank if there is no divergence, or if you cannot confirm one: a guessed pairing reads as fact." }), _jsxs(Stack, { gap: "xs", children: [_jsx(Textarea, { label: "Highlights \u2014 one per line", value: String(v.highlightsText ?? ""), onChange: (e) => onChange({ highlightsText: e.target.value }), rows: 4, placeholder: "Genuine Takara Tomy stock\nChecked and photographed before listing" }), _jsx(Text, { size: "xs", color: "muted", children: "Short \"why shop this\" bullets, shown above the FAQs. Blank lines are dropped. Up to 12." })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "sm", weight: "medium", children: "Category FAQs" }), _jsx(Text, { size: "xs", color: "muted", children: "Rendered as an accordion on the category page and emitted as FAQPage structured data. Keep platform-wide answers in the global FAQ collection instead \u2014 two copies of one answer means the one that gets fixed is never the one being read." }), _jsx(Repeater, { rows: faqs, onChange: setFaqs, blank: () => ({ question: "", answer: "" }), addLabel: "Add an FAQ", max: 20, renderRow: (row, set) => (_jsxs(_Fragment, { children: [_jsx(Input, { label: "Question", value: row.question, onChange: (e) => set({ question: e.target.value }), placeholder: "Are these compatible with Burst launchers?" }), _jsx(Textarea, { value: row.answer, onChange: (e) => set({ answer: e.target.value }), rows: 3, placeholder: "Answer\u2026" })] })) })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "sm", weight: "medium", children: "Description templates" }), _jsxs(Text, { size: "xs", color: "muted", children: ["What the seller form offers when a listing is filed here. One per condition band \u2014 worldhobbyshop reuses exactly two across 1,195 listings. Slots like", " ", _jsx(Span, { family: "mono", children: "{{title}}" }), ",", " ", _jsx(Span, { family: "mono", children: "{{brand}}" }), ",", " ", _jsx(Span, { family: "mono", children: "{{condition}}" }), " and", " ", _jsx(Span, { family: "mono", children: "{{series}}" }), " are filled from the listing; an unresolved one becomes empty and is reported to the seller, never left as a literal brace pair."] }), _jsx(Repeater, { rows: templates, onChange: setTemplates, blank: () => ({ id: "", label: "", variant: "default", body: "" }), addLabel: "Add a template", max: 8, renderRow: (row, set) => (_jsxs(_Fragment, { children: [_jsxs(Div, { layout: "grid", gap: "4", className: "sm:grid-cols-2", children: [_jsx(Input, { label: "Label", value: row.label, onChange: (e) => set({ label: e.target.value }), placeholder: "Pre-owned \u2014 condition as pictured" }), _jsx(Select, { label: "Condition band", value: row.variant, onChange: (e) => set({ variant: e.target.value }), options: TEMPLATE_VARIANT_OPTIONS })] }), _jsx(Textarea, { value: row.body, onChange: (e) => set({ body: e.target.value }), rows: 6, placeholder: "Important things to know about {{title}} \u2014 HTML permitted\u2026" }), _jsx(Text, { size: "xs", color: "muted", children: usedPlaceholders(row.body).length > 0
+                    fields: ["contentBody", "highlightsText", "altRegionName"],
+                    render: ({ values: v, onChange, errors }) => (_jsxs(Stack, { gap: "md", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Textarea, { label: "Category page body", value: String(v.contentBody ?? ""), onChange: (e) => onChange({ contentBody: e.target.value }), rows: 8, placeholder: "400\u2013900 characters of keyword-rich HTML with links to sibling and parent categories\u2026" }), errors.contentBody ? (_jsx(Text, { size: "sm", variant: "error", role: "alert", children: errors.contentBody })) : (_jsx(Text, { size: "xs", color: "muted", children: "Rendered on the category page. Distinct from the short Description above, which also feeds the SEO meta and every card. 36 of worldhobbyshop's 46 categories carry one of these and it is their actual ranking mechanism; no Shopify competitor in the crawl has any." }))] }), _jsx(FieldInput, { name: "altRegionName", label: "Alternate regional name", value: String(v.altRegionName ?? ""), onChange: (val) => onChange({ altRegionName: val }), placeholder: "e.g. Beyblade Burst Turbo", error: errors.altRegionName, hint: "Only when this release genuinely ships under a different name in another region \u2014 e.g. Cho-Z sells as Turbo, God as Evolution. Rendered on the category page as 'Also known as'. Leave blank if there is no divergence, or if you cannot confirm one: a guessed pairing reads as fact." }), _jsxs(Stack, { gap: "xs", children: [_jsx(Textarea, { label: "Highlights \u2014 one per line", value: String(v.highlightsText ?? ""), onChange: (e) => onChange({ highlightsText: e.target.value }), rows: 4, placeholder: "Genuine Takara Tomy stock\nChecked and photographed before listing" }), _jsx(Text, { size: "xs", color: "muted", children: "Short \"why shop this\" bullets, shown above the FAQs. Blank lines are dropped. Up to 12." })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "sm", weight: "medium", children: "Category FAQs" }), _jsx(Text, { size: "xs", color: "muted", children: "Rendered as an accordion on the category page and emitted as FAQPage structured data. Keep platform-wide answers in the global FAQ collection instead \u2014 two copies of one answer means the one that gets fixed is never the one being read." }), _jsx(Repeater, { rows: faqs, onChange: setFaqs, blank: () => ({ question: "", answer: "" }), addLabel: "Add an FAQ", max: 20, renderRow: (row, set) => (_jsxs(_Fragment, { children: [_jsx(Input, { label: "Question", value: row.question, onChange: (e) => set({ question: e.target.value }), placeholder: "Are these compatible with Burst launchers?" }), _jsx(Textarea, { value: row.answer, onChange: (e) => set({ answer: e.target.value }), rows: 3, placeholder: "Answer\u2026" })] })) })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "sm", weight: "medium", children: "Description templates" }), _jsxs(Text, { size: "xs", color: "muted", children: ["What the seller form offers when a listing is filed here. One per condition band \u2014 worldhobbyshop reuses exactly two across 1,195 listings. Slots like", " ", _jsx(Span, { family: "mono", children: "{{title}}" }), ",", " ", _jsx(Span, { family: "mono", children: "{{brand}}" }), ",", " ", _jsx(Span, { family: "mono", children: "{{condition}}" }), " and", " ", _jsx(Span, { family: "mono", children: "{{series}}" }), " are filled from the listing; an unresolved one becomes empty and is reported to the seller, never left as a literal brace pair."] }), _jsx(Repeater, { rows: templates, onChange: setTemplates, blank: () => ({ id: "", label: "", variant: "default", body: "" }), addLabel: "Add a template", max: 8, renderRow: (row, set) => (_jsxs(_Fragment, { children: [_jsxs(Div, { layout: "grid", gap: "4", className: "sm:grid-cols-2", children: [_jsx(Input, { label: "Label", value: row.label, onChange: (e) => set({ label: e.target.value }), placeholder: "Pre-owned \u2014 condition as pictured" }), _jsx(Select, { label: "Condition band", value: row.variant, onChange: (e) => set({ variant: e.target.value }), options: TEMPLATE_VARIANT_OPTIONS })] }), _jsx(Textarea, { value: row.body, onChange: (e) => set({ body: e.target.value }), rows: 6, placeholder: "Important things to know about {{title}} \u2014 HTML permitted\u2026" }), _jsx(Text, { size: "xs", color: "muted", children: usedPlaceholders(row.body).length > 0
                                                         ? `Slots used: ${usedPlaceholders(row.body).map((p) => `{{${p}}}`).join(", ")}`
                                                         : "No slots used — this body will read identically on every listing." })] })) })] })] })),
                 },
@@ -546,5 +547,8 @@ export function AdminCategoryEditorView({ categoryId, onSaved, onDeleted, embedd
         return _jsx(Div, { className: `${__O.yAuto} ${__P.p4}`, children: formContent });
     }
     const twoPanel = (_jsxs(Div, { layout: "grid", gap: "6", lgAlign: "start", className: "lg:grid-cols-[1fr_280px]", children: [_jsx(CardBody, { className: "min-w-0 space-y-6 p-[var(--appkit-space-0)]", children: formContent }), _jsx(Show, { above: "lg", children: _jsx(StickyToolbar, { offset: "header", tone: "default", border: false, padding: "none", children: actionSidebar }) })] }));
-    return (_jsxs(_Fragment, { children: [_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit Category" : "Create Category", sections: [twoPanel] }), _jsx(ConfirmDeleteModal, { isOpen: deleteOpen, onClose: () => setDeleteOpen(false), onConfirm: () => deleteMutation.mutate(), isDeleting: deleteMutation.isPending, title: "Delete this category?", message: "Products in this category will become uncategorized. This action cannot be undone.", confirmText: "Delete category", variant: "danger" })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit Category" : "Create Category", sections: [
+                    _jsx(AdminComposableRegion, { pageId: pageId, initialCards: pageRegionCards }, "page-region"),
+                    twoPanel,
+                ] }), _jsx(ConfirmDeleteModal, { isOpen: deleteOpen, onClose: () => setDeleteOpen(false), onConfirm: () => deleteMutation.mutate(), isDeleting: deleteMutation.isPending, title: "Delete this category?", message: "Products in this category will become uncategorized. This action cannot be undone.", confirmText: "Delete category", variant: "danger" })] }));
 }

package/dist/features/admin/components/AdminClassifiedView.d.ts

@@ -9,5 +9,9 @@
  */
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui/components/ListingLayout";
-export type AdminClassifiedViewProps = ListingLayoutProps;
-export declare function AdminClassifiedView({ children, ...props }: AdminClassifiedViewProps): React.JSX.Element;
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export interface AdminClassifiedViewProps extends ListingLayoutProps {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+}
+export declare function AdminClassifiedView({ children, pageRegionCards, ...props }: AdminClassifiedViewProps): React.JSX.Element;

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

@@ -1,5 +1,5 @@
 "use client";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * AdminClassifiedView — admin browse of classified listings.
  *
@@ -14,18 +14,23 @@ import { ListingLayout } from "../../../ui/components/ListingLayout.js";
 import { buildListingTypeListingConfig } from "../../products/config/listing-type-listing-config.js";
 import { DataListingView } from "./DataListingView.js";
 import { useAvailabilityScope } from "../../products/hooks/useAvailabilityScope.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const LISTING_TYPES = ["classified"];
 const CONFIG_OPTS = {
     title: "Classified",
     searchPlaceholder: "Search classified by name or seller",
     emptyLabel: "No classified listings",
 };
-export function AdminClassifiedView({ children, ...props }) {
+export function AdminClassifiedView({ children, pageRegionCards = [], ...props }) {
     const scope = useAvailabilityScope(LISTING_TYPES);
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
     // Built per-render rather than at module scope: the availability scope
     // reads the URL through a hook, which cannot run outside a component.
-    return (_jsx(DataListingView, { config: buildListingTypeListingConfig("classified", { ...CONFIG_OPTS, scope }) }));
+    const config = buildListingTypeListingConfig("classified", { ...CONFIG_OPTS, scope });
+    return (_jsx(DataListingView, { config: {
+            ...config,
+            renderAboveContent: () => (_jsxs(_Fragment, { children: [config.renderAboveContent?.(), _jsx(AdminComposableRegion, { pageId: "admin-classified", initialCards: pageRegionCards })] })),
+        } }));
 }

package/dist/features/admin/components/AdminClearanceView.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import type { ListingLayoutProps } from "../../../ui/components/ListingLayout";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+export type AdminClearanceViewProps = ListingLayoutProps & {
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
+};
+export declare function AdminClearanceView({ children, pageRegionCards, ...props }: AdminClearanceViewProps): React.JSX.Element;