@mohasinac/appkit 4.71.0 → 4.71.2

package/dist/features/products/schemas/part-slots.js

@@ -0,0 +1,231 @@
+/**
+ * Part slots and composition flags — the SHOP's share of the old parts schema.
+ *
+ * The bey/part reference taxonomy left the shop on 2026-11-08 (owner decision:
+ * the wiki owns it as JSON and will expose an API, the way it already does for
+ * tools). These three symbols did NOT go with it, because they are not
+ * taxonomy — they are product concerns that outlive the reference pages:
+ *
+ *   PART_SLOT_VALUES / PartSlot   a `spares` listing still has a slot
+ *   PART_SLOT_CATEGORY            the price index maps a slot to its leaf
+ *   LISTING_TYPE_HAS_COMPOSITION  category assignment still asks the question
+ *
+ * Kept as a `Record<PartSlot, …>` for the reason the original gave: a new slot
+ * is a COMPILE ERROR rather than a page heading that reads `performance-tip`.
+ */
+export const PART_SLOT_VALUES = {
+    BIT_CHIP: "bit-chip",
+    ATTACK_RING: "attack-ring",
+    WEIGHT_DISK: "weight-disk",
+    SPIN_GEAR: "spin-gear",
+    ENGINE_GEAR: "engine-gear",
+    BLADE_BASE: "blade-base",
+    RUNNING_CORE: "running-core",
+    FACE_BOLT: "face-bolt",
+    ENERGY_RING: "energy-ring",
+    FUSION_WHEEL: "fusion-wheel",
+    CHROME_WHEEL: "chrome-wheel",
+    SPIN_TRACK: "spin-track",
+    PERFORMANCE_TIP: "performance-tip",
+    LAYER: "layer",
+    DISC: "disc",
+    DRIVER: "driver",
+    ARMOUR: "armour",
+    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",
+};
+export const PART_SLOT_CATEGORY = {
+    // Plastic Generation / HMS — Takara, pre-2006.
+    "attack-ring": "category-original-attack-rings",
+    "weight-disk": "category-original-weight-disks",
+    "blade-base": "category-original-blade-bases",
+    "bit-chip": "category-original-bit-chips",
+    "spin-gear": "category-original-spin-gears",
+    "engine-gear": "category-original-engine-gears",
+    "running-core": "category-original-running-cores",
+    // Metal Fight / 4D.
+    "face-bolt": "category-metal-face-bolts",
+    "energy-ring": "category-metal-energy-rings",
+    "fusion-wheel": "category-metal-fusion-wheels",
+    "chrome-wheel": "category-metal-chrome-wheels",
+    "spin-track": "category-metal-spin-tracks",
+    "performance-tip": "category-metal-performance-tips",
+    // Burst.
+    layer: "category-burst-layers",
+    disc: "category-burst-discs",
+    driver: "category-burst-drivers",
+    armour: "category-burst-chips-armour",
+    // Beyblade X.
+    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-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",
+    "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-support-parts",
+};
+/**
+ * Normalises a colourway for use as a grouping key in the price index.
+ * Moved here with the slot constants for the same reason.
+ */
+export function normaliseColourway(value) {
+    if (!value)
+        return "";
+    return value
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+export const LISTING_TYPE_HAS_COMPOSITION = {
+    standard: true,
+    "collector-drop": 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,
+    "clearance": true,
+    classified: true,
+    live: true,
+    // Depicts the model; is not the model.
+    "art-and-stickers": false,
+    // A redemption code has no physical parts at all.
+    "digital-code": false,
+};

package/dist/features/products/schemas/product-features.d.ts

@@ -34,8 +34,8 @@ export declare const MAX_STORE_CUSTOM_FEATURES = 20;
  */
 export declare const MAX_FEATURES_PER_PRODUCT = 24;
 export type ProductFeatureScope = "platform" | "store";
-export type ProductFeatureCategory = "shipping" | "seller" | "condition" | "platform" | "auction" | "preorder" | "custom";
-export type ProductFeatureProductType = "product" | "auction" | "preorder" | "prize-draw" | "classified" | "digital-code" | "live" | "art" | "stickers" | "all";
+export type ProductFeatureCategory = "shipping" | "seller" | "condition" | "platform" | "collector-drop" | "preorder" | "custom";
+export type ProductFeatureProductType = "product" | "collector-drop" | "preorder" | "clearance" | "classified" | "digital-code" | "live" | "art-and-stickers" | "all";
 /**
  * Either an appkit icon-set name key (e.g. "truck") or a raw SVG path-d string.
  * Path strings must start with "M " — see isFeatureIconPath().
@@ -46,7 +46,7 @@ export declare function isFeatureIconPath(icon: string): boolean;
  * The vocabulary's namespace.
  *
  * 🛑 NOT the same axis as `category` above, which groups features by the
- * SURFACE that shows them (shipping/seller/platform/auction/preorder) and is
+ * SURFACE that shows them (shipping/seller/platform/collector drop/preorder) and is
  * what drives badge placement. `group` namespaces what a feature MEANS, and
  * drives the filter drawer: one facet section per group, rather than one flat
  * 60-value checkbox list.

package/dist/features/products/schemas/product-features.validators.d.ts

@@ -6,8 +6,8 @@
  * of hand-rolling parallel schemas.
  */
 import { z } from "zod";
-export declare const PRODUCT_FEATURE_PRODUCT_TYPE_ENUM: z.ZodEnum<["product", "auction", "preorder", "prize-draw", "classified", "digital-code", "live", "all"]>;
-export declare const PRODUCT_FEATURE_CATEGORY_ENUM: z.ZodEnum<["shipping", "seller", "condition", "platform", "auction", "preorder", "custom"]>;
+export declare const PRODUCT_FEATURE_PRODUCT_TYPE_ENUM: z.ZodEnum<["product", "collector-drop", "preorder", "clearance", "classified", "digital-code", "live", "all"]>;
+export declare const PRODUCT_FEATURE_CATEGORY_ENUM: z.ZodEnum<["shipping", "seller", "condition", "platform", "collector-drop", "preorder", "custom"]>;
 export declare const PRODUCT_FEATURE_SCOPE_ENUM: z.ZodEnum<["platform", "store"]>;
 /** Shape for POST /api/admin/features — admin creates either scope. */
 export declare const productFeatureAdminCreateSchema: z.ZodObject<{
@@ -15,31 +15,31 @@ export declare const productFeatureAdminCreateSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     icon: z.ZodString;
     iconColor: z.ZodOptional<z.ZodString>;
-    category: z.ZodEnum<["shipping", "seller", "condition", "platform", "auction", "preorder", "custom"]>;
+    category: z.ZodEnum<["shipping", "seller", "condition", "platform", "collector-drop", "preorder", "custom"]>;
     scope: z.ZodEnum<["platform", "store"]>;
-    productTypes: z.ZodArray<z.ZodEnum<["product", "auction", "preorder", "prize-draw", "classified", "digital-code", "live", "all"]>, "many">;
+    productTypes: z.ZodArray<z.ZodEnum<["product", "collector-drop", "preorder", "clearance", "classified", "digital-code", "live", "all"]>, "many">;
     storeId: z.ZodOptional<z.ZodString>;
     isActive: z.ZodBoolean;
     displayOrder: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    category: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder";
+    label: string;
+    category: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder";
     isActive: boolean;
     displayOrder: number;
     icon: string;
-    label: string;
     scope: "store" | "platform";
-    productTypes: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[];
+    productTypes: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[];
     description?: string | undefined;
     storeId?: string | undefined;
     iconColor?: string | undefined;
 }, {
-    category: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder";
+    label: string;
+    category: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder";
     isActive: boolean;
     displayOrder: number;
     icon: string;
-    label: string;
     scope: "store" | "platform";
-    productTypes: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[];
+    productTypes: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[];
     description?: string | undefined;
     storeId?: string | undefined;
     iconColor?: string | undefined;
@@ -50,26 +50,26 @@ export declare const productFeatureStoreCreateSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     icon: z.ZodString;
     iconColor: z.ZodOptional<z.ZodString>;
-    category: z.ZodEnum<["shipping", "seller", "condition", "platform", "auction", "preorder", "custom"]>;
-    productTypes: z.ZodArray<z.ZodEnum<["product", "auction", "preorder", "prize-draw", "classified", "digital-code", "live", "all"]>, "many">;
+    category: z.ZodEnum<["shipping", "seller", "condition", "platform", "collector-drop", "preorder", "custom"]>;
+    productTypes: z.ZodArray<z.ZodEnum<["product", "collector-drop", "preorder", "clearance", "classified", "digital-code", "live", "all"]>, "many">;
     isActive: z.ZodBoolean;
     displayOrder: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    category: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder";
+    label: string;
+    category: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder";
     isActive: boolean;
     displayOrder: number;
     icon: string;
-    label: string;
-    productTypes: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[];
+    productTypes: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[];
     description?: string | undefined;
     iconColor?: string | undefined;
 }, {
-    category: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder";
+    label: string;
+    category: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder";
     isActive: boolean;
     displayOrder: number;
     icon: string;
-    label: string;
-    productTypes: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[];
+    productTypes: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[];
     description?: string | undefined;
     iconColor?: string | undefined;
 }>;
@@ -79,28 +79,28 @@ export declare const productFeatureUpdateSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;
     iconColor: z.ZodOptional<z.ZodString>;
-    category: z.ZodOptional<z.ZodEnum<["shipping", "seller", "condition", "platform", "auction", "preorder", "custom"]>>;
-    productTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["product", "auction", "preorder", "prize-draw", "classified", "digital-code", "live", "all"]>, "many">>;
+    category: z.ZodOptional<z.ZodEnum<["shipping", "seller", "condition", "platform", "collector-drop", "preorder", "custom"]>>;
+    productTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["product", "collector-drop", "preorder", "clearance", "classified", "digital-code", "live", "all"]>, "many">>;
     isActive: z.ZodOptional<z.ZodBoolean>;
     displayOrder: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    label?: string | undefined;
     description?: string | undefined;
-    category?: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder" | undefined;
+    category?: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder" | undefined;
     isActive?: boolean | undefined;
     displayOrder?: number | undefined;
     icon?: string | undefined;
-    label?: string | undefined;
     iconColor?: string | undefined;
-    productTypes?: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[] | undefined;
+    productTypes?: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[] | undefined;
 }, {
+    label?: string | undefined;
     description?: string | undefined;
-    category?: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder" | undefined;
+    category?: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder" | undefined;
     isActive?: boolean | undefined;
     displayOrder?: number | undefined;
     icon?: string | undefined;
-    label?: string | undefined;
     iconColor?: string | undefined;
-    productTypes?: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[] | undefined;
+    productTypes?: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[] | undefined;
 }>;
 /**
  * The FORM schema for the product-feature editor, with UI metadata.
@@ -123,53 +123,53 @@ export declare const productFeatureFormSchema: z.ZodEffects<z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     icon: z.ZodString;
     iconColor: z.ZodOptional<z.ZodString>;
-    category: z.ZodEnum<["shipping", "seller", "condition", "platform", "auction", "preorder", "custom"]>;
+    category: z.ZodEnum<["shipping", "seller", "condition", "platform", "collector-drop", "preorder", "custom"]>;
     scope: z.ZodEnum<["platform", "store"]>;
-    productTypes: z.ZodArray<z.ZodEnum<["product", "auction", "preorder", "prize-draw", "classified", "digital-code", "live", "all"]>, "many">;
+    productTypes: z.ZodArray<z.ZodEnum<["product", "collector-drop", "preorder", "clearance", "classified", "digital-code", "live", "all"]>, "many">;
     storeId: z.ZodOptional<z.ZodString>;
     isActive: z.ZodBoolean;
     displayOrder: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    category: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder";
+    label: string;
+    category: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder";
     isActive: boolean;
     displayOrder: number;
     icon: string;
-    label: string;
     scope: "store" | "platform";
-    productTypes: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[];
+    productTypes: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[];
     description?: string | undefined;
     storeId?: string | undefined;
     iconColor?: string | undefined;
 }, {
-    category: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder";
+    label: string;
+    category: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder";
     isActive: boolean;
     displayOrder: number;
     icon: string;
-    label: string;
     scope: "store" | "platform";
-    productTypes: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[];
+    productTypes: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[];
     description?: string | undefined;
     storeId?: string | undefined;
     iconColor?: string | undefined;
 }>, {
-    category: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder";
+    label: string;
+    category: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder";
     isActive: boolean;
     displayOrder: number;
     icon: string;
-    label: string;
     scope: "store" | "platform";
-    productTypes: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[];
+    productTypes: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[];
     description?: string | undefined;
     storeId?: string | undefined;
     iconColor?: string | undefined;
 }, {
-    category: "seller" | "custom" | "condition" | "auction" | "platform" | "shipping" | "preorder";
+    label: string;
+    category: "seller" | "custom" | "condition" | "collector-drop" | "platform" | "shipping" | "preorder";
     isActive: boolean;
     displayOrder: number;
     icon: string;
-    label: string;
     scope: "store" | "platform";
-    productTypes: ("all" | "auction" | "prize-draw" | "classified" | "digital-code" | "live" | "product" | "preorder")[];
+    productTypes: ("all" | "collector-drop" | "clearance" | "classified" | "digital-code" | "live" | "preorder" | "product")[];
     description?: string | undefined;
     storeId?: string | undefined;
     iconColor?: string | undefined;

package/dist/features/products/schemas/product-features.validators.js

@@ -9,9 +9,9 @@ import { z } from "zod";
 import { annotate } from "../../shell/field-ui-meta.js";
 export const PRODUCT_FEATURE_PRODUCT_TYPE_ENUM = z.enum([
     "product",
-    "auction",
+    "collector-drop",
     "preorder",
-    "prize-draw",
+    "clearance",
     "classified",
     "digital-code",
     "live",
@@ -22,7 +22,7 @@ export const PRODUCT_FEATURE_CATEGORY_ENUM = z.enum([
     "seller",
     "condition",
     "platform",
-    "auction",
+    "collector-drop",
     "preorder",
     "custom",
 ]);

package/dist/features/products/schemas/surface-counts.d.ts

@@ -34,7 +34,7 @@
  * its own page would have rendered rows, which is the correctness property
  * that matters here and the reason this is not a bespoke `count()` query.
  *
- * It inherits that function's time-dependence: an auction becomes unavailable
+ * It inherits that function's time-dependence: a collector drop becomes unavailable
  * by the clock with no product write, so a type whose last row just ended stays
  * "non-empty" until the next recompute. Erring toward VISIBLE is the right
  * direction for this feature — showing an empty list is a cosmetic problem,

package/dist/features/products/schemas/surface-counts.js

@@ -34,7 +34,7 @@
  * its own page would have rendered rows, which is the correctness property
  * that matters here and the reason this is not a bespoke `count()` query.
  *
- * It inherits that function's time-dependence: an auction becomes unavailable
+ * It inherits that function's time-dependence: a collector drop becomes unavailable
  * by the clock with no product write, so a type whose last row just ended stays
  * "non-empty" until the next recompute. Erring toward VISIBLE is the right
  * direction for this feature — showing an empty list is a cosmetic problem,

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

@@ -11,7 +11,7 @@ export type ProductCondition = "new" | "like_new" | "good" | "fair" | "poor" | "
  * accepts legacy alias tokens (`preorder` → `pre-order`, `product` → `standard`)
  * but stored values are always one of these five.
  */
-export type ListingType = "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | "art" | "stickers" | "spares";
+export type ListingType = "standard" | "collector-drop" | "pre-order" | "clearance" | "classified" | "digital-code" | "live" | "art-and-stickers" | "spares";
 /**
  * One gallery image — THE single definition, used by both the Firestore
  * document and the client shape.
@@ -164,13 +164,13 @@ export interface ProductItem {
     }[];
     startingBid?: number;
     bidCount?: number;
-    auctionEndDate?: string | Date;
+    collectorDropEndDate?: string | Date;
     reservePrice?: number;
     buyNowPrice?: number;
     minBidIncrement?: number;
     autoExtendable?: boolean;
-    auctionExtensionMinutes?: number;
-    auctionShippingPaidBy?: "seller" | "winner";
+    collectorDropExtensionMinutes?: number;
+    collectorDropShippingPaidBy?: "seller" | "winner";
     preOrderDeliveryDate?: string | Date;
     preOrderDepositPercent?: number;
     preOrderDepositAmount?: number;
@@ -189,7 +189,7 @@ export interface ProductItem {
     prizeRevealMode?: "instant" | "scheduled";
     prizeGithubFileUrl?: string;
     maxPerUser?: number;
-    /** Winner's display name for ended auctions — shown masked in public UI */
+    /** Winner's display name for ended collector drops — shown masked in public UI */
     winnerDisplayName?: string;
     viewCount?: number;
     avgRating?: number;
@@ -251,10 +251,10 @@ export interface ProductListParams {
     page?: number;
     pageSize?: number;
     featured?: boolean;
-    /** Auction-specific: current bid range */
+    /** CollectorDrop-specific: current bid range */
     minBid?: number;
     maxBid?: number;
-    /** Auction: end date range / Pre-order: delivery date range */
+    /** Collector Drop: end date range / Pre-order: delivery date range */
     dateFrom?: string;
     dateTo?: string;
     /** Pre-order production status */

package/dist/features/products/utils/listing-badge-variant.d.ts

@@ -11,7 +11,7 @@ export type ListingBadgeVariant = "default" | "primary" | "secondary" | "success
  *
  * Typed `Record<ListingType, …>` (2026-08-21) so a new listing type is a
  * COMPILE error here rather than a silent fallthrough. It previously covered
- * only auction / pre-order / prize-draw / standard, so the other five types
+ * only collector drop / pre-order / prize-draw / standard, so the other five types
  * fell through to the caller's `?? "default"` and all rendered identically.
  */
 export declare const LISTING_BADGE_VARIANT: Record<ListingType, ListingBadgeVariant>;

package/dist/features/products/utils/listing-badge-variant.js

@@ -10,23 +10,22 @@ import { isListingType } from "./listing-type.js";
  *
  * Typed `Record<ListingType, …>` (2026-08-21) so a new listing type is a
  * COMPILE error here rather than a silent fallthrough. It previously covered
- * only auction / pre-order / prize-draw / standard, so the other five types
+ * only collector drop / pre-order / prize-draw / standard, so the other five types
  * fell through to the caller's `?? "default"` and all rendered identically.
  */
 export const LISTING_BADGE_VARIANT = {
     standard: "default",
     // Shares `primary` with art/stickers: all three are "a thing we make or
-    // salvage ourselves" rather than a mechanism (auction) or a promise
+    // salvage ourselves" rather than a mechanism (collector drop) or a promise
     // (pre-order), and the badge LABEL is what distinguishes them.
     spares: "primary",
-    auction: "warning",
+    "collector-drop": "warning",
     "pre-order": "secondary",
-    "prize-draw": "primary",
+    "clearance": "primary",
     classified: "secondary",
     "digital-code": "success",
     live: "danger",
-    art: "primary",
-    stickers: "primary",
+    "art-and-stickers": "primary",
 };
 /**
  * Badge variant for a listing kind that may not be a real `ListingType` —

package/dist/features/products/utils/listing-type.d.ts

@@ -5,7 +5,7 @@ export declare function isListingType(value: string): value is ListingType;
  * Parse a multi-select listing-type URL value into canonical types.
  *
  * The type filter is a checkbox group, so its URL value is a pipe-joined set
- * (`auction|pre-order`) — the same shape the Sieve adapter upgrades to a
+ * (`collector drop|pre-order`) — the same shape the Sieve adapter upgrades to a
  * Firestore `in` query. Unknown tokens are DROPPED rather than passed through:
  * an unrecognised value reaching `where("listingType","==",x)` matches zero
  * documents forever with no error (Root Cause #33), so silently ignoring it and
@@ -19,14 +19,14 @@ export declare function parseSelectedListingTypes(raw: string | undefined | null
  * Toggle one type in a pipe-joined selection, returning the new URL value
  * (`""` when nothing is left selected). Keeps canonical iteration order so the
  * URL is stable regardless of the order the user ticked the boxes — otherwise
- * `auction|art` and `art|auction` would be two different React Query keys for
+ * `collector drop|art-and-stickers` and `art-and-stickers|collector drop` would be two different React Query keys for
  * the same result set.
  */
 export declare function toggleListingTypeSelection(raw: string | undefined | null, type: ListingType): string;
 /**
  * Canonical accessor for the listing-kind discriminator. `listingType` is the
  * single source of truth on every `ProductDocument` / `ProductItem` — the
- * legacy `isAuction` / `isPreOrder` booleans were removed in S3 (SB1-G final,
+ * legacy `isCollectorDrop` / `isPreOrder` booleans were removed in S3 (SB1-G final,
  * 2026-05-13).
  *
  * Returns `"standard"` when the input is undefined or missing the field, so
@@ -36,7 +36,7 @@ export declare function normalizeListingType(input?: {
     listingType?: ListingType;
 }): ListingType;
 /** Convenience predicates that read the canonical `listingType` discriminator. */
-export declare const isAuctionListing: (input?: {
+export declare const isCollectorDropListing: (input?: {
     listingType?: ListingType;
 }) => boolean;
 export declare const isPreOrderListing: (input?: {
@@ -45,7 +45,7 @@ export declare const isPreOrderListing: (input?: {
 export declare const isStandardListing: (input?: {
     listingType?: ListingType;
 }) => boolean;
-export declare const isPrizeDrawListing: (input?: {
+export declare const isClearanceListing: (input?: {
     listingType?: ListingType;
 }) => boolean;
 export declare const isClassifiedListing: (input?: {
@@ -57,9 +57,6 @@ export declare const isDigitalCodeListing: (input?: {
 export declare const isLiveListing: (input?: {
     listingType?: ListingType;
 }) => boolean;
-export declare const isArtListing: (input?: {
-    listingType?: ListingType;
-}) => boolean;
-export declare const isStickersListing: (input?: {
+export declare const isArtAndStickersListing: (input?: {
     listingType?: ListingType;
 }) => boolean;