@mohasinac/appkit 4.53.0 → 4.53.2

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

@@ -0,0 +1,57 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * WHY: 752 parts were reachable only by drilling classification -> code.
+ *      `/parts` had no search input anywhere.
+ * WHAT: A search box over the `part` slice of the local index. Zero Firestore
+ *       reads, and it resolves the code ambiguity in the result row.
+ *
+ * ## 🛑 The ambiguity is the feature, not a problem to hide
+ *
+ * `route-map.ts` explains why a code alone cannot be a URL: "`105` is a Metal
+ * Fight spin-track height, a bare number in Burst is a disc, and `1-60` is a
+ * Beyblade X ratchet." So the honest answer to "105" is THREE results, each
+ * naming its classification and each linking to the right two-segment path —
+ * not one result picked by whatever sorted first.
+ *
+ * That is exactly what the index already carries: the part source puts the
+ * classification in `detail` for precisely this reason, and derives the slug
+ * by splitting the `${slot}--${code}` document id, which is the one
+ * derivation guaranteed to agree with the page that exists.
+ *
+ * ## It does not replace the drill-down
+ *
+ * The classification grid stays. Browsing by "what kind of thing is this" is
+ * a different question from "where is the part I can already name", and the
+ * grid is the only one of the two that works when you do not know the word.
+ *
+ * @tag domain:parts
+ * @tag layer:feature
+ * @tag pattern:none
+ * @tag access:client
+ * @tag consumers:app/[locale]/parts/page.tsx
+ * @tag sideEffects:network
+ */
+import React from "react";
+import { Div, Input, Stack, Text, TextLink } from "../../../ui/index.js";
+import { useSiteSearch } from "../../search/hooks/useSiteSearch.js";
+/** Only this slice of the index. See `resolveEntity`'s `types` parameter. */
+const PART_TYPES = ["part"];
+/** Stable identity — a `useMemo` dependency inside the hook. */
+const partLabel = () => "Parts";
+export function PartsSearchBox({ indexEnabled, placeholder = "Search parts by name or code — RF, 105, Rubber Flat…", limit = 10, }) {
+    const [query, setQuery] = React.useState("");
+    const [active, setActive] = React.useState(false);
+    const { status, result } = useSiteSearch(query, {
+        active,
+        indexEnabled,
+        types: PART_TYPES,
+        label: partLabel,
+    });
+    const hits = result?.groups[0]?.hits ?? [];
+    const typed = query.trim().length > 0;
+    return (_jsxs(Stack, { gap: "sm", className: "min-w-0", children: [_jsx(Input, { type: "search", value: query, placeholder: placeholder, "aria-label": "Search parts", onFocus: () => setActive(true), onChange: (event) => {
+                    setActive(true);
+                    setQuery(event.target.value);
+                } }), typed && status === "loading" && _jsx(Text, { color: "muted", children: "Searching\u2026" }), typed && (status === "failed" || status === "disabled") && (_jsx(Text, { size: "sm", color: "muted", children: "Part search is unavailable right now \u2014 browse by classification below." })), typed && status === "ready" && hits.length === 0 && (_jsx(Text, { color: "muted", children: "No part matches that name or code." })), hits.length > 0 && (_jsx(Stack, { gap: "xs", className: "min-w-0", children: hits.slice(0, limit).map((hit) => (_jsxs(Div, { surface: "card", padding: "sm", rounded: "md", border: "subtle", children: [_jsx(TextLink, { href: hit.href, children: hit.title }), hit.detail && (_jsx(Text, { size: "xs", color: "muted", children: hit.detail }))] }, hit.id))) }))] }));
+}

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

@@ -59,6 +59,45 @@ export declare const PART_SLOT_VALUES: {
     readonly BLADE: "blade";
     readonly RATCHET: "ratchet";
     readonly BIT: "bit";
+    readonly GT_CHIP: "gt-chip";
+    readonly GATINKO_CHIP: "gatinko-chip";
+    readonly BASE: "base";
+    readonly SUPERKING_CHIP: "superking-chip";
+    readonly DB_CORE: "db-core";
+    readonly RING: "ring";
+    readonly ARMOR_TIP: "armor-tip";
+    readonly FRAME: "frame";
+    readonly CHASSIS: "chassis";
+    readonly BU_BLADE: "bu-blade";
+    readonly QS_BLADE: "qs-blade";
+    readonly DRIVE_CHIP: "drive-chip";
+    readonly STORM_CHIP: "storm-chip";
+    readonly STRIKE_CHIP: "strike-chip";
+    readonly GRAVITY_RING: "gravity-ring";
+    readonly SPIRIT_SHIELD: "spirit-shield";
+    readonly SPIRIT_AXLE: "spirit-axle";
+    readonly DISC_INTEGRATED_DRIVER: "disc-integrated-driver";
+    readonly LOCK_CHIP: "lock-chip";
+    readonly MAIN_BLADE: "main-blade";
+    readonly ASSIST_BLADE: "assist-blade";
+    readonly OVER_BLADE: "over-blade";
+    readonly METAL_BLADE: "metal-blade";
+    readonly RATCHET_INTEGRATED_BLADE: "ratchet-integrated-blade";
+    readonly RATCHET_INTEGRATED_BIT: "ratchet-integrated-bit";
+    readonly WARRIOR_WHEEL: "warrior-wheel";
+    readonly ELEMENT_WHEEL: "element-wheel";
+    readonly LIGHT_WHEEL: "light-wheel";
+    readonly WHEEL: "wheel";
+    readonly SHOGUN_FACE_BOLT: "shogun-face-bolt";
+    readonly DOME_SPIN_TRACK: "dome-spin-track";
+    readonly EVOLUTION_GEAR: "evolution-gear";
+    readonly BIT_PROTECTOR: "bit-protector";
+    readonly WEIGHT: "weight";
+    readonly CORE: "core";
+    readonly SUPPORT_PARTS: "support-parts";
+    readonly SUB_ATTACK_RING: "sub-attack-ring";
+    readonly CEW: "cew";
+    readonly GEAR_CHIP: "gear-chip";
 };
 export type PartSlot = (typeof PART_SLOT_VALUES)[keyof typeof PART_SLOT_VALUES];
 /**
@@ -122,6 +161,55 @@ export declare const ALL_PART_SLOTS: readonly PartSlot[];
  */
 export declare function partSlotFromSegment(segment: string): PartSlot | null;
 /** One part. */
+/**
+ * How much a given spec value is to be trusted, in the corpus's own
+ * vocabulary so nothing is lost in translation.
+ *
+ * `confirmed` — `FACT(PDB)`, verified against PlasticsDB's own part page, or
+ *               a `[CONFIRMED CSn Case m]` citation in the case study.
+ * `fact`      — a bare `FACT` tag, or a wiki infobox value.
+ * `inferred`  — the source flags it as an inference.
+ * `estimated` — the source marks it approximate. 🛑 A `~` in a COLUMN HEADER
+ *               marks the whole column, which is how gen3/gen4 write it; a
+ *               per-cell check alone would publish 300+ estimates as facts.
+ */
+export type PartSpecConfidence = "confirmed" | "fact" | "inferred" | "estimated";
+/** One labelled specification row. */
+export interface PartSpec {
+    /** "Weight", "Material", "Full width", "Stats", "WBO legality". */
+    label: string;
+    /** Verbatim from the source. Multi-valued cells are never resolved. */
+    value: string;
+    /** "g", "mm". Absent for a non-dimensional value. */
+    unit?: string;
+    /** Which extractor produced it, for the provenance footnote. */
+    source?: string;
+    confidence?: PartSpecConfidence;
+}
+/** One release of a part: which box, which bey, which vendor, which colour. */
+export interface PartRelease {
+    /** "Takara Tomy", "Hasbro", "Sonokong", "Youngtoys". */
+    vendor: string;
+    /** The box code. `BX-00` is the wiki's marker for "no retail number". */
+    code?: string;
+    /** The Beyblade it came in. */
+    bey: string;
+    /** The set or multipack, when the bey shipped inside one. */
+    set?: string;
+    colourway?: string;
+    /** "G1 Prize", "CoroCoro Exclusive" — the channel, not the colour. */
+    distribution?: string[];
+}
+/** A distinct colourway, deduped on (colour, channel). */
+export interface PartColourway {
+    /** "Red Ver.", "Bronze Ver.", "Supreme Dragon Ver.". */
+    colourway: string;
+    vendor: string;
+    code?: string;
+    distribution?: string;
+    /** The bey this colourway was released in. */
+    inBey: string;
+}
 export interface PartGlossaryDocument extends BaseDocument {
     /** `${slot}--${codeOrSlug}` — both halves, because a code is not unique. */
     id: string;
@@ -148,11 +236,70 @@ export interface PartGlossaryDocument extends BaseDocument {
      * than a lookup table.
      */
     usedBy?: string[];
-    /** Code, name and the spoken form of the code — feeds `searchTxt`. */
+    /** Code, name and the spoken form of the code. */
     aliases?: string[];
     /** Which extractor source contributed the row. */
     source?: string;
-    searchTxt?: string[];
+    /**
+     * Labelled specification rows, ready to render.
+     *
+     * 🛑 ONE array rather than a dozen typed fields. Material, dimensions, spin
+     * direction, JP name, romaji, product code, release date, WBO legality and
+     * the 0–6 stat grid all render as "a labelled row" and none has a query, a
+     * sort, a filter or a format of its own. Twelve typed fields would be twelve
+     * projection-triage entries for zero behaviour; promote one the day a reader
+     * is named for it.
+     *
+     * 🛑 NEVER carries a `Weight` row when `weightG` is set. The page renders
+     * the weight as a badge, so a row too would show it twice and the two could
+     * disagree the moment either is edited. The generator enforces this and
+     * `verify-part-specs` asserts it.
+     */
+    specs?: PartSpec[];
+    /**
+     * One sentence per part, generated from the facts above.
+     *
+     * 🛑 GENERATED, NEVER COPIED. Every source page has an `== Description ==`
+     * section and lifting it is both a CC-BY-SA problem and the precise
+     * anti-pattern the competitor crawl recorded of a rival store — wiki bodies
+     * lifted verbatim, one shipping with the literal UI string "Add to
+     * Wishlist". What this replaces is worse than nothing SEO-wise: a template
+     * reading "{name} is a Beyblade {label}. See which models use it", identical
+     * across 752 pages, which made them compete with each other.
+     */
+    seoDescription?: string;
+    /**
+     * Which Beyblades and sets this part shipped in, first-seen order.
+     *
+     * Distinct from `usedBy`, and both are worth having: `usedBy` holds
+     * `modelComposition` IDS that resolve to our own category leaves, while this
+     * holds the wiki's PRODUCT names including sets and multipacks we have no
+     * leaf for. 10,723 references extracted across 2,008 pages.
+     */
+    shippedIn?: string[];
+    /** The per-release rows `shippedIn` and `colourways` are derived from. */
+    releases?: PartRelease[];
+    /**
+     * Colourways, with the channel each was released through.
+     *
+     * 🛑 Absent and empty mean different things. Absent = "we have not looked";
+     * `[]` with `colourwaysDocumented: true` = "a source asserts there are
+     * none". Without that distinction a part with one release and a part we
+     * never checked render identically, which is Root Cause #57's exact symptom.
+     */
+    colourways?: PartColourway[];
+    colourwaysDocumented?: boolean;
+    /**
+     * A mould revision changes the physical part — weight, burst resistance — so
+     * it is a DIFFERENT axis from colour and must not be folded into it.
+     */
+    hasMoldVariations?: boolean;
+    /** `/media/<slug>`. 🛑 Never a raw Storage host URL. */
+    image?: string;
+    /** The wiki page the photo came from — the CC-BY-SA attribution target. */
+    imageSourceUrl?: string;
+    /** "Read more on the Beyblade Wiki". Facts taken, prose theirs, link out. */
+    sourceUrl?: string;
 }
 /** One slot of one model's composition. */
 export interface ModelSlot {
@@ -229,7 +376,6 @@ export interface ModelCompositionDocument extends BaseDocument {
     source?: string;
     /** The named-model category this composition describes, when one exists. */
     categoryId?: string;
-    searchTxt?: string[];
 }
 /** `(slot, code|name)` → document id. The ONE place this is composed. */
 export declare function partGlossaryId(slot: PartSlot, codeOrName: string): string;

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

@@ -27,6 +27,71 @@ export const PART_SLOT_VALUES = {
     BLADE: "blade",
     RATCHET: "ratchet",
     BIT: "bit",
+    /*
+     * ── 🛑 THE OTHER 39, ADDED 2026-10-20 FROM THE WIKI RE-CRAWL ─────────────
+     *
+     * The original 20 predate Gatinko, Sparking, Dynamite Battle, QuadDrive,
+     * QuadStrike, Burst Ultimate and the whole Beyblade X Custom line. These are
+     * not wiki noise — `case study/BEYBLADE MASTER REFERENCE.md` documents the
+     * STACK of each system, and every key below is a slot in one of them:
+     *
+     *   GT / Gatinko  GT Chip -> Layer Base -> Forge Disc -> Driver
+     *   SK / Sparking  Sparking Chip -> Layer Base -> Forge Disc -> Driver
+     *   DB             DB Core -> Armor -> Layer Ring -> Forge Disc -> Driver
+     *   CX             Lock Chip + Main Blade + Assist Blade -> Ratchet -> Bit
+     *   CX Expand      Lock Chip + Over Blade + Metal Blade + Assist Blade -> …
+     *
+     * Measured: the live `Category:Parts` holds 2,261 English pages against our
+     * 752 rows, and 569 of them carried a classification this union could not
+     * express — so they were unrepresentable rather than merely absent.
+     *
+     * 🛑 MAPPED, NOT DUPLICATED. `Forge Disc` is `disc`, `Armor` is `armour`,
+     * `Energy Layer` is `layer`, `Layer Base` is `base`, `Sparking Chip` is
+     * `superking-chip`. A second key for any of them would split one part
+     * family in half: the existing 752 rows in one, every new row in the other.
+     * The alias map lives in `scripts/lib/part-slot-vocab.mjs`, which is the
+     * SOURCE this union mirrors — the same contract the 20 above already have
+     * with `extract-part-composition.mjs`.
+     */
+    GT_CHIP: "gt-chip",
+    GATINKO_CHIP: "gatinko-chip",
+    BASE: "base",
+    SUPERKING_CHIP: "superking-chip",
+    DB_CORE: "db-core",
+    RING: "ring",
+    ARMOR_TIP: "armor-tip",
+    FRAME: "frame",
+    CHASSIS: "chassis",
+    BU_BLADE: "bu-blade",
+    QS_BLADE: "qs-blade",
+    DRIVE_CHIP: "drive-chip",
+    STORM_CHIP: "storm-chip",
+    STRIKE_CHIP: "strike-chip",
+    GRAVITY_RING: "gravity-ring",
+    SPIRIT_SHIELD: "spirit-shield",
+    SPIRIT_AXLE: "spirit-axle",
+    DISC_INTEGRATED_DRIVER: "disc-integrated-driver",
+    LOCK_CHIP: "lock-chip",
+    MAIN_BLADE: "main-blade",
+    ASSIST_BLADE: "assist-blade",
+    OVER_BLADE: "over-blade",
+    METAL_BLADE: "metal-blade",
+    RATCHET_INTEGRATED_BLADE: "ratchet-integrated-blade",
+    RATCHET_INTEGRATED_BIT: "ratchet-integrated-bit",
+    WARRIOR_WHEEL: "warrior-wheel",
+    ELEMENT_WHEEL: "element-wheel",
+    LIGHT_WHEEL: "light-wheel",
+    WHEEL: "wheel",
+    SHOGUN_FACE_BOLT: "shogun-face-bolt",
+    DOME_SPIN_TRACK: "dome-spin-track",
+    EVOLUTION_GEAR: "evolution-gear",
+    BIT_PROTECTOR: "bit-protector",
+    WEIGHT: "weight",
+    CORE: "core",
+    SUPPORT_PARTS: "support-parts",
+    SUB_ATTACK_RING: "sub-attack-ring",
+    CEW: "cew",
+    GEAR_CHIP: "gear-chip",
 };
 /**
  * Buyer-facing label per slot.
@@ -62,6 +127,47 @@ export const PART_SLOT_LABEL = {
     blade: "Blade",
     ratchet: "Ratchet",
     bit: "Bit",
+    // The 39 added 2026-10-20. Labels are the wiki's own `Classification=`
+    // spelling, which is also what a buyer sees printed in product listings.
+    "gt-chip": "GT Chip",
+    "gatinko-chip": "Gatinko Chip",
+    base: "Layer Base",
+    "superking-chip": "Superking Chip",
+    "db-core": "DB Core",
+    ring: "Layer Ring",
+    "armor-tip": "Armor Tip",
+    frame: "Frame",
+    chassis: "Chassis",
+    "bu-blade": "BU Blade",
+    "qs-blade": "QS Blade",
+    "drive-chip": "Drive Chip",
+    "storm-chip": "Storm Chip",
+    "strike-chip": "Strike Chip",
+    "gravity-ring": "Gravity Ring",
+    "spirit-shield": "Spirit Shield",
+    "spirit-axle": "Spirit Axle",
+    "disc-integrated-driver": "Disc-Integrated Driver",
+    "lock-chip": "Lock Chip",
+    "main-blade": "Main Blade",
+    "assist-blade": "Assist Blade",
+    "over-blade": "Over Blade",
+    "metal-blade": "Metal Blade",
+    "ratchet-integrated-blade": "Ratchet-Integrated Blade",
+    "ratchet-integrated-bit": "Ratchet-Integrated Bit",
+    "warrior-wheel": "Warrior Wheel",
+    "element-wheel": "Element Wheel",
+    "light-wheel": "Light Wheel",
+    wheel: "Wheel",
+    "shogun-face-bolt": "Shogun Face Bolt",
+    "dome-spin-track": "Dome Spin Track",
+    "evolution-gear": "Evolution Gear",
+    "bit-protector": "Bit Protector",
+    weight: "Weight",
+    core: "Core",
+    "support-parts": "Support Parts",
+    "sub-attack-ring": "Sub Attack Ring",
+    cew: "Customize Engine Weight",
+    "gear-chip": "Gear Chip",
 };
 /**
  * Which CATEGORY node a part of this classification is filed under.
@@ -123,6 +229,68 @@ export const PART_SLOT_CATEGORY = {
     blade: "category-x-blades",
     ratchet: "category-x-ratchets",
     bit: "category-x-bits",
+    /*
+     * ── The 39 added 2026-10-20 ──────────────────────────────────────────────
+     *
+     * 🛑 EVERY TARGET ALREADY EXISTS IN `category-forest.ts`. Verified against
+     * it rather than assumed: no new parent node is created here, so the forest
+     * is untouched, `buildCategoryTree` derives the same shape it already does,
+     * and the only change is which parent a part leaf nests under. Minting 39
+     * new nodes would be a taxonomy restructure — and the parts layer is moving
+     * out of categories in a follow-up plan anyway, so adding nodes to it now
+     * would be churn with a known expiry.
+     *
+     * Grouped by what the part IS, not by when we learned about it: the Burst
+     * chip/armour node already collects "small Burst component that is not a
+     * layer, disc or driver", which is exactly what GT/Gatinko/Superking/DB/
+     * QuadDrive chips are.
+     */
+    // Burst — layer stack components.
+    base: "category-burst-layers",
+    ring: "category-burst-layers",
+    frame: "category-burst-layers",
+    chassis: "category-burst-layers",
+    "bu-blade": "category-burst-layers",
+    "qs-blade": "category-burst-layers",
+    "gravity-ring": "category-burst-layers",
+    // Burst — chips, armour and the small bits that bolt onto a layer.
+    "gt-chip": "category-burst-chips-armour",
+    "gatinko-chip": "category-burst-chips-armour",
+    "superking-chip": "category-burst-chips-armour",
+    "db-core": "category-burst-chips-armour",
+    "armor-tip": "category-burst-chips-armour",
+    "drive-chip": "category-burst-chips-armour",
+    "storm-chip": "category-burst-chips-armour",
+    "strike-chip": "category-burst-chips-armour",
+    "spirit-shield": "category-burst-chips-armour",
+    "spirit-axle": "category-burst-chips-armour",
+    weight: "category-burst-chips-armour",
+    core: "category-burst-chips-armour",
+    // 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",
+    "gear-chip": "category-x-custom-cx",
+    // Beyblade X — integrated parts file under the half a buyer shops for.
+    "ratchet-integrated-blade": "category-x-blades",
+    "ratchet-integrated-bit": "category-x-bits",
+    // Metal Fight / Shogun Steel.
+    "warrior-wheel": "category-metal-fusion-wheels",
+    "element-wheel": "category-metal-fusion-wheels",
+    "light-wheel": "category-metal-fusion-wheels",
+    wheel: "category-metal-fusion-wheels",
+    "shogun-face-bolt": "category-metal-face-bolts",
+    "dome-spin-track": "category-metal-spin-tracks",
+    // Plastic Generation / HMS.
+    "sub-attack-ring": "category-original-attack-rings",
+    "evolution-gear": "category-original-engine-gears",
+    "bit-protector": "category-original-bit-chips",
+    cew: "category-original-weight-disks",
+    "support-parts": "category-original-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);
@@ -169,6 +337,22 @@ export function partGlossaryId(slot, codeOrName) {
 export const LISTING_TYPE_HAS_COMPOSITION = {
     standard: true,
     auction: true,
+    /*
+     * 🛑 FALSE, and this is the one entry worth arguing for.
+     *
+     * `spares` is tempting to set true — it is the most part-shaped type in the
+     * union — and it would be a worse version of the exact defect this map's
+     * docblock records. A spare attack ring IS a part; it is not the assembly
+     * the composition describes. True would give an attack ring a "Parts" tab
+     * whose contents are an attack ring, a weight disk and a blade base: one
+     * level deeper into wrong than the poster was.
+     *
+     * The reverse direction is the useful one and it is phase F: a spare links
+     * UP to its glossary entry via `sparePartGlossaryId`, and that entry lists
+     * the models the part fits. "What is this a part of" is a real question; "what
+     * parts is this part made of" is not.
+     */
+    spares: false,
     "pre-order": true,
     "prize-draw": true,
     classified: true,

package/dist/features/payments/repository/payout.repository.d.ts

@@ -4,6 +4,7 @@
  * Data access layer for payout documents in Firestore.
  * Handles seller payout requests and admin payout processing.
  */
+import type { JsonValue } from "../../../schemas/types";
 import { BaseRepository, parseSieveDateValue, type SieveModel, type FirebaseSieveResult } from "../../../providers/db-firebase";
 import type { DocumentReference } from "firebase-admin/firestore";
 import type { PayoutDocument, PayoutPlain, PayoutCreateInput, PayoutRefundDeduction, PayoutStatus, PayoutUpdateInput } from "../schemas";
@@ -51,6 +52,20 @@ export declare class PayoutRepository extends BaseRepository<PayoutDocument> {
      */
     protected piiFields: readonly ["sellerEmail", "upiId"];
     protected piiIndexMap: Record<string, string>;
+    /**
+     * Admin search by seller name/email, without decryption.
+     *
+     * 🛑 THIS IS THE ONE THAT MATTERS FOR THE TESTER HARNESS. `payouts` is
+     * SEED_TRANSACTIONAL: it cascades on `storeId` whenever its store is
+     * wiped, then gets RE-SEEDED from `appkit/src/seed/payouts-seed-data.ts`.
+     * The seed file has no `sellerTokensIndex` field — only this hook produces
+     * one — so a one-shot backfill script would have been silently undone by
+     * the very next tester run. Routing through `applyWriteHooks` means the
+     * reseed writes through `createWithId`, which calls this hook, which
+     * regenerates the index — so the field is never actually "missing after a
+     * wipe", because the wipe is always followed by the write that restores it.
+     */
+    protected buildTokensIndexFor(data: Record<string, JsonValue>): Record<string, string[]> | null;
     /**
      * The base hook, plus the nested objects it cannot see.
      *

package/dist/features/payments/repository/payout.repository.js

@@ -4,6 +4,7 @@
  * Data access layer for payout documents in Firestore.
  * Handles seller payout requests and admin payout processing.
  */
+import { buildTokensIndex } from "../../../security/blind-index-tokens.js";
 import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase/index.js";
 import { PAYOUT_COLLECTION, PAYOUT_FIELDS, PAYOUT_TRACKED_FIELDS, createPayoutId } from "../schemas/index.js";
 import { withHistory } from "../../../_internal/shared/history/index.js";
@@ -69,6 +70,26 @@ export class PayoutRepository extends BaseRepository {
     maskedPayouts(docs) {
         return docs.map((d) => this.maskedPayout(d));
     }
+    /**
+     * Admin search by seller name/email, without decryption.
+     *
+     * 🛑 THIS IS THE ONE THAT MATTERS FOR THE TESTER HARNESS. `payouts` is
+     * SEED_TRANSACTIONAL: it cascades on `storeId` whenever its store is
+     * wiped, then gets RE-SEEDED from `appkit/src/seed/payouts-seed-data.ts`.
+     * The seed file has no `sellerTokensIndex` field — only this hook produces
+     * one — so a one-shot backfill script would have been silently undone by
+     * the very next tester run. Routing through `applyWriteHooks` means the
+     * reseed writes through `createWithId`, which calls this hook, which
+     * regenerates the index — so the field is never actually "missing after a
+     * wipe", because the wipe is always followed by the write that restores it.
+     */
+    buildTokensIndexFor(data) {
+        const sellerName = typeof data.sellerName === "string" ? data.sellerName : undefined;
+        const sellerEmail = typeof data.sellerEmail === "string" ? data.sellerEmail : undefined;
+        if (!sellerName && !sellerEmail)
+            return null;
+        return { sellerTokensIndex: buildTokensIndex(sellerName, sellerEmail) };
+    }
     /**
      * The base hook, plus the nested objects it cannot see.
      *

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

@@ -8,7 +8,7 @@ const __P = {
 const __O = {
     hidden: "overflow-hidden",
 };
-const CLS_BREADCRUMB_LINK = "hover:text-primary-600 transition-colors";
+const CLS_BREADCRUMB_LINK = "hover:text-primary-600 dark:hover:text-primary-400 transition-colors";
 const CLS_PREORDER_BADGE = "inline-block rounded-full bg-indigo-100 dark:bg-indigo-900/30 px-[var(--appkit-space-2-5)] py-[var(--appkit-space-0-5)] text-indigo-700 dark:text-indigo-300";
 const CLS_STATUS_BADGE = "inline-block rounded-full bg-warning-surface dark:bg-warning-surface px-[var(--appkit-space-2-5)] py-[var(--appkit-space-0-5)] text-warning dark:text-warning";
 import { ROUTES } from "../../../next/routing/route-map.js";
@@ -17,16 +17,17 @@ import { formatCurrency, roundRupees } from "../../../utils/number.formatter.js"
 import { normalizeRichTextHtml } from "../../../utils/string.formatter.js";
 import { safeDisplayName } from "../../../security/index.js";
 import { ProgressBarFill } from "../../../ui/components/ProgressBarFill.js";
-import { Button, Container, Div, GatedPrice, PricesOnly, Heading, Main, Nav, RichText, Row, Section, Span, Stack, Text, Ul, Li, Dl, Dt, Dd, } from "../../../ui/index.js";
+import { Button, Container, Div, GatedPrice, PricesOnly, Heading, Main, Nav, RichText, Row, Section, Span, Stack, Text, Ul, Li, SpecTable, } from "../../../ui/index.js";
 import { PreOrderDetailView } from "../../products/components/PreOrderDetailView.js";
 import { PreOrderBottomActions } from "./PreOrderBottomActions.js";
 import { ProductTabsShell } from "../../products/components/ProductTabsShell.js";
-import { CustomSectionTabContent } from "../../products/components/CustomSectionTabContent.js";
+import { toCustomSectionTabs } from "../../products/components/CustomSectionTabContent.js";
 import { PreOrderActionsClient } from "./PreOrderActionsClient.js";
 import { ProductGalleryClient } from "../../products/components/ProductGalleryClient.js";
 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]
             : [];
@@ -142,9 +147,6 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
     const specs = Array.isArray(p.specifications)
         ? p.specifications
         : [];
-    const customSections = Array.isArray(p.customSections)
-        ? p.customSections
-        : [];
     const descriptionHtml = toDescriptionHtml(p.description);
     const sublistingCategoryId = typeof p.sublistingCategoryId === "string" ? p.sublistingCategoryId : null;
     const groupId = typeof p.groupId === "string" ? p.groupId : null;
@@ -156,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,
@@ -168,9 +166,5 @@ export async function PreOrderDetailPageView({ id, initialPreOrder, onReserveNow
                             ? () => (_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(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(Dl, { divide: "subtle", rounded: "xl", border: "subtle", className: "overflow-hidden", children: specs.map((s, i) => (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-36 flex-shrink-0", color: "primary", weight: "medium", children: s.name }), _jsxs(Dd, { className: "flex-1", color: "muted", children: [s.value, s.unit ? ` ${s.unit}` : ""] })] }, i))) })) : undefined, customTabs: customSections.map((s) => ({
-                                id: s.id,
-                                label: s.title,
-                                content: _jsx(CustomSectionTabContent, { section: s }),
-                            })) })), renderBuyBar: () => (_jsx(PreOrderBuyBarPanel, { reserveTarget: reserveTarget, reservedCount: reservedCount, progressPct: progressPct, productId: String(product.id), price: price, currency: currency, depositAmount: depositAmount, depositPercent: depositPercent, isCancellable: isCancellable, tags: tags, onReserveNow: onReserveNow })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _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(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(PreOrderBuyBarPanel, { reserveTarget: reserveTarget, reservedCount: reservedCount, progressPct: progressPct, productId: String(product.id), price: price, currency: currency, depositAmount: depositAmount, depositPercent: depositPercent, isCancellable: isCancellable, tags: tags, onReserveNow: onReserveNow })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _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/pre-orders/components/PreOrdersIndexListing.js

@@ -232,5 +232,5 @@ export function PreOrdersIndexListing({ initialData, categorySlug, brandName })
                 ] }), totalPages > 1 && (_jsx(StickyToolbar, { offset: "header+pagination", tone: "translucent", border: true, padding: "toolbar", children: _jsx(Row, { justify: "center", children: _jsx(Pagination, { currentPage: page, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) }) })), _jsx(Div, { padding: "y-lg", children: isLoading ? (_jsx(Grid, { cols: "cards", gap: "md", children: Array.from({ length: 10 }).map((_, i) => (_jsxs(Div, { className: `${__O.hidden} animate-pulse`, border: "subtle", rounded: "xl", children: [_jsx(Div, { className: "aspect-square", surface: "subtle" }), _jsxs(Stack, { className: `${__P.p3}`, gap: "sm", children: [_jsx(Div, { className: "h-3 w-3/4", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-3 w-1/2", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-4 w-1/3", surface: "subtle", rounded: "default" }), _jsx(Div, { className: "h-8", surface: "subtle", rounded: "default" })] })] }, i))) })) : preOrders.length === 0 ? (_jsx(Text, { paddingY: "3xl", color: "muted", size: "sm", align: "start", children: "No pre-orders found." })) : view === "list" ? (_jsx(Stack, { className: "divide-y divide-zinc-100 divide-[var(--appkit-color-border-subtle)]", border: "subtle", rounded: "xl", children: preOrders.map((product) => (_jsx(MarketplacePreorderCard, { product: product, variant: "list", hrefBuilder: (p) => String(ROUTES.PUBLIC.PRE_ORDER_DETAIL(p.id)), onAddToCart: handleAddToCart, wishlistActions: wishlistActions, selectable: selection.isSelecting, isSelected: selection.isSelected(product.id), onSelect: (id) => selection.toggle(id) }, product.id))) })) : (_jsx(Grid, { cols: "cards", gap: "md", children: preOrders.map((product) => (_jsx(MarketplacePreorderCard, { product: product, variant: "grid", hrefBuilder: (p) => String(ROUTES.PUBLIC.PRE_ORDER_DETAIL(p.id)), onAddToCart: handleAddToCart, wishlistActions: wishlistActions, selectable: selection.isSelecting, isSelected: selection.isSelected(product.id), onSelect: (id) => selection.toggle(id) }, product.id))) })) }), _jsx(CompareOverlay, { isOpen: compareIds.length > 0, productIds: compareIds, productType: "preorder", onClose: () => {
                     setCompareIds([]);
                     selection.clearSelection();
-                }, onRemove: (id) => setCompareIds((ids) => ids.filter((i) => i !== id)) }), _jsx(FilterDrawer, { open: filterOpen, onOpen: openFilters, onClose: () => setFilterOpen(false), onApply: applyFilters, onReset: onFilterClear, activeCount: filterActiveCount, hideTrigger: true, children: _jsx(PreOrderFilters, { table: pendingTable, currencyPrefix: "\u20B9", categoryOptions: categoryOptions, brandOptions: brandOptions }) }), _jsx(LoginRequiredModal, { isOpen: modalOpen, onClose: closeModal, message: modalMessage })] }));
+                }, onRemove: (id) => setCompareIds((ids) => ids.filter((i) => i !== id)), onAdd: (id) => setCompareIds((ids) => (ids.includes(id) ? ids : [...ids, id])) }), _jsx(FilterDrawer, { open: filterOpen, onOpen: openFilters, onClose: () => setFilterOpen(false), onApply: applyFilters, onReset: onFilterClear, activeCount: filterActiveCount, hideTrigger: true, children: _jsx(PreOrderFilters, { table: pendingTable, currencyPrefix: "\u20B9", categoryOptions: categoryOptions, brandOptions: brandOptions }) }), _jsx(LoginRequiredModal, { isOpen: modalOpen, onClose: closeModal, message: modalMessage })] }));
 }

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

@@ -79,9 +79,32 @@ 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;
     initialData?: PriceIndexToolResponse | null;
+    /** `siteSettings.search?.indexEnabled`. Read as `!== false`. */
+    searchIndexEnabled?: boolean;
 }
-export declare function PriceIndexToolView({ initialQuery, initialData }: PriceIndexToolViewProps): React.JSX.Element;
+export declare function PriceIndexToolView({ initialQuery, initialData, searchIndexEnabled, }: PriceIndexToolViewProps): React.JSX.Element;