@mohasinac/appkit 4.45.0 → 4.46.0

package/dist/features/search/components/SearchResultsPageView.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Section, Container, Stack, Row, Div, Heading, Text, Span, TextLink } from "../../../ui/index.js";
+export function SearchResultsPageView({ result, renderSearchInput, }) {
+    const { q, terms, groups, totalHits } = result;
+    const hasQuery = q.trim().length > 0;
+    /*
+     * 🛑 THREE states, not two, and the middle one is the honest part.
+     *
+     *   no query          — prompt, no claim about results
+     *   query, 0 terms    — the query normalised away ("!!!", "—"). Saying
+     *                       "no results for !!!" implies we looked; we could
+     *                       not. A2's bug was the inverse of this: a
+     *                       punctuation-only query returned the ENTIRE
+     *                       published catalogue as search results.
+     *   query, 0 hits     — genuinely nothing matched
+     */
+    const normalisedAway = hasQuery && terms.length === 0;
+    return (_jsx(Section, { padding: "page", children: _jsx(Container, { children: _jsxs(Stack, { gap: "loose", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 1, children: hasQuery ? `Search: ${q}` : "Search" }), hasQuery && !normalisedAway && (_jsx(Text, { color: "muted", size: "sm", children: totalHits === 0
+                                    ? "Nothing matched."
+                                    : `${totalHits}${groups.some((g) => g.truncated) ? "+" : ""} result${totalHits === 1 ? "" : "s"} across ${groups.length} section${groups.length === 1 ? "" : "s"}.` }))] }), renderSearchInput?.(), !hasQuery && (_jsx(Text, { color: "muted", children: "Search listings, categories, brands, stores, articles and help pages at once." })), normalisedAway && (_jsx(Text, { color: "muted", children: "That search had no searchable words in it. Try a product, part or category name." })), groups.map((group) => (_jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { justify: "between", align: "center", wrap: true, gap: "sm", children: [_jsxs(Heading, { level: 2, size: "lg", children: [group.label, group.truncated && (_jsxs(Span, { size: "sm", color: "muted", children: [" ", "(", group.hits.length, "+)"] }))] }), _jsxs(TextLink, { href: group.moreHref, children: ["See all ", group.label.toLowerCase(), " \u2192"] })] }), _jsx(Stack, { gap: "xs", children: group.hits.map((hit) => (_jsxs(Div, { surface: "card", padding: "sm", rounded: "md", children: [_jsx(TextLink, { href: hit.href, children: hit.title }), hit.detail && (_jsx(Text, { size: "xs", color: "muted", children: hit.detail }))] }, `${group.key}-${hit.id}`))) })] }, group.key))), hasQuery && !normalisedAway && totalHits === 0 && (_jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { color: "muted", children: ["No listings, categories, brands, stores, articles or help pages matched \u201C", q, "\u201D."] }), _jsx(TextLink, { href: "/products", children: "Browse all listings \u2192" })] }))] }) }) }));
+}

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

@@ -2,6 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { formatPhysicalLocation } from "../../../utils/physical-location.js";
 import { normalizeError } from "../../../errors/normalize.js";
+import { trackError, ErrorCategory, ErrorSeverity, } from "../../../monitoring/error-tracking.js";
 import { toUserMessage } from "../../../errors/error-display-map.js";
 import { SIEVE_OP, Stack, sieveFilter } from "@mohasinac/appkit/client";
 import { LOW_STOCK_THRESHOLD } from "../../store-extensions/constants/alert-metrics.js";
@@ -9,7 +10,7 @@ import { sortBy } from "@mohasinac/appkit/client";
 import { useState, useCallback } from "react";
 import { useEntityDelete } from "../../../react/hooks/useEntityDelete.js";
 import { useActionDispatch } from "../../../react/hooks/use-action-dispatch.js";
-import { Eye, EyeOff, Pencil, Trash2, Printer, MapPin, Boxes } from "lucide-react";
+import { Eye, EyeOff, Pencil, Trash2, Printer, MapPin, Boxes, Wrench, Scissors } from "lucide-react";
 import { PhysicalLocationModal } from "./PhysicalLocationModal.js";
 import { BulkStockModal } from "./BulkStockModal.js";
 import { useUrlTable } from "../../../react/hooks/useUrlTable.js";
@@ -30,6 +31,7 @@ import { SellerProductsCards } from "./SellerProductsCards.js";
 import { SellerProductsFilterFields } from "./SellerProductsFilterDrawer.js";
 import { listingBadgeVariant } from "../../products/utils/listing-badge-variant.js";
 import { DataListingView } from "../../admin/components/DataListingView.js";
+import { AssemblyDrawer, } from "../../parts/components/AssemblyDrawer.js";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry.js";
 import { buildBulkAction } from "../../../_internal/shared/actions/bulk-helpers.js";
 const FILTER_KEYS = [
@@ -148,6 +150,29 @@ const PRODUCT_COLUMNS = [
      * Both stock fields have been `canFilter`/`canSort` at the repository layer
      * the whole time; only the view omitted them.
      */
+    /*
+     * D8 — views, which were collected on ~30 surfaces and joined to NOTHING.
+     * A seller could not see how many people looked at their listing: the metric
+     * every competitor platform leads with.
+     *
+     * 🛑 Three states, and the middle one is the whole reason this is a column
+     * rather than a number in a subtitle. `undefined` means NOT YET ROLLED UP —
+     * the nightly pass has not run — and renders an em-dash; `0` means measured
+     * and nobody looked, and renders `0`. Collapsing them with `?? 0` is exactly
+     * what made the admin Top Products table show "0 views" on every row as
+     * though it were a measurement (A5).
+     */
+    {
+        key: "views",
+        header: "7d views",
+        className: "w-24 text-right",
+        render: (row) => {
+            if (typeof row.views7d !== "number") {
+                return _jsx(Span, { size: "xs", color: "faint", children: "\u2014" });
+            }
+            return (_jsx(Span, { size: "xs", color: row.views7d > 0 ? "primary" : "muted", numeric: true, children: row.views7d.toLocaleString() }));
+        },
+    },
     {
         key: "stock",
         header: "Stock",
@@ -227,6 +252,94 @@ export function SellerProductsView({ onDeleteProduct, onCreateClick, }) {
     const [setLocationOpen, setSetLocationOpen] = useState(false);
     const [selectedIdsForLocation, setSelectedIdsForLocation] = useState([]);
     const [setStockOpen, setSetStockOpen] = useState(false);
+    /*
+     * ── D13: assembly ──────────────────────────────────────────────────────
+     *
+     * 🛑 The drawer's data is fetched when it OPENS, not with the page. 50 part
+     * listings and a composition per row would be a read nobody asked for on a
+     * view that renders 50 rows — and the drawer is used on a handful of them.
+     */
+    const [assembleFor, setAssembleFor] = useState(null);
+    const [assembleData, setAssembleData] = useState(null);
+    const [assembleLoading, setAssembleLoading] = useState(false);
+    const openAssembly = useCallback(async (row, direction) => {
+        setAssembleFor({ id: row.id, title: row.primary ?? row.id, direction });
+        setAssembleData(null);
+        setAssembleLoading(true);
+        try {
+            const res = await fetch(SELLER_ENDPOINTS.PRODUCT_ASSEMBLE(row.id));
+            const body = (await res.json().catch(() => null));
+            if (!res.ok)
+                throw new Error(body?.error ?? "Could not load your parts");
+            setAssembleData({
+                compositions: body?.data?.compositions ?? [],
+                options: body?.data?.options ?? [],
+                targetAvailable: body?.data?.targetAvailable ?? 0,
+            });
+        }
+        catch (err) {
+            const e = normalizeError(err);
+            /*
+             * 🛑 Closed and reported, never left open and empty. An empty picker
+             * with no explanation is the state in which a seller concludes they
+             * hold no parts — which may be false.
+             */
+            setAssembleFor(null);
+            /*
+             * 🛑 AUTHORED copy, not `e.message`. Unlike the 409 (which carries
+             * `{needs, has}` and composes a sentence around the real figures),
+             * a load failure has no number worth surfacing — so this is one honest
+             * line, and the raw text goes to the recorder where it belongs.
+             */
+            showToast("Could not load your parts. Please try again.", "error");
+            trackError(e.message, ErrorCategory.API, ErrorSeverity.MEDIUM, {
+                component: "SellerProductsView",
+                action: "openAssembly",
+            });
+        }
+        finally {
+            setAssembleLoading(false);
+        }
+    }, [showToast]);
+    const submitAssembly = useCallback(async (input) => {
+        const id = assembleFor?.id;
+        if (!id)
+            throw new Error("No listing selected");
+        const res = await fetch(SELLER_ENDPOINTS.PRODUCT_ASSEMBLE(id), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(input),
+        });
+        const body = (await res.json().catch(() => null));
+        /*
+         * 🛑 THROWS with the server's own message, which the drawer renders. A
+         * 409 reads "Not enough available: needs 6, has 5" — the one sentence
+         * that tells the seller what to do. Swallowing it into a generic failure
+         * would turn "restock" into "retry".
+         */
+        if (!res.ok) {
+            /*
+             * 🛑 Carries the structured DETAIL to the drawer and never a rendered
+             * sentence. The drawer composes its own copy around `{needs, has}`;
+             * `message` here is for the recorder (Root Cause #86 —
+             * `audit-raw-error-text` blocks showing a thrown `.message`).
+             */
+            const err = new Error(body?.error ?? "assembly failed");
+            /*
+             * Typed rather than `unknown`: the 409's shape is OURS — the planner
+             * throws `{ kind, productId, needs, has }` — so declaring it is what
+             * lets the drawer compose a sentence around real figures instead of
+             * casting at the boundary (Root Cause #57/#70: a cast at a boundary is
+             * where this class of bug lives).
+             */
+            err.detail = { code: body?.code, ...(body?.details ?? {}) };
+            throw err;
+        }
+        return {
+            unitsBuilt: body?.data?.unitsBuilt ?? input.units,
+            consumed: body?.data?.consumed ?? [],
+        };
+    }, [assembleFor?.id]);
     const [selectedIdsForStock, setSelectedIdsForStock] = useState([]);
     const [stockBusy, setStockBusy] = useState(false);
     /*
@@ -472,6 +585,9 @@ export function SellerProductsView({ onDeleteProduct, onCreateClick, }) {
                     price: priceRaw ? `₹${priceRaw.toLocaleString("en-IN")}` : "—",
                     stock: stockLabel || "—",
                     stockValue,
+                    // Carried through ONLY when the document really has it — see the
+                    // field's own note on undefined-vs-zero.
+                    ...(typeof item.views7d === "number" ? { views7d: item.views7d } : {}),
                     physicalLocation: item.physicalLocation &&
                         typeof item.physicalLocation.zone === "string"
                         ? item.physicalLocation
@@ -524,8 +640,18 @@ export function SellerProductsView({ onDeleteProduct, onCreateClick, }) {
                 : `/products/${row.id}`,
         renderRowActions: (row) => {
             const isPublished = (statusOverrides.get(row.id) ?? row.status) === "published";
-            return (_jsxs(Row, { gap: "xs", children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); handleEdit(row); }, "aria-label": ACTIONS.STORE["edit-listing"].ariaLabel, children: _jsx(Pencil, { className: "w-4 h-4" }) }), _jsx(Button, { variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); void handleTogglePublish(row); }, "aria-label": isPublished ? "Unpublish" : "Publish", title: isPublished ? "Unpublish" : "Publish", disabled: publishingId === row.id, children: isPublished ? _jsx(EyeOff, { className: "w-4 h-4" }) : _jsx(Eye, { className: "w-4 h-4" }) }), _jsx(Button, { variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); void handleDuplicate(row); }, "aria-label": "Duplicate listing", title: "Duplicate", children: "\u29C9" }), onDeleteProduct && (_jsx(Button, { variant: "ghost", size: "sm", action: ACTIONS.STORE["delete-listing"], onClick: (e) => { e.stopPropagation(); void handleDelete(row); }, disabled: deletingId === row.id, className: "text-[var(--appkit-color-error)] hover:bg-[var(--appkit-color-border-subtle)]", children: _jsx(Trash2, { className: "w-4 h-4" }) }))] }));
+            return (_jsxs(Row, { gap: "xs", children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); handleEdit(row); }, "aria-label": ACTIONS.STORE["edit-listing"].ariaLabel, children: _jsx(Pencil, { className: "w-4 h-4" }) }), _jsx(Button, { variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); void openAssembly(row, "assemble"); }, "aria-label": ACTIONS.STORE["assemble-from-parts"].ariaLabel, title: ACTIONS.STORE["assemble-from-parts"].label, disabled: assembleLoading, children: _jsx(Wrench, { className: "w-4 h-4" }) }), _jsx(Button, { variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); void openAssembly(row, "part-out"); }, "aria-label": ACTIONS.STORE["part-out-listing"].ariaLabel, title: ACTIONS.STORE["part-out-listing"].label, disabled: assembleLoading, children: _jsx(Scissors, { className: "w-4 h-4" }) }), _jsx(Button, { variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); void handleTogglePublish(row); }, "aria-label": isPublished ? "Unpublish" : "Publish", title: isPublished ? "Unpublish" : "Publish", disabled: publishingId === row.id, children: isPublished ? _jsx(EyeOff, { className: "w-4 h-4" }) : _jsx(Eye, { className: "w-4 h-4" }) }), _jsx(Button, { variant: "ghost", size: "sm", onClick: (e) => { e.stopPropagation(); void handleDuplicate(row); }, "aria-label": "Duplicate listing", title: "Duplicate", children: "\u29C9" }), onDeleteProduct && (_jsx(Button, { variant: "ghost", size: "sm", action: ACTIONS.STORE["delete-listing"], onClick: (e) => { e.stopPropagation(); void handleDelete(row); }, disabled: deletingId === row.id, className: "text-[var(--appkit-color-error)] hover:bg-[var(--appkit-color-border-subtle)]", children: _jsx(Trash2, { className: "w-4 h-4" }) }))] }));
         },
     };
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), setLocationOpen && (_jsx(PhysicalLocationModal, { count: selectedIdsForLocation.length, onSave: (loc) => handleSetLocation(loc, selectedIdsForLocation), onClose: () => setSetLocationOpen(false) })), setStockOpen && (_jsx(BulkStockModal, { count: selectedIdsForStock.length, busy: stockBusy, onSave: (qty) => handleSetStock(qty, selectedIdsForStock), onClose: () => setSetStockOpen(false) }))] }));
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), setLocationOpen && (_jsx(PhysicalLocationModal, { count: selectedIdsForLocation.length, onSave: (loc) => handleSetLocation(loc, selectedIdsForLocation), onClose: () => setSetLocationOpen(false) })), setStockOpen && (_jsx(BulkStockModal, { count: selectedIdsForStock.length, busy: stockBusy, onSave: (qty) => handleSetStock(qty, selectedIdsForStock), onClose: () => setSetStockOpen(false) })), assembleFor && assembleData && (_jsx(AssemblyDrawer, { isOpen: true, 
+                /*
+                 * 🛑 No refetch on close, and that is a stated limitation rather than
+                 * a silent one: `DataListingView` owns the query and exposes no
+                 * refetch handle to a consumer. The drawer reports the real
+                 * before/after per component, so the seller SEES what moved — but the
+                 * row behind it still shows the pre-build figure until the next
+                 * navigation. Wiring a refetch means giving `ListingViewConfig` a
+                 * handle, which is a shared-surface change and its own commit.
+                 */
+                onClose: () => { setAssembleFor(null); setAssembleData(null); }, direction: assembleFor.direction, targetTitle: assembleFor.title, targetAvailable: assembleData.targetAvailable, compositions: assembleData.compositions, options: assembleData.options, onSubmit: submitAssembly }))] }));
 }

package/dist/features/tester/seed-data/authored/admin__site-system.js

@@ -424,21 +424,6 @@ export const authored = {
         expectedUiState: "The page renders logs, or a readable message naming what is unavailable. It does not show a stack trace, and it does not take the rest of the admin panel with it.",
         endResult: "Read-only; nothing persists.",
     },
-    "checklist-admin-site-system-copilot-admin": {
-        roles: ["admin"],
-        startPage: "/admin",
-        steps: [
-            "Sign in as admin@letitrip.in / TempPass123!.",
-            "Open /admin/copilot and read what it offers.",
-            "Read whether it states which model or provider it uses.",
-            "Submit a simple request and read the response.",
-            "Read whether any error surfaces a provider key or a raw response body.",
-            "Read whether the feature declines cleanly when unconfigured.",
-        ],
-        expectedBehaviour: "The feature works or declines cleanly, and never surfaces a provider credential or a raw upstream error to the browser. Every 5xx message is scrubbed before it reaches a client, with the real one kept server-side for the error recorder.",
-        expectedUiState: "A response renders, or a readable message names what is missing. No provider key, no raw upstream body, no stack trace.",
-        endResult: "Read-only; nothing persists.",
-    },
     "checklist-admin-site-system-team-admin": {
         roles: ["admin"],
         startPage: "/admin/team",

package/dist/features/tester/seed-data/authored/content-discovery__parts-database.d.ts

@@ -0,0 +1,2 @@
+import type { AuthoredCase } from "./_types";
+export declare const authored: Record<string, AuthoredCase>;

package/dist/features/tester/seed-data/authored/content-discovery__parts-database.js

@@ -0,0 +1,166 @@
+/*
+ * WHY: Authored six-part procedures for content-discovery/parts-database.
+ * WHAT: 9 cases, keyed by full checklist id.
+ *
+ * 🛑 EVERY CASE HERE IS WRITTEN AS BEFORE → AFTER, because every defect this
+ * feature has already produced returned HTTP 200 with plausible content. A case
+ * reading "check the parts page works" passes against all four of them:
+ *
+ *   1. `getCompositionsForCategory` first queried a `searchTxt` field that
+ *      `modelComposition` does not have. Zero rows, no error, an empty panel
+ *      that reads as "no composition recorded".
+ *   2. The composition `name` was a FILE PATH for all 259 rows, so the
+ *      category join matched 0 of 259 — and a model page with no panel is
+ *      indistinguishable from a model we have no data for.
+ *   3. Without the paren-stripped fallback the join reached only 150 of 259,
+ *      and HMS models in particular silently had no panel.
+ *   4. 🛑 The one live listing whose leaf has a composition is an ART POSTER,
+ *      so before `LISTING_TYPE_HAS_COMPOSITION` the only Parts tab in the
+ *      catalogue offered a poster an attack ring and a blade base — a correct
+ *      part list for the wrong kind of object.
+ *
+ * So each case below names what the WRONG answer looked like, and several
+ * compare two surfaces that must agree rather than checking that something
+ * rendered.
+ *
+ * @tag domain:tester
+ * @tag layer:seed
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:seed-data/authored/index.ts
+ * @tag sideEffects:none
+ */
+export const authored = {
+    "checklist-content-discovery-parts-database-index-lists-every-classification": {
+        roles: ["guest"],
+        startPage: "/parts",
+        steps: [
+            "Open /parts.",
+            "Count the classification tiles.",
+            "Confirm every tile reads as a part NAME in sentence case — 'Performance Tip', 'Fusion Wheel', 'Bit Chip' — and not as a URL slug like 'performance-tip' or 'bit-chip'.",
+            "Open any one tile and confirm it loads a page rather than 404ing.",
+        ],
+        expectedBehaviour: "BEFORE: there was no parts database at all, so a buyer reading '105RF' on a listing had nowhere to learn that 105 is a spin-track height and RF is a rubber flat tip. AFTER: 20 classifications, each a real page. The labels come from a compile-checked map rather than being title-cased from the slug, because 'Bit Chip' is not 'bit-chip' title-cased and 'Armour' is not 'armour'.",
+        expectedUiState: "Exactly 20 tiles, each labelled in sentence case, each a working link.",
+        expectedData: { classificationTiles: 20 },
+        endResult: "Nothing is changed; this case only reads.",
+    },
+    "checklist-content-discovery-parts-database-index-shows-no-fabricated-counts": {
+        roles: ["guest"],
+        startPage: "/parts",
+        steps: [
+            "Open /parts.",
+            "Look at each classification tile and confirm NO tile shows a number of parts.",
+            "Answer no if any tile shows a count, including a zero.",
+        ],
+        expectedBehaviour: "A per-classification count on this page would be 20 queries or a 753-document scan on a page that exists only to route — against a ~3-round-trip budget per render. The honest version of 'we are not going to pay for that number' is to not show a number, rather than to show a stale or a zero one.",
+        expectedUiState: "Tiles carry a label and a link, and no count.",
+        expectedData: { tileShowsCount: false },
+        endResult: "Nothing is changed; this case only reads.",
+    },
+    "checklist-content-discovery-parts-database-classification-page-lists-its-parts": {
+        roles: ["guest"],
+        startPage: "/parts",
+        steps: [
+            "Open /parts, then open the Performance Tip tile.",
+            "Read the count in the line under the heading.",
+            "Count the rows listed.",
+            "Confirm the rows are in alphabetical order by part name.",
+            "Confirm a part that has a recorded weight shows it as '(N g)' and a part with no recorded weight shows nothing in its place — not '0 g' and not an em-dash.",
+        ],
+        expectedBehaviour: "The count is a promise about the list directly beneath it, so the two must agree exactly. Only 98 of 753 parts carry a weight and only 23 carry a code; both are facts about our sources rather than missing data, so an absent one renders as nothing at all. A '0 g' would be a measurement we never took.",
+        expectedUiState: "The stated count equals the number of rows. Rows are alphabetical. Weights appear only where recorded.",
+        expectedData: { statedCountEqualsRowCount: true },
+        endResult: "Nothing is changed; this case only reads.",
+    },
+    "checklist-content-discovery-parts-database-unknown-classification-404s": {
+        roles: ["guest"],
+        startPage: "/parts",
+        steps: [
+            "Open /parts, then edit the address bar to /parts/zzzznope and load it.",
+            "Confirm you get a 404 page.",
+            "Then go back to /parts and open the Performance Tip tile as a positive control, and confirm it loads with rows.",
+            "Answer no if /parts/zzzznope renders an EMPTY classification page instead of 404ing.",
+        ],
+        expectedBehaviour: "BEFORE the guard existed, casting a URL segment to a slot type would have made this a perfectly successful query for a classification no document has: zero rows, HTTP 200, and a page reading 'No parts recorded in this classification yet' — which is a lie about our data rather than a statement about the URL. The positive control is what distinguishes a working 404 from a page that 404s on everything.",
+        expectedUiState: "/parts/zzzznope is a 404. /parts/performance-tip loads and lists parts.",
+        expectedData: { unknownSegment404s: true, knownSegmentLoads: true },
+        endResult: "Nothing is changed; this case only reads.",
+    },
+    "checklist-content-discovery-parts-database-part-page-shows-which-models-use-it": {
+        roles: ["guest"],
+        startPage: "/parts",
+        steps: [
+            "Open /parts, then open Disc, then open the part named Sting.",
+            "Read the 'Used by N models' heading.",
+            "Count the model rows beneath it.",
+            "Click one model row and confirm it opens that model's category page.",
+            "Confirm any model row that is NOT a link is still readable as plain text rather than rendering as a broken link.",
+        ],
+        expectedBehaviour: "'Which beys use this part' is the single most useful thing a part page says and the reason the glossary is a collection rather than a lookup table. 210 of 259 compositions joined to a category, so a model that did not join renders as plain text — a link to a page that does not exist is worse than no link.",
+        expectedUiState: "The heading count equals the number of rows. Linked models open their category page; unlinked models render as text.",
+        expectedData: { headingCountEqualsRowCount: true },
+        endResult: "Nothing is changed; this case only reads.",
+    },
+    "checklist-content-discovery-parts-database-part-page-shows-no-prices": {
+        roles: ["guest"],
+        startPage: "/parts",
+        steps: [
+            "Open /parts, then Disc, then Sting.",
+            "Read the Listings section.",
+            "Confirm NO row shows a rupee amount.",
+            "Confirm no row shows 'Sign in to see price' either.",
+            "Click 'Search the catalogue' or 'See all listings' and confirm it lands on /products with a search term.",
+        ],
+        expectedBehaviour: "Prices are withheld from signed-out visitors, so an amount here would need the price gate and would make this a client-rendered page. A row carrying a title, a condition and a link has nothing to gate and therefore nothing to leak — which is why there is no 'Sign in to see price' placeholder either. The price lives one click away on the listing, where the gate already is.",
+        expectedUiState: "Listing rows show a title and optionally a condition. No rupee amounts, no sign-in-to-see-price text.",
+        expectedData: { pricesOnPartPage: false },
+        endResult: "Nothing is changed; this case only reads.",
+    },
+    "checklist-content-discovery-parts-database-model-page-shows-its-composition": {
+        roles: ["guest"],
+        startPage: "/categories/category-ace-dragon-sting-charge-zan",
+        steps: [
+            "Open /categories/category-ace-dragon-sting-charge-zan — a tier-4 named-model leaf. Every category id carries the `category-` prefix and a URL without it does not resolve.",
+            "Find the 'What it is made of' section.",
+            "Confirm it lists at least one slot row, each reading as a part classification on the left and a part name on the right.",
+            "Click a part name and confirm it opens that part's page under /parts/.",
+            "Then open /categories/category-burst-gt — the generation LINE one level up — and confirm it has NO 'What it is made of' section at all.",
+        ],
+        expectedBehaviour: "BEFORE: the panel showed nothing on every model, twice over — the read queried a field the collection does not have, and separately every composition's name was a file path so none of them joined to a category. Both failures rendered as an absent section, which is indistinguishable from a model we have no data for. AFTER: the leaf shows its parts and each one links out. The LINE shows nothing deliberately — 'Burst GT' is not made of parts, the beys under it are.",
+        expectedUiState: "The model leaf shows a composition with linked part names. The line above it shows no composition section.",
+        expectedData: { leafHasPanel: true, lineHasPanel: false },
+        endResult: "Nothing is changed; this case only reads.",
+    },
+    "checklist-content-discovery-parts-database-art-listing-has-no-parts-tab": {
+        roles: ["guest"],
+        startPage: "/products/art-dranzer-phoenix-poster",
+        steps: [
+            "Open /products/art-dranzer-phoenix-poster — an art print filed under the Dranzer F model leaf.",
+            "Read the tab strip above the description.",
+            "Confirm there is NO 'Parts' tab.",
+            "Answer no if a Parts tab appears listing an attack ring, a weight disk or a blade base.",
+        ],
+        expectedBehaviour: "BEFORE: this was the ONLY listing in the catalogue that satisfied every other condition, so the one Parts tab in the whole product catalogue offered a poster an attack ring and a blade base. It rendered a correct part list for the wrong kind of object, with no error anywhere. AFTER: a print, a sticker sheet and a redemption code are excluded by type. They file under the model's leaf on purpose — a sticker sheet belongs beside the bey it is for — and none of them is made of its parts.",
+        expectedUiState: "No Parts tab on an art listing.",
+        expectedData: { partsTabOnArtListing: false },
+        endResult: "Nothing is changed; this case only reads.",
+    },
+    "checklist-content-discovery-parts-database-seller-description-lists-parts": {
+        roles: ["seller"],
+        startPage: "/store/products/new",
+        steps: [
+            "Open /store/products/new and enter any title.",
+            "Pick the category category-ace-dragon-sting-charge-zan, a Burst GT named-model leaf.",
+            "Set the condition to Used.",
+            "Wait for the template picker to fill the Description field.",
+            "Read the filled description and confirm it contains a 'Parts:' line naming at least one real part.",
+            "Now change the category to category-pokemon-set-151 — a real trading-card expansion-set leaf, which has no parts — and confirm the refilled description contains NO 'Parts:' line at all.",
+            "Answer no if the second description shows an EMPTY 'Parts:' line.",
+        ],
+        expectedBehaviour: "A listing filed under a named model can state what the bey is made of, from the same data the model page renders. The second half is the half that matters: an unfilled slot resolves to an empty string, so a shared template would render an empty 'Parts:' bullet on every listing in the catalogue that is not a Beyblade. The line is REMOVED rather than emptied — absent data must read as absent, not as blank.",
+        expectedUiState: "The Beyblade description carries a Parts line naming real parts. The trading-card description has no Parts line and no empty bullet.",
+        expectedData: { partsLineOnModelLeaf: true, emptyPartsLineElsewhere: false },
+        endResult: "Nothing is saved — the draft is abandoned without publishing, so no listing is created.",
+    },
+};

package/dist/features/tester/seed-data/authored/index.js

@@ -76,6 +76,7 @@ import { authored as a_content_discovery__blog } from "./content-discovery__blog
 import { authored as a_content_discovery__coupons } from "./content-discovery__coupons.js";
 import { authored as a_content_discovery__events } from "./content-discovery__events.js";
 import { authored as a_content_discovery__faq_help } from "./content-discovery__faq-help.js";
+import { authored as a_content_discovery__parts_database } from "./content-discovery__parts-database.js";
 import { authored as a_content_discovery__notifications } from "./content-discovery__notifications.js";
 import { authored as a_content_discovery__search } from "./content-discovery__search.js";
 import { authored as a_cta_layout__checkout_bottom_bar } from "./cta-layout__checkout-bottom-bar.js";
@@ -195,6 +196,7 @@ export const AUTHORED_CASES = {
     ...a_content_discovery__coupons,
     ...a_content_discovery__events,
     ...a_content_discovery__faq_help,
+    ...a_content_discovery__parts_database,
     ...a_content_discovery__notifications,
     ...a_content_discovery__search,
     ...a_cta_layout__checkout_bottom_bar,

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -3091,6 +3091,34 @@ const rawTesterChecklistItems = [
                 { key: "brand-count-matches-its-listing", label: "A brand page's count equals what that brand page lists" },
             ],
         },
+        {
+            /*
+             * D12 — the parts database, the composition panel, and the part line in a
+             * seller's auto-filled description.
+             *
+             * 🛑 Four defects this feature has already produced, every one of them a
+             * 200 with plausible content: a read against a field the collection does
+             * not have; a composition `name` that was a FILE PATH for all 259 rows so
+             * nothing joined; a join that reached 150 of 259 until a paren-stripped
+             * fallback took it to 210; and a Parts tab on an ART POSTER offering it
+             * an attack ring. None of them errored, and three of them rendered as an
+             * ABSENT panel — indistinguishable from a model we have no data for.
+             */
+            pageKey: "parts-database",
+            pageLabel: "Parts database, composition panel and the part line in a description",
+            href: "/parts",
+            cases: [
+                { key: "index-lists-every-classification", label: "The parts index lists all 20 classifications, labelled as names and not as URL slugs" },
+                { key: "index-shows-no-fabricated-counts", label: "No classification tile shows a part count — not even a zero" },
+                { key: "classification-page-lists-its-parts", label: "A classification's stated count equals the rows it lists, and a missing weight renders as nothing rather than 0 g" },
+                { key: "unknown-classification-404s", label: "An unknown classification 404s instead of rendering an empty page — with a real one as the control" },
+                { key: "part-page-shows-which-models-use-it", label: "A part page names the models that use it, and an unjoined model reads as text rather than a broken link" },
+                { key: "part-page-shows-no-prices", label: "A part page's listing rows carry no price and no sign-in-to-see-price placeholder" },
+                { key: "model-page-shows-its-composition", label: "A named-model leaf shows what it is made of with linked parts; the generation line above it shows none" },
+                { key: "art-listing-has-no-parts-tab", label: "An art print filed under a model leaf has NO Parts tab" },
+                { key: "seller-description-lists-parts", label: "A listing under a model leaf gets a Parts line in its filled description, and a non-Beyblade category gets no empty one" },
+            ],
+        },
         {
             /*
              * Store reviews. The endpoint answered 200 with zero reviews for EVERY
@@ -5497,7 +5525,6 @@ const rawTesterChecklistItems = [
                     description: "Found 2026-09-02: this is the only page in the app calling a Google Cloud API rather than Firestore, and the call was unguarded — a permission or outage error took the whole page down (and failed the production build). It now degrades to an empty list and records a DEGRADED_READ. Confirm the page renders its heading and empty state rather than an error boundary.",
                     href: "/admin/maintenance/cloud-logs",
                 },
-                { key: "copilot-admin", label: "Admin copilot page works correctly", href: "/admin/copilot" },
                 { key: "team-admin", label: "Admin team page works correctly", href: "/admin/team" },
                 {
                     key: "team-permission-group-filter",

package/dist/index.d.ts

@@ -365,10 +365,7 @@ export { FEATURE_SUBPATH_MAP } from "./cli/index";
 export { mergeFeatureMessages } from "./cli/index";
 export { withFeatures } from "./cli/index";
 export type { NextConfig } from "./cli/index";
-export { COPILOT_LOGS_COLLECTION } from "./core/index";
-export { COPILOT_LOGS_INDEXED_FIELDS } from "./core/index";
 export { CacheManager } from "./core/index";
-export { CopilotLogRepository } from "./core/index";
 export { EventBus } from "./core/index";
 export { Logger } from "./core/index";
 export { MUTATION_EVENTS } from "./core/index";
@@ -381,8 +378,6 @@ export { StorageManager } from "./core/index";
 export { _resetActionMiddleware } from "./core/index";
 export { cacheManager } from "./core/index";
 export { configureMarketDefaults } from "./core/index";
-export { copilotLogQueryHelpers } from "./core/index";
-export { copilotLogRepository } from "./core/index";
 export { createServerAction } from "./core/index";
 export { createSiteConfig } from "./core/index";
 export { emitMutation } from "./core/index";
@@ -414,9 +409,6 @@ export type { ActionResult } from "./_internal/shared/types/action-result";
 export { handleActionError } from "./utils/action-response";
 export type { CacheEntry } from "./core/index";
 export type { CacheOptions } from "./core/index";
-export type { CopilotFeedback } from "./core/index";
-export type { CopilotLogCreateInput } from "./core/index";
-export type { CopilotLogDocument } from "./core/index";
 export type { EventSubscription } from "./core/index";
 export type { LogEntry } from "./core/index";
 export type { LogLevel } from "./core/index";
@@ -1612,13 +1604,6 @@ export type { ContactFormProps } from "./features/contact/index";
 export type { ContactInfoItem } from "./features/contact/index";
 export type { ContactInfoSidebarProps } from "./features/contact/index";
 export type { UseContactSubmitOptions } from "./features/contact/index";
-export { AdminCopilotView } from "./features/copilot/index";
-export { useCopilotChat } from "./features/copilot/index";
-export { useCopilotFeedback } from "./features/copilot/index";
-export type { AdminCopilotViewProps } from "./features/copilot/index";
-export type { CopilotChatResponse } from "./features/copilot/index";
-export type { CopilotMessage } from "./features/copilot/index";
-export type { UseCopilotFeedbackOptions } from "./features/copilot/index";
 export { CorporateInquiryForm } from "./features/corporate/index";
 export { buildCorporateColumns } from "./features/corporate/index";
 export { corporateAdminColumns } from "./features/corporate/index";
@@ -2999,7 +2984,7 @@ export { Ol } from "./ui/index";
 export { LoginRequiredModal } from "./ui/components/LoginRequiredModal";
 export type { LoginRequiredModalProps } from "./ui/components/LoginRequiredModal";
 export { isAuthError } from "./utils/auth-error";
-export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, ADMIN_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COPILOT_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, WISHLIST_ENDPOINTS, COLLECTION_CACHE_PATHS, resolveEndpoint, resolveEndpointFn, ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES, WISHLIST_MAX, HISTORY_MAX, CART_MAX_ITEMS, WISHLIST_DOC_ID, HISTORY_DOC_ID, WISHLIST_COLLECTION, HISTORY_COLLECTION, } from "./constants/index";
+export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, ADMIN_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, WISHLIST_ENDPOINTS, COLLECTION_CACHE_PATHS, resolveEndpoint, resolveEndpointFn, ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES, WISHLIST_MAX, HISTORY_MAX, CART_MAX_ITEMS, WISHLIST_DOC_ID, HISTORY_DOC_ID, WISHLIST_COLLECTION, HISTORY_COLLECTION, } from "./constants/index";
 export { WishlistFullError } from "./features/wishlist/server";
 export { useHistory, useHistoryMergeOnLogin, getGuestHistory, trackGuestHistory, removeGuestHistoryItem, clearGuestHistory, getGuestHistoryCount, type GuestHistoryItem, type GuestHistoryType, type UserHistoryItem, type HistoryProductType, type HistoryItemSnapshot, type TrackArgs as TrackHistoryArgs, } from "./features/history";
 export { historyRepository, UserHistoryRepository, trackHistoryView, getHistoryForUser, removeHistoryItem, clearHistory, mergeGuestHistory, } from "./features/history/server";
@@ -3072,6 +3057,16 @@ export { groupedListingFormSchema, groupedListingCreateSchema, groupedListingUpd
 export { scammersSeedData } from "./seed/index";
 export { productFeaturesSeedData } from "./seed/index";
 export { taxCodesSeedData } from "./seed/index";
+export { PART_GLOSSARY_COLLECTION, MODEL_COMPOSITION_COLLECTION, PART_SLOT_VALUES, PART_SLOT_LABEL, ALL_PART_SLOTS, LISTING_TYPE_HAS_COMPOSITION, partSlotFromSegment, partGlossaryId, } from "./features/parts/schemas/firestore";
+export type { PartGlossaryDocument, ModelCompositionDocument, ModelSlot, ModelSlotMerge, PartSlot, } from "./features/parts/schemas/firestore";
+export { partGlossarySeedData } from "./seed/index";
+export { modelCompositionSeedData } from "./seed/index";
+export { ModelCompositionPanel } from "./features/parts/components/ModelCompositionPanel";
+export { PartsIndexPageView, PartClassificationPageView, } from "./features/parts/components/PartsIndexPageView";
+export { PartDetailPageView } from "./features/parts/components/PartDetailPageView";
+export { AssemblyDrawer } from "./features/parts/components/AssemblyDrawer";
+export type { AssemblyDrawerProps, AssemblyPartOption, AssemblyRow, AssemblyOutcome, } from "./features/parts/components/AssemblyDrawer";
+export type { PartListingRow } from "./features/parts/components/PartDetailPageView";
 export { SCAMMER_COLLECTION, SCAMMER_ID_PREFIX, SCAMMER_MATCH_FIELDS, SCAMMER_INDEXED_FIELDS, SCAMMER_FIELDS, SCAMMER_INCIDENTS_SUBCOLLECTION, SCAMMER_COMMENTS_SUBCOLLECTION, SCAMMER_CONTESTS_SUBCOLLECTION, MAX_COMMENT_BODY_LENGTH, MAX_PENDING_SCAMMER_REPORTS_PER_USER, ScammerStatusValues, ScamPlatformValues, SocialPlatformValues, ContestTypeValues, ContestStatusValues, SCAM_PLATFORM_LABELS, SOCIAL_PLATFORM_LABELS, SCAMMER_STATUS_LABELS, CONTEST_TYPE_LABELS, CONTEST_STATUS_LABELS, DEFAULT_SCAMMER_DATA, DEFAULT_SCAMMER_INCIDENT_DATA, DEFAULT_SCAMMER_COMMENT_DATA, DEFAULT_SCAMMER_CONTEST_DATA, } from "./features/scams/schemas/firestore";
 export type { ScammerStatus, ScamPlatform, SocialPlatform, ContestType, ContestStatus, ScammerMatchField, ScammerMatchStrength, ScammerSocialMedia, ScammerDocument, ScammerIncidentDocument, ScammerCommentDocument, ScammerContestDocument, ScammerSuggestion, ScammerCreateInput, ScammerAdminUpdateInput, ScammerIncidentCreateInput, ScammerCommentCreateInput, ScammerContestCreateInput, } from "./features/scams/schemas/firestore";
 export { SCAM_TYPES, SCAM_CATEGORIES, SCAM_TYPE_LABELS, SCAM_CATEGORY_LABELS, getScamType, getScamTypesByCategory, getCategoryForScamType, } from "./features/scams/constants/scam-types";