@mohasinac/appkit 4.58.0 → 4.60.0

package/dist/features/gateway-events/schemas/index.d.ts

@@ -0,0 +1,81 @@
+import { z } from "zod";
+export * from "./firestore";
+export declare const gatewayEventKindSchema: z.ZodEnum<["paid", "failed", "dispute", "refund", "other"]>;
+export declare const gatewayEventStatusSchema: z.ZodEnum<["received", "processing", "processed", "ignored", "conflict", "failed"]>;
+export declare const gatewayEventFirestoreSchema: z.ZodObject<{
+    id: z.ZodString;
+    gateway: z.ZodString;
+    rawEvent: z.ZodString;
+    kind: z.ZodEnum<["paid", "failed", "dispute", "refund", "other"]>;
+    status: z.ZodEnum<["received", "processing", "processed", "ignored", "conflict", "failed"]>;
+    terminal: z.ZodOptional<z.ZodBoolean>;
+    providerEventId: z.ZodOptional<z.ZodString>;
+    bodySha256: z.ZodString;
+    gatewayOrderId: z.ZodOptional<z.ZodString>;
+    gatewayPaymentId: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    orderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    receivedAt: z.ZodDate;
+    claimedAt: z.ZodDate;
+    leaseExpiresAt: z.ZodDate;
+    processedAt: z.ZodOptional<z.ZodDate>;
+    attempts: z.ZodNumber;
+    lastError: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodDate;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, z.ZodTypeDef, unknown>>>;
+    payloadTruncated: z.ZodOptional<z.ZodBoolean>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    seedPurpose: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "received" | "failed" | "processed" | "processing" | "conflict" | "ignored";
+    id: string;
+    kind: "other" | "paid" | "failed" | "dispute" | "refund";
+    createdAt: Date;
+    updatedAt: Date;
+    expiresAt: Date;
+    gateway: string;
+    receivedAt: Date;
+    attempts: number;
+    bodySha256: string;
+    leaseExpiresAt: Date;
+    claimedAt: Date;
+    rawEvent: string;
+    terminal?: boolean | undefined;
+    amount?: number | undefined;
+    seedPurpose?: string | undefined;
+    orderIds?: string[] | undefined;
+    processedAt?: Date | undefined;
+    gatewayPaymentId?: string | undefined;
+    gatewayOrderId?: string | undefined;
+    providerEventId?: string | undefined;
+    lastError?: string | undefined;
+    payload?: Record<string, unknown> | undefined;
+    payloadTruncated?: boolean | undefined;
+}, {
+    status: "received" | "failed" | "processed" | "processing" | "conflict" | "ignored";
+    id: string;
+    kind: "other" | "paid" | "failed" | "dispute" | "refund";
+    createdAt: Date;
+    updatedAt: Date;
+    expiresAt: Date;
+    gateway: string;
+    receivedAt: Date;
+    attempts: number;
+    bodySha256: string;
+    leaseExpiresAt: Date;
+    claimedAt: Date;
+    rawEvent: string;
+    terminal?: boolean | undefined;
+    amount?: number | undefined;
+    seedPurpose?: string | undefined;
+    orderIds?: string[] | undefined;
+    processedAt?: Date | undefined;
+    gatewayPaymentId?: string | undefined;
+    gatewayOrderId?: string | undefined;
+    providerEventId?: string | undefined;
+    lastError?: string | undefined;
+    payload?: Record<string, unknown> | undefined;
+    payloadTruncated?: boolean | undefined;
+}>;
+export type GatewayEventFromSchema = z.infer<typeof gatewayEventFirestoreSchema>;

package/dist/features/gateway-events/schemas/index.js

@@ -0,0 +1,79 @@
+// [SCHEMA] gateway-events feature — Firestore document schema.
+//
+// Mirrors GatewayEventDocument in ./firestore.ts.
+//
+// 🛑 THE MIRROR MUST BE COMPLETE, and that is not a style point. `z.object()`
+// STRIPS unknown keys, so a field present on the interface and absent here is
+// silently DELETED by any parse — which is precisely what
+// `orderRefundEventSchema` was doing to `reasonCode` and `razorpayRefundId`
+// (the schema written to validate a gateway refund reference discarded it), and
+// what `serverErrorFirestoreSchema` was doing to `cause`, `entityType` and
+// `entityId`. Both were found by reading the two files side by side, which is
+// the only way this class of drift is ever found.
+//
+// So: a field added to `GatewayEventDocument` is added here in the same edit.
+import { z } from "zod";
+export * from "./firestore.js";
+export const gatewayEventKindSchema = z.enum([
+    "paid",
+    "failed",
+    "dispute",
+    "refund",
+    "other",
+]);
+export const gatewayEventStatusSchema = z.enum([
+    "received",
+    "processing",
+    "processed",
+    "ignored",
+    "conflict",
+    "failed",
+]);
+/**
+ * The redacted payload, as a recursive JSON-ish value.
+ *
+ * `z.record(z.unknown())` would accept anything and assert nothing; this at
+ * least pins the shape to serialisable data, which is the property that matters
+ * for a field written to Firestore and read back into an admin table.
+ */
+const jsonValueSchema = z.lazy(() => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(jsonValueSchema),
+    z.record(jsonValueSchema),
+]));
+export const gatewayEventFirestoreSchema = z.object({
+    id: z.string(),
+    gateway: z.string(),
+    rawEvent: z.string(),
+    kind: gatewayEventKindSchema,
+    status: gatewayEventStatusSchema,
+    terminal: z.boolean().optional(),
+    providerEventId: z.string().optional(),
+    bodySha256: z.string(),
+    gatewayOrderId: z.string().optional(),
+    gatewayPaymentId: z.string().optional(),
+    /*
+     * No `.int()`. The amount is decimal RUPEES, so a legitimate ₹1,499.50 must
+     * parse — `audit-money-units`' INT_ON_MONEY_FIELD rule exists because that
+     * constraint survived the subunit→rupee migration on six money fields and
+     * rejected real values.
+     */
+    amount: z.number().optional(),
+    orderIds: z.array(z.string()).optional(),
+    receivedAt: z.date(),
+    claimedAt: z.date(),
+    leaseExpiresAt: z.date(),
+    processedAt: z.date().optional(),
+    attempts: z.number(),
+    lastError: z.string().optional(),
+    expiresAt: z.date(),
+    payload: z.record(jsonValueSchema).optional(),
+    payloadTruncated: z.boolean().optional(),
+    // BaseDocument
+    createdAt: z.date(),
+    updatedAt: z.date(),
+    seedPurpose: z.string().optional(),
+});

package/dist/features/grouped/components/GroupedListingDetailView.js

@@ -15,7 +15,7 @@ const THEME_LABEL = {
     generic: "Grouped listing",
 };
 export function GroupedListingDetailView({ group, members }) {
-    return (_jsx(Section, { padding: "section", children: _jsx(Container, { children: _jsxs(Stack, { gap: "comfortable", children: [group.coverImage && (_jsx(Div, { className: `relative h-48 w-full md:h-64 ${__O.hidden}`, rounded: "xl", surface: "muted", children: _jsx(MediaImage, { src: group.coverImage, alt: group.title, size: "banner" }) })), _jsxs(Stack, { gap: "xs", children: [_jsx(Span, { size: "xs", color: "muted", transform: "uppercase", weight: "semibold", children: THEME_LABEL[group.groupTheme] }), _jsx(RecordOwnerQuickActions, { resource: "GROUP", recordId: String(group.id), placement: "detail", recordLabel: String(group.title), storeId: group.storeId ? String(group.storeId) : undefined }), _jsx(Heading, { level: 1, children: group.title }), group.description && (_jsx(Text, { color: "muted", children: group.description })), _jsxs(Text, { size: "sm", color: "muted", children: [members.length, " item", members.length === 1 ? "" : "s", " in this group"] })] }), members.length > 0 ? (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, size: "lg", children: "Pick what you want" }), _jsx(Text, { size: "sm", color: "muted", children: "Choose a quantity for each item \u2014 they'll go into your cart as a single line you can edit later." }), _jsx(GroupMemberPicker, { groupId: group.id, groupSource: "grouped-listing", members: members, 
+    return (_jsx(Section, { padding: "section", children: _jsx(Container, { children: _jsxs(Stack, { gap: "comfortable", children: [group.coverImage && (_jsx(Div, { className: `relative h-48 w-full md:h-64 ${__O.hidden}`, rounded: "xl", surface: "muted", children: _jsx(MediaImage, { src: group.coverImage, alt: group.title, size: "banner" }) })), _jsxs(Stack, { gap: "xs", children: [_jsx(Span, { size: "xs", color: "muted", transform: "uppercase", weight: "semibold", children: THEME_LABEL[group.groupTheme] }), _jsx(Heading, { level: 1, children: group.title }), _jsx(RecordOwnerQuickActions, { resource: "GROUP", recordId: String(group.id), placement: "detail", recordLabel: String(group.title), storeId: group.storeId ? String(group.storeId) : undefined }), group.description && (_jsx(Text, { color: "muted", children: group.description })), _jsxs(Text, { size: "sm", color: "muted", children: [members.length, " item", members.length === 1 ? "" : "s", " in this group"] })] }), members.length > 0 ? (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 2, size: "lg", children: "Pick what you want" }), _jsx(Text, { size: "sm", color: "muted", children: "Choose a quantity for each item \u2014 they'll go into your cart as a single line you can edit later." }), _jsx(GroupMemberPicker, { groupId: group.id, groupSource: "grouped-listing", members: members, 
                                 /*
                                  * Off the group document this view already loaded. The picker
                                  * and `addGroupLineToCart` run the SAME `checkGroupRules`, so

package/dist/features/homepage/components/AnnouncementBar.js

@@ -55,6 +55,42 @@ export function AnnouncementBar({ message, link, className = "", onDismiss }) {
     }, [message, userAlreadyDismissed]);
     if (dismissed)
         return null;
+    /*
+     * ── THE CLS STORY, AND WHY THIS CLASS EXISTS ──────────────────────────────
+     *
+     * 🛑 THIS COMPONENT USED TO CAUSE A TOP-OF-PAGE LAYOUT SHIFT ON EVERY
+     * RETURNING VISIT, and a shift at the top of the document moves everything
+     * below it — so it counts against CLS at close to full weight. The mobile
+     * homepage measured 0.822 against a 0.1 "good" threshold.
+     *
+     * The mechanism: `dismissed` starts `false` for anyone without a resolved
+     * session, so the server and the first client frame BOTH render the bar at
+     * full height — at `opacity-0`, because `mounted` is also false. Then the
+     * effect above reads `localStorage`, finds a dismissal, and returns `null`.
+     * The bar's whole height disappears after paint and the page jumps upward.
+     * The visitor saw a coloured strip they could not read, which then vanished.
+     *
+     * It cannot be fixed from inside this component. The dismissal is in
+     * `localStorage`, which does not exist during the server render, and the
+     * root locale layout must stay STATIC (Root Cause #82) so it cannot read a
+     * cookie instead. Something has to decide before React runs.
+     *
+     * So `src/app/layout.tsx` carries a pre-paint inline script — the same
+     * mechanism already used there for theme, font and hand mode — which sets
+     * `data-banner-dismissed="1"` on `<html>`. This class is what that attribute
+     * acts on: `display: none` from the first frame, so the bar reserves nothing
+     * and there is nothing to collapse.
+     *
+     * 🛑 THE CLASS STAYS ON EVEN AFTER MOUNT. Removing it once React knows
+     * better would re-introduce the shift for the exact visitor it protects. The
+     * component's own `dismissed` state unmounts the bar in the same frame, so
+     * the two agree; the attribute is the pre-React half of one decision, not a
+     * guess to be corrected.
+     *
+     * The `opacity` transition is kept for the OTHER case — a visitor with no
+     * dismissal, where the bar is genuinely shown and fading it in avoids a hard
+     * pop. That case reserves its space on the server and does not shift.
+     */
     /*
      * 🛑 THE `overlay` PROP IS GONE — DO NOT REINTRODUCE IT.
      *
@@ -76,7 +112,7 @@ export function AnnouncementBar({ message, link, className = "", onDismiss }) {
      * every width, so there is nothing to overlap and no breakpoint to tune.
      */
     const positionCls = "relative w-full bg-primary-700";
-    return (_jsx(Div, { className: `${positionCls} transition-opacity duration-200 ${mounted ? "opacity-100" : "opacity-0"} ${className}`, role: "banner", children: _jsx(Div, { paddingX: "x-page", className: "container mx-auto max-w-[1920px]", children: _jsxs(Row, { textWeight: "medium", textSize: "sm", className: "relative text-left text-white", padding: "y-xs", align: "center", justify: "start", children: [link ? (_jsx(TextLink, { href: link, className: "text-white underline", children: message })) : (_jsx(Span, { children: message })), _jsx(IconButton, { type: "button", onClick: () => {
+    return (_jsx(Div, { className: `appkit-announcement-bar ${positionCls} transition-opacity duration-200 ${mounted ? "opacity-100" : "opacity-0"} ${className}`, role: "banner", children: _jsx(Div, { paddingX: "x-page", className: "container mx-auto max-w-[1920px]", children: _jsxs(Row, { textWeight: "medium", textSize: "sm", className: "relative text-left text-white", padding: "y-xs", align: "center", justify: "start", children: [link ? (_jsx(TextLink, { href: link, className: "text-white underline", children: message })) : (_jsx(Span, { children: message })), _jsx(IconButton, { type: "button", onClick: () => {
                             saveLocalDismissal(message);
                             onDismiss?.(bannerHash);
                             setDismissed(true);

package/dist/features/homepage/components/AnnouncementBar.style.css

@@ -0,0 +1,30 @@
+/*
+ * The announcement bar's pre-paint suppression.
+ *
+ * 🛑 THE SELECTOR IS A CONTRACT WITH AN INLINE SCRIPT IN `src/app/layout.tsx`.
+ * That script reads `localStorage['letitrip:announcement-dismissed']` before
+ * the first paint and sets `data-banner-dismissed="1"` on `<html>`; this rule
+ * is the half that acts on it.
+ *
+ * Why it has to be CSS and not React: the bar renders at full height on the
+ * server (nothing has told it the visitor dismissed it), so by the time a
+ * `useEffect` can read `localStorage` the space is already painted — and
+ * removing it then is a top-of-page layout shift that moves the whole
+ * document. Mobile homepage CLS measured 0.822 against a 0.1 threshold.
+ *
+ * 🛑 `display: none`, NOT `visibility: hidden` or `opacity: 0`. The point is
+ * to reserve NO SPACE. The previous behaviour was effectively `opacity: 0`
+ * while still occupying its height, which is the worst of both: an unreadable
+ * coloured strip that then collapsed.
+ *
+ * 🛑 NOT scoped to a media query. The shift happens at every width; it is
+ * merely worst on a phone, where the bar wraps to two lines and the viewport
+ * is short enough that its height is a large fraction of the fold.
+ *
+ * @tag domain:homepage
+ * @tag layer:feature
+ */
+
+:root[data-banner-dismissed="1"] .appkit-announcement-bar {
+  display: none;
+}

package/dist/features/homepage/components/BrandsSection.js

@@ -29,7 +29,7 @@ function BrandLogo({ brand }) {
     const iconSrc = brand.display?.icon;
     const coverImage = brand.display?.coverImage;
     const initial = brand.name[0]?.toUpperCase() ?? "?";
-    return (_jsxs(Link, { href: ROUTES.PUBLIC.CATEGORY_DETAIL(brand.slug), className: "flex h-32 w-36 flex-col items-center justify-center gap-[var(--appkit-space-2)] rounded-xl border bg-[var(--appkit-color-surface)] p-[var(--appkit-space-3)] shadow-sm transition-all hover:border-primary-300 hover:shadow-md border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] md:h-40", children: [iconSrc || coverImage ? (_jsx(Image, { src: resolveMediaUrl(iconSrc ?? coverImage), alt: brand.name, width: 64, height: 64, className: "h-16 w-16 rounded object-contain" })) : (_jsx(Row, { textWeight: "bold", textSize: "sm", className: "h-16 w-16 bg-primary-100 text-primary-700 dark:bg-primary-900 dark:text-primary-300", align: "center", justify: "center", rounded: "lg", children: initial })), _jsx(Text, { className: "w-full truncate", color: "muted", size: "xs", weight: "medium", align: "start", children: brand.name })] }));
+    return (_jsxs(Link, { href: ROUTES.PUBLIC.CATEGORY_DETAIL(brand.slug), className: "flex h-32 w-36 flex-col items-center justify-center gap-[var(--appkit-space-2)] rounded-xl border p-[var(--appkit-space-3)] shadow-sm transition-all hover:border-primary-300 hover:shadow-md border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] md:h-40", children: [iconSrc || coverImage ? (_jsx(Image, { src: resolveMediaUrl(iconSrc ?? coverImage), alt: brand.name, width: 64, height: 64, className: "h-16 w-16 rounded object-contain" })) : (_jsx(Row, { textWeight: "bold", textSize: "sm", className: "h-16 w-16 bg-primary-100 text-primary-700 dark:bg-primary-900 dark:text-primary-300", align: "center", justify: "center", rounded: "lg", children: initial })), _jsx(Text, { className: "w-full truncate", color: "muted", size: "xs", weight: "medium", align: "start", children: brand.name })] }));
 }
 export function BrandsSection({ title = "Top Brands", subtitle, limit = 12, viewMoreHref, viewMoreLabel = "All brands →", className = "", initialItems, cta, filters, autoScroll = true, scrollInterval = 4000, loop = true, }) {
     const themed = { textPrimary: THEMED_TEXT_PRIMARY };

package/dist/features/homepage/components/CTABannerSection.js

@@ -24,5 +24,5 @@ export function CTABannerSection({ title = SECTION_TITLE.banner, eyebrow = SECTI
 // Pairs with SECTION_COPY.bannerSecondaryCta — see the note there for why
 // this banner must not default to /auctions.
 secondaryHref = String(ROUTES.PUBLIC.CATEGORIES), height = "md", backgroundImage, className = "", }) {
-    return (_jsxs(Section, { tone: "accent-banner", className: `relative ${className}`, overflow: "hidden", paddingY: HEIGHT_PADDING_Y[height], paddingX: "x-md", children: [backgroundImage && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: backgroundImage, alt: "", size: "banner", objectFit: "cover" }) }), _jsx(Scrim, { direction: "left-to-right", intensity: "strong", className: "absolute inset-0" })] })), _jsxs(Div, { className: "relative mx-auto max-w-3xl text-left", children: [_jsxs(Div, { layout: "inline-flex", align: "center", gap: "2", surface: "frost", rounded: "full", padding: "x-sm", className: "mb-4 py-[var(--appkit-space-1-5)] backdrop-blur-sm", children: [_jsx(Icon, { name: "deals", size: "sm", tone: "on-solid" }), _jsx(Span, { color: "inverse", size: "xs", weight: "semibold", transform: "uppercase", className: "tracking-[0.18em]", children: eyebrow })] }), _jsx(Heading, { color: "inverse", level: 2, mdSize: "3xl", lgSize: "4xl", size: "2xl", weight: "bold", children: title }), subtitle && (_jsx(Text, { color: "inverse-muted", className: "mt-3", size: "base", children: subtitle })), description && (_jsx(Text, { color: "inverse-muted", className: "mt-2 max-w-2xl", size: "sm", children: description })), _jsxs(Row, { className: "mt-8", align: "center", justify: "start", gap: "md", wrap: true, children: [_jsx(Link, { href: primaryHref, className: "inline-flex items-center rounded-full bg-white px-[var(--appkit-space-8)] py-[var(--appkit-space-3)] text-[length:var(--appkit-text-sm)] font-semibold text-primary-700 shadow-sm transition-all hover:bg-surface-hover hover:shadow-md focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-primary-600", children: primaryLabel }), secondaryHref && (_jsx(Link, { href: secondaryHref, className: "inline-flex items-center rounded-full border-2 border-white/80 px-[var(--appkit-space-8)] py-[var(--appkit-space-3)] text-[length:var(--appkit-text-sm)] font-semibold text-white transition-all hover:bg-white/10 focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-primary-600", children: secondaryLabel }))] })] })] }));
+    return (_jsxs(Section, { tone: "accent-banner", className: `relative ${className}`, overflow: "hidden", paddingY: HEIGHT_PADDING_Y[height], paddingX: "x-md", children: [backgroundImage && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: backgroundImage, alt: "", size: "banner", objectFit: "cover", fill: true }) }), _jsx(Scrim, { direction: "left-to-right", intensity: "strong", className: "absolute inset-0" })] })), _jsxs(Div, { className: "relative mx-auto max-w-3xl text-left", children: [_jsxs(Div, { layout: "inline-flex", align: "center", gap: "2", surface: "frost", rounded: "full", padding: "x-sm", className: "mb-4 py-[var(--appkit-space-1-5)] backdrop-blur-sm", children: [_jsx(Icon, { name: "deals", size: "sm", tone: "on-solid" }), _jsx(Span, { color: "inverse", size: "xs", weight: "semibold", transform: "uppercase", className: "tracking-[0.18em]", children: eyebrow })] }), _jsx(Heading, { color: "inverse", level: 2, mdSize: "3xl", lgSize: "4xl", size: "2xl", weight: "bold", children: title }), subtitle && (_jsx(Text, { color: "inverse-muted", className: "mt-3", size: "base", children: subtitle })), description && (_jsx(Text, { color: "inverse-muted", className: "mt-2 max-w-2xl", size: "sm", children: description })), _jsxs(Row, { className: "mt-8", align: "center", justify: "start", gap: "md", wrap: true, children: [_jsx(Link, { href: primaryHref, className: "inline-flex items-center rounded-full bg-white px-[var(--appkit-space-8)] py-[var(--appkit-space-3)] text-[length:var(--appkit-text-sm)] font-semibold text-primary-700 shadow-sm transition-all hover:bg-surface-hover hover:shadow-md focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-primary-600", children: primaryLabel }), secondaryHref && (_jsx(Link, { href: secondaryHref, className: "inline-flex items-center rounded-full border-2 border-white/80 px-[var(--appkit-space-8)] py-[var(--appkit-space-3)] text-[length:var(--appkit-text-sm)] font-semibold text-white transition-all hover:bg-white/10 focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-primary-600", children: secondaryLabel }))] })] })] }));
 }

package/dist/features/homepage/components/FeaturedBundlesSection.js

@@ -9,36 +9,26 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Link from "next/link.js";
-import { Badge, Div, GatedPrice, Grid, Heading, PricesOnly, Row, Section, Stack, Text } from "../../../ui/index.js";
-import { MediaImage } from "../../media/MediaImage.js";
+/*
+ * 🛑 The import list shrank with the card. Badge, GatedPrice, PricesOnly,
+ * MediaImage, Div, formatCurrency, BUNDLE_STOCK_VARIANT,
+ * computeBundleDiscount, the two className constants and the placeholder
+ * emoji were ALL only reachable from the deleted `FeaturedBundleCard`.
+ * `tsc` does not flag an unused import, so leaving them would have kept a
+ * card's worth of dependencies on a file that no longer draws a card — and
+ * `MarketplaceBundleCard` owns every one of those concerns now.
+ */
+import { Grid, Heading, Row, Section, Stack, Text } from "../../../ui/index.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
-import { formatCurrency } from "../../../utils/number.formatter.js";
-import { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "../../../_internal/shared/features/categories/bundle-copy.js";
-import { computeBundleDiscount } from "../../../_internal/shared/features/categories/bundle-pricing.js";
-import { useHandMode } from "../../../_internal/client/hand-mode/index.js";
+import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy.js";
+import { MarketplaceBundleCard } from "../../products/components/MarketplaceBundleCard.js";
 import { BundleBuyNowCta } from "../../categories/components/BundleBuyNowCta.js";
-const __P = {
-    p3: "p-[var(--appkit-space-3)]",
-};
-const __O = {
-    hidden: "overflow-hidden",
-};
-const PLACEHOLDER_EMOJI = "📦";
+import { useHandMode } from "../../../_internal/client/hand-mode/index.js";
 export function FeaturedBundlesSection({ title = BUNDLE_COPY.featuredDefaultTitle, description, initialItems = [], maxItems, showSavingsBadge = true, viewMoreLabel = BUNDLE_COPY.featured.viewAll, className = "", onBuyNow, }) {
     const { hand } = useHandMode();
     const bundles = initialItems.filter((c) => c.categoryType === "bundle");
     const items = maxItems && maxItems > 0 ? bundles.slice(0, maxItems) : bundles;
     if (items.length === 0)
         return null;
-    return (_jsx(Section, { className: `${className}`, padding: "y-2xl", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", wrap: true, reverse: hand === "left", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, size: "2xl", weight: "semibold", color: "primary", children: title }), description && (_jsx(Text, { size: "sm", color: "muted", children: description }))] }), _jsx(Link, { href: String(ROUTES.PUBLIC.BUNDLES), className: "inline-flex items-center gap-[0.375rem] rounded-[var(--appkit-radius-md)] px-[var(--appkit-space-3)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-sm)] font-semibold transition-colors bg-primary text-white hover:bg-primary-600", children: viewMoreLabel })] }), _jsx(Grid, { cols: "cards", gap: "3", children: items.map((bundle) => (_jsx(FeaturedBundleCard, { bundle: bundle, showSavingsBadge: showSavingsBadge, onBuyNow: onBuyNow }, bundle.id))) })] }) }));
-}
-function FeaturedBundleCard({ bundle, showSavingsBadge = true, onBuyNow, }) {
-    const stock = bundle.bundleStockStatus ?? "in_stock";
-    const memberCount = bundle.bundleProductIds?.length ?? 0;
-    const cover = bundle.display?.coverImage;
-    const href = String(ROUTES.PUBLIC.BUNDLE_DETAIL?.(bundle.slug) ?? "#");
-    const discount = computeBundleDiscount(bundle.bundlePrice, bundle.bundleOriginalTotal);
-    return (_jsxs(Stack, { gap: "none", surface: "default", rounded: "xl", border: "default", children: [_jsxs(Link, { href: href, className: "group block p-[var(--appkit-space-3)] hover:no-underline", children: [_jsxs(Div, { className: `relative mb-2 aspect-square ${__O.hidden}`, rounded: "lg", surface: "subtle", children: [cover ? (_jsx(MediaImage, { src: cover, alt: bundle.name, size: "card", className: "transition-transform group-hover:scale-105" })) : (_jsx(Row, { textSize: "3xl", className: "h-full w-full", align: "center", justify: "center", children: PLACEHOLDER_EMOJI })), showSavingsBadge && discount && (_jsx(PricesOnly, { children: _jsx(Badge, { variant: "success", className: "absolute left-2 top-2", children: BUNDLE_COPY.detail.discountBadge(discount.percent) }) }))] }), _jsx(Text, { className: "line-clamp-2", size: "sm", weight: "semibold", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", className: "mt-1", wrap: true, children: [_jsx(Text, { size: "sm", weight: "bold", children: _jsx(GatedPrice, { label: "Sign in to see the bundle price", children: bundle.bundlePrice
-                                        ? formatCurrency(bundle.bundlePrice, "INR")
-                                        : BUNDLE_COPY.featured.priceFallback }) }), discount && (_jsx(PricesOnly, { children: _jsx(Text, { size: "xs", color: "muted", className: "line-through", children: formatCurrency(discount.originalTotal, "INR") }) })), _jsxs(Text, { size: "xs", color: "muted", children: ["\u00B7 ", BUNDLE_COPY.featured.itemCount(memberCount)] }), stock !== "in_stock" && (_jsx(Badge, { variant: BUNDLE_STOCK_VARIANT[stock], children: BUNDLE_COPY.stockBadge.listVariantOutOfStock }))] })] }), onBuyNow && (_jsx(Div, { border: "subtle", className: `border-t ${__P.p3}`, padding: "t-xs", children: _jsx(BundleBuyNowCta, { bundleSlug: bundle.slug, outOfStock: stock === "out_of_stock", onBuyNow: onBuyNow, compact: true }) }))] }));
+    return (_jsx(Section, { className: `${className}`, padding: "y-2xl", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Row, { gap: "sm", align: "center", justify: "between", wrap: true, reverse: hand === "left", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, size: "2xl", weight: "semibold", color: "primary", children: title }), description && (_jsx(Text, { size: "sm", color: "muted", children: description }))] }), _jsx(Link, { href: String(ROUTES.PUBLIC.BUNDLES), className: "inline-flex items-center gap-[0.375rem] rounded-[var(--appkit-radius-md)] px-[var(--appkit-space-3)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-sm)] font-semibold transition-colors bg-primary text-white hover:bg-primary-600", children: viewMoreLabel })] }), _jsx(Grid, { cols: "cards", gap: "3", children: items.map((bundle) => (_jsxs(Stack, { children: [_jsx(MarketplaceBundleCard, { bundle: bundle }), onBuyNow && (_jsx(BundleBuyNowCta, { bundleSlug: bundle.slug, outOfStock: bundle.bundleStockStatus === "out_of_stock", onBuyNow: onBuyNow, compact: true }))] }, bundle.id))) })] }) }));
 }

package/dist/features/homepage/components/HeroCarousel.js

@@ -90,7 +90,7 @@ function SlideBackground({ bg, legacy, mobileLegacy, isMobile, priority, }) {
     if (effectiveBg.type === "video") {
         return (_jsxs(_Fragment, { children: [_jsx(MediaVideo, { src: src, thumbnailUrl: effectiveBg.thumbnail ?? legacy?.thumbnail, alt: "", autoPlayMuted: true, loop: true, controls: false }), effectiveBg.dimOverlay?.enabled && (_jsx(Div, { className: POSITION_FILL, style: { backgroundColor: `rgba(0,0,0,${(effectiveBg.dimOverlay.opacity ?? 0) / 100})` } }))] }));
     }
-    return (_jsxs(_Fragment, { children: [_jsx(MediaImage, { src: src, alt: "", size: "hero", objectFit: "cover", priority: priority, fetchPriority: priority ? "high" : "low" }), effectiveBg.dimOverlay?.enabled && (_jsx(Div, { className: POSITION_FILL, style: { backgroundColor: `rgba(0,0,0,${(effectiveBg.dimOverlay.opacity ?? 0) / 100})` } }))] }));
+    return (_jsxs(_Fragment, { children: [_jsx(MediaImage, { src: src, alt: "", size: "hero", objectFit: "cover", fill: true, priority: priority, fetchPriority: priority ? "high" : "low" }), effectiveBg.dimOverlay?.enabled && (_jsx(Div, { className: POSITION_FILL, style: { backgroundColor: `rgba(0,0,0,${(effectiveBg.dimOverlay.opacity ?? 0) / 100})` } }))] }));
 }
 /** Renders the background of a card (image, video, color, gradient). */
 function CardBackground({ bg }) {
@@ -106,7 +106,7 @@ function CardBackground({ bg }) {
     if (bg.type === "image" && bg.url) {
         // `cover` for the same reason as the slide backdrop above — this sits
         // behind the card's eyebrow/title/description, not beside them.
-        return _jsx(MediaImage, { src: bg.url, alt: "", size: "card", objectFit: "cover" });
+        return _jsx(MediaImage, { src: bg.url, alt: "", size: "card", objectFit: "cover", fill: true });
     }
     return null;
 }

package/dist/features/homepage/components/SocialPostCard.js

@@ -54,5 +54,5 @@ export function SocialPostCard({ post, showCaption = true, showStats = true }) {
         return _jsx(YouTubeCard, { post: post, showCaption: showCaption });
     }
     const meta = PLATFORM_META[post.platform];
-    return (_jsxs(Anchor, { href: post.permalink, tone: "none", underline: "none", rounded: "xl", className: "group relative block aspect-square overflow-hidden bg-[var(--appkit-color-surface)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--appkit-color-primary)] bg-[var(--appkit-color-surface-elevated)]", "aria-label": post.caption ?? `View on ${meta.label}`, children: [post.imageUrl ? (_jsx(MediaImage, { src: post.imageUrl, alt: post.caption ?? `${meta.label} post`, size: "card", className: "transition-transform duration-300 group-hover:scale-105" })) : (_jsx(Row, { className: "h-full w-full", surface: "subtle", align: "center", justify: "center", children: _jsx(Span, { size: "sm", color: "faint", children: "No preview" }) })), post.mediaType === "video" && (_jsx(Row, { className: "pointer-events-none absolute inset-0", align: "center", justify: "center", children: _jsx(Row, { surface: "overlay-sm", className: "h-12 w-12 backdrop-blur-sm", align: "center", justify: "center", rounded: "full", children: _jsx("svg", { className: "ml-1 h-5 w-5 text-white", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M8 5v14l11-7z" }) }) }) })), post.mediaType === "carousel" && (_jsx(Div, { className: "pointer-events-none absolute right-2 top-2", children: _jsx(Row, { surface: "overlay-sm", className: "h-6 w-6 backdrop-blur-sm", rounded: "default", align: "center", justify: "center", children: _jsxs("svg", { className: "h-3.5 w-3.5 text-white", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [_jsx("rect", { x: "2", y: "3", width: "15", height: "15", rx: "2" }), _jsx("path", { d: "M7 8h14M7 12h14M7 16h14" })] }) }) })), _jsxs(Row, { textWeight: "medium", textSize: "xs", className: `absolute left-2 top-2 px-[0.375rem] text-white ${meta.colorClass}`, padding: "y-2xs", align: "center", gap: "xs", rounded: "default", children: [meta.icon, _jsx(Span, { className: "hidden sm:inline", children: meta.label })] }), _jsxs(Stack, { justify: "end", surface: "overlay-xl", className: `pointer-events-none absolute inset-0 ${__P.p3} opacity-0 transition-opacity duration-200 group-hover:opacity-100`, children: [showCaption && post.caption && (_jsx(Text, { color: "inverse", className: "mb-2 line-clamp-3", size: "xs", children: post.caption })), showStats && (_jsxs(Row, { textSize: "xs", className: "text-white/80", align: "center", gap: "3", children: [post.stats.likes != null && (_jsxs(Span, { layout: "flex", gap: "xs", children: [_jsx("svg", { className: "h-3 w-3", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z" }) }), formatCount(post.stats.likes)] })), post.stats.views != null && (_jsxs(Span, { layout: "flex", gap: "xs", children: [_jsx("svg", { className: "h-3 w-3", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M12 4.5C7 4.5 2.73 7.61 1 12c1.73 4.39 6 7.5 11 7.5s9.27-3.11 11-7.5c-1.73-4.39-6-7.5-11-7.5zM12 17c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z" }) }), formatCount(post.stats.views)] })), post.stats.comments != null && (_jsxs(Span, { layout: "flex", gap: "xs", children: [_jsx("svg", { className: "h-3 w-3", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z" }) }), formatCount(post.stats.comments)] }))] }))] })] }));
+    return (_jsxs(Anchor, { href: post.permalink, tone: "none", underline: "none", rounded: "xl", className: "group relative block aspect-square overflow-hidden focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--appkit-color-primary)] bg-[var(--appkit-color-surface-elevated)]", "aria-label": post.caption ?? `View on ${meta.label}`, children: [post.imageUrl ? (_jsx(MediaImage, { src: post.imageUrl, alt: post.caption ?? `${meta.label} post`, size: "card", className: "transition-transform duration-300 group-hover:scale-105" })) : (_jsx(Row, { className: "h-full w-full", surface: "subtle", align: "center", justify: "center", children: _jsx(Span, { size: "sm", color: "faint", children: "No preview" }) })), post.mediaType === "video" && (_jsx(Row, { className: "pointer-events-none absolute inset-0", align: "center", justify: "center", children: _jsx(Row, { surface: "overlay-sm", className: "h-12 w-12 backdrop-blur-sm", align: "center", justify: "center", rounded: "full", children: _jsx("svg", { className: "ml-1 h-5 w-5 text-white", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M8 5v14l11-7z" }) }) }) })), post.mediaType === "carousel" && (_jsx(Div, { className: "pointer-events-none absolute right-2 top-2", children: _jsx(Row, { surface: "overlay-sm", className: "h-6 w-6 backdrop-blur-sm", rounded: "default", align: "center", justify: "center", children: _jsxs("svg", { className: "h-3.5 w-3.5 text-white", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [_jsx("rect", { x: "2", y: "3", width: "15", height: "15", rx: "2" }), _jsx("path", { d: "M7 8h14M7 12h14M7 16h14" })] }) }) })), _jsxs(Row, { textWeight: "medium", textSize: "xs", className: `absolute left-2 top-2 px-[0.375rem] text-white ${meta.colorClass}`, padding: "y-2xs", align: "center", gap: "xs", rounded: "default", children: [meta.icon, _jsx(Span, { className: "hidden sm:inline", children: meta.label })] }), _jsxs(Stack, { justify: "end", surface: "overlay-xl", className: `pointer-events-none absolute inset-0 ${__P.p3} opacity-0 transition-opacity duration-200 group-hover:opacity-100`, children: [showCaption && post.caption && (_jsx(Text, { color: "inverse", className: "mb-2 line-clamp-3", size: "xs", children: post.caption })), showStats && (_jsxs(Row, { textSize: "xs", className: "text-white/80", align: "center", gap: "3", children: [post.stats.likes != null && (_jsxs(Span, { layout: "flex", gap: "xs", children: [_jsx("svg", { className: "h-3 w-3", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z" }) }), formatCount(post.stats.likes)] })), post.stats.views != null && (_jsxs(Span, { layout: "flex", gap: "xs", children: [_jsx("svg", { className: "h-3 w-3", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M12 4.5C7 4.5 2.73 7.61 1 12c1.73 4.39 6 7.5 11 7.5s9.27-3.11 11-7.5c-1.73-4.39-6-7.5-11-7.5zM12 17c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z" }) }), formatCount(post.stats.views)] })), post.stats.comments != null && (_jsxs(Span, { layout: "flex", gap: "xs", children: [_jsx("svg", { className: "h-3 w-3", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z" }) }), formatCount(post.stats.comments)] }))] }))] })] }));
 }

package/dist/features/inventory/components/AdminMoveLedgerView.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+export declare function AdminMoveLedgerView(): React.JSX.Element;
+/** The kind chips, derived from the union so a sixth kind cannot be missed. */
+export declare const MOVEMENT_KIND_TABS: {
+    id: "move" | "receive" | "pick" | "adjust" | "audit";
+    label: string;
+}[];

package/dist/features/inventory/components/AdminMoveLedgerView.js

@@ -0,0 +1,157 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * WHY: The ledger is the only thing that can answer "where did this go", and
+ *      an append-only log is useless if nobody can read it.
+ * WHAT: The movement listing. READ ONLY — there is no row action, because a
+ *       movement cannot be edited or deleted.
+ *
+ * @tag domain:inventory
+ * @tag layer:feature
+ * @tag access:client
+ */
+import React from "react";
+import { DataListingView, } from "../../admin/components/DataListingView.js";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { sortBy } from "../../../constants/sort.js";
+import { sieveFilter, SIEVE_OP } from "../../../utils/sieve-builder.js";
+import { RecordDetailModal } from "../../../ui/components/RecordDetailModal.js";
+import { statusLabel } from "../../../ui/columns/cell-renderers.js";
+import { MovementKindValues, } from "../schemas/firestore.js";
+/**
+ * `AC60-01 → AC60-04`, or `→ AC60-04` for a receive.
+ *
+ * 🛑 Reads the DENORMALISED codes on the row, not the live box documents, and
+ * that is correct rather than lazy: a movement records what things were
+ * CALLED at the time. Resolving the current code would rewrite history to
+ * match the present, which is the one thing a historical record must not do.
+ */
+function endpoints(m) {
+    const from = m.fromBoxCode ?? m.fromBoxId;
+    const to = m.toBoxCode ?? m.toBoxId;
+    if (from && to)
+        return `${from} → ${to}`;
+    if (to)
+        return `→ ${to}`;
+    if (from)
+        return `${from} →`;
+    return "—";
+}
+export function AdminMoveLedgerView() {
+    /*
+     * 🛑 Declared BEFORE the `useMemo` that closes over `setSelected`. The memo
+     * factory runs during this render, so a `useState` below it would leave the
+     * setter in its temporal dead zone and throw `ReferenceError` on first
+     * paint — a `const` is hoisted but not initialised.
+     */
+    const [selected, setSelected] = React.useState(null);
+    const config = React.useMemo(() => ({
+        portal: "admin",
+        title: "Move Ledger",
+        subtitle: "Every stock movement, newest first. Append-only — a movement that should not have happened is corrected with an adjustment, never edited.",
+        /*
+         * 🛑 NO SEARCH BOX. `inventoryMovements` has no `searchTxt` and the
+         * repository indexes equality-plus-date, so a box here would accept
+         * typing, send the term and change nothing — which is the ~39 dead
+         * boxes `DataListingView`'s own `searchPlaceholder` note is about.
+         * Scoping is done by the kind chips and by arriving from a box or a
+         * product page, both of which pass a real filter.
+         */
+        emptyLabel: "No stock has moved yet",
+        filterKeys: ["kind"],
+        /*
+         * 🛑 REQUIRED, and its absence was not a missing filter — it CRASHED
+         * THE PAGE. `useAdminListing` calls `buildFilters(currentFilterState)`
+         * unconditionally (its optional sibling one line below is spelled
+         * `buildExtraParams?.(…)`), so with none supplied the render threw
+         * `TypeError: buildFilters is not a function` and
+         * `/admin/inventory/movements` never painted at all.
+         *
+         * This view and `AdminStorageBoxesView` were the only two of ~84
+         * `ListingViewConfig` declarations in the repo missing it — both mine,
+         * both from Phase 5, and both among the four screens flagged as
+         * "built without a browser". Opening either one once would have found
+         * this instantly; reading the source did not, because the field is
+         * required by a type that was only checked after a separate syntax
+         * error stopped masking it.
+         */
+        buildFilters: (state) => state.kind ? sieveFilter("kind", SIEVE_OP.EQ, state.kind) : undefined,
+        defaultSort: sortBy("occurredAt", "DESC"),
+        sortOptions: [
+            { value: sortBy("occurredAt", "DESC"), label: "Newest" },
+            { value: sortBy("occurredAt", "ASC"), label: "Oldest" },
+            { value: sortBy("quantity", "DESC"), label: "Largest quantity" },
+        ],
+        queryKey: ["admin", "inventory", "movements"],
+        endpoint: ADMIN_ENDPOINTS.INVENTORY_MOVEMENTS,
+        mapRows: (response) => (response.items ?? []).map((m) => ({
+            id: m.id,
+            primary: `${m.quantity} × ${m.productTitle ?? m.productId}`,
+            secondary: [
+                endpoints(m),
+                /*
+                 * The reason, which is REQUIRED on an adjust — a variance
+                 * nobody explained is indistinguishable from a typo three
+                 * weeks later, and the row cannot be amended to add one.
+                 */
+                m.reason,
+                m.shipmentId ? `shipment ${m.shipmentId}` : undefined,
+            ]
+                .filter(Boolean)
+                .join(" · "),
+            status: statusLabel(m.kind),
+            updatedAt: m.occurredAt ? String(m.occurredAt) : "",
+            doc: m,
+        })),
+        /*
+         * 🛑 Still no `renderRowActions`, no `renderEditor`, no
+         * `rowHrefTemplate` — so these rows get NO EDIT affordance, which is
+         * the honest output for a collection whose repository throws on
+         * `update` and `delete`. A pencil here would be a control that cannot
+         * work, which is the defect the row-affordance work exists to remove
+         * rather than to spread.
+         *
+         * 🛑 But READ is a different question, and the original version of
+         * this comment answered the edit one and stopped — which is why
+         * `audit-listing-detail-affordance` flagged this view as 1 of 64
+         * dead ends and was RIGHT to. `onRowClick` opens a read-only modal;
+         * it mutates nothing and so does not contradict any of the above.
+         */
+        onRowClick: (row) => setSelected(row),
+    }), []);
+    const m = selected?.doc;
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(RecordDetailModal, { isOpen: selected !== null, onClose: () => setSelected(null), title: selected?.primary ?? "Movement", description: m
+                    ? `${statusLabel(m.kind)} · ${endpoints(m)}`
+                    : undefined, fields: m
+                    ? [
+                        /*
+                         * `actorUid` first — it is the field the row cannot show and
+                         * the only reason this modal exists. A uid rather than a
+                         * name on purpose: resolving it would cost a user read per
+                         * row, and the ledger's job is to be unambiguous about WHICH
+                         * account acted, which a uid is and a display name is not.
+                         */
+                        { label: "Moved by", value: m.actorUid || "—" },
+                        { label: "Kind", value: statusLabel(m.kind) },
+                        { label: "Quantity", value: String(m.quantity) },
+                        {
+                            label: "Product",
+                            value: m.productTitle ?? m.productId,
+                        },
+                        { label: "From", value: m.fromBoxCode ?? m.fromBoxId ?? "—" },
+                        { label: "To", value: m.toBoxCode ?? m.toBoxId ?? "—" },
+                        {
+                            label: "Occurred",
+                            value: m.occurredAt ? String(m.occurredAt) : "—",
+                        },
+                        { label: "Reason", value: m.reason || "—" },
+                        { label: "Shipment", value: m.shipmentId || "—" },
+                        { label: "Movement id", value: m.id },
+                    ]
+                    : undefined })] }));
+}
+/** The kind chips, derived from the union so a sixth kind cannot be missed. */
+export const MOVEMENT_KIND_TABS = MovementKindValues.map((k) => ({
+    id: k,
+    label: statusLabel(k),
+}));

package/dist/features/inventory/components/AdminStorageBoxesView.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+/**
+ * The register-a-box form.
+ *
+ * Exported because it is a PAGE now, not a drawer — see the note on
+ * `primaryAction` below for why create could not share the row affordance.
+ */
+export declare function RegisterBoxForm({ onCreated }: {
+    onCreated: () => void;
+}): React.JSX.Element;
+export declare function AdminStorageBoxesView(): React.JSX.Element;