@mohasinac/appkit 4.53.0 → 4.53.1

package/dist/features/search/hooks/useScopedSearch.js

@@ -0,0 +1,114 @@
+"use client";
+/*
+ * WHY: A signed-in viewer's own records belong in the same box as the public
+ *      catalogue — but they cost real reads and must not be fetched the way
+ *      the free tier is.
+ * WHAT: Tier 2's client half, plus the merge with Tier 1.
+ *
+ * ## 🛑 ON SUBMIT, never per keystroke
+ *
+ * Tier 1 is a local scan and costs nothing, so it runs on every character.
+ * This one is a bounded Firestore fan-out — up to ~320 documents for an
+ * admin — so it runs when the user commits to a query. A debounced
+ * per-keystroke version of this endpoint is how a 50k/day read tier
+ * disappears in an afternoon.
+ *
+ * ## 🛑 A guest issues ZERO requests
+ *
+ * Gated on `enabled`, which the caller sets from the session. The server
+ * refuses too (`auth: true`, and `scopedSourcesFor(null)` is `[]`), but the
+ * client gate is what makes "signed out = no authenticated request in the
+ * Network panel" true, which is the only form of that claim anyone can
+ * verify.
+ *
+ * @tag domain:search
+ * @tag layer:feature
+ * @tag pattern:hook
+ * @tag access:client
+ * @tag consumers:SearchResultsClient
+ * @tag sideEffects:network
+ */
+import * as React from "react";
+import { apiClient } from "../../../http/index.js";
+import { normalizeError } from "../../../errors/normalize.js";
+import { SEARCH_ENDPOINTS } from "../../../constants/api-endpoints.js";
+/** Matches the server-side gate, so the two cannot disagree about what is worth asking. */
+const MIN_CHARS = 3;
+export function useScopedSearch({ enabled, submittedQuery, }) {
+    const [status, setStatus] = React.useState("idle");
+    const [groups, setGroups] = React.useState([]);
+    React.useEffect(() => {
+        const q = submittedQuery.trim();
+        if (!enabled || q.length < MIN_CHARS) {
+            setStatus("idle");
+            setGroups([]);
+            return;
+        }
+        /*
+         * An `AbortController` per query, mirroring `useNavSuggestions`. Without
+         * it, a slow response to an earlier query can land after a faster
+         * response to a later one and overwrite it — the user sees results for
+         * something they already moved on from, which looks like the search
+         * returning the wrong thing rather than like a race.
+         */
+        const controller = new AbortController();
+        setStatus("loading");
+        apiClient
+            .get(SEARCH_ENDPOINTS.SCOPED(q), { signal: controller.signal })
+            .then((res) => {
+            if (controller.signal.aborted)
+                return;
+            setGroups(res?.data?.groups ?? []);
+            setStatus("ready");
+        })
+            .catch((err) => {
+            if (controller.signal.aborted)
+                return;
+            const e = normalizeError(err);
+            /*
+             * `failed`, and the CALLER must say so out loud.
+             * `searchEverything`'s own header records that a degraded source "is
+             * indistinguishable from 'nothing matched'" — and on a page where
+             * the public half rendered fine, silence tells a seller their draft
+             * does not exist.
+             */
+            void e;
+            setGroups([]);
+            setStatus("failed");
+        });
+        return () => controller.abort();
+    }, [enabled, submittedQuery]);
+    return { status, groups };
+}
+/**
+ * Merge the two tiers.
+ *
+ * ## 🛑 Dedupe by DESTINATION, and local wins
+ *
+ * The tiers are NOT disjoint: a seller's published listing is in the public
+ * artifact AND in `my-listings`. Showing both is a duplicate-results bug;
+ * dropping the public one would lose the row a buyer would see.
+ *
+ * Local wins, so what survives in the scoped group is precisely the rows the
+ * artifact does not have — a seller's DRAFTS. Labelling that group "Your
+ * listings (incl. drafts)" is what makes the dedupe legible rather than
+ * mysterious.
+ *
+ * 🛑 The key is the HREF, not `${typeKey}:${id}`. The artifact keys products
+ * by SLUG and Firestore by document id, so a composite key would never
+ * collide and the dedupe would silently do nothing — the failure mode being
+ * a page that looks fine and shows everything twice. Both tiers already
+ * agree on where a row goes, which is the only identity they share.
+ */
+export function mergeSearchTiers(local, scoped) {
+    const seen = new Set();
+    for (const g of local)
+        for (const h of g.hits)
+            seen.add(h.href);
+    const deduped = scoped
+        .map((g) => ({ ...g, hits: g.hits.filter((h) => !seen.has(h.href)) }))
+        // A scoped group that is now empty is dropped entirely rather than
+        // rendered as a heading over nothing, which reads as a broken section.
+        .filter((g) => g.hits.length > 0);
+    return [...local, ...deduped];
+}

package/dist/features/search/hooks/useSiteSearch.d.ts

@@ -0,0 +1,26 @@
+import { type FacetCount } from "../../../_internal/shared/search/to-groups";
+import { type SearchIndexStatus } from "./useSearchIndex";
+import type { SearchEverythingResult } from "../../../_internal/server/features/search/search-everything";
+import type { NavSuggestionRecord } from "./useNavSuggestions";
+export interface UseSiteSearchOptions {
+    /** Flip true on focus or first keypress. Gates the artifact fetch. */
+    active: boolean;
+    /** `siteSettings.search?.indexEnabled` — read as `!== false`. */
+    indexEnabled?: boolean;
+    /** Restrict to these index type keys. Absent means every type. */
+    types?: readonly string[];
+    /** Require every one of these `k:v` pairs. The facet rail's selection. */
+    facets?: readonly string[];
+    /** `typeKey` -> heading. See `ToGroupsOptions.label`. */
+    label: (typeKey: string) => string;
+}
+export interface UseSiteSearchResult {
+    readonly status: SearchIndexStatus;
+    /** Null until the index is ready; never a fabricated empty result. */
+    readonly result: SearchEverythingResult | null;
+    readonly suggestions: readonly NavSuggestionRecord[];
+    readonly facets: readonly FacetCount[];
+    /** The index build this answered from, for a "results as of" line. */
+    readonly builtAt: string | null;
+}
+export declare function useSiteSearch(query: string, { active, indexEnabled, types, facets, label }: UseSiteSearchOptions): UseSiteSearchResult;

package/dist/features/search/hooks/useSiteSearch.js

@@ -0,0 +1,149 @@
+"use client";
+/*
+ * WHY: One query, one matcher, two surfaces — the header dropdown and
+ *      `/search` must not grow separate notions of what matches.
+ * WHAT: The client search hook. Runs the browser matcher over the loaded
+ *       artifact and returns BOTH shapes: grouped results for the page and
+ *       flat suggestion rows for the typeahead.
+ *
+ * ## 🛑 Synchronous per keystroke, and no debounce
+ *
+ * There is nothing to debounce — a debounce exists to avoid spending a
+ * network round trip per character, and this spends none. `searchIndex` is a
+ * linear scan over ~3,700 prepared records, measured sub-millisecond by
+ * `verify-search-local.mjs`. Adding a 250 ms debounce here would make the box
+ * feel SLOWER than the thing it replaced while costing nothing less.
+ *
+ * The one thing that is async is loading the artifact, once, and `active`
+ * gates that (see `useSearchIndex`).
+ *
+ * ## 🛑 No minimum query length either
+ *
+ * `useNavSuggestions` gates at 3 characters because each query is a real
+ * Firestore round trip and below that the result is dominated by whatever
+ * sorts first. Neither clause holds here: a one-character query costs the
+ * same nothing, and the matcher ranks rather than truncates. Typing "d" and
+ * seeing something is the behaviour a local index is FOR.
+ *
+ * ## It returns a result even when the index is not in play
+ *
+ * `status` distinguishes `idle` / `loading` / `ready` / `failed` / `disabled`,
+ * and the last two mean *the caller should fall back*, not *show nothing*.
+ * A caller that renders an empty state on `loading` is saying "nothing
+ * matched" about a question that has not been asked yet.
+ *
+ * @tag domain:search
+ * @tag layer:feature
+ * @tag pattern:hook
+ * @tag access:client
+ * @tag consumers:Search,SearchResultsClient
+ * @tag sideEffects:none
+ */
+import * as React from "react";
+import { searchIndex } from "../../../_internal/shared/search/match.js";
+import { countFacets, moreHrefResolver, toSearchResult, } from "../../../_internal/shared/search/to-groups.js";
+import { parseSearchTxtQuery } from "../../../utils/search-txt.js";
+import { useSearchIndex } from "./useSearchIndex.js";
+/**
+ * How many hits the matcher is asked for.
+ *
+ * Generous because grouping happens AFTER: a cap of 20 on a query matching
+ * 400 products would starve every other group, since the list is
+ * score-ordered and products would fill it. 200 keeps the long tail of types
+ * reachable while staying trivial to sort.
+ */
+const MATCH_LIMIT = 200;
+/**
+ * `typeKey` -> the five values the header dropdown's icon and badge maps
+ * understand.
+ *
+ * 🛑 A MAPPING rather than a widening of `NavSuggestionRecord["type"]`.
+ * That union is public API and is switched on by the dropdown's
+ * `DEFAULT_TYPE_ICONS` / `DEFAULT_TYPE_BADGES`; widening it to `string` would
+ * compile everywhere and silently render unstyled rows for the 16 index types
+ * those maps have never heard of (Root Cause #20). The real key travels
+ * alongside, in `typeKey`, for anything that wants it.
+ */
+function suggestionTypeFor(typeKey) {
+    switch (typeKey) {
+        case "blog":
+            return "blog";
+        case "event":
+            return "event";
+        case "category":
+        case "brand":
+        case "franchise":
+        case "bundle":
+        case "model":
+        case "part":
+            return "category";
+        case "store":
+        case "faq":
+        case "review":
+        case "scammer":
+        case "coupon":
+        case "group":
+            return "page";
+        default:
+            // Every listing type — product, auction, pre-order, … — plus anything
+            // added to the index later. A listing is the commonest row and the
+            // product icon is the right default for an unknown one.
+            return "product";
+    }
+}
+export function useSiteSearch(query, { active, indexEnabled, types, facets, label }) {
+    const { status, index } = useSearchIndex({ active, indexEnabled });
+    /*
+     * 🛑 `types` and `facets` are arrays, so a caller passing a literal creates
+     * a new identity every render and would re-run the scan on every keystroke
+     * of an UNCHANGED filter. Keying the memo on the joined strings makes the
+     * dependency structural rather than referential.
+     */
+    const typeKey = types ? types.join(",") : "";
+    const facetKey = facets ? facets.join(",") : "";
+    return React.useMemo(() => {
+        if (!index) {
+            return { status, result: null, suggestions: [], facets: [], builtAt: null };
+        }
+        const q = query.trim();
+        if (!q) {
+            return {
+                status,
+                result: null,
+                suggestions: [],
+                facets: [],
+                builtAt: index.builtAt,
+            };
+        }
+        const hits = searchIndex(index.artifact, index.prepared, q, {
+            limit: MATCH_LIMIT,
+            types: typeKey ? typeKey.split(",") : undefined,
+            facets: facetKey ? facetKey.split(",") : undefined,
+        });
+        /*
+         * Terms come from the SAME parser the matcher used, so a query that
+         * normalises away ("!!!") reports zero terms and the page can render its
+         * "no searchable words" state — which is a different thing from "nothing
+         * matched", and the distinction the server tier also draws via
+         * `plan.empty`.
+         */
+        const terms = parseSearchTxtQuery(q);
+        return {
+            status,
+            result: toSearchResult(q, terms, hits, {
+                label,
+                moreHref: moreHrefResolver(index.artifact),
+            }),
+            suggestions: hits.slice(0, 8).map((h) => ({
+                objectID: h.href,
+                type: suggestionTypeFor(h.typeKey),
+                typeKey: h.typeKey,
+                title: h.title,
+                subtitle: h.detail || undefined,
+                url: h.href,
+            })),
+            facets: countFacets(hits),
+            builtAt: index.builtAt,
+        };
+    }, [index, status, query, typeKey, facetKey, label]);
+}

package/dist/features/search/index.d.ts

@@ -1,7 +1,3 @@
-export * from "./types";
-export * from "./schemas";
-export * from "./columns";
-export * from "./hooks/useSearch";
 export * from "./hooks/useNavSuggestions";
 export * from "./components";
 export { manifest } from "./manifest";

package/dist/features/search/index.js

@@ -1,7 +1,3 @@
-export * from "./types/index.js";
-export * from "./schemas/index.js";
-export * from "./columns/index.js";
-export * from "./hooks/useSearch.js";
 export * from "./hooks/useNavSuggestions.js";
 export * from "./components/index.js";
 export { manifest } from "./manifest.js";

package/dist/features/search/manifest.d.ts

@@ -1,2 +1,14 @@
 import type { FeatureManifest } from "../../contracts";
+/**
+ * `default` is `SearchResultsClient`, which is what `[locale]/search/page.tsx`
+ * actually renders. It used to say `SearchView` — a component the route has
+ * never rendered, from the dead legacy `feat-search` subsystem — and A7
+ * (`audit-feature-manifest-routes`) is what this file is the fixed example
+ * for.
+ *
+ * `api/search` (the dead `SearchRepository`-backed GET handler) was removed
+ * from `apiRoutes` in the same Wave 10 commit that deleted the route itself
+ * — the manifest and the filesystem go empty together, not one claiming the
+ * other vanished a week early.
+ */
 export declare const manifest: FeatureManifest;

package/dist/features/search/manifest.js

@@ -1,10 +1,25 @@
+/**
+ * `default` is `SearchResultsClient`, which is what `[locale]/search/page.tsx`
+ * actually renders. It used to say `SearchView` — a component the route has
+ * never rendered, from the dead legacy `feat-search` subsystem — and A7
+ * (`audit-feature-manifest-routes`) is what this file is the fixed example
+ * for.
+ *
+ * `api/search` (the dead `SearchRepository`-backed GET handler) was removed
+ * from `apiRoutes` in the same Wave 10 commit that deleted the route itself
+ * — the manifest and the filesystem go empty together, not one claiming the
+ * other vanished a week early.
+ */
 export const manifest = {
     name: "search",
     i18nNamespace: "search",
     envKeys: [],
-    routes: [{ segment: "[locale]/search", exports: { default: "SearchView" } }],
+    routes: [
+        { segment: "[locale]/search", exports: { default: "SearchResultsClient" } },
+    ],
     apiRoutes: [
-        { segment: "api/search", methods: ["GET"] },
+        { segment: "api/search/scoped", methods: ["GET"] },
+        { segment: "api/search/suggestions", methods: ["GET"] },
         { segment: "api/categories/flat", methods: ["GET"] },
     ],
 };

package/dist/features/search/server.d.ts

@@ -1,4 +1 @@
-export * from "./actions";
-export { SearchRepository } from "./repository/search.repository";
 export { manifest } from "./manifest";
-export { GET as searchGET, GET } from "./api/route";

package/dist/features/search/server.js

@@ -1,4 +1 @@
-export * from "./actions/index.js";
-export { SearchRepository } from "./repository/search.repository.js";
 export { manifest } from "./manifest.js";
-export { GET as searchGET, GET } from "./api/route.js";

package/dist/features/seller/components/SellerListingTypeView.d.ts

@@ -53,7 +53,7 @@ export interface SellerListingTypeSpec {
  * because standard / auction / pre-order / prize-draw do NOT have one — their
  * store routes redirect into the multi-type `SellerProductsView`.
  */
-export type SellerListingTypeKey = "art" | "stickers" | "classified" | "digital-code" | "live";
+export type SellerListingTypeKey = "art" | "stickers" | "classified" | "digital-code" | "live" | "spares";
 export declare const SELLER_LISTING_TYPE_SPECS: Record<SellerListingTypeKey, SellerListingTypeSpec>;
 export interface SellerListingTypeViewProps {
     onCreateClick?: () => void;

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

@@ -87,6 +87,26 @@ export const SELLER_LISTING_TYPE_SPECS = {
         }),
         extraColumns: [textCell("size", "Size")],
     },
+    spares: {
+        editRoute: (id) => String(ROUTES.STORE.SPARES_EDIT(id)),
+        newRoute: String(ROUTES.STORE.SPARES_NEW),
+        createLabel: "List a Spare",
+        bulkKey: "spares",
+        deleteLabel: "Spare Listing",
+        searchPlaceholder: "Search spares by part or colour...",
+        emptyLabel: "No spares listed yet — list a part you have going spare",
+        /*
+         * Colourway, not size. Two listings of the same part code are told apart by
+         * COLOUR here — a red Cross Dranzer and a navy one are different objects to
+         * a buyer rebuilding a specific top, which is the user's own framing
+         * ("sell it to someone who wants it in the same colour"). `printMeta.size`
+         * is meaningless on a moulded component.
+         */
+        extraFields: (item) => ({
+            colourway: toStringValue(item.colourway, ""),
+        }),
+        extraColumns: [textCell("colourway", "Colourway")],
+    },
     classified: {
         editRoute: (id) => String(ROUTES.STORE.CLASSIFIED_EDIT(id)),
         newRoute: String(ROUTES.STORE.CLASSIFIED_NEW),

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

@@ -46,9 +46,17 @@ const payoutSettingsDraftSchema = z.object({
     ifscCode: annotate(z.string(), { section: "method", quick: true, order: 5, row: "pair" }),
     bankName: annotate(z.string(), { section: "method", quick: true, order: 6, row: "pair" }),
     accountType: annotate(z.enum(["savings", "current"]), { section: "method", quick: true, order: 7, row: "pair" }),
+    // The three fields that identify the SUPPLIER OF RECORD on this store's
+    // invoices. A seller with a GSTIN invoices under it; one without
+    // invoices under LetItRip's (resolveSupplierIdentity).
+    //
+    // `pan` and `businessType` were removed 2026-10-19: neither exists on
+    // StoreDocument or UserDocument and the route stripped them, so a
+    // seller who entered a PAN was told it saved and it went nowhere.
+    // An input that provably cannot persist is worse than no input.
     gstin: annotate(z.string(), { section: "tax", sectionLabel: "Tax Info", order: 1, row: "pair" }),
-    pan: annotate(z.string(), { section: "tax", order: 2, row: "pair" }),
-    businessType: annotate(z.string(), { section: "tax", order: 3, row: "pair" }),
+    legalName: annotate(z.string(), { section: "tax", order: 2, row: "pair" }),
+    registeredAddress: annotate(z.string(), { section: "tax", order: 3, row: "full" }),
     autoPayout: annotate(z.boolean(), {
         section: "preferences", sectionLabel: "Preferences", order: 1, row: "quarter",
     }),
@@ -110,8 +118,8 @@ const DEFAULT_DRAFT = {
     bankName: "",
     accountType: "savings",
     gstin: "",
-    pan: "",
-    businessType: "",
+    legalName: "",
+    registeredAddress: "",
     autoPayout: true,
     minimumThreshold: "",
     emiEnabled: false,
@@ -142,9 +150,22 @@ export function SellerPayoutSettingsView({ apiBase = SELLER_ENDPOINTS.PAYOUT_SET
                 ifscCode: details.bankAccount?.ifscCode ?? "",
                 bankName: details.bankAccount?.bankName ?? "",
                 accountType: details.bankAccount?.accountType ?? "savings",
-                gstin: res?.data?.taxInfo?.gstin ?? "",
-                pan: res?.data?.taxInfo?.pan ?? "",
-                businessType: res?.data?.taxInfo?.businessType ?? "",
+                /*
+                 * 🛑 Flat fields, NOT `res.data.taxInfo.*`.
+                 *
+                 * `taxInfo` is a key the route has never returned, so these three
+                 * inputs were ALWAYS blank on load no matter what had been saved —
+                 * and the save side posted a `taxInfo` object that the route's
+                 * `z.object()` schema silently stripped. A seller could type their
+                 * GSTIN, get a success toast, reload, and find it gone.
+                 *
+                 * The route now declares and persists `gstin` / `legalName` /
+                 * `registeredAddress` on the STORE, because the GSTIN decides who
+                 * is the supplier of record on that store's invoices.
+                 */
+                gstin: res?.data?.gstin ?? "",
+                legalName: res?.data?.legalName ?? "",
+                registeredAddress: res?.data?.registeredAddress ?? "",
                 autoPayout: res?.data?.preferences?.autoPayout ?? true,
                 minimumThreshold: res?.data?.preferences?.minimumThreshold
                     ? String(res.data.preferences.minimumThreshold)
@@ -184,11 +205,11 @@ export function SellerPayoutSettingsView({ apiBase = SELLER_ENDPOINTS.PAYOUT_SET
                 pricesIncludeGst: draft.pricesIncludeGst,
                 supportsShippingProtection: draft.supportsShippingProtection,
                 supportsSaleProtection: draft.supportsSaleProtection,
-                taxInfo: {
-                    gstin: draft.gstin.trim(),
-                    pan: draft.pan.trim(),
-                    businessType: draft.businessType.trim(),
-                },
+                // Flat, matching the route's schema. A nested `taxInfo` object was
+                // stripped by `z.object()` and never reached Firestore.
+                gstin: draft.gstin.trim(),
+                legalName: draft.legalName.trim(),
+                registeredAddress: draft.registeredAddress.trim(),
                 preferences: {
                     autoPayout: draft.autoPayout,
                     minimumThreshold: Math.round(parseFloat(draft.minimumThreshold || "0") * 100) / 100,
@@ -244,8 +265,8 @@ export function SellerPayoutSettingsView({ apiBase = SELLER_ENDPOINTS.PAYOUT_SET
         {
             id: "tax",
             label: "Tax Info",
-            fields: ["gstin", "pan", "businessType"],
-            render: ({ values, onChange }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Tax Information" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Optional \u2014 required only for GST invoice generation and TDS compliance." }), _jsx(FormField, { name: "gstin", label: "GSTIN (optional)", type: "text", value: values.gstin, onChange: (v) => onChange({ gstin: v.toUpperCase() }), placeholder: "e.g. 22AAAAA0000A1Z5", helpText: "15-character Goods and Services Tax Identification Number.", disabled: busy }), _jsx(FormField, { name: "pan", label: "PAN (optional)", type: "text", value: values.pan, onChange: (v) => onChange({ pan: v.toUpperCase() }), placeholder: "e.g. ABCDE1234F", helpText: "Required for payouts above \u20B950,000 per year (TDS threshold).", disabled: busy }), _jsx(FormField, { name: "businessType", label: "Business Type (optional)", type: "text", value: values.businessType, onChange: (v) => onChange({ businessType: v }), placeholder: "e.g. Individual, Sole Proprietor, Private Limited", disabled: busy })] })),
+            fields: ["gstin", "legalName", "registeredAddress"],
+            render: ({ values, onChange }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Tax Information" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Optional. Enter a GSTIN and your orders are invoiced under your own registration; leave it blank and they are invoiced under LetItRip's." }), _jsx(FormField, { name: "gstin", label: "GSTIN (optional)", type: "text", value: values.gstin, onChange: (v) => onChange({ gstin: v.toUpperCase() }), placeholder: "e.g. 22AAAAA0000A1Z5", helpText: "15-character Goods and Services Tax Identification Number.", disabled: busy }), _jsx(FormField, { name: "legalName", label: "Registered legal name (optional)", type: "text", value: values.legalName, onChange: (v) => onChange({ legalName: v }), placeholder: "e.g. Arena Collectibles Pvt Ltd", helpText: "The entity name that appears on the invoice. Leave blank to use your store name.", disabled: busy }), _jsx(FormField, { name: "registeredAddress", label: "Registered address (optional)", type: "text", value: values.registeredAddress, onChange: (v) => onChange({ registeredAddress: v }), placeholder: "Address as registered against your GSTIN", helpText: "Printed on invoices issued under your GSTIN.", disabled: busy })] })),
         },
         {
             id: "preferences",

package/dist/features/seller/components/SellerProductShell.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import type { MediaField } from "../../media/types";
-export type ProductListingMode = "standard" | "auction" | "pre-order" | "prize-draw" | "bundle" | "classified" | "digital-code" | "live" | "art" | "stickers";
+export type ProductListingMode = "standard" | "auction" | "pre-order" | "prize-draw" | "bundle" | "classified" | "digital-code" | "live" | "art" | "stickers" | "spares";
 export interface SellerProductDraft {
     title?: string;
     slug?: string;

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

@@ -8,6 +8,7 @@ import { FormShellContext, useFormShellState, applyZodIssues, FormErrorSummary }
 import { Alert, Button, Div, FormField, FormGroup, Heading, Section, Stack, TagInput, Text, Toggle, useToast, Row } from "../../../ui/index.js";
 import { ImageUpload, MediaUploadField, MediaUploadList, useMediaUpload } from "../../media/index.js";
 import { StoreAddressSelectorCreate } from "../../stores/components/StoreAddressSelectorCreate.js";
+import { PriceGuidanceHint } from "../../categories/components/PriceGuidanceHint.js";
 import { QuickProductForm } from "./QuickProductForm.js";
 import { BarcodeField } from "./BarcodeField.js";
 import { pluginFor } from "../../../_internal/shared/listing-types/_registry.js";
@@ -388,7 +389,7 @@ const TYPE_SPECIFIC_SECTIONS = {
 function StepPricing({ values, onChange, listingType, }) {
     const listingPlugin = pluginForMode(listingType);
     const priceLabel = listingPlugin.priceLabel;
-    return (_jsxs(Stack, { gap: "md", children: [_jsx(Alert, { variant: "info", children: "All prices in Indian Rupees (\u20B9)." }), _jsxs(FormGroup, { columns: 2, children: [_jsx(FormField, { name: "price", label: priceLabel, type: "number", value: toRupeesString(values.price), onChange: (v) => onChange({ price: fromRupeesString(v) }), placeholder: "999" }), _jsx(FormField, { name: "originalPrice", label: "Compare-at Price (\u20B9, optional)", type: "number", value: toRupeesString(values.originalPrice), onChange: (v) => onChange({ originalPrice: v ? fromRupeesString(v) : undefined }), placeholder: "1299", helpText: "Original price shown as strikethrough" })] }), listingPlugin.showsStockQuantity && (_jsx(FormField, { name: "stockQuantity", label: "Stock Quantity", type: "number", value: String(values.stockQuantity ?? ""), onChange: (v) => onChange({ stockQuantity: Number(v) }), placeholder: "1" })), _jsxs(FormGroup, { columns: 2, children: [_jsx(Toggle, { checked: !!values.featured, onChange: (checked) => onChange({ featured: checked }), label: "Mark as Featured" }), _jsx(Toggle, { checked: !!values.isNew, onChange: (checked) => onChange({ isNew: checked }), label: "Mark as New Arrival" })] }), _jsx(Toggle, { checked: !!values.allowOffers, onChange: (checked) => onChange({
+    return (_jsxs(Stack, { gap: "md", children: [_jsx(Alert, { variant: "info", children: "All prices in Indian Rupees (\u20B9)." }), _jsxs(FormGroup, { columns: 2, children: [_jsx(FormField, { name: "price", label: priceLabel, type: "number", value: toRupeesString(values.price), onChange: (v) => onChange({ price: fromRupeesString(v) }), placeholder: "999" }), _jsx(FormField, { name: "originalPrice", label: "Compare-at Price (\u20B9, optional)", type: "number", value: toRupeesString(values.originalPrice), onChange: (v) => onChange({ originalPrice: v ? fromRupeesString(v) : undefined }), placeholder: "1299", helpText: "Original price shown as strikethrough" })] }), (values.categoryIds?.[0] ?? values.category) && (_jsx(PriceGuidanceHint, { categoryId: (values.categoryIds?.[0] ?? values.category) })), listingPlugin.showsStockQuantity && (_jsx(FormField, { name: "stockQuantity", label: "Stock Quantity", type: "number", value: String(values.stockQuantity ?? ""), onChange: (v) => onChange({ stockQuantity: Number(v) }), placeholder: "1" })), _jsxs(FormGroup, { columns: 2, children: [_jsx(Toggle, { checked: !!values.featured, onChange: (checked) => onChange({ featured: checked }), label: "Mark as Featured" }), _jsx(Toggle, { checked: !!values.isNew, onChange: (checked) => onChange({ isNew: checked }), label: "Mark as New Arrival" })] }), _jsx(Toggle, { checked: !!values.allowOffers, onChange: (checked) => onChange({
                     allowOffers: checked,
                     minOfferPercent: checked
                         ? values.minOfferPercent ?? DEFAULT_MIN_OFFER_PERCENT

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

@@ -24,7 +24,7 @@ const CLS_NAV_ICON_ACTIVE = "text-warning dark:text-warning";
 function NavLink({ item, isActive, onClick }) {
     return (_jsxs(Link, { href: item.href, onClick: onClick, className: `flex items-center justify-end gap-[var(--appkit-space-2-5)] rounded-lg px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[0.8125rem] font-medium leading-tight transition-colors ${isActive
             ? CLS_NAV_ACTIVE
-            : "text-[var(--appkit-color-text-muted)] hover:bg-surface-hover hover:text-zinc-800 hover:text-[var(--appkit-color-text-muted)]"}`, children: [item.icon && _jsx(Span, { size: "base", className: "shrink-0 opacity-60", children: item.icon }), _jsx(Span, { className: "truncate", children: item.label }), item.badge != null && item.badge > 0 && (_jsx(Span, { weight: "bold", className: CLS_NAV_BADGE, children: item.badge }))] }));
+            : "text-[var(--appkit-color-text-muted)] hover:bg-surface-hover hover:text-[var(--appkit-color-text)]"}`, children: [item.icon && _jsx(Span, { size: "base", className: "shrink-0 opacity-60", children: item.icon }), _jsx(Span, { className: "truncate", children: item.label }), item.badge != null && item.badge > 0 && (_jsx(Span, { weight: "bold", className: CLS_NAV_BADGE, children: item.badge }))] }));
 }
 function FlatContent({ items, activeHref, storeName, storeLogoURL, onItemClick, }) {
     const activeItem = findActiveNavItem(items, activeHref);

package/dist/features/seller/components/SellerSparesView.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SellerSparesView — seller browse/manage of spares listings.
+ *
+ * A named wrapper, matching its five siblings exactly: all behaviour is
+ * `SellerListingTypeView`, and everything this type does differently is one
+ * entry in `SELLER_LISTING_TYPE_SPECS` (a colourway column instead of a size
+ * column, and its own routes and copy).
+ *
+ * Written as a wrapper rather than as a sixth copy of the component on purpose
+ * — see `SellerListingTypeView`'s header for what the five hand-written copies
+ * cost, and note that the factory it adopts had existed with zero seller
+ * callers the whole time.
+ */
+import React from "react";
+import { type SellerListingTypeViewProps } from "./SellerListingTypeView";
+export type SellerSparesViewProps = SellerListingTypeViewProps;
+export declare function SellerSparesView(props: SellerSparesViewProps): React.JSX.Element;

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

@@ -0,0 +1,6 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { SellerListingTypeView, } from "./SellerListingTypeView.js";
+export function SellerSparesView(props) {
+    return _jsx(SellerListingTypeView, { type: "spares", ...props });
+}

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

@@ -114,6 +114,8 @@ export { SellerArtView } from "./SellerArtView";
 export type { SellerArtViewProps } from "./SellerArtView";
 export { SellerStickersView } from "./SellerStickersView";
 export type { SellerStickersViewProps } from "./SellerStickersView";
+export { SellerSparesView } from "./SellerSparesView";
+export type { SellerSparesViewProps } from "./SellerSparesView";
 export { SellerDigitalCodesView } from "./SellerDigitalCodesView";
 export type { SellerDigitalCodesViewProps } from "./SellerDigitalCodesView";
 export { SellerLiveView } from "./SellerLiveView";

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

@@ -60,6 +60,7 @@ export { SellerBundlesView } from "./SellerBundlesView.js";
 export { SellerClassifiedView } from "./SellerClassifiedView.js";
 export { SellerArtView } from "./SellerArtView.js";
 export { SellerStickersView } from "./SellerStickersView.js";
+export { SellerSparesView } from "./SellerSparesView.js";
 export { SellerDigitalCodesView } from "./SellerDigitalCodesView.js";
 export { SellerLiveView } from "./SellerLiveView.js";
 export { BarcodeField } from "./BarcodeField.js";

package/dist/features/shell/CommandPalette.js

@@ -60,7 +60,7 @@ export function CommandPalette({ isOpen, onClose, groups, placeholder = "Jump to
         if (target)
             navigate(target.href);
     }, [results, activeIndex, navigate, onClose]);
-    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, size: "lg", showCloseButton: false, className: "appkit-command-palette", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Input, { ref: inputRef, value: query, onChange: (e) => setQuery(e.target.value), onKeyDown: handleKeyDown, placeholder: placeholder, "aria-label": placeholder, className: "flex-1", autoFocus: true }), _jsx(Kbd, { size: "sm", tone: "brand", children: "Esc" })] }), _jsx(Div, { className: "max-h-96", overflow: "y-auto", children: results.length === 0 ? (_jsxs(Text, { size: "sm", color: "muted", align: "center", paddingY: "lg", children: ["No matches for \u201C", query, "\u201D."] })) : (_jsx(Stack, { gap: "none", children: results.map((item, idx) => (_jsxs(Button, { variant: "ghost", type: "button", onClick: () => navigate(item.href), onMouseEnter: () => setActiveIndex(idx), justify: "between", rounded: "md", paddingX: "sm", paddingY: "xs", className: [
+    return (_jsx(Modal, { isOpen: isOpen, onClose: onClose, size: "lg", showCloseButton: false, children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Input, { ref: inputRef, value: query, onChange: (e) => setQuery(e.target.value), onKeyDown: handleKeyDown, placeholder: placeholder, "aria-label": placeholder, className: "flex-1", autoFocus: true }), _jsx(Kbd, { size: "sm", tone: "brand", children: "Esc" })] }), _jsx(Div, { className: "max-h-96", overflow: "y-auto", children: results.length === 0 ? (_jsxs(Text, { size: "sm", color: "muted", align: "center", paddingY: "lg", children: ["No matches for \u201C", query, "\u201D."] })) : (_jsx(Stack, { gap: "none", children: results.map((item, idx) => (_jsxs(Button, { variant: "ghost", type: "button", onClick: () => navigate(item.href), onMouseEnter: () => setActiveIndex(idx), justify: "between", rounded: "md", paddingX: "sm", paddingY: "xs", className: [
                                 "w-full text-left",
                                 idx === activeIndex
                                     ? "bg-[var(--appkit-color-primary-50)] text-[var(--appkit-color-primary-700)]"

package/dist/features/sticker-trace/schemas/firestore.d.ts

@@ -116,6 +116,25 @@ export interface SheetPart {
      * on these sheets.
      */
     duplicateOf?: number;
+    /**
+     * The `/media/{shortId}` slug of this part's PUBLIC, WATERMARKED copy.
+     *
+     * 🛑 ZERO BYTES ARE DUPLICATED. The `mediaAssets` row points at the SAME
+     * `assetPath` above — the clean original under `private/sticker-sheets/` —
+     * and is written with `watermarkedAt` deliberately ABSENT, so
+     * `/api/media/[...slug]` composites the mark on read. Clean original for the
+     * cut file, watermarked copy for the marketplace, one object.
+     *
+     * Object COUNT is metered separately from bytes (that is the whole reason the
+     * thumb atlas exists), so a second uploaded copy per part would spend Class A
+     * writes 60× faster per sheet for pixels we already have.
+     *
+     * Stored back here so re-promoting a sheet REUSES the row rather than minting
+     * a second slug for the same object and orphaning the first.
+     *
+     * Absent until the sheet has been promoted to listings.
+     */
+    mediaShortId?: string;
 }
 /**
  * One progress transition, mirrored from RTDB so history survives the prune.

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

@@ -1,6 +1,6 @@
 import React from "react";
 import type { ReactNode } from "react";
-export declare const getStoreBySlug: (slug: string) => Promise<import("@mohasinac/appkit").StoreDocument | null>;
+export declare const getStoreBySlug: (slug: string) => Promise<import("..").StoreDocument | null>;
 export interface StoreDetailLayoutViewProps {
     storeSlug: string;
     /** The current active tab value: "products" | "auctions" | "reviews" | "about" */