@mohasinac/appkit 4.53.0 → 4.53.2

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

@@ -7,4 +7,4 @@ export interface CharacterSeed {
     beyCount: number;
 }
 export declare const CHARACTER_SEEDS: CharacterSeed[];
-export declare const CHARACTER_SEED_COUNT = 94;
+export declare const CHARACTER_SEED_COUNT = 95;

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

@@ -68,6 +68,7 @@ export const CHARACTER_SEEDS = [
     { 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 },
@@ -116,4 +117,4 @@ export const CHARACTER_SEEDS = [
     { slug: "blader-yuni-naniwa", name: "Yuni Naniwa", beyCount: 1 },
     { slug: "blader-zyro-kurogane", name: "Zyro Kurogane", beyCount: 1 },
 ];
-export const CHARACTER_SEED_COUNT = 94;
+export const CHARACTER_SEED_COUNT = 95;

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

@@ -64,8 +64,16 @@ export function franchiseRow(input, order, stamps) {
         path: id,
         isLeaf: true,
         order,
-        /* `icon` deliberately unset — the brands grid reads `display.icon` first
-         * and an emoji there would beat a real cover image (brand-rows trap 2). */
+        /*
+         * 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,

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

@@ -1,4 +1,34 @@
+/**
+ * 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.
  *
@@ -9,6 +39,23 @@ export declare function seedExtMedia(url: string): string;
  * 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.

package/dist/seed/_helpers/media.js

@@ -75,6 +75,21 @@ export function seedExtMedia(url) {
  * 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.
  *
@@ -120,6 +135,25 @@ export function seedPhotoLabel(seed) {
         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.

package/dist/seed/authenticity-knowledge-seed-data.d.ts

@@ -1,14 +1,19 @@
 export declare const AUTHENTICITY_KNOWLEDGE_COLLECTION = "authenticityKnowledge";
-/** A date-code row, a generation summary, or (future) a marque. */
-export type AuthenticityKnowledgeKind = "date-code" | "generation" | "marque";
+/** A date-code row, its reverse per-model row, a generation summary, a series-production window, or (future) a marque. */
+export type AuthenticityKnowledgeKind = "date-code" | "model-codes" | "generation" | "series-window" | "marque";
 /**
  * What the community has recorded about a box code.
  *
  * 🛑 `recorded-midfake` is a statement about a BATCH, never about a seller, and
  * never "counterfeit". A midfake is Takara-Tomy-blueprint product of reduced
  * quality and there is no official Takara Tomy statement acknowledging the runs.
+ *
+ * 🛑 `contested` is not a weaker midfake — it means two sources assert OPPOSITE
+ * things about the same code. Quoting either side of one as the answer is how
+ * this collection would be used to accuse the holder of a genuine box, or to
+ * reassure the holder of a fake. Report both.
  */
-export type AuthenticityCodeVerdict = "recorded-original" | "recorded-midfake" | "unresolved";
+export type AuthenticityCodeVerdict = "recorded-original" | "recorded-midfake" | "contested" | "unresolved";
 export interface AuthenticityKnowledgeDocument {
     id: string;
     kind: AuthenticityKnowledgeKind;
@@ -17,18 +22,57 @@ export interface AuthenticityKnowledgeDocument {
     code?: string;
     verdict?: AuthenticityCodeVerdict;
     products?: string[];
-    distributors?: string[];
+    /** Regions of sale: Japan, Taiwan (Funbox Toys), Korea (Sonokong), … */
+    regions?: string[];
+    /** Starter / Booster / Random Booster Vol. N, where a source stated it. */
+    packaging?: string[];
+    /** Per-batch observations: mould variants, importer stickers, launcher colour. */
+    notes?: string[];
+    /** Midfake rows: taiwan-batch | sonokong-highquality | chinese-font. */
+    families?: string[];
+    /** Which archived source files carry this row. */
+    sources?: string[];
+    /** The source itself hedged — a blurry photo, or two codes it could not separate. */
+    uncertain?: boolean;
     /** Derived FROM the code under the disputed month-day-year reading. */
     derivedDate?: string | null;
     /** True where the source's own written date contradicts its own stated rule. */
     sourceDateDiffers?: boolean;
+    /**
+     * The bey(s) this code is recorded against, as CATEGORY LEAF ids — the same
+     * id the model's own page, its search hit and its imagery all use.
+     *
+     * 🛑 A code resolving to no model is NORMAL and is not a defect in the row:
+     * the source may have named a bey the canonical corpus has no entry for, or
+     * named a Random Booster rather than a bey. Those labels are kept in
+     * `unlinkedProducts` so the gap is visible instead of looking like nothing
+     * was ever recorded.
+     */
+    modelSlugs?: string[];
+    categoryIds?: string[];
+    unlinkedProducts?: string[];
+    /** `contested` rows only: which source is on which side. */
+    recordedOriginalBy?: string[];
+    recordedMidfakeBy?: string[];
     generation?: string;
+    /** `model-codes` rows only — the reverse index, keyed by category leaf. */
+    modelSlug?: string;
+    categoryId?: string;
+    retailCode?: string | null;
+    originalCodes?: string[];
+    midfakeCodes?: string[];
+    contestedCodes?: string[];
+    unclearCodes?: string[];
     /** generation rows only. */
     canonicalReleaseCount?: number;
     releasesWithRetailCode?: number;
     exampleCodes?: string[];
     hasDateCodeTable?: boolean;
+    /** series-window rows only. `name`/`generation` are shared with other kinds above. */
+    name?: string;
+    startLabel?: string;
+    endLabel?: string;
 }
 export declare const authenticityKnowledgeSeedData: AuthenticityKnowledgeDocument[];
 /** Asserted downstream so a silent drop is loud. */
-export declare const AUTHENTICITY_KNOWLEDGE_COUNT = 104;
+export declare const AUTHENTICITY_KNOWLEDGE_COUNT = 565;