@mohasinac/appkit 4.53.1 → 4.54.0-next.0

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,172 @@ 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.
+     */
+    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";
@@ -86,8 +87,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,11 +158,7 @@ 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,

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;