@mohasinac/appkit 4.58.0 → 4.59.0

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

@@ -1,27 +0,0 @@
-import type { CategoryDocument } from "../../features/categories/schemas";
-/** The authoring shape — only the fields a human should have to write. */
-export interface CategoryTreeNode {
-    /** Doc id AND slug; they are always equal for categories (`id === slug`). */
-    id: string;
-    name: string;
-    description: string;
-    /** Per-row extras: display, seo, highlights, faqs, isFeatured, … */
-    extra?: Partial<CategoryDocument>;
-    children?: CategoryTreeNode[];
-}
-export interface BuildCategoryTreeOptions {
-    createdBy: string;
-    createdAt: Date;
-    updatedAt: Date;
-    /** Applied to every row unless the node's own `extra` overrides it. */
-    defaults?: Partial<CategoryDocument>;
-}
-/**
- * Flatten a forest of nested nodes into seed rows with every structural field
- * computed.
- *
- * Traversal is DFS pre-order, and `position` is a single counter running across
- * ALL roots — the numbering is global to the collection, not per-tree, which is
- * what `onCategoryWrite`'s range shifting assumes.
- */
-export declare function buildCategoryTree(roots: CategoryTreeNode[], opts: BuildCategoryTreeOptions): Partial<CategoryDocument>[];

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

@@ -1,119 +0,0 @@
-/*
- * WHY: `CategoryDocument` requires nine interlocking structural fields on every
- *      row — rootId, parentIds (the FULL ancestor chain), childrenIds, tier,
- *      path, isLeaf, ancestors, position and subtreeSize. Hand-writing those
- *      across a real tree guarantees mistakes, and the seed already had them:
- *      the old root claimed `subtreeSize: 4` at `position: 0` while all four of
- *      its children ALSO sat at positions 0-3, which is not a valid DFS
- *      pre-order numbering.
- * WHAT: Declare the tree once as a nested literal; derive every structural
- *       field from it. Purely deterministic — no Math.random, no Date.now — so
- *       reseeding is idempotent (Root Cause #25).
- *
- * EXPORTS:
- *   CategoryTreeNode  — the authoring shape (id/name/... plus `children`)
- *   buildCategoryTree — nested literal -> flat Partial<CategoryDocument>[]
- *
- * `position`/`subtreeSize` are DFS pre-order coordinates: a node's subtree
- * occupies exactly `[position, position + subtreeSize - 1]`, which is what lets
- * `onCategoryWrite` shift ranges on insert/delete. Seeding them correctly means
- * that Function has nothing to repair on first write.
- *
- * @tag domain:categories
- * @tag layer:seed
- * @tag pattern:derived
- * @tag access:server-only
- * @tag consumers:seed/categories-seed-data.ts
- * @tag sideEffects:none
- */
-/**
- * Flatten a forest of nested nodes into seed rows with every structural field
- * computed.
- *
- * Traversal is DFS pre-order, and `position` is a single counter running across
- * ALL roots — the numbering is global to the collection, not per-tree, which is
- * what `onCategoryWrite`'s range shifting assumes.
- */
-export function buildCategoryTree(roots, opts) {
-    const rows = [];
-    /*
-     * 🛑 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) {
-        const myPosition = position++;
-        // The slug segment is the id minus its `category-` prefix, so
-        // `spinning-tops/beyblade-burst/burst-parts` reads as a real path.
-        const segment = node.id.replace(/^category-/, "");
-        const path = parentPath ? `${parentPath}/${segment}` : segment;
-        const children = node.children ?? [];
-        // `seo` and `display` are REQUIRED on CategoryDocument, so synthesise
-        // sensible ones rather than make every row hand-write a block. A node that
-        // wants a real icon/cover/keywords overrides via `extra`, which is spread
-        // last.
-        const seo = {
-            title: `${node.name} | LetItRip`,
-            description: node.description,
-            keywords: node.name.toLowerCase().split(/\s+/).filter(Boolean),
-        };
-        const display = {
-            // Deeper rows are navigational, not menu-worthy: showing all four tiers
-            // in the header menu would drown it.
-            showInMenu: tier <= 1,
-            showInFooter: false,
-        };
-        const row = {
-            ...opts.defaults,
-            seo,
-            display,
-            id: node.id,
-            slug: node.id,
-            name: node.name,
-            description: node.description,
-            rootId,
-            parentIds: ancestors.map((a) => a.id),
-            childrenIds: children.map((c) => c.id),
-            ancestors: ancestors.map((a) => ({ ...a })),
-            tier,
-            path,
-            order,
-            isLeaf: children.length === 0,
-            position: myPosition,
-            createdBy: opts.createdBy,
-            createdAt: opts.createdAt,
-            updatedAt: opts.updatedAt,
-            ...node.extra,
-        };
-        rows.push(row);
-        const nextAncestors = [
-            ...ancestors,
-            { id: node.id, name: node.name, tier },
-        ];
-        let descendants = 0;
-        children.forEach((child, index) => {
-            descendants += visit(child, rootId, nextAncestors, tier + 1, path, index + 1);
-        });
-        // A node's subtree spans itself plus everything beneath it.
-        row.subtreeSize = descendants + 1;
-        return row.subtreeSize;
-    }
-    for (const [index, root] of roots.entries()) {
-        visit(root, root.id, [], 0, "", index + 1);
-    }
-    return rows;
-}

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

@@ -1,10 +0,0 @@
-/** 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 = 95;

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

@@ -1,120 +0,0 @@
-/*
- * 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: 8 },
-    { slug: "blader-shu-kurenai", name: "Shu Kurenai", 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-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-rago", name: "Rago", 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-burn-fujiwara", name: "Burn Fujiwara", 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-fubuki-sumiye", name: "Fubuki Sumiye", 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-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 = 95;

package/dist/seed/_helpers/final-sale-fixtures.d.ts

@@ -1,35 +0,0 @@
-import type { ProductDocument } from "../../features/products/schemas";
-/**
- * Seeded listings that explicitly ACCEPT change-of-mind returns.
- *
- * `finalSale` is absent on every other fixture, and absent means final sale —
- * so the default path is exercised by the bulk of the catalogue exactly as it
- * will be in production, where the field did not exist until now and no
- * pre-existing document carries it.
- *
- * One per listing type, deliberately. The "Final Sale" badge and the refund
- * gate both branch on this, and a badge that renders identically on every row
- * proves nothing: without at least one opted-out fixture per type there is no
- * way to tell "the predicate works" from "the predicate returns a constant".
- * That is the same reason the availability work seeded one unavailable row per
- * type rather than trusting the shared checks.
- *
- * Ids are listed rather than a `finalSale: false` written inline at each
- * record because the records live in nine files with five different export
- * wrappers, and a per-record edit is invisible to review — this set can be
- * read in one glance and cross-checked against the badge.
- */
-export declare const RETURNABLE_FIXTURE_IDS: ReadonlySet<string>;
-/**
- * Set `finalSale: false` on the opted-out fixtures and leave it ABSENT on
- * every other record.
- *
- * Absent rather than `finalSale: true`, on purpose: writing the default
- * explicitly would mean the seed never produces the shape that production data
- * actually has, so `isFinalSale`'s handling of `undefined` — the only part of
- * it that can be got wrong — would go untested by the entire fixture set.
- *
- * Pure and deterministic, so it does not reintroduce the `appkit-seed`
- * idempotency problem of Root Cause #25.
- */
-export declare function withFinalSale(p: Partial<ProductDocument>): Partial<ProductDocument>;

package/dist/seed/_helpers/final-sale-fixtures.js

@@ -1,61 +0,0 @@
-/**
- * Seeded listings that explicitly ACCEPT change-of-mind returns.
- *
- * `finalSale` is absent on every other fixture, and absent means final sale —
- * so the default path is exercised by the bulk of the catalogue exactly as it
- * will be in production, where the field did not exist until now and no
- * pre-existing document carries it.
- *
- * One per listing type, deliberately. The "Final Sale" badge and the refund
- * gate both branch on this, and a badge that renders identically on every row
- * proves nothing: without at least one opted-out fixture per type there is no
- * way to tell "the predicate works" from "the predicate returns a constant".
- * That is the same reason the availability work seeded one unavailable row per
- * type rather than trusting the shared checks.
- *
- * Ids are listed rather than a `finalSale: false` written inline at each
- * record because the records live in nine files with five different export
- * wrappers, and a per-record edit is invisible to review — this set can be
- * read in one glance and cross-checked against the badge.
- */
-export const RETURNABLE_FIXTURE_IDS = new Set([
-    // standard
-    "product-beyblade-burst-valkyrie",
-    // auction
-    "auction-beyblade-x-shark-edge",
-    // pre-order
-    "preorder-beyblade-x-bx-09-glide-ring",
-    // prize-draw
-    "prizedraw-beyblade-scheduled-demo",
-    // classified
-    "classified-beyblade-x-starter-pune",
-    // digital-code
-    "digitalcode-beyblade-x-app-legendary-pack",
-    // live
-    "live-bonsai-juniper-10yr",
-    // art
-    "art-valkyrie-holographic-print",
-    // stickers
-    "sticker-beyblade-x-holographic-pack",
-]);
-/**
- * Set `finalSale: false` on the opted-out fixtures and leave it ABSENT on
- * every other record.
- *
- * Absent rather than `finalSale: true`, on purpose: writing the default
- * explicitly would mean the seed never produces the shape that production data
- * actually has, so `isFinalSale`'s handling of `undefined` — the only part of
- * it that can be got wrong — would go untested by the entire fixture set.
- *
- * Pure and deterministic, so it does not reintroduce the `appkit-seed`
- * idempotency problem of Root Cause #25.
- */
-export function withFinalSale(p) {
-    // Spread FIRST so a record that sets `finalSale` itself keeps its own value;
-    // this helper only fills in the opt-outs it owns.
-    const next = { ...p };
-    if (typeof next.finalSale === "undefined" && next.id && RETURNABLE_FIXTURE_IDS.has(next.id)) {
-        next.finalSale = false;
-    }
-    return next;
-}

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

@@ -1,43 +0,0 @@
-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

@@ -1,189 +0,0 @@
-/*
- * 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,
-        /*
-         * A placeholder tile that a real wordmark OVERRIDES — same rule as
-         * `brand-rows.ts`: `withGeneratedCoverImage` treats a `/images/seed-tiles/`
-         * path as a default rather than a hand-authored decision. Only
-         * `franchise-beyblade` resolves a real one today; the other seven are the
-         * inactive dead-facet rows and keep the tile.
-         *
-         * `icon` stays 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" },
-};