@mohasinac/appkit 4.59.0 → 4.60.0

package/dist/features/inventory/schemas/firestore.d.ts

@@ -0,0 +1,197 @@
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+export declare const STORAGE_BOXES_COLLECTION = "storageBoxes";
+export declare const INVENTORY_PLACEMENTS_COLLECTION = "inventoryPlacements";
+export declare const INVENTORY_MOVEMENTS_COLLECTION = "inventoryMovements";
+/**
+ * The two box sizes actually owned.
+ *
+ * 🛑 A TS UNION, not a seeded reference list, and this was one of the plan's
+ * open questions. The deciding argument is that the LABEL GEOMETRY depends on
+ * it: a box label's dimensions are chosen per type, so a third type is a code
+ * change in the label profiles whatever the data model says. A seeded list
+ * would let an admin create an `AC90` that no label profile can print, and
+ * discover it at the printer.
+ *
+ * Adding a type is therefore deliberately a two-line code change plus a
+ * profile, not a form submission.
+ */
+/**
+ * How many rows the receive station stages before it must commit.
+ *
+ * 🛑 THIS IS A FIRESTORE LIMIT, NOT A UI PREFERENCE. A transaction caps at 500
+ * writes and each received row is two of them (the placement and its movement
+ * row), so 50 rows is 100 writes with ample room for the ledger growing a
+ * field later. The whole table commits in ONE transaction because the operator
+ * has already physically filled the boxes — a partial write leaves the ledger
+ * disagreeing with the shelf and nothing saying which rows landed.
+ *
+ * 🛑 Declared here so the route and the station cannot disagree. It was a
+ * local `MAX_ROWS` in the route and a second literal in the view for one
+ * revision, which is the two-owners shape that drifts the moment either moves
+ * (Root Cause #42) — and the failure would be silent in the worst direction:
+ * a UI cap above the route's gives the operator a full table and a 400.
+ */
+export declare const MAX_RECEIVE_ROWS = 50;
+export declare const BoxTypeValues: readonly ["AC60", "AC30"];
+export type BoxType = (typeof BoxTypeValues)[number];
+/**
+ * `retired` rather than deleting: a box's movements are permanent, and a
+ * ledger row pointing at a box that no longer exists cannot be read back.
+ */
+export declare const BoxStatusValues: readonly ["active", "full", "retired"];
+export type BoxStatus = (typeof BoxStatusValues)[number];
+/**
+ * Why stock moved. Every movement has one.
+ *
+ * `receive`  inbound from a procurement shipment
+ * `move`     box → box
+ * `pick`     out of a box, for an order
+ * `adjust`   a human reconciling a variance they investigated
+ * `audit`    a count that AGREED — recorded so "last verified" is answerable
+ *
+ * 🛑 `pick` is MANUAL and does not auto-fire from checkout — the other open
+ * question in the plan. An automatic decrement would have the ledger assert a
+ * movement nobody performed: the stock is sold, but it is still in the box
+ * until someone walks over and takes it out. A ledger that records intentions
+ * rather than actions cannot be used to find a missing item, which is its
+ * only real job.
+ */
+export declare const MovementKindValues: readonly ["receive", "move", "pick", "adjust", "audit"];
+export type MovementKind = (typeof MovementKindValues)[number];
+export interface StorageBoxDocument extends BaseDocument {
+    /**
+     * `AC60-03` — what is written on the physical label.
+     *
+     * 🛑 The id is `storagebox-{code}` and this is a PURE SLUG: a second
+     * `AC60-03` *is* the same box. A generated id would let two registry rows
+     * describe one physical object, and then "where is this" has two answers
+     * with no way to tell which shelf was meant.
+     */
+    code: string;
+    boxType: BoxType;
+    /** The number in the code, denormalised so a list can sort numerically. */
+    ordinal: number;
+    status: BoxStatus;
+    /** Free text — "shelf B, second from top". Deliberately not a taxonomy. */
+    location?: string;
+    /** "fits ~40 Burst tops" — a human's note, never a computed capacity. */
+    capacityNote?: string;
+    /**
+     * Rollups, for a list that does not fan out one read per box.
+     *
+     * 🛑 Maintained by a SCHEDULED REPAIR JOB, never a Firestore trigger. A
+     * trigger on a collection it also writes back to is Root Cause #92's exact
+     * shape — the one that cost 12M invocations against a 2M/month quota,
+     * because its no-op guard used `JSON.stringify` on a map whose key order
+     * Firestore does not preserve. A scheduled recompute cannot recurse.
+     *
+     * Treat as ADVISORY. `inventoryPlacements` is the truth; this is a cache.
+     */
+    rollup?: {
+        distinctProducts: number;
+        totalUnits: number;
+        computedAt: Date;
+    };
+    /** Word-prefix search tokens. Derived on write. */
+    searchTxt?: string[];
+}
+/**
+ * How many of one product are in one box, right now.
+ *
+ * 🛑 The id is DETERMINISTIC — `${boxId}__${productId}` — which makes "is X
+ * in Y" an O(1) document read and makes the write an idempotent upsert. With
+ * a generated id, the same question is a two-field query needing its own
+ * composite index, and a double-submit creates a second row for the same
+ * pair that silently doubles the count.
+ *
+ * `__` as the separator because both ids contain `-` (`storagebox-ac60-03`,
+ * `product-beyblade-x-dran-sword`), so a single hyphen could not be split
+ * back apart.
+ */
+export interface InventoryPlacementDocument extends BaseDocument {
+    boxId: string;
+    productId: string;
+    /** Always ≥ 1. A zero placement is deleted — see the header. */
+    quantity: number;
+    /** "slot 4", "front left" — optional, free text, for a big box. */
+    slot?: string;
+    boxCode: string;
+    productTitle: string;
+    /** The human stock key at the time of placement — what is on the label. */
+    productSku?: string;
+}
+/**
+ * One movement. Append-only.
+ *
+ * 🛑 `quantity` IS ALWAYS POSITIVE. Direction is carried by `from`/`to`, not
+ * by the sign — a signed quantity means every reader has to agree on what a
+ * negative means, and the first one that disagrees double-counts. A `receive`
+ * has no `from`; a `pick` has no `to`; a `move` has both.
+ *
+ * Immutability is enforced by the repository overriding `update` and `delete`
+ * to throw, and by `audit-inventory-ledger-append-only`. A ledger that can be
+ * edited is a ledger nobody can use as evidence.
+ */
+export interface InventoryMovementDocument extends BaseDocument {
+    kind: MovementKind;
+    productId: string;
+    /** Always positive. See the header. */
+    quantity: number;
+    /** Absent on `receive` — stock came from outside the system. */
+    fromBoxId?: string;
+    /** Absent on `pick` — stock left the system. */
+    toBoxId?: string;
+    /** When it physically happened, which is not always when it was recorded. */
+    occurredAt: Date;
+    /** Who did it. A uid, never a name — this collection is not PII-encrypted. */
+    actorUid: string;
+    /** Required on `adjust`: a variance nobody explained is not reconciled. */
+    reason?: string;
+    /** The procurement shipment a `receive` came from, when there was one. */
+    shipmentId?: string;
+    /** Denormalised for a readable ledger. Advisory, like the placement's. */
+    productTitle?: string;
+    fromBoxCode?: string;
+    toBoxCode?: string;
+}
+/**
+ * The deterministic placement id.
+ *
+ * One definition, used by the repository, the receive station and the seed —
+ * a second copy of this string concatenation is a second answer to "is X in
+ * Y", and the two would disagree the first time one of them changed.
+ */
+export declare function placementId(boxId: string, productId: string): string;
+/** Field-name constants, so a query never spells a path by hand. */
+export declare const STORAGE_BOX_FIELDS: {
+    readonly CODE: "code";
+    readonly BOX_TYPE: "boxType";
+    readonly ORDINAL: "ordinal";
+    readonly STATUS: "status";
+    readonly LOCATION: "location";
+    readonly SEARCH_TXT: "searchTxt";
+    readonly CREATED_AT: "createdAt";
+    readonly UPDATED_AT: "updatedAt";
+};
+export declare const INVENTORY_PLACEMENT_FIELDS: {
+    readonly BOX_ID: "boxId";
+    readonly PRODUCT_ID: "productId";
+    readonly QUANTITY: "quantity";
+    readonly SLOT: "slot";
+    readonly BOX_CODE: "boxCode";
+    readonly PRODUCT_TITLE: "productTitle";
+    readonly PRODUCT_SKU: "productSku";
+    readonly CREATED_AT: "createdAt";
+    readonly UPDATED_AT: "updatedAt";
+};
+export declare const INVENTORY_MOVEMENT_FIELDS: {
+    readonly KIND: "kind";
+    readonly PRODUCT_ID: "productId";
+    readonly QUANTITY: "quantity";
+    readonly FROM_BOX_ID: "fromBoxId";
+    readonly TO_BOX_ID: "toBoxId";
+    readonly OCCURRED_AT: "occurredAt";
+    readonly ACTOR_UID: "actorUid";
+    readonly SHIPMENT_ID: "shipmentId";
+    readonly CREATED_AT: "createdAt";
+};

package/dist/features/inventory/schemas/firestore.js

@@ -0,0 +1,159 @@
+/*
+ * WHY: Stock lives in physical AC60 and AC30 boxes with a label maker, and
+ *      "where is this" is a question the catalogue could not answer. The
+ *      previous attempt — `ProductDocument.physicalLocation`, a free-text
+ *      zone/shelf/bin triple — carried 0 of 1,039 products and had no write
+ *      path at all, because a location typed once and never moved is not an
+ *      inventory system. A box registry plus an append-only move ledger is.
+ *
+ * WHAT: Three TOP-LEVEL collections.
+ *
+ *   storageBoxes/{storagebox-slug}        one physical box
+ *   inventoryPlacements/{boxId__prodId}   how many of X are in Y, right now
+ *   inventoryMovements/{auto}             every move, immutable
+ *
+ * ── 🛑 TOP-LEVEL, NOT SUBCOLLECTIONS, and the reason is structural ─────────
+ *
+ * `BaseRepository.getCollection()` returns a `CollectionReference` and every
+ * write method depends on it, while `collectionGroup()` returns a `Query`.
+ * Measured: the repo has 685 `COLLECTION` indexes, 3 `COLLECTION_GROUP`
+ * indexes, and **zero `collectionGroup(` call sites** — all three of those
+ * indexes are dead. A subcollection here would mean hand-rolling the
+ * repository base and losing PII encryption, `searchTxt` and `mapDoc` with it.
+ *
+ * ── 🛑 A ZERO-QUANTITY PLACEMENT IS DELETED, NEVER STORED AT ZERO ──────────
+ *
+ * Keeping zeros forces every "what is in this box" read to pair
+ * `quantity > 0` with an `orderBy`, and Firestore appends an inequality's
+ * field to the sort implicitly — so it demands a composite index in an order
+ * nobody declares, fails with FAILED_PRECONDITION, and every caller in this
+ * codebase wraps such a read in `.catch(() => null)`. That renders as an
+ * EMPTY BOX rather than an error (Root Cause #59). Absence means zero.
+ *
+ * ── 🛑 NO STOCK RECONCILIATION. `stockQuantity` STAYS AUTHORITATIVE ───────
+ *
+ * This system never writes it. Deriving it would write the left side of
+ * `resolveStockResync`'s invariant (`reserved = prevStock − prevAvailable`)
+ * from a measurement blind to reservations, handing reserved units back to
+ * the shelf. And a nightly reconciler would be Root Cause #102 verbatim: a
+ * three-way state (authored / reserved / located) against one number cannot
+ * distinguish "3 are lost" from "3 are on the photography table". Variance is
+ * a REPORT a human resolves with an `adjust` movement.
+ *
+ * EXPORTS: STORAGE_BOXES_COLLECTION, INVENTORY_PLACEMENTS_COLLECTION,
+ *   INVENTORY_MOVEMENTS_COLLECTION, BoxTypeValues, BoxType, BoxStatusValues,
+ *   BoxStatus, MovementKindValues, MovementKind, StorageBoxDocument,
+ *   InventoryPlacementDocument, InventoryMovementDocument, placementId,
+ *   STORAGE_BOX_FIELDS, INVENTORY_PLACEMENT_FIELDS, INVENTORY_MOVEMENT_FIELDS
+ *
+ * @tag domain:inventory
+ * @tag layer:feature
+ * @tag pattern:firestore-schema
+ * @tag access:server
+ * @tag sideEffects:none
+ */
+export const STORAGE_BOXES_COLLECTION = "storageBoxes";
+export const INVENTORY_PLACEMENTS_COLLECTION = "inventoryPlacements";
+export const INVENTORY_MOVEMENTS_COLLECTION = "inventoryMovements";
+/**
+ * The two box sizes actually owned.
+ *
+ * 🛑 A TS UNION, not a seeded reference list, and this was one of the plan's
+ * open questions. The deciding argument is that the LABEL GEOMETRY depends on
+ * it: a box label's dimensions are chosen per type, so a third type is a code
+ * change in the label profiles whatever the data model says. A seeded list
+ * would let an admin create an `AC90` that no label profile can print, and
+ * discover it at the printer.
+ *
+ * Adding a type is therefore deliberately a two-line code change plus a
+ * profile, not a form submission.
+ */
+/**
+ * How many rows the receive station stages before it must commit.
+ *
+ * 🛑 THIS IS A FIRESTORE LIMIT, NOT A UI PREFERENCE. A transaction caps at 500
+ * writes and each received row is two of them (the placement and its movement
+ * row), so 50 rows is 100 writes with ample room for the ledger growing a
+ * field later. The whole table commits in ONE transaction because the operator
+ * has already physically filled the boxes — a partial write leaves the ledger
+ * disagreeing with the shelf and nothing saying which rows landed.
+ *
+ * 🛑 Declared here so the route and the station cannot disagree. It was a
+ * local `MAX_ROWS` in the route and a second literal in the view for one
+ * revision, which is the two-owners shape that drifts the moment either moves
+ * (Root Cause #42) — and the failure would be silent in the worst direction:
+ * a UI cap above the route's gives the operator a full table and a 400.
+ */
+export const MAX_RECEIVE_ROWS = 50;
+export const BoxTypeValues = ["AC60", "AC30"];
+/**
+ * `retired` rather than deleting: a box's movements are permanent, and a
+ * ledger row pointing at a box that no longer exists cannot be read back.
+ */
+export const BoxStatusValues = ["active", "full", "retired"];
+/**
+ * Why stock moved. Every movement has one.
+ *
+ * `receive`  inbound from a procurement shipment
+ * `move`     box → box
+ * `pick`     out of a box, for an order
+ * `adjust`   a human reconciling a variance they investigated
+ * `audit`    a count that AGREED — recorded so "last verified" is answerable
+ *
+ * 🛑 `pick` is MANUAL and does not auto-fire from checkout — the other open
+ * question in the plan. An automatic decrement would have the ledger assert a
+ * movement nobody performed: the stock is sold, but it is still in the box
+ * until someone walks over and takes it out. A ledger that records intentions
+ * rather than actions cannot be used to find a missing item, which is its
+ * only real job.
+ */
+export const MovementKindValues = [
+    "receive",
+    "move",
+    "pick",
+    "adjust",
+    "audit",
+];
+/**
+ * The deterministic placement id.
+ *
+ * One definition, used by the repository, the receive station and the seed —
+ * a second copy of this string concatenation is a second answer to "is X in
+ * Y", and the two would disagree the first time one of them changed.
+ */
+export function placementId(boxId, productId) {
+    return `${boxId}__${productId}`;
+}
+/** Field-name constants, so a query never spells a path by hand. */
+export const STORAGE_BOX_FIELDS = {
+    CODE: "code",
+    BOX_TYPE: "boxType",
+    ORDINAL: "ordinal",
+    STATUS: "status",
+    LOCATION: "location",
+    SEARCH_TXT: "searchTxt",
+    CREATED_AT: "createdAt",
+    UPDATED_AT: "updatedAt",
+};
+export const INVENTORY_PLACEMENT_FIELDS = {
+    BOX_ID: "boxId",
+    PRODUCT_ID: "productId",
+    QUANTITY: "quantity",
+    SLOT: "slot",
+    BOX_CODE: "boxCode",
+    PRODUCT_TITLE: "productTitle",
+    PRODUCT_SKU: "productSku",
+    CREATED_AT: "createdAt",
+    UPDATED_AT: "updatedAt",
+};
+export const INVENTORY_MOVEMENT_FIELDS = {
+    KIND: "kind",
+    PRODUCT_ID: "productId",
+    QUANTITY: "quantity",
+    FROM_BOX_ID: "fromBoxId",
+    TO_BOX_ID: "toBoxId",
+    OCCURRED_AT: "occurredAt",
+    ACTOR_UID: "actorUid",
+    SHIPMENT_ID: "shipmentId",
+    CREATED_AT: "createdAt",
+};

package/dist/features/layout/AppLayoutShell.d.ts

@@ -59,6 +59,17 @@ export interface AppLayoutShellProps {
     homeHref: string;
     shopHref: string;
     footer: FooterLayoutProps;
+    /**
+     * Render the public marketing footer. Defaults to `true`.
+     *
+     * Pass `false` on a dashboard. `footer` stays REQUIRED either way, so the
+     * consumer keeps one code path and there is no "which half did I forget"
+     * state — this only decides whether it is shown.
+     *
+     * 🛑 It also moves the bottom-chrome reservation: the footer owns it when
+     * rendered, `<Main>` owns it when not. See the comment on `<Main>`.
+     */
+    showFooter?: boolean;
     searchSlot?: React.ReactNode;
     /** Render-prop alternative to searchSlot — receives onClose so the slot can close the overlay. */
     searchSlotRenderer?: (onClose: () => void) => React.ReactNode;
@@ -137,4 +148,4 @@ export interface AppLayoutShellProps {
         };
     };
 }
-export declare function AppLayoutShell({ children, navItems, sidebarItems, sidebarSections, sidebarPrimaryActions, sidebarTitle, hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, messagesHref, unreadMessageCount, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle, suppressDashboardNav, hideSidebarToggle, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, eventBannerSlot, showBottomNav, contentClassName, lightBackground, darkBackground, }: AppLayoutShellProps): React.JSX.Element;
+export declare function AppLayoutShell({ children, navItems, sidebarItems, sidebarSections, sidebarPrimaryActions, sidebarTitle, hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, messagesHref, unreadMessageCount, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, showFooter, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle, suppressDashboardNav, hideSidebarToggle, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, eventBannerSlot, showBottomNav, contentClassName, lightBackground, darkBackground, }: AppLayoutShellProps): React.JSX.Element;

package/dist/features/layout/AppLayoutShell.js

@@ -120,7 +120,7 @@ function CollapsibleSidebarSection({ section, navItemClass, navItemActiveClass,
     return (_jsxs(Stack, { gap: "none", className: "", children: [_jsxs("button", { type: "button", onClick: () => setOpen((v) => !v), className: "flex w-full items-center justify-between px-[var(--appkit-space-1)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] font-semibold uppercase tracking-wider text-[var(--appkit-color-text-muted)] hover:text-[var(--appkit-color-text-muted)] transition-colors", children: [_jsx(Span, { children: section.title }), _jsx("svg", { className: `w-3.5 h-3.5 transition-transform duration-200 ${open ? "rotate-180" : ""} shrink-0`, fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 9l-7 7-7-7" }) })] }), open && (_jsx(SidebarSectionLinks, { items: section.items, activeHref: activeHref, activeItem: activeItem, navItemClass: navItemClass, navItemActiveClass: navItemActiveClass }))] }));
 }
 /** Sidebar header when a user is logged in — avatar + display name + close button. */
-function SidebarUserHeader({ user, onClose, }) {
+function SidebarUserHeader({ user, onClose, profileHref, }) {
     return (_jsxs(Row, { align: "center", justify: "between", gap: "3", children: [_jsxs(Row, { className: "flex-1 min-w-0", align: "center", gap: "3", children: [_jsxs(Div, { className: "flex-shrink-0 relative", children: [_jsx(AvatarDisplay, { cropData: user.avatarMetadata
                                     ? {
                                         url: user.avatarMetadata.url,
@@ -129,11 +129,11 @@ function SidebarUserHeader({ user, onClose, }) {
                                     }
                                     : user.photoURL
                                         ? { url: user.photoURL, position: { x: 50, y: 50 }, zoom: 1 }
-                                        : null, size: "md", alt: user.displayName || "User", displayName: user.displayName, email: user.email }), user.role && !isBuyerUser(user) && (_jsx(Row, { textWeight: "bold", className: `absolute -bottom-0.5 -right-0.5 w-4 h-4 border-2 border-white text-white text-[9px] leading-none select-none ${ROLE_DOT_BG_CLASS[user.role] ?? "bg-[var(--appkit-color-text-muted)]"}`, align: "center", justify: "center", rounded: "full", title: user.role.charAt(0).toUpperCase() + user.role.slice(1), "aria-label": user.role, children: user.role.charAt(0).toUpperCase() }))] }), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "truncate", color: "primary", size: "sm", weight: "medium", children: user.displayName || "User" }), _jsx(Text, { className: "truncate", color: "muted", size: "xs", children: user.email || "" })] })] }), _jsx("button", { type: "button", "aria-label": "Close menu", onClick: onClose, className: "flex-shrink-0 rounded-full p-[var(--appkit-space-2)] text-[var(--appkit-color-text-muted)] hover:bg-surface-hover hover:text-zinc-900 text-[var(--appkit-color-text-muted)] dark:hover:text-zinc-100 transition-all hover:rotate-90", children: _jsx("svg", { className: "w-4 h-4 shrink-0", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })] }));
+                                        : null, size: "md", alt: user.displayName || "User", displayName: user.displayName, email: user.email }), user.role && !isBuyerUser(user) && (_jsx(Row, { textWeight: "bold", className: `absolute -bottom-0.5 -right-0.5 w-4 h-4 border-2 border-white text-white text-[9px] leading-none select-none ${ROLE_DOT_BG_CLASS[user.role] ?? "bg-[var(--appkit-color-text-muted)]"}`, align: "center", justify: "center", rounded: "full", title: user.role.charAt(0).toUpperCase() + user.role.slice(1), "aria-label": user.role, children: user.role.charAt(0).toUpperCase() })), profileHref && (_jsx(TextLink, { href: profileHref, variant: "none", onClick: onClose, className: "absolute inset-0 rounded-full", children: _jsx(Span, { className: "sr-only", children: "View your profile" }) }))] }), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "truncate", color: "primary", size: "sm", weight: "medium", children: user.displayName || "User" }), _jsx(Text, { className: "truncate", color: "muted", size: "xs", children: user.email || "" })] })] }), _jsx("button", { type: "button", "aria-label": "Close menu", onClick: onClose, className: "flex-shrink-0 rounded-full p-[var(--appkit-space-2)] hover:bg-surface-hover hover:text-zinc-900 text-[var(--appkit-color-text-muted)] dark:hover:text-zinc-100 transition-all hover:rotate-90", children: _jsx("svg", { className: "w-4 h-4 shrink-0", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })] }));
 }
 /** Sidebar header when no user is logged in — title + close button. */
 function SidebarGuestHeader({ sidebarTitle, onClose, }) {
-    return (_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Div, { textWeight: "semibold", textSize: "sm", color: "primary", children: sidebarTitle }), _jsx("button", { type: "button", "aria-label": "Close menu", onClick: onClose, className: "rounded-full p-[var(--appkit-space-2)] text-[var(--appkit-color-text-muted)] hover:bg-surface-hover hover:text-zinc-900 text-[var(--appkit-color-text-muted)] dark:hover:text-zinc-100 transition-all hover:rotate-90", children: _jsx("svg", { className: "w-4 h-4 shrink-0", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })] }));
+    return (_jsxs(Row, { align: "center", justify: "between", children: [_jsx(Div, { textWeight: "semibold", textSize: "sm", color: "primary", children: sidebarTitle }), _jsx("button", { type: "button", "aria-label": "Close menu", onClick: onClose, className: "rounded-full p-[var(--appkit-space-2)] hover:bg-surface-hover hover:text-zinc-900 text-[var(--appkit-color-text-muted)] dark:hover:text-zinc-100 transition-all hover:rotate-90", children: _jsx("svg", { className: "w-4 h-4 shrink-0", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })] }));
 }
 function SidebarContent({ sidebarItems, sidebarSections, sidebarPrimaryActions, user, activeHref, profileHref, userOrdersHref, userWishlistHref, userSettingsHref, adminHref, storeHref, sellerHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, theme, activeThemeName, toggleTheme, onLogout, onAfterLogout, }) {
     const hasLegacyItems = sidebarItems.length > 0;
@@ -177,10 +177,10 @@ function SidebarContent({ sidebarItems, sidebarSections, sidebarPrimaryActions,
                         action.variant === "outline"
                             ? "border hover:bg-surface-hover border-[var(--appkit-color-border)] text-[var(--appkit-color-text)]"
                             : "bg-primary text-white hover:bg-primary-600 dark:bg-primary dark:hover:bg-primary-600 btn-glow",
-                    ].join(" "), children: action.label }, `${action.href}-${action.label}`))) })), isAuthenticated && (_jsx(CollapsibleNavGroup, { title: labels.sectionTitle, hasActive: !!activeProfileLink, children: _jsxs(Ul, { spacing: "2xs", children: [_jsx(Li, { children: _jsx(TextLink, { href: profileHref, variant: "none", className: activeProfileLink?.href === profileHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === profileHref ? "page" : undefined, children: labels.profile }) }), userOrdersHref && (_jsx(Li, { children: _jsx(TextLink, { href: userOrdersHref, variant: "none", className: activeProfileLink?.href === userOrdersHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userOrdersHref ? "page" : undefined, children: labels.orders }) })), userWishlistHref && (_jsx(Li, { children: _jsx(TextLink, { href: userWishlistHref, variant: "none", className: activeProfileLink?.href === userWishlistHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userWishlistHref ? "page" : undefined, children: labels.wishlist }) })), userSettingsHref && (_jsx(Li, { children: _jsx(TextLink, { href: userSettingsHref, variant: "none", className: activeProfileLink?.href === userSettingsHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userSettingsHref ? "page" : undefined, children: labels.settings }) }))] }) })), isAuthenticated && user?.stats && (_jsxs(Div, { layout: "grid", gap: "2", className: "grid-cols-2", children: [user.stats.totalOrders != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.totalOrders }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Orders" })] })), user.stats.reviewsCount != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.reviewsCount }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Reviews" })] })), user.stats.auctionsWon != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.auctionsWon }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Auctions Won" })] })), user.stats.itemsSold != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.itemsSold }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Items Sold" })] }))] })), isAuthenticated && isAdminOrSeller && (adminHref || resolvedStoreHref) && (_jsx(CollapsibleNavGroup, { title: labels.dashboardSectionTitle, hasActive: !!activeDashboardLink, children: _jsxs(Ul, { spacing: "2xs", children: [adminHref && role === "admin" && (_jsx(Li, { children: _jsx(TextLink, { href: adminHref, variant: "none", className: activeDashboardLink?.href === adminHref ? navItemActiveClass : navItemClass, "aria-current": activeDashboardLink?.href === adminHref ? "page" : undefined, children: labels.adminDashboard }) })), resolvedStoreHref && isAdminOrSeller && (_jsx(Li, { children: _jsx(TextLink, { href: resolvedStoreHref, variant: "none", className: activeDashboardLink?.href === resolvedStoreHref ? navItemActiveClass : navItemClass, "aria-current": activeDashboardLink?.href === resolvedStoreHref ? "page" : undefined, children: labels.storeDashboard }) }))] }) })), normalizedSections.map((section, sectionIndex) => (_jsx(CollapsibleSidebarSection, { section: section, navItemClass: navItemClass, navItemActiveClass: navItemActiveClass, activeHref: activeHref }, `sidebar-section-${sectionIndex}`))), (sidebarLocaleSlot || showThemeToggleInSidebar || (isAuthenticated && onLogout)) && (_jsxs(Stack, { border: "default", className: "border-t border-[var(--appkit-color-border-subtle)]", padding: "t-md", gap: "3", children: [sidebarLocaleSlot, showThemeToggleInSidebar && (_jsxs("button", { type: "button", onClick: toggleTheme, className: "flex w-full items-center justify-end gap-[var(--appkit-space-3)] rounded-lg px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] text-[var(--appkit-color-text-muted)] transition-colors hover:bg-primary-surface hover:text-primary-800 dark:hover:text-primary-200", children: [_jsx(Span, { "aria-hidden": "true", children: theme === "dark" ? "☀️" : "🌙" }), activeThemeName] })), isAuthenticated && onLogout && (_jsx("button", { type: "button", onClick: () => { onLogout(); onAfterLogout(); }, className: CLS_LOGOUT_BTN, children: labels.logout }))] }))] }));
+                    ].join(" "), children: action.label }, `${action.href}-${action.label}`))) })), isAuthenticated && (_jsx(CollapsibleNavGroup, { title: labels.sectionTitle, hasActive: !!activeProfileLink, children: _jsxs(Ul, { spacing: "2xs", children: [_jsx(Li, { children: _jsx(TextLink, { href: profileHref, variant: "none", className: activeProfileLink?.href === profileHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === profileHref ? "page" : undefined, children: labels.profile }) }), userOrdersHref && (_jsx(Li, { children: _jsx(TextLink, { href: userOrdersHref, variant: "none", className: activeProfileLink?.href === userOrdersHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userOrdersHref ? "page" : undefined, children: labels.orders }) })), userWishlistHref && (_jsx(Li, { children: _jsx(TextLink, { href: userWishlistHref, variant: "none", className: activeProfileLink?.href === userWishlistHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userWishlistHref ? "page" : undefined, children: labels.wishlist }) })), userSettingsHref && (_jsx(Li, { children: _jsx(TextLink, { href: userSettingsHref, variant: "none", className: activeProfileLink?.href === userSettingsHref ? navItemActiveClass : navItemClass, "aria-current": activeProfileLink?.href === userSettingsHref ? "page" : undefined, children: labels.settings }) }))] }) })), isAuthenticated && user?.stats && (_jsxs(Div, { layout: "grid", gap: "2", className: "grid-cols-2", children: [user.stats.totalOrders != null && userOrdersHref && (_jsxs(TextLink, { href: userOrdersHref, variant: "none", className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.totalOrders }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Orders" })] })), user.stats.reviewsCount != null && (_jsxs(TextLink, { href: `${profileHref}#reviews`, variant: "none", className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.reviewsCount }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Reviews" })] })), user.stats.auctionsWon != null && userOrdersHref && (_jsxs(TextLink, { href: `${userOrdersHref}?orderType=auction`, variant: "none", className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.auctionsWon }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Auctions Won" })] })), user.stats.itemsSold != null && resolvedStoreHref && (_jsxs(TextLink, { href: resolvedStoreHref, variant: "none", className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.itemsSold }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Items Sold" })] }))] })), isAuthenticated && isAdminOrSeller && (adminHref || resolvedStoreHref) && (_jsx(CollapsibleNavGroup, { title: labels.dashboardSectionTitle, hasActive: !!activeDashboardLink, children: _jsxs(Ul, { spacing: "2xs", children: [adminHref && role === "admin" && (_jsx(Li, { children: _jsx(TextLink, { href: adminHref, variant: "none", className: activeDashboardLink?.href === adminHref ? navItemActiveClass : navItemClass, "aria-current": activeDashboardLink?.href === adminHref ? "page" : undefined, children: labels.adminDashboard }) })), resolvedStoreHref && isAdminOrSeller && (_jsx(Li, { children: _jsx(TextLink, { href: resolvedStoreHref, variant: "none", className: activeDashboardLink?.href === resolvedStoreHref ? navItemActiveClass : navItemClass, "aria-current": activeDashboardLink?.href === resolvedStoreHref ? "page" : undefined, children: labels.storeDashboard }) }))] }) })), normalizedSections.map((section, sectionIndex) => (_jsx(CollapsibleSidebarSection, { section: section, navItemClass: navItemClass, navItemActiveClass: navItemActiveClass, activeHref: activeHref }, `sidebar-section-${sectionIndex}`))), (sidebarLocaleSlot || showThemeToggleInSidebar || (isAuthenticated && onLogout)) && (_jsxs(Stack, { border: "default", className: "border-t border-[var(--appkit-color-border-subtle)]", padding: "t-md", gap: "3", children: [sidebarLocaleSlot, showThemeToggleInSidebar && (_jsxs("button", { type: "button", onClick: toggleTheme, className: "flex w-full items-center justify-end gap-[var(--appkit-space-3)] rounded-lg px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] text-[var(--appkit-color-text-muted)] transition-colors hover:bg-primary-surface hover:text-primary-800 dark:hover:text-primary-200", children: [_jsx(Span, { "aria-hidden": "true", children: theme === "dark" ? "☀️" : "🌙" }), activeThemeName] })), isAuthenticated && onLogout && (_jsx("button", { type: "button", onClick: () => { onLogout(); onAfterLogout(); }, className: CLS_LOGOUT_BTN, children: labels.logout }))] }))] }));
 }
 // ─── Main component ────────────────────────────────────────────────────────────
-export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarSections, sidebarPrimaryActions, sidebarTitle = "Navigation", hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, messagesHref, unreadMessageCount, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle = false, suppressDashboardNav = false, hideSidebarToggle = false, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar = false, sidebarProfileLabels, eventBannerSlot, showBottomNav = true, contentClassName, lightBackground = DEFAULT_LIGHT_BG, darkBackground = DEFAULT_DARK_BG, }) {
+export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarSections, sidebarPrimaryActions, sidebarTitle = "Navigation", hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, messagesHref, unreadMessageCount, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, showFooter = true, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle = false, suppressDashboardNav = false, hideSidebarToggle = false, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar = false, sidebarProfileLabels, eventBannerSlot, showBottomNav = true, contentClassName, lightBackground = DEFAULT_LIGHT_BG, darkBackground = DEFAULT_DARK_BG, }) {
     // QueryClientProvider used to be created here so AppLayoutShell could stand
     // alone. The real cause of the 2026-06-10/11 "No QueryClient set" prod crash
     // turned out to be a peer-dep duplicate of @tanstack/query-core under
@@ -247,12 +247,18 @@ export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarS
             opacity: darkBackground.overlay?.opacity ?? 0,
         },
     };
-    return (_jsx(_Fragment, { children: _jsxs(Stack, { className: "min-h-screen w-full overflow-x-clip transition-colors duration-300", children: [_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: normalizedLightBackground, darkMode: normalizedDarkBackground }), _jsx(Div, { id: TOP_BANNER_SLOT_ID, className: "w-full" }), _jsxs(Div, { ref: headerRef, className: "sticky top-0 z-50 w-full", children: [_jsx(TitleBar, { onToggleSidebar: handleTogglePublicSidebar, sidebarOpen: sidebarOpen, onSearchToggle: () => setSearchOpen((prev) => !prev), searchOpen: searchOpen, brandName: brandName, brandShortName: brandShortName, siteLogoUrl: siteLogoUrl, logoHref: logoHref, promotionsHref: promotionsHref, cartHref: cartHref, wishlistHref: wishlistHref, messagesHref: messagesHref, unreadMessageCount: unreadMessageCount, userId: userId, profileHref: profileHref, loginHref: loginHref, registerHref: registerHref, user: user, navSlot: titleBarNavSlot, notificationSlot: titleBarNotificationSlot, devSlot: titleBarDevSlot, promoStripText: titleBarPromoStripText, isDark: theme === "dark", onToggleTheme: showThemeToggle ? toggleTheme : undefined, onBeforeToggleDashboardNav: handleBeforeDashboardNavToggle, suppressDashboardNav: suppressDashboardNav, hideSidebarToggle: hideSidebarToggle }), _jsx(NavbarWithSettings, { navItems: navItems, hiddenNavItems: hiddenNavItems, permissions: authUser?.permissions }), searchOpen && (searchSlotRenderer ? searchSlotRenderer(() => setSearchOpen(false)) : searchSlot), eventBannerSlot] }), _jsx(AutoBreadcrumbs, {}), _jsxs(Div, { layout: "flex", className: "relative w-full flex-1 overflow-x-clip", children: [_jsx(SidebarLayout, { isOpen: sidebarOpen, ariaLabel: "Secondary navigation", header: user ? (_jsx(SidebarUserHeader, { user: user, onClose: () => setSidebarOpen(false) })) : (_jsx(SidebarGuestHeader, { sidebarTitle: sidebarTitle, onClose: () => setSidebarOpen(false) })), onClose: () => setSidebarOpen(false), children: sidebarContent }), _jsx(Main, { id: "main-content", 
-                            // No bottom-chrome clearance here on purpose. FooterLayout is a
-                            // SIBLING rendered after <Main>, so a margin here only gaps
-                            // main-to-footer — it never clears the bottom of the page, which is
-                            // what the fixed nav + tier actually overlap. That reservation now
-                            // lives on the footer's own padding-bottom.
+    return (_jsx(_Fragment, { children: _jsxs(Stack, { className: "min-h-screen w-full overflow-x-clip transition-colors duration-300", children: [_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: normalizedLightBackground, darkMode: normalizedDarkBackground }), _jsx(Div, { id: TOP_BANNER_SLOT_ID, className: "w-full" }), _jsxs(Div, { ref: headerRef, className: "sticky top-0 z-50 w-full", children: [_jsx(TitleBar, { onToggleSidebar: handleTogglePublicSidebar, sidebarOpen: sidebarOpen, onSearchToggle: () => setSearchOpen((prev) => !prev), searchOpen: searchOpen, brandName: brandName, brandShortName: brandShortName, siteLogoUrl: siteLogoUrl, logoHref: logoHref, promotionsHref: promotionsHref, cartHref: cartHref, wishlistHref: wishlistHref, messagesHref: messagesHref, unreadMessageCount: unreadMessageCount, userId: userId, profileHref: profileHref, loginHref: loginHref, registerHref: registerHref, user: user, navSlot: titleBarNavSlot, notificationSlot: titleBarNotificationSlot, devSlot: titleBarDevSlot, promoStripText: titleBarPromoStripText, isDark: theme === "dark", onToggleTheme: showThemeToggle ? toggleTheme : undefined, onBeforeToggleDashboardNav: handleBeforeDashboardNavToggle, suppressDashboardNav: suppressDashboardNav, hideSidebarToggle: hideSidebarToggle }), _jsx(NavbarWithSettings, { navItems: navItems, hiddenNavItems: hiddenNavItems, permissions: authUser?.permissions }), searchOpen && (searchSlotRenderer ? searchSlotRenderer(() => setSearchOpen(false)) : searchSlot), eventBannerSlot] }), _jsx(AutoBreadcrumbs, {}), _jsxs(Div, { layout: "flex", className: "relative w-full flex-1 overflow-x-clip", children: [_jsx(SidebarLayout, { isOpen: sidebarOpen, ariaLabel: "Secondary navigation", header: user ? (_jsx(SidebarUserHeader, { user: user, onClose: () => setSidebarOpen(false), profileHref: profileHref })) : (_jsx(SidebarGuestHeader, { sidebarTitle: sidebarTitle, onClose: () => setSidebarOpen(false) })), onClose: () => setSidebarOpen(false), children: sidebarContent }), _jsx(Main, { id: "main-content", 
+                            // Bottom-chrome clearance belongs to whichever element is LAST.
+                            //
+                            // With the footer rendered it is the footer's, and a margin here
+                            // would only gap main-to-footer — it would never clear the bottom
+                            // of the page, which is what the fixed nav + tier actually
+                            // overlap. That is why this carried no bottom padding.
+                            //
+                            // With the footer SUPPRESSED (`showFooter={false}`, which is every
+                            // dashboard page) `<Main>` becomes the last element, so the same
+                            // reasoning puts the reservation here instead. Exactly one of the
+                            // two owns it at a time; both would add a screen of dead space.
                             //
                             // The TOP tier is the mirror image and does belong here: at `lg` the
                             // chrome tier hangs under the header as a fixed bar, so without this
@@ -260,5 +266,12 @@ export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarS
                             // is 0 below `lg` and 0 whenever no bar is published, so this
                             // reserves exactly nothing until there is something to reserve —
                             // which is why it can be unconditional rather than route-gated.
-                            className: "w-full flex-1 flex flex-col pt-[var(--top-chrome-height,0px)] transition-[padding-top] duration-300 ease-out", children: _jsx(Div, { padding: "y-lg", className: `flex-1 ${contentClassName ?? "mx-auto w-full max-w-screen-xl px-[var(--appkit-space-5)] md:px-[var(--appkit-space-6)] lg:px-[var(--appkit-space-8)]"}`, children: children }) })] }), _jsx(BackToTop, {}), _jsx(FooterLayout, { ...footer }), _jsx(BottomChrome, { children: _jsx(BottomActions, {}) }), _jsx(SideActionDock, {}), showBottomNav && (_jsx(BottomNavbar, { user: user, userId: userId, homeHref: homeHref, shopHref: shopHref, cartHref: cartHref, wishlistHref: wishlistHref, profileHref: profileHref, loginHref: loginHref, onSearchToggle: () => setSearchOpen((prev) => !prev), navItems: navItems, onMoreToggle: handleTogglePublicSidebar })), _jsx(UnsavedChangesModal, {})] }) }));
+                            className: [
+                                "w-full flex-1 flex flex-col pt-[var(--top-chrome-height,0px)] transition-[padding-top] duration-300 ease-out",
+                                showFooter
+                                    ? ""
+                                    : "pb-[calc(var(--bottom-nav-height,4rem)+var(--bottom-chrome-height,0px))]",
+                            ]
+                                .filter(Boolean)
+                                .join(" "), children: _jsx(Div, { padding: contentClassName ? "none" : "y-lg", className: `flex-1 ${contentClassName ?? "mx-auto w-full max-w-screen-xl px-[var(--appkit-space-5)] md:px-[var(--appkit-space-6)] lg:px-[var(--appkit-space-8)]"}`, children: children }) })] }), _jsx(BackToTop, {}), showFooter && _jsx(FooterLayout, { ...footer }), _jsx(BottomChrome, { children: _jsx(BottomActions, {}) }), _jsx(SideActionDock, {}), showBottomNav && (_jsx(BottomNavbar, { user: user, userId: userId, homeHref: homeHref, shopHref: shopHref, cartHref: cartHref, wishlistHref: wishlistHref, profileHref: profileHref, loginHref: loginHref, onSearchToggle: () => setSearchOpen((prev) => !prev), navItems: navItems, onMoreToggle: handleTogglePublicSidebar })), _jsx(UnsavedChangesModal, {})] }) }));
 }