@mohasinac/appkit 4.59.0 → 4.60.0

package/dist/client.d.ts

@@ -132,6 +132,7 @@ export { useMediaCrop } from "./features/media/index";
 export { useMediaTrim } from "./features/media/index";
 export { useMediaUpload } from "./features/media/index";
 export { SessionProvider, useSession } from "./react/contexts/SessionContext";
+export { useOptionalSession } from "./react/contexts/SessionContext";
 export type { SessionProviderProps } from "./react/contexts/SessionContext";
 export { useUrlTable } from "./react/hooks/useUrlTable";
 export { useTabParam } from "./react/hooks/useTabParam";
@@ -387,6 +388,10 @@ export type { UserAccountHubViewProps, UserAccountHubViewLabels, UserOrdersViewP
 export { useOrders, useOrder, OrdersList } from "./features/orders/index";
 export { OrderStatusTimeline } from "./features/orders/components/OrderStatusTimeline";
 export type { OrderStatusTimelineProps } from "./features/orders/components/OrderStatusTimeline";
+export { PROTECTION_CLAIM_REASON_LABEL } from "./features/protection-claims/schemas/firestore";
+export type { ProtectionClaimReason } from "./features/protection-claims/schemas/firestore";
+export { OrderCompletionPanel } from "./features/orders/components/OrderCompletionPanel";
+export type { OrderCompletionPanelProps, RateableLine } from "./features/orders/components/OrderCompletionPanel";
 export { EmiInstallmentsPanel } from "./features/orders/components/EmiInstallmentsPanel";
 export type { EmiInstallmentsPanelProps } from "./features/orders/components/EmiInstallmentsPanel";
 export { CountdownDisplay } from "./ui/components/CountdownDisplay";
@@ -411,7 +416,7 @@ export type { PromotionsViewProductSectionProps } from "./features/promotions/co
 export { RichText } from "./ui/rich-text/RichText";
 export { RichTextRenderer } from "./ui/rich-text/RichTextRenderer";
 export type { RichTextRendererProps } from "./ui/rich-text/RichTextRenderer";
-export { SCAM_TYPES, SCAM_CATEGORIES, SCAM_TYPE_LABELS, SCAM_CATEGORY_LABELS, getScamType, getScamTypesByCategory, } from "./features/scams/constants/scam-types";
+export { SCAM_TYPES, SCAM_CATEGORIES, SCAM_TYPE_LABELS, SCAM_CATEGORY_LABELS, getScamType, getScamTypesByCategory, isScamType, } from "./features/scams/constants/scam-types";
 export type { ScamType, ScamCategory, ScamTypeDefinition, ScamCategoryDefinition } from "./features/scams/constants/scam-types";
 export { SCAM_PLATFORM_LABELS, ScamPlatformValues, } from "./features/scams/schemas/firestore";
 export type { ScamPlatform } from "./features/scams/schemas/firestore";
@@ -498,8 +503,8 @@ export type { PaymentProofReviewMessageInput } from "./features/orders/utils/pay
 export type { AdminNotificationDocument, ItemRequestDocument, ModerationQueueDocument, ReportDocument, CustomRoleDocument, AnalyticsCardDocument, ListingTemplateDocument, } from "./features/store-extensions/index";
 export { CommandPalette, useCommandPaletteHotkey } from "./features/shell/index";
 export type { CommandPaletteGroup } from "./features/shell/index";
-export { AdminBlogEditorView, AdminBundleEditorView, AdminCarouselEditorView, AdminCategoryEditorView, AdminCouponEditorView, AdminFaqEditorView, AdminFeatureEditorView, AdminOrderEditorView, AdminPayoutMarkPaidModal, AdminAuditLogView, ViewAuditLogEntryModal, AdminProductEditorView, AdminScammerEditorView, AdminEmployeeEditorView, AdminNavEditorView, AdminUserEditorView, AdminStoreEditorView, AdminSublistingCategoryEditorView, AdminSupportTicketDetailView, } from "./features/admin/index";
-export type { AdminStoreEditorViewProps, AdminPayoutMarkPaidModalProps, AdminAuditLogViewProps, AuditLogEntryDetail, ViewAuditLogEntryModalProps } from "./features/admin/index";
+export { AdminBlogEditorView, AdminBundleEditorView, AdminCarouselEditorView, AdminCategoryEditorView, AdminCouponEditorView, AdminFaqEditorView, AdminFeatureEditorView, AdminOrderEditorView, AdminPayoutMarkPaidModal, AdminAuditLogView, AdminMoneyCasesView, AdminGatewayEventsView, ViewAuditLogEntryModal, AdminProductEditorView, AdminScammerEditorView, AdminEmployeeEditorView, AdminNavEditorView, AdminUserEditorView, AdminStoreEditorView, AdminSublistingCategoryEditorView, AdminSupportTicketDetailView, } from "./features/admin/index";
+export type { AdminStoreEditorViewProps, AdminPayoutMarkPaidModalProps, AdminAuditLogViewProps, AdminMoneyCasesViewProps, AuditLogEntryDetail, ViewAuditLogEntryModalProps } from "./features/admin/index";
 export type { NavItemData } from "./features/admin/index";
 export { PageLoader } from "./ui/index";
 export { ADMIN_CHECKOUT_BYPASS_FLAG_KEY } from "./features/admin/schemas/firestore";
@@ -535,7 +540,7 @@ export type { PriceGuidanceHintProps } from "./features/categories/components/Pr
 export { BrandInlineSelect } from "./features/seller/components/BrandInlineSelect";
 export { API_ENDPOINTS } from "./constants/index";
 export { SELLER_LISTING_TABS, type SellerListingTabId, } from "./features/products/constants/listing-tabs";
-export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs";
+export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_PROTECTION_CLAIM_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs";
 export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS, STORE_FIELDS, CATEGORY_FIELDS, BLOG_FIELDS, USER_FIELDS, ADDRESS_FIELDS, BRAND_FIELDS, CART_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, NOTIFICATION_FIELDS, SESSION_FIELDS, COUPON_USAGE_FIELDS, SCAMMER_FIELDS, SUPPORT_TICKET_FIELDS, CAROUSEL_FIELDS, COUPON_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
 export { CART_LANE, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane, laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane, canAddNewItems, type CartLane, type LaneAssignable, } from "./_internal/shared/checkout/lanes";
 export { roundShippingUp, toQuoteOptions, reconcileShipping, SHIPPING_ROUND_UP_TO, type ShippingQuoteOption, type SelectedShippingQuote, type ActualShipmentCost, type ShippingReconciliation, } from "./_internal/shared/shipping/quote";

package/dist/client.js

@@ -199,6 +199,14 @@ export { useMediaTrim } from "./features/media/index.js";
 export { useMediaUpload } from "./features/media/index.js";
 // Client-side context providers
 export { SessionProvider, useSession } from "./react/contexts/SessionContext.js";
+/*
+ * 🛑 `useOptionalSession` — returns null instead of throwing when no provider
+ * is mounted. Required by anything that renders on a PUBLIC page and adjusts
+ * for the viewer: library code must not demand a provider (Root Cause #20),
+ * and the no-provider path has to fail CLOSED. `useCanSeePrices` already
+ * depends on it; the grievance form on /grievance is the second consumer.
+ */
+export { useOptionalSession } from "./react/contexts/SessionContext.js";
 // ThemeProvider — exported above alongside the registry-aware variant.
 export { useUrlTable } from "./react/hooks/useUrlTable.js";
 export { useTabParam } from "./react/hooks/useTabParam.js";
@@ -405,6 +413,21 @@ export { couponDraftToPayload } from "./features/seller/schemas/coupon-form.js";
 export { UserAccountHubView, UserOrdersView, UserBidsView, OrderDetailView, UserReturnsView, useNotifications } from "./features/account/index.js";
 export { useOrders, useOrder, OrdersList } from "./features/orders/index.js";
 export { OrderStatusTimeline } from "./features/orders/components/OrderStatusTimeline.js";
+/*
+ * The buyer's completion surface. Client entry only — it fetches and posts.
+ */
+/*
+ * Buyer-facing claim reason labels. A pure `Record<Reason, string>` — no
+ * firebase-admin anywhere in its chain, so it is client-safe.
+ *
+ * 🛑 CLIENT entry only, not also `index.ts`. The buyer's claim form is the only
+ * consumer and it is a `"use client"` module; adding it to the main barrel
+ * would widen the graph the build-weight work is unwinding for no reader. The
+ * admin queue reads the same map through `/server`, which already exports the
+ * schema module.
+ */
+export { PROTECTION_CLAIM_REASON_LABEL } from "./features/protection-claims/schemas/firestore.js";
+export { OrderCompletionPanel } from "./features/orders/components/OrderCompletionPanel.js";
 // Buyer-facing EMI schedule with a pay-any-instalment action.
 export { EmiInstallmentsPanel } from "./features/orders/components/EmiInstallmentsPanel.js";
 export { CountdownDisplay } from "./ui/components/CountdownDisplay.js";
@@ -422,7 +445,7 @@ export { PromotionsViewProductSection, PromotionsHero, PromotionsView } from "./
 export { RichText } from "./ui/rich-text/RichText.js";
 export { RichTextRenderer } from "./ui/rich-text/RichTextRenderer.js";
 // Scam registry — pure data constants safe for client bundle
-export { SCAM_TYPES, SCAM_CATEGORIES, SCAM_TYPE_LABELS, SCAM_CATEGORY_LABELS, getScamType, getScamTypesByCategory, } from "./features/scams/constants/scam-types.js";
+export { SCAM_TYPES, SCAM_CATEGORIES, SCAM_TYPE_LABELS, SCAM_CATEGORY_LABELS, getScamType, getScamTypesByCategory, isScamType, } from "./features/scams/constants/scam-types.js";
 export { SCAM_PLATFORM_LABELS, ScamPlatformValues, } from "./features/scams/schemas/firestore.js";
 // History (recently-viewed) — client hook + guest util + cap constants
 export { useHistory, useHistoryMergeOnLogin, getGuestHistory, trackGuestHistory, removeGuestHistoryItem, clearGuestHistory, getGuestHistoryCount, HistoryTracker, } from "./features/history/index.js";
@@ -515,7 +538,7 @@ export { normalizeError, getErrorMessage, isApiNormalized, isAppNormalized, isFi
  */
 export { buildPaymentProofReviewMessage } from "./features/orders/utils/payment-proof-message.js";
 export { CommandPalette, useCommandPaletteHotkey } from "./features/shell/index.js";
-export { AdminBlogEditorView, AdminBundleEditorView, AdminCarouselEditorView, AdminCategoryEditorView, AdminCouponEditorView, AdminFaqEditorView, AdminFeatureEditorView, AdminOrderEditorView, AdminPayoutMarkPaidModal, AdminAuditLogView, ViewAuditLogEntryModal, AdminProductEditorView, AdminScammerEditorView, 
+export { AdminBlogEditorView, AdminBundleEditorView, AdminCarouselEditorView, AdminCategoryEditorView, AdminCouponEditorView, AdminFaqEditorView, AdminFeatureEditorView, AdminOrderEditorView, AdminPayoutMarkPaidModal, AdminAuditLogView, AdminMoneyCasesView, AdminGatewayEventsView, ViewAuditLogEntryModal, AdminProductEditorView, AdminScammerEditorView, 
 // Client-exported for the W22 /admin/team/{new,[id]/edit} pages. It was
 // reachable only from `index.ts` (the SERVER entry), which a "use client"
 // page must never import — that is the Turbopack client-bundle trap.
@@ -544,7 +567,7 @@ export { API_ENDPOINTS } from "./constants/index.js";
 // [CLIENT-SAFE] Pure, zero-import constant files — dashboard filter-tab
 // sets and Firestore field-name maps. No server dependency of any kind.
 export { SELLER_LISTING_TABS, } from "./features/products/constants/listing-tabs.js";
-export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs.js";
+export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_PROTECTION_CLAIM_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs.js";
 export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS, STORE_FIELDS, CATEGORY_FIELDS, BLOG_FIELDS, USER_FIELDS, ADDRESS_FIELDS, BRAND_FIELDS, CART_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, NOTIFICATION_FIELDS, SESSION_FIELDS, COUPON_USAGE_FIELDS, SCAMMER_FIELDS, SUPPORT_TICKET_FIELDS, CAROUSEL_FIELDS, COUPON_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names.js";
 // Checkout lanes — the derived auction > offer > standard partition of the
 // cart, and the priority rule that decides which one may be checked out.

package/dist/configs/tailwind.d.ts

@@ -42,20 +42,8 @@ export declare function defineTailwindConfig(override?: TailwindConfigOverride):
                 secondary: string;
                 accent: string;
                 surface: string;
-                "surface-muted": string;
                 "surface-elevated": string;
-                "on-surface": string;
-                "on-surface-muted": string;
                 border: string;
-                "border-strong": string;
-                divider: string;
-                "text-primary": string;
-                "text-secondary": string;
-                "text-tertiary": string;
-                "text-disabled": string;
-                "text-inverse": string;
-                link: string;
-                "link-hover": string;
                 success: {
                     DEFAULT: string;
                     surface: string;

package/dist/configs/tailwind.js

@@ -38,23 +38,36 @@ export function defineTailwindConfig(override = {}) {
                     primary: "var(--appkit-color-primary)",
                     secondary: "var(--appkit-color-secondary)",
                     accent: "var(--appkit-color-accent)",
-                    // Surface
+                    /*
+                     * Surface
+                     *
+                     * 🛑 THIRTEEN ENTRIES WERE DELETED FROM HERE, and every one of them
+                     * generated an invalid declaration.
+                     *
+                     * They mapped to camelCase custom properties — `--appkit-color-surfaceMuted`,
+                     * `--appkit-color-textPrimary`, `--appkit-color-borderStrong`,
+                     * `--appkit-color-linkHover` and nine more — and **not one of those
+                     * names is declared anywhere**. The real tokens are kebab-case. So
+                     * `bg-surface-muted` compiled to
+                     * `background-color: var(--appkit-color-surfaceMuted)`, which is
+                     * undefined with no fallback, which drops the declaration at
+                     * computed-value time: the utility existed, was documented by its
+                     * presence here, and did nothing.
+                     *
+                     * Deleted rather than renamed because all ten named utilities have
+                     * ZERO uses across both repos (measured), and once corrected most
+                     * would have been redundant aliases of utilities that already work
+                     * — `text-text-primary` for `text-[var(--appkit-color-text)]`. A
+                     * config entry that advertises a utility which silently no-ops is a
+                     * trap for whoever writes the natural-looking class next; an absent
+                     * entry is a compile-time nothing they will notice immediately.
+                     *
+                     * `surface-elevated` is kept because it names a real, distinct token
+                     * that no other utility reaches — with its var spelled correctly.
+                     */
                     surface: "var(--appkit-color-surface)",
-                    "surface-muted": "var(--appkit-color-surfaceMuted)",
-                    "surface-elevated": "var(--appkit-color-surfaceElevated)",
-                    "on-surface": "var(--appkit-color-onSurface)",
-                    "on-surface-muted": "var(--appkit-color-onSurfaceMuted)",
+                    "surface-elevated": "var(--appkit-color-surface-elevated)",
                     border: "var(--appkit-color-border)",
-                    "border-strong": "var(--appkit-color-borderStrong)",
-                    divider: "var(--appkit-color-divider)",
-                    // Text
-                    "text-primary": "var(--appkit-color-textPrimary)",
-                    "text-secondary": "var(--appkit-color-textSecondary)",
-                    "text-tertiary": "var(--appkit-color-textTertiary)",
-                    "text-disabled": "var(--appkit-color-textDisabled)",
-                    "text-inverse": "var(--appkit-color-textInverse)",
-                    link: "var(--appkit-color-link)",
-                    "link-hover": "var(--appkit-color-linkHover)",
                     // State — semantic colors with surface sub-keys
                     success: {
                         DEFAULT: "var(--appkit-color-success)",

package/dist/constants/api-endpoints.d.ts

@@ -150,6 +150,18 @@ export declare const ADMIN_ENDPOINTS: {
     readonly PAYOUTS_EXPORT: "/api/admin/payouts/export";
     readonly AUDIT_LOG: "/api/admin/audit-log";
     readonly AUDIT_LOG_BY_ID: (id: string) => string;
+    readonly PAYMENT_CASES: "/api/admin/payment-cases";
+    readonly PAYMENT_CASE_BY_ID: (id: string) => string;
+    readonly PROTECTION_CLAIMS: "/api/admin/protection-claims";
+    readonly PROTECTION_CLAIM_BY_ID: (id: string) => string;
+    /**
+     * Credit or debit a buyer's points by hand — `admin_adjustment`'s first human
+     * writer (D48). POST only; the balance and ledger are already readable from
+     * the user detail surfaces, so there is no matching GET.
+     */
+    readonly POINTS: "/api/admin/points";
+    readonly MAINTENANCE_GATEWAY_EVENTS: "/api/admin/maintenance/gateway-events";
+    readonly MAINTENANCE_OBLIGATIONS: "/api/admin/maintenance/obligations";
     readonly SHIPMENTS: "/api/admin/shipments";
     readonly SHIPMENT_BY_ID: (id: string) => string;
     readonly SHIPMENT_LOTS: (id: string) => string;
@@ -159,6 +171,11 @@ export declare const ADMIN_ENDPOINTS: {
     readonly SHIPMENT_LOT_ITEMS_BULK: (id: string, lotId: string) => string;
     readonly SHIPMENT_LOT_ITEM_LINK: (id: string, lotId: string, itemId: string) => string;
     readonly SHIPMENTS_PROJECTIONS: "/api/admin/shipments/projections";
+    readonly INVENTORY_BOXES: "/api/admin/inventory/boxes";
+    readonly INVENTORY_BOX_BY_ID: (id: string) => string;
+    readonly INVENTORY_PLACEMENTS: "/api/admin/inventory/placements";
+    readonly INVENTORY_MOVEMENTS: "/api/admin/inventory/movements";
+    readonly INVENTORY_RECEIVE: "/api/admin/inventory/receive";
     readonly CATALOGUE_APPROVALS: "/api/admin/catalogue";
     readonly CATALOGUE_APPROVE: (id: string) => string;
     readonly CATALOGUE_REJECT: (id: string) => string;
@@ -411,9 +428,6 @@ export declare const HOMEPAGE_ENDPOINTS: {
     readonly CAROUSEL: "/api/carousel";
     readonly NEWSLETTER_SUBSCRIBE: "/api/newsletter/subscribe";
 };
-export declare const LOYALTY_ENDPOINTS: {
-    readonly BALANCE: (uid: string) => string;
-};
 export declare const ANALYTICS_ENDPOINTS: {
     readonly PAGE_VIEW: "/api/analytics/pageview";
 };
@@ -718,6 +732,18 @@ export declare const API_ENDPOINTS: {
         readonly PAYOUTS_EXPORT: "/api/admin/payouts/export";
         readonly AUDIT_LOG: "/api/admin/audit-log";
         readonly AUDIT_LOG_BY_ID: (id: string) => string;
+        readonly PAYMENT_CASES: "/api/admin/payment-cases";
+        readonly PAYMENT_CASE_BY_ID: (id: string) => string;
+        readonly PROTECTION_CLAIMS: "/api/admin/protection-claims";
+        readonly PROTECTION_CLAIM_BY_ID: (id: string) => string;
+        /**
+         * Credit or debit a buyer's points by hand — `admin_adjustment`'s first human
+         * writer (D48). POST only; the balance and ledger are already readable from
+         * the user detail surfaces, so there is no matching GET.
+         */
+        readonly POINTS: "/api/admin/points";
+        readonly MAINTENANCE_GATEWAY_EVENTS: "/api/admin/maintenance/gateway-events";
+        readonly MAINTENANCE_OBLIGATIONS: "/api/admin/maintenance/obligations";
         readonly SHIPMENTS: "/api/admin/shipments";
         readonly SHIPMENT_BY_ID: (id: string) => string;
         readonly SHIPMENT_LOTS: (id: string) => string;
@@ -727,6 +753,11 @@ export declare const API_ENDPOINTS: {
         readonly SHIPMENT_LOT_ITEMS_BULK: (id: string, lotId: string) => string;
         readonly SHIPMENT_LOT_ITEM_LINK: (id: string, lotId: string, itemId: string) => string;
         readonly SHIPMENTS_PROJECTIONS: "/api/admin/shipments/projections";
+        readonly INVENTORY_BOXES: "/api/admin/inventory/boxes";
+        readonly INVENTORY_BOX_BY_ID: (id: string) => string;
+        readonly INVENTORY_PLACEMENTS: "/api/admin/inventory/placements";
+        readonly INVENTORY_MOVEMENTS: "/api/admin/inventory/movements";
+        readonly INVENTORY_RECEIVE: "/api/admin/inventory/receive";
         readonly CATALOGUE_APPROVALS: "/api/admin/catalogue";
         readonly CATALOGUE_APPROVE: (id: string) => string;
         readonly CATALOGUE_REJECT: (id: string) => string;
@@ -926,9 +957,6 @@ export declare const API_ENDPOINTS: {
         readonly CAROUSEL: "/api/carousel";
         readonly NEWSLETTER_SUBSCRIBE: "/api/newsletter/subscribe";
     };
-    readonly LOYALTY: {
-        readonly BALANCE: (uid: string) => string;
-    };
     readonly ANALYTICS: {
         readonly PAGE_VIEW: "/api/analytics/pageview";
     };
@@ -1251,6 +1279,18 @@ export declare const API_ROUTES: {
         readonly PAYOUTS_EXPORT: "/api/admin/payouts/export";
         readonly AUDIT_LOG: "/api/admin/audit-log";
         readonly AUDIT_LOG_BY_ID: (id: string) => string;
+        readonly PAYMENT_CASES: "/api/admin/payment-cases";
+        readonly PAYMENT_CASE_BY_ID: (id: string) => string;
+        readonly PROTECTION_CLAIMS: "/api/admin/protection-claims";
+        readonly PROTECTION_CLAIM_BY_ID: (id: string) => string;
+        /**
+         * Credit or debit a buyer's points by hand — `admin_adjustment`'s first human
+         * writer (D48). POST only; the balance and ledger are already readable from
+         * the user detail surfaces, so there is no matching GET.
+         */
+        readonly POINTS: "/api/admin/points";
+        readonly MAINTENANCE_GATEWAY_EVENTS: "/api/admin/maintenance/gateway-events";
+        readonly MAINTENANCE_OBLIGATIONS: "/api/admin/maintenance/obligations";
         readonly SHIPMENTS: "/api/admin/shipments";
         readonly SHIPMENT_BY_ID: (id: string) => string;
         readonly SHIPMENT_LOTS: (id: string) => string;
@@ -1260,6 +1300,11 @@ export declare const API_ROUTES: {
         readonly SHIPMENT_LOT_ITEMS_BULK: (id: string, lotId: string) => string;
         readonly SHIPMENT_LOT_ITEM_LINK: (id: string, lotId: string, itemId: string) => string;
         readonly SHIPMENTS_PROJECTIONS: "/api/admin/shipments/projections";
+        readonly INVENTORY_BOXES: "/api/admin/inventory/boxes";
+        readonly INVENTORY_BOX_BY_ID: (id: string) => string;
+        readonly INVENTORY_PLACEMENTS: "/api/admin/inventory/placements";
+        readonly INVENTORY_MOVEMENTS: "/api/admin/inventory/movements";
+        readonly INVENTORY_RECEIVE: "/api/admin/inventory/receive";
         readonly CATALOGUE_APPROVALS: "/api/admin/catalogue";
         readonly CATALOGUE_APPROVE: (id: string) => string;
         readonly CATALOGUE_REJECT: (id: string) => string;
@@ -1459,9 +1504,6 @@ export declare const API_ROUTES: {
         readonly CAROUSEL: "/api/carousel";
         readonly NEWSLETTER_SUBSCRIBE: "/api/newsletter/subscribe";
     };
-    readonly LOYALTY: {
-        readonly BALANCE: (uid: string) => string;
-    };
     readonly ANALYTICS: {
         readonly PAGE_VIEW: "/api/analytics/pageview";
     };

package/dist/constants/api-endpoints.js

@@ -187,6 +187,23 @@ export const ADMIN_ENDPOINTS = {
     PAYOUTS_EXPORT: "/api/admin/payouts/export",
     AUDIT_LOG: "/api/admin/audit-log",
     AUDIT_LOG_BY_ID: (id) => `/api/admin/audit-log/${id}`,
+    /*
+     * Payment protection. `payment-cases` is NOT under `maintenance/` — see the
+     * route-map entry for why: maintenance means "something broke, look when you
+     * can", and a chargeback has a clock and real money.
+     */
+    PAYMENT_CASES: "/api/admin/payment-cases",
+    PAYMENT_CASE_BY_ID: (id) => `/api/admin/payment-cases/${id}`,
+    PROTECTION_CLAIMS: "/api/admin/protection-claims",
+    PROTECTION_CLAIM_BY_ID: (id) => `/api/admin/protection-claims/${id}`,
+    /**
+     * Credit or debit a buyer's points by hand — `admin_adjustment`'s first human
+     * writer (D48). POST only; the balance and ledger are already readable from
+     * the user detail surfaces, so there is no matching GET.
+     */
+    POINTS: "/api/admin/points",
+    MAINTENANCE_GATEWAY_EVENTS: "/api/admin/maintenance/gateway-events",
+    MAINTENANCE_OBLIGATIONS: "/api/admin/maintenance/obligations",
     SHIPMENTS: "/api/admin/shipments",
     SHIPMENT_BY_ID: (id) => `/api/admin/shipments/${id}`,
     SHIPMENT_LOTS: (id) => `/api/admin/shipments/${id}/lots`,
@@ -196,6 +213,12 @@ export const ADMIN_ENDPOINTS = {
     SHIPMENT_LOT_ITEMS_BULK: (id, lotId) => `/api/admin/shipments/${id}/lots/${lotId}/items/bulk`,
     SHIPMENT_LOT_ITEM_LINK: (id, lotId, itemId) => `/api/admin/shipments/${id}/lots/${lotId}/items/${itemId}/link`,
     SHIPMENTS_PROJECTIONS: "/api/admin/shipments/projections",
+    // Inventory — the box registry, placements and the move ledger.
+    INVENTORY_BOXES: "/api/admin/inventory/boxes",
+    INVENTORY_BOX_BY_ID: (id) => `/api/admin/inventory/boxes/${id}`,
+    INVENTORY_PLACEMENTS: "/api/admin/inventory/placements",
+    INVENTORY_MOVEMENTS: "/api/admin/inventory/movements",
+    INVENTORY_RECEIVE: "/api/admin/inventory/receive",
     CATALOGUE_APPROVALS: "/api/admin/catalogue",
     CATALOGUE_APPROVE: (id) => `/api/admin/catalogue/${id}/approve`,
     CATALOGUE_REJECT: (id) => `/api/admin/catalogue/${id}/reject`,
@@ -525,12 +548,6 @@ export const HOMEPAGE_ENDPOINTS = {
     NEWSLETTER_SUBSCRIBE: "/api/newsletter/subscribe",
 };
 // ---------------------------------------------------------------------------
-// Loyalty
-// ---------------------------------------------------------------------------
-export const LOYALTY_ENDPOINTS = {
-    BALANCE: (uid) => `/api/loyalty/balance?uid=${uid}`,
-};
-// ---------------------------------------------------------------------------
 // Analytics — page-view tracking (public pages only)
 // ---------------------------------------------------------------------------
 export const ANALYTICS_ENDPOINTS = {
@@ -785,7 +802,6 @@ export const API_ENDPOINTS = {
     LOTTERY: LOTTERY_ENDPOINTS,
     FAQS: FAQ_ENDPOINTS,
     HOMEPAGE: HOMEPAGE_ENDPOINTS,
-    LOYALTY: LOYALTY_ENDPOINTS,
     ANALYTICS: ANALYTICS_ENDPOINTS,
     MEDIA: MEDIA_ENDPOINTS,
     ORDERS: ORDER_ENDPOINTS,

package/dist/constants/index.d.ts

@@ -9,7 +9,7 @@
  *   import { COLLECTION_CACHE_PATHS } from "@mohasinac/appkit/constants";
  *   import { resolveEndpoint } from "@mohasinac/appkit/constants";
  */
-export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, PROMOTION_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, STORE_ENDPOINTS, WISHLIST_ENDPOINTS, PROFILE_STATS_ENDPOINTS, } from "./api-endpoints";
+export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, PROMOTION_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, STORE_ENDPOINTS, WISHLIST_ENDPOINTS, PROFILE_STATS_ENDPOINTS, } from "./api-endpoints";
 export { COLLECTION_CACHE_PATHS } from "./cache-invalidation";
 export { PAGE_SIZES, MAX_PAGE_SIZE, FEATURED_LIMITS, SITEMAP_LIMITS, } from "./pagination-presets";
 export type { PageSizeKey } from "./pagination-presets";

package/dist/constants/index.js

@@ -9,7 +9,7 @@
  *   import { COLLECTION_CACHE_PATHS } from "@mohasinac/appkit/constants";
  *   import { resolveEndpoint } from "@mohasinac/appkit/constants";
  */
-export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, PROMOTION_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, STORE_ENDPOINTS, WISHLIST_ENDPOINTS, PROFILE_STATS_ENDPOINTS, } from "./api-endpoints.js";
+export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, PROMOTION_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, STORE_ENDPOINTS, WISHLIST_ENDPOINTS, PROFILE_STATS_ENDPOINTS, } from "./api-endpoints.js";
 export { COLLECTION_CACHE_PATHS } from "./cache-invalidation.js";
 export { PAGE_SIZES, MAX_PAGE_SIZE, FEATURED_LIMITS, SITEMAP_LIMITS, } from "./pagination-presets.js";
 export { NOTIFICATION_TYPES, NOTIFICATION_TYPE_TABS, } from "./notification-types.js";

package/dist/contracts/index.d.ts

@@ -2,7 +2,7 @@ export type { WhereOp, SieveQuery, PagedResult, IReadRepository, IWriteRepositor
 export type { AuthPayload, AuthUser, CreateUserInput, IAuthProvider, ISessionProvider, } from "./auth";
 export type { EmailAttachment, EmailOptions, EmailResult, IEmailProvider, } from "./email";
 export type { UploadOptions, StorageFile, IStorageProvider } from "./storage";
-export type { PaymentOrder, PaymentCapture, Refund } from "./payment";
+export type { PaymentOrder, PaymentCapture, Refund, Dispute, GatewayPaymentRecord, } from "./payment";
 export { IPaymentProvider } from "./payment";
 export type { ShippingAddress, CreateShipmentInput, Shipment, TrackingEvent, TrackingInfo, ServiceabilityResult, } from "./shipping";
 export { IShippingProvider } from "./shipping";

package/dist/contracts/payment.d.ts

@@ -36,6 +36,102 @@ export interface Refund {
     reason?: string;
     createdAt: string;
 }
+/**
+ * A chargeback / dispute, normalised at the provider boundary.
+ *
+ * ## Units
+ *
+ * 🛑 `amount` and `amountDeducted` are **decimal rupees**. Razorpay's own
+ * entity reports both in currency SUBUNITS (`RazorpayDispute.amount`), so the
+ * adapter converts with `paiseToRupees` and nothing downstream ever sees the
+ * subunit figure — `audit-money-units` blocks both the raw `/100` and the word
+ * for the subunit in a comment or label.
+ *
+ * 🛑 **This deliberately differs from `Refund` above, which is in SUBUNITS**,
+ * and the inconsistency is real rather than an oversight here: `refund()` takes
+ * `rupeesToPaise(input.amount)` from its one call site and returns
+ * `Number(result.amount)` unconverted. That is pre-existing and is NOT changed
+ * by this type — flipping it would silently alter what every refund consumer
+ * reads, which is the money-unit migration's whole cautionary tale. A new
+ * surface gets the correct convention; an existing one gets a measured
+ * migration or nothing. If you are here because the two look inconsistent:
+ * they are, `Dispute` is the right one, and `Refund` is a separate job.
+ *
+ * 🛑 `respondBy` and `createdAt` are `Date`. Razorpay reports both as **Unix
+ * timestamps in SECONDS**, so `new Date(respond_by)` yields 1970 and reads as
+ * corrupt data rather than as a unit error — the same trap the Vercel token's
+ * `expiresAt` sets. Multiply by 1000 at the boundary, once.
+ *
+ * ## `status` and `phase` are strings, not unions, on purpose
+ *
+ * The SDK declares both as `string` (`disputes.d.ts`), and the value set is
+ * Razorpay's to change. Inventing a union here would mean a real dispute in a
+ * state we did not anticipate either fails a parse or gets asserted into the
+ * wrong member — and a dispute is the one record where being wrong has a
+ * deadline attached. Treat them as opaque, compare against known values where
+ * a decision depends on it, and never exhaustively switch.
+ */
+export interface Dispute {
+    /** The gateway's own dispute id. */
+    id: string;
+    /** The payment this dispute is against — the join key to our orders. */
+    paymentId: string;
+    /** Decimal rupees. */
+    amount: number;
+    currency: string;
+    /** Decimal rupees. What the gateway takes from our balance if we lose. */
+    amountDeducted: number;
+    /** The gateway's reason code, verbatim. */
+    reasonCode: string;
+    /**
+     * The gateway's own deadline for a response. **An external, hard date** — not
+     * an SLA we invented — which is why a `paymentCases` row built from a dispute
+     * takes its `dueAt` from here and from nowhere else.
+     */
+    respondBy: Date;
+    /** Opaque — see the docstring. */
+    status: string;
+    /** Opaque — see the docstring. */
+    phase: string;
+    createdAt: Date;
+    /** The provider's short name, so a mixed-gateway queue stays attributable. */
+    gateway: string;
+}
+/**
+ * One payment as the GATEWAY sees it — the input to reconciliation.
+ *
+ * 🛑 This type exists so a reconciler can compare the gateway's view against
+ * ours **in the direction that needs no trust in our own code.** Every other
+ * check in this system starts from our records and asks whether they are
+ * consistent; this one starts from the gateway's and asks whether we have an
+ * order at all. That is the only direction that could have detected the
+ * 2026-10-21 incident, where our side had nothing to be inconsistent with.
+ *
+ * `amount`, `amountRefunded` — decimal rupees, converted at the boundary.
+ * `capturedAt` — a Date; the gateway reports Unix SECONDS.
+ */
+export interface GatewayPaymentRecord {
+    /** The gateway's payment id. */
+    id: string;
+    /** The gateway's order id, when the payment is attached to one. */
+    orderId?: string;
+    /** Decimal rupees. */
+    amount: number;
+    currency: string;
+    /**
+     * The gateway's own status string, verbatim and opaque. Razorpay uses
+     * `created | authorized | captured | refunded | failed`; treat anything
+     * unrecognised as "not captured", which fails toward not drawing a
+     * conclusion.
+     */
+    status: string;
+    /** Decimal rupees already refunded against this payment, per the gateway. */
+    amountRefunded: number;
+    /** `null` | `partial` | `full`, as the gateway reports it. */
+    refundStatus?: string;
+    capturedAt?: Date;
+    gateway: string;
+}
 /**
  * Payment gateway adapter contract. An abstract base class rather than a
  * plain interface so every provider (manual, PhonePe, and any future
@@ -53,4 +149,39 @@ export declare abstract class IPaymentProvider {
     abstract capturePayment(orderId: string): Promise<PaymentCapture>;
     abstract refund(paymentId: string, amount?: number): Promise<Refund>;
     abstract getOrder(orderId: string): Promise<PaymentOrder>;
+    /**
+     * Every payment the gateway recorded in a window — the reconciliation feed.
+     *
+     * 🛑 A provider that cannot enumerate payments returns `[]`, and the caller
+     * MUST treat an empty list as "no information", never as "no payments".
+     * Concluding "nothing is missing" from a provider that cannot answer is the
+     * false-clean a reconciler exists to avoid.
+     */
+    abstract listPayments(opts: {
+        from: Date;
+        to: Date;
+        limit?: number;
+    }): Promise<GatewayPaymentRecord[]>;
+    /** Fetch one dispute by the gateway's id. */
+    abstract getDispute(disputeId: string): Promise<Dispute>;
+    /**
+     * Every dispute the gateway knows about.
+     *
+     * 🛑 A gateway with no dispute concept returns `[]`, and that is the CORRECT
+     * documented answer rather than a silent degrade: "this provider cannot have
+     * chargebacks" is a true statement about manual bank transfers, not a
+     * swallowed failure. `audit-silent-degrade` draws that line, and the
+     * difference is that an empty array here is a fact while a `.catch(() => [])`
+     * would be a guess.
+     */
+    abstract listDisputes(): Promise<Dispute[]>;
+    /**
+     * Accept liability. **Irreversible** — the gateway debits us and the dispute
+     * is closed in the buyer's favour.
+     *
+     * `confirmIrrevocable` is a required literal `true`, so the call cannot be
+     * made by a caller who has not read what it does; a boolean parameter that
+     * could be `false` would be a flag, and this is a gate.
+     */
+    abstract acceptDispute(disputeId: string, confirmIrrevocable: true): Promise<Dispute>;
 }

package/dist/features/about/components/AboutView.js

@@ -2,5 +2,5 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Anchor, Avatar, Badge, Card, Div, Heading, Row, Section, Span, Stack, Text, TextLink } from "../../../ui/index.js";
 import { ROUTES } from "../../../constants/index.js";
 export function AboutView({ labels = {}, howItems = [], valueItems = [], milestones = [], teamMembers = [], ctaBannerClass = "", renderCtaButtons, }) {
-    return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(Section, { color: "inverse", tone: "accent-banner", padding: "y-4xl", children: _jsxs(Div, { paddingX: "x-page", className: "max-w-4xl mx-auto text-center", children: [_jsx(Heading, { color: "inverse", level: 1, variant: "none", className: "mb-6", mdSize: "5xl", size: "4xl", weight: "bold", children: labels.title }), _jsx(Text, { color: "inverse", variant: "none", className: "/80 max-w-2xl mx-auto", size: "xl", children: labels.subtitle })] }) }), _jsxs(Div, { paddingX: "x-page", className: "max-w-5xl mx-auto", padding: "y-4xl", children: [_jsxs(Section, { className: "text-center max-w-3xl mx-auto", children: [_jsx(Heading, { level: 2, className: "mb-4", children: labels.missionTitle }), _jsx(Text, { size: "lg", variant: "secondary", className: "leading-relaxed", children: labels.missionText })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-12", align: "center", children: labels.howItWorksTitle }), _jsx(Div, { className: "grid md:grid-cols-3", gap: "6", children: howItems.map(({ title, text, icon, tone }) => (_jsxs(Card, { variant: `gradient-${tone ?? "indigo"}`, padding: "md", spacing: "sm", children: [_jsx(Div, { children: _jsx(Span, { size: "4xl", children: icon }) }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: labels.valuesSubtitle ? "mb-3" : "mb-12", align: "center", children: labels.valuesTitle }), labels.valuesSubtitle && (_jsx(Text, { size: "base", variant: "secondary", align: "center", className: "mb-12 max-w-2xl mx-auto leading-relaxed", children: labels.valuesSubtitle })), _jsx(Div, { className: "grid md:grid-cols-3", gap: "5", children: valueItems.map(({ title, text, icon, detail }) => (_jsxs(Stack, { gap: "3", surface: "default", padding: "lg", rounded: "xl", border: "default", children: [_jsx(Div, { children: _jsx(Span, { size: "3xl", children: icon }) }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text }), detail && (_jsx(Text, { size: "sm", color: "muted", className: "leading-relaxed", children: detail }))] }, title))) }), labels.valuesLinkLabel && (_jsx(Div, { className: "mt-8 text-center", children: _jsx(TextLink, { href: String(ROUTES.PUBLIC.ETHICS), size: "sm", children: labels.valuesLinkLabel }) }))] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-10", align: "center", children: labels.milestonesTitle }), _jsx(Stack, { className: "relative border-l-2 border-primary/30 max-w-2xl mx-auto pl-[2rem]", gap: "xl", children: milestones.map(({ year, text }) => (_jsxs(Div, { className: "relative", children: [_jsx(Div, { className: "absolute -left-10 top-1 w-4 h-4 bg-primary border-2 border-white", rounded: "full" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] }), teamMembers.length > 0 && (_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-2", align: "center", children: labels.teamTitle }), labels.teamSubtitle && (_jsx(Text, { size: "lg", variant: "secondary", align: "center", className: "mb-12 max-w-2xl mx-auto", children: labels.teamSubtitle })), _jsx(Div, { className: "grid md:grid-cols-3", gap: "6", children: teamMembers.map((member) => (_jsxs(Stack, { gap: "3", surface: "default", padding: "lg", rounded: "xl", border: "default", align: "center", className: "text-center", children: [_jsx(Avatar, { src: member.photoUrl, name: member.name, alt: member.name, size: "lg" }), _jsx(Heading, { level: 3, children: member.name }), _jsxs(Row, { gap: "xs", wrap: true, justify: "center", children: [_jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: member.role }), member.isFounder && _jsx(Badge, { variant: "primary", size: "xs", children: "Founder" }), member.isDeveloper && _jsx(Badge, { variant: "secondary", size: "xs", children: "Developer" })] }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: member.bio }), member.githubUrl && (_jsx(Anchor, { href: member.githubUrl, tone: "muted", size: "sm", underline: "hover", children: "GitHub \u2197" }))] }, member.name))) })] })), _jsxs(Section, { color: "inverse", tone: "accent-banner", className: `text-center ${ctaBannerClass}`, padding: "xl", rounded: "2xl", children: [_jsx(Heading, { color: "inverse", level: 2, variant: "none", className: "mb-8", size: "3xl", weight: "bold", children: labels.ctaTitle }), renderCtaButtons ? (renderCtaButtons()) : (_jsx(Row, { justify: "center", gap: "3", wrap: true, children: _jsxs(Span, { color: "inverse", size: "sm", className: "/70", children: [labels.ctaSell, " \u00B7 ", labels.ctaShop] }) }))] })] })] }));
+    return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(Section, { color: "inverse", tone: "accent-banner", padding: "y-4xl", children: _jsxs(Div, { paddingX: "x-page", className: "max-w-4xl mx-auto text-center", children: [_jsx(Heading, { color: "inverse", level: 1, variant: "none", className: "mb-6", mdSize: "5xl", size: "4xl", weight: "bold", children: labels.title }), _jsx(Text, { color: "inverse-muted", variant: "none", className: "max-w-2xl mx-auto", size: "xl", children: labels.subtitle })] }) }), _jsxs(Div, { paddingX: "x-page", className: "max-w-5xl mx-auto", padding: "y-4xl", children: [_jsxs(Section, { className: "text-center max-w-3xl mx-auto", children: [_jsx(Heading, { level: 2, className: "mb-4", children: labels.missionTitle }), _jsx(Text, { size: "lg", variant: "secondary", className: "leading-relaxed", children: labels.missionText })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-12", align: "center", children: labels.howItWorksTitle }), _jsx(Div, { className: "grid md:grid-cols-3", gap: "6", children: howItems.map(({ title, text, icon, tone }) => (_jsxs(Card, { variant: `gradient-${tone ?? "indigo"}`, padding: "md", spacing: "sm", children: [_jsx(Div, { children: _jsx(Span, { size: "4xl", children: icon }) }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: labels.valuesSubtitle ? "mb-3" : "mb-12", align: "center", children: labels.valuesTitle }), labels.valuesSubtitle && (_jsx(Text, { size: "base", variant: "secondary", align: "center", className: "mb-12 max-w-2xl mx-auto leading-relaxed", children: labels.valuesSubtitle })), _jsx(Div, { className: "grid md:grid-cols-3", gap: "5", children: valueItems.map(({ title, text, icon, detail }) => (_jsxs(Stack, { gap: "3", surface: "default", padding: "lg", rounded: "xl", border: "default", children: [_jsx(Div, { children: _jsx(Span, { size: "3xl", children: icon }) }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text }), detail && (_jsx(Text, { size: "sm", color: "muted", className: "leading-relaxed", children: detail }))] }, title))) }), labels.valuesLinkLabel && (_jsx(Div, { className: "mt-8 text-center", children: _jsx(TextLink, { href: String(ROUTES.PUBLIC.ETHICS), size: "sm", children: labels.valuesLinkLabel }) }))] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-10", align: "center", children: labels.milestonesTitle }), _jsx(Stack, { className: "relative border-l-2 border-primary/30 max-w-2xl mx-auto pl-[2rem]", gap: "xl", children: milestones.map(({ year, text }) => (_jsxs(Div, { className: "relative", children: [_jsx(Div, { className: "absolute -left-10 top-1 w-4 h-4 bg-primary border-2 border-white", rounded: "full" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] }), teamMembers.length > 0 && (_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-2", align: "center", children: labels.teamTitle }), labels.teamSubtitle && (_jsx(Text, { size: "lg", variant: "secondary", align: "center", className: "mb-12 max-w-2xl mx-auto", children: labels.teamSubtitle })), _jsx(Div, { className: "grid md:grid-cols-3", gap: "6", children: teamMembers.map((member) => (_jsxs(Stack, { gap: "3", surface: "default", padding: "lg", rounded: "xl", border: "default", align: "center", className: "text-center", children: [_jsx(Avatar, { src: member.photoUrl, name: member.name, alt: member.name, size: "lg" }), _jsx(Heading, { level: 3, children: member.name }), _jsxs(Row, { gap: "xs", wrap: true, justify: "center", children: [_jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: member.role }), member.isFounder && _jsx(Badge, { variant: "primary", size: "xs", children: "Founder" }), member.isDeveloper && _jsx(Badge, { variant: "secondary", size: "xs", children: "Developer" })] }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: member.bio }), member.githubUrl && (_jsx(Anchor, { href: member.githubUrl, tone: "muted", size: "sm", underline: "hover", children: "GitHub \u2197" }))] }, member.name))) })] })), _jsxs(Section, { color: "inverse", tone: "accent-banner", className: `text-center ${ctaBannerClass}`, padding: "xl", rounded: "2xl", children: [_jsx(Heading, { color: "inverse", level: 2, variant: "none", className: "mb-8", size: "3xl", weight: "bold", children: labels.ctaTitle }), renderCtaButtons ? (renderCtaButtons()) : (_jsx(Row, { justify: "center", gap: "3", wrap: true, children: _jsxs(Span, { color: "inverse-muted", size: "sm", children: [labels.ctaSell, " \u00B7 ", labels.ctaShop] }) }))] })] })] }));
 }

package/dist/features/about/components/DeveloperView.js

@@ -1,7 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize.js";
 import { serverLogger } from "../../../monitoring/server-logger.js";
-import { Anchor, Avatar, Badge, Div, Heading, Row, Section, Span, Stack, Text, TextLink } from "../../../ui/index.js";
+import { ProseHero } from "./ProseHero.js";
+// `Section` dropped — `ProseHero` owns the banner now and this view had no
+// other use for it.
+import { Anchor, Avatar, Badge, Div, Heading, Row, Span, Stack, Text, TextLink } from "../../../ui/index.js";
 import { ROUTES } from "../../../constants/index.js";
 import { PAGE_CONTAINER } from "../../../_internal/shared/styles/page.js";
 import { siteSettingsRepository } from "../../../repositories/index.js";
@@ -30,5 +33,5 @@ export async function DeveloperView({ labels = {} }) {
         });
     }
     const developers = teamMembers.filter((m) => m.isDeveloper);
-    return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(Section, { color: "inverse", tone: "accent-banner", padding: "banner", children: _jsxs(Div, { className: `${page.container.sm}`, children: [_jsx(Heading, { color: "inverse", level: 1, variant: "none", className: "mb-3", children: labels.title ?? "Meet the Developer" }), _jsx(Text, { color: "inverse", variant: "none", className: "/80", size: "sm", children: labels.subtitle ?? "The person building LetItRip, one feature at a time." })] }) }), _jsxs(Div, { className: `${page.container.sm}`, padding: "content-banner", children: [developers.length === 0 ? (_jsx(Text, { variant: "secondary", children: labels.empty ?? "Developer profile coming soon." })) : (_jsx(Stack, { gap: "xl", children: developers.map((dev) => (_jsxs(Stack, { gap: "md", surface: "default", padding: "lg", rounded: "xl", border: "default", children: [_jsxs(Row, { gap: "md", align: "center", children: [_jsx(Avatar, { src: dev.photoUrl, name: dev.name, alt: dev.name, size: "lg" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, children: dev.name }), _jsxs(Row, { gap: "xs", wrap: true, children: [_jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: dev.role }), dev.isFounder && _jsx(Badge, { variant: "primary", size: "xs", children: "Founder" }), _jsx(Badge, { variant: "secondary", size: "xs", children: "Developer" })] })] })] }), _jsx(Text, { variant: "secondary", className: "leading-relaxed", children: dev.bio }), dev.githubUrl && (_jsx(Anchor, { href: dev.githubUrl, tone: "brand", size: "sm", underline: "hover", children: "GitHub \u2197" }))] }, dev.name))) })), milestones.length > 0 && (_jsxs(Div, { className: "mt-14 border-t", border: "default", padding: "t-xl", children: [_jsx(Heading, { level: 3, className: "mb-6", color: "muted", size: "sm", weight: "semibold", transform: "uppercase", children: labels.journeyTitle ?? "The Journey" }), _jsx(Stack, { className: "relative border-l-2 border-primary/30 max-w-2xl pl-[2rem]", gap: "lg", children: milestones.map(({ year, text }) => (_jsxs(Div, { className: "relative", children: [_jsx(Div, { className: "absolute -left-10 top-1 w-4 h-4 bg-primary border-2 border-white", rounded: "full" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] })), _jsx(Div, { className: "mt-10", children: _jsx(TextLink, { href: String(ROUTES.PUBLIC.ABOUT), variant: "muted", size: "sm", children: labels.backToTeam ?? "← Meet the whole team" }) })] })] }));
+    return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(ProseHero, { width: "sm", centered: false, subtitleSize: "sm", title: labels.title ?? "Meet the Developer", subtitle: labels.subtitle ?? "The person building LetItRip, one feature at a time." }), _jsxs(Div, { className: `${page.container.sm}`, padding: "content-banner", children: [developers.length === 0 ? (_jsx(Text, { variant: "secondary", children: labels.empty ?? "Developer profile coming soon." })) : (_jsx(Stack, { gap: "xl", children: developers.map((dev) => (_jsxs(Stack, { gap: "md", surface: "default", padding: "lg", rounded: "xl", border: "default", children: [_jsxs(Row, { gap: "md", align: "center", children: [_jsx(Avatar, { src: dev.photoUrl, name: dev.name, alt: dev.name, size: "lg" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, children: dev.name }), _jsxs(Row, { gap: "xs", wrap: true, children: [_jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: dev.role }), dev.isFounder && _jsx(Badge, { variant: "primary", size: "xs", children: "Founder" }), _jsx(Badge, { variant: "secondary", size: "xs", children: "Developer" })] })] })] }), _jsx(Text, { variant: "secondary", className: "leading-relaxed", children: dev.bio }), dev.githubUrl && (_jsx(Anchor, { href: dev.githubUrl, tone: "brand", size: "sm", underline: "hover", children: "GitHub \u2197" }))] }, dev.name))) })), milestones.length > 0 && (_jsxs(Div, { className: "mt-14 border-t", border: "default", padding: "t-xl", children: [_jsx(Heading, { level: 3, className: "mb-6", color: "muted", size: "sm", weight: "semibold", transform: "uppercase", children: labels.journeyTitle ?? "The Journey" }), _jsx(Stack, { className: "relative border-l-2 border-primary/30 max-w-2xl pl-[2rem]", gap: "lg", children: milestones.map(({ year, text }) => (_jsxs(Div, { className: "relative", children: [_jsx(Div, { className: "absolute -left-10 top-1 w-4 h-4 bg-primary border-2 border-white", rounded: "full" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] })), _jsx(Div, { className: "mt-10", children: _jsx(TextLink, { href: String(ROUTES.PUBLIC.ABOUT), variant: "muted", size: "sm", children: labels.backToTeam ?? "← Meet the whole team" }) })] })] }));
 }