@mohasinac/appkit 4.71.0 → 4.71.2

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

@@ -1,17 +1,19 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useApiMutation } from "@mohasinac/appkit/client";
+import { useApiMutation, ALL_LISTING_TYPES, ALL_CATEGORY_TYPES, ALL_BROWSE_PAGES } from "@mohasinac/appkit/client";
 import React from "react";
 import { useQuery } from "@tanstack/react-query";
 import { z } from "zod";
 import { ConfirmDeleteModal } from "../../../ui/components/ConfirmDeleteModal.js";
 import { Div } from "../../../ui/components/Div.js";
 import { Input } from "../../../ui/components/Input.js";
+import { Repeater } from "../../../ui/components/Repeater.js";
 import { RichTextEditor } from "../../../ui/components/RichTextEditor.js";
 import { Select } from "../../../ui/components/Select.js";
 import { Stack } from "../../../ui/components/Layout.js";
 import { StackedViewShell } from "../../../ui/components/StackedViewShell.js";
 import { TagInput } from "../../../ui/components/TagInput.js";
+import { Textarea } from "../../../ui/components/Textarea.js";
 import { Text } from "../../../ui/components/Typography.js";
 import { Toggle } from "../../../ui/components/Toggle.js";
 import { useToast } from "../../../ui/components/toast-context.js";
@@ -21,6 +23,7 @@ import { apiClient } from "../../../http/index.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { FAQ_CATEGORY_LABELS } from "../../faq/schemas/firestore.js";
 import { getBrandName } from "../../../core/brand-resolver.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /**
  * Matches the draft this form actually holds, and the payload it actually
  * sends.
@@ -48,7 +51,60 @@ const faqFormSchema = z.object({
     isPinned: z.boolean().optional(),
     showOnHomepage: z.boolean().optional(),
     showInFooter: z.boolean().optional(),
+    // The form's own draft shape (`FragmentDraft`), not the wire shape sent to
+    // the API — `toWireFragment` converts at submit time. Unconstrained beyond
+    // its own shape: the real content boundary is the server's
+    // `answerFragmentsSchema` (`.text.min(1)` etc.), and a blank added-then-
+    // abandoned row here is dropped by `toWireFragment`, not rejected here.
+    answerFragments: z
+        .array(z.object({
+        governsKind: z.enum(["", "listingType", "categoryType", "browsePage"]),
+        governsValue: z.string(),
+        text: z.string(),
+        whenHidden: z.string(),
+    }))
+        .optional(),
 });
+function blankFragment() {
+    return { governsKind: "", governsValue: "", text: "", whenHidden: "" };
+}
+function fromWireFragment(f) {
+    return {
+        governsKind: f.governs?.governs ?? "",
+        governsValue: f.governs?.value ?? "",
+        text: f.text ?? "",
+        whenHidden: f.whenHidden ?? "",
+    };
+}
+/** Drops a row with no text — the Zod boundary requires `text.min(1)`, and a blank added-then-abandoned row is noise, not an intended empty fragment. */
+function toWireFragment(f) {
+    if (!f.text.trim())
+        return null;
+    return {
+        ...(f.governsKind ? { governs: { governs: f.governsKind, value: f.governsValue } } : {}),
+        text: f.text.trim(),
+        ...(f.whenHidden.trim() ? { whenHidden: f.whenHidden.trim() } : {}),
+    };
+}
+const GOVERNS_KIND_OPTIONS = [
+    { value: "", label: "— Always shown —" },
+    { value: "listingType", label: "Listing type" },
+    { value: "categoryType", label: "Category type" },
+    { value: "browsePage", label: "Browse page" },
+];
+function humanize(value) {
+    return value.charAt(0).toUpperCase() + value.slice(1).replace(/-/g, " ");
+}
+/** Dropdown source per `governsKind` — the real unions, never a hand-typed list (Root Cause #61). */
+function governsValueOptions(kind) {
+    if (kind === "listingType")
+        return ALL_LISTING_TYPES.map((t) => ({ value: t, label: humanize(t) }));
+    if (kind === "categoryType")
+        return ALL_CATEGORY_TYPES.map((t) => ({ value: t, label: humanize(t) }));
+    if (kind === "browsePage")
+        return ALL_BROWSE_PAGES.map((p) => ({ value: p, label: humanize(p) }));
+    return [];
+}
 const EMPTY_FAQ = {
     question: "",
     slug: "",
@@ -61,6 +117,7 @@ const EMPTY_FAQ = {
     isPinned: false,
     showOnHomepage: false,
     showInFooter: false,
+    answerFragments: [],
 };
 const __P = {
     p4: "p-[var(--appkit-space-4)]",
@@ -73,7 +130,7 @@ const __O = {
  * 🛑 DERIVED FROM THE REAL UNION. NEVER HAND-WRITE THIS LIST AGAIN.
  *
  * Until 2026-10-02 this was six hand-written options — shipping / returns /
- * payments / auctions / pre-orders / general — and FIVE of them were values no
+ * payments / collector drops / pre-orders / general — and FIVE of them were values no
  * reader in the product understands. `FAQCategory` is orders_payment |
  * shipping_delivery | returns_refunds | product_information | account_security |
  * technical_support | general | scam_awareness, so only `general` overlapped.
@@ -105,7 +162,7 @@ function toSlug(str) {
     return base.startsWith("faq-") ? base : `faq-${base}`;
 }
 // --- Component ---------------------------------------------------------------
-export function AdminFaqEditorView({ faqId, onSaved, onDeleted, embedded, ...rest }) {
+export function AdminFaqEditorView({ faqId, pageId, pageRegionCards = [], onSaved, onDeleted, embedded, ...rest }) {
     const isEdit = Boolean(faqId);
     const [values, setValues] = React.useState(EMPTY_FAQ);
     const [slugManual, setSlugManual] = React.useState(false);
@@ -145,6 +202,9 @@ export function AdminFaqEditorView({ faqId, onSaved, onDeleted, embedded, ...res
             isPinned: f.isPinned ?? false,
             showOnHomepage: f.showOnHomepage ?? false,
             showInFooter: f.showInFooter ?? false,
+            answerFragments: Array.isArray(f.answerFragments)
+                ? f.answerFragments.map(fromWireFragment)
+                : [],
         });
     }, [faqQuery.data]);
     // --- save ---
@@ -163,6 +223,9 @@ export function AdminFaqEditorView({ faqId, onSaved, onDeleted, embedded, ...res
                 isPinned: values.isPinned,
                 showOnHomepage: values.showOnHomepage,
                 showInFooter: values.showInFooter,
+                answerFragments: values.answerFragments
+                    .map(toWireFragment)
+                    .filter((f) => f !== null),
             };
             if (isEdit) {
                 return apiClient.put(ADMIN_ENDPOINTS.FAQ_BY_ID(faqId), payload);
@@ -200,6 +263,18 @@ export function AdminFaqEditorView({ faqId, onSaved, onDeleted, embedded, ...res
                             onChange({ slug: e.target.value });
                         }, placeholder: "faq-how-does-bidding-work", helperText: "Auto-generated from the question until you edit it. Must start with 'faq-'.", error: errors.slug }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "sm", weight: "medium", color: "muted", children: "Answer" }), _jsx(RichTextEditor, { ariaLabel: "Answer", value: String(v.answer ?? ""), onChange: (val) => onChange({ answer: val }), placeholder: "Write a clear, helpful answer...", minHeightClassName: "min-h-[200px]" }), errors.answer && (_jsx(Text, { size: "xs", color: "error", role: "alert", children: errors.answer }))] })] })),
         },
+        {
+            id: "fragments",
+            label: "Conditional phrasing",
+            fields: ["answerFragments"],
+            render: ({ values: v, onChange }) => {
+                const rows = Array.isArray(v.answerFragments) ? v.answerFragments : [];
+                return (_jsxs(Stack, { gap: "md", children: [_jsx(Text, { size: "sm", color: "muted", children: "Optional. Use this only when the answer MENTIONS something that can be switched off site-wide (a listing type, category type, or browse page) and omitting that clause would leave an abrupt gap \u2014 e.g. \u201CReserve upcoming drops via our pre-order system\u201D needs different wording when pre-orders are off, not just silence. Most FAQs need none of these; the rich-text answer above already covers ordinary content." }), _jsx(Repeater, { rows: rows, onChange: (next) => onChange({ answerFragments: next }), blank: blankFragment, addLabel: "Add fragment", max: 20, renderRow: (row, set) => (_jsxs(Stack, { gap: "xs", children: [_jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(Select, { label: "Governed by", options: GOVERNS_KIND_OPTIONS, value: row.governsKind, onValueChange: (val) => set({
+                                                    governsKind: val,
+                                                    governsValue: "",
+                                                }) }), row.governsKind ? (_jsx(Select, { label: "Value", options: governsValueOptions(row.governsKind), value: row.governsValue, onValueChange: (val) => set({ governsValue: val }) })) : null] }), _jsx(Textarea, { label: row.governsKind ? "Text (shown while enabled)" : "Text (always shown)", value: row.text, onChange: (e) => set({ text: e.target.value }), maxLength: 2000, showCharCount: true, rows: 2 }), row.governsKind ? (_jsx(Textarea, { label: "Replacement text when disabled (optional \u2014 leave blank to omit this clause instead)", value: row.whenHidden, onChange: (e) => set({ whenHidden: e.target.value }), maxLength: 2000, showCharCount: true, rows: 2 })) : null] })) })] }));
+            },
+        },
         {
             id: "classification",
             label: "Filing & ordering",
@@ -229,5 +304,8 @@ export function AdminFaqEditorView({ faqId, onSaved, onDeleted, embedded, ...res
     if (embedded) {
         return _jsx(Div, { className: `${__O.yAuto} ${__P.p4}`, children: formSection });
     }
-    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit FAQ" : "New FAQ", sections: [formSection] }));
+    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit FAQ" : "New FAQ", sections: [
+            _jsx(AdminComposableRegion, { pageId: pageId, initialCards: pageRegionCards }, "page-region"),
+            formSection,
+        ] }));
 }

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

@@ -1,8 +1,11 @@
 import React from "react";
 import type { ListingLayoutProps } from "../../../ui/components/ListingLayout";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface AdminFaqsViewProps extends ListingLayoutProps {
     actionHref?: string;
     onBulkArchive?: (ids: string[]) => Promise<void>;
     onBulkDelete?: (ids: string[]) => Promise<void>;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function AdminFaqsView({ children, onBulkArchive, onBulkDelete, ...props }: AdminFaqsViewProps): React.JSX.Element;
+export declare function AdminFaqsView({ children, onBulkArchive, onBulkDelete, pageRegionCards, ...props }: AdminFaqsViewProps): React.JSX.Element;

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

@@ -1,5 +1,5 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { SIEVE_OP, Stack, sieveFilter } from "@mohasinac/appkit/client";
 import { sortBy } from "@mohasinac/appkit/client";
 import React, { useMemo } from "react";
@@ -11,6 +11,7 @@ import { ADMIN_BULK_ACTIONS, ROW_ACTION_META, ROW_ACTION_ID } from "../../produc
 import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData.js";
 import { DataListingView } from "./DataListingView.js";
 import { AdminFaqEditorView } from "./AdminFaqEditorView.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const COLUMNS = [
     {
         key: "primary",
@@ -31,7 +32,7 @@ const COLUMNS = [
         render: (row) => (_jsx(Text, { size: "sm", color: "muted", children: row.updatedAt })),
     },
 ];
-export function AdminFaqsView({ children, onBulkArchive, onBulkDelete, ...props }) {
+export function AdminFaqsView({ children, onBulkArchive, onBulkDelete, pageRegionCards = [], ...props }) {
     const config = useMemo(() => ({
         portal: "admin",
         title: "FAQs",
@@ -97,11 +98,11 @@ export function AdminFaqsView({ children, onBulkArchive, onBulkDelete, ...props
                 { id: "true", label: "Published" },
                 { id: "false", label: "Draft" },
             ], value: pendingFilters.isActive || "", onChange: (v) => setPendingFilters((p) => ({ ...p, isActive: v })) })),
-        renderEditor: ({ editId, closePanel }) => (_jsx(AdminFaqEditorView, { faqId: editId ?? undefined, onSaved: closePanel, onDeleted: closePanel, embedded: true })),
+        renderEditor: ({ editId, closePanel }) => (_jsx(AdminFaqEditorView, { faqId: editId ?? undefined, pageId: editId ? "admin-faqs-id-edit" : "admin-faqs-new", onSaved: closePanel, onDeleted: closePanel, embedded: true })),
         resolveEditorTitle: ({ isCreate }) => (isCreate ? "Add FAQ" : "Edit FAQ"),
     }), [onBulkArchive, onBulkDelete]);
     if (React.Children.count(children) > 0) {
         return (_jsxs(ListingLayout, { portal: "admin", ...props, children: [_jsx(Heading, { level: 1, className: "sr-only", children: "FAQs" }), children] }));
     }
-    return _jsx(DataListingView, { config: config });
+    return (_jsxs(_Fragment, { children: [_jsx(AdminComposableRegion, { pageId: "admin-faqs", initialCards: pageRegionCards }), _jsx(DataListingView, { config: config })] }));
 }

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

@@ -1,12 +1,17 @@
 import React from "react";
 import type { StackedViewShellProps } from "../../../ui/components/StackedViewShell";
 import type { ProductFeatureScope } from "../../products/schemas/product-features";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface AdminFeatureEditorViewProps extends Omit<StackedViewShellProps, "sections"> {
     featureId?: string;
     /** Force a fixed scope (store editor uses scope=store + readonly storeId). */
     fixedScope?: ProductFeatureScope;
     /** Force a fixed storeId (store editor passes the seller's store). */
     fixedStoreId?: 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[];
     /** When true, omit StackedViewShell wrapper (SideDrawer body). */
     embedded?: boolean;
     /** Override the create/update endpoint set (used by store API path). */
@@ -17,4 +22,4 @@ export interface AdminFeatureEditorViewProps extends Omit<StackedViewShellProps,
     onSaved?: (id: string) => void;
     onDeleted?: () => void;
 }
-export declare function AdminFeatureEditorView({ featureId, fixedScope, fixedStoreId, embedded, endpointOverride, onSaved, onDeleted, ...rest }: AdminFeatureEditorViewProps): React.JSX.Element;
+export declare function AdminFeatureEditorView({ featureId, fixedScope, fixedStoreId, pageId, pageRegionCards, embedded, endpointOverride, onSaved, onDeleted, ...rest }: AdminFeatureEditorViewProps): React.JSX.Element;

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

@@ -18,6 +18,7 @@ import { buildSectionsFromSchema, visibleValues } from "../../shell/build-sectio
 import { SectionForm, useSectionFormNav } from "../../shell/SectionForm.js";
 import { productFeatureFormSchema } from "../../products/schemas/product-features.validators.js";
 import { PRODUCT_FEATURE_CATEGORY_OPTIONS, PRODUCT_FEATURE_DEFAULT_DISPLAY_ORDER, PRODUCT_FEATURE_ICON_COLOR_OPTIONS, PRODUCT_FEATURE_PRODUCT_TYPE_OPTIONS, PRODUCT_FEATURE_SCOPE_OPTIONS, } from "../../products/constants/product-features.constants.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const __P = {
     p4: "p-[var(--appkit-space-4)]",
 };
@@ -34,7 +35,7 @@ const TOAST = {
     UPDATED: "Feature updated.",
     DELETED: "Feature deleted.",
 };
-export function AdminFeatureEditorView({ featureId, fixedScope, fixedStoreId, embedded, endpointOverride, onSaved, onDeleted, ...rest }) {
+export function AdminFeatureEditorView({ featureId, fixedScope, fixedStoreId, pageId, pageRegionCards = [], embedded, endpointOverride, onSaved, onDeleted, ...rest }) {
     const isEdit = Boolean(featureId);
     const { showToast } = useToast();
     const [form, setForm] = React.useState({
@@ -216,5 +217,8 @@ export function AdminFeatureEditorView({ featureId, fixedScope, fixedStoreId, em
     if (embedded) {
         return _jsxs(Div, { className: `${__O.yAuto} ${__P.p4}`, children: [formSection, deleteModal] });
     }
-    return (_jsxs(_Fragment, { children: [_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit Feature" : "New Feature", sections: [formSection] }), deleteModal] }));
+    return (_jsxs(_Fragment, { children: [_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit Feature" : "New Feature", sections: [
+                    _jsx(AdminComposableRegion, { pageId: pageId, initialCards: pageRegionCards }, "page-region"),
+                    formSection,
+                ] }), deleteModal] }));
 }

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

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

package/dist/features/admin/components/AdminFeaturesView.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";
 import { sortBy } from "@mohasinac/appkit/client";
 import React from "react";
 import { useRouter, useSearchParams, usePathname } from "next/navigation.js";
@@ -11,6 +11,7 @@ import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdmin
 import { DataListingView } from "./DataListingView.js";
 import { AdminFeatureEditorView } from "./AdminFeatureEditorView.js";
 import { PRODUCT_FEATURE_SCOPE_TABS } from "../../products/constants/product-features.constants.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const PAGE_SIZE = 50;
 const DEFAULT_SCOPE = "platform";
 const STICKY_TABS_CLASS = "sticky top-[calc(var(--header-height,0px)+44px)] z-10 bg-[var(--appkit-color-surface)]/95 backdrop-blur-sm border-b border-[var(--appkit-color-border)] px-[var(--appkit-space-3)] py-[var(--appkit-space-2)]";
@@ -31,7 +32,7 @@ function mapFeatureRow(item, index) {
         updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
     };
 }
-export function AdminFeaturesView({ children, ...props }) {
+export function AdminFeaturesView({ children, pageRegionCards = [], ...props }) {
     const router = useRouter();
     const pathname = usePathname();
     const searchParams = useSearchParams();
@@ -74,8 +75,13 @@ export function AdminFeaturesView({ children, ...props }) {
                 params.set("scope", value);
                 router.replace(`${pathname}?${params.toString()}`);
             } })),
-        renderEditor: ({ editId, closePanel }) => (_jsx(AdminFeatureEditorView, { featureId: editId ?? undefined, onSaved: closePanel, onDeleted: closePanel, embedded: true })),
+        renderEditor: ({ editId, closePanel }) => (_jsx(AdminFeatureEditorView, { featureId: editId ?? undefined, onSaved: closePanel, onDeleted: closePanel, embedded: true, 
+            // Same page-id as the dedicated /admin/features/new and
+            // /admin/features/[id]/edit routes — this inline drawer is the same
+            // logical "create/edit a feature" screen, just reached from the list
+            // instead of a full navigation.
+            pageId: editId ? "admin-features-id-edit" : "admin-features-new" })),
         resolveEditorTitle: ({ isCreate }) => (isCreate ? "Add Feature" : "Edit Feature"),
     };
-    return _jsx(DataListingView, { config: config });
+    return (_jsxs(_Fragment, { children: [_jsx(AdminComposableRegion, { pageId: "admin-features", initialCards: pageRegionCards }), _jsx(DataListingView, { config: config })] }));
 }

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

@@ -1,7 +1,10 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface AdminFulfillmentViewProps {
     /** Pre-selected store ID — skips the store picker when provided. */
     initialStoreId?: string;
     initialStoreName?: string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function AdminFulfillmentView({ initialStoreId, initialStoreName, }: AdminFulfillmentViewProps): React.JSX.Element;
+export declare function AdminFulfillmentView({ initialStoreId, initialStoreName, pageRegionCards, }: AdminFulfillmentViewProps): React.JSX.Element;

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

@@ -12,6 +12,7 @@ import { normalizeError } from "../../../errors/normalize.js";
 import { useToast } from "../../../ui/components/toast-context.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 async function loadStoreOptions(query, page) {
     const params = new URLSearchParams({ page: String(page), pageSize: "25" });
     if (query)
@@ -29,7 +30,7 @@ function statusBadgeVariant(status) {
         return "success";
     return "default";
 }
-export function AdminFulfillmentView({ initialStoreId, initialStoreName, }) {
+export function AdminFulfillmentView({ initialStoreId, initialStoreName, pageRegionCards = [], }) {
     const [storeId, setStoreId] = useState(initialStoreId ?? null);
     const [orders, setOrders] = useState([]);
     const [isLoading, setIsLoading] = useState(false);
@@ -106,6 +107,6 @@ export function AdminFulfillmentView({ initialStoreId, initialStoreName, }) {
     return (_jsxs(Stack, { gap: "md", padding: "md", children: [_jsxs(Row, { align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsx(Heading, { level: 3, children: "Fulfillment Queue" }), storeId && (_jsx(Button, { variant: "secondary", size: "sm", onClick: () => {
                             setStoreId(null);
                             setOrders([]);
-                        }, children: "Change Store" }))] }), !storeId && (_jsxs(Stack, { gap: "sm", children: [_jsx(Text, { size: "sm", color: "muted", children: "Select a store to view its fulfilment queue." }), _jsx(PaginatedSelect, { value: null, onChange: (v) => { if (v)
+                        }, children: "Change Store" }))] }), _jsx(AdminComposableRegion, { pageId: "admin-fulfillment", initialCards: pageRegionCards }), !storeId && (_jsxs(Stack, { gap: "sm", children: [_jsx(Text, { size: "sm", color: "muted", children: "Select a store to view its fulfilment queue." }), _jsx(PaginatedSelect, { value: null, onChange: (v) => { if (v)
                             setStoreId(v); }, loadOptions: loadStoreOptions, placeholder: "Search stores\u2026", searchPlaceholder: "Type store name\u2026", noResultsText: "No stores found", ariaLabel: "Store" })] })), storeId && (_jsxs(Stack, { gap: "sm", children: [isLoading && (_jsx(Text, { size: "sm", color: "muted", children: "Loading orders\u2026" })), !isLoading && orders.length === 0 && (_jsx(Text, { color: "muted", children: "No orders in the fulfillment queue \u2014 great work!" })), orders.map((order) => (_jsxs(Stack, { surface: "card", padding: "sm", rounded: "md", gap: "xs", children: [_jsxs(Row, { align: "center", gap: "xs", wrap: true, children: [_jsxs(TextLink, { href: String(ROUTES.ADMIN.ORDER_DETAIL(order.id)), size: "sm", weight: "medium", children: ["#", order.id] }), _jsx(Badge, { variant: statusBadgeVariant(order.status), children: order.status }), order.pickedAt && _jsx(Badge, { variant: "success", children: "Picked" }), order.packedAt && _jsx(Badge, { variant: "success", children: "Packed" })] }), _jsxs(Text, { size: "xs", color: "muted", children: [order.userName, order.items && order.items.length > 0 && (_jsxs(_Fragment, { children: [" \u00B7 ", order.items.map((i) => i.productTitle).join(", ")] }))] }), order.assignedWorkerId && (_jsxs(Text, { size: "xs", color: "muted", children: ["Assigned to: ", order.assignedWorkerId] })), _jsxs(Row, { gap: "xs", children: [!order.pickedAt && (_jsx(Button, { size: "sm", variant: "secondary", onClick: () => handleMarkPicked(order.id), isLoading: actionLoadingId === order.id + ":picked", children: "Mark Picked" })), order.pickedAt && !order.packedAt && (_jsx(Button, { size: "sm", variant: "secondary", onClick: () => handleMarkPacked(order.id), isLoading: actionLoadingId === order.id + ":packed", children: "Mark Packed" })), order.assignedWorkerId && (_jsx(Button, { size: "sm", variant: "secondary", onClick: () => handleUnassign(order.id), isLoading: actionLoadingId === order.id + ":unassign", children: "Unassign" }))] })] }, order.id)))] })), initialStoreName && !storeId && (_jsxs(Text, { size: "xs", color: "muted", children: ["Previously viewing: ", initialStoreName] }))] }));
 }

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

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

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

@@ -65,6 +65,7 @@ import { ADMIN_GATEWAY_EVENT_KIND_TABS, ADMIN_GATEWAY_EVENT_STATUS_TABS, } from
 import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData.js";
 import { formatMoney } from "../../../utils/number.formatter.js";
 import { DataListingView } from "./DataListingView.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /** Operator-facing status names — see the 🛑 about `ignored` and `conflict`. */
 const STATUS_LABEL = {
     received: "Received, not yet settled",
@@ -74,7 +75,7 @@ const STATUS_LABEL = {
     conflict: "Arrived late — recorded, not applied",
     ignored: "Recorded, no handler for this type",
 };
-export function AdminGatewayEventsView({ children, ...props }) {
+export function AdminGatewayEventsView({ children, pageRegionCards = [], ...props }) {
     const [detail, setDetail] = useState(null);
     const [reopenId, setReopenId] = useState(null);
     const [busy, setBusy] = useState(false);
@@ -179,7 +180,7 @@ export function AdminGatewayEventsView({ children, ...props }) {
         renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(Stack, { gap: "md", children: [_jsx(FilterChipGroup, { label: "Status", tabs: ADMIN_GATEWAY_EVENT_STATUS_TABS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) }), _jsx(FilterChipGroup, { label: "Kind", tabs: ADMIN_GATEWAY_EVENT_KIND_TABS, value: pendingFilters.kind ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, kind: id })) })] })),
     };
     const detailStatus = detail ? toStringValue(detail.status, "") : "";
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(RecordDetailModal, { isOpen: detail !== null, onClose: () => setDetail(null), title: detail
+    return (_jsxs(_Fragment, { children: [_jsx(AdminComposableRegion, { pageId: "admin-maintenance-gateway-events", initialCards: pageRegionCards }), _jsx(DataListingView, { config: config }), _jsx(RecordDetailModal, { isOpen: detail !== null, onClose: () => setDetail(null), title: detail
                     ? `${toStringValue(detail.gateway, "?")} · ${toStringValue(detail.kind, "other")}`
                     : "Gateway event", badges: detail
                     ? [

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

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

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

@@ -20,6 +20,7 @@ import { ProductInlineSelect } from "../../seller/components/ProductInlineSelect
 import { apiClient } from "../../../http/index.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 function ReassignProductsDrawer({ state, onClose, onSaved, }) {
     const [productIds, setProductIds] = useState(state.currentProductIds);
     const [saving, setSaving] = useState(false);
@@ -42,7 +43,7 @@ function ReassignProductsDrawer({ state, onClose, onSaved, }) {
     };
     return (_jsxs(Stack, { gap: "md", padding: "md", children: [_jsxs(Text, { size: "sm", color: "muted", children: ["Select products to include in \u201C", state.groupTitle, "\u201D. Changes replace the current list."] }), _jsx(ProductInlineSelect, { scope: "admin", multiple: true, value: productIds, onChange: setProductIds, placeholder: "Search products to add\u2026" }), _jsxs(Row, { justify: "end", gap: "sm", children: [_jsx(Button, { variant: "outline", onClick: onClose, disabled: saving, children: "Cancel" }), _jsxs(Button, { variant: "primary", onClick: handleSave, disabled: saving, isLoading: saving, children: ["Save (", productIds.length, " product", productIds.length !== 1 ? "s" : "", ")"] })] })] }));
 }
-export function AdminGroupedListingsView({ children, ...props }) {
+export function AdminGroupedListingsView({ children, pageRegionCards = [], ...props }) {
     const [reassign, setReassign] = useState(null);
     const [refreshKey, setRefreshKey] = useState(0);
     const openReassign = React.useCallback((row) => {
@@ -100,5 +101,5 @@ export function AdminGroupedListingsView({ children, ...props }) {
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
     }
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(SideDrawer, { isOpen: reassign !== null, onClose: () => setReassign(null), title: reassign ? `Reassign products — ${reassign.groupTitle}` : "Reassign products", children: reassign && (_jsx(ReassignProductsDrawer, { state: reassign, onClose: () => setReassign(null), onSaved: () => setRefreshKey((k) => k + 1) })) })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(AdminComposableRegion, { pageId: "admin-grouped-listings", initialCards: pageRegionCards }), _jsx(DataListingView, { config: config }), _jsx(SideDrawer, { isOpen: reassign !== null, onClose: () => setReassign(null), title: reassign ? `Reassign products — ${reassign.groupTitle}` : "Reassign products", children: reassign && (_jsx(ReassignProductsDrawer, { state: reassign, onClose: () => setReassign(null), onSaved: () => setRefreshKey((k) => k + 1) })) })] }));
 }

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

@@ -1,6 +1,12 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
+import type { ContentFlagSnapshot } from "../../../_internal/shared/features/content-tags/registry";
 export interface AdminGuideHubViewProps {
     permissions?: string[];
     isFullAdmin?: boolean;
+    /** Phase 3B's first slice — admin-curated cards shared across every admin viewing this page. `[]` or omitted renders nothing extra. */
+    pageRegionCards?: DashboardCard[];
+    /** Passed straight through to `AdminComposableRegion` — see that component's own doc comment. */
+    flagSnapshot?: ContentFlagSnapshot | null;
 }
-export declare function AdminGuideHubView({ permissions, isFullAdmin }: AdminGuideHubViewProps): React.JSX.Element;
+export declare function AdminGuideHubView({ permissions, isFullAdmin, pageRegionCards, flagSnapshot }: AdminGuideHubViewProps): React.JSX.Element;

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

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

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

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

package/dist/features/admin/components/AdminHistoryView.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";
 /**
  * AdminHistoryView — read-only admin insights for the top-level `history` collection.
  * One row per user with item count + last visit. Mirrors AdminWishlistsView.
@@ -12,6 +12,7 @@ import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
 import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData.js";
 import { DataListingView } from "./DataListingView.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const ADMIN_HISTORY_CONFIG = {
     portal: "admin",
     title: "History",
@@ -40,7 +41,7 @@ const ADMIN_HISTORY_CONFIG = {
     getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
     buildFilters: () => undefined,
 };
-export function AdminHistoryView({ children, ...props }) {
+export function AdminHistoryView({ children, pageRegionCards = [], ...props }) {
     const router = useRouter();
     if (React.Children.count(children) > 0) {
         return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
@@ -48,8 +49,8 @@ export function AdminHistoryView({ children, ...props }) {
     // Same shape as AdminWishlistsView: the list API returns only a per-user
     // summary (never the viewed items), so the row already shows its whole
     // record and the useful destination is the owning user's admin page.
-    return (_jsx(DataListingView, { config: {
-            ...ADMIN_HISTORY_CONFIG,
-            onRowClick: (row) => row.userId && router.push(String(ROUTES.ADMIN.USER_DETAIL(row.userId))),
-        } }));
+    return (_jsxs(_Fragment, { children: [_jsx(AdminComposableRegion, { pageId: "admin-history", initialCards: pageRegionCards }), _jsx(DataListingView, { config: {
+                    ...ADMIN_HISTORY_CONFIG,
+                    onRowClick: (row) => row.userId && router.push(String(ROUTES.ADMIN.USER_DETAIL(row.userId))),
+                } })] }));
 }

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

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

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

@@ -10,6 +10,7 @@ import { Row, Stack } from "../../../ui/components/Layout.js";
 import { FieldInput } from "../../../ui/forms/FieldInput.js";
 import { Icon } from "../../../ui/components/Icon.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /**
  * Admin → Finance → Invoicing: the GSTR-1 draft export (Phase 7d).
  *
@@ -48,7 +49,7 @@ function defaultFyStartYear() {
     // calendar year.
     return now.getMonth() >= 3 ? now.getFullYear() : now.getFullYear() - 1;
 }
-export function AdminInvoicingView() {
+export function AdminInvoicingView({ pageRegionCards = [] } = {}) {
     const [fyStart, setFyStart] = useState(String(defaultFyStartYear()));
     const [from, setFrom] = useState("");
     const [to, setTo] = useState("");
@@ -63,7 +64,7 @@ export function AdminInvoicingView() {
     const href = from && to
         ? `${ADMIN_ENDPOINTS.INVOICING_GSTR1}?from=${from}&to=${to}`
         : undefined;
-    return (_jsxs(Stack, { gap: "lg", children: [_jsxs(Div, { children: [_jsx(Heading, { level: 1, children: "Invoicing" }), _jsx(Text, { color: "muted", size: "sm", children: "Export the invoice and credit-note register for a period, as a draft for your accountant." })] }), _jsx(Card, { padding: "md", children: _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 2, children: "GSTR-1 draft" }), _jsx(Disclaimer, { id: "accounting-output" }), _jsx(Row, { gap: "sm", wrap: true, children: _jsx(Div, { className: "w-40", children: _jsx(FieldInput, { name: "fyStart", label: "FY starting", value: fyStart, onChange: setFyStart, hint: "e.g. 2026 for FY 26-27" }) }) }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Quarter" }), _jsx(Row, { gap: "sm", wrap: true, children: QUARTERS.map((q) => (_jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => applyQuarter(q), children: q.label }, q.label))) })] }), _jsxs(Row, { gap: "sm", wrap: true, children: [_jsx(Div, { className: "w-48", children: _jsx(FieldInput, { name: "from", label: "From", value: from, onChange: setFrom }) }), _jsx(Div, { className: "w-48", children: _jsx(FieldInput, { name: "to", label: "To", value: to, onChange: setTo }) })] }), _jsxs(Row, { gap: "sm", align: "center", children: [_jsxs(Button, { type: "button", variant: "primary", disabled: !href, onClick: () => {
+    return (_jsxs(Stack, { gap: "lg", children: [_jsxs(Div, { children: [_jsx(Heading, { level: 1, children: "Invoicing" }), _jsx(Text, { color: "muted", size: "sm", children: "Export the invoice and credit-note register for a period, as a draft for your accountant." })] }), _jsx(AdminComposableRegion, { pageId: "admin-invoicing", initialCards: pageRegionCards }), _jsx(Card, { padding: "md", children: _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 2, children: "GSTR-1 draft" }), _jsx(Disclaimer, { id: "accounting-output" }), _jsx(Row, { gap: "sm", wrap: true, children: _jsx(Div, { className: "w-40", children: _jsx(FieldInput, { name: "fyStart", label: "FY starting", value: fyStart, onChange: setFyStart, hint: "e.g. 2026 for FY 26-27" }) }) }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Quarter" }), _jsx(Row, { gap: "sm", wrap: true, children: QUARTERS.map((q) => (_jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => applyQuarter(q), children: q.label }, q.label))) })] }), _jsxs(Row, { gap: "sm", wrap: true, children: [_jsx(Div, { className: "w-48", children: _jsx(FieldInput, { name: "from", label: "From", value: from, onChange: setFrom }) }), _jsx(Div, { className: "w-48", children: _jsx(FieldInput, { name: "to", label: "To", value: to, onChange: setTo }) })] }), _jsxs(Row, { gap: "sm", align: "center", children: [_jsxs(Button, { type: "button", variant: "primary", disabled: !href, onClick: () => {
                                         if (href)
                                             window.location.href = href;
                                     }, children: [_jsx(Icon, { name: "download", size: "sm" }), "Download draft CSV"] }), !href && (_jsx(Text, { color: "muted", size: "xs", children: "Pick a quarter, or enter both dates as YYYY-MM-DD." }))] }), _jsx(Text, { color: "muted", size: "xs", children: "Credit notes appear as negative rows, so the TOTAL row is net of refunds. Any paid order in the window that carries no invoice number is listed at the bottom of the file as a warning \u2014 those are not included in the totals and need looking at." })] }) })] }));

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

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