@mohasinac/appkit 3.1.7 → 3.2.1

package/dist/_internal/client/features/layout/DashboardLayoutClient.js

@@ -34,36 +34,65 @@ import { Div } from "../../../../ui";
  * Hoisted drawer-state hook — the matchMedia-aware open/close logic that was
  * triplicated across admin/store/user layouts. Used internally by
  * DashboardLayoutClient; not exported because it's not generically useful.
+ *
+ * storageKey: variant-scoped localStorage key (`appkit:sidebar-open:{variant}`)
+ * so admin/store/user each persist their own collapse state independently.
  */
-function useResponsiveDrawer() {
+function useResponsiveDrawer(storageKey) {
     const [desktopOpen, setDesktopOpen] = useState(false);
     const [mobileOpen, setMobileOpen] = useState(false);
     const { registerNav, unregisterNav } = useDashboardNav();
     const isDesktop = useCallback(() => typeof window !== "undefined" && window.matchMedia(DASHBOARD_DESKTOP_MEDIA_QUERY).matches, []);
+    // Restore persisted desktop-open state after hydration (avoids SSR mismatch).
+    useEffect(() => {
+        try {
+            if (localStorage.getItem(storageKey) === "true")
+                setDesktopOpen(true);
+        }
+        catch { /* localStorage unavailable (private-browse / SSR fallback) */ }
+    }, [storageKey]);
     const open = useCallback(() => {
         startTransition(() => {
-            if (isDesktop())
+            if (isDesktop()) {
+                try {
+                    localStorage.setItem(storageKey, "true");
+                }
+                catch { /* noop */ }
                 setDesktopOpen(true);
+            }
             else
                 setMobileOpen(true);
         });
-    }, [isDesktop]);
+    }, [isDesktop, storageKey]);
     const close = useCallback(() => {
         startTransition(() => {
-            if (isDesktop())
+            if (isDesktop()) {
+                try {
+                    localStorage.setItem(storageKey, "false");
+                }
+                catch { /* noop */ }
                 setDesktopOpen(false);
+            }
             else
                 setMobileOpen(false);
         });
-    }, [isDesktop]);
+    }, [isDesktop, storageKey]);
     const toggle = useCallback(() => {
         startTransition(() => {
-            if (isDesktop())
-                setDesktopOpen((prev) => !prev);
+            if (isDesktop()) {
+                setDesktopOpen((prev) => {
+                    const next = !prev;
+                    try {
+                        localStorage.setItem(storageKey, String(next));
+                    }
+                    catch { /* noop */ }
+                    return next;
+                });
+            }
             else
                 setMobileOpen((prev) => !prev);
         });
-    }, [isDesktop]);
+    }, [isDesktop, storageKey]);
     useEffect(() => {
         registerNav({ open, close, toggle });
         return () => unregisterNav();
@@ -87,7 +116,8 @@ const DEFAULT_CONTENT_MAX_WIDTH = "max-w-screen-2xl";
 export function DashboardLayoutClient({ variant, groups, permissions, activeHref: explicitActiveHref, responsive: _responsive, className, contentPadding, contentSurface, contentMaxWidth, children, }) {
     const pathname = usePathname();
     const activeHref = explicitActiveHref ?? pathname ?? "";
-    const { desktopOpen, mobileOpen, close, toggle } = useResponsiveDrawer();
+    const storageKey = `appkit:sidebar-open:${variant}`;
+    const { desktopOpen, mobileOpen, close, toggle } = useResponsiveDrawer(storageKey);
     const { data: settings } = useSiteSettings();
     const navConfig = settings?.navConfig;
     const filteredGroups = filterGroups(groups, navConfig, permissions);

package/dist/_internal/client/features/tour/TourProvider.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+export interface TourContextValue {
+    startTour: () => void;
+}
+export declare function useTour(): TourContextValue;
+/**
+ * TourProvider — skeleton shell for Patch 1.
+ * driver.js steps are wired in Patch 2+; this provider is an identity wrapper.
+ */
+export declare function TourProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/_internal/client/features/tour/TourProvider.js

@@ -0,0 +1,19 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+const TourContext = React.createContext({
+    startTour: () => { },
+});
+export function useTour() {
+    return React.useContext(TourContext);
+}
+/**
+ * TourProvider — skeleton shell for Patch 1.
+ * driver.js steps are wired in Patch 2+; this provider is an identity wrapper.
+ */
+export function TourProvider({ children }) {
+    const startTour = React.useCallback(() => {
+        // driver.js will be imported and configured here in Patch 2+.
+    }, []);
+    return (_jsx(TourContext.Provider, { value: { startTour }, children: children }));
+}

package/dist/_internal/server/features/checkout/actions.js

@@ -232,12 +232,18 @@ export async function createCheckoutOrderAction(input) {
     const { userId: uid, userName, userEmail, addressId, paymentMethod, notes, excludedProductIds = [], adminBypass = false, adminBypassBy, } = input;
     const siteSettings = await siteSettingsRepository.getSingleton();
     const commissions = siteSettings?.commissions ?? CHECKOUT_DEFAULT_COMMISSIONS;
-    // W1-43 — enforce COD toggle. Admin bypass + non-COD payments still flow through.
+    // W1-43 — enforce COD toggle.
     if (!adminBypass &&
         paymentMethod === "cod" &&
         siteSettings?.payment?.codEnabled === false) {
         throw new ValidationError("Cash on Delivery is not currently accepted. Please choose another payment method.");
     }
+    // P-1 — enforce UPI/cash manual payment toggle.
+    if (!adminBypass &&
+        (paymentMethod === "upi_manual" || paymentMethod === "cash") &&
+        siteSettings?.payment?.upiManualEnabled === false) {
+        throw new ValidationError("Manual UPI / cash payment is not currently accepted. Please choose another payment method.");
+    }
     const cart = await unitOfWork.carts.getOrCreate(uid);
     if (!cart.items || cart.items.length === 0) {
         throw new ValidationError(ERROR_MESSAGES.CHECKOUT.CART_EMPTY);
@@ -470,7 +476,7 @@ export async function createCheckoutOrderAction(input) {
         });
         const totalQuantity = group.reduce((sum, { item }) => sum + item.quantity, 0);
         const { shippingFee, storeOwnerId } = await resolveShippingCost(firstItem.storeId, groupTotal, commissions);
-        const isCodLike = paymentMethod === "cod" || paymentMethod === "upi_manual";
+        const isCodLike = paymentMethod === "cod" || paymentMethod === "upi_manual" || paymentMethod === "cash";
         const depositAmount = isCodLike
             ? Math.round(groupTotal * (commissions.codDepositPercent / 100) * 100) / 100
             : undefined;

package/dist/_internal/server/features/media/contextGuards.js

@@ -45,7 +45,7 @@ export const CONTEXT_LIMITS = {
     RICH_TEXT_IMAGE_MAX: 20,
 };
 // Contexts that accept both image and PDF (proof documents).
-const IMAGE_OR_PDF_CONTEXTS = ["shipping-proof", "refund-proof"];
+const IMAGE_OR_PDF_CONTEXTS = ["shipping-proof", "refund-proof", "payment-proof"];
 const PDF_ONLY_CONTEXTS = ["invoice", "payout-doc"];
 const IMAGE_ONLY_CONTEXT_TYPES = new Set([
     "store-logo",
@@ -215,7 +215,7 @@ export function applyMediaContextGuards({ detectedMime, context: ctx, }) {
         return {
             ok: false,
             status: 400,
-            error: "PDF uploads are only allowed for invoice, payout-doc, shipping-proof, or refund-proof contexts",
+            error: "PDF uploads are only allowed for invoice, payout-doc, shipping-proof, refund-proof, or payment-proof contexts",
             details: { context: ctx.type, detected: detectedMime },
         };
     }

package/dist/_internal/server/features/orders/actions.d.ts

@@ -3,3 +3,9 @@ export declare function createOrderAction(input: unknown): Promise<ActionResult<
 export declare function cancelOrderAction(input: unknown): Promise<ActionResult<unknown>>;
 export declare function requestReturnAction(input: unknown): Promise<ActionResult<unknown>>;
 export declare function updateOrderStatusAction(input: unknown): Promise<ActionResult<unknown>>;
+export declare function attachPaymentProofAction(orderId: string, proof: {
+    proofUrl: string;
+    transactionId?: string;
+    mimeType?: string;
+}): Promise<ActionResult<void>>;
+export declare function adminVerifyPaymentAction(orderId: string): Promise<ActionResult<void>>;

package/dist/_internal/server/features/orders/actions.js

@@ -6,7 +6,7 @@ import { createOrderSchema, updateOrderStatusSchema, cancelOrderSchema, } from "
 import { assertOrderCancellable, assertReturnWindowOpen } from "./service";
 import { ValidationError } from "../../../shared/errors/index";
 import { OrderNotFoundError, OrderOwnershipError } from "../../../shared/features/orders/errors";
-import { isAdminUser } from "../../../../features/auth/role-predicates";
+import { isAdminUser, isModeratorUser } from "../../../../features/auth/role-predicates";
 export async function createOrderAction(input) {
     return wrapAction(async () => {
         const user = await requireRoleUser(["buyer", "seller", "admin"]);
@@ -58,3 +58,45 @@ export async function updateOrderStatusAction(input) {
         });
     });
 }
+// ── P-1 Manual payment proof ─────────────────────────────────────────────────
+export async function attachPaymentProofAction(orderId, proof) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["buyer", "seller", "admin"]);
+        const order = await orderRepository.findById(orderId).catch(() => null);
+        if (!order)
+            throw new OrderNotFoundError(orderId);
+        if (!isAdminUser(user) && order.userId !== user.uid)
+            throw new OrderOwnershipError(orderId);
+        const pm = order.paymentMethod ?? "";
+        if (pm !== "cash" && pm !== "upi_manual") {
+            throw new ValidationError("Payment proof can only be attached to cash or UPI orders");
+        }
+        if (order.paymentProofUrl) {
+            throw new ValidationError("PROOF_ALREADY_ATTACHED");
+        }
+        await orderRepository.update(orderId, {
+            paymentProofUrl: proof.proofUrl,
+            paymentTransactionId: proof.transactionId,
+            paymentProofMimeType: proof.mimeType,
+            paymentProofUploadedAt: new Date(),
+        });
+    });
+}
+export async function adminVerifyPaymentAction(orderId) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["admin", "moderator"]);
+        if (!isAdminUser(user) && !isModeratorUser(user)) {
+            throw new ValidationError("Only admin or moderator can verify payments");
+        }
+        const order = await orderRepository.findById(orderId).catch(() => null);
+        if (!order)
+            throw new OrderNotFoundError(orderId);
+        if (order.paymentStatus === "paid")
+            return; // idempotent
+        await orderRepository.update(orderId, {
+            paymentStatus: "paid",
+            paymentId: order.paymentTransactionId ?? order.paymentId ?? `manual-${orderId}`,
+            status: "processing",
+        });
+    });
+}

package/dist/_internal/server/features/products/data.js

@@ -11,7 +11,11 @@ import { PRODUCT_FIELDS } from "../../../../constants/field-names";
 // ---------------------------------------------------------------------------
 /** Fetch a single product by slug or id, deduped per request. */
 export const getProductForDetail = cache(async (slugOrId) => {
-    return (await productRepository.findByIdOrSlug(slugOrId).catch(() => undefined)) ?? null;
+    const product = (await productRepository.findByIdOrSlug(slugOrId).catch(() => undefined)) ?? null;
+    // Fire-and-forget viewCount increment — must not affect response time
+    if (product)
+        void productRepository.incrementViewCount(product.id);
+    return product;
 });
 /** Fetch the first page of approved reviews for a product, deduped per request. */
 export const getReviewsForProduct = cache(async (productId) => {

package/dist/_internal/server/jobs/core/assignSpinPrize.js

@@ -8,6 +8,10 @@ const EVENTS_COLLECTION = "events";
 const EVENT_ENTRIES_COLLECTION = "eventEntries";
 const COUPONS_COLLECTION = "coupons";
 export async function runAssignSpinPrize(input, ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping spin prize assignment");
+        return { eventId: input.eventId, userId: input.userId, reason: "feature_disabled" };
+    }
     const { eventId, userId } = input;
     const eventSnap = await ctx.db.collection(EVENTS_COLLECTION).doc(eventId).get();
     if (!eventSnap.exists) {

package/dist/_internal/server/jobs/core/auctionSettlement.js

@@ -57,6 +57,10 @@ async function settleAuction(ctx, product) {
     });
 }
 export async function runAuctionSettlement(ctx) {
+    if (ctx.env("FEATURE_AUCTIONS") !== "true") {
+        ctx.logger.info("FEATURE_AUCTIONS disabled — skipping auction settlement");
+        return;
+    }
     ctx.logger.info("Starting auction settlement sweep");
     const expired = await productRepository.getExpiredAuctions(ctx.now);
     if (expired.length === 0) {

package/dist/_internal/server/jobs/core/autoPayoutEligibility.js

@@ -13,6 +13,10 @@ function getBusinessDayCutoff(daysAgo) {
     return cutoff;
 }
 export async function runAutoPayoutEligibility(ctx) {
+    if (ctx.env("FEATURE_PAYOUTS") !== "true") {
+        ctx.logger.info("FEATURE_PAYOUTS disabled — skipping auto-payout eligibility");
+        return;
+    }
     ctx.logger.info("Starting daily auto-payout eligibility sweep", {
         windowDays: AUTO_PAYOUT_WINDOW_DAYS,
     });

package/dist/_internal/server/jobs/core/bundleStockSync.js

@@ -36,6 +36,10 @@ async function computeBundleStockStatus(productIds, ctx) {
     return "in_stock";
 }
 export async function runBundleStockSync(ctx) {
+    if (ctx.env("FEATURE_BUNDLES") !== "true") {
+        ctx.logger.info("FEATURE_BUNDLES disabled — skipping bundle stock sync");
+        return;
+    }
     ctx.logger.info("Bundle stock sync starting (SB-UNI-V categories)");
     const snap = await ctx.db
         .collection(CATEGORIES_COLLECTION)

package/dist/_internal/server/jobs/core/payoutBatch.js

@@ -87,6 +87,10 @@ async function dispatch(ctx, entry) {
     }
 }
 export async function runPayoutBatch(ctx) {
+    if (ctx.env("FEATURE_PAYOUTS") !== "true") {
+        ctx.logger.info("FEATURE_PAYOUTS disabled — skipping payout batch");
+        return;
+    }
     ctx.logger.info("Starting payout batch sweep");
     const pending = await payoutRepository.getPending();
     if (pending.length === 0) {

package/dist/_internal/server/jobs/core/prizeRevealClose.js

@@ -2,6 +2,10 @@ import { PRODUCT_FIELDS, COMMON_FIELDS } from "../../../../constants/field-names
 const PRODUCT_COLLECTION = "products";
 const PRIZE_DRAW_LISTING_TYPE = "prize-draw";
 export async function runPrizeRevealClose(ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping prize reveal close");
+        return;
+    }
     ctx.logger.info("Prize reveal close sweep starting");
     const snap = await ctx.db
         .collection(PRODUCT_COLLECTION)

package/dist/_internal/server/jobs/core/prizeRevealExpiry.js

@@ -3,6 +3,10 @@ import { sendNotification } from "../../../../features/admin/actions/notificatio
 import { ORDER_FIELDS, PRODUCT_FIELDS, COMMON_FIELDS } from "../../../../constants/field-names";
 const ORDER_COLLECTION = "orders";
 export async function runPrizeRevealExpiry(ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping prize reveal expiry");
+        return;
+    }
     ctx.logger.info("Prize reveal expiry sweep starting");
     const snap = await ctx.db
         .collection(ORDER_COLLECTION)

package/dist/_internal/server/jobs/core/prizeRevealOpen.js

@@ -5,6 +5,10 @@ const PRODUCT_COLLECTION = "products";
 const ORDER_COLLECTION = "orders";
 const PRIZE_DRAW_LISTING_TYPE = "prize-draw";
 export async function runPrizeRevealOpen(ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping prize reveal open");
+        return;
+    }
     ctx.logger.info("Prize reveal open sweep starting");
     const snap = await ctx.db
         .collection(PRODUCT_COLLECTION)

package/dist/_internal/server/jobs/core/prizeRevealReminder.js

@@ -4,6 +4,10 @@ import { ORDER_FIELDS, PRODUCT_FIELDS } from "../../../../constants/field-names"
 const ORDER_COLLECTION = "orders";
 const ONE_DAY_MS = 86400000;
 export async function runPrizeRevealReminder(ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping prize reveal reminder");
+        return;
+    }
     ctx.logger.info("Prize reveal reminder sweep starting");
     const cutoff = new Date(ctx.now.getTime() + ONE_DAY_MS);
     const snap = await ctx.db

package/dist/_internal/server/jobs/core/promotions.js

@@ -6,6 +6,10 @@ import { ProductStatusValues } from "../../../../features/products/schemas/fires
  * (coupon.startDate IS NULL OR <= now) filter Firestore can't express.
  */
 export async function runPromotions(_input, ctx) {
+    if (ctx.env("FEATURE_EVENTS") !== "true") {
+        ctx.logger.info("FEATURE_EVENTS disabled — skipping promotions");
+        return { promotedProducts: [], featuredProducts: [], activeCoupons: [] };
+    }
     ctx.logger.info("Promotions data requested");
     const now = new Date();
     const nowIso = now.toISOString();

package/dist/_internal/server/jobs/core/triggerEventRaffle.js

@@ -7,6 +7,10 @@ import { EVENT_ENTRY_FIELDS } from "../../../../constants/field-names";
 const EVENTS_COLLECTION = "events";
 const EVENT_ENTRIES_COLLECTION = "eventEntries";
 export async function runTriggerEventRaffle(input, ctx) {
+    if (ctx.env("FEATURE_PRIZE_DRAWS") !== "true") {
+        ctx.logger.info("FEATURE_PRIZE_DRAWS disabled — skipping event raffle");
+        return { eventId: input.eventId, raffleEntryCount: 0 };
+    }
     const eventRef = ctx.db.collection(EVENTS_COLLECTION).doc(input.eventId);
     const eventSnap = await eventRef.get();
     if (!eventSnap.exists) {

package/dist/_internal/server/jobs/core/weeklyPayoutEligibility.js

@@ -7,6 +7,10 @@ import { BATCH_LIMIT } from "../handlers/messages";
 import { getDefaultCurrency } from "../../../../core";
 const PLATFORM_COMMISSION_RATE = 0.05;
 export async function runWeeklyPayoutEligibility(ctx) {
+    if (ctx.env("FEATURE_PAYOUTS") !== "true") {
+        ctx.logger.info("FEATURE_PAYOUTS disabled — skipping weekly payout eligibility");
+        return;
+    }
     ctx.logger.info("Starting weekly payout eligibility sweep");
     const eligible = await orderRepository.getEligibleShiprocket();
     if (eligible.length === 0) {

package/dist/_internal/shared/actions/action-registry.js

@@ -835,6 +835,19 @@ export const ACTIONS = {
             kind: "secondary",
             permissions: ["admin"],
         },
+        "verify-payment": {
+            id: "admin.verify-payment",
+            label: "Verify Payment",
+            ariaLabel: "Mark payment as received and verified",
+            description: "Confirms manual cash/UPI payment was received. Moves order to Processing.",
+            kind: "primary",
+            permissions: ["admin", "moderator"],
+            confirmation: {
+                title: "Verify payment?",
+                body: "This marks the payment as received. The order will move to Processing. This action cannot be undone.",
+                confirmLabel: "Yes, verify",
+            },
+        },
         "verify-vendor": {
             id: "admin.verify-vendor",
             label: "Verify vendor",

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

@@ -4,5 +4,5 @@ export declare const CHECKOUT_DEFAULT_COMMISSIONS: {
     readonly platformShippingPercent: 10;
     readonly platformShippingFixedMin: 50;
 };
-export declare const CHECKOUT_PAYMENT_METHODS: readonly ["cod", "online", "upi_manual", "admin_bypass"];
+export declare const CHECKOUT_PAYMENT_METHODS: readonly ["cash", "cod", "online", "upi_manual", "admin_bypass"];
 export type CheckoutPaymentMethod = (typeof CHECKOUT_PAYMENT_METHODS)[number];

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

@@ -4,4 +4,4 @@ export const CHECKOUT_DEFAULT_COMMISSIONS = {
     platformShippingPercent: 10,
     platformShippingFixedMin: 50,
 };
-export const CHECKOUT_PAYMENT_METHODS = ["cod", "online", "upi_manual", "admin_bypass"];
+export const CHECKOUT_PAYMENT_METHODS = ["cash", "cod", "online", "upi_manual", "admin_bypass"];

package/dist/features/admin/components/AdminOrderEditorView.d.ts

@@ -4,5 +4,9 @@ export interface AdminOrderEditorViewProps {
     orderId?: string;
     orderLabel?: string;
     currentStatus?: string;
+    paymentProofUrl?: string;
+    paymentTransactionId?: string;
+    paymentMethod?: string;
+    paymentStatus?: string;
 }
-export declare function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, }: AdminOrderEditorViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, paymentProofUrl, paymentTransactionId, paymentMethod, paymentStatus, }: AdminOrderEditorViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminOrderEditorView.js

@@ -1,11 +1,14 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useApiMutation } from "@mohasinac/appkit/client";
-import React from "react";
+import React, { useState } from "react";
+import { normalizeError } from "../../../errors/normalize";
 import { useQueryClient } from "@tanstack/react-query";
-import { Button, Form, FormActions, Input, Label, Select, SideDrawer, Stack, useToast } from "../../../ui";
+import { Button, Div, Form, FormActions, Input, Label, Select, SideDrawer, Stack, Text, useToast } from "../../../ui";
+import { MediaImage } from "../../media";
 import { apiClient } from "../../../http";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 const STATUS_OPTIONS = [
     { label: "Pending", value: "pending" },
     { label: "Processing", value: "processing" },
@@ -25,7 +28,7 @@ const CARRIER_OPTIONS = [
     { label: "Other", value: "Other" },
 ];
 // --- Component ---------------------------------------------------------------
-export function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, }) {
+export function AdminOrderEditorView({ open, onClose, orderId, orderLabel, currentStatus, paymentProofUrl, paymentTransactionId, paymentMethod, paymentStatus, }) {
     const queryClient = useQueryClient();
     const { showToast } = useToast();
     const [status, setStatus] = React.useState(currentStatus ?? "pending");
@@ -33,6 +36,9 @@ export function AdminOrderEditorView({ open, onClose, orderId, orderLabel, curre
     const [carrier, setCarrier] = React.useState("");
     const [notes, setNotes] = React.useState("");
     const [refundAmount, setRefundAmount] = React.useState("");
+    const [isVerifyingPayment, setIsVerifyingPayment] = useState(false);
+    const isCashOrUpi = paymentMethod === "cash" || paymentMethod === "upi_manual";
+    const needsVerification = isCashOrUpi && paymentStatus === "pending";
     React.useEffect(() => {
         if (open) {
             setStatus(currentStatus ?? "pending");
@@ -68,8 +74,28 @@ export function AdminOrderEditorView({ open, onClose, orderId, orderLabel, curre
             showToast(err?.message ?? "Failed to update order.", "error");
         },
     });
+    const handleVerifyPayment = async () => {
+        if (!orderId)
+            return;
+        setIsVerifyingPayment(true);
+        try {
+            await apiClient.patch(`/api/admin/orders/${orderId}/payment-verify`, {});
+            showToast("Payment verified. Order moved to Processing.", "success");
+            queryClient.invalidateQueries({ queryKey: ["admin", "orders"] });
+            onClose();
+        }
+        catch (err) {
+            void normalizeError(err);
+            showToast(err?.message ?? "Failed to verify payment.", "error");
+        }
+        finally {
+            setIsVerifyingPayment(false);
+        }
+    };
     return (_jsx(SideDrawer, { isOpen: open, onClose: onClose, title: orderLabel ? `Order: ${orderLabel}` : "Update Order", children: _jsxs(Form, { onSubmit: (e) => {
                 e.preventDefault();
                 saveMutation.mutate();
-            }, spacing: "md", padding: "md", children: [_jsx(Select, { label: "Order status", options: STATUS_OPTIONS, value: status, onValueChange: setStatus }), _jsx(Input, { label: "Tracking number (optional)", value: trackingNumber, onChange: (e) => setTrackingNumber(e.target.value), placeholder: "e.g. DEL1234567890IN" }), _jsx(Select, { label: "Carrier (optional)", options: CARRIER_OPTIONS, value: carrier, onValueChange: setCarrier }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { size: "sm", weight: "medium", color: "primary", children: "Internal note (optional)" }), _jsx("textarea", { value: notes, onChange: (e) => setNotes(e.target.value), rows: 3, placeholder: "Reason for status change, escalation notes\u2026", className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500" })] }), (status === "refunded" || status === "return_requested") && (_jsx(Input, { label: "Refund amount \u20B9 (optional)", type: "number", min: "0", step: "0.01", value: refundAmount, onChange: (e) => setRefundAmount(e.target.value), placeholder: "e.g. 499.00" })), _jsxs(FormActions, { align: "right", children: [_jsx(Button, { type: "button", variant: "secondary", onClick: onClose, children: "Cancel" }), _jsx(Button, { type: "submit", isLoading: saveMutation.isPending, disabled: !orderId || saveMutation.isPending, children: "Save changes" })] })] }) }));
+            }, spacing: "md", padding: "md", children: [_jsx(Select, { label: "Order status", options: STATUS_OPTIONS, value: status, onValueChange: setStatus }), _jsx(Input, { label: "Tracking number (optional)", value: trackingNumber, onChange: (e) => setTrackingNumber(e.target.value), placeholder: "e.g. DEL1234567890IN" }), _jsx(Select, { label: "Carrier (optional)", options: CARRIER_OPTIONS, value: carrier, onValueChange: setCarrier }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { size: "sm", weight: "medium", color: "primary", children: "Internal note (optional)" }), _jsx("textarea", { value: notes, onChange: (e) => setNotes(e.target.value), rows: 3, placeholder: "Reason for status change, escalation notes\u2026", className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 bg-white dark:bg-zinc-800 px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 focus:outline-none focus:ring-2 focus:ring-primary-500" })] }), (status === "refunded" || status === "return_requested") && (_jsx(Input, { label: "Refund amount \u20B9 (optional)", type: "number", min: "0", step: "0.01", value: refundAmount, onChange: (e) => setRefundAmount(e.target.value), placeholder: "e.g. 499.00" })), isCashOrUpi && (_jsxs(Stack, { gap: "xs", children: [_jsx(Label, { size: "sm", weight: "medium", color: "primary", children: "Payment Proof" }), paymentProofUrl ? (_jsxs(Stack, { gap: "xs", children: [_jsx(MediaImage, { src: paymentProofUrl, alt: "Payment screenshot", size: "card", className: "rounded-lg border border-zinc-200 dark:border-zinc-700" }), paymentTransactionId && (_jsxs(Text, { size: "xs", color: "muted", children: ["UTR: ", _jsx(Text, { as: "span", size: "xs", weight: "medium", children: paymentTransactionId })] })), needsVerification && (_jsx(Button, { type: "button", action: ACTIONS.ADMIN["verify-payment"], onClick: handleVerifyPayment, isLoading: isVerifyingPayment, disabled: isVerifyingPayment, variant: "primary", className: "mt-1 w-full" })), !needsVerification && paymentStatus === "paid" && (
+                                // audit-variant-ok: themed success border color not in BORDER_MAP
+                                _jsx(Div, { rounded: "lg", padding: "inlineSm", className: "border border-success/20", surface: "success-surface", children: _jsx(Text, { size: "xs", className: "text-success", weight: "medium", children: "Payment verified" }) }))] })) : (_jsx(Text, { size: "xs", color: "faint", children: "No proof uploaded yet." }))] })), _jsxs(FormActions, { align: "right", children: [_jsx(Button, { type: "button", variant: "secondary", onClick: onClose, children: "Cancel" }), _jsx(Button, { type: "submit", isLoading: saveMutation.isPending, disabled: !orderId || saveMutation.isPending, children: "Save changes" })] })] }) }));
 }

package/dist/features/admin/components/AdminOrdersView.js

@@ -51,6 +51,10 @@ export function AdminOrdersView({ children, ...props }) {
             ].join(" · "),
             status: toStringValue(item.status, "Unknown"),
             updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
+            paymentProofUrl: toStringValue(item.paymentProofUrl, "") || undefined,
+            paymentTransactionId: toStringValue(item.paymentTransactionId, "") || undefined,
+            paymentMethod: toStringValue(item.paymentMethod, "") || undefined,
+            paymentStatus: toStringValue(item.paymentStatus, "") || undefined,
         })),
         getTotal: (response, mappedRows) => typeof response.meta?.total === "number" ? response.meta.total : mappedRows.length,
         buildFilters: (f) => (f.status && f.status !== "All" ? sieveFilter("status", SIEVE_OP.EQ, f.status) : undefined),
@@ -117,5 +121,5 @@ export function AdminOrdersView({ children, ...props }) {
             ] })),
         renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsx(FilterChipGroup, { label: "Status", tabs: ADMIN_ORDER_STATUS_TABS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) })),
     };
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminOrderEditorView, { open: drawerOpen, onClose: () => setDrawerOpen(false), orderId: selectedRow?.id, orderLabel: selectedRow?.primary, currentStatus: selectedRow?.status })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(AdminOrderEditorView, { open: drawerOpen, onClose: () => setDrawerOpen(false), orderId: selectedRow?.id, orderLabel: selectedRow?.primary, currentStatus: selectedRow?.status, paymentProofUrl: selectedRow?.paymentProofUrl, paymentTransactionId: selectedRow?.paymentTransactionId, paymentMethod: selectedRow?.paymentMethod, paymentStatus: selectedRow?.paymentStatus })] }));
 }

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

@@ -88,6 +88,8 @@ export interface AppLayoutShellProps {
         logout?: string;
     };
     eventBannerSlot?: React.ReactNode;
+    /** When provided, renders a tour-start icon button in the title bar. Null in Patch 1. */
+    onTourStart?: () => void;
     /**
      * Override className for the main content wrapper div.
      * When set, replaces the default `w-full px-4 py-6 …`
@@ -113,4 +115,4 @@ export interface AppLayoutShellProps {
         };
     };
 }
-export declare function AppLayoutShell({ children, navItems, sidebarItems, sidebarSections, sidebarPrimaryActions, sidebarTitle, hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle, suppressDashboardNav, hideSidebarToggle, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, eventBannerSlot, contentClassName, lightBackground, darkBackground, }: AppLayoutShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppLayoutShell({ children, navItems, sidebarItems, sidebarSections, sidebarPrimaryActions, sidebarTitle, hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle, suppressDashboardNav, hideSidebarToggle, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar, sidebarProfileLabels, eventBannerSlot, onTourStart, contentClassName, lightBackground, darkBackground, }: AppLayoutShellProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/layout/AppLayoutShell.js

@@ -104,7 +104,7 @@ function SidebarContent({ sidebarItems, sidebarSections, sidebarPrimaryActions,
                     ].join(" "), children: action.label }, `${action.href}-${action.label}`))) })), isAuthenticated && (_jsx(CollapsibleNavGroup, { title: labels.sectionTitle, children: _jsxs(Ul, { spacing: "2xs", children: [_jsx(Li, { children: _jsx(TextLink, { href: profileHref, variant: "none", className: navItemClass, children: labels.profile }) }), userOrdersHref && (_jsx(Li, { children: _jsx(TextLink, { href: userOrdersHref, variant: "none", className: navItemClass, children: labels.orders }) })), userWishlistHref && (_jsx(Li, { children: _jsx(TextLink, { href: userWishlistHref, variant: "none", className: navItemClass, children: labels.wishlist }) })), userSettingsHref && (_jsx(Li, { children: _jsx(TextLink, { href: userSettingsHref, variant: "none", className: navItemClass, children: labels.settings }) }))] }) })), isAuthenticated && user?.stats && (_jsxs(Div, { layout: "grid", gap: "2", className: "grid-cols-2", children: [user.stats.totalOrders != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.totalOrders }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Orders" })] })), user.stats.reviewsCount != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.reviewsCount }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Reviews" })] })), user.stats.auctionsWon != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.auctionsWon }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Auctions Won" })] })), user.stats.itemsSold != null && (_jsxs(Div, { className: CLS_STAT_BOX, children: [_jsx(Text, { className: "leading-none", color: "primary", size: "lg", weight: "bold", children: user.stats.itemsSold }), _jsx(Text, { className: CLS_STAT_LABEL, children: "Items Sold" })] }))] })), isAuthenticated && isAdminOrSeller && (adminHref || resolvedStoreHref) && (_jsx(CollapsibleNavGroup, { title: labels.dashboardSectionTitle, children: _jsxs(Ul, { spacing: "2xs", children: [adminHref && role === "admin" && (_jsx(Li, { children: _jsx(TextLink, { href: adminHref, variant: "none", className: navItemClass, children: labels.adminDashboard }) })), resolvedStoreHref && isAdminOrSeller && (_jsx(Li, { children: _jsx(TextLink, { href: resolvedStoreHref, variant: "none", className: navItemClass, children: labels.storeDashboard }) }))] }) })), normalizedSections.map((section, sectionIndex) => (_jsx(CollapsibleSidebarSection, { section: section, navItemClass: navItemClass }, `sidebar-section-${sectionIndex}`))), (sidebarLocaleSlot || showThemeToggleInSidebar || (isAuthenticated && onLogout)) && (_jsxs(Stack, { border: "default", className: "border-t dark:border-slate-800", padding: "t-md", gap: "3", children: [sidebarLocaleSlot, showThemeToggleInSidebar && (_jsxs("button", { type: "button", onClick: toggleTheme, className: "flex w-full items-center gap-3 rounded-lg px-3 py-2 text-sm text-zinc-700 transition-colors hover:bg-primary-50 hover:text-primary-800 dark:text-zinc-300 dark:hover:bg-slate-800 dark:hover:text-secondary-300", children: [_jsx(Span, { "aria-hidden": "true", children: theme === "dark" ? "☀️" : "🌙" }), theme === "dark" ? "Light mode" : "Dark mode"] })), isAuthenticated && onLogout && (_jsx("button", { type: "button", onClick: () => { onLogout(); onAfterLogout(); }, className: CLS_LOGOUT_BTN, children: labels.logout }))] }))] }));
 }
 // ─── Main component ────────────────────────────────────────────────────────────
-export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarSections, sidebarPrimaryActions, sidebarTitle = "Navigation", hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle = false, suppressDashboardNav = false, hideSidebarToggle = false, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar = false, sidebarProfileLabels, eventBannerSlot, contentClassName, lightBackground = DEFAULT_LIGHT_BG, darkBackground = DEFAULT_DARK_BG, }) {
+export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarSections, sidebarPrimaryActions, sidebarTitle = "Navigation", hiddenNavItems, user, brandName, brandShortName, siteLogoUrl, logoHref, promotionsHref, cartHref, wishlistHref, userId, profileHref, loginHref, registerHref, homeHref, shopHref, footer, searchSlot, searchSlotRenderer, titleBarNavSlot, titleBarNotificationSlot, titleBarDevSlot, titleBarPromoStripText, showThemeToggle = false, suppressDashboardNav = false, hideSidebarToggle = false, onLogout, adminHref, storeHref, sellerHref, userOrdersHref, userWishlistHref, userSettingsHref, sidebarLocaleSlot, showThemeToggleInSidebar = false, sidebarProfileLabels, eventBannerSlot, onTourStart, contentClassName, lightBackground = DEFAULT_LIGHT_BG, darkBackground = DEFAULT_DARK_BG, }) {
     // QueryClientProvider used to be created here so AppLayoutShell could stand
     // alone. The real cause of the 2026-06-10/11 "No QueryClient set" prod crash
     // turned out to be a peer-dep duplicate of @tanstack/query-core under
@@ -164,5 +164,5 @@ export function AppLayoutShell({ children, navItems, sidebarItems = [], sidebarS
             opacity: darkBackground.overlay?.opacity ?? 0,
         },
     };
-    return (_jsx(_Fragment, { children: _jsxs(Stack, { className: "min-h-screen w-full overflow-x-clip transition-colors duration-300", children: [_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: normalizedLightBackground, darkMode: normalizedDarkBackground }), _jsxs(Div, { ref: headerRef, className: "sticky top-0 z-50 w-full", children: [_jsx(TitleBar, { onToggleSidebar: handleTogglePublicSidebar, sidebarOpen: sidebarOpen, onSearchToggle: () => setSearchOpen((prev) => !prev), searchOpen: searchOpen, brandName: brandName, brandShortName: brandShortName, siteLogoUrl: siteLogoUrl, logoHref: logoHref, promotionsHref: promotionsHref, cartHref: cartHref, wishlistHref: wishlistHref, userId: userId, profileHref: profileHref, loginHref: loginHref, registerHref: registerHref, user: user, navSlot: titleBarNavSlot, notificationSlot: titleBarNotificationSlot, devSlot: titleBarDevSlot, promoStripText: titleBarPromoStripText, isDark: theme === "dark", onToggleTheme: showThemeToggle ? toggleTheme : undefined, onBeforeToggleDashboardNav: handleBeforeDashboardNavToggle, suppressDashboardNav: suppressDashboardNav, hideSidebarToggle: hideSidebarToggle }), _jsx(NavbarWithSettings, { navItems: navItems, hiddenNavItems: hiddenNavItems, permissions: authUser?.permissions }), searchOpen && (searchSlotRenderer ? searchSlotRenderer(() => setSearchOpen(false)) : searchSlot)] }), eventBannerSlot, _jsx(AutoBreadcrumbs, {}), _jsxs(Div, { layout: "flex", className: "relative w-full flex-1 overflow-x-clip", children: [_jsx(SidebarLayout, { isOpen: sidebarOpen, ariaLabel: "Secondary navigation", header: user ? (_jsx(SidebarUserHeader, { user: user, onClose: () => setSidebarOpen(false) })) : (_jsx(SidebarGuestHeader, { sidebarTitle: sidebarTitle, onClose: () => setSidebarOpen(false) })), onClose: () => setSidebarOpen(false), children: sidebarContent }), _jsx(Main, { id: "main-content", className: `w-full flex-1 flex flex-col ${hasBottomActions ? "mb-28" : "mb-16"} md:mb-0`, children: _jsx(Div, { padding: "y-lg", className: `flex-1 ${contentClassName ?? "w-full px-5 md:px-6 lg:px-8"}`, children: children }) })] }), _jsx(BackToTop, {}), _jsx(FooterLayout, { ...footer }), _jsx(BottomActions, {}), _jsx(BottomNavbar, { user: user, homeHref: homeHref, shopHref: shopHref, cartHref: cartHref, profileHref: profileHref, loginHref: loginHref, onSearchToggle: () => setSearchOpen((prev) => !prev), navItems: navItems, onMoreToggle: hasDashboardNav ? toggleDashboardNav : handleTogglePublicSidebar }), _jsx(UnsavedChangesModal, {})] }) }));
+    return (_jsx(_Fragment, { children: _jsxs(Stack, { className: "min-h-screen w-full overflow-x-clip transition-colors duration-300", children: [_jsx(BackgroundRenderer, { mode: theme === "dark" ? "dark" : "light", lightMode: normalizedLightBackground, darkMode: normalizedDarkBackground }), _jsxs(Div, { ref: headerRef, className: "sticky top-0 z-50 w-full", children: [_jsx(TitleBar, { onToggleSidebar: handleTogglePublicSidebar, sidebarOpen: sidebarOpen, onSearchToggle: () => setSearchOpen((prev) => !prev), searchOpen: searchOpen, brandName: brandName, brandShortName: brandShortName, siteLogoUrl: siteLogoUrl, logoHref: logoHref, promotionsHref: promotionsHref, cartHref: cartHref, wishlistHref: wishlistHref, userId: userId, profileHref: profileHref, loginHref: loginHref, registerHref: registerHref, user: user, navSlot: titleBarNavSlot, notificationSlot: titleBarNotificationSlot, devSlot: titleBarDevSlot, promoStripText: titleBarPromoStripText, isDark: theme === "dark", onToggleTheme: showThemeToggle ? toggleTheme : undefined, onTourStart: onTourStart, onBeforeToggleDashboardNav: handleBeforeDashboardNavToggle, suppressDashboardNav: suppressDashboardNav, hideSidebarToggle: hideSidebarToggle }), _jsx(NavbarWithSettings, { navItems: navItems, hiddenNavItems: hiddenNavItems, permissions: authUser?.permissions }), searchOpen && (searchSlotRenderer ? searchSlotRenderer(() => setSearchOpen(false)) : searchSlot)] }), eventBannerSlot, _jsx(AutoBreadcrumbs, {}), _jsxs(Div, { layout: "flex", className: "relative w-full flex-1 overflow-x-clip", children: [_jsx(SidebarLayout, { isOpen: sidebarOpen, ariaLabel: "Secondary navigation", header: user ? (_jsx(SidebarUserHeader, { user: user, onClose: () => setSidebarOpen(false) })) : (_jsx(SidebarGuestHeader, { sidebarTitle: sidebarTitle, onClose: () => setSidebarOpen(false) })), onClose: () => setSidebarOpen(false), children: sidebarContent }), _jsx(Main, { id: "main-content", className: `w-full flex-1 flex flex-col ${hasBottomActions ? "mb-28" : "mb-16"} md:mb-0`, children: _jsx(Div, { padding: "y-lg", className: `flex-1 ${contentClassName ?? "mx-auto w-full max-w-screen-xl px-5 md:px-6 lg:px-8"}`, children: children }) })] }), _jsx(BackToTop, {}), _jsx(FooterLayout, { ...footer }), _jsx(BottomActions, {}), _jsx(BottomNavbar, { user: user, homeHref: homeHref, shopHref: shopHref, cartHref: cartHref, profileHref: profileHref, loginHref: loginHref, onSearchToggle: () => setSearchOpen((prev) => !prev), navItems: navItems, onMoreToggle: hasDashboardNav ? toggleDashboardNav : handleTogglePublicSidebar }), _jsx(UnsavedChangesModal, {})] }) }));
 }

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

@@ -52,6 +52,8 @@ export interface TitleBarLayoutProps {
     onToggleDashboardNav?: () => void;
     /** Hide the public sidebar toggle button when nested layouts own navigation. */
     hideSidebarToggle?: boolean;
+    /** When provided, renders a tour-start icon button before the theme toggle. Null in Patch 1. */
+    onTourStart?: () => void;
     id?: string;
     className?: string;
 }
@@ -64,4 +66,4 @@ export interface TitleBarLayoutProps {
  *
  * Receives all domain data as props — zero domain imports.
  */
-export declare function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen: _searchOpen, brandName, brandShortName: _brandShortName, siteLogoUrl, logoHref, promotionsHref, compareHref, wishlistHref, wishlistCount, cartHref, cartCount, profileHref, unreadNotificationCount, notificationsHref, loginHref, registerHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark, onToggleTheme, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle, id, className, }: TitleBarLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen: _searchOpen, brandName, brandShortName: _brandShortName, siteLogoUrl, logoHref, promotionsHref, compareHref, wishlistHref, wishlistCount, cartHref, cartCount, profileHref, unreadNotificationCount, notificationsHref, loginHref, registerHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark, onToggleTheme, onTourStart, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle, id, className, }: TitleBarLayoutProps): import("react/jsx-runtime").JSX.Element;