@mohasinac/appkit 4.42.18 → 4.44.0

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

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

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

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

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

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

package/dist/seed/_helpers/media.d.ts

@@ -17,4 +17,4 @@ export declare function seedPhotoLabel(seed: string): string;
  * `appkit-seed` invocation, so anything non-stable here would give the same
  * fixture a different URL on every run.
  */
-export declare function seedPhoto(seed: string, width: number, height: number): string;
+export declare function seedPhoto(seed: string, _width?: number, _height?: number): string;

package/dist/seed/_helpers/media.js

@@ -47,16 +47,49 @@ export function seedExtMedia(url) {
  * photography for a demo catalogue: every card now says what it is, and nobody
  * can mistake seeded data for real inventory.
  */
-/** The one place a seed image host is named. Changing it is a one-line edit. */
-const SEED_PHOTO_HOST = "https://placehold.co";
+/*
+ * 🛑 SUPERSEDED 2026-10-09 — seed photography is now LOCAL and costs nothing.
+ *
+ * The reasoning above is still correct about third-party fragility, and the
+ * one-line-to-move property is still the goal. What it missed is the cost: every
+ * one of these URLs was persisted as `/api/media/ext?url=…`, so every render of
+ * every card was a Node lambda doing a third-party fetch (up to 2 × 4 s) plus a
+ * full sharp decode/watermark/encode — ONE INVOCATION PER IMAGE. The homepage
+ * alone referenced 160 of them at ~49.5 KB; `52.52 GB of origin transfer ÷
+ * 49.5 KB ≈ 1.06 M` proxy responses in a week, which suspended the project
+ * (HTTP 402).
+ *
+ * A placeholder is synthetic by definition, so there was never anything to
+ * fetch. Six static tiles ship in `public/images/seed-tiles/`, chosen by the
+ * same deterministic hash, and the homepage goes 160 images → 6.
+ *
+ * The trade accepted: the tile no longer renders the item's NAME. That text was
+ * a genuine gain and it is lost here — but it cost a function invocation per
+ * card to render text the card already displays beside the image, and `alt` still
+ * carries it for assistive tech. `seedPhotoLabel` is kept and still exported for
+ * exactly that use.
+ *
+ * 🛑 Do NOT reintroduce a third-party host here, and do NOT encode width/height
+ * into the path — a per-size URL is a per-size CDN cache key, which is how 6
+ * files become 400 again. `audit-media-proxy-hosts` blocks the first; this
+ * comment is the only thing guarding the second.
+ */
+const SEED_TILE_PREFIX = "/images/seed-tiles/";
 /**
  * Muted backgrounds, all dark enough for the same light foreground.
  *
- * Raw hex rather than theme tokens because these are baked into a URL that a
- * third party renders — no stylesheet and no CSS custom property is in scope.
+ * Raw hex rather than theme tokens because an SVG served as the body of an
+ * `<img>` has no stylesheet and no `var(--appkit-color-*)` in scope — the same
+ * reason `_placeholder.ts` keeps its artwork in an asset file.
+ *
+ * 🛑 These six values ARE the filenames in `public/images/seed-tiles/`, and they
+ * are mirrored a third time in `PLACEHOLDER_MEDIA_HOSTS`' sibling
+ * `SEED_TILE_COLOURS` (`appkit/src/utils/media-url.ts`), which maps a legacy
+ * stored `placehold.co` URL back to the same tile. Add a colour and all three
+ * must move together; a missing one degrades to a deterministic fallback tile
+ * rather than a broken image, so the failure mode is "less variety", never a 404.
  */
 const SEED_PHOTO_COLOURS = ["1e293b", "334155", "3f3f46", "44403c", "312e81", "164e63"];
-const SEED_PHOTO_FG = "f8fafc";
 /** Deterministic 32-bit hash. Same seed, same colour, every reseed. */
 function seedHash(input) {
     let h = 2166136261;
@@ -95,8 +128,11 @@ export function seedPhotoLabel(seed) {
  * `appkit-seed` invocation, so anything non-stable here would give the same
  * fixture a different URL on every run.
  */
-export function seedPhoto(seed, width, height) {
+export function seedPhoto(seed, _width, _height) {
     const bg = SEED_PHOTO_COLOURS[seedHash(seed) % SEED_PHOTO_COLOURS.length];
-    const text = encodeURIComponent(seedPhotoLabel(seed));
-    return seedExtMedia(`${SEED_PHOTO_HOST}/${width}x${height}/${bg}/${SEED_PHOTO_FG}/png?text=${text}`);
+    // Width/height are accepted and ignored. All 366 call sites pass them, and the
+    // tiles carry `preserveAspectRatio="xMidYMid slice"` so one file fits every
+    // aspect — baking the dimensions into the path would mint a separate cache
+    // entry per size, which is the thing this change removes.
+    return `${SEED_TILE_PREFIX}${bg}.svg`;
 }

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

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

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

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