@mohasinac/appkit 4.53.1 → 4.54.0-next.0

package/dist/features/seller/hooks/useStoreListingEntitlements.js

@@ -0,0 +1,70 @@
+"use client";
+/**
+ * Which listing types the signed-in seller's own store may create.
+ *
+ * ── Why this needs a fetch at all ─────────────────────────────────────────
+ *
+ * 🛑 `StoreDocument.capabilities` is listed in `PRIVATE_STORE_FIELDS` —
+ * "internal feature gating; server-enforced, never client-read" — so it is
+ * absent from every public store payload and from the session user. A client
+ * component genuinely cannot derive this locally, and the alternative a
+ * previous draft reached for (publish the capability array to the browser)
+ * would ship `lower_commission_rate`, `priority_support` and fifteen more
+ * admin-granted entitlements to anyone who opened devtools. Root Cause #70.
+ *
+ * So the server sends a PROJECTION: `allowedListingTypes`, already resolved by
+ * `listingTypesAllowedFor` on the same capability array the write-path gate
+ * uses. Client and server therefore agree by construction rather than by two
+ * copies of one rule (Root Cause #30).
+ *
+ * ── Why the loading state is not "denied" ─────────────────────────────────
+ *
+ * `isLoading` is returned and callers must respect it. The three-state rule
+ * from `useCanSeePrices`: "not known yet" rendering as "no" shows an entitled
+ * seller a refusal on every page load. The server refuses authoritatively in
+ * `createSellerProduct` / `sellerUpdateProduct`, so an optimistic render while
+ * the fetch is in flight costs nothing worse than a late refusal.
+ *
+ * @tag domain:seller
+ * @tag layer:hooks
+ * @tag access:client
+ */
+import { useMemo } from "react";
+import { useApiQuery } from "../../../client/api/useApiQuery.js";
+import { apiClient } from "../../../http/index.js";
+import { SELLER_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { BASIC_LISTING_TYPES } from "../../../_internal/shared/listing-types/tiers.js";
+export function useStoreListingEntitlements() {
+    const query = useApiQuery({
+        queryKey: ["store", "listing-entitlements"],
+        queryFn: async () => {
+            const res = await apiClient.get(SELLER_ENDPOINTS.PAYOUT_SETTINGS);
+            return res?.data ?? {};
+        },
+        /*
+         * The answer changes only when an admin or the seller flips a capability,
+         * so a short window is pointless churn — but it must not be `Infinity`,
+         * because a seller who has just ticked the box in another tab should not
+         * have to hard-reload to see the nav and forms open up.
+         */
+        staleTime: 60000,
+        silentBackgroundFailures: true,
+    });
+    return useMemo(() => {
+        /*
+         * 🛑 Falls back to the BASIC types, not to everything and not to nothing.
+         *
+         * Everything would offer a form that the server then refuses — the exact
+         * "filled in a long wizard and got rejected at publish" experience this
+         * hook exists to prevent. Nothing would lock a seller out of `standard`
+         * on a transient network blip, which is the one type every store has.
+         */
+        const list = query.data?.allowedListingTypes;
+        const allowed = new Set(Array.isArray(list) && list.length > 0 ? list : BASIC_LISTING_TYPES);
+        return {
+            allowed,
+            advancedEnabled: query.data?.advancedListingTypesEnabled === true,
+            isLoading: query.isLoading,
+        };
+    }, [query.data, query.isLoading]);
+}

package/dist/features/stores/components/InteractiveStoreCard.d.ts

@@ -12,5 +12,15 @@ export interface InteractiveStoreCardProps {
         visitStore?: string;
     };
     className?: string;
+    /**
+     * Owner-only pencil / clone / bin, for an admin or whoever owns this record.
+     * Pass `<OwnerQuickActions>`; it renders nothing for anyone else.
+     *
+     * 🛑 Rendered OUTSIDE this card's own `<Link>`/`<TextLink>`, as a sibling.
+     * A `<button>` inside an `<a>` is invalid HTML that browsers resolve by
+     * closing the anchor early, which breaks the CARD's navigation rather than
+     * just the button's — `stopPropagation` stops a click but cannot fix a parse.
+     */
+    renderOwnerActions?: () => React.ReactNode;
 }
-export declare function InteractiveStoreCard({ store, href, selectable, isSelected, onSelect, labels, className, }: InteractiveStoreCardProps): import("react").JSX.Element;
+export declare function InteractiveStoreCard({ store, href, selectable, isSelected, onSelect, labels, className, renderOwnerActions, }: InteractiveStoreCardProps): import("react").JSX.Element;

package/dist/features/stores/components/InteractiveStoreCard.js

@@ -10,13 +10,13 @@ const __O = {
     hidden: "overflow-hidden",
 };
 const CLS_RATING_BADGE = "absolute top-2 right-2 flex items-center gap-[var(--appkit-space-1)] rounded-full bg-black/50 backdrop-blur-sm px-[var(--appkit-space-2)] py-[var(--appkit-space-0-5)] text-[length:var(--appkit-text-xs)] font-semibold text-warning";
-export function InteractiveStoreCard({ store, href, selectable, isSelected = false, onSelect, labels = {}, className = "", }) {
+export function InteractiveStoreCard({ store, href, selectable, isSelected = false, onSelect, labels = {}, className = "", renderOwnerActions, }) {
     const initial = store.storeName[0]?.toUpperCase() ?? "S";
     const [logoBroken, setLogoBroken] = useState(false);
     const hasLogo = Boolean(store.storeLogoURL) && !logoBroken;
     const hasBanner = Boolean(store.storeBannerURL);
     const longPress = useLongPress(() => onSelect?.(store.id, !isSelected));
-    return (_jsxs(Div, { className: [
+    const card = (_jsxs(Div, { className: [
             "group relative flex flex-col h-full overflow-hidden rounded-xl border bg-[var(--appkit-color-surface)] shadow-sm transition-shadow hover:shadow-lg",
             isSelected
                 ? "border-[var(--appkit-color-primary,theme(colors.violet.600))] outline outline-2 outline-[var(--appkit-color-primary,theme(colors.violet.600))]"
@@ -26,4 +26,11 @@ export function InteractiveStoreCard({ store, href, selectable, isSelected = fal
                     e.preventDefault();
                     onSelect(store.id, !isSelected);
                 }, label: isSelected ? "Deselect store" : "Select store", position: "top-2 left-2", className: selectable || isSelected ? "opacity-100" : "opacity-0 pointer-events-none group-hover:opacity-100 group-hover:pointer-events-auto transition-opacity" })), _jsxs(Link, { href: href, className: "flex flex-col flex-1 min-h-0", children: [_jsxs(Div, { surface: "muted", className: `relative aspect-video w-full ${__O.hidden} flex-shrink-0`, children: [hasBanner ? (_jsx(MediaImage, { src: store.storeBannerURL, alt: `${store.storeName} banner`, size: "banner", className: "h-full w-full object-cover transition-transform duration-500 group-hover:scale-105" })) : (_jsx(Row, { className: "absolute inset-0", align: "center", justify: "center", children: _jsx(Span, { className: "opacity-20 select-none", size: "5xl", "aria-hidden": "true", children: "\uD83C\uDFEA" }) })), _jsx(Scrim, { direction: "bottom-up", intensity: "subtle", className: "absolute inset-x-0 bottom-0 h-12" }), store.averageRating != null && store.averageRating > 0 && (_jsxs(Div, { className: CLS_RATING_BADGE, children: ["\u2605 ", store.averageRating.toFixed(1)] }))] }), _jsxs(Stack, { paddingY: "b-md", className: "flex-1", padding: "x-md", children: [_jsx(Row, { className: "-mt-5 mb-2", align: "end", justify: "between", children: _jsx(Div, { className: "flex-shrink-0", children: hasLogo ? (_jsx(Div, { className: "relative h-10 w-10 border-2 border-[var(--appkit-color-border-subtle)] bg-[var(--appkit-color-surface)]", rounded: "lg", shadow: "md", overflow: "hidden", children: _jsx(MediaImage, { src: store.storeLogoURL, alt: store.storeName, size: "thumbnail", onError: () => setLogoBroken(true) }) })) : (_jsx(Row, { textWeight: "bold", textSize: "base", className: "h-10 w-10 border-2 border-white bg-primary/10 dark:bg-primary/20 text-primary", align: "center", justify: "center", rounded: "lg", shadow: "md", children: initial })) }) }), _jsx(Heading, { level: 3, className: `group-hover:text-primary transition-colors`, truncate: true, size: "sm", weight: "bold", color: "primary", children: store.storeName }), store.storeDescription ? (_jsx(RichText, { html: normalizeRichTextHtml(store.storeDescription), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "mt-1 line-clamp-2 text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)] flex-1" })) : (_jsx(Div, { className: "flex-1" })), _jsxs(Row, { color: "muted", textSize: "xs", gap: "sm", className: "mt-2.5", wrap: true, children: [store.totalProducts != null && store.totalProducts > 0 && (_jsxs(Span, { layout: "flex", gap: "2xs", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDCE6" }), " ", store.totalProducts, " ", labels.products ?? "products"] })), store.itemsSold != null && store.itemsSold > 0 && (_jsxs(Span, { layout: "flex", gap: "2xs", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDECD\uFE0F" }), " ", store.itemsSold, " ", labels.sold ?? "sold"] }))] }), _jsxs(Row, { border: "top-subtle", paddingY: "y-xs-tall", className: "mt-3", align: "center", justify: "between", children: [_jsxs(Span, { size: "xs", weight: "semibold", className: "text-primary group-hover:underline transition-colors", children: [labels.visitStore ?? "Visit store", " \u2192"] }), store.totalReviews != null && store.totalReviews > 0 && (_jsxs(Span, { size: "xs", color: "muted", children: [store.totalReviews, " ", labels.reviews ?? "reviews"] }))] })] })] })] }));
+    if (!renderOwnerActions)
+        return card;
+    /*
+     * Sibling of the card, never a child — see the prop's docstring. `z-20`
+     * beats this card's own overlays, which all sit at `z-10`.
+     */
+    return (_jsxs(Div, { className: "relative h-full", children: [card, _jsx(Div, { className: "absolute right-2 bottom-2 z-20", children: renderOwnerActions() })] }));
 }

package/dist/features/stores/components/StoreAuctionsListing.js

@@ -16,6 +16,7 @@ import { AUCTION_PUBLIC_SORT_OPTIONS } from "../../products/constants/sieve.js";
 import { AvailabilityTabs } from "../../products/components/AvailabilityTabs.js";
 import { AVAILABILITY_VALUES } from "../../../constants/field-names.js";
 import { TABLE_KEYS } from "../../../constants/table-keys.js";
+import { productImageUrls } from "../../products/schemas/firestore.js";
 const STORE_AUCTION_TYPES = ["auction"];
 const __P = {
     p3: "p-[var(--appkit-space-3)]",
@@ -75,7 +76,7 @@ export function StoreAuctionsListing({ storeId, initialData }) {
         description: p.description,
         price: p.price ?? 0,
         currency: p.currency || getDefaultCurrency(),
-        mainImage: p.mainImage ?? p.images?.[0],
+        mainImage: p.mainImage || productImageUrls(p.images)[0],
         images: p.images,
         listingType: "auction",
         auctionEndDate: p.auctionEndDate,

package/dist/features/stores/components/index.d.ts

@@ -47,5 +47,3 @@ export { StoreCapabilitiesGuideView } from "./StoreCapabilitiesGuideView";
 export type { StoreCapabilitiesGuideViewProps } from "./StoreCapabilitiesGuideView";
 export { StoreSettingsGuideView } from "./StoreSettingsGuideView";
 export type { StoreSettingsGuideViewProps } from "./StoreSettingsGuideView";
-export { StoreWhatsAppGuideView } from "./StoreWhatsAppGuideView";
-export type { StoreWhatsAppGuideViewProps } from "./StoreWhatsAppGuideView";

package/dist/features/stores/components/index.js

@@ -20,4 +20,3 @@ export { StoreOrdersGuideView } from "./StoreOrdersGuideView.js";
 export { StoreFinanceGuideView } from "./StoreFinanceGuideView.js";
 export { StoreCapabilitiesGuideView } from "./StoreCapabilitiesGuideView.js";
 export { StoreSettingsGuideView } from "./StoreSettingsGuideView.js";
-export { StoreWhatsAppGuideView } from "./StoreWhatsAppGuideView.js";

package/dist/features/stores/schemas/index.d.ts

@@ -228,7 +228,7 @@ export declare const storeFirestoreSchema: z.ZodObject<{
         totalReviews: number;
         averageRating?: number | undefined;
     }>>;
-    capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
     customCommissionRate: z.ZodOptional<z.ZodNumber>;
     googleReviews: z.ZodOptional<z.ZodObject<{
         placeId: z.ZodString;

package/dist/features/stores/schemas/index.js

@@ -1,6 +1,7 @@
 export * from "./firestore.js";
 import { z } from "zod";
 import { StoreStatusValues } from "./firestore.js";
+import { ALL_STORE_CAPABILITIES } from "../../auth/permissions/constants.js";
 import { auditTimestampsShape, firestoreDateSchema, rupeesSchema } from "../../../schemas/firestore-helpers.js";
 // ─── Firestore document schema (W2) ───────────────────────────────────────────
 // Mirrors StoreDocument in ./firestore.ts. Registered into SCHEMAS.firestore.stores.
@@ -70,7 +71,15 @@ export const storeFirestoreSchema = z.object({
         averageRating: z.number().optional(),
     })
         .optional(),
-    capabilities: z.array(z.string()).optional(),
+    /*
+     * 🛑 A `z.enum`, not `z.array(z.string())`. Nothing used to check a stored
+     * capability against the union, so a typo saved successfully and the gate it
+     * was meant to open never opened — with no error anywhere, because an
+     * unrecognised capability is indistinguishable from an ungranted one.
+     */
+    capabilities: z
+        .array(z.enum(ALL_STORE_CAPABILITIES))
+        .optional(),
     customCommissionRate: z.number().min(0).max(100).optional(),
     googleReviews: z
         .object({

package/dist/features/tester/seed-data/authored/content-discovery__authenticity-checker.js

@@ -1,6 +1,6 @@
 /*
  * WHY: Authored six-part procedures for content-discovery/authenticity-checker.
- * WHAT: 16 cases, keyed by full checklist id.
+ * WHAT: 22 cases, keyed by full checklist id.
  *
  * 🛑 EVERY CASE IS WRITTEN AS BEFORE → AFTER, because this feature's whole
  * failure mode is a confident, plausible, wrong answer returned with HTTP 200. A
@@ -44,7 +44,7 @@ export const authored = {
         startPage: "/tools/authenticity",
         steps: [
             "Open /tools/authenticity signed out.",
-            "Confirm the LOOKUP FORM itself is there and usable — Model name, Code on the box, Brand, Generation, How it was sold, and a 'Check it' button.",
+            "Confirm the LOOKUP FORM itself is there and usable — 'Which bey is it?', 'Code on the box', a collapsed 'More details' holding the name-as-printed, brand, generation and how-it-was-sold fields, and a 'Check it' button.",
             "Confirm there is no sign-in card and no 'Sign in to run a lookup' text anywhere on the page.",
             "Enter A0813 as the code and submit, still signed out.",
             "Confirm a real assessment comes back rather than an error or a prompt to sign in.",
@@ -475,4 +475,116 @@ export const authoredTypeahead = {
         expectedUiState: "The result renders immediately. The network log shows no fetch to the search artifact or any /api/search* endpoint.",
         endResult: "Read-only; nothing persists.",
     },
+    /* ── The model picker and the per-model code list (2026-10-20) ──────────
+       * 🛑 The reported bug these exist for: typing "l drago" returned
+       * "Inconclusive — Nothing contradicts it, and nothing confirms it either",
+       * while the tool held 33 recorded box codes for Lightning L-Drago, 35 for
+       * Meteo and 27 for Destructor and had no way to reach any of them. Every
+       * table was keyed by CODE, so naming a bey could never surface them.
+       *
+       * So each case compares the answer against data the tool DEMONSTRABLY HAS.
+       * "Check the picker works" passes against the bug; "picking Lightning
+       * L-Drago must list its 33 codes" does not.
+       */
+    "checklist-content-discovery-authenticity-checker-model-picker-finds-l-drago": {
+        roles: ["guest"],
+        startPage: "/tools/authenticity",
+        steps: [
+            "Open /tools/authenticity.",
+            "Confirm the FIRST field is 'Which bey is it?' and is a searchable select, not a plain text box.",
+            "Open it and type: l drago",
+            "Confirm all three L-Drago releases are offered — Lightning L-Drago 100HF, Meteo L-Drago LW105LF and L-Drago Destructor F:S.",
+            "Confirm each offered row states how many box codes are on file for it.",
+            "Clear the search and type: pegasis",
+            "Confirm Storm Pegasus still appears, even though the list spells it Pegasus.",
+            "Answer no if 'l drago' offers nothing, or if the field is a free-text input with no list.",
+        ],
+        inputs: { search: "l drago" },
+        expectedBehaviour: "BEFORE: the first field was a free-text 'Model name'. Typing 'l drago' matched four releases, so the engine refused to pick one and returned an inconclusive verdict — correct, and useless, because the three L-Dragos it declined to choose between have 95 recorded box codes between them and the screen never said so. AFTER: the picker resolves exactly one bey, which is what unlocks the per-model code list. It searches aliases as well as labels, because Takara Tomy romanises the line Pegasis and Hasbro prints Pegasus — a label-only filter would find neither from the other.",
+        expectedUiState: "A searchable select labelled 'Which bey is it?' listing three L-Drago rows, each annotated with a box-code count. Beys with codes on file are offered before beys without.",
+        endResult: "Nothing is written. The picker only reads a bundled list.",
+    },
+    "checklist-content-discovery-authenticity-checker-picked-model-lists-its-box-codes": {
+        roles: ["guest"],
+        startPage: "/tools/authenticity",
+        steps: [
+            "Open /tools/authenticity.",
+            "In 'Which bey is it?', search for and pick: Lightning L-Drago 100HF",
+            "Leave 'Code on the box' EMPTY.",
+            "Press 'Check it'.",
+            "Read the verdict line, then look for a panel headed 'Box codes recorded for Lightning L-Drago 100HF'.",
+            "Count the codes it lists.",
+            "Answer no if the verdict is 'Inconclusive — Nothing contradicts it, and nothing confirms it either', or if no code list appears.",
+        ],
+        inputs: { modelSlug: "lightning-l-drago-100hf" },
+        expectedBehaviour: "BEFORE: naming this bey with no code produced 'Inconclusive — Nothing contradicts it, and nothing confirms it either' and a physical checklist. True, in that nothing had been checked — and it withheld the 33 box codes the tables record for this exact bey, which is the single most useful thing the tool holds and the one thing the user had asked for. AFTER: the verdict is 'I know this one. Now find the code stamped on the box.' — still not a judgement, because nothing has been checked, but with the next step named and the 33 codes listed to check against.",
+        expectedUiState: "Verdict badge 'Need a bit more', headline 'I know this one. Now find the code stamped on the box.', a caveat naming the count, and a panel listing 33 codes as badges. A link reading 'Everything we hold on Lightning L-Drago 100HF' points at the model's own category page.",
+        expectedData: { recordedCodes: 33 },
+        endResult: "Read-only.",
+    },
+    "checklist-content-discovery-authenticity-checker-picked-model-plus-its-own-code": {
+        roles: ["guest"],
+        startPage: "/tools/authenticity",
+        steps: [
+            "Pick 'Lightning L-Drago 100HF' in 'Which bey is it?'.",
+            "Enter A0910 in 'Code on the box' — a code recorded against this exact bey.",
+            "Press 'Check it' and read the verdict.",
+            "Expand 'How I got there' and find the row about the code.",
+            "Press 'Start over'. Pick Lightning L-Drago 100HF again, this time enter A0310 — a real code recorded against a DIFFERENT bey.",
+            "Read the verdict and expand the working-out again.",
+            "Answer no if the second case reads as a mismatch, a discrepancy, or anything implying the item is wrong.",
+        ],
+        inputs: { modelSlug: "lightning-l-drago-100hf", recordedCode: "A0910", otherBeyCode: "A0310" },
+        expectedBehaviour: "A0910 is in this bey's own list, so the check reads as agreement — the strongest thing the tool can say from data, and it still says so is not proof. A0310 is recorded, but on Earth Aquila: that is WEAK SUPPORT, not a mismatch, because a production date covers whatever was boxed that day. The distinction is the whole point. Reporting 'that code belongs to a different bey' as a discrepancy would manufacture suspicion out of how the tables are organised, and the panel highlights the code you entered inside the list so you can see where it sits.",
+        expectedUiState: "First run: 'Consistent with an original', and a row reading that the code is recorded on genuine boxes of this exact bey. Second run: still not adverse — a neutral row saying the code is recorded but not against this bey, with the phrase 'weak support rather than a mismatch'.",
+        endResult: "Read-only.",
+    },
+    "checklist-content-discovery-authenticity-checker-missing-code-is-not-an-accusation": {
+        roles: ["guest"],
+        startPage: "/tools/authenticity",
+        steps: [
+            "Pick 'Lightning L-Drago 100HF' in 'Which bey is it?'.",
+            "Enter Z9999 in 'Code on the box' — well-formed, and in none of the tables.",
+            "Press 'Check it'.",
+            "Read the verdict, the code panel and the working-out.",
+            "Answer no if any sentence implies the item is fake, counterfeit or a reproduction, or if the verdict is more severe than 'Inconclusive'.",
+        ],
+        inputs: { modelSlug: "lightning-l-drago-100hf", code: "Z9999" },
+        expectedBehaviour: "A code absent from a model's list means UNRECORDED, never wrong. These tables are what collectors photographed, not a manufacturing record: 38 of 221 canonical beys have any recorded code at all, new genuine codes turn up regularly, and counterfeiters print real codes anyway. The panel must say so where a user will actually read it, not only inside the collapsed working-out — the reading 'my code is not in the list, so it is fake' is the one this whole feature has to defend against.",
+        expectedUiState: "Verdict 'Inconclusive'. A neutral row reading 'Not among the 33 codes recorded for Lightning L-Drago 100HF' whose text says 'unrecorded, not wrong'. The code panel carries a line beginning 'A code missing from this list means unrecorded, not fake.'",
+        endResult: "Read-only.",
+    },
+    "checklist-content-discovery-authenticity-checker-working-out-is-collapsed-by-default": {
+        roles: ["guest"],
+        startPage: "/tools/authenticity",
+        steps: [
+            "Pick 'Lightning L-Drago 100HF' and enter A0910. Press 'Check it'.",
+            "WITHOUT expanding anything, confirm you can read the verdict badge, the headline, the caveat and the recorded-code list.",
+            "Confirm the reasoning is behind a single collapsed control reading 'How I got there — N checks'.",
+            "Expand it and confirm every individual check is still there, each with its own confidence chip.",
+            "Press 'Start over'. Now enter the code A0813 with no model picked — a code the sources record as a midfake batch.",
+            "Confirm the working-out is ALREADY OPEN this time, without being clicked.",
+            "Answer no if the reasoning is expanded by default on the clean run, or collapsed on the midfake run.",
+        ],
+        inputs: { modelSlug: "lightning-l-drago-100hf", cleanCode: "A0910", midfakeCode: "A0813" },
+        expectedBehaviour: "BEFORE: every check rendered expanded under a 'What I checked' heading — up to eleven rows of reasoning between the buyer and the answer they asked for. AFTER: it is collapsed, not deleted, because 'why should I believe this' has to stay one tap away for a tool whose entire posture is that it hedges and cites. A CONCERN forces it open: the one case where the reasoning IS the answer is the case where something is wrong, and the user who never expands it must not be the user who never finds out.",
+        expectedUiState: "Clean run: verdict block, code panel, a collapsed 'How I got there — N checks', then the physical checks. Midfake run: the same control, already open.",
+        endResult: "Read-only.",
+    },
+    "checklist-content-discovery-authenticity-checker-result-scrolls-into-view": {
+        roles: ["guest"],
+        startPage: "/tools/authenticity",
+        steps: [
+            "Resize the browser to a phone viewport (about 390 x 740) or use device emulation.",
+            "Pick 'Lightning L-Drago 100HF' and enter A0910.",
+            "Scroll so the 'Check it' button is visible, and note what is on screen.",
+            "Press 'Check it'.",
+            "Without scrolling yourself, confirm the verdict badge and headline are now on screen.",
+            "Answer no if the page does not move and the verdict is below the fold.",
+        ],
+        inputs: { viewport: "390x740", modelSlug: "lightning-l-drago-100hf", code: "A0910" },
+        expectedBehaviour: "BEFORE: the form is taller than a phone viewport, so the answer rendered below the fold and pressing 'Check it' looked like it had done nothing — at the one moment this tool must not be ambiguous. AFTER: the result is scrolled into view on every fresh assessment, including the re-run a clarifying question triggers, and anchored at the top of the viewport rather than the middle so the badge and headline land where the eye already is.",
+        expectedUiState: "After submitting, the verdict badge and headline are visible without manual scrolling.",
+        endResult: "Read-only.",
+    },
 };