@mohasinac/appkit 4.70.0 → 4.71.2

package/dist/features/digital-codes/components/DigitalCodeDetailPageView.js

@@ -2,6 +2,8 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import Link from "next/link.js";
 import { OwnerQuickActions } from "../../../features/admin/components/OwnerQuickActions.js";
 import { getDigitalCodeForDetail } from "../../../_internal/server/features/digital-code/data.js";
+import { getFieldVisibility } from "../../../_internal/server/features/forms/field-visibility.js";
+import { SectionVisibilityGate } from "../../shell/SectionVisibilityGate.js";
 const CLS_BREADCRUMB_LINK = "hover:text-primary-600 dark:hover:text-primary-400 transition-colors";
 const CLS_DIGITALCODE_BADGE = "inline-block rounded-full bg-violet-100 dark:bg-violet-900/30 px-[var(--appkit-space-2-5)] py-[var(--appkit-space-0-5)] text-violet-700 dark:text-violet-300";
 import { ROUTES } from "../../../next/routing/route-map.js";
@@ -30,7 +32,8 @@ import { ReviewsListingPanel } from "../../reviews/components/ReviewsListingPane
 import { ListingBottomActions } from "../../products/components/ListingBottomActions.js";
 import { productImageUrls } from "../../products/schemas/firestore.js";
 import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
-export async function DigitalCodeDetailPageView({ slug, initialProduct, renderPrimaryActions }) {
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
+export async function DigitalCodeDetailPageView({ slug, initialProduct, renderPrimaryActions, pageRegionCards = [] }) {
     const product = initialProduct !== undefined
         ? (initialProduct ?? undefined)
         // The listing IS this page's subject — a read failure must surface rather
@@ -64,26 +67,39 @@ export async function DigitalCodeDetailPageView({ slug, initialProduct, renderPr
     const storeHref = storeSlug ? String(ROUTES.PUBLIC.STORE_DETAIL(storeSlug)) : null;
     const specs = Array.isArray(p.specifications) ? p.specifications : [];
     const descriptionHtml = toDescriptionHtml(p.description);
-    const [{ relatedItems, relatedByBrand, relatedByTags, relatedByStore }, groups, initialReviews] = await Promise.all([
+    const [{ relatedItems, relatedByBrand, relatedByTags, relatedByStore }, groups, initialReviews, pdpSectionVisibility] = await Promise.all([
         computeRelatedItems(product),
         getGroupsWithItemsForProduct(product.id),
         getReviewPageForProduct(product.id),
+        // Same shared "pdp-sections" surface as every other listing type's
+        // detail-page component — one admin decision applies across all of them.
+        getFieldVisibility("pdp-sections"),
     ]);
+    /*
+     * `functionalSlot` (2026-11-05) — same hoisting pattern as the standard
+     * PDP's `primaryActionsNode`. Simpler here: `renderPrimaryActions` is
+     * called exactly once (no separate mobile registration call), and the
+     * anchor `ListingBottomActions` depends on is a plain DOM `id`
+     * (`digital-code-buy-bar`), not `ctaAnchorProps()` — kept always mounted,
+     * only its children swap.
+     */
+    const primaryActionsNode = renderPrimaryActions?.({
+        productId: String(product.id),
+        productSlug: String(p.slug ?? product.id),
+        productTitle: title,
+        productImage: images[0],
+        price,
+        currency,
+        storeId: typeof p.storeId === "string" ? p.storeId : undefined,
+        storeName: storeName ?? undefined,
+        inStock: codesLeft > 0,
+    });
+    const hasPrimaryActionsSlotOverride = pageRegionCards.some((card) => card.elements.some((el) => el.kind === "functionalSlot" && el.slotId === "pdp-primary-actions"));
     return (_jsxs(Main, { children: [_jsx(HistoryTracker, { productId: String(p.id ?? p.slug ?? ""), productType: "product", snapshot: {
                     title,
                     thumb: images[0],
                     price: price ?? undefined,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: storeName ?? undefined,
-                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.DIGITAL_CODES), className: CLS_BREADCRUMB_LINK, children: "Digital Codes" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => _jsx(ProductGalleryClient, { images: images, productName: title }), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_DIGITALCODE_BADGE, children: "Digital Code" }), codesLeft > 0 ? (_jsxs(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: [codesLeft, " available"] })) : (_jsx(Span, { size: "xs", weight: "semibold", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "danger-surface", color: "error", children: "Sold out" }))] }), _jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(p.title ?? p.slug ?? p.id), storeId: p.storeId ? String(p.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(p.id))) }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) })), meta?.redemptionInstructions && (_jsx(Text, { size: "xs", color: "muted", children: meta.redemptionInstructions })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, reviewsContent: _jsx(ReviewsListingPanel, { source: { kind: "product", productId: product.id }, stateMode: "local", context: "listing", initialData: initialReviews, emptyLabel: "No reviews yet \u2014 be the first to review this product." }), customTabs: toCustomSectionTabs(p.customSections) })), renderBuyBar: () => (_jsx(Div, { id: "digital-code-buy-bar", children: renderPrimaryActions?.({
-                                productId: String(product.id),
-                                productSlug: String(p.slug ?? product.id),
-                                productTitle: title,
-                                productImage: images[0],
-                                price,
-                                currency,
-                                storeId: typeof p.storeId === "string" ? p.storeId : undefined,
-                                storeName: storeName ?? undefined,
-                                inStock: codesLeft > 0,
-                            }) })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(PurchaseReviewAffordance, { productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined }), _jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand, storeLabel: storeName ?? undefined })] })) }), _jsx(ListingBottomActions, { listingType: "digital-code", anchorId: "digital-code-buy-bar", price: price, currency: currency, unavailable: codesLeft <= 0 })] })] }));
+                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.DIGITAL_CODES), className: CLS_BREADCRUMB_LINK, children: "Digital Codes" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "gallery", initialVisible: pdpSectionVisibility.gallery !== false, children: _jsx(ProductGalleryClient, { images: images, productName: title }) })), renderInfo: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "info", initialVisible: pdpSectionVisibility.info !== false, children: _jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_DIGITALCODE_BADGE, children: "Digital Code" }), codesLeft > 0 ? (_jsxs(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: [codesLeft, " available"] })) : (_jsx(Span, { size: "xs", weight: "semibold", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "danger-surface", color: "error", children: "Sold out" }))] }), _jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(p.title ?? p.slug ?? p.id), storeId: p.storeId ? String(p.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(p.id))) }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) })), meta?.redemptionInstructions && (_jsx(Text, { size: "xs", color: "muted", children: meta.redemptionInstructions })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] }) })), renderTabs: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "tabs", initialVisible: pdpSectionVisibility.tabs !== false, children: _jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(SpecTable, { rows: specs })) : undefined, reviewsContent: _jsx(ReviewsListingPanel, { source: { kind: "product", productId: product.id }, stateMode: "local", context: "listing", initialData: initialReviews, emptyLabel: "No reviews yet \u2014 be the first to review this product." }), customTabs: toCustomSectionTabs(p.customSections) }) })), renderBuyBar: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "actions", initialVisible: pdpSectionVisibility.actions !== false, children: _jsx(Div, { id: "digital-code-buy-bar", children: !hasPrimaryActionsSlotOverride && primaryActionsNode }) })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(PurchaseReviewAffordance, { productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined }), _jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "grouped-listings", initialVisible: pdpSectionVisibility["grouped-listings"] !== false, children: _jsx(GroupedListingsCarousel, { groups: groups }) }), _jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "related", initialVisible: pdpSectionVisibility.related !== false, children: _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand, storeLabel: storeName ?? undefined }) })] })) }), _jsx(Div, { className: "mt-8", children: _jsx(AdminComposableRegion, { pageId: "digital-codes-slug", initialCards: pageRegionCards, functionalSlots: { "pdp-primary-actions": primaryActionsNode } }) }), _jsx(ListingBottomActions, { listingType: "digital-code", anchorId: "digital-code-buy-bar", price: price, currency: currency, unavailable: codesLeft <= 0 })] })] }));
 }

package/dist/features/email/notification-templates.js

@@ -31,11 +31,10 @@ import { EmailBold, EmailButton, EmailContainer, EmailDivider, EmailDoc, EmailFo
  *    inline-styled markup email clients actually render; hand-rolled markup
  *    is what `audit-email-raw-html` blocks.
  */
-// See constraint (1) above — this MUST stay a lazy require.
-function renderToStaticMarkup(el) {
-    const m = require("react-dom/server");
-    return m.renderToStaticMarkup(el);
-}
+// See constraint (1) above. The lazy require now lives in ONE place —
+// `render-static-markup.ts` — because two more call sites needed it and a third
+// identical copy would trip `audit-duplicate-helpers`.
+import { renderStaticMarkup as renderToStaticMarkup } from "./render-static-markup.js";
 /**
  * 🛑 Every notification type, no exceptions.
  *
@@ -55,9 +54,9 @@ export const NOTIFICATION_EMAIL_TEMPLATES = {
     emi_installment_overdue: { lead: "An EMI installment is overdue.", cta: "View order", tone: "danger" },
     bid_placed: { lead: "Your bid has been placed.", cta: "View bids" },
     bid_outbid: { lead: "Someone has outbid you.", cta: "View bids", tone: "danger" },
-    bid_won: { lead: "You won the auction.", cta: "Complete checkout", tone: "success" },
-    bid_lost: { lead: "This auction closed without you.", cta: "View bids" },
-    auction_ended: { lead: "Your auction has ended.", cta: "View auction" },
+    bid_won: { lead: "You won the collector drop.", cta: "Complete checkout", tone: "success" },
+    bid_lost: { lead: "This collector drop closed without you.", cta: "View bids" },
+    collector_drop_ended: { lead: "Your collector drop has ended.", cta: "View collector drop" },
     offer_received: { lead: "A buyer has made you an offer.", cta: "Review offer" },
     offer_responded: { lead: "The seller has responded to your offer.", cta: "View offer" },
     offer_counter_accepted: { lead: "Your counter-offer was accepted.", cta: "Complete checkout", tone: "success" },

package/dist/features/email/render-static-markup.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `renderToStaticMarkup`, behind a lazy `require` — the ONE definition.
+ *
+ * ## Why this is not a plain import
+ *
+ * A top-level `import { renderToStaticMarkup } from "react-dom/server"` is
+ * flagged by Next's static tracer the moment any module in the re-export chain
+ * is reachable from a Server Component — and these are, via
+ * `@mohasinac/appkit/server` → `providers.config.ts` → `src/app/layout.tsx`:
+ *
+ *   Error: You're importing a component that imports react-dom/server.
+ *
+ * `require()` is opaque to that analyser, so the chain stops here. The
+ * specifier MUST stay BARE: a relative one resolves against the emitted chunk
+ * and fails only in production (Root Cause #86).
+ *
+ * ## 🛑 Why it is a module rather than a local helper per file
+ *
+ * It was a local copy in `features/contact/email.tsx` and
+ * `features/email/notification-templates.tsx`, which worked — but
+ * `courier-block` and `dailyStatusDigest` imported `react-dom/server` DIRECTLY
+ * and broke `next build` outright. Giving each of those a fourth and fifth copy
+ * of the shim would have traded a build error for an `audit-duplicate-helpers`
+ * failure, which fires at THREE byte-identical top-level bodies. One definition
+ * is the only answer that satisfies both.
+ *
+ * 🛑 The build error was INVISIBLE on the registry pin, because a package in
+ * `node_modules` is not traversed as first-party source. It surfaced only when
+ * the consumer was switched to `file:./appkit`. So "it builds" was a property
+ * of where appkit was installed, not of appkit being correct — which matters
+ * for Tier AK, where the whole point is that appkit must stand on its own.
+ */
+import type { ReactElement } from "react";
+export declare function renderStaticMarkup(el: ReactElement): string;

package/dist/features/email/render-static-markup.js

@@ -0,0 +1,4 @@
+export function renderStaticMarkup(el) {
+    const m = require("react-dom/server");
+    return m.renderToStaticMarkup(el);
+}

package/dist/features/events/actions/event-actions.d.ts

@@ -4,8 +4,8 @@
  * Business logic for event CRUD, status changes, entries, and public access.
  * Auth, rate-limiting, and input validation are handled by the calling server action.
  */
-import type { JsonValue } from "@mohasinac/appkit";
-import type { EventDocument, EventEntryDocument } from "../schemas";
+import type { JsonValue } from "../../../schemas/types";
+import type { EventDocument, EventEntryDocument, EventEntryMedia } from "../schemas";
 import type { EventStatus } from "../types";
 import type { FirebaseSieveResult } from "../../../providers/db-firebase";
 export interface CreateEventInput {
@@ -52,6 +52,14 @@ export interface EnterEventInput {
     pollVotes?: string[];
     pollComment?: string;
     formResponses?: Record<string, JsonValue>;
+    /**
+     * CONTEST entries — validated at the route, where the three limits that only
+     * make sense together live (at least one image, at most four items, at most
+     * one video). Carried through here unchanged.
+     */
+    media?: EventEntryMedia[];
+    /** Optional ≤100-word paragraph explaining the entry. */
+    note?: string;
 }
 export declare function createEvent(adminId: string, input: CreateEventInput): Promise<EventDocument>;
 export declare function updateEvent(adminId: string, id: string, input: UpdateEventInput): Promise<EventDocument>;
@@ -94,7 +102,7 @@ export declare function getPublicEventById(id: string): Promise<EventDocument |
 export declare function getEventLeaderboard(eventId: string): Promise<import("../types").LeaderboardEntry[]>;
 /**
  * Last N spins that actually won a prize, most recent first — powers the
- * public "Last 10 Spin Results" tab on spin_wheel events. Joins each entry's
+ * public "Last 10 Spin Results" tab on `bonus-spin` events. Joins each entry's
  * `spinPrizeId` against the event's `spinPrizes` config for a human label
  * (the entries repository has no access to the events collection, mirroring
  * `getEventPollResults`' join pattern above) and marks guest spins so the

package/dist/features/events/actions/event-actions.js

@@ -4,8 +4,8 @@
  * Business logic for event CRUD, status changes, entries, and public access.
  * Auth, rate-limiting, and input validation are handled by the calling server action.
  */
-import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
-import { sortBy } from "@mohasinac/appkit";
+import { SIEVE_OP, sieveFilter } from "../../../utils/sieve-builder.js";
+import { sortBy } from "../../../constants/sort.js";
 import { serverLogger } from "../../../monitoring/index.js";
 import { eventRepository } from "../repository/events.repository.js";
 import { eventEntryRepository } from "../repository/event-entry.repository.js";
@@ -16,6 +16,7 @@ import { RAFFLE_MAX_ENTRIES_PER_USER } from "../../../_internal/shared/features/
 const ERR_EVENT_NOT_FOUND = "Event not found";
 import { coerceMediaField, getMediaUrl } from "../../../utils/index.js";
 import { finalizeStagedMediaField, finalizeStagedMediaObject, finalizeStagedMediaObjectArray, } from "../../media/finalize.js";
+import { normalizeEventType } from "../types/index.js";
 import { hidePublicTestData } from "../../../_internal/server/features/tester/visibility.js";
 import { sortPinnedFirst } from "../utils/sort-pinned.js";
 // --- Admin: Create Event --------------------------------------------------
@@ -184,7 +185,7 @@ export async function getEventLeaderboard(eventId) {
 }
 /**
  * Last N spins that actually won a prize, most recent first — powers the
- * public "Last 10 Spin Results" tab on spin_wheel events. Joins each entry's
+ * public "Last 10 Spin Results" tab on `bonus-spin` events. Joins each entry's
  * `spinPrizeId` against the event's `spinPrizes` config for a human label
  * (the entries repository has no access to the events collection, mirroring
  * `getEventPollResults`' join pattern above) and marks guest spins so the
@@ -192,7 +193,8 @@ export async function getEventLeaderboard(eventId) {
  */
 export async function getEventSpinResults(eventId, limit = 10) {
     const event = await eventRepository.findByIdOrSlug(eventId);
-    if (!event || event.type !== "spin_wheel")
+    // 🛑 `normalizeEventType`: pre-2026-10-31 documents still hold `spin_wheel`.
+    if (!event || normalizeEventType(event.type) !== "bonus-spin")
         return [];
     const prizeTitleById = new Map((event.spinPrizes ?? []).map((p) => [p.id, p.label]));
     const entries = await eventEntryRepository.getRecentSpinResults(event.id, limit);
@@ -248,7 +250,8 @@ export async function getEventSpinResults(eventId, limit = 10) {
  */
 export async function getUserSpinResultsForEvent(eventId, userId) {
     const event = await eventRepository.findByIdOrSlug(eventId);
-    if (!event || event.type !== "spin_wheel")
+    // 🛑 `normalizeEventType`: pre-2026-10-31 documents still hold `spin_wheel`.
+    if (!event || normalizeEventType(event.type) !== "bonus-spin")
         return [];
     const prizeTitleById = new Map((event.spinPrizes ?? []).map((p) => [p.id, p.label]));
     const entries = await eventEntryRepository.getUserSpinResults(event.id, userId);
@@ -373,13 +376,18 @@ export async function enterEvent(eventId, input, user, request) {
     // `allowGuestParticipation` override is applied. Anonymous feedback is a
     // distinct opt-in concept (the event itself declares no identity is ever
     // collected) so it stays open regardless of the guest-participation flag.
+    // 🛑 Resolved through `normalizeEventType` ONCE for this whole function:
+    // pre-2026-10-31 documents still hold `raffle`/`spin_wheel`, and a bare
+    // equality here would hand every one of them FREE GUEST ACCESS — the exact
+    // hole the per-type list had before the flag was introduced.
+    const eventType = normalizeEventType(event.type);
     const perTypeRequiresLogin = event.type === "poll" ||
         event.type === "survey" ||
         (event.type === "feedback" && !event.feedbackConfig?.anonymous) ||
-        event.type === "raffle" ||
-        event.type === "spin_wheel";
+        eventType === "giveaway" ||
+        eventType === "bonus-spin";
     // Every event type that reaches enterEvent() is now gated by the single
-    // admin-controlled flag — raffle/spin_wheel no longer get accidental free
+    // admin-controlled flag — giveaway/bonus-spin no longer get accidental free
     // guest access just because they were absent from the old per-type list.
     const requiresLogin = !event.allowGuestParticipation && perTypeRequiresLogin;
     if (requiresLogin && !user) {
@@ -446,7 +454,7 @@ export async function enterEvent(eventId, input, user, request) {
      * duplicate entry is a direct and quantifiable unfairness, had none. The
      * client-side guard was inert in two independent ways: `submissionCount` is
      * `useState(0)` that is never hydrated from the server, so a reload resets
-     * it; and `maxEntriesPerUser` was not passed to `EventRaffleEntryForm` at
+     * it; and `maxEntriesPerUser` was not passed to `EventGiveawayEntryForm` at
      * all, so it defaulted to 1 while nothing enforced it.
      *
      * The limit is `RAFFLE_MAX_ENTRIES_PER_USER`, shared with the form that
@@ -457,7 +465,7 @@ export async function enterEvent(eventId, input, user, request) {
      * Reuses the same `countUserEntries` as the survey and poll paths, so the
      * read cost and the `(eventId, userId)` index it needs are already proven.
      */
-    if (user && event.type === "raffle") {
+    if (user && eventType === "giveaway") {
         const priorEntries = await eventEntryRepository.countUserEntries(resolvedEventId, user.uid);
         if (priorEntries >= RAFFLE_MAX_ENTRIES_PER_USER) {
             throw new ValidationError(ERROR_MESSAGES.EVENT.ALREADY_ENTERED);
@@ -504,7 +512,7 @@ export async function enterEvent(eventId, input, user, request) {
      */
     const autoApprove = event.type === "poll" ||
         event.type === "feedback" ||
-        event.type === "raffle" ||
+        eventType === "giveaway" ||
         (event.type === "survey" &&
             !event.surveyConfig?.entryReviewRequired);
     const reviewStatus = autoApprove ? "approved" : "pending";
@@ -517,6 +525,8 @@ export async function enterEvent(eventId, input, user, request) {
         pollVotes: input.pollVotes,
         pollComment: input.pollComment,
         formResponses: input.formResponses,
+        media: input.media,
+        note: input.note,
         reviewStatus,
     });
     await eventRepository.incrementTotalEntries(resolvedEventId);

package/dist/features/events/api/[id]/route.js

@@ -36,7 +36,7 @@ export async function GET(_request, context) {
         }
         // 🛑 Do not hand-roll this projection here. `toPublicEvent` drops
         // `createdBy` AND allow-lists the two nested structures that decide
-        // outcomes — `lotteryConfig.slots[]` (price / weight / bookedByUserId) and
+        // outcomes — `giveawayConfig.slots[]` (price / weight / bookedByUserId) and
         // `spinPrizes[]` (weight / couponId). Both were published to anonymous
         // callers by the deny-list spread that used to live here.
         const publicEvent = toPublicEvent(event);

package/dist/features/events/components/AdminEventEditorView.d.ts

@@ -1,11 +1,16 @@
 import React from "react";
 import type { StackedViewShellProps } from "../../../ui/components/StackedViewShell";
 import type { EventType } from "../types";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface AdminEventEditorViewProps extends Omit<StackedViewShellProps, "sections"> {
     eventId?: string;
+    /** Page-region id for this screen (Phase 12) — required because this View is mounted from two different routes (new vs edit), each with its own id. */
+    pageId: string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
     onSaved?: (id: string) => void;
     embedded?: boolean;
     /** When provided, restricts the event type dropdown to these values only. */
     allowedTypes?: EventType[];
 }
-export declare function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes, ...rest }: AdminEventEditorViewProps): React.JSX.Element;
+export declare function AdminEventEditorView({ eventId, pageId, pageRegionCards, onSaved, embedded, allowedTypes, ...rest }: AdminEventEditorViewProps): React.JSX.Element;

package/dist/features/events/components/AdminEventEditorView.js

@@ -29,6 +29,7 @@ import { SectionForm, useSectionFormNav } from "../../shell/SectionForm.js";
 import { eventDraftSchema } from "../schemas/event-form.js";
 import { ProductInlineSelect } from "../../seller/components/ProductInlineSelect.js";
 import { CouponInlineSelect } from "../../seller/components/CouponInlineSelect.js";
+import { AdminComposableRegion } from "../../dashboard/components/AdminComposableRegion.js";
 // Covers the cross-type required fields plus the two conditional rules the
 // "Settings" step already hand-enforces (offer coupon/code, poll min-2
 // options) — mirrored here as Zod so they're also live/summary-visible, not
@@ -51,10 +52,10 @@ const CLS_RAFFLE_BODY = "text-warning dark:text-warning";
 /*
  * DERIVED. This was a hand-written 7-entry array and `EVENT_TYPE_LABELS`
  * — a `Record<EventType, string>` sitting one import away — already held the
- * same labels for all 8. It was missing `lottery`, and `allowedTypes` filters
- * AGAINST this list, so passing `"lottery"` in still could not surface it:
- * lottery events had no create path in the UI at all and could only come from
- * `npm run seed`.
+ * same labels for all 8. It was missing the random-draw type, and
+ * `allowedTypes` filters AGAINST this list, so passing it in still could not
+ * surface it: random-draw events had no create path in the UI at all and could
+ * only come from `npm run seed`.
  *
  * Deriving from the Record means a new EventType cannot be omitted here
  * without failing to compile (Root Cause #61).
@@ -63,8 +64,13 @@ const EVENT_TYPE_OPTIONS = ALL_EVENT_TYPES.map((value) => ({
     value,
     label: EVENT_TYPE_LABELS[value],
 }));
+/**
+ * 🛑 `RaffleType` — the draw MECHANISM. Deliberately NOT renamed with the
+ * `EventType` union on 2026-10-31; `spin_wheel` here is a persisted
+ * `raffleType` value, not the event type that became `bonus-spin`.
+ */
 const RAFFLE_TYPE_OPTIONS = [
-    { label: "Open raffle (all confirmed entries)", value: "open_raffle" },
+    { label: "Open draw (all confirmed entries)", value: "open_raffle" },
     { label: "Top N scorers", value: "top_n_scorers" },
     { label: "Top N earliest participants", value: "top_n_participants" },
     { label: "Spin wheel", value: "spin_wheel" },
@@ -149,6 +155,13 @@ const DEFAULT_DRAFT = {
     createdBy: "",
     allowGuestParticipation: false,
     isPinned: false,
+    showOnCarousel: false,
+    carouselEyebrow: "",
+    carouselTitle: "",
+    carouselDescription: "",
+    carouselButtonText: "",
+    carouselBackgroundMediaSlug: "",
+    carouselOrder: "",
     couponIds: [],
     discountPercent: "10",
     saleBannerText: "",
@@ -193,13 +206,43 @@ function buildEventTypeConfig(draft) {
         return { feedbackConfig: { anonymous: draft.anonymous, formFields: draft.feedbackFields.map((f, i) => ({ ...f, order: i })) } };
     return {};
 }
+/**
+ * `showOnCarousel` is the publish decision and is always sent, so turning it
+ * OFF actually unpublishes — merge-write semantics mean an omitted key just
+ * leaves the stored value in place. `carouselConfig` is sent only while
+ * publishing is on; the admin UI only ever authors `placement: "overlay"`
+ * (one event, full hero) — `"cards"` stays a schema capability with no
+ * authoring surface here, per CLAUDE.md "Homepage Hero Carousel".
+ */
+function buildCarouselFields(draft) {
+    const fields = { showOnCarousel: draft.showOnCarousel };
+    if (!draft.showOnCarousel)
+        return fields;
+    const order = Number(draft.carouselOrder);
+    fields.carouselConfig = {
+        placement: "overlay",
+        eyebrow: draft.carouselEyebrow.trim() || undefined,
+        title: draft.carouselTitle.trim(),
+        description: draft.carouselDescription.trim() || undefined,
+        buttonText: draft.carouselButtonText.trim() || undefined,
+        backgroundMediaSlug: draft.carouselBackgroundMediaSlug.trim() || undefined,
+        order: Number.isFinite(order) && draft.carouselOrder.trim() !== "" ? order : undefined,
+    };
+    return fields;
+}
 function buildEventRaffleFields(draft) {
-    const isRaffleType = draft.type === "raffle" || draft.type === "spin_wheel";
+    // 🛑 TWO AXES, one word. `draft.type` is an `EventType` and was renamed on
+    // 2026-10-31 (`raffle` -> `giveaway`, `spin_wheel` -> `bonus-spin`).
+    // `raffleType` is a `RaffleType` — the draw MECHANISM — and its
+    // `"spin_wheel"` member was deliberately NOT renamed. So the CONDITION
+    // below reads the new spelling while the VALUE it assigns keeps the old one;
+    // that asymmetry is correct, not a missed replacement.
+    const isRaffleType = draft.type === "giveaway" || draft.type === "bonus-spin";
     const fields = {};
     if (!draft.hasRaffle && !isRaffleType)
         return fields;
     fields.hasRaffle = true;
-    fields.raffleType = isRaffleType && draft.type === "spin_wheel" ? "spin_wheel" : draft.raffleType;
+    fields.raffleType = isRaffleType && draft.type === "bonus-spin" ? "spin_wheel" : draft.raffleType;
     if (Number(draft.raffleTopN) > 0)
         fields.raffleTopN = Number(draft.raffleTopN);
     if (draft.rafflePrize)
@@ -227,7 +270,8 @@ function buildEventRaffleFields(draft) {
     fields.rafflePrizeCouponIds = draft.rafflePrizeCouponIds;
     if (draft.rafflePrizeProductIds.length > 0)
         fields.rafflePrizeProductIds = draft.rafflePrizeProductIds;
-    if (draft.raffleType === "spin_wheel" || draft.type === "spin_wheel") {
+    // `draft.raffleType` = RaffleType (NOT renamed) · `draft.type` = EventType.
+    if (draft.raffleType === "spin_wheel" || draft.type === "bonus-spin") {
         fields.spinPrizes = draft.spinPrizes;
         if (Number(draft.spinMaxPerUser) > 0)
             fields.spinMaxPerUser = Number(draft.spinMaxPerUser);
@@ -295,6 +339,16 @@ function eventToDraft(event) {
         // the toggle as off rather than leaving it `undefined`, which React
         // would read as an uncontrolled input.
         isPinned: Boolean(event.isPinned),
+        // `??`, not `||` — a deliberate `showOnCarousel: false` on an event
+        // whose legacy `carouselConfig.active` is still `true` must mean OFF.
+        // See `isPublishedToCarousel` in events/utils/carousel-slide.ts.
+        showOnCarousel: Boolean(event.showOnCarousel ?? event.carouselConfig?.active),
+        carouselEyebrow: event.carouselConfig?.eyebrow || "",
+        carouselTitle: event.carouselConfig?.title || "",
+        carouselDescription: event.carouselConfig?.description || "",
+        carouselButtonText: event.carouselConfig?.buttonText || "",
+        carouselBackgroundMediaSlug: event.carouselConfig?.backgroundMediaSlug || "",
+        carouselOrder: event.carouselConfig?.order != null ? String(event.carouselConfig.order) : "",
         couponIds: Array.isArray(event.couponIds) ? event.couponIds : [],
         discountPercent: String(event.saleConfig?.discountPercent ?? 10),
         saleBannerText: event.saleConfig?.bannerText || "",
@@ -335,7 +389,7 @@ function eventToDraft(event) {
         spinWindowEnd: toLocalDatetime(event.spinWindowEnd),
     };
 }
-export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes, ...rest }) {
+export function AdminEventEditorView({ eventId, pageId, pageRegionCards = [], onSaved, embedded, allowedTypes, ...rest }) {
     const isEdit = Boolean(eventId);
     const [draft, setDraft] = React.useState(DEFAULT_DRAFT);
     const [slugManual, setSlugManual] = React.useState(false);
@@ -343,7 +397,7 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
     const [triggerMessage, setTriggerMessage] = React.useState(null);
     // Root translator (no namespace) — `toUserMessage` passes fully-qualified
     // `errors.codes.*` keys and resolves them itself. Same precedent as
-    // `PlaceBidFormClient` and `SpinWheelView`.
+    // `PlaceBidFormClient` and `BonusSpinView`.
     const t = useTranslations();
     const [raffleWinnerName, setRaffleWinnerName] = React.useState("");
     const [raffleEntryCount, setRaffleEntryCount] = React.useState(null);
@@ -399,6 +453,7 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
                 couponIds: draft.couponIds,
                 ...buildEventTypeConfig(draft),
                 ...buildEventRaffleFields(draft),
+                ...buildCarouselFields(draft),
             };
             if (eventId) {
                 payload.status = draft.status;
@@ -421,16 +476,16 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
             setSaveMessage(error instanceof Error ? error.message : "Save failed");
         },
     });
-    // --- raffle trigger ---
-    const triggerRaffleMutation = useApiMutation({
+    // --- giveaway draw trigger ---
+    const triggerGiveawayMutation = useApiMutation({
         mutationFn: async () => {
             if (!eventId)
                 throw new Error("Save the event before triggering");
-            return apiClient.post(ADMIN_ENDPOINTS.EVENT_TRIGGER_RAFFLE(eventId), {});
+            return apiClient.post(ADMIN_ENDPOINTS.EVENT_TRIGGER_GIVEAWAY(eventId), {});
         },
         onSuccess: (res) => {
             const data = res.data ?? res;
-            setTriggerMessage(data?.raffleWinnerDisplayName ? `Winner: ${data.raffleWinnerDisplayName}` : "Raffle triggered.");
+            setTriggerMessage(data?.raffleWinnerDisplayName ? `Winner: ${data.raffleWinnerDisplayName}` : "Giveaway draw triggered.");
             if (data?.raffleWinnerDisplayName)
                 setRaffleWinnerName(data.raffleWinnerDisplayName);
             if (typeof data?.raffleEntryCount === "number")
@@ -490,23 +545,25 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
         {
             id: "settings",
             label: "Settings",
-            fields: ["status", "allowGuestParticipation", "isPinned", "couponIds", "discountPercent", "saleBannerText", "couponId", "displayCode", "offerBannerText", "pollOptions", "resultsVisibility", "allowMultiSelect", "allowComment", "maxEntriesPerUser", "hasLeaderboard", "hasPointSystem", "pointsLabel", "entryReviewRequired", "surveyFields", "anonymous", "feedbackFields"],
+            fields: ["status", "allowGuestParticipation", "isPinned", "showOnCarousel", "carouselEyebrow", "carouselTitle", "carouselDescription", "carouselButtonText", "carouselBackgroundMediaSlug", "carouselOrder", "couponIds", "discountPercent", "saleBannerText", "couponId", "displayCode", "offerBannerText", "pollOptions", "resultsVisibility", "allowMultiSelect", "allowComment", "maxEntriesPerUser", "hasLeaderboard", "hasPointSystem", "pointsLabel", "entryReviewRequired", "surveyFields", "anonymous", "feedbackFields"],
             // Same: the offer-coupon, offer-display-code and poll-minimum-options
             // rules are all stated in eventDraftSchema's superRefine, which now
             // surfaces them inline on the field instead of as a step-blocking banner.
-            render: ({ values, onChange, errors }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Event Settings" }), isEdit && (_jsx(Select, { label: "Status", error: errors.status, value: values.status, options: EVENT_STATUS_OPTIONS, onChange: (e) => onChange({ status: e.target.value }) })), values.createdBy && (_jsxs(Stack, { gap: "none", children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Created by" }), _jsx(Text, { size: "sm", color: "muted", children: values.createdBy })] })), _jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Toggle, { checked: values.allowGuestParticipation, onChange: (v) => onChange({ allowGuestParticipation: v }), label: "Allow guest participation (no login required)" }), _jsx(Text, { size: "xs", color: "muted", children: "When enabled, unauthenticated visitors can participate in this event (poll vote, survey/feedback response, raffle entry, or wheel spin), identified by a hashed IP address instead of an account. Applies uniformly to whatever entry mechanism this event type uses." })] }), _jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Toggle, { checked: values.isPinned, onChange: (v) => onChange({ isPinned: v }), label: "Pin to the top of Events" }), _jsx(Text, { size: "xs", color: "muted", children: "Pinned events are listed first on the Events page and in the homepage strip, ahead of the usual soonest-first order. A pinned event still has to be Active to appear at all \u2014 pinning does not publish it." })] }), _jsx(PromotionalCouponsField, { values: values, onChange: onChange }), values.type === "sale" && (_jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Sale configuration" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Discount %", error: errors.discountPercent, type: "number", value: values.discountPercent, onChange: (e) => onChange({ discountPercent: e.target.value }), placeholder: "10" }), _jsx(Input, { label: "Banner text (optional)", value: values.saleBannerText, error: errors.saleBannerText, onChange: (e) => onChange({ saleBannerText: e.target.value }), placeholder: "Limited time \u2014 ends Sunday!" })] })] })), values.type === "offer" && (_jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Offer configuration" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Coupon" }), _jsx(CouponInlineSelect, { scope: "admin", value: values.couponId, onChange: (id) => onChange({ couponId: id ?? "" }), placeholder: "Search coupons\u2026", allowCreate: false })] }), _jsx(Input, { label: "Display code", error: errors.displayCode, value: values.displayCode, onChange: (e) => onChange({ displayCode: e.target.value }), placeholder: "CHARIZARD25", required: true })] }), _jsx(Input, { label: "Banner text (optional)", value: values.offerBannerText, error: errors.offerBannerText, onChange: (e) => onChange({ offerBannerText: e.target.value }), placeholder: "Use CHARIZARD25 at checkout" })] })), values.type === "poll" && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Poll configuration" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", color: "muted", children: "Options (minimum 2)" }), values.pollOptions.map((opt, idx) => (_jsxs(Row, { gap: "xs", children: [_jsx(Div, { className: "flex-1", children: _jsx(Input, { value: opt.label, 
+            render: ({ values, onChange, errors }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Event Settings" }), isEdit && (_jsx(Select, { label: "Status", error: errors.status, value: values.status, options: EVENT_STATUS_OPTIONS, onChange: (e) => onChange({ status: e.target.value }) })), values.createdBy && (_jsxs(Stack, { gap: "none", children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Created by" }), _jsx(Text, { size: "sm", color: "muted", children: values.createdBy })] })), _jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Toggle, { checked: values.allowGuestParticipation, onChange: (v) => onChange({ allowGuestParticipation: v }), label: "Allow guest participation (no login required)" }), _jsx(Text, { size: "xs", color: "muted", children: "When enabled, unauthenticated visitors can participate in this event (poll vote, survey/feedback response, raffle entry, or wheel spin), identified by a hashed IP address instead of an account. Applies uniformly to whatever entry mechanism this event type uses." })] }), _jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Toggle, { checked: values.isPinned, onChange: (v) => onChange({ isPinned: v }), label: "Pin to the top of Events" }), _jsx(Text, { size: "xs", color: "muted", children: "Pinned events are listed first on the Events page and in the homepage strip, ahead of the usual soonest-first order. A pinned event still has to be Active to appear at all \u2014 pinning does not publish it." })] }), _jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Toggle, { checked: values.showOnCarousel, onChange: (v) => onChange({ showOnCarousel: v }), label: "Show on homepage carousel" }), _jsx(Text, { size: "xs", color: "muted", children: "Publishes this event as one slide on the homepage hero carousel \u2014 a full-bleed photo with the headline and button below. One event, one slide; at most 5 events show at once." }), values.showOnCarousel && (_jsxs(Stack, { gap: "sm", className: "mt-2", children: [_jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Eyebrow (optional)", value: values.carouselEyebrow, onChange: (e) => onChange({ carouselEyebrow: e.target.value }), placeholder: "Ends this weekend" }), _jsx(Input, { label: "Slide order", type: "number", value: values.carouselOrder, onChange: (e) => onChange({ carouselOrder: e.target.value }), placeholder: "Lower shows first" })] }), _jsx(Input, { label: "Headline", value: values.carouselTitle, onChange: (e) => onChange({ carouselTitle: e.target.value }), placeholder: "Short \u2014 renders up to 6rem wide", required: true }), _jsx(Textarea, { label: "Description (optional)", value: values.carouselDescription, onChange: (e) => onChange({ carouselDescription: e.target.value }), rows: 2 }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Button text (optional)", value: values.carouselButtonText, onChange: (e) => onChange({ carouselButtonText: e.target.value }), placeholder: "See the offer" }), _jsx(Input, { label: "Hero background image slug (optional)", value: values.carouselBackgroundMediaSlug, onChange: (e) => onChange({ carouselBackgroundMediaSlug: e.target.value }), helperText: "Falls back to the event's cover image when empty \u2014 a dedicated hero crop (1920\u00D7860) is sharper than an upscaled cover (1200\u00D7600)." })] })] }))] }), _jsx(PromotionalCouponsField, { values: values, onChange: onChange }), values.type === "sale" && (_jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Sale configuration" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Discount %", error: errors.discountPercent, type: "number", value: values.discountPercent, onChange: (e) => onChange({ discountPercent: e.target.value }), placeholder: "10" }), _jsx(Input, { label: "Banner text (optional)", value: values.saleBannerText, error: errors.saleBannerText, onChange: (e) => onChange({ saleBannerText: e.target.value }), placeholder: "Limited time \u2014 ends Sunday!" })] })] })), values.type === "offer" && (_jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Offer configuration" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Coupon" }), _jsx(CouponInlineSelect, { scope: "admin", value: values.couponId, onChange: (id) => onChange({ couponId: id ?? "" }), placeholder: "Search coupons\u2026", allowCreate: false })] }), _jsx(Input, { label: "Display code", error: errors.displayCode, value: values.displayCode, onChange: (e) => onChange({ displayCode: e.target.value }), placeholder: "CHARIZARD25", required: true })] }), _jsx(Input, { label: "Banner text (optional)", value: values.offerBannerText, error: errors.offerBannerText, onChange: (e) => onChange({ offerBannerText: e.target.value }), placeholder: "Use CHARIZARD25 at checkout" })] })), values.type === "poll" && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Poll configuration" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", color: "muted", children: "Options (minimum 2)" }), values.pollOptions.map((opt, idx) => (_jsxs(Row, { gap: "xs", children: [_jsx(Div, { className: "flex-1", children: _jsx(Input, { value: opt.label, 
                                                     /* Indexed: a failure on option 2 arrives as `pollOptions.1.label`. */
                                                     error: errors[`pollOptions.${idx}.label`], onChange: (e) => onChange({ pollOptions: values.pollOptions.map((o) => o.id === opt.id ? { ...o, label: e.target.value } : o) }), placeholder: `Option ${idx + 1}` }) }), values.pollOptions.length > 2 && (_jsx(Button, { variant: "ghost", type: "button", onClick: () => onChange({ pollOptions: values.pollOptions.filter((o) => o.id !== opt.id) }), className: CLS_REMOVE_BTN_PX2, "aria-label": "Remove option", children: "\u00D7" }))] }, opt.id))), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onChange({ pollOptions: [...values.pollOptions, { id: `opt${Date.now()}`, label: "" }] }), children: "+ Add option" })] }), _jsx(Select, { label: "Results visibility", error: errors.resultsVisibility, value: values.resultsVisibility, options: POLL_VISIBILITY_OPTIONS, onChange: (e) => onChange({ resultsVisibility: e.target.value }) }), _jsxs(Stack, { gap: "sm", children: [_jsx(Toggle, { checked: values.allowMultiSelect, onChange: (v) => onChange({ allowMultiSelect: v }), label: "Allow multi-select" }), _jsx(Toggle, { checked: values.allowComment, onChange: (v) => onChange({ allowComment: v }), label: "Allow comment with vote" })] })] })), values.type === "survey" && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Survey configuration" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Max entries per user", error: errors.maxEntriesPerUser, type: "number", value: values.maxEntriesPerUser, onChange: (e) => onChange({ maxEntriesPerUser: e.target.value }), placeholder: "1" }), values.hasPointSystem && (_jsx(Input, { label: "Points label", error: errors.pointsLabel, value: values.pointsLabel, onChange: (e) => onChange({ pointsLabel: e.target.value }), placeholder: "Points" }))] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Toggle, { checked: values.requireLogin, onChange: (v) => onChange({ requireLogin: v }), label: "Require login to participate" }), _jsx(Toggle, { checked: values.hasLeaderboard, onChange: (v) => onChange({ hasLeaderboard: v }), label: "Show leaderboard" }), _jsx(Toggle, { checked: values.hasPointSystem, onChange: (v) => onChange({ hasPointSystem: v }), label: "Enable point system" }), _jsx(Toggle, { checked: values.entryReviewRequired, onChange: (v) => onChange({ entryReviewRequired: v }), label: "Require employee review before entry is approved" })] }), _jsx(FormFieldBuilder, { fields: values.surveyFields, setFields: (f) => onChange({ surveyFields: f }) })] })), values.type === "feedback" && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Feedback configuration" }), _jsx(Toggle, { checked: values.anonymous, onChange: (v) => onChange({ anonymous: v }), label: "Allow anonymous submissions" }), _jsx(FormFieldBuilder, { fields: values.feedbackFields, setFields: (f) => onChange({ feedbackFields: f }) })] }))] })),
         },
         {
             id: "raffle",
-            label: "Raffle / Spin",
+            label: "Giveaway / Spin",
             fields: ["hasRaffle", "raffleType", "raffleTopN", "rafflePrize", "rafflePrizeCouponIds", "rafflePrizeProductIds", "spinPrizes", "spinMaxPerUser", "spinWindowStart", "spinWindowEnd"],
             render: ({ values, onChange, errors }) => {
-                const isRaffleType = values.type === "raffle" || values.type === "spin_wheel";
+                // 🛑 `values.type` is an `EventType` (renamed 2026-10-31);
+                // `values.raffleType` is a `RaffleType` whose `"spin_wheel"` was NOT.
+                const isRaffleType = values.type === "giveaway" || values.type === "bonus-spin";
                 const showRaffleConfig = isRaffleType || values.hasRaffle;
-                const isSpinMode = values.type === "spin_wheel" || values.raffleType === "spin_wheel";
-                return (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Raffle & Spin Wheel" }), !isRaffleType && (_jsx(Toggle, { checked: values.hasRaffle, onChange: (v) => onChange({ hasRaffle: v }), label: "Attach a raffle to this event" })), !isRaffleType && !values.hasRaffle && (_jsx(Text, { size: "sm", color: "muted", children: "Enable the toggle above to attach a raffle draw to this event. Not applicable for this event type by default." })), showRaffleConfig && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Select, { label: "Raffle type", error: errors.raffleType, value: values.type === "spin_wheel" ? "spin_wheel" : values.raffleType, options: RAFFLE_TYPE_OPTIONS, onChange: (e) => onChange({ raffleType: e.target.value }), disabled: values.type === "spin_wheel" }), _jsx(Input, { label: "Top N (for top-N raffle types)", error: errors.raffleTopN, type: "number", value: values.raffleTopN, onChange: (e) => onChange({ raffleTopN: e.target.value }), placeholder: "10" })] }), _jsx(Input, { label: "Prize description", error: errors.rafflePrize, value: values.rafflePrize, onChange: (e) => onChange({ rafflePrize: e.target.value }), placeholder: "\u20B92,000 store credit + exclusive Pikachu sticker" }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Coupons for winner (optional)" }), _jsx(CouponInlineSelect, { scope: "admin", multiple: true, value: values.rafflePrizeCouponIds, onChange: (ids) => onChange({ rafflePrizeCouponIds: ids }), placeholder: "Search coupons\u2026", allowCreate: false }), _jsxs(Text, { size: "xs", color: "muted", className: "mt-1", children: ["Every coupon listed here is awarded to the winner when the draw runs. Up to ", ATTACHED_COUPON_MAX, "."] })] }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Prize products (optional)" }), _jsx(ProductInlineSelect, { scope: "admin", multiple: true, value: values.rafflePrizeProductIds, onChange: (ids) => onChange({ rafflePrizeProductIds: ids }), placeholder: "Search products to feature as prizes\u2026" }), _jsx(Text, { size: "xs", color: "muted", className: "mt-1", children: "Products shown to winners or displayed as the prize showcase." })] }), isSpinMode && _jsx(SpinPrizesEditor, { values: values, onChange: onChange }), isEdit && (_jsxs(Stack, { gap: "xs", rounded: "lg", padding: "sm", className: CLS_RAFFLE_PANEL, children: [_jsxs(Row, { justify: "between", gap: "sm", children: [_jsx(Text, { size: "sm", weight: "medium", className: CLS_RAFFLE_HEADING, children: raffleWinnerName ? `Winner: ${raffleWinnerName}` : "Raffle not yet triggered" }), _jsx(Button, { type: "button", action: ACTIONS.EVENT["draw-raffle-winner"], size: "sm", onClick: () => triggerRaffleMutation.mutate(), disabled: triggerRaffleMutation.isPending || Boolean(raffleWinnerName), children: triggerRaffleMutation.isPending ? "Triggering…" : raffleWinnerName ? "Already triggered" : "Trigger Raffle Now" })] }), raffleEntryCount !== null && _jsxs(Text, { size: "xs", className: CLS_RAFFLE_BODY, children: ["Pool size: ", raffleEntryCount] }), raffleGithubUrl && _jsxs(Text, { size: "xs", className: `break-all ${CLS_RAFFLE_BODY}`, children: ["Fairness proof: ", raffleGithubUrl] }), triggerMessage && _jsx(Text, { size: "xs", className: CLS_RAFFLE_HEADING, children: triggerMessage })] }))] }))] }));
+                const isSpinMode = values.type === "bonus-spin" || values.raffleType === "spin_wheel";
+                return (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Giveaway & Bonus Spin" }), !isRaffleType && (_jsx(Toggle, { checked: values.hasRaffle, onChange: (v) => onChange({ hasRaffle: v }), label: "Attach a giveaway draw to this event" })), !isRaffleType && !values.hasRaffle && (_jsx(Text, { size: "sm", color: "muted", children: "Enable the toggle above to attach a giveaway draw to this event. Not applicable for this event type by default." })), showRaffleConfig && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Select, { label: "Draw mechanism", error: errors.raffleType, value: values.type === "bonus-spin" ? "spin_wheel" : values.raffleType, options: RAFFLE_TYPE_OPTIONS, onChange: (e) => onChange({ raffleType: e.target.value }), disabled: values.type === "bonus-spin" }), _jsx(Input, { label: "Top N (for top-N giveaway types)", error: errors.raffleTopN, type: "number", value: values.raffleTopN, onChange: (e) => onChange({ raffleTopN: e.target.value }), placeholder: "10" })] }), _jsx(Input, { label: "Prize description", error: errors.rafflePrize, value: values.rafflePrize, onChange: (e) => onChange({ rafflePrize: e.target.value }), placeholder: "\u20B92,000 store credit + exclusive Pikachu sticker" }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Coupons for winner (optional)" }), _jsx(CouponInlineSelect, { scope: "admin", multiple: true, value: values.rafflePrizeCouponIds, onChange: (ids) => onChange({ rafflePrizeCouponIds: ids }), placeholder: "Search coupons\u2026", allowCreate: false }), _jsxs(Text, { size: "xs", color: "muted", className: "mt-1", children: ["Every coupon listed here is awarded to the winner when the draw runs. Up to ", ATTACHED_COUPON_MAX, "."] })] }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Prize products (optional)" }), _jsx(ProductInlineSelect, { scope: "admin", multiple: true, value: values.rafflePrizeProductIds, onChange: (ids) => onChange({ rafflePrizeProductIds: ids }), placeholder: "Search products to feature as prizes\u2026" }), _jsx(Text, { size: "xs", color: "muted", className: "mt-1", children: "Products shown to winners or displayed as the prize showcase." })] }), isSpinMode && _jsx(SpinPrizesEditor, { values: values, onChange: onChange }), isEdit && (_jsxs(Stack, { gap: "xs", rounded: "lg", padding: "sm", className: CLS_RAFFLE_PANEL, children: [_jsxs(Row, { justify: "between", gap: "sm", children: [_jsx(Text, { size: "sm", weight: "medium", className: CLS_RAFFLE_HEADING, children: raffleWinnerName ? `Winner: ${raffleWinnerName}` : "Giveaway not yet triggered" }), _jsx(Button, { type: "button", action: ACTIONS.EVENT["draw-raffle-winner"], size: "sm", onClick: () => triggerGiveawayMutation.mutate(), disabled: triggerGiveawayMutation.isPending || Boolean(raffleWinnerName), children: triggerGiveawayMutation.isPending ? "Triggering…" : raffleWinnerName ? "Already triggered" : "Draw Giveaway Winner" })] }), raffleEntryCount !== null && _jsxs(Text, { size: "xs", className: CLS_RAFFLE_BODY, children: ["Pool size: ", raffleEntryCount] }), raffleGithubUrl && _jsxs(Text, { size: "xs", className: `break-all ${CLS_RAFFLE_BODY}`, children: ["Fairness proof: ", raffleGithubUrl] }), triggerMessage && _jsx(Text, { size: "xs", className: CLS_RAFFLE_HEADING, children: triggerMessage })] }))] }))] }));
             },
         },
     ];
@@ -519,5 +576,8 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
     if (embedded) {
         return _jsx(Div, { className: `${__O.yAuto} ${__P.p4}`, children: formContent });
     }
-    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit Event" : "Create Event", sections: [formContent] }));
+    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: isEdit ? "Edit Event" : "Create Event", sections: [
+            _jsx(AdminComposableRegion, { pageId: pageId, initialCards: pageRegionCards }, "page-region"),
+            formContent,
+        ] }));
 }

package/dist/features/events/components/AdminEventEntriesView.d.ts

@@ -1,8 +1,11 @@
 import React from "react";
+import type { DashboardCard } from "../../../_internal/shared/features/dashboard/recent-entry";
 export interface AdminEventEntriesViewProps {
     eventId?: string;
     entriesEndpoint?: (eventId: string) => string;
     entryReviewEndpoint?: (eventId: string, entryId: string) => string;
     statsEndpoint?: (eventId: string) => string;
+    /** Admin-curated page-region cards (Phase 12). Omit for no extra content. */
+    pageRegionCards?: DashboardCard[];
 }
-export declare function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEndpoint, statsEndpoint, }: AdminEventEntriesViewProps): React.JSX.Element;
+export declare function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEndpoint, statsEndpoint, pageRegionCards, }: AdminEventEntriesViewProps): React.JSX.Element;