@mohasinac/appkit 4.49.1 → 4.51.0

package/dist/seed/_helpers/category-images-generated.js

@@ -7,10 +7,30 @@
  * a third-party URL (Root Cause #104 — that adds an upstream fetch to every
  * single render).
  *
+ * Covers BOTH complete-model leaves and PART leaves — they share one id space
+ * (`category-*`), so one map serves the category cover and, through
+ * `gen-catalogue-listings.mjs`, that leaf's product listing image too.
+ *
  * A hand-authored `display.coverImage` always wins over this map; a row absent
  * from it keeps no image rather than being given a placeholder. See
  * `withGeneratedCoverImage` in `categories-seed-data.ts`.
  *
+ * ── Replacing one of these with your own photograph ───────────────────────
+ *
+ * `CategoryForm` already edits `display.coverImage` (upload -> `/media/<id>`),
+ * so any of these can be swapped for an original at runtime.
+ *
+ * 🛑 But a RUNTIME edit does not survive `appkit-seed load` — the loader
+ * merge-writes `display`, so the generated value comes back. To replace one
+ * permanently, set `display.coverImage` in the category SOURCE (the forest or
+ * the seed row); the hand-authored value then wins here forever. That is the
+ * deliberate trade for "the seed can always rebuild the database".
+ *
+ * Deleting them entirely: remove the `media/categories/` Storage prefix, delete
+ * this file and `media-assets-seed-data.ts`, re-run the category seed. Bucket
+ * versioning and soft-delete are both OFF, so a deleted object leaves no
+ * recoverable copy and no residual billing.
+ *
  * Source and licensing for every file:
  * `docs/research/bey-corpus-2026-10/image-provenance.json`.
  */
@@ -210,5 +230,314 @@ export const GENERATED_CATEGORY_IMAGES = {
     "category-wyvern-dj": "/media/category-wyvern-dj-image",
     "category-z-achilles-11-xtend": "/media/category-z-achilles-11-xtend-image",
     "category-zeus": "/media/category-zeus-image",
+    "category-circle-upper": "/media/category-circle-upper-image",
+    "category-cross-attacker": "/media/category-cross-attacker-image",
+    "category-cross-dranzer": "/media/category-cross-dranzer-image",
+    "category-cross-fang": "/media/category-cross-fang-image",
+    "category-cross-griffon": "/media/category-cross-griffon-image",
+    "category-cross-spike": "/media/category-cross-spike-image",
+    "category-cross-spiker": "/media/category-cross-spiker-image",
+    "category-cybernetic-dragon": "/media/category-cybernetic-dragon-image",
+    "category-devil-crusher": "/media/category-devil-crusher-image",
+    "category-double-horn": "/media/category-double-horn-image",
+    "category-double-wing": "/media/category-double-wing-image",
+    "category-dragon-breaker": "/media/category-dragon-breaker-image",
+    "category-dragon-saucer": "/media/category-dragon-saucer-image",
+    "category-eight-attacker": "/media/category-eight-attacker-image",
+    "category-eight-spike": "/media/category-eight-spike-image",
+    "category-flame-wing": "/media/category-flame-wing-image",
+    "category-g-upper": "/media/category-g-upper-image",
+    "category-genocide-circle": "/media/category-genocide-circle-image",
+    "category-gigantic-claw": "/media/category-gigantic-claw-image",
+    "category-great-dragon": "/media/category-great-dragon-image",
+    "category-hammer-tusk": "/media/category-hammer-tusk-image",
+    "category-howling-leo": "/media/category-howling-leo-image",
+    "category-jiraiya-blade": "/media/category-jiraiya-blade-image",
+    "category-metal-ape": "/media/category-metal-ape-image",
+    "category-metal-attacker": "/media/category-metal-attacker-image",
+    "category-metal-defense": "/media/category-metal-defense-image",
+    "category-metal-saucer": "/media/category-metal-saucer-image",
+    "category-mountain-hammer": "/media/category-mountain-hammer-image",
+    "category-panther-claw": "/media/category-panther-claw-image",
+    "category-panther-head": "/media/category-panther-head-image",
+    "category-penta-wing": "/media/category-penta-wing-image",
+    "category-reverse-dragon": "/media/category-reverse-dragon-image",
+    "category-attack-ring-sharkrash": "/media/category-attack-ring-sharkrash-image",
+    "category-shield-hammer": "/media/category-shield-hammer-image",
+    "category-sonic-tiger": "/media/category-sonic-tiger-image",
+    "category-spike-dragon": "/media/category-spike-dragon-image",
+    "category-spiral-upper": "/media/category-spiral-upper-image",
+    "category-star-wolf": "/media/category-star-wolf-image",
+    "category-strike-turtle": "/media/category-strike-turtle-image",
+    "category-ten-spike": "/media/category-ten-spike-image",
+    "category-tiger-defenser": "/media/category-tiger-defenser-image",
+    "category-triangle-wing": "/media/category-triangle-wing-image",
+    "category-triple-beak": "/media/category-triple-beak-image",
+    "category-turtle-survivor": "/media/category-turtle-survivor-image",
+    "category-ultimate-attacker": "/media/category-ultimate-attacker-image",
+    "category-upper-claw": "/media/category-upper-claw-image",
+    "category-upper-dragon": "/media/category-upper-dragon-image",
+    "category-attack-ring-vanishing-moot": "/media/category-attack-ring-vanishing-moot-image",
+    "category-war-lion": "/media/category-war-lion-image",
+    "category-war-monkey": "/media/category-war-monkey-image",
+    "category-wing-survivor": "/media/category-wing-survivor-image",
+    "category-wing-upper": "/media/category-wing-upper-image",
+    "category-wolf-crusher": "/media/category-wolf-crusher-image",
+    "category-accel": "/media/category-accel-image",
+    "category-disk-ball": "/media/category-disk-ball-image",
+    "category-flat": "/media/category-flat-image",
+    "category-free-ball": "/media/category-free-ball-image",
+    "category-gear-ball": "/media/category-gear-ball-image",
+    "category-hexa": "/media/category-hexa-image",
+    "category-point": "/media/category-point-image",
+    "category-taper": "/media/category-taper-image",
+    "category-trans-point": "/media/category-trans-point-image",
+    "category-vortex": "/media/category-vortex-image",
+    "category-bit-chip-apollon": "/media/category-bit-chip-apollon-image",
+    "category-black-dranzer": "/media/category-black-dranzer-image",
+    "category-cyber-draciel": "/media/category-cyber-draciel-image",
+    "category-cyber-dragoon": "/media/category-cyber-dragoon-image",
+    "category-cyber-dranzer": "/media/category-cyber-dranzer-image",
+    "category-cyber-driger": "/media/category-cyber-driger-image",
+    "category-dark-gargoyle": "/media/category-dark-gargoyle-image",
+    "category-draciel": "/media/category-draciel-image",
+    "category-bit-chip-dragoon": "/media/category-bit-chip-dragoon-image",
+    "category-dranzer": "/media/category-dranzer-image",
+    "category-driger": "/media/category-driger-image",
+    "category-bit-chip-flash-leopard": "/media/category-bit-chip-flash-leopard-image",
+    "category-bit-chip-galeon": "/media/category-bit-chip-galeon-image",
+    "category-bit-chip-galman": "/media/category-bit-chip-galman-image",
+    "category-bit-chip-galzzly": "/media/category-bit-chip-galzzly-image",
+    "category-bit-chip-gigars": "/media/category-bit-chip-gigars-image",
+    "category-bit-chip-griffolyon": "/media/category-bit-chip-griffolyon-image",
+    "category-hopper": "/media/category-hopper-image",
+    "category-master-dranzer": "/media/category-master-dranzer-image",
+    "category-bit-chip-metal-draciel": "/media/category-bit-chip-metal-draciel-image",
+    "category-bit-chip-metal-driger": "/media/category-bit-chip-metal-driger-image",
+    "category-rapid-eagle": "/media/category-rapid-eagle-image",
+    "category-bit-chip-rock-bison": "/media/category-bit-chip-rock-bison-image",
+    "category-rushing-boar": "/media/category-rushing-boar-image",
+    "category-bit-chip-salamalyon": "/media/category-bit-chip-salamalyon-image",
+    "category-seaborg": "/media/category-seaborg-image",
+    "category-bit-chip-shadow-driger": "/media/category-bit-chip-shadow-driger-image",
+    "category-bit-chip-sharkrash": "/media/category-bit-chip-sharkrash-image",
+    "category-bit-chip-strata-dragoon": "/media/category-bit-chip-strata-dragoon-image",
+    "category-bit-chip-thunder-pegasus": "/media/category-bit-chip-thunder-pegasus-image",
+    "category-bit-chip-torch-pegasus": "/media/category-bit-chip-torch-pegasus-image",
+    "category-bit-chip-trygle": "/media/category-bit-chip-trygle-image",
+    "category-tryhorn": "/media/category-tryhorn-image",
+    "category-bit-chip-trypio": "/media/category-bit-chip-trypio-image",
+    "category-bit-chip-vanishing-moot": "/media/category-bit-chip-vanishing-moot-image",
+    "category-bit-chip-vortex-ape": "/media/category-bit-chip-vortex-ape-image",
+    "category-bit-chip-wolborg": "/media/category-bit-chip-wolborg-image",
+    "category-bit-chip-wyborg": "/media/category-bit-chip-wyborg-image",
+    "category-bit-chip-zeus": "/media/category-bit-chip-zeus-image",
+    "category-aeropegasus": "/media/category-aeropegasus-image",
+    "category-cobaltdragoon": "/media/category-cobaltdragoon-image",
+    "category-cobaltdrake": "/media/category-cobaltdrake-image",
+    "category-crimsongaruda": "/media/category-crimsongaruda-image",
+    "category-dranbuster": "/media/category-dranbuster-image",
+    "category-drandagger": "/media/category-drandagger-image",
+    "category-dransword": "/media/category-dransword-image",
+    "category-dranzerspiral": "/media/category-dranzerspiral-image",
+    "category-drigerslash": "/media/category-drigerslash-image",
+    "category-ghostcircle": "/media/category-ghostcircle-image",
+    "category-hellshammer": "/media/category-hellshammer-image",
+    "category-hellsscythe": "/media/category-hellsscythe-image",
+    "category-knightshield": "/media/category-knightshield-image",
+    "category-leonclaw": "/media/category-leonclaw-image",
+    "category-phoenixwing": "/media/category-phoenixwing-image",
+    "category-savior": "/media/category-savior-image",
+    "category-sharkedge": "/media/category-sharkedge-image",
+    "category-silverwolf": "/media/category-silverwolf-image",
+    "category-tyrannobeat": "/media/category-tyrannobeat-image",
+    "category-unicornsting": "/media/category-unicornsting-image",
+    "category-vipertail": "/media/category-vipertail-image",
+    "category-wizardarrow": "/media/category-wizardarrow-image",
+    "category-wizardrod": "/media/category-wizardrod-image",
+    "category-customize-clutch-base": "/media/category-customize-clutch-base-image",
+    "category-customize-grip-base": "/media/category-customize-grip-base-image",
+    "category-customize-metal-sharp": "/media/category-customize-metal-sharp-image",
+    "category-engine-stopper-base": "/media/category-engine-stopper-base-image",
+    "category-first-clutch-base": "/media/category-first-clutch-base-image",
+    "category-flame-change-base": "/media/category-flame-change-base-image",
+    "category-fortress-base": "/media/category-fortress-base-image",
+    "category-full-auto-clutch-base": "/media/category-full-auto-clutch-base-image",
+    "category-griffolyon-base": "/media/category-griffolyon-base-image",
+    "category-instant-release": "/media/category-instant-release-image",
+    "category-jumping-base": "/media/category-jumping-base-image",
+    "category-magne-flat-base": "/media/category-magne-flat-base-image",
+    "category-metal-change-base": "/media/category-metal-change-base-image",
+    "category-metal-sharp-base": "/media/category-metal-sharp-base-image",
+    "category-sg-flat-base": "/media/category-sg-flat-base-image",
+    "category-sg-flat": "/media/category-sg-flat-image",
+    "category-sg-jumping-base-2": "/media/category-sg-jumping-base-2-image",
+    "category-sg-metal-ball": "/media/category-sg-metal-ball-image",
+    "category-sg-metal-flat-2": "/media/category-sg-metal-flat-2-image",
+    "category-sg-metal-flat-base": "/media/category-sg-metal-flat-base-image",
+    "category-viper-metal-ball-base": "/media/category-viper-metal-ball-base-image",
+    "category-volcano-change-base": "/media/category-volcano-change-base-image",
+    "category-chrome-wheel-dragoon": "/media/category-chrome-wheel-dragoon-image",
+    "category-0": "/media/category-0-image",
+    "category-00": "/media/category-00-image",
+    "category-disc-1": "/media/category-disc-1-image",
+    "category-10": "/media/category-10-image",
+    "category-11": "/media/category-11-image",
+    "category-disc-7": "/media/category-disc-7-image",
+    "category-8": "/media/category-8-image",
+    "category-aquilon-q": "/media/category-aquilon-q-image",
+    "category-around": "/media/category-around-image",
+    "category-blitz": "/media/category-blitz-image",
+    "category-boost": "/media/category-boost-image",
+    "category-drake": "/media/category-drake-image",
+    "category-force": "/media/category-force-image",
+    "category-karma": "/media/category-karma-image",
+    "category-knuckle": "/media/category-knuckle-image",
+    "category-legacy": "/media/category-legacy-image",
+    "category-limited": "/media/category-limited-image",
+    "category-nexus": "/media/category-nexus-image",
+    "category-nine": "/media/category-nine-image",
+    "category-over": "/media/category-over-image",
+    "category-sting": "/media/category-sting-image",
+    "category-tapered": "/media/category-tapered-image",
+    "category-triple": "/media/category-triple-image",
+    "category-vanguard": "/media/category-vanguard-image",
+    "category-vertical": "/media/category-vertical-image",
+    "category-disc-yell": "/media/category-disc-yell-image",
+    "category-zenith": "/media/category-zenith-image",
+    "category-driver-atomic": "/media/category-driver-atomic-image",
+    "category-driver-bullet": "/media/category-driver-bullet-image",
+    "category-driver-charge": "/media/category-driver-charge-image",
+    "category-destroy-dash": "/media/category-destroy-dash-image",
+    "category-driver-dimension-dash": "/media/category-driver-dimension-dash-image",
+    "category-dimension": "/media/category-dimension-image",
+    "category-drift": "/media/category-drift-image",
+    "category-evolution-dash": "/media/category-evolution-dash-image",
+    "category-iron": "/media/category-iron-image",
+    "category-jaggy": "/media/category-jaggy-image",
+    "category-loop": "/media/category-loop-image",
+    "category-merge": "/media/category-merge-image",
+    "category-driver-mobius": "/media/category-driver-mobius-image",
+    "category-nothing": "/media/category-nothing-image",
+    "category-press": "/media/category-press-image",
+    "category-reboot": "/media/category-reboot-image",
+    "category-revolve-q": "/media/category-revolve-q-image",
+    "category-driver-spiral": "/media/category-driver-spiral-image",
+    "category-unite-dash": "/media/category-unite-dash-image",
+    "category-unite": "/media/category-unite-image",
+    "category-variable-dash": "/media/category-variable-dash-image",
+    "category-variable": "/media/category-variable-image",
+    "category-xceed-x": "/media/category-xceed-x-image",
+    "category-xtend": "/media/category-xtend-image",
+    "category-zone-z": "/media/category-zone-z-image",
+    "category-energy-ring-4d-clear-wheel-orion": "/media/category-energy-ring-4d-clear-wheel-orion-image",
+    "category-energy-ring-blaze": "/media/category-energy-ring-blaze-image",
+    "category-energy-ring-bull": "/media/category-energy-ring-bull-image",
+    "category-capricorn": "/media/category-capricorn-image",
+    "category-energy-ring-capricorne": "/media/category-energy-ring-capricorne-image",
+    "category-clear-wheel-wolf": "/media/category-clear-wheel-wolf-image",
+    "category-nemesis-x": "/media/category-nemesis-x-image",
+    "category-energy-ring-sagittario-i": "/media/category-energy-ring-sagittario-i-image",
+    "category-energy-ring-sagittario": "/media/category-energy-ring-sagittario-image",
+    "category-energy-ring-striker-ii": "/media/category-energy-ring-striker-ii-image",
+    "category-energy-ring-wolf": "/media/category-energy-ring-wolf-image",
+    "category-energy-ring-zurafa": "/media/category-energy-ring-zurafa-image",
+    "category-left-engine-gear": "/media/category-left-engine-gear-image",
+    "category-face-bolt-aquario": "/media/category-face-bolt-aquario-image",
+    "category-face-bolt-aries": "/media/category-face-bolt-aries-image",
+    "category-face-bolt-befall": "/media/category-face-bolt-befall-image",
+    "category-face-bolt-blaze": "/media/category-face-bolt-blaze-image",
+    "category-face-bolt-bull": "/media/category-face-bolt-bull-image",
+    "category-face-bolt-byxis": "/media/category-face-bolt-byxis-image",
+    "category-face-bolt-cygnus": "/media/category-face-bolt-cygnus-image",
+    "category-face-bolt-dragoon": "/media/category-face-bolt-dragoon-image",
+    "category-face-bolt-eagle": "/media/category-face-bolt-eagle-image",
+    "category-face-bolt-jupiter": "/media/category-face-bolt-jupiter-image",
+    "category-face-bolt-l-drago": "/media/category-face-bolt-l-drago-image",
+    "category-orochi": "/media/category-orochi-image",
+    "category-face-bolt-pegasus": "/media/category-face-bolt-pegasus-image",
+    "category-face-bolt-striker-ii": "/media/category-face-bolt-striker-ii-image",
+    "category-variares": "/media/category-variares-image",
+    "category-face-bolt-zurafa": "/media/category-face-bolt-zurafa-image",
+    "category-4d-metal-wheel-phantom": "/media/category-4d-metal-wheel-phantom-image",
+    "category-burn": "/media/category-burn-image",
+    "category-earth": "/media/category-earth-image",
+    "category-flame": "/media/category-flame-image",
+    "category-forbidden": "/media/category-forbidden-image",
+    "category-metal-wheel-mercury": "/media/category-metal-wheel-mercury-image",
+    "category-proto": "/media/category-proto-image",
+    "category-rock": "/media/category-rock-image",
+    "category-dark-deathscyther": "/media/category-dark-deathscyther-image",
+    "category-layer-draciel-fortress": "/media/category-layer-draciel-fortress-image",
+    "category-drain-fafnir": "/media/category-drain-fafnir-image",
+    "category-dranzer-flame": "/media/category-dranzer-flame-image",
+    "category-engine-gear": "/media/category-engine-gear-image",
+    "category-gaia-dragoon": "/media/category-gaia-dragoon-image",
+    "category-genesis-valtryek-v3": "/media/category-genesis-valtryek-v3-image",
+    "category-god-valkyrie": "/media/category-god-valkyrie-image",
+    "category-kaiser-kerbeus": "/media/category-kaiser-kerbeus-image",
+    "category-king-kerbeus-k2": "/media/category-king-kerbeus-k2-image",
+    "category-legend-spriggan": "/media/category-legend-spriggan-image",
+    "category-maximum-garuda": "/media/category-maximum-garuda-image",
+    "category-obelisk-odin": "/media/category-obelisk-odin-image",
+    "category-sieg-xcalibur": "/media/category-sieg-xcalibur-image",
+    "category-spryzen-requiem-s3": "/media/category-spryzen-requiem-s3-image",
+    "category-storm-spriggan": "/media/category-storm-spriggan-image",
+    "category-victory-valkyrie": "/media/category-victory-valkyrie-image",
+    "category-wild-wyvern": "/media/category-wild-wyvern-image",
+    "category-layer-wolborg": "/media/category-layer-wolborg-image",
+    "category-xeno-xcalibur": "/media/category-xeno-xcalibur-image",
+    "category-as": "/media/category-as-image",
+    "category-bs": "/media/category-bs-image",
+    "category-cf": "/media/category-cf-image",
+    "category-cs": "/media/category-cs-image",
+    "category-evolution": "/media/category-evolution-image",
+    "category-ewd": "/media/category-ewd-image",
+    "category-f-d": "/media/category-f-d-image",
+    "category-performance-tip-f": "/media/category-performance-tip-f-image",
+    "category-performance-tip-gf": "/media/category-performance-tip-gf-image",
+    "category-ms": "/media/category-ms-image",
+    "category-r-f": "/media/category-r-f-image",
+    "category-rb": "/media/category-rb-image",
+    "category-rf": "/media/category-rf-image",
+    "category-sf": "/media/category-sf-image",
+    "category-tb": "/media/category-tb-image",
+    "category-wb": "/media/category-wb-image",
+    "category-wsf": "/media/category-wsf-image",
+    "category-0-80": "/media/category-0-80-image",
+    "category-1-60": "/media/category-1-60-image",
+    "category-3-60": "/media/category-3-60-image",
+    "category-3-70": "/media/category-3-70-image",
+    "category-3-80": "/media/category-3-80-image",
+    "category-4-60": "/media/category-4-60-image",
+    "category-4-70": "/media/category-4-70-image",
+    "category-4-80": "/media/category-4-80-image",
+    "category-5-60": "/media/category-5-60-image",
+    "category-5-70": "/media/category-5-70-image",
+    "category-5-80": "/media/category-5-80-image",
+    "category-9-60": "/media/category-9-60-image",
+    "category-flat-core": "/media/category-flat-core-image",
+    "category-grip-flat-core": "/media/category-grip-flat-core-image",
+    "category-manual-change-core": "/media/category-manual-change-core-image",
+    "category-semi-flat-core": "/media/category-semi-flat-core-image",
+    "category-sharp-core": "/media/category-sharp-core-image",
+    "category-heavy-metal-core": "/media/category-heavy-metal-core-image",
+    "category-neo-right-sg": "/media/category-neo-right-sg-image",
+    "category-135": "/media/category-135-image",
+    "category-a230": "/media/category-a230-image",
+    "category-sa165": "/media/category-sa165-image",
+    "category-sp230": "/media/category-sp230-image",
+    "category-t125": "/media/category-t125-image",
+    "category-v145": "/media/category-v145-image",
+    "category-w105": "/media/category-w105-image",
+    "category-circle-balance": "/media/category-circle-balance-image",
+    "category-eight-heavy": "/media/category-eight-heavy-image",
+    "category-heavy-attack": "/media/category-heavy-attack-image",
+    "category-magne-weight-disk": "/media/category-magne-weight-disk-image",
+    "category-star-attack": "/media/category-star-attack-image",
+    "category-ten-balance": "/media/category-ten-balance-image",
+    "category-ten-heavy": "/media/category-ten-heavy-image",
+    "category-ten-wide": "/media/category-ten-wide-image",
+    "category-wing-attacker": "/media/category-wing-attacker-image",
 };
-export const GENERATED_CATEGORY_IMAGE_COUNT = 195;
+export const GENERATED_CATEGORY_IMAGE_COUNT = 504;

package/dist/seed/_helpers/franchise-rows.d.ts

@@ -0,0 +1,43 @@
+import type { CategoryDocument } from "../../features/categories/schemas";
+export interface FranchiseSeedInput {
+    /** Without the `franchise-` prefix. Products match on this, never the name. */
+    slug: string;
+    name: string;
+    description: string;
+    /** Live only when real stock exists — see the dead-facet rule above. */
+    active: boolean;
+    featured?: boolean;
+    keywords: string[];
+    seoDescription: string;
+}
+export declare function franchiseRow(input: FranchiseSeedInput, order: number, stamps: {
+    createdBy: string;
+    createdAt: Date;
+    updatedAt: Date;
+}): Partial<CategoryDocument>;
+export declare function buildFranchiseRows(stamps: {
+    createdBy: string;
+    createdAt: Date;
+    updatedAt: Date;
+}): Partial<CategoryDocument>[];
+export declare const FRANCHISE_ROW_COUNT: number;
+/** The slugs a product's `franchiseSlug` may point at. */
+export declare const FRANCHISE_SLUGS: readonly string[];
+/**
+ * Category ROOT -> the franchise everything beneath it belongs to.
+ *
+ * Derived rather than stamped per product: a product already carries its full
+ * ancestor chain, so the root is free and cannot drift from the taxonomy the
+ * way a hand-written field would (Root Cause #42).
+ *
+ * 🛑 Deliberately PARTIAL. `category-living-collectibles` is absent because a
+ * juniper bonsai and a leucistic axolotl are not from an IP — they are living
+ * things. Mapping every root for completeness' sake would assert a franchise
+ * that does not exist, and "no franchise" is the correct answer for 4 of the
+ * 1,308 seeded products. A root with no entry yields no franchise, not a
+ * fallback.
+ */
+export declare const FRANCHISE_BY_CATEGORY_ROOT: Readonly<Record<string, {
+    slug: string;
+    name: string;
+}>>;

package/dist/seed/_helpers/franchise-rows.js

@@ -0,0 +1,181 @@
+/*
+ * WHY: a product's BRAND is who made it (Takara-Tomy); its FRANCHISE is what
+ *      it is from (Beyblade). The site had no way to express the second, while
+ *      `CharacterHotspot` shipped eighteen `/franchise/*` links to a route that
+ *      did not exist. This is that unit, modelled on brands per the explicit
+ *      instruction — "like brands make franchise its own separate unit".
+ *
+ * WHAT: one factory plus eight declarations.
+ *
+ * EXPORTS:
+ *   FRANCHISE_ROWS       — Partial<CategoryDocument>[], categoryType:"franchise"
+ *   FRANCHISE_ROW_COUNT  — asserted by the seed so a silent drop is loud
+ *
+ * ── 🛑 THE DEAD-FACET RULE, AND HOW THESE OBEY IT ─────────────────────────
+ *
+ * `brand-rows.ts` trap 3 states it exactly: *"A brand row with no product is a
+ * DEAD FACET, and worse than absent — it renders as a card in the grid that
+ * opens an empty page."* Seven of the eight rows below have no stock today,
+ * because this catalogue sells Beyblade.
+ *
+ * So they are seeded **`isActive: false`**. That is not a soft delete — the row
+ * exists, it is editable in the admin category editor, its page resolves, and
+ * `/franchise/marvel` stops being a 404. It is excluded from the grid and from
+ * search until it has something to sell, at which point one flag flips.
+ *
+ * The alternative readings were both worse: omitting them leaves eighteen links
+ * broken, and seeding them active puts seven empty shopfronts on a live grid.
+ *
+ * 🛑 `isActive` is therefore load-bearing here, not boilerplate. A future
+ * franchise row should be `false` until a product carries its `franchiseSlug`.
+ *
+ * ── Why tier-0 and outside the forest ─────────────────────────────────────
+ *
+ * Same as brands: `position` is NOT set, because these live outside the
+ * category forest's DFS numbering and a position inside it would corrupt the
+ * ranges `onCategoryWrite` shifts on insert.
+ *
+ * @tag domain:categories
+ * @tag layer:seed
+ * @tag pattern:shared-literal
+ * @tag access:server-only
+ * @tag consumers:seed/categories-seed-data.ts
+ * @tag sideEffects:none
+ */
+/* 🛑 `constants/field-names`, NOT the schema copy — there are two
+ * `CATEGORY_FIELDS` and only this one carries `CATEGORY_TYPE_VALUES`.
+ * `categories-seed-data.ts` imports this one; matching it is what keeps the
+ * discriminator a single spelling. Same reasoning as `brand-rows.ts`. */
+import { CATEGORY_FIELDS } from "../../constants/field-names.js";
+import { seedPhoto } from "./media.js";
+export function franchiseRow(input, order, stamps) {
+    const id = `franchise-${input.slug}`;
+    return {
+        id,
+        slug: id,
+        name: input.name,
+        categoryType: CATEGORY_FIELDS.CATEGORY_TYPE_VALUES.FRANCHISE,
+        description: input.description,
+        rootId: id,
+        parentIds: [],
+        childrenIds: [],
+        ancestors: [],
+        tier: 0,
+        path: id,
+        isLeaf: true,
+        order,
+        /* `icon` deliberately unset — the brands grid reads `display.icon` first
+         * and an emoji there would beat a real cover image (brand-rows trap 2). */
+        display: {
+            coverImage: seedPhoto(`franchise-cover-${input.slug}-20261014`, 800, 800),
+            showInMenu: false,
+            showInFooter: false,
+        },
+        isFeatured: input.featured ?? false,
+        isActive: input.active,
+        isSearchable: input.active,
+        createdBy: stamps.createdBy,
+        createdAt: stamps.createdAt,
+        updatedAt: stamps.updatedAt,
+        seo: {
+            title: `${input.name} | LetItRip`,
+            description: input.seoDescription,
+            keywords: input.keywords,
+        },
+    };
+}
+/*
+ * The eight. Beyblade is the catalogue; the other seven are the IPs
+ * `CharacterHotspot` already links to, seeded inactive so those links resolve
+ * without advertising an empty shop.
+ */
+const INPUTS = [
+    {
+        slug: "beyblade",
+        name: "Beyblade",
+        description: "The spinning-top battling franchise — every generation from the original Spin Gear tops through Metal Fight, Burst and Beyblade X. Complete tops, loose parts, stadiums and accessories.",
+        active: true,
+        featured: true,
+        keywords: ["beyblade", "spinning tops", "burst", "metal fight", "beyblade x"],
+        seoDescription: "Shop Beyblade across every generation — tops, parts, stadiums and spares, new and pre-owned.",
+    },
+    {
+        slug: "marvel",
+        name: "Marvel",
+        description: "Figures, collectibles and merchandise from the Marvel universe.",
+        active: false,
+        keywords: ["marvel", "comics", "superhero", "figures"],
+        seoDescription: "Marvel collectibles and figures.",
+    },
+    {
+        slug: "dc-comics",
+        name: "DC Comics",
+        description: "Figures, collectibles and merchandise from the DC universe.",
+        active: false,
+        keywords: ["dc", "dc comics", "superhero", "figures"],
+        seoDescription: "DC Comics collectibles and figures.",
+    },
+    {
+        slug: "dragon-ball",
+        name: "Dragon Ball",
+        description: "Figures and collectibles from the Dragon Ball series.",
+        active: false,
+        keywords: ["dragon ball", "anime", "figures", "shonen"],
+        seoDescription: "Dragon Ball collectibles and figures.",
+    },
+    {
+        slug: "naruto",
+        name: "Naruto",
+        description: "Figures and collectibles from the Naruto series.",
+        active: false,
+        keywords: ["naruto", "anime", "figures", "shonen"],
+        seoDescription: "Naruto collectibles and figures.",
+    },
+    {
+        slug: "bleach",
+        name: "Bleach",
+        description: "Figures and collectibles from the Bleach series.",
+        active: false,
+        keywords: ["bleach", "anime", "figures", "shonen"],
+        seoDescription: "Bleach collectibles and figures.",
+    },
+    {
+        slug: "one-piece",
+        name: "One Piece",
+        description: "Figures and collectibles from the One Piece series.",
+        active: false,
+        keywords: ["one piece", "anime", "figures", "shonen"],
+        seoDescription: "One Piece collectibles and figures.",
+    },
+    {
+        slug: "one-punch-man",
+        name: "One Punch Man",
+        description: "Figures and collectibles from the One Punch Man series.",
+        active: false,
+        keywords: ["one punch man", "anime", "figures"],
+        seoDescription: "One Punch Man collectibles and figures.",
+    },
+];
+export function buildFranchiseRows(stamps) {
+    return INPUTS.map((input, i) => franchiseRow(input, i + 1, stamps));
+}
+export const FRANCHISE_ROW_COUNT = INPUTS.length;
+/** The slugs a product's `franchiseSlug` may point at. */
+export const FRANCHISE_SLUGS = INPUTS.map((i) => `franchise-${i.slug}`);
+/**
+ * Category ROOT -> the franchise everything beneath it belongs to.
+ *
+ * Derived rather than stamped per product: a product already carries its full
+ * ancestor chain, so the root is free and cannot drift from the taxonomy the
+ * way a hand-written field would (Root Cause #42).
+ *
+ * 🛑 Deliberately PARTIAL. `category-living-collectibles` is absent because a
+ * juniper bonsai and a leucistic axolotl are not from an IP — they are living
+ * things. Mapping every root for completeness' sake would assert a franchise
+ * that does not exist, and "no franchise" is the correct answer for 4 of the
+ * 1,308 seeded products. A root with no entry yields no franchise, not a
+ * fallback.
+ */
+export const FRANCHISE_BY_CATEGORY_ROOT = {
+    "category-spinning-tops": { slug: "franchise-beyblade", name: "Beyblade" },
+};

package/dist/seed/_helpers/part-colours-generated.d.ts

@@ -0,0 +1,18 @@
+/**
+ * GENERATED by scripts/derive-part-colours.mjs — do not edit by hand.
+ *
+ * Part glossary id -> the dominant colour MEASURED from that part's cached
+ * reference photograph. Not invented: the pixels are the evidence.
+ *
+ * 🛑 The wiki exposes ONE photo per part, so for a part released in several
+ * models this is the colour of the photographed release — exact for that one,
+ * indicative for the others. The MODEL half of a colourway is always exact
+ * (it comes from `usedBy`); this half carries that caveat. Replacing these
+ * with real per-release photography is the intended fix.
+ *
+ * White is excluded before counting, because the fetcher flattens transparent
+ * PNGs onto white and a naive dominant-colour read returns White for almost
+ * everything.
+ */
+export declare const GENERATED_PART_COLOURS: Readonly<Record<string, string>>;
+export declare const GENERATED_PART_COLOUR_COUNT = 254;