@mohasinac/appkit 4.64.0 → 4.65.0

package/dist/features/parts/schemas/firestore.d.ts

@@ -548,7 +548,252 @@ export interface PartGlossaryDocument extends BaseDocument, AdminEditableRecord
     imageSourceUrl?: string;
     /** "Read more on the Beyblade Wiki". Facts taken, prose theirs, link out. */
     sourceUrl?: string;
+    /**
+     * Hand-written analysis, read from the sources one page at a time.
+     *
+     * 🛑 ONE NESTED OBJECT, not twenty top-level fields, and the reason is the
+     * merge rather than tidiness. Everything else on this document is EXTRACTED
+     * and is regenerated wholesale by `generate-parts-seed.mjs`; this is
+     * AUTHORED and must survive that regeneration. Keeping it under one key
+     * makes the overlay merge a single assignment the generator cannot
+     * accidentally clobber field-by-field, and makes "is this ours or the
+     * wiki's?" answerable by position rather than by memory.
+     *
+     * 🛑 It also keeps `adminEditedFields` honest: an admin editing
+     * `authored.verdict` records one path, where twenty flattened fields would
+     * need twenty entries and the first missed one would be silently
+     * re-generated over.
+     */
+    authored?: PartAuthoredAnalysis;
+}
+/**
+ * What a human wrote about one part after reading its sources.
+ *
+ * ── 🛑 WHY THESE FIELDS AND NOT A FREE-TEXT BLOB ───────────────────────────
+ *
+ * Each one is a question a buyer or a game implementation actually asks, and
+ * each was being answered in passing inside prose where nothing could filter,
+ * sort or require it. `availability` is the worked example: 93 records carried
+ * "one bey, Takara Tomy only" and "widely shipped across six products" inside
+ * their competitive reasoning, so the single most commercially useful fact on
+ * the record was unqueryable until it became a field.
+ */
+export interface PartAuthoredAnalysis {
+    /** My own account of the shape, in my words, from the sources' facts. */
+    geometryNote: string;
+    /** 2-3 sentences. The thing a buyer reads first. */
+    verdict: string;
+    competitive: {
+        /** essential | useful | collector | outclassed. */
+        tier: PartCompetitiveTier;
+        /** 0-100 WITHIN its slot, so parts are comparable where they compete. */
+        score: number;
+        /** Where the judgement came from, so a reader can discount it. */
+        basis: "source-overall" | "ratings" | "mass" | "legality" | "combo-list" | "inference";
+        /**
+         * Per format or per role, because one part is often two parts.
+         *
+         * 🛑 Not decoration: `attack-ring--circle-upper` produces monstrous Smash
+         * ONLY in left spin and mingles all three attack types in right spin, from
+         * one fixed shape. A single tier for that part is a lie in one direction.
+         */
+        byFormat?: Record<string, string> | null;
+        reasoning: string;
+    };
+    designDifficulty: {
+        /** 0-100. How hard this part is to reproduce faithfully in a game. */
+        score: number;
+        /** From the CLOSED driver set in `terms.json`. */
+        drivers: string[];
+        reasoning: string;
+        /** The detail a naive implementation gets wrong. */
+        note?: string;
+    };
+    /**
+     * Which products it came in, and in what colour.
+     *
+     * 🛑 `beys` is what a RELEASE LIST says shipped it — a purchasing fact with
+     * codes and colourways attached. `beysFromOtherSources` is "a document
+     * describes this part inside this bey", LABELLED BY ORIGIN
+     * (`corpus:gen1-plastic-dranzer-v2`). Merging the two would make a corpus
+     * mention indistinguishable from a box you can buy, which is the one
+     * distinction a shopper needs. 306 parts have the second and not the first.
+     */
+    availability: {
+        beys: string[];
+        beysFromOtherSources?: string[];
+        usedByIds?: string[];
+        colourways: Array<{
+            colourway: string;
+            vendor?: string;
+            code?: string;
+            distribution?: string;
+            inBey?: string;
+        }>;
+        codes?: string[];
+        hasbroCode?: string;
+        moulds?: boolean;
+        /** Why `beys` is empty, when it is. An empty list is a finding, not a blank. */
+        note?: string | null;
+    };
+    /**
+     * The character who used it in the story.
+     *
+     * 🛑 The single biggest collector hook, and it does NOT live on the part
+     * pages: measured, the `Owner` infobox key is filled on 3 of 2,248 part
+     * pages. It comes from the bey and character pages. Nobody searches "Attack
+     * Ring MA-04"; they search "Tyson's Dragoon".
+     */
+    owner?: string;
+    /** "Bladebreakers", "Blitz Team" — a collecting set in its own right. */
+    team?: string;
+    /** Series plus episode of first appearance, as the source words it. */
+    animeDebut?: string;
+    /** How hard it is to get. A closed enum so it can be faceted. */
+    rarity?: PartRarity;
+    /** The vendor or region that gated it — "SH-03/04 Chinese exclusive". */
+    exclusiveTo?: string;
+    /**
+     * How to tell which copy you are buying.
+     *
+     * 🛑 The most actionable buying guidance in the whole corpus and it was
+     * buried in prose. Circle Upper's first mould has a 2.9 mm metal frame and
+     * weighs mid-19 g; its second has 3.6 mm and weighs upper-20 g, and they
+     * perform differently. Cross Griffon's Hasbro mould moves the figurine
+     * mounts to the top where they only add recoil, so the wiki says a Takara
+     * copy is "greatly preferred". That is a purchase decision.
+     */
+    mouldIdentification?: string;
+    /**
+     * What wears or breaks, and whether it matters — which is exactly what a
+     * USED-marketplace listing needs and what the sources keep volunteering:
+     * "spikes wear with use but do NOT affect usability", "very unlikely to
+     * break, even on Grip Base", "sharp wing tips can cause damage to Stadium
+     * walls".
+     */
+    conditionWatch?: string;
+    /** What else you must own for it to work — "needs a taller RC to clear the floor". */
+    needsToUse?: string;
+    /**
+     * Named finishing moves, with the character who performs them.
+     *
+     * Source: the bey corpus's own tables, e.g.
+     * `| Dark Wings | Phi | Layer-level impact at low spin | Burst Turbo |`.
+     * Nothing had ever joined them to a part or a bey.
+     */
+    specialMoves?: Array<{
+        name: string;
+        character?: string;
+        effect?: string;
+        system?: string;
+    }>;
+    /** The spirit bound to the bey — a game entity in its own right. */
+    bitBeast?: string;
+    /**
+     * How it wins.
+     *
+     * 🛑 FOUR classes are already evidenced and most models carry two. Beyond
+     * knock-out and destabilise-then-outspin: Cross Griffon has "some of the
+     * most effective stopping power of any Attack Ring", interrupting rotation
+     * without moving the opponent, and Cross Spiker delivers "spike attack" in
+     * left spin. An implementation with only KO and topple has nowhere to put
+     * either, and would render the generation's best stopping-power ring as a
+     * mid-tier smash part.
+     */
+    winCondition?: string[];
+    /**
+     * Every photograph of this part that a source carries, with its caption.
+     *
+     * 🛑 THE CAPTION IS THE DATA. "Advance Attacker with Metal Frame detached" is
+     * not a label for a picture — it is the statement that a photograph exists of
+     * the one feature the part is built around, and looking at it corrected the
+     * prose: every source calls the metal frame a "Metal Frame" that "separates
+     * from the ABS Caul", and the photograph shows it is a single die-cast
+     * triskelion — a central annulus, three radial arms, three tangential claws,
+     * with three registration pegs at 120° that are what permit the flip. No
+     * source says any of that.
+     *
+     * 🛑 `image` above is ONE `/media/<slug>` for the card. This is the gallery,
+     * and it holds SOURCE urls deliberately: routing them through `/media`
+     * requires uploading ~1,600 objects to live Storage, which is a separate,
+     * explicitly-authorised step. Recording what exists is free and reversible;
+     * publishing it is neither. Nothing renders these directly — Root Cause #27
+     * and the media rules still apply at the point of use.
+     *
+     * 🛑 Fetching needs `Referer: https://beyblade.fandom.com/`.
+     * `static.wikia.nocookie.net` hotlink-protects on the REFERER, not the
+     * User-Agent: a browser UA alone returns 403 `text/html`, which reads as "the
+     * image is gone" and sends you hunting for a replacement that does not exist.
+     *
+     * 🛑 fandom and WBO are ONE lineage here, not two sources. Both serve
+     * `1AdvanceStriker.JPG` under the same name. Dedupe on `name`, never on
+     * `url`, or one photograph is counted as corroboration of itself.
+     */
+    photos?: Array<{
+        /** The source's own caption. Empty on WBO, which usually gives none. */
+        caption?: string;
+        /** Original upload filename — the dedupe key across hosts. */
+        name?: string;
+        /** Full-size URL, with the host's thumbnail scaling undone. */
+        url: string;
+        /** `fandom` | `wbo` — which crawl it came from, for attribution. */
+        host?: string;
+        /** What this photo PROVES that the prose does not say. */
+        shows?: string;
+    }>;
+    /**
+     * What wear does to it.
+     *
+     * 🛑 WEAR CAN BE A POSITIVE, which a durability model that only degrades
+     * cannot express. hmsdb's best combo for Circle Upper wants "a Bearing Core
+     * 2 that is WORN ENOUGH to consistently flower pattern". Treating wear as
+     * monotonic damage contradicts the source.
+     */
+    wearBehaviour?: string;
+    /** Launcher or winder needed, and whether spin direction is chosen at launch. */
+    launcherRequirement?: string;
+    /** Where behaviour changes by stadium — range matters more in a wide one. */
+    stadiumDependence?: string;
+    /** Counters and countered-by, as the sources name them. */
+    matchups?: {
+        strongAgainst?: string[];
+        weakAgainst?: string[];
+        note?: string;
+    };
+    /** Parts the sources pair it with, verbatim from their combo lists. */
+    comboPartners?: string[];
+    /** Terms from `terms.json`, so the vocabulary stays closed. */
+    termsUsed?: string[];
+    /** Where a source was wrong or where two sources disagree. */
+    corrections?: Array<{
+        field: string;
+        was: string;
+        now: string;
+        basis: string;
+    }>;
+    /** confirmed | probable | weak — and the gate checks it against the record. */
+    confidence: "confirmed" | "probable" | "weak";
+    confidenceNote?: string;
+    /** Which sources the record was written from. */
+    sourceUsed: string[];
+    sourceUrl?: string;
+    authoredAt: string;
+    /** Set when a record is re-read after new sources became reachable. */
+    reReadAt?: string;
 }
+/** How hard a part is to obtain. Faceted, so it is a closed set. */
+export declare const PartRarityValues: readonly ["mass-retail", "booster", "random-booster", "set-only", "prize", "vendor-exclusive", "regional-exclusive"];
+export type PartRarity = (typeof PartRarityValues)[number];
+/**
+ * How much a part matters competitively.
+ *
+ * 🛑 `collector` is not a weak `useful`. It means "worth owning rather than
+ * playing" and it is the only tier assignable with NO performance evidence —
+ * which is what a part like `attack-ring--dark-spike`, whose every source is
+ * silent, honestly deserves.
+ */
+export declare const PartCompetitiveTierValues: readonly ["essential", "useful", "collector", "outclassed"];
+export type PartCompetitiveTier = (typeof PartCompetitiveTierValues)[number];
 /** One slot of one model's composition. */
 export interface ModelSlot {
     slotKey: PartSlot;
@@ -624,6 +869,35 @@ export interface ModelCompositionDocument extends BaseDocument {
     source?: string;
     /** The named-model category this composition describes, when one exists. */
     categoryId?: string;
+    /**
+     * The character who used this bey, as a `character-*` category id.
+     *
+     * 🛑 An ID, not a name. Character names are re-localised between the
+     * Japanese and English releases (Takao Kinomiya / Tyson Granger), so a name
+     * is the one key guaranteed to drift — the same trap `brand-rows.ts` records
+     * for brands matching on display name.
+     */
+    owner?: string;
+    /**
+     * ── 🛑 THE ANIME SUCCESSION CHAIN, NOT RELEASE ORDER ────────────────────
+     *
+     * `previousBey` is the bey this one replaced in the STORY; `nextBey` is the
+     * one that replaced it. Both are composition ids.
+     *
+     * 🛑 IT CANNOT BE DERIVED FROM PRODUCT CODES, and a generator must not try.
+     * Tyson's chain runs Dragoon -> Dragoon S -> Dragoon V -> Dragoon V2 ->
+     * Dragoon G -> Dragoon MS, crossing four part systems and three toy lines,
+     * and the codes do not order it. The sequence is a narrative fact stated in
+     * prose on the bey and character pages, so it is READ.
+     *
+     * 🛑 BOTH DIRECTIONS ARE STORED AND MUST AGREE. A one-way link makes "what
+     * came before this" unanswerable from the earlier bey's page, and a
+     * `character.lineup` that disagrees with these links is the denormalised-
+     * mirror trap (Root Cause #42) — here it would silently break a progression.
+     * `audit-lineup-symmetry` checks both.
+     */
+    previousBey?: string;
+    nextBey?: string;
 }
 /** `(slot, code|name)` → document id. The ONE place this is composed. */
 export declare function partGlossaryId(slot: PartSlot, codeOrName: string): string;

package/dist/features/parts/schemas/firestore.js

@@ -305,6 +305,25 @@ export function partSlotFromSegment(segment) {
     const hit = ALL_PART_SLOTS.find((s) => s === segment);
     return hit ?? null;
 }
+/** How hard a part is to obtain. Faceted, so it is a closed set. */
+export const PartRarityValues = [
+    "mass-retail",
+    "booster",
+    "random-booster",
+    "set-only",
+    "prize",
+    "vendor-exclusive",
+    "regional-exclusive",
+];
+/**
+ * How much a part matters competitively.
+ *
+ * 🛑 `collector` is not a weak `useful`. It means "worth owning rather than
+ * playing" and it is the only tier assignable with NO performance evidence —
+ * which is what a part like `attack-ring--dark-spike`, whose every source is
+ * silent, honestly deserves.
+ */
+export const PartCompetitiveTierValues = ["essential", "useful", "collector", "outclassed"];
 /** `(slot, code|name)` → document id. The ONE place this is composed. */
 export function partGlossaryId(slot, codeOrName) {
     const tail = codeOrName

package/dist/features/payments/repository/saved-payment-methods.repository.js

@@ -12,7 +12,7 @@ import { createHash } from "crypto";
 import { normalizeError } from "../../../errors/normalize.js";
 import { DatabaseError } from "../../../errors/index.js";
 import { serverLogger } from "../../../monitoring/index.js";
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase/index.js";
+import { BaseRepository, prepareForFirestore } from "../../../providers/db-firebase/index.js";
 import { PAYMENT_METHOD_PII_FIELDS, encryptPiiFields, maskPii, revealPii, } from "../../../security/index.js";
 import { asEncrypted } from "../../../security/encrypted.js";
 import { SAVED_PAYMENT_METHOD_FIELDS, SAVED_PAYMENT_METHODS_COLLECTION, } from "../schemas/saved-methods-firestore.js";

package/dist/features/pre-orders/api/admin/route.js

@@ -11,11 +11,7 @@
 import { NextResponse } from "next/server.js";
 import { getProviders } from "../../../../contracts/index.js";
 import { normalizeError } from "../../../../errors/normalize.js";
-function numParam(url, key, fallback) {
-    const v = url.searchParams.get(key);
-    const n = v !== null ? Number(v) : NaN;
-    return Number.isFinite(n) ? n : fallback;
-}
+import { numParam } from "../../../../utils/search-params.js";
 export async function GET(request) {
     try {
         const url = new URL(request.url);

package/dist/features/pre-orders/components/PreOrderDetailPageView.js

@@ -14,7 +14,7 @@ const CLS_STATUS_BADGE = "inline-block rounded-full bg-warning-surface dark:bg-w
 import { ROUTES } from "../../../next/routing/route-map.js";
 import { getDefaultCurrency } from "../../../core/baseline-resolver.js";
 import { formatCurrency, roundRupees } from "../../../utils/number.formatter.js";
-import { normalizeRichTextHtml } from "../../../utils/string.formatter.js";
+import { toDescriptionHtml } from "../../../utils/string.formatter.js";
 import { safeDisplayName } from "../../../security/index.js";
 import { ProgressBarFill } from "../../../ui/components/ProgressBarFill.js";
 import { Button, Container, Div, GatedPrice, PricesOnly, Heading, Main, Nav, RichText, Row, Section, Span, Stack, Text, Ul, Li, SpecTable, } from "../../../ui/index.js";
@@ -38,12 +38,6 @@ import { GroupedListingsCarousel } from "../../grouped/components/GroupedListing
 import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data.js";
 import { OwnerQuickActions } from "../../admin/components/OwnerQuickActions.js";
 import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
-function toDescriptionHtml(raw) {
-    if (!raw)
-        return "";
-    const s = typeof raw === "string" ? raw : JSON.stringify(raw);
-    return normalizeRichTextHtml(s);
-}
 const PRODUCTION_STATUS_LABELS = {
     upcoming: "Coming Soon",
     in_production: "In Production",

package/dist/features/products/api/route.js

@@ -22,6 +22,7 @@ import { printMetaSchema } from "../schemas/index.js";
 import { sanitizeProductsForPublic } from "../utils/sanitize.js";
 import { listPublicProducts, parsePublicProductParams, } from "../../../_internal/server/features/products/list-public.js";
 import { normalizeError } from "../../../errors/normalize.js";
+import { param } from "../../../utils/search-params.js";
 // --- Mutation schemas ---------------------------------------------------------
 // Minimal schemas for secured mutations — consumer apps can extend as needed.
 const productMutateSchema = z
@@ -72,9 +73,6 @@ const productMutateSchema = z
 })
     .passthrough();
 // --- Helpers ------------------------------------------------------------------
-function param(url, key) {
-    return url.searchParams.get(key);
-}
 // --- GET /api/products --------------------------------------------------------
 /**
  * Delegates to `listPublicProducts` — the single implementation shared with

package/dist/features/products/components/CustomSectionTabContent.js

@@ -1,11 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { RichText, SpecTable, Stack, Text } from "../../../ui/index.js";
 import { normalizeRichTextHtml } from "../../../utils/string.formatter.js";
-function renderFieldValue(f) {
-    if (f.type === "boolean")
-        return f.value === "true" ? "Yes" : "No";
-    return f.value + (f.unit ? ` ${f.unit}` : "");
-}
 /**
  * `customSections` → `ProductTabsShell`'s `customTabs` prop, in one place.
  *

package/dist/features/products/components/GroupMemberPicker.js

@@ -18,7 +18,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * consumer pages untouched.
  */
 import { useMemo, useState } from "react";
-import { Alert, Button, Div, GatedPrice, PricesOnly, Row, Span, Stack, Table, Tbody, Td, Text, Th, Thead, Tr, } from "../../../ui/index.js";
+import { Alert, Button, Div, GatedPrice, PricesOnly, Row, Span, Stack, Table, Tbody, Td, Text, Th, Thead, Tr, TextLink, } from "../../../ui/index.js";
 import { QuantityStepper } from "../../../ui/components/QuantityStepper.js";
 import { MediaImage } from "../../media/MediaImage.js";
 import { formatCurrency } from "../../../utils/number.formatter.js";
@@ -140,7 +140,7 @@ export function GroupMemberPicker({ groupId, groupSource, members, rules = EMPTY
                                                  * A made-to-order member has no ceiling; the line's
                                                  * own 99-per-line cap still applies at the cart.
                                                  */
-                                                max: m.madeToOrder === true ? undefined : m.availableQuantity, ariaLabel: `Quantity for ${m.title}`, decrementLabel: ACTIONS.CART["decrease-quantity"].ariaLabel, incrementLabel: ACTIONS.CART["increase-quantity"].ariaLabel })) })), _jsx(Td, { padding: "xs-tall", children: _jsx("a", { href: memberHref(m), className: "text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-primary)] hover:underline", children: "View \u2192" }) })] }, m.id));
+                                                max: m.madeToOrder === true ? undefined : m.availableQuantity, ariaLabel: `Quantity for ${m.title}`, decrementLabel: ACTIONS.CART["decrease-quantity"].ariaLabel, incrementLabel: ACTIONS.CART["increase-quantity"].ariaLabel })) })), _jsx(Td, { padding: "xs-tall", children: _jsx(TextLink, { href: memberHref(m), size: "xs", className: "text-[var(--appkit-color-primary)] hover:underline", children: "View \u2192" }) })] }, m.id));
                             }) })] }) }), !isCrossStore && (_jsxs(_Fragment, { children: [ruleNotes.length > 0 && (_jsx(Text, { size: "xs", color: "muted", children: ruleNotes.join(" · ") })), error && _jsx(Alert, { variant: "error", children: error }), selectedUnits > 0 && violations.length > 0 && (_jsx(Alert, { variant: "warning", children: _jsx(Stack, { gap: "dense", children: violations.map((v) => (_jsx(Text, { size: "sm", children: v.message }, v.code + v.message))) }) })), _jsxs(Row, { justify: "between", align: "center", gap: "sm", className: "min-w-0", children: [_jsxs(Text, { size: "sm", color: "muted", children: [selectedUnits > 0
                                         ? `${selectedUnits} item${selectedUnits === 1 ? "" : "s"}`
                                         : "Nothing selected yet", selectedUnits > 0 && (_jsx(PricesOnly, { children: discountPercent > 0

package/dist/features/products/components/GroupSettingsPanel.js

@@ -359,7 +359,7 @@ export function GroupSettingsPanel({ productId, productSlug, groupId, isGroupPar
                 return (groupChildSlugs?.length ?? 0) >= 4 ? (_jsx(SideDrawer, { isOpen: showAddModal, onClose: close, title: "Add child listing", children: content })) : (_jsx(Modal, { open: showAddModal, onClose: close, title: "Add child listing", size: "lg", children: content }));
             })(), confirmAction && (_jsx(ConfirmDeleteModal, { isOpen: true, title: confirmAction.title, message: confirmAction.message, onConfirm: confirmAction.onConfirm, onClose: () => setConfirmAction(null), isDeleting: loading }))] }));
 }
-function AddChildContent({ addTab, setAddTab, createForm, setCreateForm, productSlug, storeProductsEndpoint, linkTargets, setLinkTargets, onAddCreate, onAddLink, loading, }) {
+function AddChildContent({ addTab, setAddTab, createForm, setCreateForm, storeProductsEndpoint, linkTargets, setLinkTargets, onAddCreate, onAddLink, loading, }) {
     const sections = React.useMemo(() => buildSectionsFromSchema(createChildSchema, {
         options: { condition: CONDITION_OPTIONS },
     }), []);

package/dist/features/products/components/PrizeDrawDetailPageView.js

@@ -9,7 +9,7 @@ const __P = {
 const CLS_PRIZE_BADGE = "inline-block rounded-full bg-fuchsia-100 dark:bg-fuchsia-900/30 px-[var(--appkit-space-2-5)] py-[var(--appkit-space-0-5)] text-fuchsia-700 dark:text-fuchsia-300";
 import { ROUTES } from "../../../next/routing/route-map.js";
 import { getDefaultCurrency } from "../../../core/baseline-resolver.js";
-import { normalizeRichTextHtml } from "../../../utils/string.formatter.js";
+import { toDescriptionHtml } from "../../../utils/string.formatter.js";
 import { safeDisplayName } from "../../../security/index.js";
 import { Container, Disclaimer, Div, Heading, Main, RichText, Row, Section, Span, Stack, Text, } from "../../../ui/index.js";
 import { PreOrderDetailView } from "./PreOrderDetailView.js";
@@ -24,12 +24,6 @@ import { computeRelatedItems } from "../../../_internal/server/features/products
 import { GroupedListingsCarousel } from "../../grouped/components/GroupedListingsCarousel.js";
 import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data.js";
 import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
-function toDescriptionHtml(raw) {
-    if (!raw)
-        return "";
-    const s = typeof raw === "string" ? raw : JSON.stringify(raw);
-    return normalizeRichTextHtml(s);
-}
 function statusLabel(s) {
     switch (s) {
         case "open":

package/dist/features/products/components/PrizeDrawEntryActions.d.ts

@@ -29,4 +29,4 @@ export interface PrizeDrawEntryActionsProps {
  * the rule's preflight already checks `prizeMaxEntries`. The whole server half
  * was written and unreachable because the client never sent a quantity.
  */
-export declare function PrizeDrawEntryActions({ productId, productSlug, title, pricePerEntry, currency, remainingEntries, revealStatus, prizeGithubFileUrl, }: PrizeDrawEntryActionsProps): import("react").JSX.Element;
+export declare function PrizeDrawEntryActions({ productId, title, pricePerEntry, currency, remainingEntries, revealStatus, prizeGithubFileUrl, }: PrizeDrawEntryActionsProps): import("react").JSX.Element;

package/dist/features/products/components/PrizeDrawEntryActions.js

@@ -34,7 +34,7 @@ import { toUserMessage } from "../../../errors/error-display-map.js";
  * the rule's preflight already checks `prizeMaxEntries`. The whole server half
  * was written and unreachable because the client never sent a quantity.
  */
-export function PrizeDrawEntryActions({ productId, productSlug, title, pricePerEntry, currency, remainingEntries, revealStatus, prizeGithubFileUrl, }) {
+export function PrizeDrawEntryActions({ productId, title, pricePerEntry, currency, remainingEntries, revealStatus, prizeGithubFileUrl, }) {
     const router = useRouter();
     const { requireAuth, isAuthResolving, modalOpen, modalMessage, closeModal } = useAuthGate();
     const [consentOpen, setConsentOpen] = useState(false);

package/dist/features/products/components/ProductDetailPageView.js

@@ -34,7 +34,7 @@ import { getDefaultCurrency } from "../../../core/baseline-resolver.js";
 import { RecordOwnerQuickActions } from "../../admin/components/RecordOwnerQuickActions.js";
 import { PurchaseReviewAffordance } from "../../reviews/components/PurchaseReviewAffordance.js";
 import { Button, Container, Div, Heading, Main, PriceDisplay, RichText, Row, Section, Span, Stack, Text, Ul, Ol, Li, SpecTable, Icon, } from "../../../ui/index.js";
-import { normalizeRichTextHtml } from "../../../utils/string.formatter.js";
+import { toDescriptionHtml } from "../../../utils/string.formatter.js";
 import { safeDisplayName } from "../../../security/index.js";
 import { ReviewsListingPanel } from "../../reviews/components/ReviewsListingPanel.js";
 import { ProductDetailView } from "./ProductDetailView.js";
@@ -61,12 +61,6 @@ import { DEFAULT_MIN_OFFER_PERCENT, resolveOfferBounds, } from "../../../_intern
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-function toDescriptionHtml(raw) {
-    if (!raw)
-        return "";
-    const s = typeof raw === "string" ? raw : JSON.stringify(raw);
-    return normalizeRichTextHtml(s);
-}
 function StarRating({ value }) {
     const full = Math.floor(value);
     const half = value - full >= 0.5;

package/dist/features/products/repository/products.repository.js

@@ -343,7 +343,6 @@ export class ProductRepository extends BaseRepository {
          * derived one is the one that goes stale.
          */
         const assignments = readAssignments(input);
-        const leaf = assignments[0] ?? null;
         /*
          * The brand selector's option value is the brand ROW's id (`brand-beyblade`),
          * but `ProductDocument.brand` is matched by DISPLAY NAME —

package/dist/features/promotions/api/route.js

@@ -20,14 +20,7 @@
 import { NextResponse } from "next/server.js";
 import { getProviders } from "../../../contracts/index.js";
 import { normalizeError } from "../../../errors/normalize.js";
-function param(url, key) {
-    return url.searchParams.get(key);
-}
-function numParam(url, key, fallback) {
-    const v = url.searchParams.get(key);
-    const n = v !== null ? Number(v) : NaN;
-    return Number.isFinite(n) ? n : fallback;
-}
+import { numParam, param } from "../../../utils/search-params.js";
 // --- GET /api/promotions ------------------------------------------------------
 // Query params:
 //   isActive  — "true" | "false" (default: "true")

package/dist/features/reviews/components/ReviewsIndexPageView.d.ts

@@ -1,7 +1,6 @@
 import React from "react";
-type SearchParams = Record<string, string | string[]>;
+import type { SearchParamsRecord } from "../../../utils/search-params";
 export interface ReviewsIndexPageViewProps {
-    searchParams?: SearchParams;
+    searchParams?: SearchParamsRecord;
 }
 export declare function ReviewsIndexPageView({ searchParams }: ReviewsIndexPageViewProps): Promise<React.JSX.Element>;
-export {};

package/dist/features/reviews/components/ReviewsIndexPageView.js

@@ -5,13 +5,10 @@ import { Container, Heading, Main, Section } from "../../../ui/index.js";
 import { AdSlot } from "../../homepage/components/AdSlot.js";
 import { ReviewsIndexListing } from "./ReviewsIndexListing.js";
 import { safeRead } from "../../../errors/safe-read.js";
-function sp(params, key) {
-    const v = params[key];
-    return Array.isArray(v) ? v[0] ?? "" : v ?? "";
-}
+import { firstParam } from "../../../utils/search-params.js";
 function buildReviewFilters(params) {
     const parts = ["status==approved"];
-    const rating = sp(params, "rating");
+    const rating = firstParam(params, "rating");
     if (rating) {
         const values = rating.split("|").filter(Boolean);
         if (values.length === 1)
@@ -19,14 +16,14 @@ function buildReviewFilters(params) {
         else if (values.length > 1)
             parts.push(sieveFilter("rating", SIEVE_OP.EQ, values.join("|")));
     }
-    const minVotes = sp(params, "minVotes");
+    const minVotes = firstParam(params, "minVotes");
     if (minVotes)
         parts.push(sieveFilter("helpfulCount", SIEVE_OP.GTE, minVotes));
-    const maxVotes = sp(params, "maxVotes");
+    const maxVotes = firstParam(params, "maxVotes");
     if (maxVotes)
         parts.push(sieveFilter("helpfulCount", SIEVE_OP.LTE, maxVotes));
-    const dateFrom = sp(params, "dateFrom");
-    const dateTo = sp(params, "dateTo");
+    const dateFrom = firstParam(params, "dateFrom");
+    const dateTo = firstParam(params, "dateTo");
     if (dateFrom)
         parts.push(sieveFilter("createdAt", SIEVE_OP.GTE, dateFrom));
     if (dateTo)
@@ -53,10 +50,10 @@ function buildReviewFilters(params) {
     return parts.join(",");
 }
 export async function ReviewsIndexPageView({ searchParams = {} }) {
-    const sort = sp(searchParams, "sort") || "-createdAt";
-    const page = Number(sp(searchParams, "page")) || 1;
+    const sort = firstParam(searchParams, "sort") || "-createdAt";
+    const page = Number(firstParam(searchParams, "page")) || 1;
     const filters = buildReviewFilters(searchParams);
-    const q = sp(searchParams, "q");
+    const q = firstParam(searchParams, "q");
     // audit-public-test-data-ok: `ReviewDocument` carries no `isTestData` field —
     // tsc rejects the filter outright, which is the honest signal that reviews
     // have no sandbox concept to strip. A review OF a sandbox product is not

package/dist/features/seller/api/coupons/route.js

@@ -15,11 +15,7 @@
 import { NextResponse } from "next/server.js";
 import { getProviders } from "../../../../contracts/index.js";
 import { createRouteHandler } from "../../../../next/api/routeHandler.js";
-function numParam(url, key, fallback) {
-    const v = url.searchParams.get(key);
-    const n = v !== null ? Number(v) : NaN;
-    return Number.isFinite(n) ? n : fallback;
-}
+import { numParam } from "../../../../utils/search-params.js";
 export const GET = createRouteHandler({
     roles: ["seller", "admin", "moderator"],
     handler: async ({ request, user }) => {

package/dist/features/seller/api/products/route.js

@@ -16,11 +16,7 @@ import { NextResponse } from "next/server.js";
 import { getProviders } from "../../../../contracts/index.js";
 import { createRouteHandler } from "../../../../next/api/routeHandler.js";
 import { storeRepository } from "../../../stores/repository/store.repository.js";
-function numParam(url, key, fallback) {
-    const v = url.searchParams.get(key);
-    const n = v !== null ? Number(v) : NaN;
-    return Number.isFinite(n) ? n : fallback;
-}
+import { numParam } from "../../../../utils/search-params.js";
 export const GET = createRouteHandler({
     roles: ["seller", "admin", "moderator"],
     handler: async ({ request, user }) => {

package/dist/features/seller/components/SellerProductShell.js

@@ -544,7 +544,6 @@ productId, onSave, onPublish, onDiscard, isLoading = false, storeSlug, renderCat
     useFormShellState(sellerProductSchema, undefined, {
         allowAddAnother: mode === "create",
     });
-    const [stepError, setStepError] = useState(null);
     const { isDirty, markDirty, markClean } = useFormShell();
     const router = useRouter();
     const { showToast } = useToast();
@@ -859,7 +858,7 @@ productId, onSave, onPublish, onDiscard, isLoading = false, storeSlug, renderCat
                     }) }) }) }));
     }
     if (mode === "create") {
-        return (_jsx(FormShell, { isOpen: true, onClose: handleDiscard, title: title, breadcrumb: breadcrumb, isDirty: isDirty, isLoading: isLoading, previewSlot: previewSlot, splitPreview: !!previewSlot, renderBottomBar: () => (_jsxs(Div, { className: "flex-shrink-0 border-t border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", children: [_jsx(FormShellContext.Provider, { value: shellCtx, children: _jsx(Div, { paddingX: "x-5", padding: "y-sm", children: _jsx(FormErrorSummary, {}) }) }), _jsxs(Div, { paddingX: "x-5", padding: "b-sm", children: [_jsx(FormShellContext.Provider, { value: shellCtx, children: _jsx(AddAnotherToggle, { noun: listingTypeLabel.toLowerCase(), isCreate: mode === "create" }) }), _jsxs(Row, { gap: "sm", justify: "between", wrap: true, children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: () => void handleSave(), disabled: isLoading || !draft.title?.trim(), children: "Save as draft & finish later" }), _jsx(Button, { variant: "primary", onClick: () => void handlePublish(), isLoading: isLoading, disabled: isLoading, children: addAnotherSubmitLabel(`Publish ${listingTypeLabel}`, addAnother) })] })] }), stepError && (_jsx(Text, { className: "text-[var(--appkit-color-error)] px-[1.25rem] pb-[0.75rem]", size: "sm", children: stepError }))] })), children: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsx(SectionForm, { sections: sections, values: draft, onChange: update, onSubmit: handlePublish, schema: sellerProductSchema, openIds: openIds, onOpenChange: setOpenIds, isLoading: isLoading, hideActions: true }) }) }));
+        return (_jsx(FormShell, { isOpen: true, onClose: handleDiscard, title: title, breadcrumb: breadcrumb, isDirty: isDirty, isLoading: isLoading, previewSlot: previewSlot, splitPreview: !!previewSlot, renderBottomBar: () => (_jsxs(Div, { className: "flex-shrink-0 border-t border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", children: [_jsx(FormShellContext.Provider, { value: shellCtx, children: _jsx(Div, { paddingX: "x-5", padding: "y-sm", children: _jsx(FormErrorSummary, {}) }) }), _jsxs(Div, { paddingX: "x-5", padding: "b-sm", children: [_jsx(FormShellContext.Provider, { value: shellCtx, children: _jsx(AddAnotherToggle, { noun: listingTypeLabel.toLowerCase(), isCreate: mode === "create" }) }), _jsxs(Row, { gap: "sm", justify: "between", wrap: true, children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: () => void handleSave(), disabled: isLoading || !draft.title?.trim(), children: "Save as draft & finish later" }), _jsx(Button, { variant: "primary", onClick: () => void handlePublish(), isLoading: isLoading, disabled: isLoading, children: addAnotherSubmitLabel(`Publish ${listingTypeLabel}`, addAnother) })] })] })] })), children: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsx(SectionForm, { sections: sections, values: draft, onChange: update, onSubmit: handlePublish, schema: sellerProductSchema, openIds: openIds, onOpenChange: setOpenIds, isLoading: isLoading, hideActions: true }) }) }));
     }
     // Edit mode — FormShell with section nav + full form
     const editSections = [