@mohasinac/appkit 4.52.5 → 4.53.1

package/dist/security/settings-encryption.js

@@ -71,6 +71,97 @@ export function decryptSecret(encrypted) {
 export function isSecretEncrypted(value) {
     return encEnvelopeKind(value) === "settings";
 }
+/*
+ * ---------------------------------------------------------------------------
+ * Binary envelope — for FILE BYTES, not strings.
+ * ---------------------------------------------------------------------------
+ *
+ * Same algorithm, same key, same `enc:v1:` marker as the string form above, but
+ * a BINARY layout rather than a dot-joined base64 triple:
+ *
+ *   "enc:v1:" (7 ASCII bytes) || iv (12) || authTag (16) || ciphertext
+ *
+ * 🛑 Why not reuse `encryptSecret` with a base64 string. Two reasons, and the
+ * first one is a hard ceiling rather than a preference:
+ *
+ *   1. Base64 inflates by 4/3, so the 680 KB Udyam certificate becomes ~907 KB
+ *      of string before the envelope is added. A Firestore document is capped
+ *      at 1 MiB, so that approach is one slightly-larger PDF away from an
+ *      unrecoverable write failure — and it fails at UPLOAD time, after the
+ *      user has handed over the document.
+ *   2. The bytes belong in Storage regardless, and Storage takes a Buffer. Round
+ *      -tripping them through base64 to satisfy a string API costs 33% of the
+ *      object size and every byte of it is paid again on download.
+ *
+ * So: metadata in Firestore, ciphertext in Storage. These two functions are the
+ * seam between them.
+ */
+/** ASCII `enc:v1:` — the same marker the string envelope uses, as raw bytes. */
+const BINARY_PREFIX = Buffer.from(PREFIX, "ascii");
+const TAG_BYTES = 16;
+/**
+ * AES-256-GCM a file's bytes under `SETTINGS_ENCRYPTION_KEY`.
+ *
+ * Throws when the key is unset — deliberately, and identically to
+ * `encryptSecret`. A document store that silently writes plaintext when
+ * misconfigured is worse than one that refuses, because nothing downstream can
+ * tell the two apart afterwards.
+ */
+export function encryptBuffer(plaintext) {
+    const key = getMasterKey();
+    const { randomBytes, createCipheriv } = nodeCrypto();
+    const iv = randomBytes(IV_BYTES);
+    const cipher = createCipheriv(ALGORITHM, key, iv);
+    const ciphertext = Buffer.concat([cipher.update(plaintext), cipher.final()]);
+    return Buffer.concat([BINARY_PREFIX, iv, cipher.getAuthTag(), ciphertext]);
+}
+/**
+ * Reverse `encryptBuffer`.
+ *
+ * 🛑 Unlike `decryptSecret`, a buffer with no `enc:v1:` prefix is REJECTED
+ * rather than passed through. That asymmetry is intentional. `decryptSecret`
+ * tolerates plaintext because the settings collection genuinely holds
+ * unencrypted placeholders that predate encryption, so passing them through is
+ * the migration path. Here there is no such legacy: every object this reads was
+ * written by `encryptBuffer`, so an unprefixed buffer means the wrong object,
+ * a truncated download, or an upload that bypassed encryption — and returning
+ * it verbatim would serve one of those to an admin as though it were fine.
+ *
+ * GCM authentication also means `final()` throws on any tampering or on the
+ * wrong key, so a corrupted object fails loudly instead of yielding garbage.
+ */
+export function decryptBuffer(encrypted) {
+    if (!isBufferEncrypted(encrypted)) {
+        // Interpolates PREFIX rather than writing "enc:v1:" a second time —
+        // audit-pii-crypto's ENC_PREFIX_REDECLARED rule exists because two
+        // independent copies of that literal are how two incompatible formats
+        // came to look identical to every "is this encrypted" check.
+        throw new Error(`Buffer is not settings-encrypted — expected a '${PREFIX}' binary envelope`);
+    }
+    const ivStart = BINARY_PREFIX.length;
+    const tagStart = ivStart + IV_BYTES;
+    const dataStart = tagStart + TAG_BYTES;
+    const { createDecipheriv } = nodeCrypto();
+    const decipher = createDecipheriv(ALGORITHM, getMasterKey(), encrypted.subarray(ivStart, tagStart));
+    decipher.setAuthTag(encrypted.subarray(tagStart, dataStart));
+    return Buffer.concat([
+        decipher.update(encrypted.subarray(dataStart)),
+        decipher.final(),
+    ]);
+}
+/**
+ * True when `buf` carries the binary envelope AND is long enough to hold a
+ * complete one.
+ *
+ * The length check is not pedantry: without it a 7-byte buffer containing only
+ * the prefix passes, and `decryptBuffer` then hands `createDecipheriv` a
+ * zero-length IV, which throws `Invalid initialization vector` — an error that
+ * describes the crypto call rather than the truncated download that caused it.
+ */
+export function isBufferEncrypted(buf) {
+    return (buf.length > BINARY_PREFIX.length + IV_BYTES + TAG_BYTES &&
+        buf.subarray(0, BINARY_PREFIX.length).equals(BINARY_PREFIX));
+}
 export function maskSecret(value) {
     if (!value || value.length < 12) {
         return "****";

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

@@ -34,23 +34,33 @@
  *    never attributes a product code to Tomy alone). Every row below is one
  *    B6 can put at least one real product behind.
  *
- * ## 🛑 Why these are seedPhoto tiles and not 28 committed logo SVGs
+ * ## 🛑 Real logos, decided 2026-10-20 — and what the earlier caution was right about
  *
- * The plan recommended committing `public/images/brands/<slug>.svg` to avoid
- * `seedExtMedia`, which persists an `/api/media/ext?url=…` into Firestore and
- * costs a lambda plus a third-party fetch plus a full sharp encode PER IMAGE
- * PER RENDER — Root Cause #104, the thing that took Fast Origin Transfer to
- * 52.52 GB against a 10 GB cap.
+ * This block used to argue for neutral `seedPhoto` tiles over real logos, on
+ * the grounds that 26 of these are marques we do not own and "shipping drawn
+ * approximations of their logos is trademark reproduction for commercial
+ * use… a licensed-asset task, not a seed task."
  *
- * That reasoning is right and the conclusion has moved, because `seedPhoto`
- * now resolves to one of six STATIC LOCAL SVG tiles served `immutable` from
- * `/images/`. It already has the property the recommendation was reaching for:
- * no proxy, no third-party fetch, no per-render cost.
+ * That call was reversed deliberately, not forgotten. Real wordmarks are now
+ * used to IDENTIFY the line a listing belongs to, which is nominative use, and
+ * the help pages carry an explicit fair-use and non-affiliation notice naming
+ * every marque. Provenance for each file is recorded per-image in
+ * `docs/research/taxonomy-images-2026-10/image-provenance.json`, so
+ * attribution is possible and a takedown is mechanical.
  *
- * And it avoids a question committing the files would raise — 26 of these are
- * marques we do not own, so shipping drawn approximations of their logos is
- * trademark reproduction for commercial use. A neutral tile is honest about
- * being a placeholder. Real logos are a licensed-asset task, not a seed task.
+ * 🛑 Two things the old reasoning got right and this did NOT change:
+ *
+ *   1. **Never `seedExtMedia`.** A persisted `/api/media/ext?url=…` costs a
+ *      lambda plus a third-party fetch plus a sharp encode PER RENDER — Root
+ *      Cause #104, which took Fast Origin Transfer to 52.52 GB against a
+ *      10 GB cap. These are fetched ONCE, stored in our own bucket, and
+ *      referenced as `/media/<slug>`.
+ *   2. **No drawn approximations.** Nothing here is an imitation of a logo we
+ *      traced; each is the actual wordmark, cited.
+ *
+ * Only three brands resolve an image today (Beyblade, Hasbro, Sonokong). The
+ * other 25 have no verified source yet and show no cover rather than a guessed
+ * one — see `knownGaps` in the manifest.
  *
  * @tag domain:categories
  * @tag layer:seed
@@ -96,6 +106,20 @@ export function brandRow(input, order, stamps) {
          * forest's DFS numbering, and giving them a position inside it would
          * corrupt the ranges `onCategoryWrite` shifts on insert.
          */
+        /*
+         * A placeholder tile, which a real logo now OVERRIDES rather than being
+         * blocked by — `withGeneratedCoverImage` treats a `/images/seed-tiles/`
+         * path as a default to improve on, not as a hand-authored decision
+         * (`isSeedPlaceholderImage`).
+         *
+         * 🛑 So keep it. Three brands resolve a real wordmark today (Beyblade,
+         * Hasbro, Sonokong) and override this; the other 25 have no verified
+         * source and fall back to the tile. Removing the line would give those 25
+         * an EMPTY grey box, because a brand row carries no `color` and no `icon`
+         * either — strictly worse than a neutral tile.
+         *
+         * `icon` stays unset — see trap 2. An emoji here would outrank the logo.
+         */
         display: {
             coverImage: seedPhoto(`brand-logo-${input.slug}-20260101`, 800, 800),
             showInMenu: false,

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

@@ -52,6 +52,24 @@ import { MODEL_LEAVES } from "./category-models.js";
 import { PART_LEAVES } from "./category-parts.js";
 import { BEY_TEMPLATES, COLLECTIBLE_TEMPLATES, PART_TEMPLATES, SEALED_TEMPLATES, accessoryDefaults, beyDefaults, diecastDefaults, figureDefaults, launcherDefaults, livingDefaults, marketBand, partDefaults, stadiumDefaults, tcgDefaults, ROOT_TAX_DEFAULTS, ROOT_AUTHENTICITY_DEFAULT, } from "./category-content.js";
 import { seedPhoto } from "./media.js";
+/**
+ * A synthetic placeholder tile, for a node with no real cover of its own.
+ *
+ * 🛑 This is a FALLBACK, not a decision — and that took a fix to become true.
+ * `withGeneratedCoverImage` used to skip any row with a non-empty
+ * `display.coverImage`, so a `cover(...)` here BLOCKED the generated map
+ * outright: a wordmark could be fetched, uploaded and mapped and the card
+ * would still show a grey tile, with nothing reporting why.
+ *
+ * It now ranks the three sources honestly — a real authored path beats a
+ * generated image beats a placeholder tile (`isSeedPlaceholderImage`) — so
+ * every node can keep a tile in source and simply be overridden when an image
+ * exists. Four roots are overridden today (the Beyblade generations); the rest
+ * render the tile, which is the right thing to show when there is nothing
+ * better and much better than the empty box they would get from no value.
+ *
+ * So adding artwork to a node is now a manifest entry ALONE — no edit here.
+ */
 const cover = (slug) => seedPhoto(`category-image-${slug}-20260101`, 1200, 600);
 /**
  * A tier-3 line that owns named-model leaves.
@@ -62,13 +80,28 @@ const cover = (slug) => seedPhoto(`category-image-${slug}-20260101`, 1200, 600);
  * empty line, never a crash — but a line that is MEANT to have models and
  * silently has none is the failure this cannot see, which is why the seed
  * asserts `MODEL_LEAF_COUNT` against what it actually spread.
+ *
+ * `opts.hasbroName` carries the regional-naming divergence for the waves that
+ * have one. Last and optional, so all 21 existing call sites are unchanged.
+ *
+ * 🛑 There is no `hasbroCoverImage` here on purpose. The name is an editorial
+ * FACT and belongs in source; the image is a resolved asset and belongs in the
+ * generated map, exactly like `display.coverImage` — see
+ * `GENERATED_CATEGORY_HASBRO_IMAGES` and `withGeneratedHasbroCover` in
+ * `categories-seed-data.ts`. Hard-coding a `/media/…` string here would put
+ * the one field that changes on every re-upload into the one file that should
+ * not have to be edited for it.
  */
-function line(id, name, description, defaults, templates) {
+function line(id, name, description, defaults, templates, opts) {
     return {
         id,
         name,
         description,
-        extra: { productDefaults: defaults, descriptionTemplates: templates },
+        extra: {
+            productDefaults: defaults,
+            descriptionTemplates: templates,
+            ...(opts?.hasbroName ? { hasbroName: opts.hasbroName } : {}),
+        },
         children: MODEL_LEAVES[id] ?? [],
     };
 }
@@ -234,12 +267,32 @@ const BEYBLADE_BURST = {
     },
     children: [
         branch("category-burst-tops", "Burst Tops", "Complete Burst-system Beyblades across every wave.", [
+            /*
+             * 🛑 `hasbroName` is set on exactly the five waves where a Hasbro season
+             * title demonstrably differs, each confirmed by BOTH logos existing in
+             * the wiki corpus (a Japanese-market logo and an English-market one for
+             * the same wave):
+             *
+             *   God        <-> Evolution    Beyblade_Burst_{God,Evolution}_Logo
+             *   Cho-Z      <-> Turbo        {Chouzetsu,Turbo_English}_Logo
+             *   GT         <-> Rise         {GT_Japanese,Rise_English}_Logo
+             *   Superking  <-> Surge        {Superking_Japanese,Surge_English}_Logo
+             *   Dynamite B <-> QuadDrive    {Dynamite_Battle_Japanese,QuadDrive_English}_Logo
+             *
+             * `burst-classic` is unset because season 1 shipped as "Beyblade Burst"
+             * in both markets — there is no divergence to show. `burst-bu` is unset
+             * because the corpus will not support one: it describes Burst Ultimate
+             * as a Takara-Tomy toyline concluding the series, and while Hasbro's
+             * QuadStrike is contemporaneous, no source we hold states they are the
+             * same line renamed. A guessed pairing on a page a buyer reads as fact
+             * is worse than a blank.
+             */
             line("category-burst-classic", "Burst Classic", "The original 2015–2017 single- and dual-layer waves, before any metal entered the Layer.", beyDefaults("category-burst-classic", "Beyblade Burst", "Burst System"), BEY_TEMPLATES),
-            line("category-burst-god", "Burst God", "The God Layer wave, which added spring-loaded Layers and the first real burst-resistance tuning.", beyDefaults("category-burst-god", "Beyblade Burst God", "God Layer System"), BEY_TEMPLATES),
-            line("category-burst-cho-z", "Cho-Z", "The metal-layer wave — heavier Layers and roughly double the burst resistance of what came before.", beyDefaults("category-burst-cho-z", "Beyblade Burst Cho-Z", "Cho-Z Layer System"), BEY_TEMPLATES),
-            line("category-burst-gt", "GT", "The Gatinko wave, with a swappable chip inside the Layer for a third tuning axis.", beyDefaults("category-burst-gt", "Beyblade Burst GT", "Gatinko Layer System"), BEY_TEMPLATES),
-            line("category-burst-superking", "Superking", "The Sparking / Superking wave and its five-sided ratchet, which changed launch dynamics entirely.", beyDefaults("category-burst-superking", "Beyblade Burst Superking", "Sparking Layer System"), BEY_TEMPLATES),
-            line("category-burst-db", "Dynamite Battle", "The DB wave — Armour Tips and the heaviest Layers Burst had shipped to that point.", beyDefaults("category-burst-db", "Beyblade Burst Dynamite Battle", "Dynamite Battle Layer System"), BEY_TEMPLATES),
+            line("category-burst-god", "Burst God", "The God Layer wave, which added spring-loaded Layers and the first real burst-resistance tuning.", beyDefaults("category-burst-god", "Beyblade Burst God", "God Layer System"), BEY_TEMPLATES, { hasbroName: "Beyblade Burst Evolution" }),
+            line("category-burst-cho-z", "Cho-Z", "The metal-layer wave — heavier Layers and roughly double the burst resistance of what came before.", beyDefaults("category-burst-cho-z", "Beyblade Burst Cho-Z", "Cho-Z Layer System"), BEY_TEMPLATES, { hasbroName: "Beyblade Burst Turbo" }),
+            line("category-burst-gt", "GT", "The Gatinko wave, with a swappable chip inside the Layer for a third tuning axis.", beyDefaults("category-burst-gt", "Beyblade Burst GT", "Gatinko Layer System"), BEY_TEMPLATES, { hasbroName: "Beyblade Burst Rise" }),
+            line("category-burst-superking", "Superking", "The Sparking / Superking wave and its five-sided ratchet, which changed launch dynamics entirely.", beyDefaults("category-burst-superking", "Beyblade Burst Superking", "Sparking Layer System"), BEY_TEMPLATES, { hasbroName: "Beyblade Burst Surge" }),
+            line("category-burst-db", "Dynamite Battle", "The DB wave — Armour Tips and the heaviest Layers Burst had shipped to that point.", beyDefaults("category-burst-db", "Beyblade Burst Dynamite Battle", "Dynamite Battle Layer System"), BEY_TEMPLATES, { hasbroName: "Beyblade Burst QuadDrive" }),
             line("category-burst-bu", "Burst Ultimate", "The final Burst wave, closing the line in 2023 before Beyblade X replaced it.", beyDefaults("category-burst-bu", "Beyblade Burst Ultimate", "Burst Ultimate Layer System"), BEY_TEMPLATES),
         ]),
         branch("category-burst-parts", "Burst Parts", "Layers, Discs, Drivers and the chips and armour that bolt onto them.", [
@@ -302,6 +355,19 @@ const BEYBLADE_X = {
             node("category-x-xtreme-stadiums", "Xtreme Stadiums", "X-format stadiums with the Xtreme Line rail — the feature the whole generation is designed around.", stadiumDefaults("category-x-xtreme-stadiums", "Beyblade X"), SEALED_TEMPLATES),
             node("category-x-standard-stadiums", "Standard X Stadiums", "Plain round X dishes without the rail, for casual play and practice.", stadiumDefaults("category-x-standard-stadiums", "Beyblade X"), SEALED_TEMPLATES),
         ]),
+        /*
+         * Added 2026-10-19 for the real CX-20 "Customize Set C" pre-order fixture.
+         * A Customize Set is its own retail concept, distinct from both a complete
+         * top (`category-x-tops`) and a single loose part (`category-x-parts`):
+         * it bundles one complete top with several loose Blades/Ratchets/Bits, so
+         * neither existing leaf is the right home. `partDefaults` is still the
+         * closer fit of the two existing helpers — the commercial character is
+         * "components for a custom build," which is what its FAQ templates
+         * (fit/compatibility, not authenticity) already speak to — and it carries
+         * `taxCodeId: TAX_TOY` (HSN 9503 0020, 5%), the same rate every other
+         * Beyblade/part/launcher/stadium in this catalogue already uses.
+         */
+        node("category-x-customize-sets", "Customize Sets", "CX-line Customize Sets — a complete top plus extra Blades, Ratchets and Bits for building several distinct combinations from one box.", partDefaults("category-x-customize-sets", "Customize Set"), PART_TEMPLATES),
     ],
 };
 /**

package/dist/seed/_helpers/category-images-generated.d.ts

@@ -7,9 +7,11 @@
  * 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.
+ * Covers model leaves, PART leaves and taxonomy BRANCH rows (generation roots
+ * and waves, retail lines, brand rows, franchise rows) — they share one id
+ * space (`category-*` / `brand-*` / `franchise-*`), so one map serves the
+ * category cover and, through `gen-catalogue-listings.mjs`, a 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
@@ -31,8 +33,25 @@
  * 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`.
+ * Source and licensing for every file — TWO manifests, because the leaves and
+ * the branches were fetched by different scripts from different sources:
+ *   `docs/research/bey-corpus-2026-10/image-provenance.json`      (model/part leaves)
+ *   `docs/research/taxonomy-images-2026-10/image-provenance.json` (branch wordmarks)
  */
 export declare const GENERATED_CATEGORY_IMAGES: Readonly<Record<string, string>>;
-export declare const GENERATED_CATEGORY_IMAGE_COUNT = 504;
+export declare const GENERATED_CATEGORY_IMAGE_COUNT = 554;
+/**
+ * The REGIONAL-VARIANT logo, keyed on the same category id.
+ *
+ * 🛑 A separate map rather than more entries in the one above, because this is
+ * a SECOND image for the SAME category — `category-burst-god` has both a
+ * Takara-Tomy "God" wordmark and a Hasbro "Evolution" one. Merging them would
+ * mean one silently overwriting the other, and the loser would be whichever
+ * the directory listing happened to reach second.
+ *
+ * Applied by `withGeneratedHasbroCover` to `hasbroCoverImage`, and rendered
+ * beside the "Also known as" name. Only populated for a category that also
+ * carries `hasbroName` — an image with no name to label it has nothing to say.
+ */
+export declare const GENERATED_CATEGORY_HASBRO_IMAGES: Readonly<Record<string, string>>;
+export declare const GENERATED_CATEGORY_HASBRO_IMAGE_COUNT = 5;

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

@@ -7,9 +7,11 @@
  * 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.
+ * Covers model leaves, PART leaves and taxonomy BRANCH rows (generation roots
+ * and waves, retail lines, brand rows, franchise rows) — they share one id
+ * space (`category-*` / `brand-*` / `franchise-*`), so one map serves the
+ * category cover and, through `gen-catalogue-listings.mjs`, a 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
@@ -31,8 +33,10 @@
  * 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`.
+ * Source and licensing for every file — TWO manifests, because the leaves and
+ * the branches were fetched by different scripts from different sources:
+ *   `docs/research/bey-corpus-2026-10/image-provenance.json`      (model/part leaves)
+ *   `docs/research/taxonomy-images-2026-10/image-provenance.json` (branch wordmarks)
  */
 export const GENERATED_CATEGORY_IMAGES = {
     "category-ace-dragon-sting-charge-zan": "/media/category-ace-dragon-sting-charge-zan-image",
@@ -165,6 +169,7 @@ export const GENERATED_CATEGORY_IMAGES = {
     "category-obelisk-odin-triple-xtreme": "/media/category-obelisk-odin-triple-xtreme-image",
     "category-phantom-fox-ms": "/media/category-phantom-fox-ms-image",
     "category-phantom-orion-b-d": "/media/category-phantom-orion-b-d-image",
+    "category-phoenixforce-whm-65mt": "/media/category-phoenixforce-whm-65mt-image",
     "category-poison-serpent-sw145sd": "/media/category-poison-serpent-sw145sd-image",
     "category-prominence-phoenix-tapered-metal-universe-10": "/media/category-prominence-phoenix-tapered-metal-universe-10-image",
     "category-proto-nemesis-ad145d": "/media/category-proto-nemesis-ad145d-image",
@@ -539,5 +544,75 @@ export const GENERATED_CATEGORY_IMAGES = {
     "category-ten-heavy": "/media/category-ten-heavy-image",
     "category-ten-wide": "/media/category-ten-wide-image",
     "category-wing-attacker": "/media/category-wing-attacker-image",
+    "brand-bandai": "/media/brand-bandai-image",
+    "brand-banpresto": "/media/brand-banpresto-image",
+    "brand-beyblade": "/media/brand-beyblade-image",
+    "brand-bushiroad": "/media/brand-bushiroad-image",
+    "brand-funskool": "/media/brand-funskool-image",
+    "brand-furyu": "/media/brand-furyu-image",
+    "brand-good-smile-company": "/media/brand-good-smile-company-image",
+    "brand-hasbro": "/media/brand-hasbro-image",
+    "brand-hot-wheels": "/media/brand-hot-wheels-image",
+    "brand-konami": "/media/brand-konami-image",
+    "brand-mattel": "/media/brand-mattel-image",
+    "brand-mcfarlane-toys": "/media/brand-mcfarlane-toys-image",
+    "brand-mezco": "/media/brand-mezco-image",
+    "brand-newboy": "/media/brand-newboy-image",
+    "brand-pokemon-company": "/media/brand-pokemon-company-image",
+    "brand-sonokong": "/media/brand-sonokong-image",
+    "brand-taito": "/media/brand-taito-image",
+    "brand-takara-tomy": "/media/brand-takara-tomy-image",
+    "brand-takara": "/media/brand-takara-image",
+    "brand-tamashii-nations": "/media/brand-tamashii-nations-image",
+    "brand-toy-biz": "/media/brand-toy-biz-image",
+    "brand-wizards-of-the-coast": "/media/brand-wizards-of-the-coast-image",
+    "category-beyblade-burst": "/media/category-beyblade-burst-image",
+    "category-beyblade-metal": "/media/category-beyblade-metal-image",
+    "category-beyblade-original": "/media/category-beyblade-original-image",
+    "category-beyblade-x": "/media/category-beyblade-x-image",
+    "category-burst-cho-z": "/media/category-burst-cho-z-image",
+    "category-burst-classic": "/media/category-burst-classic-image",
+    "category-burst-db": "/media/category-burst-db-image",
+    "category-burst-god": "/media/category-burst-god-image",
+    "category-burst-gt": "/media/category-burst-gt-image",
+    "category-burst-superking": "/media/category-burst-superking-image",
+    "category-metal-fury-4d": "/media/category-metal-fury-4d-image",
+    "category-metal-fusion": "/media/category-metal-fusion-image",
+    "category-metal-masters": "/media/category-metal-masters-image",
+    "category-metal-shogun-steel": "/media/category-metal-shogun-steel-image",
+    "category-original-engine-gear": "/media/category-original-engine-gear-image",
+    "category-original-magnacore": "/media/category-original-magnacore-image",
+    "category-x-basic": "/media/category-x-basic-image",
+    "category-x-custom-cx": "/media/category-x-custom-cx-image",
+    "category-x-unique-ux": "/media/category-x-unique-ux-image",
+    "franchise-beyblade": "/media/franchise-beyblade-image",
+    "franchise-bleach": "/media/franchise-bleach-image",
+    "franchise-dc-comics": "/media/franchise-dc-comics-image",
+    "franchise-dragon-ball": "/media/franchise-dragon-ball-image",
+    "franchise-marvel": "/media/franchise-marvel-image",
+    "franchise-naruto": "/media/franchise-naruto-image",
+    "franchise-one-piece": "/media/franchise-one-piece-image",
+    "franchise-one-punch-man": "/media/franchise-one-punch-man-image",
 };
-export const GENERATED_CATEGORY_IMAGE_COUNT = 504;
+export const GENERATED_CATEGORY_IMAGE_COUNT = 554;
+/**
+ * The REGIONAL-VARIANT logo, keyed on the same category id.
+ *
+ * 🛑 A separate map rather than more entries in the one above, because this is
+ * a SECOND image for the SAME category — `category-burst-god` has both a
+ * Takara-Tomy "God" wordmark and a Hasbro "Evolution" one. Merging them would
+ * mean one silently overwriting the other, and the loser would be whichever
+ * the directory listing happened to reach second.
+ *
+ * Applied by `withGeneratedHasbroCover` to `hasbroCoverImage`, and rendered
+ * beside the "Also known as" name. Only populated for a category that also
+ * carries `hasbroName` — an image with no name to label it has nothing to say.
+ */
+export const GENERATED_CATEGORY_HASBRO_IMAGES = {
+    "category-burst-cho-z": "/media/category-burst-cho-z-hasbro-image",
+    "category-burst-db": "/media/category-burst-db-hasbro-image",
+    "category-burst-god": "/media/category-burst-god-hasbro-image",
+    "category-burst-gt": "/media/category-burst-gt-hasbro-image",
+    "category-burst-superking": "/media/category-burst-superking-hasbro-image",
+};
+export const GENERATED_CATEGORY_HASBRO_IMAGE_COUNT = 5;

package/dist/seed/_helpers/category-models.d.ts

@@ -2,4 +2,4 @@ import type { CategoryTreeNode } from "./category-tree";
 /** Named-model leaves, keyed by the tier-3 line they belong to. */
 export declare const MODEL_LEAVES: Record<string, CategoryTreeNode[]>;
 /** Total named-model leaves — asserted by the seed so a silent drop is loud. */
-export declare const MODEL_LEAF_COUNT = 220;
+export declare const MODEL_LEAF_COUNT = 221;

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

@@ -1330,6 +1330,12 @@ export const MODEL_LEAVES = {
         },
     ],
     "category-x-custom-cx": [
+        {
+            id: "category-phoenixforce-whm-65mt",
+            name: "PhoenixForce WHM-65MT",
+            description: "PhoenixForce WHM-65MT — a Balance-type, right-spin Custom Line (CX) release, product code CX-20, released by TT Customize Set. Release note: Released only as part of the CX-20 Customize Set C. Complete tops, loose parts, sticker sheets and pre-owned examples of this model are listed here.",
+            extra: { aliases: ["CX-20", "PhoenixForce Weight Heavy M-65 Metal Taper", "Phoenix Force (manga, English)"], productDefaults: { defaultFeatures: ["feature-blader-burn-fujiwara", "feature-type-balance", "feature-right-spin"] } },
+        },
         {
             id: "category-valkyrievolt-s4-70v",
             name: "ValkyrieVolt S4-70V",
@@ -1385,4 +1391,4 @@ export const MODEL_LEAVES = {
     ],
 };
 /** Total named-model leaves — asserted by the seed so a silent drop is loud. */
-export const MODEL_LEAF_COUNT = 220;
+export const MODEL_LEAF_COUNT = 221;

package/dist/seed/_helpers/category-parts-glossary-map.js

@@ -15,6 +15,7 @@ export const PART_CATEGORY_TO_GLOSSARY_ID = {
     "category-00-00turn": "disc--00-00turn",
     "category-00-part-of-chassis": "disc--00-part-of-chassis",
     "category-1-60": "ratchet--1-60",
+    "category-1-70": "ratchet--1-70",
     "category-10": "disc--10",
     "category-100": "spin-track--100",
     "category-105": "spin-track--105",
@@ -58,6 +59,7 @@ export const PART_CATEGORY_TO_GLOSSARY_ID = {
     "category-6mobile-ring": "disc--6mobile-ring",
     "category-6vortex": "disc--6vortex",
     "category-8": "disc--8",
+    "category-8-80": "ratchet--8-80",
     "category-88": "spin-track--88",
     "category-8flow": "disc--8flow",
     "category-9": "ratchet--9",
@@ -416,6 +418,7 @@ export const PART_CATEGORY_TO_GLOSSARY_ID = {
     "category-hexa": "bit--hexa",
     "category-hf": "performance-tip--hf",
     "category-hf-s-hole-flat-sharp": "performance-tip--hf-s-hole-flat-sharp",
+    "category-high-needle": "bit--high-needle",
     "category-hit-release": "blade-base--hit-release",
     "category-hit-release-base": "blade-base--hit-release-base",
     "category-hit-release-draciel": "blade-base--hit-release-draciel",
@@ -442,6 +445,7 @@ export const PART_CATEGORY_TO_GLOSSARY_ID = {
     "category-karma": "disc--karma",
     "category-kerbecs-clear-wheel": "energy-ring--kerbecs-clear-wheel",
     "category-ketos-clear-wheel": "energy-ring--ketos-clear-wheel",
+    "category-kick": "bit--kick",
     "category-kick-3": "driver--kick-3",
     "category-killerken": "chrome-wheel--killerken",
     "category-king-kerbeus-k2": "layer--king-kerbeus-k2",
@@ -471,6 +475,8 @@ export const PART_CATEGORY_TO_GLOSSARY_ID = {
     "category-loop": "driver--loop",
     "category-lost-l-inor-l2": "layer--lost-l-inor-l2",
     "category-low": "performance-tip--low",
+    "category-low-orb": "bit--low-orb",
+    "category-low-rush": "bit--low-rush",
     "category-lw105": "spin-track--lw105",
     "category-lw160": "spin-track--lw160",
     "category-m145-gimmick-track": "spin-track--m145-gimmick-track",
@@ -628,6 +634,7 @@ export const PART_CATEGORY_TO_GLOSSARY_ID = {
     "category-sg-sharp": "blade-base--sg-sharp",
     "category-sg-sharp-base": "blade-base--sg-sharp-base",
     "category-sharkedge": "blade--sharkedge",
+    "category-sharkscale": "blade--sharkscale",
     "category-sharp-core": "running-core--sharp-core",
     "category-shield-hammer": "attack-ring--shield-hammer",
     "category-shooter-change-core": "running-core--shooter-change-core",
@@ -698,6 +705,7 @@ export const PART_CATEGORY_TO_GLOSSARY_ID = {
     "category-turtle-survivor": "attack-ring--turtle-survivor",
     "category-tyrannobeat": "blade--tyrannobeat",
     "category-ultimate-attacker": "attack-ring--ultimate-attacker",
+    "category-under-flat": "bit--under-flat",
     "category-unicornsting": "blade--unicornsting",
     "category-unite": "driver--unite",
     "category-unite-dash": "driver--unite-dash",

package/dist/seed/_helpers/category-parts.d.ts

@@ -6,4 +6,4 @@ export declare const PART_LEAVES: Record<string, CategoryTreeNode[]>;
  * SAME string by construction, so this map exists only to let a reader see that
  * stated rather than inferred.
  */
-export declare const PART_LEAF_COUNT = 752;
+export declare const PART_LEAF_COUNT = 760;

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

@@ -21,7 +21,7 @@
  * 🛑 The prose is ours, composed from facts (name, classification, printed
  *    code, weight, model count). No corpus sentence is reproduced.
  *
- * 752 parts -> 752 leaves across 20 part-type nodes.
+ * 760 parts -> 760 leaves across 20 part-type nodes.
  * 129 needed a classification-qualified slug because the bare name
  * collides across classifications; the rest keep the short URL.
  *
@@ -4280,12 +4280,36 @@ export const PART_LEAVES = {
             description: "Hexa — a bit (used by 1 model). Loose examples, spares and pre-owned bits of this part are listed here.",
             extra: { aliases: ["Hexa", "hexa"] },
         },
+        {
+            id: "category-high-needle",
+            name: "High Needle",
+            description: "High Needle — a bit. Loose examples, spares and pre-owned bits of this part are listed here.",
+            extra: { aliases: ["High Needle", "high-needle"] },
+        },
+        {
+            id: "category-kick",
+            name: "Kick",
+            description: "Kick — a bit. Loose examples, spares and pre-owned bits of this part are listed here.",
+            extra: { aliases: ["Kick", "kick"] },
+        },
         {
             id: "category-bit-lf",
             name: "LF",
             description: "LF — a bit (used by 2 models). Loose examples, spares and pre-owned bits of this part are listed here.",
             extra: { aliases: ["LF", "lf"] },
         },
+        {
+            id: "category-low-orb",
+            name: "Low Orb",
+            description: "Low Orb — a bit. Loose examples, spares and pre-owned bits of this part are listed here.",
+            extra: { aliases: ["Low Orb", "low-orb"] },
+        },
+        {
+            id: "category-low-rush",
+            name: "Low Rush",
+            description: "Low Rush — a bit. Loose examples, spares and pre-owned bits of this part are listed here.",
+            extra: { aliases: ["Low Rush", "low-rush"] },
+        },
         {
             id: "category-n",
             name: "N",
@@ -4346,6 +4370,12 @@ export const PART_LEAVES = {
             description: "Trans Point — a bit (used by 1 model). Loose examples, spares and pre-owned bits of this part are listed here.",
             extra: { aliases: ["Trans Point", "trans point"] },
         },
+        {
+            id: "category-under-flat",
+            name: "Under Flat",
+            description: "Under Flat — a bit. Loose examples, spares and pre-owned bits of this part are listed here.",
+            extra: { aliases: ["Under Flat", "under-flat"] },
+        },
         {
             id: "category-vortex",
             name: "Vortex",
@@ -4456,6 +4486,12 @@ export const PART_LEAVES = {
             description: "SharkEdge — a blade (used by 2 models). Loose examples, spares and pre-owned blades of this part are listed here.",
             extra: { aliases: ["SharkEdge", "sharkedge"] },
         },
+        {
+            id: "category-sharkscale",
+            name: "SharkScale",
+            description: "SharkScale — a blade. Loose examples, spares and pre-owned blades of this part are listed here.",
+            extra: { aliases: ["SharkScale", "sharkscale"] },
+        },
         {
             id: "category-silverwolf",
             name: "SilverWolf",
@@ -4512,6 +4548,12 @@ export const PART_LEAVES = {
             description: "1-60 — a ratchet (used by 1 model). Loose examples, spares and pre-owned ratchets of this part are listed here.",
             extra: { aliases: ["1-60"] },
         },
+        {
+            id: "category-1-70",
+            name: "1-70",
+            description: "1-70 — a ratchet. Loose examples, spares and pre-owned ratchets of this part are listed here.",
+            extra: { aliases: ["1-70"] },
+        },
         {
             id: "category-2",
             name: "2",
@@ -4572,6 +4614,12 @@ export const PART_LEAVES = {
             description: "5-80 — a ratchet (used by 1 model). Loose examples, spares and pre-owned ratchets of this part are listed here.",
             extra: { aliases: ["5-80"] },
         },
+        {
+            id: "category-8-80",
+            name: "8-80",
+            description: "8-80 — a ratchet. Loose examples, spares and pre-owned ratchets of this part are listed here.",
+            extra: { aliases: ["8-80"] },
+        },
         {
             id: "category-9",
             name: "9",
@@ -4591,4 +4639,4 @@ export const PART_LEAVES = {
  * SAME string by construction, so this map exists only to let a reader see that
  * stated rather than inferred.
  */
-export const PART_LEAF_COUNT = 752;
+export const PART_LEAF_COUNT = 760;