@mohasinac/appkit 4.43.0 → 4.44.0

package/dist/seed/_helpers/category-tree.js

@@ -36,7 +36,23 @@
  */
 export function buildCategoryTree(roots, opts) {
     const rows = [];
-    let position = 0;
+    /*
+     * 🛑 1-BASED, and that is not cosmetic — it must match `positionsReconcile`,
+     * which starts its own DFS at `let counter = 1`.
+     *
+     * This counter started at 0 until 2026-10-10. The nightly reconcile then
+     * found every row off by one (`current.position !== position`) and rewrote
+     * the entire collection on the first run after any reseed — 58 writes then,
+     * ~330 once the catalogue grows, each re-entering `onCategoryWrite` as a
+     * no-op invocation. Measured in production before the change: seed emits
+     * 0..57, live data reads 1..58, i.e. the reconcile had already corrected
+     * all of it.
+     *
+     * It also makes position 0 UNAMBIGUOUS, which `handleCategoryWrite` now
+     * relies on: a document arriving with `position >= 1` was numbered by this
+     * builder, and one with 0/absent was not.
+     */
+    let position = 1;
     function visit(node, rootId, 
     /** Ancestors nearest-last, matching how `parentIds` is read elsewhere. */
     ancestors, tier, parentPath, order) {

package/dist/seed/_helpers/character-features.d.ts

@@ -0,0 +1,10 @@
+/** A blader, and how many canonical beys the corpus attributes to them. */
+export interface CharacterSeed {
+    /** Without the `feature-` prefix — the factory prepends it. */
+    slug: string;
+    name: string;
+    /** Canonical beys owned. Drives display order; not stored on the row. */
+    beyCount: number;
+}
+export declare const CHARACTER_SEEDS: CharacterSeed[];
+export declare const CHARACTER_SEED_COUNT = 93;

package/dist/seed/_helpers/character-features.js

@@ -0,0 +1,118 @@
+/*
+ * GENERATED by scripts/gen-category-models.mjs — do not edit by hand.
+ *
+ * WHY: the clickable owner linkage. `Owner (Anime)` is 100% populated in the
+ *      corpus but it is a SENTENCE — "Tyson Granger (Tyson's 9th and final
+ *      bey)" — so it renders as prose and filters nothing. These are the
+ *      normalised names as `character`-group features, which makes
+ *      "show me every Tyson Granger bey" one click from any listing page.
+ *
+ * 🛑 A FEATURE and never a category node. A blader crosses every generation —
+ *    Tyson owns nine beys spanning Spin Gear, Magnacore, Engine Gear and HMS —
+ *    so a tree node would duplicate all nine under a second parent and break
+ *    the one-chain-per-product invariant. As a feature it COMPOSES with the
+ *    generation tree instead of competing with it: browse Beyblade Original,
+ *    then narrow to Tyson's.
+ *
+ * @tag domain:products
+ * @tag layer:seed
+ * @tag pattern:generated
+ * @tag access:server-only
+ * @tag sideEffects:none
+ */
+export const CHARACTER_SEEDS = [
+    { slug: "blader-tyson-granger", name: "Tyson Granger", beyCount: 9 },
+    { slug: "blader-kai-hiwatari", name: "Kai Hiwatari", beyCount: 7 },
+    { slug: "blader-daichi-sumeragi", name: "Daichi Sumeragi", beyCount: 6 },
+    { slug: "blader-max-tate", name: "Max Tate", beyCount: 6 },
+    { slug: "blader-ray-kon", name: "Ray Kon", beyCount: 6 },
+    { slug: "blader-shu-kurenai", name: "Shu Kurenai", beyCount: 6 },
+    { slug: "blader-gingka-hagane", name: "Gingka Hagane", beyCount: 5 },
+    { slug: "blader-lui-shirosagi", name: "Lui Shirosagi", beyCount: 5 },
+    { slug: "blader-tala", name: "Tala", beyCount: 5 },
+    { slug: "blader-valt-aoi", name: "Valt Aoi", beyCount: 5 },
+    { slug: "blader-free-de-la-hoya", name: "Free De La Hoya", beyCount: 4 },
+    { slug: "blader-aiger-akabane", name: "Aiger Akabane", beyCount: 3 },
+    { slug: "blader-dante-koryu", name: "Dante Koryu", beyCount: 3 },
+    { slug: "blader-jaxon-cross", name: "Jaxon Cross", beyCount: 3 },
+    { slug: "blader-kenta-yumiya", name: "Kenta Yumiya", beyCount: 3 },
+    { slug: "blader-kyoya-tategami", name: "Kyoya Tategami", beyCount: 3 },
+    { slug: "blader-multi-nana-iro", name: "Multi Nana-iro", beyCount: 3 },
+    { slug: "blader-ryuga", name: "Ryuga", beyCount: 3 },
+    { slug: "blader-benkei-hanawa", name: "Benkei Hanawa", beyCount: 2 },
+    { slug: "blader-daigo-kurogami", name: "Daigo Kurogami", beyCount: 2 },
+    { slug: "blader-damian-hart", name: "Damian Hart", beyCount: 2 },
+    { slug: "blader-dashan-wang", name: "Dashan Wang", beyCount: 2 },
+    { slug: "blader-delta-zakuro", name: "Delta Zakuro", beyCount: 2 },
+    { slug: "blader-dunga", name: "Dunga", beyCount: 2 },
+    { slug: "blader-eddy", name: "Eddy", beyCount: 2 },
+    { slug: "blader-fumiya-kindo", name: "Fumiya Kindo", beyCount: 2 },
+    { slug: "blader-hikaru-hizashi", name: "Hikaru Hizashi", beyCount: 2 },
+    { slug: "blader-hyde", name: "Hyde", beyCount: 2 },
+    { slug: "blader-jin-of-the-gale", name: "Jin of the Gale", beyCount: 2 },
+    { slug: "blader-kira-hayama", name: "Kira Hayama", beyCount: 2 },
+    { slug: "blader-lee", name: "Lee", beyCount: 2 },
+    { slug: "blader-masamune-kadoya", name: "Masamune Kadoya", beyCount: 2 },
+    { slug: "blader-michael-summers", name: "Michael Summers", beyCount: 2 },
+    { slug: "blader-miguel", name: "Miguel", beyCount: 2 },
+    { slug: "blader-ozuma", name: "Ozuma", beyCount: 2 },
+    { slug: "blader-robin-kazami", name: "Robin Kazami", beyCount: 2 },
+    { slug: "blader-tsubasa-otori", name: "Tsubasa Otori", beyCount: 2 },
+    { slug: "blader-wakiya-murasaki", name: "Wakiya Murasaki", beyCount: 2 },
+    { slug: "blader-xander-shakadera", name: "Xander Shakadera", beyCount: 2 },
+    { slug: "blader-yu-tendo", name: "Yu Tendo", beyCount: 2 },
+    { slug: "blader-aguma", name: "Aguma", beyCount: 1 },
+    { slug: "blader-akuya-onizaki", name: "Akuya Onizaki", beyCount: 1 },
+    { slug: "blader-anime", name: "Anime", beyCount: 1 },
+    { slug: "blader-anime-secondary", name: "Anime-secondary", beyCount: 1 },
+    { slug: "blader-blader-dj", name: "Blader DJ", beyCount: 1 },
+    { slug: "blader-brooklyn", name: "Brooklyn", beyCount: 1 },
+    { slug: "blader-chris", name: "Chris", beyCount: 1 },
+    { slug: "blader-claude", name: "Claude", beyCount: 1 },
+    { slug: "blader-clio-delon", name: "Clio Delon", beyCount: 1 },
+    { slug: "blader-crusher", name: "Crusher", beyCount: 1 },
+    { slug: "blader-cycnus", name: "Cycnus", beyCount: 1 },
+    { slug: "blader-dan-sodo-and-reiki-sodo", name: "Dan Sodo and Reiki Sodo", beyCount: 1 },
+    { slug: "blader-doji", name: "Doji", beyCount: 1 },
+    { slug: "blader-faust", name: "Faust", beyCount: 1 },
+    { slug: "blader-garland-siebald", name: "Garland Siebald", beyCount: 1 },
+    { slug: "blader-gary", name: "Gary", beyCount: 1 },
+    { slug: "blader-ginro", name: "Ginro", beyCount: 1 },
+    { slug: "blader-hikaru-hasama", name: "Hikaru Hasama", beyCount: 1 },
+    { slug: "blader-hokuto", name: "Hokuto", beyCount: 1 },
+    { slug: "blader-hyoma", name: "Hyoma", beyCount: 1 },
+    { slug: "blader-hyuga-hizashi", name: "Hyuga Hizashi", beyCount: 1 },
+    { slug: "blader-ian-papov", name: "Ian Papov", beyCount: 1 },
+    { slug: "blader-johnny-mcgregor", name: "Johnny McGregor", beyCount: 1 },
+    { slug: "blader-joseph-burton", name: "Joseph Burton", beyCount: 1 },
+    { slug: "blader-julia-fernandez", name: "Julia Fernandez", beyCount: 1 },
+    { slug: "blader-julian-konzern", name: "Julian Konzern", beyCount: 1 },
+    { slug: "blader-karla-konjiki", name: "Karla Konjiki", beyCount: 1 },
+    { slug: "blader-ken-midori", name: "Ken Midori", beyCount: 1 },
+    { slug: "blader-kenny", name: "Kenny", beyCount: 1 },
+    { slug: "blader-kevin", name: "Kevin", beyCount: 1 },
+    { slug: "blader-kite-unabara", name: "Kite Unabara", beyCount: 1 },
+    { slug: "blader-lain-valhalla", name: "Lain Valhalla", beyCount: 1 },
+    { slug: "blader-meiko-myoden", name: "Meiko Myoden", beyCount: 1 },
+    { slug: "blader-nile", name: "Nile", beyCount: 1 },
+    { slug: "blader-nine-kurosu", name: "Nine Kurosu", beyCount: 1 },
+    { slug: "blader-omega-shiroboshi", name: "Omega Shiroboshi", beyCount: 1 },
+    { slug: "blader-phi", name: "Phi", beyCount: 1 },
+    { slug: "blader-rago", name: "Rago", beyCount: 1 },
+    { slug: "blader-reiji-mizuchi", name: "Reiji Mizuchi", beyCount: 1 },
+    { slug: "blader-reiyu-kuwabara", name: "Reiyu Kuwabara", beyCount: 1 },
+    { slug: "blader-rex-jura", name: "Rex Jura", beyCount: 1 },
+    { slug: "blader-rick-anderson", name: "Rick Anderson", beyCount: 1 },
+    { slug: "blader-robert-jurgens", name: "Robert Jurgens", beyCount: 1 },
+    { slug: "blader-sakyo-kurayami", name: "Sakyo Kurayami", beyCount: 1 },
+    { slug: "blader-silas-karlisle", name: "Silas Karlisle", beyCount: 1 },
+    { slug: "blader-spencer", name: "Spencer", beyCount: 1 },
+    { slug: "blader-teru-saotome", name: "Teru Saotome", beyCount: 1 },
+    { slug: "blader-tobio-oike", name: "Tobio Oike", beyCount: 1 },
+    { slug: "blader-toby", name: "Toby", beyCount: 1 },
+    { slug: "blader-toguro-okunaga", name: "Toguro Okunaga", beyCount: 1 },
+    { slug: "blader-yuki-mizusawa", name: "Yuki Mizusawa", beyCount: 1 },
+    { slug: "blader-yuni-naniwa", name: "Yuni Naniwa", beyCount: 1 },
+    { slug: "blader-zyro-kurogane", name: "Zyro Kurogane", beyCount: 1 },
+];
+export const CHARACTER_SEED_COUNT = 93;

package/dist/seed/_helpers/search-txt-wrappers.d.ts

@@ -1,3 +1,4 @@
+import type { CategoryDocument } from "../../features/categories/schemas/firestore";
 import type { StoreDocument } from "../../features/stores/schemas/firestore";
 import type { ScammerDocument } from "../../features/scams/schemas/firestore";
 import type { EventDocument } from "../../features/events/schemas/firestore";
@@ -6,6 +7,15 @@ import type { ReviewDocument } from "../../features/reviews/schemas/firestore";
 import type { OrderDocument } from "../../features/orders/schemas/firestore";
 import type { CouponDocument } from "../../features/promotions/schemas/firestore";
 import type { OfferDocument } from "../../features/seller/schemas/firestore";
+/**
+ * 🛑 Apply AFTER `buildCategoryTree`, never before.
+ *
+ * `buildCategorySearchTxt` indexes `path` and `ancestors[].name`, and both are
+ * DERIVED by the tree builder — a row wrapped before derivation gets tokens
+ * from `name`/`slug`/`description` only, and silently loses the lineage search
+ * that is the whole reason ancestors are indexed.
+ */
+export declare function withCategorySearchTxt<T extends Partial<CategoryDocument>>(p: T): T;
 export declare function withStoreSearchTxt<T extends Partial<StoreDocument>>(p: T): T;
 export declare function withEventSearchTxt<T extends Partial<EventDocument>>(p: T): T;
 export declare function withBlogSearchTxt<T extends Partial<BlogPostDocument>>(p: T): T;

package/dist/seed/_helpers/search-txt-wrappers.js

@@ -1,4 +1,15 @@
-import { buildStoreSearchTxt, buildEventSearchTxt, buildBlogSearchTxt, buildReviewSearchTxt, buildOrderSearchTxt, buildCouponSearchTxt, buildOfferSearchTxt, buildScammerSearchTxt, } from "../../utils/search-txt-builders";
+import { buildCategorySearchTxt, buildStoreSearchTxt, buildEventSearchTxt, buildBlogSearchTxt, buildReviewSearchTxt, buildOrderSearchTxt, buildCouponSearchTxt, buildOfferSearchTxt, buildScammerSearchTxt, } from "../../utils/search-txt-builders";
+/**
+ * 🛑 Apply AFTER `buildCategoryTree`, never before.
+ *
+ * `buildCategorySearchTxt` indexes `path` and `ancestors[].name`, and both are
+ * DERIVED by the tree builder — a row wrapped before derivation gets tokens
+ * from `name`/`slug`/`description` only, and silently loses the lineage search
+ * that is the whole reason ancestors are indexed.
+ */
+export function withCategorySearchTxt(p) {
+    return { ...p, searchTxt: buildCategorySearchTxt(p) };
+}
 export function withStoreSearchTxt(p) {
     return { ...p, searchTxt: buildStoreSearchTxt(p) };
 }

package/dist/seed/categories-seed-data.js

@@ -1,17 +1,34 @@
 /*
- * WHY: Provides the Beyblade-focused category hierarchy plus brand entries for the
- *      demo seed. The site itself stays generically branded as a collectibles marketplace —
- *      only the seeded catalog data is narrowed to Beyblade so the demo has a coherent
- *      dataset instead of a sprawling multi-franchise catalog.
- * WHAT: Exports categoriesSeedData — a 4-level, TWO-root category forest
- *       (`Spinning Tops` + `Living Collectibles`, see _helpers/category-forest.ts),
- *       brand rows (categoryType:"brand") and pricing bundles (categoryType:"bundle").
+ * WHY: The real catalogue taxonomy. 🛑 This file is NO LONGER Beyblade-only —
+ *      its header said "narrowed to Beyblade so the demo has a coherent
+ *      dataset instead of a sprawling multi-franchise catalog" and B5 reversed
+ *      that deliberately, on evidence: a 15-site crawl of ~25,900 live Indian
+ *      listings showed trading cards, collectible figures and Hot Wheels are
+ *      each a real vertical with its own measured price bands, and three of
+ *      the five largest competitors sell more than one of them.
  *
- *       The tree was 2 levels under a single root until 2026-08-24. That made
+ *      The old framing is not contradicted here, it is superseded — coherence
+ *      now comes from the TREE being one axis deep per vertical rather than
+ *      from the catalogue being one franchise wide.
+ *
+ * WHAT: Exports categoriesSeedData — a 5-level, SIX-root forest (Spinning Tops,
+ *       Trading Cards, Collectible Figures, Hot Wheels, Model Kits, Living
+ *       Collectibles — see _helpers/category-forest.ts), 28 brand rows
+ *       (categoryType:"brand", _helpers/brand-rows.ts), two sublisting rows and
+ *       five pricing bundles (categoryType:"bundle").
+ *
+ *       The tree was 2 levels under a single root until 2026-08-24 and 47 nodes
+ *       across 2 roots until B5. The first state made
  *       `categoryType:"sublisting"` — documented as "tier-4 leaf groups under a
  *       parent category" — structurally unreachable, and left the live-item
  *       products with no category at all.
  *
+ *       The tier-4 layer is 216 NAMED MODEL leaves (Lost Longinus, Storm
+ *       Pegasus, Dran Sword …), GENERATED from the canonical corpus in
+ *       _helpers/category-models.ts rather than typed by hand — a slug is the
+ *       document id, the public URL and a searchTxt source, so it is the one
+ *       field that cannot be quietly corrected later.
+ *
  *       Products tag their FULL ancestor chain (leaf -> … -> root) so a single
  *       array-contains at any level returns the whole subtree. That is what lets
  *       a category page match on its own id alone; expanding descendants into an
@@ -36,7 +53,12 @@
 import { CATEGORY_FIELDS } from "../constants/field-names";
 import { seedPhoto } from "./_helpers/media";
 import { buildCategoryTree } from "./_helpers/category-tree";
+import { withCategorySearchTxt } from "./_helpers/search-txt-wrappers";
 import { CATEGORY_FOREST } from "./_helpers/category-forest";
+import { BRAND_ROW_COUNT, buildBrandRows } from "./_helpers/brand-rows";
+import { MODEL_LEAF_COUNT } from "./_helpers/category-models";
+import { MARKET_BAND_LEAF_IDS } from "./_helpers/category-content";
+import { productsStandardSeedData } from "./products-standard-seed-data";
 const NOW = new Date();
 const daysAgo = (n) => new Date(NOW.getTime() - n * 86400000);
 const emptyMetrics = {
@@ -50,9 +72,14 @@ const emptyMetrics = {
     lastUpdated: daysAgo(1),
 };
 // ──────────────────────────────────────────────────────────────────────────────
-// Categories — 47 rows across 4 tiers and 2 roots, all structural fields derived.
-// The shape lives in _helpers/category-forest.ts; the derivation in
-// _helpers/category-tree.ts.
+// Categories — 381 rows across 5 tiers and 6 roots, every structural field
+// derived. The shape lives in _helpers/category-forest.ts, the named-model
+// tier-4 leaves in the GENERATED _helpers/category-models.ts, and the
+// derivation in _helpers/category-tree.ts.
+//
+// 🛑 Never quote this count without running `buildCategoryTree` against the
+// forest — it was 47 before B5 and the comment here said so for months after
+// the tree changed underneath it.
 // ──────────────────────────────────────────────────────────────────────────────
 const rawCategories = buildCategoryTree(CATEGORY_FOREST, {
     createdBy: "user-admin-letitrip",
@@ -153,157 +180,61 @@ const sublistingRows = [
     },
 ];
 // ──────────────────────────────────────────────────────────────────────────────
-// Brands (categoryType:"brand").
+// Brands (categoryType:"brand") — 4 rows -> 28, built by a factory.
 //
-// ⚠️ `BrandDetailPageView` matches products on the free-text `brand` DISPLAY
-// NAME (`sieveFilter("brand", EQ, brandName)`), not on `brandSlug`. So a brand
-// row's `name` here and the `brand:` string on every product that belongs to it
-// must match EXACTLY — renaming a brand silently orphans its whole catalogue.
-// Keep `brand` and `brandSlug` in lockstep on the product side.
+// The shape, the three live traps (display-name matching, icon-beats-cover,
+// and why a brand with no products is worse than no brand) and the logo
+// decision all live in _helpers/brand-rows.ts. Four inline rows at ~35 lines
+// each was already the wrong shape for 28.
 // ──────────────────────────────────────────────────────────────────────────────
-const brandRows = [
-    {
-        id: "brand-takara-tomy",
-        slug: "brand-takara-tomy",
-        name: "Takara-Tomy",
-        categoryType: CATEGORY_FIELDS.CATEGORY_TYPE_VALUES.BRAND,
-        description: "Japanese toy company behind Beyblade, Tomica, Transformers (Japan), and Duel Masters. Known for premium quality and Japan-exclusive releases.",
-        brandWebsite: "https://www.takaratomy.co.jp",
-        brandCountry: "Japan",
-        brandFounded: 2006,
-        highlights: [
-            "The Japanese toy company that manufactures every Beyblade generation",
-            "Also behind Tomica, Transformers (Japan region), and Duel Masters",
-            "Known for Japan-exclusive releases and premium tooling quality",
-        ],
-        faqs: [
-            { question: "Is Takara-Tomy the same company as Hasbro's Beyblade line?", answer: "No — Takara-Tomy manufactures and sells Beyblade in Japan and most of Asia; Hasbro licenses and distributes a separate (sometimes different) product line internationally, primarily in North America." },
-            { question: "Are Takara-Tomy imports compatible with Hasbro Beyblade parts?", answer: "Within the same generation (e.g. Burst-to-Burst), yes, in most cases — cross-generation compatibility is not guaranteed." },
-        ],
-        rootId: "brand-takara-tomy",
-        parentIds: [],
-        tier: 0,
-        path: "brand-takara-tomy",
-        isLeaf: true,
-        order: 1,
-        display: { coverImage: seedPhoto("brand-logo-takara-tomy-20260101", 800, 800), showInMenu: false, showInFooter: true },
-        isFeatured: true,
-        isBrand: true,
-        isActive: true,
-        isSearchable: true,
-        createdBy: "user-admin-letitrip",
-        createdAt: daysAgo(300),
-        updatedAt: daysAgo(30),
-        seo: { title: "Takara-Tomy | LetItRip", description: "Shop Takara-Tomy collectibles — Beyblade, Tomica, Transformers.", keywords: ["takara tomy", "takara tomy beyblade", "tomica takara"] },
-    },
-    {
-        id: "brand-beyblade",
-        slug: "brand-beyblade",
-        name: "Beyblade",
-        categoryType: CATEGORY_FIELDS.CATEGORY_TYPE_VALUES.BRAND,
-        description: "Spinning top battle franchise by Takara-Tomy (Japan) and Hasbro (international). Covers the Original series, Metal Fight, Burst, and the latest Beyblade X generation.",
-        brandWebsite: "https://beyblade.takaratomy.co.jp",
-        brandCountry: "Japan",
-        brandFounded: 1999,
-        highlights: [
-            "The franchise itself — spanning four generations since 1999",
-            "One of the best-selling spinning-top toy lines in the world",
-            "A competitive tournament scene alongside casual collecting",
-        ],
-        faqs: [
-            { question: "What age range is Beyblade designed for?", answer: "Most sets are labeled for ages 8+ due to small parts and launcher spring mechanisms — always check the age rating on the listing before buying for a young child." },
-            { question: "Where can I find official tournament rules?", answer: "Takara-Tomy and Hasbro both publish official battle rules for their respective regions — check the manufacturer's site linked from this page's \"Website\" field for the current rulebook." },
-        ],
-        rootId: "brand-beyblade",
-        parentIds: [],
-        tier: 0,
-        path: "brand-beyblade",
-        isLeaf: true,
-        order: 2,
-        display: { coverImage: seedPhoto("brand-logo-beyblade-20260101", 800, 800), showInMenu: false, showInFooter: true },
-        isFeatured: true,
-        isBrand: true,
-        isActive: true,
-        isSearchable: true,
-        createdBy: "user-admin-letitrip",
-        createdAt: daysAgo(300),
-        updatedAt: daysAgo(30),
-        seo: { title: "Beyblade | LetItRip", description: "Shop Beyblade — Original, X, Burst, Metal Fight tops and stadiums.", keywords: ["beyblade", "beyblade x", "beyblade burst", "spinning top battle"] },
-    },
-    {
-        id: "brand-hasbro",
-        slug: "brand-hasbro",
-        name: "Hasbro",
-        categoryType: CATEGORY_FIELDS.CATEGORY_TYPE_VALUES.BRAND,
-        description: "The international Beyblade licensee — Hasbro distributes its own Beyblade product line outside Japan, with different packaging, part names and sometimes different mould tolerances from the Takara-Tomy originals.",
-        brandWebsite: "https://shop.hasbro.com",
-        brandCountry: "United States",
-        brandFounded: 1923,
-        highlights: [
-            "The Beyblade line most collectors outside Japan grew up with",
-            "Widely available and generally cheaper than Japanese imports",
-            "Same-generation parts are usually cross-compatible with Takara-Tomy",
-        ],
-        faqs: [
-            { question: "Is a Hasbro Beyblade worse than the Takara-Tomy version?", answer: "Not worse, but often different — Hasbro releases can use different plastics and slightly looser tolerances, which competitive players notice. For casual play they perform comparably." },
-            { question: "Can I mix Hasbro and Takara-Tomy parts?", answer: "Within the same generation, almost always yes. Across generations, no — the launcher and locking systems differ." },
-        ],
-        rootId: "brand-hasbro",
-        parentIds: [],
-        tier: 0,
-        path: "brand-hasbro",
-        isLeaf: true,
-        order: 3,
-        display: { coverImage: seedPhoto("brand-logo-hasbro-20260101", 800, 800), showInMenu: false, showInFooter: true },
-        isFeatured: false,
-        isBrand: true,
-        isActive: true,
-        isSearchable: true,
-        createdBy: "user-admin-letitrip",
-        createdAt: daysAgo(300),
-        updatedAt: daysAgo(30),
-        seo: { title: "Hasbro | LetItRip", description: "Shop Hasbro Beyblade — the international product line.", keywords: ["hasbro", "hasbro beyblade", "beyblade burst hasbro"] },
-    },
-    {
-        // The Living Collectibles root needs a brand of its own: live listings are
-        // sold by individual keepers and breeders, not by a manufacturer. Without
-        // one, the three live-item products carried a `brand: "Beyblade Arena"`
-        // string (a STORE name in a brand field) that matched no brand row, so they
-        // were invisible on every brand page.
-        id: "brand-independent-keepers",
-        slug: "brand-independent-keepers",
-        name: "Independent Keepers",
-        categoryType: CATEGORY_FIELDS.CATEGORY_TYPE_VALUES.BRAND,
-        description: "Live animals and plants come from individual keepers, breeders and growers rather than a manufacturer. This entry groups those listings so they are reachable from brand browsing like everything else.",
-        brandCountry: "India",
-        highlights: [
-            "Every seller is verified before a live listing can go public",
-            "Provenance, age and health information disclosed per listing",
-        ],
-        faqs: [
-            { question: "Why is there a \"brand\" for living things at all?", answer: "Purely so live listings behave like every other listing in browse and search. It identifies the class of seller, not a manufacturer." },
-        ],
-        rootId: "brand-independent-keepers",
-        parentIds: [],
-        tier: 0,
-        path: "brand-independent-keepers",
-        isLeaf: true,
-        order: 4,
-        display: { coverImage: seedPhoto("brand-logo-independent-keepers-20260101", 800, 800), showInMenu: false, showInFooter: false },
-        isFeatured: false,
-        isBrand: true,
-        isActive: true,
-        isSearchable: true,
-        createdBy: "user-admin-letitrip",
-        createdAt: daysAgo(300),
-        updatedAt: daysAgo(30),
-        seo: { title: "Independent Keepers | LetItRip", description: "Live animals and plants from verified independent keepers and growers.", keywords: ["independent keepers", "breeders", "live plants"] },
-    },
-];
+const brandRows = buildBrandRows({
+    createdBy: "user-admin-letitrip",
+    createdAt: daysAgo(300),
+    updatedAt: daysAgo(30),
+});
 // P-17 — 5 bundle rows (categoryType:"bundle") grouping the Beyblade-minimal
 // standard products by generation, plus one cross-generation starter pack.
 // Every bundle references real seeded product ids (products-standard-seed-data.ts),
 // all currently under store-beyblade-arena.
+/*
+ * 🛑 `bundleCategorySlugs` is DERIVED, because it is a MIRROR and mirrors
+ * drift (Root Cause #42).
+ *
+ * The field is the union of the members' `categorySlugs`, and it is what lets
+ * a category page scope its Bundles tab at all. It was hand-written across
+ * all five bundles — and it drifted in B5 the moment the Beyblade X tree
+ * changed: two bundles still named `category-x-starters` and
+ * `category-x-boosters`, leaves that no longer exist, so those bundles had
+ * silently stopped appearing under any Beyblade X category.
+ *
+ * Worse, the stale strings were still being READ as valid seed ids by
+ * `audit-tester-plugin-wiring` R7 once its id scan was widened, which briefly
+ * made two genuinely-broken authored tester cases stop being reported. A
+ * hand-maintained mirror does not only go wrong — it can keep the check that
+ * would have caught it quiet.
+ *
+ * Deriving from the members' own chains means the union cannot disagree with
+ * them, and a member whose chain moves updates every bundle holding it.
+ */
+const PRODUCT_CHAINS = new Map(productsStandardSeedData.map((p) => [String(p.id), (p.categorySlugs ?? [])]));
+function bundleCategorySlugsFor(productIds) {
+    const out = [];
+    for (const id of productIds) {
+        const chain = PRODUCT_CHAINS.get(id);
+        /*
+         * A member missing from the standard seed is a BUG, not something to shrug
+         * past: the bundle would silently lose that member's categories and the
+         * Bundles tab would under-report. All eight current members are standard
+         * products; if that changes, widen the map rather than softening this.
+         */
+        if (!chain)
+            throw new Error(`bundle member ${id} is not in productsStandardSeedData`);
+        for (const c of chain)
+            if (!out.includes(c))
+                out.push(c);
+    }
+    return out;
+}
 const bundleRows = [
     {
         id: "bundle-original-collectors-set",
@@ -319,7 +250,7 @@ const bundleRows = [
             productIds: ["product-beyblade-original-dranzer-s", "product-beyblade-original-driger-v", "product-beyblade-metal-storm-pegasus"],
         },
         bundleProductIds: ["product-beyblade-original-dranzer-s", "product-beyblade-original-driger-v", "product-beyblade-metal-storm-pegasus"],
-        bundleCategorySlugs: ["category-original-hms", "category-original-tops", "category-beyblade-original", "category-spinning-tops", "category-original-plastic-gen", "category-metal-masters", "category-metal-tops", "category-beyblade-metal"],
+        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-original-dranzer-s", "product-beyblade-original-driger-v", "product-beyblade-metal-storm-pegasus"]),
         bundleOriginalTotal: 4597, // 1499 + 1799 + 1299
         bundleStockStatus: "in_stock",
         display: { coverImage: seedPhoto("bundle-original-collectors-set-20260101", 1200, 900), showInFooter: false },
@@ -354,7 +285,7 @@ const bundleRows = [
             productIds: ["product-beyblade-metal-storm-pegasus", "product-beyblade-metal-flame-sagittario", "product-beyblade-original-dranzer-s"],
         },
         bundleProductIds: ["product-beyblade-metal-storm-pegasus", "product-beyblade-metal-flame-sagittario", "product-beyblade-original-dranzer-s"],
-        bundleCategorySlugs: ["category-metal-masters", "category-metal-tops", "category-beyblade-metal", "category-spinning-tops", "category-metal-fury", "category-original-hms", "category-original-tops", "category-beyblade-original"],
+        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-metal-storm-pegasus", "product-beyblade-metal-flame-sagittario", "product-beyblade-original-dranzer-s"]),
         bundleOriginalTotal: 3997, // 1299 + 1199 + 1499
         bundleStockStatus: "in_stock",
         display: { coverImage: seedPhoto("bundle-metal-fusion-duo-20260101", 1200, 900), showInFooter: false },
@@ -391,7 +322,7 @@ const bundleRows = [
             productIds: ["product-beyblade-burst-valkyrie", "product-beyblade-burst-regalia-genesis", "product-beyblade-metal-flame-sagittario"],
         },
         bundleProductIds: ["product-beyblade-burst-valkyrie", "product-beyblade-burst-regalia-genesis", "product-beyblade-metal-flame-sagittario"],
-        bundleCategorySlugs: ["category-burst-superking", "category-burst-tops", "category-beyblade-burst", "category-spinning-tops", "category-burst-classic", "category-metal-fury", "category-metal-tops", "category-beyblade-metal"],
+        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-burst-valkyrie", "product-beyblade-burst-regalia-genesis", "product-beyblade-metal-flame-sagittario"]),
         bundleOriginalTotal: 3597, // 999 + 1399 + 1199
         bundleStockStatus: "in_stock",
         display: { coverImage: seedPhoto("bundle-burst-battlers-pack-20260101", 1200, 900), showInFooter: false },
@@ -426,7 +357,7 @@ const bundleRows = [
             productIds: ["product-beyblade-x-wizard-arrow", "product-beyblade-x-knife-shinobi", "product-beyblade-burst-valkyrie"],
         },
         bundleProductIds: ["product-beyblade-x-wizard-arrow", "product-beyblade-x-knife-shinobi", "product-beyblade-burst-valkyrie"],
-        bundleCategorySlugs: ["category-x-starters", "category-x-tops", "category-beyblade-x", "category-spinning-tops", "category-x-boosters", "category-burst-superking", "category-burst-tops", "category-beyblade-burst"],
+        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-x-wizard-arrow", "product-beyblade-x-knife-shinobi", "product-beyblade-burst-valkyrie"]),
         bundleOriginalTotal: 2847, // 899 + 949 + 999
         bundleStockStatus: "in_stock",
         display: { coverImage: seedPhoto("bundle-x-series-starter-20260101", 1200, 900), showInFooter: false },
@@ -474,7 +405,7 @@ const bundleRows = [
             "product-beyblade-burst-valkyrie",
             "product-beyblade-x-wizard-arrow",
         ],
-        bundleCategorySlugs: ["category-original-plastic-gen", "category-original-tops", "category-beyblade-original", "category-spinning-tops", "category-metal-masters", "category-metal-tops", "category-beyblade-metal", "category-burst-superking", "category-burst-tops", "category-beyblade-burst", "category-x-starters", "category-x-tops", "category-beyblade-x"],
+        bundleCategorySlugs: bundleCategorySlugsFor(["product-beyblade-original-driger-v", "product-beyblade-metal-storm-pegasus", "product-beyblade-burst-valkyrie", "product-beyblade-x-wizard-arrow"]),
         bundleOriginalTotal: 4996, // 1799 + 1299 + 999 + 899
         bundleStockStatus: "in_stock",
         display: { coverImage: seedPhoto("bundle-every-generation-starter-pack-20260101", 1200, 900), showInFooter: false },
@@ -496,17 +427,64 @@ const bundleRows = [
         updatedAt: daysAgo(1),
     },
 ];
-export const categoriesSeedData = [
+/*
+ * One array, wrapped once.
+ *
+ * `categoriesSeedData` and `categoriesP1SeedData` were two byte-identical
+ * literals, so every change had to be made twice — and `searchTxt` would have
+ * been two derivations to keep in step, which is the exact drift
+ * `search-txt-wrappers.ts` exists to prevent.
+ *
+ * 🛑 `withCategorySearchTxt` is applied AFTER the spread, deliberately:
+ * `buildCategorySearchTxt` indexes `path` and `ancestors[].name`, both DERIVED
+ * by `buildCategoryTree`. Wrapping a row before derivation would index
+ * name/slug/description only and silently drop the lineage search — typing
+ * "burst" would stop reaching a tier-4 model under Beyblade Burst.
+ */
+const allCategoryRows = [
     ...rawCategories.map((c) => ({ ancestors: [], ...c, createdByType: "admin" })),
     ...sublistingRows.map((s) => ({ ancestors: [], ...s, createdByType: "admin" })),
     ...brandRows.map((b) => ({ ancestors: [], ...b, createdByType: "admin" })),
     ...bundleRows.map((b) => ({ ancestors: [], ...b })),
-];
+].map(withCategorySearchTxt);
+/*
+ * ── Assertions, at MODULE LOAD, so a silent drop is loud ─────────────────────
+ *
+ * 🛑 These exist because of a specific failure shape this file is exposed to:
+ * `appkit-seed status` counts documents BY ID, so it cannot see content drift
+ * at all, and `load` is a `set(…, {merge:true})` that never removes a field.
+ * A generated map that silently emptied — `MODEL_LEAVES` keyed on a line id
+ * the forest renamed, say — would produce a tree that builds, typechecks,
+ * seeds without error, reports perfectly in sync, and is missing 216 pages.
+ *
+ * Throwing at import is the right severity: every consumer of this module
+ * (the seed CLI, the tester fixtures, the audits) wants to fail before writing
+ * rather than after.
+ */
+const modelLeafRows = rawCategories.filter((c) => c.tier === 4).length;
+if (modelLeafRows !== MODEL_LEAF_COUNT) {
+    throw new Error(`category seed: ${modelLeafRows} tier-4 model leaves reached the tree but ` +
+        `category-models.ts generated ${MODEL_LEAF_COUNT}. A line id in the ` +
+        `forest no longer matches a key in MODEL_LEAVES — re-run ` +
+        `node scripts/gen-category-models.mjs and check the line ids.`);
+}
+if (brandRows.length !== BRAND_ROW_COUNT) {
+    throw new Error(`category seed: ${brandRows.length} brand rows built, expected ${BRAND_ROW_COUNT}`);
+}
+{
+    /*
+     * A price band keyed on a leaf that does not exist is dead weight that READS
+     * AS COVERAGE — the hint renders nowhere and nothing says so. Cheap to
+     * check, and it is the most likely thing to rot as the tree is edited.
+     */
+    const ids = new Set(rawCategories.map((c) => c.id));
+    const orphans = MARKET_BAND_LEAF_IDS.filter((id) => !ids.has(id));
+    if (orphans.length) {
+        throw new Error(`category seed: ${orphans.length} market band(s) key a non-existent ` +
+            `leaf: ${orphans.join(", ")}`);
+    }
+}
+export const categoriesSeedData = allCategoryRows;
 // P-1 default seed: identical to categoriesSeedData (bundle rows included — P-17
 // re-added them 2026-08-15 after the earlier removal referenced below).
-export const categoriesP1SeedData = [
-    ...rawCategories.map((c) => ({ ancestors: [], ...c, createdByType: "admin" })),
-    ...sublistingRows.map((s) => ({ ancestors: [], ...s, createdByType: "admin" })),
-    ...brandRows.map((b) => ({ ancestors: [], ...b, createdByType: "admin" })),
-    ...bundleRows.map((b) => ({ ancestors: [], ...b })),
-];
+export const categoriesP1SeedData = allCategoryRows;

package/dist/seed/index.d.ts

@@ -80,6 +80,7 @@ export { scammersSeedData } from "./scammers-seed-data";
 export { supportTicketsSeedData } from "./support-tickets-seed-data";
 export { testerChecklistSeedData, testerResponsesSeedData, } from "../features/tester/seed-data";
 export { productFeaturesSeedData } from "./product-features-seed-data";
+export { taxCodesSeedData } from "./tax-codes-seed-data";
 export { offersSeedData } from "./offers-seed-data";
 export { payoutMethodsSeedData, shippingConfigsSeedData, analyticsCardsSeedData, analyticsAlertsSeedData, storeCategoriesSeedData, listingTemplatesSeedData, moderationQueueSeedData, reportsSeedData, itemRequestsSeedData, storeWhatsAppConfigSeedData, storeGoogleConfigSeedData, } from "./store-extensions-seed-data";
 export type { SeedManifest, SeedManifestEntry, SeedCollectionName } from "./manifest";

package/dist/seed/index.js

@@ -77,6 +77,7 @@ export { testerChecklistSeedData,
 // continues, which is exactly what happened on the first attempt here.
 testerResponsesSeedData, } from "../features/tester/seed-data";
 export { productFeaturesSeedData } from "./product-features-seed-data";
+export { taxCodesSeedData } from "./tax-codes-seed-data";
 export { offersSeedData } from "./offers-seed-data";
 // S-STORE Extensions (Tier S-STORE) — 11 new collections
 export { payoutMethodsSeedData, shippingConfigsSeedData, analyticsCardsSeedData, analyticsAlertsSeedData, storeCategoriesSeedData, listingTemplatesSeedData, moderationQueueSeedData, reportsSeedData, itemRequestsSeedData, storeWhatsAppConfigSeedData, storeGoogleConfigSeedData, } from "./store-extensions-seed-data";

package/dist/seed/manifest.d.ts

@@ -11,6 +11,6 @@ export interface SeedManifestEntry {
     type?: string;
 }
 /** Every collection name the CLI seeder (appkit/scripts/seed-cli.mjs) and this manifest cover. */
-export type SeedCollectionName = "users" | "addresses" | "categories" | "stores" | "products" | "orders" | "reviews" | "bids" | "coupons" | "carousels" | "carouselSlides" | "homepageSections" | "siteSettings" | "faqs" | "notifications" | "payouts" | "blogPosts" | "events" | "eventEntries" | "sessions" | "carts" | "wishlists" | "history" | "groupedListings" | "scammerProfiles" | "supportTickets" | "productFeatures" | "offers" | "couponUsage" | "claimedCoupons" | "payoutMethods" | "shippingConfigs" | "analyticsCards" | "analyticsAlerts" | "storeCategories" | "listingTemplates" | "moderationQueue" | "reports" | "itemRequests" | "storeWhatsAppConfig" | "storeGoogleConfig" | "roleOverrides" | "customRoles" | "adminNotifications" | "lotteryEntries" | "shipments" | "shipmentLots" | "shipmentItems" | "catalogueItems" | "testerChecklistItems";
+export type SeedCollectionName = "users" | "addresses" | "categories" | "stores" | "products" | "orders" | "reviews" | "bids" | "coupons" | "carousels" | "carouselSlides" | "homepageSections" | "siteSettings" | "faqs" | "notifications" | "payouts" | "blogPosts" | "events" | "eventEntries" | "sessions" | "carts" | "wishlists" | "history" | "groupedListings" | "scammerProfiles" | "supportTickets" | "productFeatures" | "taxCodes" | "offers" | "couponUsage" | "claimedCoupons" | "payoutMethods" | "shippingConfigs" | "analyticsCards" | "analyticsAlerts" | "storeCategories" | "listingTemplates" | "moderationQueue" | "reports" | "itemRequests" | "storeWhatsAppConfig" | "storeGoogleConfig" | "roleOverrides" | "customRoles" | "adminNotifications" | "lotteryEntries" | "shipments" | "shipmentLots" | "shipmentItems" | "catalogueItems" | "testerChecklistItems";
 export type SeedManifest = Record<SeedCollectionName, SeedManifestEntry[]>;
 export declare const SEED_MANIFEST: SeedManifest;