@mohasinac/appkit 4.57.0 → 4.58.0

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

@@ -1,5 +1,5 @@
 "use client";
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useRouter } from "next/navigation.js";
 import { z } from "zod";
@@ -46,6 +46,21 @@ const sellerProductSchema = z.object({
     title: z.string().min(1, "Product title is required").max(200),
     description: z.string().max(10000).optional().or(z.literal("")),
     price: z.number().min(0).optional(),
+    /*
+     * LOT vs SINGLE. 🛑 Declared HERE as well as on the interface, for the exact
+     * reason the `categoryIds` note below gives: this schema is
+     * `.passthrough()`, so an undeclared key survives at runtime and stays
+     * UNTYPED — the render site could not read `values.isLot` at all.
+     *
+     * No `.default(false)`, matching `src/validation/request-schemas.ts`: absent
+     * means single, and a default would write a field the seller never touched.
+     */
+    isLot: z.boolean().optional(),
+    /* Bounds mirror the request schema (2–999). A "lot of 1" is a single. */
+    lotSize: z.number().int().min(2).max(999).optional(),
+    /* The single-item identity, one or the other and never both. */
+    beyId: z.string().optional(),
+    partGlossaryId: z.string().optional(),
     category: z.string().optional(),
     /**
      * I2 — the assignment list, DEFAULT FIRST. `category` mirrors `[0]`.
@@ -116,9 +131,22 @@ function StepBasic({ values, onChange, renderCategorySelector, renderBrandSelect
         condition: CONDITION_OPTIONS.find((o) => o.value === (values.condition ?? "new"))?.label ?? "",
         siteName: "LetItRip",
     };
-    return (_jsxs(Stack, { gap: "md", children: [_jsx(FormField, { name: "title", label: "Title", type: "text", value: values.title ?? "", onChange: (v) => onChange({ title: v }), placeholder: "e.g. Charizard Base Set PSA 9" }), _jsxs(FormGroup, { columns: 2, children: [renderCategorySelector ? (_jsxs(_Fragment, { children: [_jsx(Text, { className: "text-[var(--appkit-color-text)] mb-1", size: "sm", weight: "medium", children: "Category" }), renderCategorySelector({
+    return (_jsxs(Stack, { gap: "md", children: [_jsx(FormField, { name: "title", label: "Title", type: "text", value: values.title ?? "", onChange: (v) => onChange({ title: v }), placeholder: "e.g. Charizard Base Set PSA 9" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "medium", children: "What is in this listing?" }), _jsxs(Row, { gap: "sm", align: "center", wrap: true, children: [_jsx(Toggle, { checked: values.isLot === true, onChange: (next) => onChange(next
+                                    ? /*
+                                       * Switching TO a lot clears the single-item identity. A
+                                       * stale `beyId` would keep the listing pointing at one
+                                       * named bey while claiming to be a mixed pile — the
+                                       * contradiction the server rule exists to prevent, smuggled
+                                       * past it by a field the seller can no longer see.
+                                       */
+                                        { isLot: true, beyId: undefined, partGlossaryId: undefined }
+                                    : /* And back again drops the count, for the same reason. */
+                                        { isLot: false, lotSize: undefined }), label: values.isLot ? "A lot of several items" : "A single item", size: "sm" }), values.isLot && (_jsx(FormField, { name: "lotSize", label: "How many?", type: "number", value: values.lotSize != null ? String(values.lotSize) : "", onChange: (v) => onChange({ lotSize: v ? Number(v) : undefined }), placeholder: "optional" }))] }), _jsx(Text, { size: "xs", color: "muted", children: values.isLot
+                            ? "A lot files under a category rather than one model, because a category is a collection — naming one model would claim every item in the pile is that model."
+                            : "A single item can be filed against the exact bey or part it is, so buyers searching that name find it." })] }), _jsxs(FormGroup, { columns: 2, children: [renderCategorySelector ? (_jsxs(_Fragment, { children: [_jsx(Text, { className: "text-[var(--appkit-color-text)] mb-1", size: "sm", weight: "medium", children: "Category" }), renderCategorySelector({
                                 value: values.category ?? "",
                                 onChange: (v) => onChange({ category: v }),
+                                isLot: values.isLot === true,
                                 /*
                                  * 🛑 `categoryIds[0]` is the DEFAULT assignment and is already
                                  * rendered by the primary picker above, so the extras list is
@@ -596,7 +624,7 @@ productId, onSave, onPublish, onDiscard, isLoading = false, storeSlug, renderCat
             label: "Basic",
             required: true,
             quick: true,
-            fields: ["title", "description", "category", "brand", "condition", "tags", "barcodeId"],
+            fields: ["title", "isLot", "lotSize", "description", "category", "brand", "condition", "tags", "barcodeId"],
             render: ({ values, onChange }) => (_jsx(StepBasic, { values: values, onChange: onChange, renderCategorySelector: renderCategorySelector, renderBrandSelector: renderBrandSelector, renderTemplateSelector: renderTemplateSelector })),
             schema: sectionSchemas.basic,
         },

package/dist/index.d.ts

@@ -2990,6 +2990,12 @@ 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 { BEYS_COLLECTION, BEY_PRODUCTS_COLLECTION, beyId, } from "./features/beys/schemas/firestore";
+export type { BeyDocument, BeyProductDocument, BeyCompositionEntry, BeyRatings, BeyDerivationCoverage, BeyProductAssortmentEntry, } from "./features/beys/schemas/firestore";
+export { beysSeedData, BEY_SEED_COUNT } from "./seed/index";
+export { BeyDetailPageView } from "./features/beys/components/BeyDetailPageView";
+export type { BeyDetailPageViewProps, BeyListingRow } from "./features/beys/components/BeyDetailPageView";
+export { beyProductsSeedData, BEY_PRODUCT_SEED_COUNT } from "./seed/index";
 export { modelCompositionSeedData } from "./seed/index";
 export { ModelCompositionPanel } from "./features/parts/components/ModelCompositionPanel";
 export { PartsIndexPageView, PartClassificationPageView, } from "./features/parts/components/PartsIndexPageView";
@@ -3067,6 +3073,8 @@ export { LISTING_TYPE_CAPABILITIES, capabilityFor, canAddToCart, canBid, support
 export type { ListingTypeCapability } from "./_internal/shared/listing-types/capabilities";
 export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_internal/shared/listing-types/_registry";
 export { OwnerQuickActions } from "./features/admin/components/OwnerQuickActions";
+export { RecordOwnerQuickActions } from "./features/admin/components/RecordOwnerQuickActions";
+export type { RecordOwnerQuickActionsProps, RecordQuickActionResource } from "./features/admin/components/RecordOwnerQuickActions";
 export type { OwnerQuickActionsProps, OwnerQuickActionsResource } from "./features/admin/components/OwnerQuickActions";
 export type { ListingTypePlugin } from "./_internal/shared/listing-types/_registry";
 export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules";

package/dist/index.js

@@ -5403,6 +5403,18 @@ export { taxCodesSeedData } from "./seed/index.js";
 // E4/D12 — the collection constants and types.
 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.js";
 export { partGlossarySeedData } from "./seed/index.js";
+/*
+ * 🛑 Exported from the MAIN barrel, not just `seed/index.ts`. `seed-cli.mjs`
+ * destructures its seed data from the BARE `@mohasinac/appkit` package, which
+ * resolves through THIS file — so an export present only on the inner barrel is
+ * invisible to the loader and the collection reports "no seed data, skipping"
+ * with exit 0. That is Root Cause #90 exactly, and it is how `mediaAssets`
+ * read "504 seed / 0 in db" while all 504 objects sat in the bucket.
+ */
+export { BEYS_COLLECTION, BEY_PRODUCTS_COLLECTION, beyId, } from "./features/beys/schemas/firestore.js";
+export { beysSeedData, BEY_SEED_COUNT } from "./seed/index.js";
+export { BeyDetailPageView } from "./features/beys/components/BeyDetailPageView.js";
+export { beyProductsSeedData, BEY_PRODUCT_SEED_COUNT } from "./seed/index.js";
 export { modelCompositionSeedData } from "./seed/index.js";
 // D12 — the public part surfaces.
 export { ModelCompositionPanel } from "./features/parts/components/ModelCompositionPanel.js";
@@ -5494,6 +5506,7 @@ export { LISTING_TYPE_CAPABILITIES, capabilityFor, canAddToCart, canBid, support
 export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_internal/shared/listing-types/_registry.js";
 // Pencil / clone / bin for whoever owns the record, on a PUBLIC surface.
 export { OwnerQuickActions } from "./features/admin/components/OwnerQuickActions.js";
+export { RecordOwnerQuickActions } from "./features/admin/components/RecordOwnerQuickActions.js";
 // Checkout rule registry â€" pure TS, safe in both client and server bundles.
 export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules/index.js";
 // Media upload limits â€" pure constants, safe in both client and server bundles.

package/dist/next/routing/route-map.d.ts

@@ -69,6 +69,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly HELP_AUCTIONS: "/help/auctions";
         readonly HELP_ORDERS: "/help/orders";
         readonly HELP_ACCOUNT: "/help/account";
+        readonly CREDITS: "/credits";
         readonly TERMS: "/terms";
         readonly PRIVACY: "/privacy";
         readonly ETHICS: "/ethics";
@@ -129,6 +130,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly PARTS: "/parts";
         readonly PART_CLASSIFICATION: (classification: string) => string;
         readonly PART_DETAIL: (classification: string, code: string) => string;
+        readonly BEY_DETAIL: (slug: string) => string;
         readonly SCAM_TYPES: "/scams/types";
         readonly SCAM_FAQS: "/scams/faqs";
         readonly CLASSIFIED: "/classified";
@@ -320,6 +322,10 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CATEGORIES: "/admin/categories";
         readonly CATEGORIES_NEW: "/admin/categories/new";
         readonly CATEGORIES_EDIT: (id: string) => string;
+        readonly PARTS: "/admin/parts";
+        readonly PARTS_EDIT: (id: string) => string;
+        readonly BEYS: "/admin/beys";
+        readonly BEYS_EDIT: (id: string) => string;
         readonly BRANDS: "/admin/brands";
         readonly BRANDS_NEW: "/admin/brands/new";
         readonly BRANDS_EDIT: (id: string) => string;
@@ -504,6 +510,7 @@ export declare const ROUTES: {
         readonly HELP_AUCTIONS: "/help/auctions";
         readonly HELP_ORDERS: "/help/orders";
         readonly HELP_ACCOUNT: "/help/account";
+        readonly CREDITS: "/credits";
         readonly TERMS: "/terms";
         readonly PRIVACY: "/privacy";
         readonly ETHICS: "/ethics";
@@ -564,6 +571,7 @@ export declare const ROUTES: {
         readonly PARTS: "/parts";
         readonly PART_CLASSIFICATION: (classification: string) => string;
         readonly PART_DETAIL: (classification: string, code: string) => string;
+        readonly BEY_DETAIL: (slug: string) => string;
         readonly SCAM_TYPES: "/scams/types";
         readonly SCAM_FAQS: "/scams/faqs";
         readonly CLASSIFIED: "/classified";
@@ -755,6 +763,10 @@ export declare const ROUTES: {
         readonly CATEGORIES: "/admin/categories";
         readonly CATEGORIES_NEW: "/admin/categories/new";
         readonly CATEGORIES_EDIT: (id: string) => string;
+        readonly PARTS: "/admin/parts";
+        readonly PARTS_EDIT: (id: string) => string;
+        readonly BEYS: "/admin/beys";
+        readonly BEYS_EDIT: (id: string) => string;
         readonly BRANDS: "/admin/brands";
         readonly BRANDS_NEW: "/admin/brands/new";
         readonly BRANDS_EDIT: (id: string) => string;
@@ -970,6 +982,6 @@ export declare const SELLER_ROUTES: {
     readonly GUIDE_CAPABILITIES: "/store/guide/capabilities";
     readonly GUIDE_SETTINGS: "/store/guide/settings";
 };
-export declare const PUBLIC_ROUTES: readonly ["/", string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, "/unauthorized", "/auth/login", "/auth/register", "/auth/forgot-password", "/auth/reset-password", "/auth/verify-email"];
+export declare const PUBLIC_ROUTES: readonly ["/", string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, "/unauthorized", "/auth/login", "/auth/register", "/auth/forgot-password", "/auth/reset-password", "/auth/verify-email"];
 export declare const PROTECTED_ROUTES: readonly [string, string, string, string, string, string, string];
 export declare const AUTH_ROUTES: readonly ["/auth/login", "/auth/register"];

package/dist/next/routing/route-map.js

@@ -83,6 +83,14 @@ export const DEFAULT_ROUTE_MAP = {
         HELP_AUCTIONS: "/help/auctions",
         HELP_ORDERS: "/help/orders",
         HELP_ACCOUNT: "/help/account",
+        /*
+         * 🛑 A LICENCE OBLIGATION, not a vanity page — which is why it is a route
+         * key and sits in PUBLIC_ROUTES. The facts across ~5,500 rows (parts, beys,
+         * products, characters) come from a CC-BY-SA community wiki; taking facts
+         * only and linking back is what keeps us clear of share-alike, and a
+         * link-back nobody can reach discharges nothing.
+         */
+        CREDITS: "/credits",
         TERMS: "/terms",
         PRIVACY: "/privacy",
         ETHICS: "/ethics",
@@ -194,6 +202,14 @@ export const DEFAULT_ROUTE_MAP = {
         PARTS: "/parts",
         PART_CLASSIFICATION: (classification) => `/parts/${classification}`,
         PART_DETAIL: (classification, code) => `/parts/${classification}/${code}`,
+        /*
+         * The BEY database. A reference surface like `/parts`, and a ONE-segment
+         * URL unlike it — a bey's id IS its slug, so the page is a direct doc read
+         * with no query and no index. Parts need the classification in the path
+         * because a code alone is ambiguous (`105` is a spin-track height in Metal
+         * Fight and a disc in Burst); a bey name is not.
+         */
+        BEY_DETAIL: (slug) => `/beys/${slug}`,
         SCAM_TYPES: "/scams/types",
         SCAM_FAQS: "/scams/faqs",
         CLASSIFIED: "/classified",
@@ -447,6 +463,24 @@ export const DEFAULT_ROUTE_MAP = {
         CATEGORIES: "/admin/categories",
         CATEGORIES_NEW: "/admin/categories/new",
         CATEGORIES_EDIT: (id) => `/admin/categories/${id}/edit`,
+        /*
+         * The two GENERATED reference databases — 2,488 parts and 1,988 beys.
+         *
+         * 🛑 THERE IS NO `PARTS_NEW` / `BEYS_NEW`, and that absence is the
+         * design. Both collections are produced by committed generators from a
+         * crawled corpus; a row created by hand would have no source, would not
+         * survive a regeneration, and would sit in a dataset whose whole value is
+         * that it reproduces from `appkit/src/seed/` alone. Admin may CORRECT and
+         * REMOVE a row — the two operations a wrong extraction needs — and adding
+         * one is a change to the generator.
+         *
+         * `audit-nav-page-wiring` is strict-zero on a route key with no page, so
+         * a key added here without its folder is a build failure, not a 404.
+         */
+        PARTS: "/admin/parts",
+        PARTS_EDIT: (id) => `/admin/parts/${id}/edit`,
+        BEYS: "/admin/beys",
+        BEYS_EDIT: (id) => `/admin/beys/${id}/edit`,
         BRANDS: "/admin/brands",
         BRANDS_NEW: "/admin/brands/new",
         BRANDS_EDIT: (id) => `/admin/brands/${id}/edit`,
@@ -636,6 +670,9 @@ export const PUBLIC_ROUTES = [
     ROUTES.PUBLIC.CONTACT,
     ROUTES.BLOG.LIST,
     ROUTES.PUBLIC.HELP,
+    /* Unauthenticated BY NECESSITY: an attribution a reader must sign in to see
+     * is not attribution. Same reasoning as the grievance-officer entry below. */
+    ROUTES.PUBLIC.CREDITS,
     ROUTES.PUBLIC.TERMS,
     ROUTES.PUBLIC.PRIVACY,
     ROUTES.PUBLIC.ETHICS,

package/dist/schemas/registry.d.ts

@@ -504,15 +504,15 @@ export declare const SCHEMAS: {
                     description?: string | undefined;
                     textColor?: string | undefined;
                     textAlign?: "center" | "left" | "right" | undefined;
-                    subtitle?: string | undefined;
                     eyebrow?: string | undefined;
+                    subtitle?: string | undefined;
                 }, {
                     title?: string | undefined;
                     description?: string | undefined;
                     textColor?: string | undefined;
                     textAlign?: "center" | "left" | "right" | undefined;
-                    subtitle?: string | undefined;
                     eyebrow?: string | undefined;
+                    subtitle?: string | undefined;
                 }>>;
                 buttons: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                     id: import("zod").ZodOptional<import("zod").ZodString>;
@@ -571,8 +571,8 @@ export declare const SCHEMAS: {
                     description?: string | undefined;
                     textColor?: string | undefined;
                     textAlign?: "center" | "left" | "right" | undefined;
-                    subtitle?: string | undefined;
                     eyebrow?: string | undefined;
+                    subtitle?: string | undefined;
                 } | undefined;
                 hover?: {
                     effect: "none" | "color" | "scale" | "glow";
@@ -612,8 +612,8 @@ export declare const SCHEMAS: {
                     description?: string | undefined;
                     textColor?: string | undefined;
                     textAlign?: "center" | "left" | "right" | undefined;
-                    subtitle?: string | undefined;
                     eyebrow?: string | undefined;
+                    subtitle?: string | undefined;
                 } | undefined;
                 hover?: {
                     effect: "none" | "color" | "scale" | "glow";
@@ -751,8 +751,8 @@ export declare const SCHEMAS: {
                     description?: string | undefined;
                     textColor?: string | undefined;
                     textAlign?: "center" | "left" | "right" | undefined;
-                    subtitle?: string | undefined;
                     eyebrow?: string | undefined;
+                    subtitle?: string | undefined;
                 } | undefined;
                 hover?: {
                     effect: "none" | "color" | "scale" | "glow";
@@ -860,8 +860,8 @@ export declare const SCHEMAS: {
                     description?: string | undefined;
                     textColor?: string | undefined;
                     textAlign?: "center" | "left" | "right" | undefined;
-                    subtitle?: string | undefined;
                     eyebrow?: string | undefined;
+                    subtitle?: string | undefined;
                 } | undefined;
                 hover?: {
                     effect: "none" | "color" | "scale" | "glow";