@mohasinac/appkit 4.70.0 → 4.71.2

package/dist/features/cart/actions/cart-actions.js

@@ -34,7 +34,7 @@ async function resolveStoreName(storeId, candidate) {
     return store?.storeName ?? storeId;
 }
 /**
- * Lane gate. While a higher-obligation lane (a won auction, then an accepted
+ * Lane gate. While a higher-obligation lane (a won collector drop, then an accepted
  * offer) is outstanding, no NEW shopping may be added — otherwise the buyer can
  * keep deferring something they already committed to by piling more into the
  * cart. Enforced on the server, not only in the UI: the UI hint is a courtesy,
@@ -44,7 +44,7 @@ async function resolveStoreName(storeId, candidate) {
  * `addItemToCart` and therefore covered exactly one of the four ways a line can
  * be created — `addBundleToCartAction` and `POST /api/cart` both call
  * `cartRepository.addItem` directly and so bypassed it entirely, letting a buyer
- * with an unpaid auction win keep shopping.
+ * with an unpaid collector drop win keep shopping.
  *
  * Returns the loaded cart so the caller doesn't pay a second read.
  */
@@ -52,8 +52,8 @@ export async function assertCanAddNewItems(userId) {
     const cart = await cartRepository.getOrCreate(userId);
     if (!canAddNewItems(cart.items ?? [])) {
         const blocking = activeLane(cart.items ?? []);
-        throw new ValidationError(blocking === CART_LANE.AUCTION
-            ? "Settle your won auction first — you can add other items once it's paid for."
+        throw new ValidationError(blocking === CART_LANE.COLLECTOR_DROP
+            ? "Settle your won collector drop first — you can add other items once it's paid for."
             : "Complete your accepted offer first — you can add other items once it's paid for.", { code: CART_LANE_BLOCKED });
     }
     return cart;
@@ -300,11 +300,11 @@ async function resolveGroupTitle(groupId, groupSource, sample) {
     return sample?.groupTitle ?? "Selected items";
 }
 /**
- * Won-auction lines are non-removable and fixed-quantity — the buyer committed
+ * Won-collector-drop lines are non-removable and fixed-quantity — the buyer committed
  * to the purchase by bidding, and letting them delete it would turn every
- * auction into a free option. That's already enforced one layer down:
+ * collector drop into a free option. That's already enforced one layer down:
  * `cartRepository.updateItem` / `removeItem` both reject a `locked` line, and
- * auction settlement is the only writer that sets `locked: true`. Accepted
+ * collector drop settlement is the only writer that sets `locked: true`. Accepted
  * offers deliberately do NOT set it — declining to buy is the buyer's right,
  * and the offer simply lapses at its `checkoutDeadline`.
  */

package/dist/features/cart/components/CartDrawer.js

@@ -6,7 +6,7 @@ import { Div } from "../../../ui/components/Div.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Row, Stack } from "../../../ui/components/Layout.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { QuantityStepper } from "../../../ui/components/QuantityStepper.js";
 import { GatedPrice } from "../../../ui/components/GatedPrice.js";
 import { formatCurrency } from "../../../utils/number.formatter.js";

package/dist/features/cart/components/CartGroupLineRow.js

@@ -23,7 +23,7 @@ import { Row, Stack } from "../../../ui/components/Layout.js";
 import { Span, Text } from "../../../ui/components/Typography.js";
 import { TextLink } from "../../../ui/components/TextLink.js";
 import { QuantityStepper } from "../../../ui/components/QuantityStepper.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { GatedPrice, PricesOnly } from "../../../ui/components/GatedPrice.js";
 import { formatCurrency } from "../../../utils/number.formatter.js";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry.js";

package/dist/features/cart/components/CartView.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import type { JsonArray } from "@mohasinac/appkit";
+import type { JsonArray } from "../../../schemas/types";
 /** Minimal shape of a per-store/per-type order group surfaced to the slot. */
 export interface CartOrderGroup {
     /** Unique key for this group (e.g. `${storeId}:${orderType}`). */

package/dist/features/cart/hooks/useCartQuery.d.ts

@@ -1,4 +1,4 @@
-import type { FirestoreValue } from "@mohasinac/appkit";
+import type { FirestoreValue } from "../../../schemas/types";
 interface UseCartQueryOptions<TData> {
     endpoint: string;
     queryKey?: readonly FirestoreValue[];

package/dist/features/cart/hooks/useCheckoutReadQueries.d.ts

@@ -1,4 +1,4 @@
-import type { JsonArray } from "@mohasinac/appkit";
+import type { JsonArray } from "../../../schemas/types";
 interface UseCheckoutReadQueriesOptions<TAddress, TCart> {
     addressesEndpoint: string;
     cartEndpoint: string;

package/dist/features/cart/repository/cart.repository.d.ts

@@ -81,7 +81,7 @@ export declare class CartRepository extends BaseRepository<CartDocument> {
     /**
      * Empty the cart, keeping any locked line.
      *
-     * A locked line is a won auction or an accepted offer — settlement put it
+     * A locked line is a won collector drop or an accepted offer — settlement put it
      * there and the buyer owes payment on it, so "clear" cannot mean "walk away"
      * (see § Checkout Lanes). Callers must tell the buyer that is what happened;
      * a silently-surviving row reads as a failed clear.
@@ -96,14 +96,14 @@ export declare class CartRepository extends BaseRepository<CartDocument> {
      * that blocks user-initiated removal.
      *
      * Only the expiry sweeps call this: a locked line whose claim has lapsed must
-     * be cleared, or it keeps the buyer's auction/offer lane non-empty forever
+     * be cleared, or it keeps the buyer's collector drop/offer lane non-empty forever
      * and the lane gate blocks their ordinary checkout on something they can no
      * longer act on.
      */
     private removeLockedLines;
     /** Clear the cart line created for a specific accepted offer. */
     removeItemsByOfferId(userId: string, offerId: string): Promise<number>;
-    /** Clear the cart line created for a specific won auction bid. */
+    /** Clear the cart line created for a specific won collector drop bid. */
     removeItemsByBidId(userId: string, bidId: string): Promise<number>;
     /**
      * Every locked line across all carts whose `checkoutDeadline` has passed.

package/dist/features/cart/repository/cart.repository.js

@@ -64,7 +64,7 @@ export class CartRepository extends BaseRepository {
         try {
             const cart = await this.getOrCreate(userId);
             const items = [...cart.items];
-            // A locked line (accepted offer / won auction) is identified by its
+            // A locked line (accepted offer / won collector drop) is identified by its
             // offerId or bidId, never merged by productId — two separate wins on the
             // same listing are two separate obligations, and re-running the
             // settlement sweep must not duplicate a line it already wrote.
@@ -106,8 +106,8 @@ export class CartRepository extends BaseRepository {
                     listingType: input.listingType,
                     ...(input.isOffer !== undefined && { isOffer: input.isOffer }),
                     ...(input.offerId !== undefined && { offerId: input.offerId }),
-                    ...(input.isAuctionWin !== undefined && { isAuctionWin: input.isAuctionWin }),
-                    ...(input.auctionId !== undefined && { auctionId: input.auctionId }),
+                    ...(input.isCollectorDropWin !== undefined && { isCollectorDropWin: input.isCollectorDropWin }),
+                    ...(input.collectorDropId !== undefined && { collectorDropId: input.collectorDropId }),
                     ...(input.bidId !== undefined && { bidId: input.bidId }),
                     ...(input.isBuyout !== undefined && { isBuyout: input.isBuyout }),
                     ...(input.lockedPrice !== undefined && {
@@ -419,7 +419,7 @@ export class CartRepository extends BaseRepository {
     /**
      * Empty the cart, keeping any locked line.
      *
-     * A locked line is a won auction or an accepted offer — settlement put it
+     * A locked line is a won collector drop or an accepted offer — settlement put it
      * there and the buyer owes payment on it, so "clear" cannot mean "walk away"
      * (see § Checkout Lanes). Callers must tell the buyer that is what happened;
      * a silently-surviving row reads as a failed clear.
@@ -475,7 +475,7 @@ export class CartRepository extends BaseRepository {
      * that blocks user-initiated removal.
      *
      * Only the expiry sweeps call this: a locked line whose claim has lapsed must
-     * be cleared, or it keeps the buyer's auction/offer lane non-empty forever
+     * be cleared, or it keeps the buyer's collector drop/offer lane non-empty forever
      * and the lane gate blocks their ordinary checkout on something they can no
      * longer act on.
      */
@@ -497,7 +497,7 @@ export class CartRepository extends BaseRepository {
     async removeItemsByOfferId(userId, offerId) {
         return this.removeLockedLines(userId, (item) => item.offerId === offerId);
     }
-    /** Clear the cart line created for a specific won auction bid. */
+    /** Clear the cart line created for a specific won collector drop bid. */
     async removeItemsByBidId(userId, bidId) {
         return this.removeLockedLines(userId, (item) => item.bidId === bidId);
     }

package/dist/features/cart/schemas/firestore.d.ts

@@ -99,8 +99,8 @@ export interface CartItemDocument {
     storeName: string;
     /**
      * Snapshot of the product's listing-kind at add-to-cart time (SB1-G Phase 4).
-     * Drives order-grouping (auctions/pre-orders settle separately from standard
-     * carts) and cart-side UI badges. Replaces the legacy `isAuctionWin`/`isPreOrder`
+     * Drives order-grouping (collector drops/pre-orders settle separately from standard
+     * carts) and cart-side UI badges. Replaces the legacy `isCollectorDropWin`/`isPreOrder`
      * pair on the cart item.
      */
     listingType: ListingType;
@@ -108,38 +108,38 @@ export interface CartItemDocument {
     isOffer?: boolean;
     offerId?: string;
     /**
-     * True when the line was created by auction settlement for the winning
-     * bidder. Auctions are `canAddToCart: false` for user-initiated adds — this
+     * True when the line was created by collector drop settlement for the winning
+     * bidder. Collector Drops are `canAddToCart: false` for user-initiated adds — this
      * line is written by the settlement job through the repository directly, and
-     * is the ONLY way an auction reaches the cart.
+     * is the ONLY way a collector drop reaches the cart.
      */
-    isAuctionWin?: boolean;
-    /** The auction product this win refers to (= productId, kept explicit). */
-    auctionId?: string;
+    isCollectorDropWin?: boolean;
+    /** The collector drop product this win refers to (= productId, kept explicit). */
+    collectorDropId?: string;
     /** The winning bid, so the resulting order can be linked back to it. */
     bidId?: string;
     /**
-     * True when this auction line came from Buy Now rather than from settlement.
+     * True when this collector drop line came from Buy Now rather than from settlement.
      *
-     * The two are NOT interchangeable even though both sit in the auction lane:
-     *  - a settlement line is a FINISHED auction — the item is already sold, the
+     * The two are NOT interchangeable even though both sit in the collector drop lane:
+     *  - a settlement line is a FINISHED collector drop — the item is already sold, the
      *    buyer owes it, and the 48h window costs nobody anything;
-     *  - a buyout line is a CLAIM on an auction that is still live and still
+     *  - a buyout line is a CLAIM on a collector drop that is still live and still
      *    taking bids. The item is not sold yet; it becomes sold only when
-     *    `claimAuctionForCheckout` commits at order time. Hence the 1h window,
+     *    `claimCollectorDropForCheckout` commits at order time. Hence the 1h window,
      *    and hence a lapse that cancels the bid rather than forfeiting it —
-     *    nothing was won, so nothing is forfeited, and the auction is untouched.
+     *    nothing was won, so nothing is forfeited, and the collector drop is untouched.
      */
     isBuyout?: boolean;
     /** Locked offer/winning-bid price — overrides normal product price at checkout */
     lockedPrice?: number;
     /**
      * When the claim on this locked price lapses. Mirrors the offer's own
-     * `checkoutDeadline`; set to now + 48h for a won auction. The expiry sweep
+     * `checkoutDeadline`; set to now + 48h for a won collector drop. The expiry sweep
      * clears lines past this point.
      */
     checkoutDeadline?: Date;
-    /** When true the item cannot be removed or have its quantity changed. Set on won-auction and accepted-offer items that require mandatory payment. */
+    /** When true the item cannot be removed or have its quantity changed. Set on won-collector-drop and accepted-offer items that require mandatory payment. */
     locked?: boolean;
     /**
      * SB-UNI-4 2026-05-13 — bundle identifier when this cart line represents a
@@ -378,8 +378,8 @@ export declare const CART_FIELDS: {
         readonly LISTING_TYPE: "listingType";
         readonly IS_OFFER: "isOffer";
         readonly OFFER_ID: "offerId";
-        readonly IS_AUCTION_WIN: "isAuctionWin";
-        readonly AUCTION_ID: "auctionId";
+        readonly IS_COLLECTOR_DROP_WIN: "isCollectorDropWin";
+        readonly COLLECTOR_DROP_ID: "collectorDropId";
         readonly BID_ID: "bidId";
         readonly IS_BUYOUT: "isBuyout";
         readonly LOCKED_PRICE: "lockedPrice";
@@ -417,10 +417,10 @@ export type AddToCartInput = {
     listingType: ListingType;
     isOffer?: boolean;
     offerId?: string;
-    isAuctionWin?: boolean;
-    auctionId?: string;
+    isCollectorDropWin?: boolean;
+    collectorDropId?: string;
     bidId?: string;
-    /** See `CartItemDocument.isBuyout` — a claim on a live auction, not a win. */
+    /** See `CartItemDocument.isBuyout` — a claim on a live collector drop, not a win. */
     isBuyout?: boolean;
     lockedPrice?: number;
     checkoutDeadline?: Date;

package/dist/features/cart/schemas/firestore.js

@@ -25,8 +25,8 @@ export const CART_FIELDS = {
         LISTING_TYPE: "listingType",
         IS_OFFER: "isOffer",
         OFFER_ID: "offerId",
-        IS_AUCTION_WIN: "isAuctionWin",
-        AUCTION_ID: "auctionId",
+        IS_COLLECTOR_DROP_WIN: "isCollectorDropWin",
+        COLLECTOR_DROP_ID: "collectorDropId",
         BID_ID: "bidId",
         IS_BUYOUT: "isBuyout",
         LOCKED_PRICE: "lockedPrice",

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

@@ -65,8 +65,6 @@ export declare const cartItemSchema: z.ZodObject<{
     id: string;
     productId: string;
     quantity: number;
-    userId?: string | undefined;
-    sessionId?: string | undefined;
     meta?: {
         currency: string;
         title: string;
@@ -75,13 +73,12 @@ export declare const cartItemSchema: z.ZodObject<{
         storeName?: string | undefined;
         attributes?: Record<string, string> | undefined;
     } | undefined;
+    userId?: string | undefined;
+    sessionId?: string | undefined;
     addedAt?: string | undefined;
 }, {
     id: string;
     productId: string;
-    userId?: string | undefined;
-    quantity?: number | undefined;
-    sessionId?: string | undefined;
     meta?: {
         title: string;
         price: number;
@@ -90,6 +87,9 @@ export declare const cartItemSchema: z.ZodObject<{
         storeName?: string | undefined;
         attributes?: Record<string, string> | undefined;
     } | undefined;
+    userId?: string | undefined;
+    quantity?: number | undefined;
+    sessionId?: string | undefined;
     addedAt?: string | undefined;
 }>;
 export declare const cartSummarySchema: z.ZodObject<{
@@ -126,8 +126,6 @@ export declare const cartSummarySchema: z.ZodObject<{
         id: string;
         productId: string;
         quantity: number;
-        userId?: string | undefined;
-        sessionId?: string | undefined;
         meta?: {
             currency: string;
             title: string;
@@ -136,13 +134,12 @@ export declare const cartSummarySchema: z.ZodObject<{
             storeName?: string | undefined;
             attributes?: Record<string, string> | undefined;
         } | undefined;
+        userId?: string | undefined;
+        sessionId?: string | undefined;
         addedAt?: string | undefined;
     }, {
         id: string;
         productId: string;
-        userId?: string | undefined;
-        quantity?: number | undefined;
-        sessionId?: string | undefined;
         meta?: {
             title: string;
             price: number;
@@ -151,6 +148,9 @@ export declare const cartSummarySchema: z.ZodObject<{
             storeName?: string | undefined;
             attributes?: Record<string, string> | undefined;
         } | undefined;
+        userId?: string | undefined;
+        quantity?: number | undefined;
+        sessionId?: string | undefined;
         addedAt?: string | undefined;
     }>, "many">;
     subtotal: z.ZodNumber;
@@ -162,8 +162,6 @@ export declare const cartSummarySchema: z.ZodObject<{
         id: string;
         productId: string;
         quantity: number;
-        userId?: string | undefined;
-        sessionId?: string | undefined;
         meta?: {
             currency: string;
             title: string;
@@ -172,6 +170,8 @@ export declare const cartSummarySchema: z.ZodObject<{
             storeName?: string | undefined;
             attributes?: Record<string, string> | undefined;
         } | undefined;
+        userId?: string | undefined;
+        sessionId?: string | undefined;
         addedAt?: string | undefined;
     }[];
     subtotal: number;
@@ -180,9 +180,6 @@ export declare const cartSummarySchema: z.ZodObject<{
     items: {
         id: string;
         productId: string;
-        userId?: string | undefined;
-        quantity?: number | undefined;
-        sessionId?: string | undefined;
         meta?: {
             title: string;
             price: number;
@@ -191,6 +188,9 @@ export declare const cartSummarySchema: z.ZodObject<{
             storeName?: string | undefined;
             attributes?: Record<string, string> | undefined;
         } | undefined;
+        userId?: string | undefined;
+        quantity?: number | undefined;
+        sessionId?: string | undefined;
         addedAt?: string | undefined;
     }[];
     subtotal: number;

package/dist/features/cart/utils/pending-ops.d.ts

@@ -62,7 +62,7 @@ export interface CartOp {
 export interface WishlistOp {
     op: WishlistOpKind;
     itemId: string;
-    type: "product" | "auction" | "preorder" | "category" | "store" | "classified" | "digital-code" | "live";
+    type: "product" | "collector-drop" | "preorder" | "category" | "store" | "classified" | "digital-code" | "live" | /* pre-rename */ "auction";
     title?: string;
     image?: string;
     ts: number;

package/dist/features/cart/utils/pending-ops.js

@@ -6,9 +6,22 @@
  * The sync manager replays these and clears them after a successful push.
  */
 import { normalizeError } from "../../../errors/normalize.js";
-const APP_ID = () => typeof process !== "undefined" && process.env.NEXT_PUBLIC_APP_ID
-    ? process.env.NEXT_PUBLIC_APP_ID
-    : "letitrip";
+import { getStorageNamespace } from "../../../constants/storage-keys.js";
+/*
+ * 🛑 A SECOND storage-key namespace owner, now removed.
+ *
+ * A1 made `constants/storage-keys.ts` the one namespace, injected by the
+ * consumer via `setStorageNamespace()`. This file had its own parallel
+ * mechanism reading a DIFFERENT env var (`NEXT_PUBLIC_APP_ID`) with a
+ * hardcoded `"letitrip"` fallback — so two modules decided what prefixes a
+ * browser key, and only one of them was configurable.
+ *
+ * The resolved value is unchanged for this install (the namespace is also
+ * "letitrip"), which matters: changing the prefix would ORPHAN every queued
+ * cart/wishlist op already sitting in a returning visitor's localStorage
+ * rather than migrating it.
+ */
+const APP_ID = () => getStorageNamespace();
 const CART_OPS_KEY = () => `${APP_ID()}_cart_ops`;
 const WL_OPS_KEY = () => `${APP_ID()}_wl_ops`;
 /** Fired whenever the pending cart/wishlist op queue changes, so a badge

package/dist/features/catalogue/components/AdminCatalogueApprovalsView.d.ts

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

package/dist/features/catalogue/components/AdminCatalogueApprovalsView.js

@@ -16,6 +16,7 @@ import { apiClient } from "../../../http/index.js";
 import { toRecordArray, toRelativeDate, toStringValue, } from "../../admin/hooks/useAdminListingData.js";
 import { DataListingView } from "../../admin/components/DataListingView.js";
 import { RecordStatusTimeline } from "../../status-history/components/RecordStatusTimeline.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /** The submitted item's photos — the whole point of a visual approval. */
 function toPhotoEntries(raw) {
     const images = Array.isArray(raw.images) ? raw.images : [];
@@ -23,7 +24,7 @@ function toPhotoEntries(raw) {
         .filter((i) => typeof i === "string")
         .map((url, i) => ({ image: url, title: `Photo ${i + 1}` }));
 }
-export function AdminCatalogueApprovalsView() {
+export function AdminCatalogueApprovalsView({ pageRegionCards = [] } = {}) {
     const queryClient = useQueryClient();
     const [rejectTarget, setRejectTarget] = React.useState(null);
     const [rejectReason, setRejectReason] = React.useState("");
@@ -63,6 +64,7 @@ export function AdminCatalogueApprovalsView() {
         })),
         getTotal: (response, mappedRows) => (typeof response.meta?.total === "number" ? response.meta.total : mappedRows.length),
         buildFilters: () => undefined,
+        renderAboveContent: () => _jsx(AdminComposableRegion, { pageId: "admin-catalogue-approvals", initialCards: pageRegionCards }),
         // Approve/Reject used to be the ONLY row affordance — an admin was asked
         // to accept or refuse a submission whose photos, description and price
         // were never rendered anywhere. "View" opens those first.

package/dist/features/catalogue/components/CatalogueItemEditorView.d.ts

@@ -22,8 +22,13 @@
  */
 import React from "react";
 import type { CatalogueItemDocument } from "../schemas/firestore";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface CatalogueItemEditorViewProps {
     item?: CatalogueItemDocument;
+    /** 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;
 }
-export declare function CatalogueItemEditorView({ item, onSaved }: CatalogueItemEditorViewProps): React.JSX.Element;
+export declare function CatalogueItemEditorView({ item, pageId, pageRegionCards, onSaved, }: CatalogueItemEditorViewProps): React.JSX.Element;

package/dist/features/catalogue/components/CatalogueItemEditorView.js

@@ -37,6 +37,7 @@ import { SectionForm, useSectionFormNav } from "../../shell/SectionForm.js";
 import { useMediaUpload } from "../../media/hooks/useMedia.js";
 import { MediaUploadList } from "../../media/upload/MediaUploadList.js";
 import { createCatalogueItemSchema } from "../schemas/validation.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 /** PUBLIC endpoints — this is a buyer surface; the admin ones would 403. */
 async function loadOptionsFrom(endpoint, query, page, 
 /** Extra query params. Passed as an object rather than baked into
@@ -62,7 +63,7 @@ extra) {
  */
 const loadCategoryOptions = (q, p) => loadOptionsFrom(CATEGORY_ENDPOINTS.LIST, q, p, { listingOnly: "true" });
 const loadBrandOptions = (q, p) => loadOptionsFrom(BRAND_ENDPOINTS.LIST, q, p);
-export function CatalogueItemEditorView({ item, onSaved }) {
+export function CatalogueItemEditorView({ item, pageId, pageRegionCards = [], onSaved, }) {
     const isCreate = !item;
     const queryClient = useQueryClient();
     const { upload } = useMediaUpload();
@@ -148,7 +149,7 @@ export function CatalogueItemEditorView({ item, onSaved }) {
         }
         saveMutation.mutate();
     };
-    return (_jsxs(Stack, { gap: "md", children: [item?.listingStatus && item.listingStatus !== "not_listed" && (_jsxs(Alert, { variant: "info", children: ["This item is ", item.listingStatus.replace(/_/g, " "), item.listingStatus === "rejected" && item.rejectionReason
+    return (_jsxs(Stack, { gap: "md", children: [_jsx(AdminComposableRegion, { pageId: pageId, initialCards: pageRegionCards }), item?.listingStatus && item.listingStatus !== "not_listed" && (_jsxs(Alert, { variant: "info", children: ["This item is ", item.listingStatus.replace(/_/g, " "), item.listingStatus === "rejected" && item.rejectionReason
                         ? `: ${item.rejectionReason}`
                         : "."] })), _jsxs(FormShellContext.Provider, { value: shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: form, onChange: (partial) => setForm((prev) => Object.assign({}, prev, partial)), onSubmit: onSubmit, schema: createCatalogueItemSchema, openIds: nav.openIds, onOpenChange: nav.setOpenIds, isLoading: saveMutation.isPending, submitLabel: isCreate ? "Add to Catalogue" : "Save Changes" })] })] }));
 }

package/dist/features/catalogue/components/PublicCatalogueItemDetailView.d.ts

@@ -1,11 +1,14 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface PublicCatalogueItemDetailViewProps {
     ownerSlug: string;
     itemId: string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
 /**
  * Public detail page for a single personal-catalogue item — previously had
  * no route or view at all; the public catalogue grid rendered bare, unlinked
  * cards (see Recurrent Root Cause sweep, 2026-08-20 session).
  */
-export declare function PublicCatalogueItemDetailView({ ownerSlug, itemId }: PublicCatalogueItemDetailViewProps): React.JSX.Element;
+export declare function PublicCatalogueItemDetailView({ ownerSlug, itemId, pageRegionCards }: PublicCatalogueItemDetailViewProps): React.JSX.Element;

package/dist/features/catalogue/components/PublicCatalogueItemDetailView.js

@@ -8,11 +8,12 @@ import { GatedPrice } from "../../../ui/components/GatedPrice.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Main, Section } from "../../../ui/components/Semantic.js";
 import { Skeleton } from "../../../ui/components/Skeleton.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { apiClient } from "../../../http/index.js";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { formatCurrency } from "../../../utils/number.formatter.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const __O = {
     hidden: "overflow-hidden",
 };
@@ -21,7 +22,7 @@ const __O = {
  * no route or view at all; the public catalogue grid rendered bare, unlinked
  * cards (see Recurrent Root Cause sweep, 2026-08-20 session).
  */
-export function PublicCatalogueItemDetailView({ ownerSlug, itemId }) {
+export function PublicCatalogueItemDetailView({ ownerSlug, itemId, pageRegionCards = [] }) {
     const { data, isLoading, isError } = useQuery({
         queryKey: ["catalogue", "public-item", ownerSlug, itemId],
         queryFn: () => apiClient.get(ACCOUNT_ENDPOINTS.PUBLIC_CATALOGUE_ITEM(ownerSlug, itemId)),
@@ -34,5 +35,5 @@ export function PublicCatalogueItemDetailView({ ownerSlug, itemId }) {
     }
     const { owner, item, linkedProductHref } = data;
     const images = item.images.length > 0 ? item.images : item.mainImage ? [item.mainImage] : [];
-    return (_jsx(Main, { children: _jsxs(Container, { size: "lg", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", gap: "xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: "/", className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: `${ROUTES.PUBLIC.PROFILE(ownerSlug)}/catalogue`, className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: owner.displayName ?? "Catalogue" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: item.title })] }), _jsxs(Grid, { cols: 2, gap: "lg", children: [images.length > 0 ? (_jsx(Div, { className: `relative aspect-square w-full ${__O.hidden}`, rounded: "xl", surface: "muted", children: _jsx(MediaImage, { src: images[0], alt: item.title, size: "hero", objectFit: "contain" }) })) : (_jsx(Div, { className: "relative aspect-square w-full", rounded: "xl", surface: "muted" })), images.length > 1 && (_jsx(Row, { gap: "sm", wrap: true, className: "col-span-2", children: images.slice(1).map((src, i) => (_jsx(Div, { className: `relative h-20 w-20 ${__O.hidden}`, rounded: "lg", surface: "muted", children: _jsx(MediaImage, { src: src, alt: `${item.title} photo ${i + 2}`, size: "thumbnail", objectFit: "cover" }) }, i))) })), _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 1, size: "2xl", weight: "bold", color: "primary", children: item.title }), typeof item.price === "number" && item.price > 0 && (_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { label: "Sign in to see the estimated value", children: formatCurrency(item.price) }) }), _jsx(Text, { size: "xs", color: "muted", children: "Estimated value \u2014 not for direct sale from this page." })] })), _jsxs(Row, { gap: "sm", wrap: true, children: [item.condition && (_jsx(Span, { size: "xs", weight: "medium", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: item.condition })), typeof item.quantity === "number" && (_jsxs(Span, { size: "xs", weight: "medium", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: ["Qty: ", item.quantity] }))] }), item.description && (_jsx(Text, { color: "muted", className: "whitespace-pre-line", children: item.description })), owner.displayName && (_jsxs(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Owned by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: owner.displayName })] })), linkedProductHref && (_jsx(Link, { href: linkedProductHref, className: "inline-flex w-fit items-center rounded-lg bg-primary px-[var(--appkit-space-4)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] font-semibold text-white transition-colors hover:opacity-90", children: "View live listing \u2192" }))] })] })] }) }));
+    return (_jsx(Main, { children: _jsxs(Container, { size: "lg", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", gap: "xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: "/", className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: `${ROUTES.PUBLIC.PROFILE(ownerSlug)}/catalogue`, className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: owner.displayName ?? "Catalogue" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: item.title })] }), _jsxs(Grid, { cols: 2, gap: "lg", children: [images.length > 0 ? (_jsx(Div, { className: `relative aspect-square w-full ${__O.hidden}`, rounded: "xl", surface: "muted", children: _jsx(MediaImage, { src: images[0], alt: item.title, size: "hero", objectFit: "contain" }) })) : (_jsx(Div, { className: "relative aspect-square w-full", rounded: "xl", surface: "muted" })), images.length > 1 && (_jsx(Row, { gap: "sm", wrap: true, className: "col-span-2", children: images.slice(1).map((src, i) => (_jsx(Div, { className: `relative h-20 w-20 ${__O.hidden}`, rounded: "lg", surface: "muted", children: _jsx(MediaImage, { src: src, alt: `${item.title} photo ${i + 2}`, size: "thumbnail", objectFit: "cover" }) }, i))) })), _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 1, size: "2xl", weight: "bold", color: "primary", children: item.title }), typeof item.price === "number" && item.price > 0 && (_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { label: "Sign in to see the estimated value", children: formatCurrency(item.price) }) }), _jsx(Text, { size: "xs", color: "muted", children: "Estimated value \u2014 not for direct sale from this page." })] })), _jsxs(Row, { gap: "sm", wrap: true, children: [item.condition && (_jsx(Span, { size: "xs", weight: "medium", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: item.condition })), typeof item.quantity === "number" && (_jsxs(Span, { size: "xs", weight: "medium", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: ["Qty: ", item.quantity] }))] }), item.description && (_jsx(Text, { color: "muted", className: "whitespace-pre-line", children: item.description })), owner.displayName && (_jsxs(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Owned by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: owner.displayName })] })), linkedProductHref && (_jsx(Link, { href: linkedProductHref, className: "inline-flex w-fit items-center rounded-lg bg-primary px-[var(--appkit-space-4)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] font-semibold text-white transition-colors hover:opacity-90", children: "View live listing \u2192" }))] })] }), _jsx(AdminComposableRegion, { pageId: "catalogue-ownerslug-itemid", initialCards: pageRegionCards })] }) }));
 }

package/dist/features/catalogue/components/PublicCatalogueView.js

@@ -7,7 +7,7 @@ import { GatedPrice } from "../../../ui/components/GatedPrice.js";
 import { Grid } from "../../../ui/components/Layout.js";
 import { Heading, Text } from "../../../ui/components/Typography.js";
 import { Skeleton } from "../../../ui/components/Skeleton.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { apiClient } from "../../../http/index.js";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { formatCurrency } from "../../../utils/number.formatter.js";

package/dist/features/catalogue/components/UserCatalogueView.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface UserCatalogueViewProps {
     /**
      * True for sellers AND admins — both can list a catalogue item directly
@@ -8,5 +9,7 @@ export interface UserCatalogueViewProps {
      * pointless round trip. Ordinary buyers get "Request to sell" instead.
      */
     canListDirectly: boolean;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function UserCatalogueView({ canListDirectly }: UserCatalogueViewProps): React.JSX.Element;
+export declare function UserCatalogueView({ canListDirectly, pageRegionCards }: UserCatalogueViewProps): React.JSX.Element;

package/dist/features/catalogue/components/UserCatalogueView.js

@@ -10,17 +10,18 @@ import { Grid, Row, Stack } from "../../../ui/components/Layout.js";
 import { Heading, Text } from "../../../ui/components/Typography.js";
 import { SideDrawer } from "../../../ui/components/SideDrawer.js";
 import { Skeleton } from "../../../ui/components/Skeleton.js";
-import { MediaImage } from "../../media/MediaImage.js";
+import { MediaImage } from "../../../ui/components/MediaImage.js";
 import { apiClient } from "../../../http/index.js";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { CatalogueItemEditorView } from "./CatalogueItemEditorView.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 const STATUS_VARIANT = {
     not_listed: "secondary",
     pending_admin_approval: "warning",
     listed: "success",
     rejected: "default",
 };
-export function UserCatalogueView({ canListDirectly }) {
+export function UserCatalogueView({ canListDirectly, pageRegionCards = [] }) {
     const queryClient = useQueryClient();
     const { data, isLoading } = useQuery({
         queryKey: ["user", "catalogue"],
@@ -53,5 +54,5 @@ export function UserCatalogueView({ canListDirectly }) {
         onSuccess: invalidate,
     });
     const editingItem = items.find((i) => i.id === editingId);
-    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Heading, { level: 2, children: "My Catalogue" }), _jsx(Button, { onClick: () => setCreating(true), children: "+ Add Item" })] }), isLoading ? (_jsx(Grid, { cols: 3, gap: "md", children: [1, 2, 3].map((n) => (_jsx(Skeleton, { variant: "rectangular", height: 220 }, n))) })) : items.length === 0 ? (_jsx(Text, { variant: "secondary", children: "Nothing in your catalogue yet." })) : (_jsx(Grid, { cols: 3, gap: "md", children: items.map((item) => (_jsxs(Div, { rounded: "xl", border: "default", padding: "md", surface: "card", children: [_jsx(MediaImage, { src: item.mainImage || item.images[0] || "", alt: item.title, size: "card" }), _jsxs(Stack, { gap: "xs", padding: "t-sm", children: [_jsx(Text, { weight: "medium", children: item.title }), _jsxs(Row, { gap: "sm", align: "center", children: [_jsx(Badge, { variant: STATUS_VARIANT[item.listingStatus], children: item.listingStatus.replace(/_/g, " ") }), _jsx(Badge, { variant: "secondary", children: item.visibility })] }), _jsxs(Row, { gap: "sm", wrap: true, children: [_jsx(Button, { size: "sm", variant: "ghost", onClick: () => setEditingId(item.id), children: "Edit" }), _jsx(Button, { size: "sm", variant: "ghost", onClick: () => toggleVisibilityMutation.mutate(item), children: item.visibility === "public" ? "Make private" : "Make public" }), item.listingStatus === "not_listed" && (canListDirectly ? (_jsx(Button, { size: "sm", isLoading: listMutation.isPending, onClick: () => listMutation.mutate(item.id), children: "List" })) : (_jsx(Button, { size: "sm", isLoading: submitMutation.isPending, onClick: () => submitMutation.mutate(item.id), children: "Request to sell" }))), item.listingStatus === "not_listed" && (_jsx(Button, { size: "sm", variant: "ghost", isLoading: deleteMutation.isPending, onClick: () => deleteMutation.mutate(item.id), children: "Delete" }))] })] })] }, item.id))) })), _jsx(SideDrawer, { isOpen: creating, onClose: () => setCreating(false), title: "Add to Catalogue", children: _jsx(CatalogueItemEditorView, { onSaved: () => { setCreating(false); invalidate(); } }) }), _jsx(SideDrawer, { isOpen: !!editingItem, onClose: () => setEditingId(null), title: "Edit Catalogue Item", children: editingItem && (_jsx(CatalogueItemEditorView, { item: editingItem, onSaved: () => { setEditingId(null); invalidate(); } })) })] }));
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Heading, { level: 2, children: "My Catalogue" }), _jsx(Button, { onClick: () => setCreating(true), children: "+ Add Item" })] }), _jsx(AdminComposableRegion, { pageId: "user-catalogue", initialCards: pageRegionCards }), isLoading ? (_jsx(Grid, { cols: 3, gap: "md", children: [1, 2, 3].map((n) => (_jsx(Skeleton, { variant: "rectangular", height: 220 }, n))) })) : items.length === 0 ? (_jsx(Text, { variant: "secondary", children: "Nothing in your catalogue yet." })) : (_jsx(Grid, { cols: 3, gap: "md", children: items.map((item) => (_jsxs(Div, { rounded: "xl", border: "default", padding: "md", surface: "card", children: [_jsx(MediaImage, { src: item.mainImage || item.images[0] || "", alt: item.title, size: "card" }), _jsxs(Stack, { gap: "xs", padding: "t-sm", children: [_jsx(Text, { weight: "medium", children: item.title }), _jsxs(Row, { gap: "sm", align: "center", children: [_jsx(Badge, { variant: STATUS_VARIANT[item.listingStatus], children: item.listingStatus.replace(/_/g, " ") }), _jsx(Badge, { variant: "secondary", children: item.visibility })] }), _jsxs(Row, { gap: "sm", wrap: true, children: [_jsx(Button, { size: "sm", variant: "ghost", onClick: () => setEditingId(item.id), children: "Edit" }), _jsx(Button, { size: "sm", variant: "ghost", onClick: () => toggleVisibilityMutation.mutate(item), children: item.visibility === "public" ? "Make private" : "Make public" }), item.listingStatus === "not_listed" && (canListDirectly ? (_jsx(Button, { size: "sm", isLoading: listMutation.isPending, onClick: () => listMutation.mutate(item.id), children: "List" })) : (_jsx(Button, { size: "sm", isLoading: submitMutation.isPending, onClick: () => submitMutation.mutate(item.id), children: "Request to sell" }))), item.listingStatus === "not_listed" && (_jsx(Button, { size: "sm", variant: "ghost", isLoading: deleteMutation.isPending, onClick: () => deleteMutation.mutate(item.id), children: "Delete" }))] })] })] }, item.id))) })), _jsx(SideDrawer, { isOpen: creating, onClose: () => setCreating(false), title: "Add to Catalogue", children: _jsx(CatalogueItemEditorView, { pageId: "user-catalogue-new", onSaved: () => { setCreating(false); invalidate(); } }) }), _jsx(SideDrawer, { isOpen: !!editingItem, onClose: () => setEditingId(null), title: "Edit Catalogue Item", children: editingItem && (_jsx(CatalogueItemEditorView, { pageId: "user-catalogue-id-edit", item: editingItem, onSaved: () => { setEditingId(null); invalidate(); } })) })] }));
 }