@mohasinac/appkit 4.53.1 → 4.54.0

package/dist/features/parts/components/PartDetailPageView.js

@@ -1,6 +1,49 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Section, Container, Stack, Row, Div, Heading, Text, Span, TextLink, Badge, } from "../../../ui/index.js";
+import { SpecTable } from "../../../ui/components/SpecTable.js";
 import { PART_SLOT_LABEL, } from "../schemas/firestore.js";
+/**
+ * The buyer-facing label for each WBO tournament format, in the order a
+ * player cares about: the formats they are most likely to enter first.
+ *
+ * 🛑 A `Record` over the format keys rather than a derived title-case, because
+ * "Burst Standard" is not `burstStandard` title-cased and "GT" must not become
+ * "Gt". 1,380 of 2,488 parts carry a legality ruling.
+ */
+const WBO_FORMAT_LABEL = {
+    burstStandard: "Burst Standard",
+    burstLimited: "Burst Limited",
+    burstClassic: "Burst Classic",
+    burstGT: "Burst GT",
+    burstSparking: "Burst Sparking",
+    burstDynamite: "Burst Dynamite",
+    xStandard: "X Standard",
+    zeroG: "Zero-G",
+    metalFight: "Metal Fight",
+    plastic: "Plastic",
+    hms: "HMS",
+};
+/**
+ * The rating axes, in a fixed order.
+ *
+ * 🛑 ORDERED EXPLICITLY, never by `Object.keys`. Firestore returns map fields
+ * alphabetically, which would put "burst" and "dash" ahead of "attack" and
+ * reorder the table per part depending on which axes that part happens to
+ * carry. A reader comparing two parts needs the same rows in the same places.
+ */
+const RATING_AXES = [
+    { key: "attack", label: "Attack" },
+    { key: "defense", label: "Defense" },
+    { key: "stamina", label: "Stamina" },
+    { key: "weight", label: "Weight" },
+    { key: "speed", label: "Speed" },
+    { key: "burst", label: "Burst" },
+    { key: "burstResistance", label: "Burst resistance" },
+    { key: "dash", label: "Dash" },
+    { key: "power", label: "Power" },
+    { key: "height", label: "Height" },
+    { key: "runTime", label: "Run time" },
+];
 export function PartDetailPageView({ part, usedBy, listings, listingsTruncated, allListingsHref, exactListings = [], exactListingsTruncated, hrefForModel, hrefForClassification, }) {
     const classification = PART_SLOT_LABEL[part.slot] ?? part.classification ?? part.slot;
     /*
@@ -10,7 +53,59 @@ export function PartDetailPageView({ part, usedBy, listings, listingsTruncated,
      * imply we looked it up and found none.
      */
     const aliases = (part.aliases ?? []).filter((a) => a && a !== part.name && a !== part.code);
-    return (_jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "lg", children: _jsxs(Stack, { gap: "lg", className: "min-w-0", children: [_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsx(Text, { size: "sm", color: "muted", children: _jsx(TextLink, { href: hrefForClassification(part.slot), children: classification }) }), _jsx(Heading, { level: 1, children: part.name }), _jsxs(Row, { gap: "xs", wrap: true, align: "center", className: "min-w-0", children: [part.code && _jsx(Badge, { variant: "info", children: part.code }), typeof part.weightG === "number" && (_jsxs(Badge, { variant: "default", children: [part.weightG, " g"] }))] }), aliases.length > 0 && (_jsxs(Text, { size: "sm", color: "muted", children: ["Also written: ", aliases.join(" · ")] }))] }), _jsxs(Stack, { gap: "sm", className: "min-w-0", children: [_jsx(Heading, { level: 2, size: "lg", children: usedBy.length > 0
+    /*
+     * ── THE SPEC TABLE ────────────────────────────────────────────────────────
+     *
+     * `specs[]` is the extracted infobox (2,144 of 2,488 parts carry one), and
+     * the four rows prepended here are the fields promoted OFF that array
+     * because something queries them — so they would otherwise either be
+     * missing from the table or duplicated inside it.
+     *
+     * 🛑 De-duplicated against the extracted rows by label. `Classification`,
+     * `System` and `Series` all appear in `specs[]` as well, so prepending them
+     * blindly printed each one twice.
+     */
+    const promoted = [
+        { name: "Classification", value: classification },
+        ...(part.system ? [{ name: "System", value: part.system }] : []),
+        ...(part.series ? [{ name: "Series", value: part.series }] : []),
+        ...(typeof part.weightG === "number"
+            ? [{ name: "Weight", value: String(part.weightG), unit: "g" }]
+            : []),
+        ...(part.spinDirection ? [{ name: "Spin direction", value: part.spinDirection }] : []),
+        ...(part.partType ? [{ name: "Type", value: part.partType }] : []),
+        ...(part.hasbroCode ? [{ name: "Hasbro code", value: part.hasbroCode }] : []),
+    ];
+    const promotedLabels = new Set(promoted.map((r) => r.name.toLowerCase()));
+    const specRows = [
+        ...promoted,
+        ...(part.specs ?? [])
+            .filter((s) => s.label && s.value && !promotedLabels.has(s.label.toLowerCase()))
+            .map((s) => ({ name: s.label, value: s.value })),
+    ];
+    /*
+     * ── RATINGS ───────────────────────────────────────────────────────────────
+     *
+     * 🛑 RENDER THE NORMALISED VECTOR, NEVER THE RAW ONE. Two scales live in
+     * these fields — the Beyblade X lines rate 0-100 and everything before them
+     * rates 0-6 (with a handful of Burst systems peaking at 7 or 8) — so a raw
+     * "Attack 3" means half of maximum for a Burst part and almost nothing for
+     * an X part. `ratingsNormalised` is the only comparable form, and the source
+     * scale is stated under the bars so the number is not passed off as the
+     * wiki's own.
+     */
+    const ratings = part.ratingsNormalised ?? null;
+    const ratingRows = ratings
+        ? RATING_AXES.map((a) => ({ ...a, value: ratings[a.key] })).filter((r) => typeof r.value === "number")
+        : [];
+    /* Only the formats this part is actually ruled on — see the note below. */
+    const legalFormats = Object.entries(part.wboLegality ?? {}).filter(([, v]) => typeof v === "boolean");
+    return (_jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "lg", children: _jsxs(Stack, { gap: "lg", className: "min-w-0", children: [_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsx(Text, { size: "sm", color: "muted", children: _jsx(TextLink, { href: hrefForClassification(part.slot), children: classification }) }), _jsx(Heading, { level: 1, children: part.name }), _jsxs(Row, { gap: "xs", wrap: true, align: "center", className: "min-w-0", children: [part.code && _jsx(Badge, { variant: "info", children: part.code }), typeof part.weightG === "number" && (_jsxs(Badge, { variant: "default", children: [part.weightG, " g"] }))] }), aliases.length > 0 && (_jsxs(Text, { size: "sm", color: "muted", children: ["Also written: ", aliases.join(" · ")] }))] }), specRows.length > 1 && (_jsxs(Stack, { gap: "sm", className: "min-w-0", children: [_jsx(Heading, { level: 2, size: "lg", children: "Specifications" }), _jsx(SpecTable, { rows: specRows })] })), ratingRows.length > 0 && (_jsxs(Stack, { gap: "sm", className: "min-w-0", children: [_jsx(Heading, { level: 2, size: "lg", children: "Ratings" }), _jsx(SpecTable, { rows: ratingRows.map((r) => ({
+                                    name: r.label,
+                                    value: `${r.value} / 100`,
+                                })) }), _jsxs(Text, { size: "xs", color: "faint", children: ["Rescaled to 0\u2013100 for comparison across generations", typeof part.ratingScale === "number"
+                                        ? `; rated 0–${part.ratingScale} at source`
+                                        : "", "."] })] })), legalFormats.length > 0 && (_jsxs(Stack, { gap: "sm", className: "min-w-0", children: [_jsx(Heading, { level: 2, size: "lg", children: "Tournament legality" }), _jsx(Row, { gap: "xs", wrap: true, align: "center", className: "min-w-0", children: legalFormats.map(([format, allowed]) => (_jsxs(Badge, { variant: allowed ? "success" : "danger", children: [WBO_FORMAT_LABEL[format] ?? format, allowed ? " ✓" : " ✗"] }, format))) }), _jsx(Text, { size: "xs", color: "faint", children: "World Beyblade Organization formats this part is ruled on. A format not listed has no ruling for it." })] })), _jsxs(Stack, { gap: "sm", className: "min-w-0", children: [_jsx(Heading, { level: 2, size: "lg", children: usedBy.length > 0
                                     ? `Used by ${usedBy.length} ${usedBy.length === 1 ? "model" : "models"}`
                                     : "Used by" }), usedBy.length === 0 ? (_jsx(Text, { color: "muted", size: "sm", children: "No model in our database records this part yet." })) : (_jsx(Stack, { gap: "xs", className: "min-w-0", children: usedBy.map((m) => (_jsxs(Row, { gap: "sm", align: "center", padding: "inline", surface: "card", rounded: "md", border: "subtle", className: "min-w-0", children: [_jsxs(Div, { className: "flex-1 min-w-0", children: [m.categoryId ? (_jsx(TextLink, { href: hrefForModel(m.categoryId), children: m.name })) : (
                                                 /* 49 of 259 compositions did not join to a category.

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

@@ -210,6 +210,67 @@ export interface PartColourway {
     /** The bey this colourway was released in. */
     inBey: string;
 }
+/**
+ * The infobox stat grid, as NUMBERS.
+ *
+ * 🛑 This is a deliberate second representation of the `Stats` row in
+ * `specs[]`, not a mirror to keep in sync. The row is a RENDERING — one line,
+ * because six rows of single digits crowd out every real specification on a
+ * part page — and this is the VALUE, which is what a sort, a filter, a
+ * side-by-side comparison and the simulation all need. Neither can do the
+ * other's job, and both are produced by one parse in one pass, so there is no
+ * second write path to forget (unlike Root Cause #42's shape).
+ *
+ * Every key is OPTIONAL because the source states them per part: a page that
+ * gives Attack and Burst and nothing else yields exactly those two. A missing
+ * key is "not stated", never zero — `weight: 0` is a real rating on a
+ * featherweight disc and must stay distinguishable from silence.
+ *
+ * The scale is 0–6 and is the wiki's own editorial judgement, not a
+ * measurement. It is useful for comparison between parts of the same slot and
+ * should not be presented as a physical quantity.
+ */
+export interface PartRatings {
+    attack?: number;
+    defense?: number;
+    stamina?: number;
+    weight?: number;
+    speed?: number;
+    burst?: number;
+    dash?: number;
+    burstResistance?: number;
+    power?: number;
+    height?: number;
+    runTime?: number;
+}
+/**
+ * WBO tournament-format legality.
+ *
+ * 🛑 A format the source does not rule on is ABSENT, never `false`. Three
+ * states exist — legal, banned, and not stated — and collapsing the third into
+ * the second would publish "banned in Burst Classic" as a fact about every
+ * part whose page simply never mentions Burst Classic.
+ */
+export interface PartWboLegality {
+    burst?: boolean;
+    burstGt?: boolean;
+    burstLimited?: boolean;
+    burstClassic?: boolean;
+    xStandard?: boolean;
+    xMasters?: boolean;
+    xOpen?: boolean;
+    mfbStandard?: boolean;
+    mfbLimited?: boolean;
+    mfbZeroG?: boolean;
+    mfb4d?: boolean;
+}
+/**
+ * OUR role vocabulary — 10 values covering all 59 slots.
+ *
+ * Mirrors `PART_ROLE` in `scripts/lib/part-slot-vocab.mjs`, which is the
+ * source. A slot missing from that map yields no `role` rather than a guess.
+ */
+export type PartRole = "chip" | "ring" | "wheel" | "weight" | "base" | "blade" | "track" | "tip" | "gear" | "support";
 export interface PartGlossaryDocument extends BaseDocument {
     /** `${slot}--${codeOrSlug}` — both halves, because a code is not unique. */
     id: string;
@@ -294,6 +355,192 @@ export interface PartGlossaryDocument extends BaseDocument {
      * it is a DIFFERENT axis from colour and must not be folded into it.
      */
     hasMoldVariations?: boolean;
+    /**
+     * The 0–6 stat grid as numbers. Present on 1,149 of 2,490 rows — the source
+     * states it per part, so absence is "not stated", not zero.
+     */
+    ratings?: PartRatings;
+    /**
+     * The ceiling `ratings` are out of — 6, 8 or 100.
+     *
+     * 🛑 LOAD-BEARING, because each generation rates on its own scale and they
+     * share these fields. Measured: Beyblade X rates 0-100 (237 rows) while
+     * Burst rates 0-6 or 0-8 (945 rows), so mean `attack` by slot reads
+     * `blade 31.8` beside `driver 1.78`. Anything that sorts, compares or
+     * simulates on a rating MUST divide by this first; without it a Beyblade X
+     * blade outranks every Burst layer five times over.
+     *
+     * Derived per system from the highest rating observed for it, rounded up to
+     * a standard step — not from a hand-written table, which was wrong within
+     * one run (`warrior-wheel--dragoon` carries attack 7 against a declared 6).
+     */
+    ratingScale?: number;
+    /**
+     * The same axes rescaled to 0-100, so a part can be compared ACROSS
+     * generations — which the game needs, since it has cross-gen battles.
+     *
+     * 🛑 This equalises the EDITORIAL JUDGEMENT, not the capability. A Burst
+     * layer at 6/6 and a Beyblade X blade at 100/100 both land on 100 and are
+     * not equally strong — that blade is 30 g against the layer's 13 g. So it
+     * answers "how good is this part for its generation", which is the right
+     * basis for a balanced roster and the wrong basis for claiming physical
+     * equivalence. `weightG` carries the latter, in grams, unnormalised.
+     *
+     * `ratings` stays raw beside it: a normalised value can be recomputed from
+     * the raw pair, a discarded raw value cannot.
+     *
+     * 🛑 FOR COMPARING OPPONENTS, NEVER FOR SUGGESTING A BUILD. A bey can only
+     * be ASSEMBLED within one generation — a Burst layer does not fit a Beyblade
+     * X ratchet — while battles are cross-generation. So this field belongs in a
+     * matchup, a leaderboard or a side-by-side, and a "build your own" picker
+     * must constrain to a single system's stack regardless of what it says.
+     */
+    ratingsNormalised?: PartRatings;
+    /** WBO format legality across 11 formats; an unstated format is absent. */
+    wboLegality?: PartWboLegality;
+    /**
+     * Other names for this exact part — the community abbreviation (`Armor Tip
+     * - Adventure` is `Ad`) and the other vendor's name. On 1,072 of 2,490 rows.
+     * Feeds search, so a buyer can find a part by the code printed on it.
+     */
+    aka?: string[];
+    /**
+     * Hasbro's own product code, a SEPARATE field from `productCodes`. On 309
+     * rows, and it is the Hasbro <-> Takara-Tomy equivalence stated outright.
+     */
+    hasbroCode?: string;
+    /** Attack / Defense / Stamina / Balance, per part. 793 rows. */
+    partType?: string;
+    /** Right-Spin / Left-Spin / Dual. 756 rows. */
+    spinDirection?: string;
+    /** Beyblade X's attribute label — "Sky" and siblings. 29 rows. */
+    element?: string;
+    /**
+     * The character this part belongs to in the story — `Bit Chip - Black
+     * Dranzer` is Kai Hiwatari's. Only 27 rows, but it is the sole place a PART
+     * is tied to a character.
+     */
+    owner?: string;
+    /** The episode this part appeared in. 22 rows. */
+    appearAnime?: string;
+    /**
+     * OUR OWN classification — what the part DOES, across generations.
+     *
+     * 🛑 `slot` cannot carry this. It mirrors the source's `Classification=`
+     * spelling and it is half of every document id (`${slot}--${code}`), and
+     * those ids are LIVE URLS (`/parts/{classification}/{code}`). Renaming a
+     * slot re-keys 2,490 rows and breaks every inbound link — a slug is the one
+     * field that cannot be quietly corrected later. So this is additive.
+     *
+     * It collapses the source's line-specific names onto one role:
+     * `bu-blade` / `qs-blade` / `blade` are all `blade`; the six Burst chip
+     * variants are all `chip`. Derived in `scripts/lib/part-slot-vocab.mjs`,
+     * which covers all 59 slots with 10 roles.
+     */
+    /**
+     * The part SYSTEM — "Dynamite Battle Layer System", "4D System", "Basic
+     * Line". Stated on 1,961 of 2,087 source pages (94%).
+     *
+     * 🛑 This is the generation key, and it is load-bearing rather than
+     * decorative:
+     *
+     * 1. ASSEMBLY IS WITHIN-GENERATION ONLY. No bey can be built across
+     *    generations, and Plastic and HMS do not interchange either, so a build
+     *    validator needs each part's system. Nothing else on the row answers it.
+     *
+     * 2. ONE SLOT CAN HOLD TWO DIFFERENT PARTS. `blade` is the measured case:
+     *    Beyblade X blades are metal at a ~32 g median while Burst QuadDrive and
+     *    Dynamite Battle blades are plastic at ~7-11 g. A per-slot mass band
+     *    cannot be correct for both, and without this field nothing downstream
+     *    could tell them apart.
+     */
+    system?: string;
+    /** The retail series — "Beyblade Burst QuadStrike", "Beyblade: Metal Fury". */
+    series?: string;
+    role?: PartRole;
+    /**
+     * Every stack role one moulding fills, listed TOP-TO-BOTTOM. A part that
+     * covers a single position does not carry this field at all.
+     *
+     * Integration is real and spans generations: HMS merges spin gear and blade
+     * base into a Running Core, a 4D Bottom (`D:D`, `X:D`) is a spin track and
+     * a performance tip in one piece, a Burst `disc-integrated-driver` is a disc
+     * and a driver, and `fusion-wheel--variares` is an energy ring and a fusion
+     * wheel. A Plastic-era base can integrate its Sub Attack Ring.
+     *
+     * 🛑 Load-bearing for any stack validation. `role` files an integrated part
+     * under its PRIMARY function, so a validator reading only that believes the
+     * other position is still empty and offers a part that cannot physically go
+     * there — it will refuse a legal build, and an exploded 3D view will show a
+     * gap where a solid piece is.
+     *
+     * 🛑 PER PART, NOT PER SLOT — that is the whole reason this is a field and
+     * not a lookup. `fusion-wheel--variares` integrates the ring and
+     * `fusion-wheel--jade` does not; same slot, different moulding. Jade is
+     * multi-PIECE, which is a different fact (see `pieceCount` when it lands).
+     *
+     * 🛑 Do NOT re-spell this as "fused". "Fusion Wheel" is a literal MFB slot
+     * name, so `fusedRoles` reads as *the roles of the fusion wheel* — the
+     * opposite of the meaning. The source's own slot names already use the
+     * right word: `disc-integrated-driver`, `ratchet-integrated-bit`.
+     *
+     * Populated by `scripts/derive-part-integration.mjs`, which reads it off the
+     * compositions each part actually appears in — the source states a 4D
+     * Bottom's `Classification` as plain "Performance Tip", so this cannot be
+     * copied from an infobox and is not guessed either.
+     */
+    integratedRoles?: PartRole[];
+    /**
+     * An owner-uploaded 3D model. Empty by default and deliberately so — the
+     * models are supplied by the owner, not ingested from anywhere.
+     *
+     * 🛑 NEVER served through `/api/media/[...slug]`. That route applies NO
+     * authentication, raw-pipes non-images with a 30-day immutable cache, and
+     * sits over a bucket whose storage rule is `allow read: if true` — so a GLB
+     * there is a public download. A mesh is the asset someone could build a
+     * competing game from, so it needs a signed, short-lived URL and an
+     * authenticated route of its own.
+     *
+     * 🛑 And a browser viewer cannot make a mesh unextractable — WebGL buffers
+     * can be dumped from any page that renders them. The honest mitigation is to
+     * publish a DECIMATED preview and keep the full-resolution mesh server-side;
+     * "protected" here means inconvenient, never impossible.
+     */
+    model3d?: {
+        url: string;
+        format: "glb";
+        sizeBytes: number;
+        /** A low-poly public preview, when the full mesh is held back. */
+        previewUrl?: string;
+        credit?: string;
+        creditUrl?: string;
+    };
+    /**
+     * An owner-uploaded sound, with its waveform for display.
+     *
+     * Renders through the existing `<MediaAudio>` primitive, so this needs no
+     * new UI primitive. `waveform` is a coarse amplitude array for drawing the
+     * trace without decoding the audio client-side.
+     */
+    sound?: {
+        url: string;
+        durationMs?: number;
+        waveform?: number[];
+        label?: string;
+    };
+    /**
+     * The Japanese name, the romanisation, and the kanji where the source gives
+     * one.
+     *
+     * 🛑 Top-level fields AS WELL AS `specs[]` rows, which is not duplication for
+     * its own sake: a `<title>`, an `og:title`, an hreflang alternate and a
+     * JSON-LD `alternateName` all need a FIELD. None of them can scan an array
+     * of label/value pairs for one whose label happens to read "Japanese name",
+     * and that is where these 1,068 values previously lived and died.
+     */
+    jpName?: string;
+    romaji?: string;
+    kanjiName?: string;
     /** `/media/<slug>`. 🛑 Never a raw Storage host URL. */
     image?: string;
     /** The wiki page the photo came from — the CC-BY-SA attribution target. */

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

@@ -269,11 +269,11 @@ export const PART_SLOT_CATEGORY = {
     // Burst — a driver with the disc moulded in is still a driver.
     "disc-integrated-driver": "category-burst-drivers",
     // Beyblade X — the CX Custom line, which has its own node.
-    "lock-chip": "category-x-custom-cx",
-    "main-blade": "category-x-custom-cx",
-    "assist-blade": "category-x-custom-cx",
-    "over-blade": "category-x-custom-cx",
-    "metal-blade": "category-x-custom-cx",
+    "lock-chip": "category-x-lock-chips",
+    "main-blade": "category-x-main-blades",
+    "assist-blade": "category-x-assist-blades",
+    "over-blade": "category-x-over-blades",
+    "metal-blade": "category-x-metal-blades",
     "gear-chip": "category-x-custom-cx",
     // Beyblade X — integrated parts file under the half a buyer shops for.
     "ratchet-integrated-blade": "category-x-blades",
@@ -290,7 +290,7 @@ export const PART_SLOT_CATEGORY = {
     "evolution-gear": "category-original-engine-gears",
     "bit-protector": "category-original-bit-chips",
     cew: "category-original-weight-disks",
-    "support-parts": "category-original-parts",
+    "support-parts": "category-original-support-parts",
 };
 /** Every slot key, for an index page that must not hand-write the list. */
 export const ALL_PART_SLOTS = Object.values(PART_SLOT_VALUES);

package/dist/features/pre-orders/components/MarketplacePreorderCard.d.ts

@@ -23,5 +23,15 @@ export interface MarketplacePreorderCardProps {
     onAddToCart?: (product: MarketplacePreorderCardData) => void;
     wishlistActions?: WishlistToggleActions;
     labels?: MarketplacePreorderCardLabels;
+    /**
+     * Owner-only pencil / clone / bin. Pass `<OwnerQuickActions>`; it renders
+     * nothing for a visitor who does not own the record.
+     *
+     * 🛑 Rendered OUTSIDE this card's own anchor, as a sibling. A `<button>`
+     * inside an `<a>` is invalid HTML that browsers resolve by closing the
+     * anchor early, which breaks the CARD's navigation rather than just the
+     * button's — `stopPropagation` stops a click but cannot fix a parse.
+     */
+    renderOwnerActions?: () => React.ReactNode;
 }
-export declare function MarketplacePreorderCard({ product, className, variant, selectable, isSelected, onSelect, inWishlist: initialInWishlist, href, hrefBuilder, onNavigate, onAddToCart, wishlistActions, labels, }: MarketplacePreorderCardProps): import("react").JSX.Element;
+export declare function MarketplacePreorderCard({ product, className, variant, selectable, isSelected, onSelect, inWishlist: initialInWishlist, href, hrefBuilder, onNavigate, onAddToCart, wishlistActions, labels, renderOwnerActions, }: MarketplacePreorderCardProps): import("react").JSX.Element;

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

@@ -14,7 +14,7 @@ const CLS_PREORDER_BADGE = "inline-flex items-center rounded-full bg-warning-sol
 const CLS_SALE_BADGE = "rounded-full bg-success-solid px-[var(--appkit-space-2)] py-[var(--appkit-space-0-5)] text-[length:var(--appkit-text-xs)] font-bold text-success-on-solid";
 const CLS_TRENDING_BADGE = "rounded-full bg-indigo-600 px-[var(--appkit-space-2)] py-[var(--appkit-space-0-5)] text-[length:var(--appkit-text-xs)] font-bold text-white";
 const CLS_LIMITED_BADGE = "rounded-full bg-info-solid px-[var(--appkit-space-2)] py-[var(--appkit-space-0-5)] text-[length:var(--appkit-text-xs)] font-bold text-info-on-solid";
-import { BaseListingCard, Button, GatedPrice, RichText, Row, Span, Stack, Text, TextLink } from "../../../ui/index.js";
+import { Div, BaseListingCard, Button, GatedPrice, RichText, Row, Span, Stack, Text, TextLink } from "../../../ui/index.js";
 import { normalizeRichTextHtml } from "../../../utils/string.formatter.js";
 import { PreorderBadge } from "./PreorderCard.js";
 import { WishlistHeartButton } from "../../wishlist/components/WishlistHeartButton.js";
@@ -34,7 +34,7 @@ function resolveHref(product, href, hrefBuilder) {
         return hrefBuilder(product);
     return ROUTES.PUBLIC.PRE_ORDER_DETAIL(product.slug ?? product.id);
 }
-export function MarketplacePreorderCard({ product, className = "", variant = "grid", selectable = false, isSelected = false, onSelect, inWishlist: initialInWishlist = false, href, hrefBuilder, onNavigate, onAddToCart, wishlistActions, labels, }) {
+export function MarketplacePreorderCard({ product, className = "", variant = "grid", selectable = false, isSelected = false, onSelect, inWishlist: initialInWishlist = false, href, hrefBuilder, onNavigate, onAddToCart, wishlistActions, labels, renderOwnerActions, }) {
     const router = useRouter();
     const mergedLabels = { ...DEFAULT_LABELS, ...labels };
     const detailHref = resolveHref(product, href, hrefBuilder);
@@ -61,7 +61,7 @@ export function MarketplacePreorderCard({ product, className = "", variant = "gr
             void normalizeError(_err);
         }
     }, [toggle]);
-    return (_jsxs(BaseListingCard, { isSelected: isSelected, variant: variant, className: className, onMouseDown: !isSelected ? longPress.onMouseDown : undefined, onMouseUp: !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: !isSelected ? longPress.onTouchEnd : undefined, onTouchCancel: !isSelected ? longPress.onTouchCancel : undefined, children: [_jsxs(BaseListingCard.Hero, { aspect: "square", variant: variant, children: [_jsx(TextLink, { href: detailHref, className: "absolute inset-0 block", children: _jsx(MediaImage, { src: product.mainImage, alt: product.title, size: "card", fallback: "Product image" }) }), _jsxs(Stack, { className: "absolute right-2 top-2", align: "end", gap: "xs", children: [_jsx(Span, { layout: "inline-flex", color: "inverse", size: "xs", weight: "medium", className: "bg-cobalt", rounded: "full", padding: "pill-xs", children: mergedLabels.preOrderBadge }), product.featured && (_jsx(Span, { size: "xs", weight: "medium", className: CLS_PREORDER_BADGE, children: mergedLabels.featuredBadge }))] }), _jsxs(Stack, { className: "absolute left-2 top-2 pointer-events-none", gap: "xs", children: [product.partOfBundleIds && product.partOfBundleIds.length > 0 && (_jsx(Span, { className: CLS_SALE_BADGE, title: product.partOfBundleTitles?.[0] ? `In bundle: ${product.partOfBundleTitles[0]}` : "In a bundle", children: "Bundled" })), product.groupId && (_jsx(Span, { className: CLS_TRENDING_BADGE, title: product.groupTitle ? `Part of set: ${product.groupTitle}` : "Part of a set", children: product.isGroupParent ? "Set Parent" : "In Set" })), product.sublistingCategoryId && (_jsx(Span, { className: CLS_LIMITED_BADGE, title: "Has variants or sub-listings", children: "Has Variants" }))] }), onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (event) => {
+    const card = (_jsxs(BaseListingCard, { isSelected: isSelected, variant: variant, className: className, onMouseDown: !isSelected ? longPress.onMouseDown : undefined, onMouseUp: !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: !isSelected ? longPress.onTouchEnd : undefined, onTouchCancel: !isSelected ? longPress.onTouchCancel : undefined, children: [_jsxs(BaseListingCard.Hero, { aspect: "square", variant: variant, children: [_jsx(TextLink, { href: detailHref, className: "absolute inset-0 block", children: _jsx(MediaImage, { src: product.mainImage, alt: product.title, size: "card", fallback: "Product image" }) }), _jsxs(Stack, { className: "absolute right-2 top-2", align: "end", gap: "xs", children: [_jsx(Span, { layout: "inline-flex", color: "inverse", size: "xs", weight: "medium", className: "bg-cobalt", rounded: "full", padding: "pill-xs", children: mergedLabels.preOrderBadge }), product.featured && (_jsx(Span, { size: "xs", weight: "medium", className: CLS_PREORDER_BADGE, children: mergedLabels.featuredBadge }))] }), _jsxs(Stack, { className: "absolute left-2 top-2 pointer-events-none", gap: "xs", children: [product.partOfBundleIds && product.partOfBundleIds.length > 0 && (_jsx(Span, { className: CLS_SALE_BADGE, title: product.partOfBundleTitles?.[0] ? `In bundle: ${product.partOfBundleTitles[0]}` : "In a bundle", children: "Bundled" })), product.groupId && (_jsx(Span, { className: CLS_TRENDING_BADGE, title: product.groupTitle ? `Part of set: ${product.groupTitle}` : "Part of a set", children: product.isGroupParent ? "Set Parent" : "In Set" })), product.sublistingCategoryId && (_jsx(Span, { className: CLS_LIMITED_BADGE, title: "Has variants or sub-listings", children: "Has Variants" }))] }), onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (event) => {
                             event.stopPropagation();
                             onSelect(product.id, !isSelected);
                         }, className: selectable || isSelected ? "opacity-100" : "opacity-0 pointer-events-none group-hover:opacity-100 group-hover:pointer-events-auto transition-opacity" }))] }), _jsx(BaseListingCard.Info, { variant: variant, children: variant === "list" ? (
@@ -69,4 +69,11 @@ export function MarketplacePreorderCard({ product, className = "", variant = "gr
                 _jsxs(_Fragment, { children: [_jsxs(Row, { className: "min-w-0", align: "start", justify: "between", gap: "sm", children: [_jsx(TextLink, { href: detailHref, className: "min-w-0 flex-1", children: _jsx(Text, { size: "sm", weight: "medium", color: "primary", truncate: 2, children: product.title }) }), wishlistActions && (_jsx(WishlistHeartButton, { size: "inline", inWishlist: inWishlist, addLabel: mergedLabels.addToWishlist, removeLabel: mergedLabels.removeFromWishlist, onToggle: handleWishlist }))] }), _jsx(CardStoreLine, { storeName: product.storeName, storeId: product.storeId }), _jsxs(Row, { align: "center", gap: "sm", wrap: true, children: [_jsx(Text, { className: "text-primary", size: "sm", weight: "bold", children: _jsx(GatedPrice, { children: formatCurrency(product.price, getDefaultCurrency()) }) }), shipDate && _jsx(PreorderBadge, { shipDate: shipDate })] }), _jsx(Button, { type: "button", variant: "primary", size: "sm", textSize: "xs", className: "self-start mt-0.5", onClick: handleNavigate, children: mergedLabels.reserveNow })] })) : (
                 /* ── Full grid layout ── */
                 _jsxs(_Fragment, { children: [_jsx(TextLink, { href: detailHref, children: _jsx(Text, { size: "sm", weight: "medium", color: "primary", truncate: 2, children: product.title }) }), _jsx(CardStoreLine, { storeName: product.storeName, storeId: product.storeId }), product.description ? (_jsx(RichText, { html: normalizeRichTextHtml(product.description), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "line-clamp-2 text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)]" })) : null, _jsxs(Row, { justify: "between", className: "mt-1", gap: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: _jsx(GatedPrice, { children: formatCurrency(product.price, getDefaultCurrency()) }) }), shipDate && _jsx(PreorderBadge, { shipDate: shipDate })] }), _jsxs(Row, { justify: "between", className: "mt-auto pt-[var(--appkit-space-2)]", gap: "sm", children: [_jsx(Button, { type: "button", variant: "primary", size: "sm", textSize: "xs", className: "flex-1", onClick: handleNavigate, children: mergedLabels.reserveNow }), onAddToCart ? (_jsx(Button, { type: "button", variant: "outline", size: "sm", textSize: "xs", className: "flex-1", onClick: (e) => { e.stopPropagation(); onAddToCart(product); }, children: mergedLabels.addToCart })) : null, wishlistActions ? (_jsx(WishlistHeartButton, { size: "inline", inWishlist: inWishlist, addLabel: mergedLabels.addToWishlist, removeLabel: mergedLabels.removeFromWishlist, onToggle: handleWishlist })) : null] })] })) })] }));
+    if (!renderOwnerActions)
+        return card;
+    /*
+     * Sibling of the card, never a child — see the prop's docstring. `z-20`
+     * clears this card's own overlays, which all sit at `z-10`.
+     */
+    return (_jsxs(Div, { className: "relative h-full", children: [card, _jsx(Div, { className: "absolute right-2 bottom-2 z-20", children: renderOwnerActions() })] }));
 }

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

@@ -27,6 +27,7 @@ import { ProductGalleryClient } from "../../products/components/ProductGalleryCl
 import { ProductFeatureBadges } from "../../products/components/ProductFeatureBadges.js";
 import { isFinalSale } from "../../products/constants/final-sale.js";
 import { FeatureBadgeList } from "../../products/components/FeatureBadge.js";
+import { productImageUrls } from "../../products/schemas/firestore.js";
 import { ShareButton } from "../../products/components/ShareButton.js";
 import { SublistingCarouselSection } from "../../products/components/SublistingCarouselSection.js";
 import { HistoryTracker } from "../../history/components/HistoryTracker.js";
@@ -35,6 +36,7 @@ import { RelatedItemsSection } from "../../products/components/RelatedItemsSecti
 import { computeRelatedItems } from "../../../_internal/server/features/products/data.js";
 import { GroupedListingsCarousel } from "../../grouped/components/GroupedListingsCarousel.js";
 import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data.js";
+import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
 function toDescriptionHtml(raw) {
     if (!raw)
         return "";
@@ -46,8 +48,8 @@ const PRODUCTION_STATUS_LABELS = {
     in_production: "In Production",
     ready_to_ship: "Ready to Ship",
 };
-function PreOrderInfoSection({ title, productionStatus, maxPerUser, deliveryDate, featured, freeShipping, condition, isCancellable, finalSale, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref, }) {
-    return (_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_PREORDER_BADGE, children: "Pre-Order" }), productionStatus && (_jsx(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: PRODUCTION_STATUS_LABELS[productionStatus] ?? productionStatus })), maxPerUser !== null && (_jsxs(Span, { size: "xs", weight: "medium", className: CLS_STATUS_BADGE, children: ["Limit: ", maxPerUser, " per customer"] }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), deliveryDate && (_jsxs(Row, { color: "muted", textSize: "sm", align: "center", gap: "xs", children: [_jsx(Span, { children: "\uD83D\uDCC5" }), _jsx(Span, { children: "Estimated delivery:" }), _jsx(Span, { weight: "medium", children: deliveryDate.toLocaleDateString(undefined, { year: "numeric", month: "long" }) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, returnable: isCancellable, finalSale: finalSale, labels: {
+function PreOrderInfoSection({ title, productId, storeId, productionStatus, maxPerUser, deliveryDate, featured, freeShipping, condition, isCancellable, finalSale, category, categoryName, brand, brandSlug, productFeatures, features, descriptionHtml, safeSeller, storeHref, }) {
+    return (_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_PREORDER_BADGE, children: "Pre-Order" }), productionStatus && (_jsx(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: PRODUCTION_STATUS_LABELS[productionStatus] ?? productionStatus })), maxPerUser !== null && (_jsxs(Span, { size: "xs", weight: "medium", className: CLS_STATUS_BADGE, children: ["Limit: ", maxPerUser, " per customer"] }))] }), productId && (_jsx(OwnerQuickActions, { resource: "PRODUCT", placement: "detail", recordLabel: title, storeId: storeId, editHref: String(ROUTES.STORE.PRODUCTS_EDIT(productId)) })), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), deliveryDate && (_jsxs(Row, { color: "muted", textSize: "sm", align: "center", gap: "xs", children: [_jsx(Span, { children: "\uD83D\uDCC5" }), _jsx(Span, { children: "Estimated delivery:" }), _jsx(Span, { weight: "medium", children: deliveryDate.toLocaleDateString(undefined, { year: "numeric", month: "long" }) })] })), _jsx(ProductFeatureBadges, { featured: featured, freeShipping: freeShipping, condition: condition ?? undefined, returnable: isCancellable, finalSale: finalSale, labels: {
                     featured: "Featured",
                     fasterDelivery: "Faster Delivery",
                     ratedSeller: "Rated Seller",
@@ -86,8 +88,12 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
     const currency = p.currency || getDefaultCurrency();
     const title = String(p.title ?? p.name ?? "Pre-Order Item");
     const price = typeof p.price === "number" ? p.price : null;
-    const images = Array.isArray(p.images)
-        ? p.images
+    // `images` is `ProductImage[]` since A6 — `productImageUrls` is the one
+    // normaliser (it also accepts the legacy `string[]`). Casting it to
+    // `string[]` handed the gallery objects and rendered a placeholder.
+    const galleryUrls = productImageUrls(p.images);
+    const images = galleryUrls.length > 0
+        ? galleryUrls
         : typeof p.mainImage === "string"
             ? [p.mainImage]
             : [];
@@ -153,15 +159,11 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
     ]);
     return (_jsxs(Main, { children: [_jsx(HistoryTracker, { productId: String(p.id ?? p.slug ?? ""), productType: "preorder", snapshot: {
                     title: typeof p.title === "string" ? p.title : undefined,
-                    thumb: typeof p.mainImage === "string"
-                        ? p.mainImage
-                        : Array.isArray(p.images) && typeof p.images[0] === "string"
-                            ? p.images[0]
-                            : undefined,
+                    thumb: typeof p.mainImage === "string" ? p.mainImage : images[0],
                     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(PreOrderDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title })), renderInfo: () => (_jsx(PreOrderInfoSection, { title: title, 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(PreOrderDetailView, { renderGallery: () => (_jsx(ProductGalleryClient, { images: images, video: productVideo, productName: title })), renderInfo: () => (_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 }))

package/dist/features/price-index/components/PriceIndexToolView.d.ts

@@ -79,6 +79,27 @@ export interface PriceIndexToolResponse {
     truncated: boolean;
     minConfidentSamples: number;
 }
+/**
+ * The competitor-crawl band for one leaf. Mirrors `PriceIndexMarketRow`.
+ *
+ * Every field but `median` and `categoryId` is optional because the crawl
+ * genuinely did not measure them everywhere, and an absent figure must render
+ * as absent. See `price-bands.md`: "a band with `n=2` is not evidence".
+ */
+export interface PriceIndexMarketRowView {
+    categoryId: string;
+    median: number;
+    p25?: number;
+    p75?: number;
+    sampleSize?: number;
+    asOf?: string;
+    soldOutShare?: number;
+    source?: string;
+    inherited: boolean;
+    viaCategoryId?: string;
+    viaName?: string;
+    taxBasis: string;
+}
 export interface PriceIndexToolViewProps {
     /** Seeded from `?q=` so a shared link reproduces the lookup. */
     initialQuery?: string;