@mohasinac/appkit 2.6.1 → 2.6.2

package/dist/_internal/shared/features/cart/schema.d.ts

@@ -8,7 +8,7 @@ export declare const addToCartSchema: z.ZodObject<{
     storeId: z.ZodString;
     storeName: z.ZodDefault<z.ZodString>;
     quantity: z.ZodDefault<z.ZodNumber>;
-    listingType: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "bundle"]>;
+    listingType: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw"]>;
     isOffer: z.ZodOptional<z.ZodBoolean>;
     offerId: z.ZodOptional<z.ZodString>;
     lockedPrice: z.ZodOptional<z.ZodNumber>;
@@ -20,7 +20,7 @@ export declare const addToCartSchema: z.ZodObject<{
     productTitle: string;
     productImage: string;
     price: number;
-    listingType: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle";
+    listingType: "auction" | "standard" | "prize-draw" | "pre-order";
     storeName: string;
     offerId?: string | undefined;
     lockedPrice?: number | undefined;
@@ -30,7 +30,7 @@ export declare const addToCartSchema: z.ZodObject<{
     productId: string;
     productTitle: string;
     price: number;
-    listingType: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle";
+    listingType: "auction" | "standard" | "prize-draw" | "pre-order";
     currency?: string | undefined;
     quantity?: number | undefined;
     productImage?: string | undefined;
@@ -66,7 +66,7 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         storeId: z.ZodString;
         storeName: z.ZodDefault<z.ZodString>;
         quantity: z.ZodDefault<z.ZodNumber>;
-        listingType: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "bundle"]>;
+        listingType: z.ZodEnum<["standard", "auction", "pre-order", "prize-draw"]>;
         isOffer: z.ZodOptional<z.ZodBoolean>;
         offerId: z.ZodOptional<z.ZodString>;
         lockedPrice: z.ZodOptional<z.ZodNumber>;
@@ -78,7 +78,7 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         productTitle: string;
         productImage: string;
         price: number;
-        listingType: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle";
+        listingType: "auction" | "standard" | "prize-draw" | "pre-order";
         storeName: string;
         offerId?: string | undefined;
         lockedPrice?: number | undefined;
@@ -88,7 +88,7 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         productId: string;
         productTitle: string;
         price: number;
-        listingType: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle";
+        listingType: "auction" | "standard" | "prize-draw" | "pre-order";
         currency?: string | undefined;
         quantity?: number | undefined;
         productImage?: string | undefined;
@@ -106,7 +106,7 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         productTitle: string;
         productImage: string;
         price: number;
-        listingType: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle";
+        listingType: "auction" | "standard" | "prize-draw" | "pre-order";
         storeName: string;
         offerId?: string | undefined;
         lockedPrice?: number | undefined;
@@ -118,7 +118,7 @@ export declare const mergeGuestCartSchema: z.ZodObject<{
         productId: string;
         productTitle: string;
         price: number;
-        listingType: "auction" | "standard" | "pre-order" | "prize-draw" | "bundle";
+        listingType: "auction" | "standard" | "prize-draw" | "pre-order";
         currency?: string | undefined;
         quantity?: number | undefined;
         productImage?: string | undefined;

package/dist/_internal/shared/features/cart/schema.js

@@ -9,12 +9,12 @@ const cartItemBaseSchema = z.object({
     storeName: z.string().default(""),
     quantity: z.number().int().min(1).max(99).default(1),
     // SB1-G Phase 4 — canonical listing-kind snapshot.
+    // SB-UNI-D — "bundle" removed from the listing-kind enum.
     listingType: z.enum([
         "standard",
         "auction",
         "pre-order",
         "prize-draw",
-        "bundle",
     ]),
     isOffer: z.boolean().optional(),
     offerId: z.string().optional(),

package/dist/_internal/shared/features/categories/bundle-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Bundle config — SB-UNI-V.
+ *
+ * Constants that used to live in `_internal/shared/features/bundles/config.ts`
+ * before bundles were folded into the categories collection as
+ * `categoryType:"bundle"` rows.
+ */
+/** Minimum products allowed in a bundle's `bundleQueryRule`. */
+export declare const BUNDLE_MIN_ITEMS: 3;
+/** Maximum products allowed in a bundle's `bundleQueryRule`. */
+export declare const BUNDLE_MAX_ITEMS: 16;
+/** Default per-user purchase cap when the bundle category doesn't override. */
+export declare const BUNDLE_MAX_PER_USER_DEFAULT: 3;
+/** Page size for `/api/categories?categoryType=bundle` listing. */
+export declare const BUNDLES_PAGE_SIZE: 24;
+/** Cap on homepage featured-bundles strip. */
+export declare const BUNDLES_FEATURED_LIMIT: 12;

package/dist/_internal/shared/features/categories/bundle-config.js

@@ -0,0 +1,17 @@
+/**
+ * Bundle config — SB-UNI-V.
+ *
+ * Constants that used to live in `_internal/shared/features/bundles/config.ts`
+ * before bundles were folded into the categories collection as
+ * `categoryType:"bundle"` rows.
+ */
+/** Minimum products allowed in a bundle's `bundleQueryRule`. */
+export const BUNDLE_MIN_ITEMS = 3;
+/** Maximum products allowed in a bundle's `bundleQueryRule`. */
+export const BUNDLE_MAX_ITEMS = 16;
+/** Default per-user purchase cap when the bundle category doesn't override. */
+export const BUNDLE_MAX_PER_USER_DEFAULT = 3;
+/** Page size for `/api/categories?categoryType=bundle` listing. */
+export const BUNDLES_PAGE_SIZE = 24;
+/** Cap on homepage featured-bundles strip. */
+export const BUNDLES_FEATURED_LIMIT = 12;

package/dist/_internal/shared/features/layout/config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Layout feature — shared config constants.
+ *
+ * Pixel widths, breakpoint values, default classNames. All sections read from
+ * here so the responsive contract is single-sourced.
+ */
+import type { DashboardVariant, LayoutBreakpoint } from "./types";
+/** Drawer (slide-out) width tokens — Tailwind classnames. */
+export declare const SIDE_DRAWER_WIDTH: Record<"sm" | "md" | "lg", string>;
+/** Persistent dashboard sidebar rail width (collapsed/expanded). */
+export declare const DASHBOARD_SIDEBAR_WIDTH: {
+    expanded: string;
+    compact: string;
+};
+/** Per-variant accent token map. Drives DashboardSidebar active-item styling. */
+export declare const DASHBOARD_ACCENT_CLASSES: Record<DashboardVariant, {
+    activeBg: string;
+    activeText: string;
+    hoverBg: string;
+}>;
+/** hideAt → Tailwind class. `md:hidden` etc. */
+export declare function hideAtClass(bp: LayoutBreakpoint | undefined): string;
+/** showAt → Tailwind class. `md:block` etc. */
+export declare function showAtClass(bp: LayoutBreakpoint | undefined, display?: string): string;
+/** Default bottom-nav padding to reserve space (mobile only). */
+export declare const BOTTOM_NAV_CONTENT_PADDING = "pb-16 md:pb-0";
+/** Sticky-header CSS custom property — written by AppLayoutShell / AppShellServer. */
+export declare const HEADER_HEIGHT_CSS_VAR = "--header-height";
+/**
+ * Desktop breakpoint for dashboard drawer behaviour. Mirrors Tailwind's `md` (768px).
+ * Exported so DashboardLayoutClient can call `window.matchMedia(DASHBOARD_DESKTOP_MEDIA_QUERY)`
+ * without re-hardcoding the value across every layout consumer.
+ */
+export declare const DASHBOARD_DESKTOP_BREAKPOINT_PX = 768;
+export declare const DASHBOARD_DESKTOP_MEDIA_QUERY = "(min-width: 768px)";

package/dist/_internal/shared/features/layout/config.js

@@ -0,0 +1,58 @@
+/**
+ * Layout feature — shared config constants.
+ *
+ * Pixel widths, breakpoint values, default classNames. All sections read from
+ * here so the responsive contract is single-sourced.
+ */
+/** Drawer (slide-out) width tokens — Tailwind classnames. */
+export const SIDE_DRAWER_WIDTH = {
+    sm: "w-72",
+    md: "w-80",
+    lg: "w-96",
+};
+/** Persistent dashboard sidebar rail width (collapsed/expanded). */
+export const DASHBOARD_SIDEBAR_WIDTH = {
+    expanded: "lg:w-64",
+    compact: "lg:w-16",
+};
+/** Per-variant accent token map. Drives DashboardSidebar active-item styling. */
+export const DASHBOARD_ACCENT_CLASSES = {
+    admin: {
+        activeBg: "bg-zinc-100 dark:bg-slate-800",
+        activeText: "text-zinc-900 dark:text-zinc-100",
+        hoverBg: "hover:bg-zinc-50 dark:hover:bg-slate-800/60",
+    },
+    store: {
+        activeBg: "bg-orange-50 dark:bg-orange-900/20",
+        activeText: "text-orange-700 dark:text-orange-300",
+        hoverBg: "hover:bg-zinc-50 dark:hover:bg-slate-800/60",
+    },
+    user: {
+        activeBg: "bg-primary-50 dark:bg-primary-900/25",
+        activeText: "text-primary-700 dark:text-primary-300",
+        hoverBg: "hover:bg-zinc-50 dark:hover:bg-slate-800",
+    },
+};
+/** hideAt → Tailwind class. `md:hidden` etc. */
+export function hideAtClass(bp) {
+    if (!bp)
+        return "";
+    return `${bp}:hidden`;
+}
+/** showAt → Tailwind class. `md:block` etc. */
+export function showAtClass(bp, display = "block") {
+    if (!bp)
+        return "";
+    return `hidden ${bp}:${display}`;
+}
+/** Default bottom-nav padding to reserve space (mobile only). */
+export const BOTTOM_NAV_CONTENT_PADDING = "pb-16 md:pb-0";
+/** Sticky-header CSS custom property — written by AppLayoutShell / AppShellServer. */
+export const HEADER_HEIGHT_CSS_VAR = "--header-height";
+/**
+ * Desktop breakpoint for dashboard drawer behaviour. Mirrors Tailwind's `md` (768px).
+ * Exported so DashboardLayoutClient can call `window.matchMedia(DASHBOARD_DESKTOP_MEDIA_QUERY)`
+ * without re-hardcoding the value across every layout consumer.
+ */
+export const DASHBOARD_DESKTOP_BREAKPOINT_PX = 768;
+export const DASHBOARD_DESKTOP_MEDIA_QUERY = `(min-width: ${DASHBOARD_DESKTOP_BREAKPOINT_PX}px)`;

package/dist/_internal/shared/features/layout/index.d.ts

@@ -0,0 +1,3 @@
+/** Layout feature — shared types + config barrel. */
+export type { LayoutBreakpoint, DashboardVariant, LayoutRole, SidebarNavItem, SidebarNavGroup, MainNavItem, BrandingConfig, FooterLinkGroup, FooterTrustBarItem, FooterSocialLink, FooterConfig, SectionResponsive, SectionTheming, LayoutConfig, DashboardLayoutConfig, } from "./types";
+export { SIDE_DRAWER_WIDTH, DASHBOARD_SIDEBAR_WIDTH, DASHBOARD_ACCENT_CLASSES, hideAtClass, showAtClass, BOTTOM_NAV_CONTENT_PADDING, HEADER_HEIGHT_CSS_VAR, DASHBOARD_DESKTOP_BREAKPOINT_PX, DASHBOARD_DESKTOP_MEDIA_QUERY, } from "./config";

package/dist/_internal/shared/features/layout/index.js

@@ -0,0 +1,2 @@
+/** Layout feature — shared types + config barrel. */
+export { SIDE_DRAWER_WIDTH, DASHBOARD_SIDEBAR_WIDTH, DASHBOARD_ACCENT_CLASSES, hideAtClass, showAtClass, BOTTOM_NAV_CONTENT_PADDING, HEADER_HEIGHT_CSS_VAR, DASHBOARD_DESKTOP_BREAKPOINT_PX, DASHBOARD_DESKTOP_MEDIA_QUERY, } from "./config";

package/dist/_internal/shared/features/layout/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Layout feature — shared types.
+ *
+ * These types describe the pure-data configuration surfaces for every layout
+ * section. They are framework-agnostic; consumers pass them into server or
+ * client section components as props.
+ *
+ * Three-layer override contract (see CLAUDE.md SSR Architecture §Encapsulation):
+ *  1. Config props (this file's types).
+ *  2. render-prop slots on each section (defined on the section component itself).
+ *  3. Section replacement via AppShell named slots.
+ */
+import type { ReactNode } from "react";
+/** Tailwind breakpoint keys used by responsive visibility props. */
+export type LayoutBreakpoint = "sm" | "md" | "lg" | "xl";
+/** A discriminator for the three dashboard surfaces. Drives accent colour + sidebar component selection. */
+export type DashboardVariant = "admin" | "store" | "user";
+/** Role tokens recognised by RoleGuard (mirrors appkit's UserRole). */
+export type LayoutRole = "admin" | "seller" | "moderator" | "employee" | "user";
+/** Single sidebar/nav link. */
+export interface SidebarNavItem {
+    href: string;
+    label: string;
+    icon?: ReactNode;
+    badge?: number;
+}
+/** Sidebar group with title + items + default-open state. */
+export interface SidebarNavGroup {
+    title: string;
+    items: SidebarNavItem[];
+    defaultOpen?: boolean;
+}
+/** Top-level main-nav item (horizontal nav, ≥lg). */
+export interface MainNavItem {
+    href: string;
+    label: string;
+    icon?: ReactNode;
+    /** Translation key (consumer fills in `label` at render time via t(key)). */
+    key?: string;
+}
+/** Branding config — propagated to TitleBar / Footer / mobile chrome. */
+export interface BrandingConfig {
+    name: string;
+    shortName?: string;
+    description?: string;
+    logoUrl?: string;
+    logoHref?: string;
+    copyrightText?: string;
+    madeInText?: string;
+}
+/** Footer config (used by FooterServer + the existing FooterLayout). */
+export interface FooterLinkGroup {
+    title: string;
+    links: {
+        href: string;
+        label: string;
+    }[];
+}
+export interface FooterTrustBarItem {
+    icon?: ReactNode;
+    label: string;
+    description?: string;
+}
+export interface FooterSocialLink {
+    href: string;
+    label: string;
+    icon?: ReactNode;
+}
+export interface FooterConfig {
+    branding: Pick<BrandingConfig, "name" | "description" | "copyrightText" | "madeInText">;
+    linkGroups: FooterLinkGroup[];
+    trustBarItems?: FooterTrustBarItem[];
+    socialLinks?: FooterSocialLink[];
+    bottomLinks?: {
+        href: string;
+        label: string;
+    }[];
+    showTrustBar?: boolean;
+    tone?: "dark" | "light" | "match";
+}
+/** Section-level responsive controls — every section accepts these. */
+export interface SectionResponsive {
+    hideAt?: LayoutBreakpoint;
+    showAt?: LayoutBreakpoint;
+    compactAt?: LayoutBreakpoint;
+}
+/** Section-level theming knobs — every section accepts these. */
+export interface SectionTheming {
+    /** Surface variant. Each section interprets these in its own way. */
+    variant?: "default" | "transparent" | "elevated" | "muted" | "subtle";
+    /** Accent token override (resolves to --appkit-color-<accent>). */
+    accent?: "primary" | "secondary" | "success" | "warning" | "danger";
+    /** Background variant for shell-level backgrounds. */
+    backgroundVariant?: "default" | "muted" | "subtle";
+    /** Free-form className to merge with the section's root. */
+    className?: string;
+}
+/** Top-level layout config (public surface). */
+export interface LayoutConfig {
+    branding: BrandingConfig;
+    mainNav: {
+        items: MainNavItem[];
+        hiddenAt?: LayoutBreakpoint;
+    };
+    sideDrawer?: {
+        title?: string;
+        sections: SidebarNavGroup[];
+        width?: "sm" | "md" | "lg";
+        position?: "left" | "right";
+    };
+    footer: FooterConfig;
+    bottomNav?: {
+        items: SidebarNavItem[];
+    };
+    /** Admin-overridable theme tokens (CSS variables) — written to :root / .dark by the server scaffold. */
+    theme?: {
+        primary?: string;
+        secondary?: string;
+        accent?: string;
+        primaryDark?: string;
+        secondaryDark?: string;
+        accentDark?: string;
+    };
+}
+/** Per-dashboard layout config. */
+export interface DashboardLayoutConfig {
+    variant: DashboardVariant;
+    role: LayoutRole | LayoutRole[];
+    groups: SidebarNavGroup[];
+    /** Path resolution for active-link highlight. */
+    activeHref?: string;
+    /** Optional rail collapse behaviour. */
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+    responsive?: SectionResponsive;
+    theming?: SectionTheming;
+}

package/dist/_internal/shared/features/layout/types.js

@@ -0,0 +1,13 @@
+/**
+ * Layout feature — shared types.
+ *
+ * These types describe the pure-data configuration surfaces for every layout
+ * section. They are framework-agnostic; consumers pass them into server or
+ * client section components as props.
+ *
+ * Three-layer override contract (see CLAUDE.md SSR Architecture §Encapsulation):
+ *  1. Config props (this file's types).
+ *  2. render-prop slots on each section (defined on the section component itself).
+ *  3. Section replacement via AppShell named slots.
+ */
+export {};

package/dist/_internal/shared/features/products/types.d.ts

@@ -21,7 +21,7 @@ export interface ProductDetailInitial {
     tags: string[];
     condition?: string;
     /** Canonical listing-kind discriminator (SB1-G — Phase 4 dropped legacy booleans). */
-    listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle";
+    listingType?: "standard" | "auction" | "pre-order" | "prize-draw";
     auctionEndDate?: string;
     startingBid?: number;
     currentBid?: number;

package/dist/_internal/shared/listing-types/_registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Listing-type plugin registry — SB-UNI X2.
+ *
+ * Adding a new listing type later means:
+ *   1. Add a folder `<type>/{config,schema,ctas,og,seed-factory}.ts`
+ *   2. Add a row to `LISTING_TYPE_CAPABILITIES` in `./capabilities.ts`
+ *   3. Add the import + entry below
+ *
+ * No grep-the-codebase sweep required. Future-expansion Pattern 3.
+ */
+import { LISTING_TYPE_CAPABILITIES } from "./capabilities";
+import type { ListingType } from "../../../features/products/types/index";
+export interface ListingTypePlugin {
+    listingType: ListingType;
+    slugPrefix: string;
+    cartLine: "single-product" | "blocked" | "bundle-expand";
+}
+export declare const LISTING_TYPE_REGISTRY: {
+    readonly standard: {
+        listingType: "standard";
+        slugPrefix: string;
+        cartLine: "single-product";
+    };
+    readonly auction: {
+        listingType: "auction";
+        slugPrefix: string;
+        cartLine: "blocked";
+    };
+    readonly "pre-order": {
+        listingType: "pre-order";
+        slugPrefix: string;
+        cartLine: "single-product";
+    };
+    readonly "prize-draw": {
+        listingType: "prize-draw";
+        slugPrefix: string;
+        cartLine: "single-product";
+    };
+};
+export declare function pluginFor(type: ListingType): {
+    listingType: "standard";
+    slugPrefix: string;
+    cartLine: "single-product";
+} | {
+    listingType: "auction";
+    slugPrefix: string;
+    cartLine: "blocked";
+} | {
+    listingType: "pre-order";
+    slugPrefix: string;
+    cartLine: "single-product";
+} | {
+    listingType: "prize-draw";
+    slugPrefix: string;
+    cartLine: "single-product";
+};
+export { LISTING_TYPE_CAPABILITIES };

package/dist/_internal/shared/listing-types/_registry.js

@@ -0,0 +1,28 @@
+/**
+ * Listing-type plugin registry — SB-UNI X2.
+ *
+ * Adding a new listing type later means:
+ *   1. Add a folder `<type>/{config,schema,ctas,og,seed-factory}.ts`
+ *   2. Add a row to `LISTING_TYPE_CAPABILITIES` in `./capabilities.ts`
+ *   3. Add the import + entry below
+ *
+ * No grep-the-codebase sweep required. Future-expansion Pattern 3.
+ */
+import * as standard from "./standard/config";
+import * as auction from "./auction/config";
+import * as preOrder from "./pre-order/config";
+import * as prizeDraw from "./prize-draw/config";
+import { LISTING_TYPE_CAPABILITIES } from "./capabilities";
+// SB-UNI-D — bundle entry removed; bundles are a categoryType, not a listingType.
+export const LISTING_TYPE_REGISTRY = {
+    standard: standard.config,
+    auction: auction.config,
+    "pre-order": preOrder.config,
+    "prize-draw": prizeDraw.config,
+};
+export function pluginFor(type) {
+    return LISTING_TYPE_REGISTRY[type];
+}
+// Re-export the capability map so consumers can pull both surfaces from
+// the same module path.
+export { LISTING_TYPE_CAPABILITIES };

package/dist/_internal/shared/listing-types/auction/config.d.ts

@@ -0,0 +1,7 @@
+export declare const LISTING_TYPE: "auction";
+export declare const capability: import("../capabilities").ListingTypeCapability;
+export declare const config: {
+    listingType: "auction";
+    slugPrefix: string;
+    cartLine: "blocked";
+};

package/dist/_internal/shared/listing-types/auction/config.js

@@ -0,0 +1,8 @@
+import { LISTING_TYPE_CAPABILITIES } from "../capabilities";
+export const LISTING_TYPE = "auction";
+export const capability = LISTING_TYPE_CAPABILITIES.auction;
+export const config = {
+    listingType: LISTING_TYPE,
+    slugPrefix: "auction-",
+    cartLine: "blocked",
+};

package/dist/_internal/shared/listing-types/auction/ctas.d.ts

@@ -0,0 +1 @@
+export declare const ctas: readonly string[];

package/dist/_internal/shared/listing-types/auction/ctas.js

@@ -0,0 +1,2 @@
+// SB-UNI X2 — placeholder. Phase 7 (W-1) wires the CTA registry.
+export const ctas = [];

package/dist/_internal/shared/listing-types/auction/og.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/_internal/shared/listing-types/auction/og.js

@@ -0,0 +1 @@
+export {};

package/dist/_internal/shared/listing-types/auction/schema.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/_internal/shared/listing-types/auction/schema.js

@@ -0,0 +1 @@
+export {};

package/dist/_internal/shared/listing-types/auction/seed-factory.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/_internal/shared/listing-types/auction/seed-factory.js

@@ -0,0 +1 @@
+export {};

package/dist/_internal/shared/listing-types/capabilities.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Listing-type capability registry — Pattern 1 + 2 from the SB-UNI plan.
+ *
+ * Every consumer that needs to branch on listing type reads from this
+ * registry rather than writing `if (listingType === "X")`. Adding a new
+ * listing type later means adding one row here + one folder under
+ * `_internal/shared/listing-types/<type>/` — no scattered grep needed.
+ *
+ * Capabilities are intentionally minimal — only behavioral facts that
+ * cross feature boundaries. Per-type rendering / form layout / SEO live
+ * inside the per-type folder (X2 plugin layout).
+ */
+import type { ListingType } from "../../../features/products/types/index";
+export interface ListingTypeCapability {
+    /** Buyers can add this listing to a cart and check out. */
+    canAddToCart: boolean;
+    /** Listing accepts bid placements. */
+    canBid: boolean;
+    /** Listing has physical fulfillment (drives shipping address requirement). */
+    supportsShipping: boolean;
+    /** Seller must be a verified vendor for KYC-gated listings. */
+    requiresVendorVerified: boolean;
+    /** Checkout must validate buyer jurisdiction (regulated items). */
+    requiresJurisdictionCheck: boolean;
+    /** Listing fulfills immediately on purchase (no shipping label flow). */
+    hasInstantFulfillment: boolean;
+}
+export declare const LISTING_TYPE_CAPABILITIES: Record<ListingType, ListingTypeCapability>;
+export declare function capabilityFor(type: ListingType): ListingTypeCapability;
+export declare function canAddToCart(type: ListingType): boolean;
+export declare function canBid(type: ListingType): boolean;
+export declare function supportsShipping(type: ListingType): boolean;
+export declare function requiresVendorVerified(type: ListingType): boolean;
+export declare function requiresJurisdictionCheck(type: ListingType): boolean;
+export declare function hasInstantFulfillment(type: ListingType): boolean;
+/**
+ * Exhaustive-switch helper. Use in `switch (type) { case ...: default: assertNever(type); }`
+ * so adding a new `ListingType` member is a TS error at every consumer
+ * that didn't update.
+ */
+export declare function assertNever(value: never): never;

package/dist/_internal/shared/listing-types/capabilities.js

@@ -0,0 +1,75 @@
+/**
+ * Listing-type capability registry — Pattern 1 + 2 from the SB-UNI plan.
+ *
+ * Every consumer that needs to branch on listing type reads from this
+ * registry rather than writing `if (listingType === "X")`. Adding a new
+ * listing type later means adding one row here + one folder under
+ * `_internal/shared/listing-types/<type>/` — no scattered grep needed.
+ *
+ * Capabilities are intentionally minimal — only behavioral facts that
+ * cross feature boundaries. Per-type rendering / form layout / SEO live
+ * inside the per-type folder (X2 plugin layout).
+ */
+export const LISTING_TYPE_CAPABILITIES = {
+    standard: {
+        canAddToCart: true,
+        canBid: false,
+        supportsShipping: true,
+        requiresVendorVerified: false,
+        requiresJurisdictionCheck: false,
+        hasInstantFulfillment: false,
+    },
+    auction: {
+        canAddToCart: false,
+        canBid: true,
+        supportsShipping: true,
+        requiresVendorVerified: false,
+        requiresJurisdictionCheck: false,
+        hasInstantFulfillment: false,
+    },
+    "pre-order": {
+        canAddToCart: true,
+        canBid: false,
+        supportsShipping: true,
+        requiresVendorVerified: false,
+        requiresJurisdictionCheck: false,
+        hasInstantFulfillment: false,
+    },
+    "prize-draw": {
+        canAddToCart: true,
+        canBid: false,
+        supportsShipping: true,
+        requiresVendorVerified: false,
+        requiresJurisdictionCheck: false,
+        hasInstantFulfillment: false,
+    },
+};
+export function capabilityFor(type) {
+    return LISTING_TYPE_CAPABILITIES[type];
+}
+export function canAddToCart(type) {
+    return LISTING_TYPE_CAPABILITIES[type].canAddToCart;
+}
+export function canBid(type) {
+    return LISTING_TYPE_CAPABILITIES[type].canBid;
+}
+export function supportsShipping(type) {
+    return LISTING_TYPE_CAPABILITIES[type].supportsShipping;
+}
+export function requiresVendorVerified(type) {
+    return LISTING_TYPE_CAPABILITIES[type].requiresVendorVerified;
+}
+export function requiresJurisdictionCheck(type) {
+    return LISTING_TYPE_CAPABILITIES[type].requiresJurisdictionCheck;
+}
+export function hasInstantFulfillment(type) {
+    return LISTING_TYPE_CAPABILITIES[type].hasInstantFulfillment;
+}
+/**
+ * Exhaustive-switch helper. Use in `switch (type) { case ...: default: assertNever(type); }`
+ * so adding a new `ListingType` member is a TS error at every consumer
+ * that didn't update.
+ */
+export function assertNever(value) {
+    throw new Error(`Unhandled discriminant: ${String(value)}`);
+}

package/dist/_internal/shared/listing-types/pre-order/config.d.ts

@@ -0,0 +1,7 @@
+export declare const LISTING_TYPE: "pre-order";
+export declare const capability: import("../capabilities").ListingTypeCapability;
+export declare const config: {
+    listingType: "pre-order";
+    slugPrefix: string;
+    cartLine: "single-product";
+};

package/dist/_internal/shared/listing-types/pre-order/config.js

@@ -0,0 +1,8 @@
+import { LISTING_TYPE_CAPABILITIES } from "../capabilities";
+export const LISTING_TYPE = "pre-order";
+export const capability = LISTING_TYPE_CAPABILITIES["pre-order"];
+export const config = {
+    listingType: LISTING_TYPE,
+    slugPrefix: "preorder-",
+    cartLine: "single-product",
+};

package/dist/_internal/shared/listing-types/pre-order/ctas.d.ts

@@ -0,0 +1 @@
+export declare const ctas: readonly string[];