@mohasinac/appkit 4.58.0 → 4.59.0

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

@@ -1,67 +0,0 @@
-/**
- * Seed-time media URL helper.
- *
- * Wraps a 3rd-party image/video URL in the /api/media/ext proxy path so
- * seed data never persists raw upstream URLs. The proxy adds watermarking,
- * survives upstream rate-limits, and keeps CSP / image hosts under our
- * control.
- *
- * Companion runtime helper: `resolveMediaUrl()` in ../../utils/media-url.ts
- * — defends consumers that still see raw URLs (e.g. live Firestore reads
- * from older docs). Both produce the same `/api/media/ext?url=<encoded>`
- * shape for external https URLs.
- *
- * Idempotent: already-proxied URLs (`/media/...` or `/api/media/ext?url=...`)
- * pass through untouched, so wrapping a wrapped URL is safe.
- */
-import type { ProductImage } from "../../features/products/types";
-export declare function seedExtMedia(url: string): string;
-/**
- * Is this cover value a generated PLACEHOLDER rather than a real image?
- *
- * 🛑 Load-bearing for `withGeneratedCoverImage`, which otherwise treats any
- * non-empty `display.coverImage` as hand-authored and skips the row — so a
- * `seedPhoto(...)` tile BLOCKED every fetched wordmark, and a logo could be
- * downloaded, uploaded, mapped and still never appear.
- *
- * The distinction is the honest one: a tile is what the seed emits when it has
- * nothing better, so it is a default to be improved on. A real path (a
- * `/media/<slug>` or an admin upload) is a decision, and that still wins.
- */
-export declare function isSeedPlaceholderImage(value: string | undefined | null): boolean;
-/**
- * Turn a seed key into something a person would read.
- *
- * `art-image-dranzer-phoenix-2-20260817` → `Dranzer Phoenix`
- *
- * Strips the trailing `-YYYYMMDD` stamp, a trailing image index, and the
- * leading `<kind>-image-` prefix that every seed key carries — all of which are
- * bookkeeping, not the name of the thing.
- */
-export declare function seedPhotoLabel(seed: string): string;
-/**
- * A seed gallery as `ProductImage[]` — plan A6 changed
- * `ProductDocument.images` from `string[]` to `ProductImage[]`, and these
- * fixtures hold bare URLs.
- *
- * 🛑 Deliberately sets NO `alt`. The only string available at these call
- * sites is the product title, and "Dranzer S" repeated as the alt of all
- * three of its photos is the naive fill that screen-reader users correctly
- * treat as noise — worse than absent, because it claims to describe. The
- * GENERATED catalogue does emit real alt ("Chain Kerbeus — Aquilon-Q
- * (Disc)") because its join knows what each photo is OF; a hand-written
- * fixture does not, and should say so by omission.
- *
- * Nor does it set `width`/`height`: a seed tile is one SVG serving every
- * aspect (see `seedPhoto` below), so there is no honest intrinsic size.
- */
-export declare function seedGallery(...urls: string[]): ProductImage[];
-/**
- * A deterministic, labelled placeholder image for seed data, already wrapped in
- * the media proxy.
- *
- * Deterministic on purpose — Root Cause #25: a seed file is re-executed on every
- * `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;

package/dist/seed/_helpers/media.js

@@ -1,172 +0,0 @@
-/**
- * Seed-time media URL helper.
- *
- * Wraps a 3rd-party image/video URL in the /api/media/ext proxy path so
- * seed data never persists raw upstream URLs. The proxy adds watermarking,
- * survives upstream rate-limits, and keeps CSP / image hosts under our
- * control.
- *
- * Companion runtime helper: `resolveMediaUrl()` in ../../utils/media-url.ts
- * — defends consumers that still see raw URLs (e.g. live Firestore reads
- * from older docs). Both produce the same `/api/media/ext?url=<encoded>`
- * shape for external https URLs.
- *
- * Idempotent: already-proxied URLs (`/media/...` or `/api/media/ext?url=...`)
- * pass through untouched, so wrapping a wrapped URL is safe.
- */
-import { MEDIA_ENDPOINTS } from "../../constants/api-endpoints.js";
-const PROXY_PREFIX = "/media/";
-// audit-hardcoded-api-routes-ok: idempotency prefix check for MEDIA_ENDPOINTS.EXT_URL's own output shape, not a call site
-const EXT_PREFIX = "/api/media/ext?url=";
-export function seedExtMedia(url) {
-    if (url.startsWith(PROXY_PREFIX))
-        return url;
-    if (url.startsWith(EXT_PREFIX))
-        return url;
-    return MEDIA_ENDPOINTS.EXT_URL(url);
-}
-/* ── Seed photography ────────────────────────────────────────────────────── */
-/*
- * WHY THIS EXISTS
- *
- * The seed catalogue used to name its image host **409 times**, in 30 files, as
- * `https://picsum.photos/seed/<seed>/<w>/<h>` literals. On 2026-08-31 picsum
- * went down — 503 from its origin AND its Fastly CDN — and because the host was
- * written into every URL rather than referenced from one place, virtually every
- * image on the production site broke at once and there was no single edit that
- * could move them.
- *
- * That is the actual defect. A third party going down is not preventable; being
- * unable to react to it in one line is.
- *
- * Measured the same day, direct: picsum 503 · fastly.picsum 503 (10.5s) ·
- * placekitten 521 · loremflickr 200 but 5.4s, which exceeds the proxy's own 4s
- * fetch timeout · placehold.co 200 in 0.58s. Hence placehold.co.
- *
- * It renders the item's own NAME on the tile, which is a real gain over random
- * photography for a demo catalogue: every card now says what it is, and nobody
- * can mistake seeded data for real inventory.
- */
-/*
- * 🛑 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/";
-/**
- * Is this cover value a generated PLACEHOLDER rather than a real image?
- *
- * 🛑 Load-bearing for `withGeneratedCoverImage`, which otherwise treats any
- * non-empty `display.coverImage` as hand-authored and skips the row — so a
- * `seedPhoto(...)` tile BLOCKED every fetched wordmark, and a logo could be
- * downloaded, uploaded, mapped and still never appear.
- *
- * The distinction is the honest one: a tile is what the seed emits when it has
- * nothing better, so it is a default to be improved on. A real path (a
- * `/media/<slug>` or an admin upload) is a decision, and that still wins.
- */
-export function isSeedPlaceholderImage(value) {
-    return typeof value === "string" && value.startsWith(SEED_TILE_PREFIX);
-}
-/**
- * Muted backgrounds, all dark enough for the same light foreground.
- *
- * 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"];
-/** Deterministic 32-bit hash. Same seed, same colour, every reseed. */
-function seedHash(input) {
-    let h = 2166136261;
-    for (let i = 0; i < input.length; i += 1) {
-        h ^= input.charCodeAt(i);
-        h = Math.imul(h, 16777619);
-    }
-    return h >>> 0;
-}
-/**
- * Turn a seed key into something a person would read.
- *
- * `art-image-dranzer-phoenix-2-20260817` → `Dranzer Phoenix`
- *
- * Strips the trailing `-YYYYMMDD` stamp, a trailing image index, and the
- * leading `<kind>-image-` prefix that every seed key carries — all of which are
- * bookkeeping, not the name of the thing.
- */
-export function seedPhotoLabel(seed) {
-    const cleaned = seed
-        .replace(/-\d{8}$/, "")
-        .replace(/-\d+$/, "")
-        .replace(/^(?:product|art|sticker|stickers|auction|preorder|prizedraw|classified|digitalcode|live|blog|event|store|user|category|brand|bundle|group|review|ad|carousel|slide)-(?:image|cover|banner|logo|avatar|photo)-/, "")
-        .replace(/^(?:image|cover|banner|logo|avatar|photo)-/, "")
-        .replace(/-/g, " ")
-        .trim();
-    if (!cleaned)
-        return "LetItRip";
-    return cleaned.replace(/\b[a-z]/g, (c) => c.toUpperCase());
-}
-/**
- * A seed gallery as `ProductImage[]` — plan A6 changed
- * `ProductDocument.images` from `string[]` to `ProductImage[]`, and these
- * fixtures hold bare URLs.
- *
- * 🛑 Deliberately sets NO `alt`. The only string available at these call
- * sites is the product title, and "Dranzer S" repeated as the alt of all
- * three of its photos is the naive fill that screen-reader users correctly
- * treat as noise — worse than absent, because it claims to describe. The
- * GENERATED catalogue does emit real alt ("Chain Kerbeus — Aquilon-Q
- * (Disc)") because its join knows what each photo is OF; a hand-written
- * fixture does not, and should say so by omission.
- *
- * Nor does it set `width`/`height`: a seed tile is one SVG serving every
- * aspect (see `seedPhoto` below), so there is no honest intrinsic size.
- */
-export function seedGallery(...urls) {
-    return urls.filter(Boolean).map((url) => ({ url }));
-}
-/**
- * A deterministic, labelled placeholder image for seed data, already wrapped in
- * the media proxy.
- *
- * Deterministic on purpose — Root Cause #25: a seed file is re-executed on every
- * `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) {
-    const bg = SEED_PHOTO_COLOURS[seedHash(seed) % SEED_PHOTO_COLOURS.length];
-    // 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/part-colours-generated.d.ts

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

package/dist/seed/_helpers/part-colours-generated.js

@@ -1,273 +0,0 @@
-/**
- * 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 const GENERATED_PART_COLOURS = {
-    "attack-ring--circle-upper": "Maroon",
-    "attack-ring--cross-attacker": "Navy",
-    "attack-ring--cross-dranzer": "Blue",
-    "attack-ring--cross-fang": "Brown",
-    "attack-ring--cross-griffon": "Teal",
-    "attack-ring--cross-spike": "Black",
-    "attack-ring--cross-spiker": "Green",
-    "attack-ring--cybernetic-dragon": "Black",
-    "attack-ring--devil-crusher": "Grey",
-    "attack-ring--double-horn": "Gold",
-    "attack-ring--double-wing": "Blue",
-    "attack-ring--dragon-breaker": "Navy",
-    "attack-ring--dragon-saucer": "Navy",
-    "attack-ring--eight-attacker": "Brown",
-    "attack-ring--eight-spike": "Silver",
-    "attack-ring--flame-wing": "Navy",
-    "attack-ring--g-upper": "Bronze",
-    "attack-ring--genocide-circle": "Red",
-    "attack-ring--gigantic-claw": "Bronze",
-    "attack-ring--great-dragon": "Black",
-    "attack-ring--hammer-tusk": "Blue",
-    "attack-ring--howling-leo": "Silver",
-    "attack-ring--jiraiya-blade": "Silver",
-    "attack-ring--metal-ape": "Grey",
-    "attack-ring--metal-attacker": "Grey",
-    "attack-ring--metal-defense": "Grey",
-    "attack-ring--metal-saucer": "Purple",
-    "attack-ring--mountain-hammer": "Maroon",
-    "attack-ring--panther-claw": "Navy",
-    "attack-ring--panther-head": "Maroon",
-    "attack-ring--penta-wing": "Navy",
-    "attack-ring--reverse-dragon": "Maroon",
-    "attack-ring--sharkrash": "Navy",
-    "attack-ring--shield-hammer": "Green",
-    "attack-ring--sonic-tiger": "Black",
-    "attack-ring--spike-dragon": "Brown",
-    "attack-ring--spiral-upper": "Navy",
-    "attack-ring--star-wolf": "Purple",
-    "attack-ring--strike-turtle": "Black",
-    "attack-ring--ten-spike": "Black",
-    "attack-ring--tiger-defenser": "Red",
-    "attack-ring--triangle-wing": "Navy",
-    "attack-ring--triple-beak": "Red",
-    "attack-ring--turtle-survivor": "Navy",
-    "attack-ring--ultimate-attacker": "Grey",
-    "attack-ring--upper-claw": "Black",
-    "attack-ring--upper-dragon": "Bronze",
-    "attack-ring--vanishing-moot": "Teal",
-    "attack-ring--war-lion": "Maroon",
-    "attack-ring--war-monkey": "Grey",
-    "attack-ring--wing-survivor": "Blue",
-    "attack-ring--wing-upper": "Silver",
-    "attack-ring--wolf-crusher": "Brown",
-    "bit--accel": "Navy",
-    "bit--disk-ball": "Gold",
-    "bit--flat": "Teal",
-    "bit--free-ball": "Yellow",
-    "bit--gear-ball": "Yellow",
-    "bit--hexa": "Maroon",
-    "bit--point": "Maroon",
-    "bit--taper": "Red",
-    "bit--trans-point": "Red",
-    "bit--vortex": "Navy",
-    "blade--aeropegasus": "Navy",
-    "blade--cobaltdragoon": "Blue",
-    "blade--cobaltdrake": "Blue",
-    "blade--crimsongaruda": "Maroon",
-    "blade--dranbuster": "Navy",
-    "blade--drandagger": "Navy",
-    "blade--dransword": "Black",
-    "blade--dranzerspiral": "Blue",
-    "blade--drigerslash": "Red",
-    "blade--ghostcircle": "Maroon",
-    "blade--hellshammer": "Maroon",
-    "blade--hellsscythe": "Black",
-    "blade--knightshield": "Black",
-    "blade--leonclaw": "Navy",
-    "blade--phoenixwing": "Maroon",
-    "blade--savior": "Blue",
-    "blade--sharkedge": "Navy",
-    "blade--silverwolf": "Grey",
-    "blade--tyrannobeat": "Maroon",
-    "blade--unicornsting": "Black",
-    "blade--vipertail": "Black",
-    "blade--wizardarrow": "Yellow",
-    "blade--wizardrod": "Gold",
-    "blade-base--customize-clutch-base": "Blue",
-    "blade-base--customize-grip-base": "Navy",
-    "blade-base--customize-metal-sharp": "Red",
-    "blade-base--engine-stopper-base": "Silver",
-    "blade-base--first-clutch-base": "Green",
-    "blade-base--flame-change-base": "Navy",
-    "blade-base--fortress-base": "Navy",
-    "blade-base--full-auto-clutch-base": "Brown",
-    "blade-base--griffolyon-base": "Grey",
-    "blade-base--instant-release": "Grey",
-    "blade-base--jumping-base": "Brown",
-    "blade-base--magne-flat-base": "Grey",
-    "blade-base--metal-change-base": "Grey",
-    "blade-base--metal-sharp-base": "Black",
-    "blade-base--sg-flat": "Red",
-    "blade-base--sg-flat-base": "Red",
-    "blade-base--sg-jumping-base-2": "Grey",
-    "blade-base--sg-metal-ball": "Green",
-    "blade-base--sg-metal-flat-2": "Purple",
-    "blade-base--sg-metal-flat-base": "Brown",
-    "blade-base--viper-metal-ball-base": "Black",
-    "blade-base--volcano-change-base": "Navy",
-    "chrome-wheel--dragoon": "White",
-    "disc--0": "Grey",
-    "disc--00": "Grey",
-    "disc--1": "Grey",
-    "disc--10": "Grey",
-    "disc--11": "Navy",
-    "disc--7": "Grey",
-    "disc--8": "Grey",
-    "disc--aquilon-q": "Grey",
-    "disc--around": "Maroon",
-    "disc--blitz": "Red",
-    "disc--boost": "Grey",
-    "disc--drake": "Navy",
-    "disc--force": "Grey",
-    "disc--karma": "Grey",
-    "disc--knuckle": "Grey",
-    "disc--legacy": "Grey",
-    "disc--limited": "Grey",
-    "disc--nexus": "Grey",
-    "disc--nine": "Teal",
-    "disc--over": "Navy",
-    "disc--sting": "Navy",
-    "disc--tapered": "Grey",
-    "disc--triple": "Navy",
-    "disc--vanguard": "Red",
-    "disc--vertical": "Black",
-    "disc--yell": "Brown",
-    "disc--zenith": "Pink",
-    "driver--atomic": "Gold",
-    "driver--bullet": "Maroon",
-    "driver--charge": "Teal",
-    "driver--destroy-dash": "Teal",
-    "driver--dimension": "Red",
-    "driver--dimension-dash": "Red",
-    "driver--drift": "Grey",
-    "driver--evolution-dash": "Teal",
-    "driver--iron": "Teal",
-    "driver--jaggy": "Navy",
-    "driver--loop": "Black",
-    "driver--merge": "Maroon",
-    "driver--mobius": "Black",
-    "driver--nothing": "Red",
-    "driver--press": "Black",
-    "driver--reboot": "Blue",
-    "driver--revolve-q": "Purple",
-    "driver--spiral": "Grey",
-    "driver--unite": "Maroon",
-    "driver--unite-dash": "Gold",
-    "driver--variable": "Teal",
-    "driver--variable-dash": "Navy",
-    "driver--xceed-x": "Bronze",
-    "driver--xtend": "Red",
-    "driver--zone-z": "Blue",
-    "energy-ring--4d-clear-wheel-orion": "Maroon",
-    "energy-ring--blaze": "Bronze",
-    "energy-ring--bull": "Navy",
-    "energy-ring--capricorn": "Green",
-    "energy-ring--capricorne": "Green",
-    "energy-ring--clear-wheel-wolf": "Navy",
-    "energy-ring--nemesis-x": "Yellow",
-    "energy-ring--sagittario": "Green",
-    "energy-ring--sagittario-i": "Green",
-    "energy-ring--striker-ii": "Maroon",
-    "energy-ring--wolf": "Navy",
-    "energy-ring--zurafa": "Black",
-    "engine-gear--left-engine-gear": "Grey",
-    "fusion-wheel--4d-metal-wheel-phantom": "Purple",
-    "fusion-wheel--burn": "Grey",
-    "fusion-wheel--earth": "Silver",
-    "fusion-wheel--flame": "Grey",
-    "fusion-wheel--forbidden": "Grey",
-    "fusion-wheel--metal-wheel-mercury": "Navy",
-    "fusion-wheel--proto": "Grey",
-    "fusion-wheel--rock": "Gold",
-    "layer--dark-deathscyther": "Black",
-    "layer--draciel-fortress": "Grey",
-    "layer--drain-fafnir": "Blue",
-    "layer--dranzer-flame": "Navy",
-    "layer--engine-gear": "Brown",
-    "layer--gaia-dragoon": "Purple",
-    "layer--genesis-valtryek-v3": "Grey",
-    "layer--god-valkyrie": "Blue",
-    "layer--kaiser-kerbeus": "Teal",
-    "layer--king-kerbeus-k2": "Grey",
-    "layer--legend-spriggan": "Pink",
-    "layer--maximum-garuda": "Yellow",
-    "layer--obelisk-odin": "Silver",
-    "layer--sieg-xcalibur": "Blue",
-    "layer--spryzen-requiem-s3": "Maroon",
-    "layer--storm-spriggan": "Pink",
-    "layer--victory-valkyrie": "Blue",
-    "layer--wild-wyvern": "Black",
-    "layer--wolborg": "Silver",
-    "layer--xeno-xcalibur": "Red",
-    "performance-tip--as": "Silver",
-    "performance-tip--bs": "Grey",
-    "performance-tip--cf": "Red",
-    "performance-tip--cs": "Navy",
-    "performance-tip--evolution": "Blue",
-    "performance-tip--ewd": "Gold",
-    "performance-tip--f": "Grey",
-    "performance-tip--f-d": "Gold",
-    "performance-tip--gf": "Black",
-    "performance-tip--ms": "Grey",
-    "performance-tip--r-f": "Navy",
-    "performance-tip--rb": "Grey",
-    "performance-tip--rf": "Bronze",
-    "performance-tip--sf": "Grey",
-    "performance-tip--tb": "Black",
-    "performance-tip--wb": "White",
-    "performance-tip--wsf": "Brown",
-    "ratchet--0-80": "Navy",
-    "ratchet--1-60": "Navy",
-    "ratchet--3-60": "Navy",
-    "ratchet--3-70": "Bronze",
-    "ratchet--3-80": "Green",
-    "ratchet--4-60": "Maroon",
-    "ratchet--4-70": "Silver",
-    "ratchet--4-80": "Gold",
-    "ratchet--5-60": "Black",
-    "ratchet--5-70": "Gold",
-    "ratchet--5-80": "Red",
-    "ratchet--9-60": "Maroon",
-    "running-core--flat-core": "Brown",
-    "running-core--grip-flat-core": "Grey",
-    "running-core--manual-change-core": "White",
-    "running-core--semi-flat-core": "Grey",
-    "running-core--sharp-core": "Grey",
-    "spin-gear--heavy-metal-core": "Brown",
-    "spin-gear--neo-right-sg": "Maroon",
-    "spin-track--135": "Grey",
-    "spin-track--a230": "Maroon",
-    "spin-track--sa165": "Brown",
-    "spin-track--sp230": "Grey",
-    "spin-track--t125": "Yellow",
-    "spin-track--v145": "Red",
-    "spin-track--w105": "Navy",
-    "weight-disk--circle-balance": "Grey",
-    "weight-disk--eight-heavy": "Grey",
-    "weight-disk--heavy-attack": "White",
-    "weight-disk--magne-weight-disk": "Grey",
-    "weight-disk--star-attack": "Grey",
-    "weight-disk--ten-balance": "White",
-    "weight-disk--ten-heavy": "Grey",
-    "weight-disk--ten-wide": "Grey",
-    "weight-disk--wing-attacker": "Red",
-};
-export const GENERATED_PART_COLOUR_COUNT = 254;

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

@@ -1,18 +0,0 @@
-import type { ProductDocument } from "../../features/products/schemas";
-/**
- * Derive `searchTxt` for a seeded product from its own content.
- *
- * Applied to the WHOLE array at each file's export rather than written per
- * record. Four of the product seed files built records as inline literals with
- * an inline `searchTxt:`, and in every one of them the last record — the
- * "sold"/"depleted" fixture appended at the bottom — had been added without it.
- * Those are exactly the rows the "Sold & Ended" scope exists to exercise, so
- * they were invisible to search in the one view built to show them.
- *
- * The `...p` spread comes FIRST so a record cannot override or omit the field:
- * that ordering is the actual guarantee, not the convention around it.
- *
- * Pure function of the record's content — deterministic, so this does not
- * reintroduce the `appkit-seed` idempotency problem of Root Cause #25.
- */
-export declare function withProductSearchTxt(p: Partial<ProductDocument>): Partial<ProductDocument>;

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

@@ -1,23 +0,0 @@
-import { buildProductSearchTxt } from "../../utils/search-txt-builders.js";
-/**
- * Derive `searchTxt` for a seeded product from its own content.
- *
- * Applied to the WHOLE array at each file's export rather than written per
- * record. Four of the product seed files built records as inline literals with
- * an inline `searchTxt:`, and in every one of them the last record — the
- * "sold"/"depleted" fixture appended at the bottom — had been added without it.
- * Those are exactly the rows the "Sold & Ended" scope exists to exercise, so
- * they were invisible to search in the one view built to show them.
- *
- * The `...p` spread comes FIRST so a record cannot override or omit the field:
- * that ordering is the actual guarantee, not the convention around it.
- *
- * Pure function of the record's content — deterministic, so this does not
- * reintroduce the `appkit-seed` idempotency problem of Root Cause #25.
- */
-export function withProductSearchTxt(p) {
-    // Delegates rather than re-deriving. This wrapper listed 9 sources while the
-    // write path indexed 12, so a seeded product was findable by fewer terms than
-    // the identical product created through the app — with no error on either side.
-    return { ...p, searchTxt: buildProductSearchTxt(p) };
-}

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

@@ -1,26 +0,0 @@
-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";
-import type { BlogPostDocument } from "../../features/blog/schemas/firestore";
-import type { ReviewPlain } from "../../features/reviews/schemas/firestore";
-import type { OrderPlain } from "../../features/orders/schemas/firestore";
-import type { CouponDocument } from "../../features/promotions/schemas/firestore";
-import type { OfferPlain } 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;
-export declare function withReviewSearchTxt<T extends Partial<ReviewPlain>>(p: T): T;
-export declare function withOrderSearchTxt<T extends Partial<OrderPlain>>(p: T): T;
-export declare function withCouponSearchTxt<T extends Partial<CouponDocument>>(p: T): T;
-export declare function withOfferSearchTxt<T extends Partial<OfferPlain>>(p: T): T;
-export declare function withScammerSearchTxt<T extends Partial<ScammerDocument>>(p: T): T;

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

@@ -1,58 +0,0 @@
-import { buildCategorySearchTxt, buildStoreSearchTxt, buildEventSearchTxt, buildBlogSearchTxt, buildReviewSearchTxt, buildOrderSearchTxt, buildCouponSearchTxt, buildOfferSearchTxt, buildScammerSearchTxt, } from "../../utils/search-txt-builders.js";
-/**
- * 🛑 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) };
-}
-export function withEventSearchTxt(p) {
-    return { ...p, searchTxt: buildEventSearchTxt(p) };
-}
-export function withBlogSearchTxt(p) {
-    return { ...p, searchTxt: buildBlogSearchTxt(p) };
-}
-/*
- * Bounded by `ReviewPlain` for the same reason as the offer wrapper: seed
- * fixtures hold plaintext and `seed-cli` encrypts on write, and
- * `string`/`Encrypted<string>` are incompatible in both directions.
- * `buildReviewSearchTxt` deliberately does NOT read `userName` — it is
- * encrypted, and indexing it would undo the encryption (D1).
- */
-export function withReviewSearchTxt(p) {
-    return { ...p, searchTxt: buildReviewSearchTxt(p) };
-}
-/*
- * Bounded by `OrderPlain`: seed fixtures hold plaintext and `seed-cli`
- * encrypts on write. `buildOrderSearchTxt` reads the product, store, tracking
- * number, items and location — never `userEmail` (D1).
- */
-export function withOrderSearchTxt(p) {
-    return { ...p, searchTxt: buildOrderSearchTxt(p) };
-}
-export function withCouponSearchTxt(p) {
-    return { ...p, searchTxt: buildCouponSearchTxt(p) };
-}
-/*
- * Bounded by `OfferPlain`, not `OfferDocument`.
- *
- * Seed fixtures hold plaintext and `seed-cli` encrypts on write, so the array
- * this maps over is `Partial<OfferPlain>[]`. `string` and `Encrypted<string>`
- * are incompatible in both directions, so a document-bounded generic rejects
- * the plain shape outright. The function reads `buyerName` for tokens and does
- * not care which it gets — and `buildOfferSearchTxt` is deliberately given the
- * PLAINTEXT one: tokenising ciphertext would index base64.
- */
-export function withOfferSearchTxt(p) {
-    return { ...p, searchTxt: buildOfferSearchTxt(p) };
-}
-export function withScammerSearchTxt(p) {
-    return { ...p, searchTxt: buildScammerSearchTxt(p) };
-}

package/dist/seed/addresses-seed-data.d.ts

@@ -1,2 +0,0 @@
-import type { AddressPlain } from "../features/addresses/schemas/firestore";
-export declare const addressesSeedData: AddressPlain[];