@mohasinac/appkit 4.71.2 → 4.72.0

package/dist/features/events/schemas/entry-votes.js

@@ -0,0 +1,114 @@
+/**
+ * Entry votes — like/dislike on a CONTEST ENTRY, and who cast them.
+ *
+ * ## Why a sibling of `likes.ts` rather than a field on the entry
+ *
+ * Deliberately the same shape as `EventLikeDocument`, for the same reasons its
+ * header gives: the document id IS the idempotency key, so a repeat vote
+ * overwrites itself, a retraction is a `.delete()`, and "how did I vote" is a
+ * single `.doc(id).get()` with no query, no index and no transaction.
+ *
+ * The rejected alternative is the same one: a `votedBy[]` array on the entry.
+ * It caps out at Firestore's 1 MiB document limit — a real ceiling for a
+ * popular entry and a silent one — and it has no clean un-vote.
+ *
+ * ## 🛑 The difference from a like: a vote has a VALUE
+ *
+ * `likes.ts` stores existence — the row is the like. A vote stores a
+ * direction, so the row carries `value` and changing your mind is a `.set()`
+ * over the same id rather than a delete-then-create. That keeps "one vote per
+ * user per entry" true by construction instead of by a rule somebody enforces.
+ *
+ * ## 🛑 Who may see WHO voted
+ *
+ * Owner, 2026-11-08: *"only admins see who voted, rest see numbers"*.
+ *
+ * So the voter list is an admin projection and the counts are the public one.
+ * This file stores only `userId` — never a denormalised name or email — for
+ * exactly the reason `likes.ts` states: a public surface reads the counts, and
+ * the cheapest way to never leak a field is to not store it. An admin screen
+ * joins the user's own public projection at read time.
+ *
+ * ## 🛑 Ranking is a CONFIG RULE, never a fixed formula
+ *
+ * This file first shipped with `entryScore = likes - dislikes` hardcoded, which
+ * is the exact mistake the rework exists to remove: a rule baked into code that
+ * an admin then cannot change. There are several legitimate situations — a
+ * like-only popularity contest, a net-score vote, a straight turnout count, a
+ * jury pick — and the event, not the source, decides which applies.
+ *
+ * So the rule is a value on the event and `resolveEntryRanking` is the one
+ * place it is interpreted. Adding a fifth rule is a case here plus a config
+ * option; it is never a second copy of the arithmetic somewhere else.
+ *
+ * @tag domain:events
+ * @tag layer:schema
+ */
+export const EVENT_ENTRY_VOTES_COLLECTION = "eventEntryVotes";
+/**
+ * The deterministic id — one row per user per entry.
+ *
+ * 🛑 `__` matches `eventLikeId`, `courierVoteId` and the tester-response id.
+ * Firestore ids may not contain `/`, and a single `_` appears inside real
+ * uids; a double underscore does not.
+ */
+export function eventEntryVoteId(entryId, userId) {
+    return `${entryId}__${userId}`;
+}
+export const EVENT_ENTRY_VOTE_FIELDS = {
+    EVENT_ID: "eventId",
+    ENTRY_ID: "entryId",
+    USER_ID: "userId",
+    VALUE: "value",
+    CREATED_AT: "createdAt",
+    UPDATED_AT: "updatedAt",
+};
+/** The default when an event does not say. Matches "most liked photo wins". */
+export const DEFAULT_ENTRY_RANKING = "most-likes";
+/**
+ * The ONE place a ranking rule is interpreted.
+ *
+ * Returns the sort key, descending — so the gallery, the scoreboard, the winner
+ * resolution and any export all order entries identically. Two screens
+ * disagreeing about who is winning is the failure this prevents.
+ *
+ * `manual` returns 0 for every entry on purpose: with no computed order, the
+ * caller must fall back to the tie-break (earliest first) rather than invent
+ * one, and the UI shows a human decision is pending.
+ */
+export function resolveEntryRanking(rule, entry) {
+    switch (rule) {
+        case "most-likes":
+            return entry.likes;
+        case "net-score":
+            return entry.likes - entry.dislikes;
+        case "most-votes":
+            return entry.likes + entry.dislikes;
+        case "earliest":
+            /*
+             * Negated so that, like every other rule, a HIGHER key sorts first —
+             * callers sort one way and need no per-rule direction flag.
+             */
+            return -entry.submittedAt.getTime();
+        case "manual":
+            return 0;
+        default:
+            /*
+             * An unknown rule means config names something this build does not
+             * implement — a newer rule set against an older deploy. Rank everything
+             * equally and let the tie-break order it, which degrades to "earliest
+             * first" rather than throwing on a public page. The admin screen is
+             * where an unimplemented rule should be surfaced, not the gallery.
+             */
+            return 0;
+    }
+}
+/**
+ * The published tie-break: the earlier entry wins.
+ *
+ * Stated here because it has to be announced BEFORE a contest closes. Deciding
+ * a tie afterwards, however fairly, looks like deciding it to suit someone.
+ */
+export function entryTieBreak(a, b) {
+    return a.submittedAt.getTime() - b.submittedAt.getTime();
+}

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

@@ -1,4 +1,5 @@
 export * from "./firestore";
+export * from "./entry-votes";
 import { z } from "zod";
 /**
  * 🛑 WRITE enum — the current spellings only. The three chance-based types
@@ -11,7 +12,28 @@ import { z } from "zod";
  * `normalizeEventType`, and rewritten by
  * `appkit/scripts/migrate-collector-drop-rename.mjs`.
  */
-export declare const eventTypeSchema: z.ZodEnum<["sale", "offer", "poll", "survey", "feedback", "giveaway", "bonus-spin", "random-draw"]>;
+/**
+ * 🛑 OPEN, not a closed enum. Owner, 2026-11-08: *"all event types are also
+ * configs … they should not be fixed, nothing in the code should be fixed"*
+ * and *"the types we have now are the DEFAULT TEMPLATES"*.
+ *
+ * The eight below are the shipped templates, kept as a named list so the
+ * common ones are discoverable and so a typo in one of THEM is still caught.
+ * Anything else is accepted as a slug and resolved against the event-type
+ * config (`seed/event-types-seed-data.ts`).
+ *
+ * The rejected shape was the previous one: a closed `z.enum` that 400s an
+ * unknown value. It made a new kind of event — a photo contest judged by votes,
+ * say — an enum edit, a schema change and a deploy, which is precisely the
+ * coupling the rework removes. The same change is owed to coupons, listings
+ * and reviews, which are all still closed today.
+ *
+ * The slug shape is still enforced, because an unvalidated string here becomes
+ * a URL segment and a Firestore query value: lowercase, digits and hyphens,
+ * 2-40 characters.
+ */
+export declare const DEFAULT_EVENT_TYPE_TEMPLATES: readonly ["sale", "offer", "poll", "survey", "feedback", "giveaway", "bonus-spin", "random-draw"];
+export declare const eventTypeSchema: z.ZodString;
 export declare const eventStatusSchema: z.ZodEnum<["draft", "active", "paused", "ended", "cancelled"]>;
 export declare const saleConfigSchema: z.ZodObject<{
     discountPercent: z.ZodNumber;
@@ -448,7 +470,7 @@ export declare const giveawayConfigClientSchema: z.ZodObject<{
 export declare const eventItemSchema: z.ZodObject<{
     id: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
-    type: z.ZodEnum<["sale", "offer", "poll", "survey", "feedback", "giveaway", "bonus-spin", "random-draw"]>;
+    type: z.ZodString;
     title: z.ZodString;
     description: z.ZodString;
     status: z.ZodEnum<["draft", "active", "paused", "ended", "cancelled"]>;
@@ -954,7 +976,7 @@ export declare const eventItemSchema: z.ZodObject<{
     title: string;
     id: string;
     status: "cancelled" | "draft" | "active" | "paused" | "ended";
-    type: "giveaway" | "sale" | "offer" | "poll" | "survey" | "feedback" | "bonus-spin" | "random-draw";
+    type: string;
     description: string;
     createdAt: string;
     updatedAt: string;
@@ -1111,7 +1133,7 @@ export declare const eventItemSchema: z.ZodObject<{
     title: string;
     id: string;
     status: "cancelled" | "draft" | "active" | "paused" | "ended";
-    type: "giveaway" | "sale" | "offer" | "poll" | "survey" | "feedback" | "bonus-spin" | "random-draw";
+    type: string;
     description: string;
     createdAt: string;
     updatedAt: string;
@@ -1264,7 +1286,7 @@ export declare const eventItemSchema: z.ZodObject<{
 }>;
 /** Base Zod schema for list-query parameters. */
 export declare const eventListParamsSchema: z.ZodObject<{
-    type: z.ZodOptional<z.ZodEnum<["sale", "offer", "poll", "survey", "feedback", "giveaway", "bonus-spin", "random-draw"]>>;
+    type: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<["draft", "active", "paused", "ended", "cancelled"]>>;
     q: z.ZodOptional<z.ZodString>;
     page: z.ZodOptional<z.ZodNumber>;
@@ -1274,14 +1296,14 @@ export declare const eventListParamsSchema: z.ZodObject<{
     sort?: string | undefined;
     q?: string | undefined;
     status?: "cancelled" | "draft" | "active" | "paused" | "ended" | undefined;
-    type?: "giveaway" | "sale" | "offer" | "poll" | "survey" | "feedback" | "bonus-spin" | "random-draw" | undefined;
+    type?: string | undefined;
     page?: number | undefined;
     perPage?: number | undefined;
 }, {
     sort?: string | undefined;
     q?: string | undefined;
     status?: "cancelled" | "draft" | "active" | "paused" | "ended" | undefined;
-    type?: "giveaway" | "sale" | "offer" | "poll" | "survey" | "feedback" | "bonus-spin" | "random-draw" | undefined;
+    type?: string | undefined;
     page?: number | undefined;
     perPage?: number | undefined;
 }>;

package/dist/features/events/schemas/index.js

@@ -1,4 +1,5 @@
 export * from "./firestore.js";
+export * from "./entry-votes.js";
 import { z } from "zod";
 import { mediaUrlSchema } from "../../../validation/schemas.js";
 import { mediaFieldSchema } from "../../media/types/index.js";
@@ -23,7 +24,27 @@ const eventCoverImageSchema = z
  * `normalizeEventType`, and rewritten by
  * `appkit/scripts/migrate-collector-drop-rename.mjs`.
  */
-export const eventTypeSchema = z.enum([
+/**
+ * 🛑 OPEN, not a closed enum. Owner, 2026-11-08: *"all event types are also
+ * configs … they should not be fixed, nothing in the code should be fixed"*
+ * and *"the types we have now are the DEFAULT TEMPLATES"*.
+ *
+ * The eight below are the shipped templates, kept as a named list so the
+ * common ones are discoverable and so a typo in one of THEM is still caught.
+ * Anything else is accepted as a slug and resolved against the event-type
+ * config (`seed/event-types-seed-data.ts`).
+ *
+ * The rejected shape was the previous one: a closed `z.enum` that 400s an
+ * unknown value. It made a new kind of event — a photo contest judged by votes,
+ * say — an enum edit, a schema change and a deploy, which is precisely the
+ * coupling the rework removes. The same change is owed to coupons, listings
+ * and reviews, which are all still closed today.
+ *
+ * The slug shape is still enforced, because an unvalidated string here becomes
+ * a URL segment and a Firestore query value: lowercase, digits and hyphens,
+ * 2-40 characters.
+ */
+export const DEFAULT_EVENT_TYPE_TEMPLATES = [
     "sale",
     "offer",
     "poll",
@@ -32,7 +53,13 @@ export const eventTypeSchema = z.enum([
     "giveaway",
     "bonus-spin",
     "random-draw",
-]);
+];
+export const eventTypeSchema = z
+    .string()
+    .trim()
+    .min(2)
+    .max(40)
+    .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "Use a lowercase slug, e.g. photo-contest");
 export const eventStatusSchema = z.enum(["draft", "active", "paused", "ended", "cancelled"]);
 export const saleConfigSchema = z.object({
     discountPercent: z.number(),

package/dist/features/inventory/components/AdminMoveLedgerView.d.ts

@@ -7,6 +7,6 @@ export interface AdminMoveLedgerViewProps {
 export declare function AdminMoveLedgerView({ pageRegionCards }?: AdminMoveLedgerViewProps): React.JSX.Element;
 /** The kind chips, derived from the union so a sixth kind cannot be missed. */
 export declare const MOVEMENT_KIND_TABS: {
-    id: "move" | "receive" | "pick" | "adjust" | "audit";
+    id: "move" | "audit" | "receive" | "pick" | "adjust";
     label: string;
 }[];

package/dist/features/live/components/LiveItemDetailPageView.js

@@ -21,7 +21,7 @@ import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Main, Nav, Section } from "../../../ui/components/Semantic.js";
 import { RichText } from "../../../ui/rich-text/RichText.js";
 import { SpecTable } from "../../../ui/components/SpecTable.js";
-import { PreOrderDetailView } from "../../products/components/PreOrderDetailView.js";
+import { ListingDetailShell } from "../../../ui/components/ListingDetailShell.js";
 import { ProductGalleryClient } from "../../products/components/ProductGalleryClient.js";
 import { ProductTabsShell } from "../../products/components/ProductTabsShell.js";
 import { toCustomSectionTabs } from "../../products/components/CustomSectionTabContent.js";
@@ -98,5 +98,5 @@ export async function LiveItemDetailPageView({ slug, initialProduct, renderActio
                     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.LIVE), className: CLS_BREADCRUMB_LINK, children: "Live" }), 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(AdminComposableRegion, { pageId: "live-slug", initialCards: pageRegionCards, functionalSlots: { "pdp-primary-actions": primaryActionsNode } }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "gallery", initialVisible: pdpSectionVisibility.gallery !== false, children: _jsx(ProductGalleryClient, { images: images, video: productVideo, 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_LIVE_ITEM_BADGE, children: "Live Item" }), meta?.vendorVerified && (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Verified Seller" })), meta?.cites && (_jsxs(Span, { color: "warning", surface: "warning-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: ["CITES: ", meta.cites] }))] }), _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 }), meta?.species && (_jsxs(Text, { className: "italic mt-1", color: "muted", size: "sm", children: [meta.species, meta.sex && meta.sex !== "n/a" && ` · ${meta.sex}`, meta.ageMonths !== undefined && ` · ${meta.ageMonths}mo`] }))] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) })), jurisdictions.length > 0 && (_jsxs(Div, { className: CLS_WARN_BOX, children: [_jsx(Text, { className: CLS_WARN_TITLE, children: "Delivery restrictions" }), _jsxs(Text, { className: CLS_WARN_BODY, children: ["This item can only be shipped to: ", jurisdictions.join(", ")] })] })), transport && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Transport" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Method: ", transport.method, transport.handlingFee !== undefined && (_jsx(PricesOnly, { children: ` · Handling: ${formatCurrency(transport.handlingFee, "INR")}` })), transport.insuranceIncluded && " · Insurance included"] })] })), meta?.careInfo && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Care information" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-muted)]", children: meta.careInfo })] })), 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: "live-item-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(ListingBottomActions, { listingType: "live", anchorId: "live-item-buy-bar", price: price, currency: currency })] })] }));
+                } }), _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.LIVE), className: CLS_BREADCRUMB_LINK, children: "Live" }), 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(AdminComposableRegion, { pageId: "live-slug", initialCards: pageRegionCards, functionalSlots: { "pdp-primary-actions": primaryActionsNode } }), _jsx(ListingDetailShell, { layout: "grid-2", renderGallery: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "gallery", initialVisible: pdpSectionVisibility.gallery !== false, children: _jsx(ProductGalleryClient, { images: images, video: productVideo, 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_LIVE_ITEM_BADGE, children: "Live Item" }), meta?.vendorVerified && (_jsx(Span, { color: "success", surface: "success-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: "Verified Seller" })), meta?.cites && (_jsxs(Span, { color: "warning", surface: "warning-surface", size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", children: ["CITES: ", meta.cites] }))] }), _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 }), meta?.species && (_jsxs(Text, { className: "italic mt-1", color: "muted", size: "sm", children: [meta.species, meta.sex && meta.sex !== "n/a" && ` · ${meta.sex}`, meta.ageMonths !== undefined && ` · ${meta.ageMonths}mo`] }))] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(price, currency) }) })), jurisdictions.length > 0 && (_jsxs(Div, { className: CLS_WARN_BOX, children: [_jsx(Text, { className: CLS_WARN_TITLE, children: "Delivery restrictions" }), _jsxs(Text, { className: CLS_WARN_BODY, children: ["This item can only be shipped to: ", jurisdictions.join(", ")] })] })), transport && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Transport" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", children: ["Method: ", transport.method, transport.handlingFee !== undefined && (_jsx(PricesOnly, { children: ` · Handling: ${formatCurrency(transport.handlingFee, "INR")}` })), transport.insuranceIncluded && " · Insurance included"] })] })), meta?.careInfo && (_jsxs(Div, { textSize: "sm", border: "subtle", surface: "muted", padding: "md", rounded: "lg", children: [_jsx(Text, { weight: "medium", children: "Care information" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-muted)]", children: meta.careInfo })] })), 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) }) })), renderAside: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "actions", initialVisible: pdpSectionVisibility.actions !== false, children: _jsx(Div, { id: "live-item-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(ListingBottomActions, { listingType: "live", anchorId: "live-item-buy-bar", price: price, currency: currency })] })] }));
 }

package/dist/features/pre-orders/components/PreOrderDetailPageView.js

@@ -28,7 +28,7 @@ import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Main, Nav, Section, Ul, Li } from "../../../ui/components/Semantic.js";
 import { RichText } from "../../../ui/rich-text/RichText.js";
 import { SpecTable } from "../../../ui/components/SpecTable.js";
-import { PreOrderDetailView } from "../../products/components/PreOrderDetailView.js";
+import { ListingDetailShell } from "../../../ui/components/ListingDetailShell.js";
 import { PreOrderBottomActions } from "./PreOrderBottomActions.js";
 import { ProductTabsShell } from "../../products/components/ProductTabsShell.js";
 import { toCustomSectionTabs } from "../../products/components/CustomSectionTabContent.js";
@@ -185,9 +185,9 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
                     price: typeof p.price === "number" ? p.price : undefined,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: typeof p.storeName === "string" ? p.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.PRE_ORDERS), className: CLS_BREADCRUMB_LINK, children: "Pre-Orders" }), 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(AdminComposableRegion, { pageId: "pre-orders-id", initialCards: pageRegionCards, functionalSlots: { "pdp-primary-actions": primaryActionsNode } }), _jsx(PreOrderDetailView, { renderGallery: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "gallery", initialVisible: pdpSectionVisibility.gallery !== false, children: _jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title }) })), renderInfo: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "info", initialVisible: pdpSectionVisibility.info !== false, children: _jsx(PreOrderInfoSection, { title: title, productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined, productionStatus: productionStatus, maxPerUser: maxPerUser, deliveryDate: deliveryDate, featured: featured, freeShipping: freeShipping, condition: condition, isCancellable: isCancellable, finalSale: isFinalSale(p), category: category, categoryName: categoryName, brand: brand, brandSlug: brandSlug, productFeatures: productFeatures, features: features, descriptionHtml: descriptionHtml, safeSeller: safeSeller, storeHref: storeHref }) })), renderSublistingSection: sublistingCategoryId
+                } }), _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.PRE_ORDERS), className: CLS_BREADCRUMB_LINK, children: "Pre-Orders" }), 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(AdminComposableRegion, { pageId: "pre-orders-id", initialCards: pageRegionCards, functionalSlots: { "pdp-primary-actions": primaryActionsNode } }), _jsx(ListingDetailShell, { layout: "grid-2", renderGallery: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "gallery", initialVisible: pdpSectionVisibility.gallery !== false, children: _jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title }) })), renderInfo: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "info", initialVisible: pdpSectionVisibility.info !== false, children: _jsx(PreOrderInfoSection, { title: title, productId: String(product.id), storeId: product.storeId ? String(product.storeId) : undefined, productionStatus: productionStatus, maxPerUser: maxPerUser, deliveryDate: deliveryDate, featured: featured, freeShipping: freeShipping, condition: condition, isCancellable: isCancellable, finalSale: isFinalSale(p), category: category, categoryName: categoryName, brand: brand, brandSlug: brandSlug, productFeatures: productFeatures, features: features, descriptionHtml: descriptionHtml, safeSeller: safeSeller, storeHref: storeHref }) })), renderSublistingSection: sublistingCategoryId
                             ? () => (_jsx(SublistingCarouselSection, { sublistingCategoryId: sublistingCategoryId, currentListingId: String(product.id) }))
                             : undefined, renderGroupSection: groupId
                             ? () => (_jsx(ShowGroupSection, { groupId: groupId, currentSlug: String(p.slug ?? product.id), isParent: isGroupParent, groupTitle: groupTitle }))
-                            : undefined, 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, customTabs: toCustomSectionTabs(p.customSections) }) })), renderBuyBar: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "actions", initialVisible: pdpSectionVisibility.actions !== false, 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 || undefined, storeLabel: storeName || undefined }) })] })) }), _jsx(PreOrderBottomActions, { price: price, currency: currency })] })] }));
+                            : undefined, 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, customTabs: toCustomSectionTabs(p.customSections) }) })), renderAside: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "actions", initialVisible: pdpSectionVisibility.actions !== false, 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 || undefined, storeLabel: storeName || undefined }) })] })) }), _jsx(PreOrderBottomActions, { price: price, currency: currency })] })] }));
 }

package/dist/features/products/components/ClearanceDetailPageView.js

@@ -20,7 +20,7 @@ import { Div } from "../../../ui/components/Div.js";
 import { Heading, Span, Text } from "../../../ui/components/Typography.js";
 import { Main, Section } from "../../../ui/components/Semantic.js";
 import { RichText } from "../../../ui/rich-text/RichText.js";
-import { PreOrderDetailView } from "./PreOrderDetailView.js";
+import { ListingDetailShell } from "../../../ui/components/ListingDetailShell.js";
 import { ClearanceBottomActions } from "./ClearanceBottomActions.js";
 import { ProductTabsShell } from "./ProductTabsShell.js";
 import { ShareButton } from "./ShareButton.js";
@@ -152,5 +152,5 @@ export async function ClearanceDetailPageView({ id, initialClearance, currentUse
                     price: pricePerEntry,
                     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", className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)] flex-wrap", children: [_jsx(Link, { href: String(ROUTES.HOME), className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CLEARANCE), className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Clearance" }), _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(ClearanceCollage, { items: items, hideWonState: true }) })), renderInfo: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "info", initialVisible: pdpSectionVisibility.info !== false, children: _jsxs(Stack, { gap: "md", children: [_jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(product.title ?? product.id), storeId: product.storeId ? String(product.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(product.id))) }), _jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: "Clearance" }), _jsx(Span, { size: "xs", weight: "semibold", className: `inline-block ${statusClass(revealStatus)}`, padding: "pill-sm", rounded: "full", children: statusLabel(revealStatus) }), maxPerUser !== null && (_jsxs(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: ["Limit: ", maxPerUser, " entries per customer"] })), maxPerUser !== null && userEntriesUsed !== null && (_jsxs(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: ["You have used ", userEntriesUsed, "/", maxPerUser] }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsx(Div, { className: `${__P.p4}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Entries" }), _jsxs(Text, { size: "sm", weight: "semibold", children: [current, " / ", max, " (", remaining, " left)"] })] }), revealStart && (_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Reveal window opens" }), _jsx(Text, { size: "sm", weight: "medium", children: revealStart.toLocaleString() })] })), revealEnd && (_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Reveal window closes" }), _jsx(Text, { size: "sm", weight: "medium", children: revealEnd.toLocaleString() })] }))] }) }), 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, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", 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" }))] }) })), _jsx(Disclaimer, { id: "clearance" })] }) })), 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 }) })), renderBuyBar: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "actions", initialVisible: pdpSectionVisibility.actions !== false, children: _jsx(Div, { padding: "5", id: "prize-draw-buy-bar", border: "subtle", surface: "muted", rounded: "xl", 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, brandLabel: brand, storeLabel: storeName ?? undefined }) }), _jsx(AdminComposableRegion, { pageId: "clearance-slug", initialCards: pageRegionCards, functionalSlots: { "pdp-primary-actions": primaryActionsNode } })] })) }), _jsx(ClearanceBottomActions, { pricePerEntry: pricePerEntry, currency: currency, closed: revealStatus === "closed" || remaining === 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", className: "flex items-center gap-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)] flex-wrap", children: [_jsx(Link, { href: String(ROUTES.HOME), className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CLEARANCE), className: "hover:text-primary-600 dark:hover:text-primary-400 transition-colors", children: "Clearance" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(ListingDetailShell, { layout: "grid-2", renderGallery: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "gallery", initialVisible: pdpSectionVisibility.gallery !== false, children: _jsx(ClearanceCollage, { items: items, hideWonState: true }) })), renderInfo: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "info", initialVisible: pdpSectionVisibility.info !== false, children: _jsxs(Stack, { gap: "md", children: [_jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: String(product.title ?? product.id), storeId: product.storeId ? String(product.storeId) : undefined, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(String(product.id))) }), _jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: "Clearance" }), _jsx(Span, { size: "xs", weight: "semibold", className: `inline-block ${statusClass(revealStatus)}`, padding: "pill-sm", rounded: "full", children: statusLabel(revealStatus) }), maxPerUser !== null && (_jsxs(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: ["Limit: ", maxPerUser, " entries per customer"] })), maxPerUser !== null && userEntriesUsed !== null && (_jsxs(Span, { size: "xs", weight: "semibold", className: CLS_PRIZE_BADGE, children: ["You have used ", userEntriesUsed, "/", maxPerUser] }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), _jsx(Div, { className: `${__P.p4}`, border: "subtle", rounded: "xl", surface: "muted", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Entries" }), _jsxs(Text, { size: "sm", weight: "semibold", children: [current, " / ", max, " (", remaining, " left)"] })] }), revealStart && (_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Reveal window opens" }), _jsx(Text, { size: "sm", weight: "medium", children: revealStart.toLocaleString() })] })), revealEnd && (_jsxs(Row, { justify: "between", align: "center", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Reveal window closes" }), _jsx(Text, { size: "sm", weight: "medium", children: revealEnd.toLocaleString() })] }))] }) }), 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, { className: `${__P.p3}`, border: "subtle", rounded: "xl", surface: "muted", 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" }))] }) })), _jsx(Disclaimer, { id: "clearance" })] }) })), 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 }) })), renderAside: () => (_jsx(SectionVisibilityGate, { surfaceId: "pdp-sections", sectionKey: "actions", initialVisible: pdpSectionVisibility.actions !== false, children: _jsx(Div, { padding: "5", id: "prize-draw-buy-bar", border: "subtle", surface: "muted", rounded: "xl", 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, brandLabel: brand, storeLabel: storeName ?? undefined }) }), _jsx(AdminComposableRegion, { pageId: "clearance-slug", initialCards: pageRegionCards, functionalSlots: { "pdp-primary-actions": primaryActionsNode } })] })) }), _jsx(ClearanceBottomActions, { pricePerEntry: pricePerEntry, currency: currency, closed: revealStatus === "closed" || remaining === 0 })] })] }));
 }

package/dist/features/products/components/index.d.ts

@@ -36,8 +36,6 @@ export { ProductDetailView } from "./ProductDetailView";
 export type { ProductDetailViewProps } from "./ProductDetailView";
 export { CollectorDropDetailView } from "./CollectorDropDetailView";
 export type { CollectorDropDetailViewProps } from "./CollectorDropDetailView";
-export { PreOrderDetailView } from "./PreOrderDetailView";
-export type { PreOrderDetailViewProps } from "./PreOrderDetailView";
 export { ProductInfo } from "./ProductInfo";
 export type { ProductInfoProps } from "./ProductInfo";
 export { ProductTabs } from "./ProductTabs";

package/dist/features/products/components/index.js

@@ -23,7 +23,6 @@ export { FeatureBadge, FeatureBadgeList } from "./FeatureBadge.js";
 export { ProductFeaturesProvider, useProductFeatures, } from "./ProductFeaturesContext.js";
 export { ProductDetailView } from "./ProductDetailView.js";
 export { CollectorDropDetailView } from "./CollectorDropDetailView.js";
-export { PreOrderDetailView } from "./PreOrderDetailView.js";
 export { ProductInfo } from "./ProductInfo.js";
 export { ProductTabs } from "./ProductTabs.js";
 export { BidHistory } from "./BidHistory.js";

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

@@ -1,6 +1,5 @@
 export * from "./firestore";
 import { z } from "zod";
-import type { ListingType } from "../types/index";
 export declare const productImageSchema: z.ZodObject<{
     url: z.ZodString;
     thumbnailUrl: z.ZodOptional<z.ZodString>;
@@ -119,7 +118,7 @@ export declare const productItemSchema: z.ZodObject<{
     status: z.ZodEnum<["draft", "published", "in_review", "archived"]>;
     condition: z.ZodOptional<z.ZodEnum<["new", "like_new", "good", "fair", "poor", "used", "refurbished", "broken", "graded"]>>;
     madeToOrder: z.ZodOptional<z.ZodBoolean>;
-    listingType: z.ZodOptional<z.ZodEnum<[ListingType, ...ListingType[]]>>;
+    listingType: z.ZodOptional<z.ZodString>;
     maxPerUser: z.ZodOptional<z.ZodNumber>;
     partOfBundleIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     partOfBundleTitles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -360,7 +359,7 @@ export declare const productItemSchema: z.ZodObject<{
     insurance?: boolean | undefined;
     insuranceCost?: number | undefined;
     shippingPaidBy?: "seller" | "buyer" | undefined;
-    listingType?: ListingType | undefined;
+    listingType?: string | undefined;
     collectorDropEndDate?: string | Date | undefined;
     startingBid?: number | undefined;
     currentBid?: number | undefined;
@@ -505,7 +504,7 @@ export declare const productItemSchema: z.ZodObject<{
     insurance?: boolean | undefined;
     insuranceCost?: number | undefined;
     shippingPaidBy?: "seller" | "buyer" | undefined;
-    listingType?: ListingType | undefined;
+    listingType?: string | undefined;
     collectorDropEndDate?: string | Date | undefined;
     startingBid?: number | undefined;
     currentBid?: number | undefined;
@@ -624,7 +623,7 @@ export declare const productListParamsSchema: z.ZodObject<{
     minPrice: z.ZodOptional<z.ZodNumber>;
     maxPrice: z.ZodOptional<z.ZodNumber>;
     inStock: z.ZodOptional<z.ZodBoolean>;
-    listingType: z.ZodOptional<z.ZodEnum<[ListingType, ...ListingType[]]>>;
+    listingType: z.ZodOptional<z.ZodString>;
     storeId: z.ZodOptional<z.ZodString>;
     sort: z.ZodOptional<z.ZodString>;
     page: z.ZodOptional<z.ZodNumber>;
@@ -638,7 +637,7 @@ export declare const productListParamsSchema: z.ZodObject<{
     storeId?: string | undefined;
     featured?: boolean | undefined;
     condition?: "new" | "like_new" | "good" | "fair" | "poor" | "used" | "refurbished" | "broken" | "graded" | undefined;
-    listingType?: ListingType | undefined;
+    listingType?: string | undefined;
     page?: number | undefined;
     minPrice?: number | undefined;
     maxPrice?: number | undefined;
@@ -652,7 +651,7 @@ export declare const productListParamsSchema: z.ZodObject<{
     storeId?: string | undefined;
     featured?: boolean | undefined;
     condition?: "new" | "like_new" | "good" | "fair" | "poor" | "used" | "refurbished" | "broken" | "graded" | undefined;
-    listingType?: ListingType | undefined;
+    listingType?: string | undefined;
     page?: number | undefined;
     minPrice?: number | undefined;
     maxPrice?: number | undefined;

package/dist/features/products/schemas/index.js

@@ -1,7 +1,6 @@
 export * from "./firestore.js";
 import { z } from "zod";
 import { mediaFieldSchema } from "../../media/types/index.js";
-import { ALL_LISTING_TYPES } from "../../../_internal/shared/listing-types/feature-flags.js";
 import { CLEARANCE_DURATION_DAYS_MIN, CLEARANCE_DURATION_DAYS_MAX, } from "../../../_internal/shared/checkout/rules/_limits.js";
 // --- Sub-schemas --------------------------------------------------------------
 export const productImageSchema = z.object({
@@ -54,7 +53,26 @@ export const printMetaSchema = z.object({
  * Registered in `audit-listing-type-tab-coverage`'s STAYS_DERIVED so nobody
  * re-expands it into a literal for readability.
  */
-const LISTING_TYPE_ENUM = z.enum(ALL_LISTING_TYPES);
+/*
+ * 🛑 OPEN, not a closed enum. Owner, 2026-11-08: *"nothing in the code should
+ * be fixed … the types we have now are the DEFAULT TEMPLATES"*, and listings
+ * were named explicitly alongside events, coupons and reviews.
+ *
+ * `ALL_LISTING_TYPES` stays the shipped template list — it still drives the
+ * admin picker, the seed and every default — but a site that wants a listing
+ * kind we never imagined adds a config row rather than waiting for a release.
+ *
+ * The SHAPE is still enforced, because this value becomes a URL segment, a
+ * Firestore query value and an index key: lowercase, digits, hyphen/underscore
+ * separated, 2-40 characters.
+ */
+const SLUG_RE = /^[a-z0-9]+(?:[-_][a-z0-9]+)*$/;
+const LISTING_TYPE_ENUM = z
+    .string()
+    .trim()
+    .min(2)
+    .max(40)
+    .regex(SLUG_RE, "Use a lowercase slug, e.g. art-and-stickers");
 export const productItemSchema = z.object({
     id: z.string(),
     title: z.string(),

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

@@ -181,7 +181,23 @@ export declare const COUPON_FIELDS: {
         readonly SELLER: "seller";
     };
 };
-export declare const COUPON_TYPE_LABELS: Record<CouponType, string>;
+/**
+ * Labels for the SHIPPED coupon types.
+ *
+ * 🛑 Since `CouponType` opened (2026-11-08) this is no longer exhaustive — a
+ * site-defined type has no entry here and a bare lookup yields `undefined`,
+ * which renders as an empty chip. Read it through `couponTypeLabel()`.
+ */
+export declare const COUPON_TYPE_LABELS: Record<string, string>;
+/**
+ * The label for a coupon type, with a readable fallback.
+ *
+ * An unknown type is a site-defined one, not an error: it renders its own slug
+ * de-slugged ("first_order" -> "First order") rather than blank. A coupon that
+ * shows no type at all is worse than one showing a plain name, and it must
+ * never throw on a checkout page.
+ */
+export declare function couponTypeLabel(type: string): string;
 export declare const DEFAULT_COUPON_DATA: Partial<CouponDocument>;
 export declare const COUPONS_PUBLIC_FIELDS: readonly ["id", "code", "name", "description", "type", "discount", "validity.startDate", "validity.endDate", "usage.totalLimit", "usage.perUserLimit"];
 export declare const COUPONS_UPDATABLE_FIELDS: readonly ["name", "description", "discount", "bxgy", "tiers", "usage", "validity", "restrictions"];

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

@@ -55,6 +55,13 @@ export const COUPON_FIELDS = {
         SELLER: "seller",
     },
 };
+/**
+ * Labels for the SHIPPED coupon types.
+ *
+ * 🛑 Since `CouponType` opened (2026-11-08) this is no longer exhaustive — a
+ * site-defined type has no entry here and a bare lookup yields `undefined`,
+ * which renders as an empty chip. Read it through `couponTypeLabel()`.
+ */
 export const COUPON_TYPE_LABELS = {
     percentage: "Percentage Discount",
     fixed: "Fixed Amount Discount",
@@ -64,6 +71,21 @@ export const COUPON_TYPE_LABELS = {
     // our word for it; "Points back" is what appears on their balance.
     points_earn: "Points Back",
 };
+/**
+ * The label for a coupon type, with a readable fallback.
+ *
+ * An unknown type is a site-defined one, not an error: it renders its own slug
+ * de-slugged ("first_order" -> "First order") rather than blank. A coupon that
+ * shows no type at all is worse than one showing a plain name, and it must
+ * never throw on a checkout page.
+ */
+export function couponTypeLabel(type) {
+    const known = COUPON_TYPE_LABELS[type];
+    if (known)
+        return known;
+    const words = type.replace(/[-_]+/g, " ").trim();
+    return words ? words.charAt(0).toUpperCase() + words.slice(1) : type;
+}
 export const DEFAULT_COUPON_DATA = {
     usage: { currentUsage: 0 },
     validity: { isActive: true, startDate: new Date(), endDate: undefined },