@mohasinac/appkit 4.53.1 → 4.54.0-next.0

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

@@ -57,8 +57,8 @@ import { withCategorySearchTxt } from "./_helpers/search-txt-wrappers.js";
 import { CATEGORY_FOREST } from "./_helpers/category-forest.js";
 import { BRAND_ROW_COUNT, buildBrandRows } from "./_helpers/brand-rows.js";
 import { FRANCHISE_ROW_COUNT, buildFranchiseRows } from "./_helpers/franchise-rows.js";
-import { MODEL_LEAF_COUNT } from "./_helpers/category-models.js";
-import { PART_LEAF_COUNT } from "./_helpers/category-parts.js";
+import { MODEL_LEAF_COUNT, MODEL_LEAVES } from "./_helpers/category-models.js";
+import { PART_LEAF_COUNT, PART_LEAVES } from "./_helpers/category-parts.js";
 import { MARKET_BAND_LEAF_IDS } from "./_helpers/category-content.js";
 import { GENERATED_CATEGORY_CONTENT, GENERATED_CATEGORY_CONTENT_COUNT, } from "./_helpers/category-content-generated.js";
 import { GENERATED_CATEGORY_IMAGES, GENERATED_CATEGORY_IMAGE_COUNT, GENERATED_CATEGORY_HASBRO_IMAGES, } from "./_helpers/category-images-generated.js";
@@ -743,11 +743,53 @@ if (allIds.length !== allCategoryRows.length) {
 const tier4Rows = rawCategories.filter((c) => c.tier === 4).length;
 const expectedTier4 = MODEL_LEAF_COUNT + PART_LEAF_COUNT;
 if (tier4Rows !== expectedTier4) {
+    /*
+     * 🛑 NAME THE DROPPED LEAVES. A count told us 2,626 of 2,711 arrived and
+     * nothing more, which is unactionable: the ids are all distinct and every
+     * parent key exists in the forest, so the difference is in WHICH parent each
+     * leaf hangs off and at what depth — and that is only visible per leaf.
+     *
+     * The expensive version of this was a session spent inferring the cause from
+     * indentation in the forest literal. The cheap version is the set
+     * difference, grouped by the parent that owns each missing leaf, which also
+     * says the tier it actually landed at. One run names the fix.
+     */
+    const reached = new Set(rawCategories.filter((c) => c.tier === 4).map((c) => String(c.id)));
+    const tierOf = new Map(rawCategories.map((c) => [String(c.id), c.tier]));
+    const declared = [];
+    for (const [parent, leaves] of Object.entries(MODEL_LEAVES)) {
+        for (const leaf of leaves)
+            declared.push({ id: leaf.id, parent });
+    }
+    for (const [parent, leaves] of Object.entries(PART_LEAVES)) {
+        for (const leaf of leaves)
+            declared.push({ id: leaf.id, parent });
+    }
+    const missing = declared.filter((d) => !reached.has(d.id));
+    const byParent = new Map();
+    for (const m of missing) {
+        if (!byParent.has(m.parent)) {
+            byParent.set(m.parent, { n: 0, landedAt: new Set(), sample: [] });
+        }
+        const g = byParent.get(m.parent);
+        g.n += 1;
+        g.landedAt.add(tierOf.has(m.id) ? `tier ${tierOf.get(m.id)}` : "absent");
+        if (g.sample.length < 3)
+            g.sample.push(m.id);
+    }
+    const detail = [...byParent.entries()]
+        .sort((a, b) => b[1].n - a[1].n)
+        .map(([parent, g]) => `    ${parent}: ${g.n} leaf/leaves landed at ${[...g.landedAt].join("+")} ` +
+        `(e.g. ${g.sample.join(", ")})`)
+        .join("\n");
     throw new Error(`category seed: ${tier4Rows} tier-4 leaves reached the tree but the generated ` +
-        `maps declare ${expectedTier4} (${MODEL_LEAF_COUNT} models + ${PART_LEAF_COUNT} parts). ` +
-        `A parent id in the forest no longer matches a key in MODEL_LEAVES or PART_LEAVES — ` +
-        `re-run node scripts/gen-category-models.mjs and node scripts/gen-category-parts.mjs ` +
-        `and check the parent ids.`);
+        `maps declare ${expectedTier4} (${MODEL_LEAF_COUNT} models + ${PART_LEAF_COUNT} parts).\n` +
+        `  ${missing.length} declared leaf/leaves did not arrive as tier 4, by parent:\n` +
+        `${detail}\n` +
+        `  A parent at the wrong DEPTH puts its leaves at the wrong tier (a leaf is ` +
+        `always parentDepth+1); a parent id the forest renamed makes them absent ` +
+        `entirely. Fix the forest, then re-run node scripts/gen-category-models.mjs ` +
+        `and node scripts/gen-category-parts.mjs.`);
 }
 if (brandRows.length !== BRAND_ROW_COUNT) {
     throw new Error(`category seed: ${brandRows.length} brand rows built, expected ${BRAND_ROW_COUNT}`);

package/dist/seed/homepage-sections-seed-data.js

@@ -21,24 +21,33 @@
  * section type with a renderer and zero seeded rows is the same class of gap,
  * just silent rather than colliding.
  *
- * ORDER follows current marketplace-homepage research rather than the previous
- * arbitrary arrangement: hero → trust → orient (categories, systems matrix) →
- * shop (products, auctions, pre-orders, bundles) → supply (stores) → social
- * proof (reviews) → engage (events, raffles, prize draws) → editorial (blog) →
- * convert (seller banner, newsletter) → reassure (stats, security, community,
- * FAQ, brands).
+ * ORDER: hero → SHOP (products, auctions, pre-orders) → carousel → trust →
+ * orient (categories, systems matrix) → shop cont. (bundles) → supply
+ * (stores) → social proof (reviews) → engage (events, raffles, prize draws) →
+ * editorial (blog) → convert (seller banner, newsletter) → reassure (stats,
+ * security, community, FAQ, brands).
  *
- * The systems matrix sits at 5, between the generation tiles and the first
- * product rail, because that is where the measured leader puts it: on
- * worldhobbyshop "Browse Beyblade Systems & Series" (25 text links) follows
- * "Shop Beyblades by Generation" (6 image tiles) and precedes the one product
- * rail — taxonomy routing before merchandising. See
+ * 🛑 Products (2), auctions (3) and pre-orders (4) were lifted above the
+ * carousel on 2026-10-20 at the owner's request — real merchandise directly
+ * under the hero, promotions below it. That OVERRIDES the research arrangement
+ * this header used to describe (trust → orient → shop), so do not "restore"
+ * the old order on the strength of the paragraphs below; they explain the
+ * reasoning for the sections that are still in a research-driven position,
+ * not a mandate for the three that were deliberately moved. Pre-orders came
+ * up from 8 in a second pass, which is why the carousel/trust/categories/
+ * matrix block reads 5 → 8 rather than 4 → 7.
+ *
+ * The systems matrix still sits immediately after the generation tiles (7 → 8)
+ * because that is where the measured leader puts it: on worldhobbyshop
+ * "Browse Beyblade Systems & Series" (25 text links) follows "Shop Beyblades
+ * by Generation" (6 image tiles) — taxonomy routing stays together. See
  * docs/research/competitor-crawl-2026-10/layout.md.
  *
- * Baymard's finding drives the top: a static hero outperforms a carousel, and
- * the one documented carousel win came from demoting it BELOW a static hero.
- * So `welcome` is first and owns the page's single <h1>; `carousel` sits under
- * it and its slide titles render as <h2>.
+ * Baymard's finding still drives the hero: a static hero outperforms a
+ * carousel, and the one documented carousel win came from demoting it BELOW a
+ * static hero. So `welcome` is first and owns the page's single <h1>; the
+ * `carousel` is now demoted further still, under the first three product
+ * rails, and its slide titles render as <h2>.
  *
  * COPY IS CATALOGUE-NEUTRAL on purpose. "Shop by Category" stays correct
  * however the catalogue changes; "Burst & X Series" goes stale the moment it
@@ -89,13 +98,13 @@ export const homepageSectionsSeedData = [
         createdAt: daysAgo(90),
         updatedAt: daysAgo(2),
     },
-    // ---- 2. Promo carousel ---------------------------------------------------
+    // ---- 5. Promo carousel ---------------------------------------------------
     // "medium" rather than "tall": it now sits UNDER a full hero, so a
     // viewport-height band would push everything else below the fold.
     {
         id: "section-hero-carousel",
         type: "carousel",
-        order: 2,
+        order: 5,
         enabled: true,
         config: {
             title: "Featured promotions",
@@ -108,13 +117,13 @@ export const homepageSectionsSeedData = [
         createdAt: daysAgo(90),
         updatedAt: daysAgo(5),
     },
-    // ---- 3. Trust bar --------------------------------------------------------
-    // Moved up from 4. Research: ~80% of attention is above the fold and the
-    // first 3–4 trust elements carry nearly all of the lift.
+    // ---- 6. Trust bar --------------------------------------------------------
+    // Research: ~80% of attention is above the fold and the first 3–4 trust
+    // elements carry nearly all of the lift.
     {
         id: "section-trust-indicators",
         type: "trust-indicators",
-        order: 3,
+        order: 6,
         enabled: true,
         config: {
             title: "Why buyers trust us",
@@ -148,12 +157,12 @@ export const homepageSectionsSeedData = [
         createdAt: daysAgo(90),
         updatedAt: daysAgo(20),
     },
-    // ---- 4. Orient: categories ----------------------------------------------
+    // ---- 7. Orient: categories ----------------------------------------------
     // Baymard's top homepage guideline, and the main internal-linking surface.
     {
         id: "section-collectibles-categories",
         type: "categories",
-        order: 4,
+        order: 7,
         enabled: true,
         config: {
             title: "Shop by Category",
@@ -173,13 +182,17 @@ export const homepageSectionsSeedData = [
         createdAt: daysAgo(90),
         updatedAt: daysAgo(10),
     },
-    // ---- 5–8. Shop -----------------------------------------------------------
+    // ---- 2–4, 9. Shop --------------------------------------------------------
+    // Products (2), auctions (3) and pre-orders (4) sit directly under the hero,
+    // ABOVE the carousel — a merchandising-first top of page, asked for
+    // 2026-10-20. Bundles (9) stay below the orientation band.
+    //
     // maxItems stays <= 12 everywhere: SSR supplies exactly 12 via
     // getFeatured*(12), so a larger cap would promise rows that cannot fill.
     {
         id: "section-featured-products",
         type: "products",
-        order: 6,
+        order: 2,
         enabled: true,
         config: {
             title: "Featured Products",
@@ -210,7 +223,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-live-auctions",
         type: "auctions",
-        order: 7,
+        order: 3,
         enabled: true,
         config: {
             title: "Live Auctions",
@@ -228,7 +241,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-pre-orders",
         type: "pre-orders",
-        order: 8,
+        order: 4,
         enabled: true,
         config: {
             title: "Reserve Before It Ships",
@@ -635,7 +648,7 @@ export const homepageSectionsSeedData = [
     {
         id: "section-systems-matrix",
         type: "custom-cards",
-        order: 5,
+        order: 8,
         enabled: true,
         config: {
             title: "Every system, every part family",

package/dist/seed/model-composition-seed-data.js

@@ -2493,7 +2493,7 @@ export const modelCompositionSeedData = [
                 "slotKey": "blade-base",
                 "slotLabel": "BLADE BASE (BB)",
                 "partName": "Metal Sharp Base",
-                "partId": "blade-base--metal-sharp-base"
+                "partId": "blade-base--blade-base"
             }
         ],
         "source": "gen1/plastic/flash-leopard-2.md",
@@ -6587,14 +6587,12 @@ export const modelCompositionSeedData = [
             {
                 "slotKey": "disc",
                 "slotLabel": "FORGE DISC",
-                "partName": "variable per combo",
-                "partId": "disc--variable-per-combo"
+                "partName": "variable per combo"
             },
             {
                 "slotKey": "performance-tip",
                 "slotLabel": "PERFORMANCE TIP",
-                "partName": "variable per combo",
-                "partId": "performance-tip--variable-per-combo"
+                "partName": "variable per combo"
             }
         ],
         "source": "gen3/bu/draciel-fortress.md",
@@ -7415,7 +7413,7 @@ export const modelCompositionSeedData = [
                 "slotKey": "driver",
                 "slotLabel": "DRIVER",
                 "partName": "Destroy'",
-                "partId": "driver--destroy-dash"
+                "partId": "driver--destroy"
             }
         ],
         "source": "gen3/db/rage-longinus-s5.md"
@@ -7925,7 +7923,7 @@ export const modelCompositionSeedData = [
                 "slotKey": "driver",
                 "slotLabel": "PERFORMANCE DRIVER",
                 "partName": "Evolution'",
-                "partId": "driver--evolution-dash"
+                "partId": "driver--evolution"
             }
         ],
         "source": "gen3/superking/brave-valtryek.md"
@@ -7972,7 +7970,7 @@ export const modelCompositionSeedData = [
                 "slotKey": "driver",
                 "slotLabel": "DRIVER",
                 "partName": "Destroy'",
-                "partId": "driver--destroy-dash"
+                "partId": "driver--destroy"
             }
         ],
         "source": "gen3/superking/rage-longinus-d3a.md"

package/dist/seed/part-glossary/chunk0.d.ts

@@ -0,0 +1,9 @@
+/**
+ * GENERATED by `scripts/generate-parts-seed.mjs` — do not hand-edit.
+ *
+ * Chunk 0 of the part glossary. See `../part-glossary-seed-data.ts` for
+ * provenance and for why the chunks are separate FILES rather than separate
+ * consts in one file.
+ */
+import type { PartGlossaryDocument } from "../../features/parts/schemas/firestore";
+export declare const glossaryChunk0: Partial<PartGlossaryDocument>[];