@mohasinac/appkit 2.8.9 → 3.0.0

package/dist/features/wishlist/components/WishlistToggleButton.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import { useState } from "react";
 import { Button, LoginRequiredModal } from "../../../ui";
 import { isAuthError } from "../../../utils/auth-error";
+import { normalizeError } from "../../../errors/normalize";
 const sizeClasses = {
     sm: "w-7 h-7",
     md: "w-9 h-9",
@@ -16,19 +17,20 @@ export function WishlistToggleButton({ inWishlist, isLoading = false, onToggle,
             await onToggle(e);
         }
         catch (err) {
+            void normalizeError(err);
             if (isAuthError(err)) {
                 setShowLoginModal(true);
             }
         }
     }
     return (_jsxs(_Fragment, { children: [_jsx(LoginRequiredModal, { isOpen: showLoginModal, onClose: () => setShowLoginModal(false), message: "You need to be signed in to save items to your wishlist. Please log in or create an account." }), _jsx(Button, { type: "button", onClick: handleClick, disabled: isLoading, "aria-label": label, title: label, className: `
-          flex items-center justify-center rounded-full
-          transition-all duration-150
-          ${inWishlist
-                    ? "bg-rose-50 text-rose-500 hover:bg-rose-100"
-                    : "bg-white/80 text-zinc-400 hover:text-rose-400"}
-          ${sizeClasses[size]}
-          ${isLoading ? "opacity-50 cursor-not-allowed" : "cursor-pointer"}
-          ${className}
-        `, children: _jsx("svg", { className: "w-4/6 h-4/6", viewBox: "0 0 24 24", fill: inWishlist ? "currentColor" : "none", stroke: "currentColor", strokeWidth: 2, children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z" }) }) })] }));
+ flex items-center justify-center rounded-full
+ transition-all duration-150
+ ${inWishlist
+                    ? "bg-error-surface text-error hover:bg-error-surface"
+                    : "bg-white/80 text-zinc-400 hover:text-error"}
+ ${sizeClasses[size]}
+ ${isLoading ? "opacity-50 cursor-not-allowed" : "cursor-pointer"}
+ ${className}
+ `, children: _jsx("svg", { className: "w-4/6 h-4/6", viewBox: "0 0 24 24", fill: inWishlist ? "currentColor" : "none", stroke: "currentColor", strokeWidth: 2, children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z" }) }) })] }));
 }

package/dist/features/wishlist/components/WishlistView.js

@@ -42,8 +42,8 @@ export function WishlistView({ userId, initialData, labels = {}, renderTabs, ren
         });
         return result;
     }, [items, activeTab, search, sort]);
-    return (_jsx(Div, { className: `min-h-screen ${className}`, children: _jsxs(Div, { className: "py-8 px-4 max-w-screen-xl mx-auto", children: [_jsx(Heading, { level: 1, className: "text-2xl font-bold mb-1", children: labels.title ?? "My Wishlist" }), total > 0 && (_jsx(Text, { variant: "secondary", className: "mb-4", children: labels.subtitle ?? `${total} saved items` })), renderTabs?.(activeTab, (tab) => table.set("tab", tab)), activeTab === "products" && (_jsxs(Row, { wrap: true, gap: "3", className: "mb-4", children: [renderSearch?.(search, (v) => table.set("q", v)), renderSort?.(sort, (v) => table.set("sort", v)), renderViewToggle?.(viewMode, (m) => table.set("view", m))] })), selectedIds.length > 0 &&
+    return (_jsx(Div, { className: `min-h-screen ${className}`, children: _jsxs(Div, { className: "max-w-screen-xl mx-auto", paddingY: "y-xl", paddingX: "x-md", children: [_jsx(Heading, { level: 1, className: "mb-1", size: "2xl", weight: "bold", children: labels.title ?? "My Wishlist" }), total > 0 && (_jsx(Text, { variant: "secondary", className: "mb-4", children: labels.subtitle ?? `${total} saved items` })), renderTabs?.(activeTab, (tab) => table.set("tab", tab)), activeTab === "products" && (_jsxs(Row, { wrap: true, gap: "3", className: "mb-4", children: [renderSearch?.(search, (v) => table.set("q", v)), renderSort?.(sort, (v) => table.set("sort", v)), renderViewToggle?.(viewMode, (m) => table.set("view", m))] })), selectedIds.length > 0 &&
                     renderBulkActions?.(selectedIds, () => setSelectedIds([])), activeTab === "products"
                     ? renderProducts?.(displayedItems, isLoading)
-                    : (renderTabPlaceholder?.(activeTab) ?? (_jsx(Div, { className: "py-16 text-center", children: _jsx(Text, { variant: "secondary", children: "Coming soon" }) }))), renderPagination?.(total)] }) }));
+                    : (renderTabPlaceholder?.(activeTab) ?? (_jsx(Div, { className: "text-center", padding: "y-4xl", children: _jsx(Text, { variant: "secondary", children: "Coming soon" }) }))), renderPagination?.(total)] }) }));
 }

package/dist/features/wishlist/hooks/useUserWishlist.d.ts

@@ -1,3 +1,4 @@
+import type { JsonArray } from "@mohasinac/appkit";
 export interface UserWishlistItem<TProduct = unknown> {
     productId: string;
     addedAt: string;
@@ -12,12 +13,12 @@ export interface UserWishlistResponse<TProduct = unknown> {
 interface UseUserWishlistOptions<TProduct> {
     enabled?: boolean;
     endpoint?: string;
-    queryKey?: unknown[];
+    queryKey?: JsonArray;
     initialData?: UserWishlistResponse<TProduct>;
 }
 export declare function useUserWishlist<TProduct = unknown>(options?: UseUserWishlistOptions<TProduct>): {
     total: number;
-    data: UserWishlistResponse<TProduct>;
+    data: NoInfer<UserWishlistResponse<TProduct>>;
     error: Error;
     isError: true;
     isPending: false;
@@ -40,12 +41,12 @@ export declare function useUserWishlist<TProduct = unknown>(options?: UseUserWis
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<UserWishlistResponse<TProduct>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<UserWishlistResponse<TProduct>>, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<UserWishlistResponse<TProduct>>;
+    promise: Promise<NoInfer<UserWishlistResponse<TProduct>>>;
 } | {
     total: number;
-    data: UserWishlistResponse<TProduct>;
+    data: NoInfer<UserWishlistResponse<TProduct>>;
     error: null;
     isError: false;
     isPending: false;
@@ -68,9 +69,9 @@ export declare function useUserWishlist<TProduct = unknown>(options?: UseUserWis
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<UserWishlistResponse<TProduct>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<UserWishlistResponse<TProduct>>, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<UserWishlistResponse<TProduct>>;
+    promise: Promise<NoInfer<UserWishlistResponse<TProduct>>>;
 } | {
     total: number;
     data: undefined;
@@ -96,9 +97,9 @@ export declare function useUserWishlist<TProduct = unknown>(options?: UseUserWis
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<UserWishlistResponse<TProduct>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<UserWishlistResponse<TProduct>>, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<UserWishlistResponse<TProduct>>;
+    promise: Promise<NoInfer<UserWishlistResponse<TProduct>>>;
 } | {
     total: number;
     data: undefined;
@@ -124,9 +125,9 @@ export declare function useUserWishlist<TProduct = unknown>(options?: UseUserWis
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<UserWishlistResponse<TProduct>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<UserWishlistResponse<TProduct>>, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<UserWishlistResponse<TProduct>>;
+    promise: Promise<NoInfer<UserWishlistResponse<TProduct>>>;
 } | {
     total: number;
     data: undefined;
@@ -152,12 +153,12 @@ export declare function useUserWishlist<TProduct = unknown>(options?: UseUserWis
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<UserWishlistResponse<TProduct>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<UserWishlistResponse<TProduct>>, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<UserWishlistResponse<TProduct>>;
+    promise: Promise<NoInfer<UserWishlistResponse<TProduct>>>;
 } | {
     total: number;
-    data: UserWishlistResponse<TProduct>;
+    data: NoInfer<UserWishlistResponse<TProduct>>;
     isError: false;
     error: null;
     isPending: false;
@@ -180,8 +181,8 @@ export declare function useUserWishlist<TProduct = unknown>(options?: UseUserWis
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<UserWishlistResponse<TProduct>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<UserWishlistResponse<TProduct>>, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<UserWishlistResponse<TProduct>>;
+    promise: Promise<NoInfer<UserWishlistResponse<TProduct>>>;
 };
 export {};

package/dist/features/wishlist/hooks/useWishlist.d.ts

@@ -11,6 +11,6 @@ export declare function useWishlist(userId: string, opts?: UseWishlistOptions):
     isWishlisted: (productId: string) => boolean;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<WishlistResponse, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<WishlistResponse>, Error>>;
 };
 export {};

package/dist/features/wishlist/hooks/useWishlistWithGuest.d.ts

@@ -17,7 +17,7 @@ export declare function useWishlistWithGuest(userId: string | null | undefined,
     isWishlisted: (productId: string) => boolean;
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<WishlistResponse, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<NoInfer<WishlistResponse>, Error>>;
     isGuest: boolean;
     guestWishlist?: undefined;
 } | {

package/dist/features/wishlist/repository/user-wishlist.repository.js

@@ -20,6 +20,7 @@ export class WishlistFullError extends Error {
         this.current = current;
     }
 }
+// audit-unknown-ok: type-narrowing entry point — accepts any value, narrows by typeof/Array.isArray
 function toDate(raw) {
     if (raw instanceof Date)
         return raw;
@@ -30,6 +31,7 @@ function toDate(raw) {
         return new Date(raw);
     return new Date();
 }
+// audit-unknown-ok: type-narrowing entry point — accepts any value, narrows by typeof/Array.isArray
 function normaliseItems(raw) {
     if (!Array.isArray(raw))
         return [];

package/dist/http/ApiClient.d.ts

@@ -1,3 +1,4 @@
+import type { JsonValue } from "../schemas/types";
 /**
  * ApiClient — @mohasinac/http
  *
@@ -25,7 +26,7 @@ export interface RequestConfig extends RequestInit {
     params?: Record<string, string | number | boolean>;
     timeout?: number;
 }
-export interface ApiResponse<T = unknown> {
+export interface ApiResponse<T = JsonValue> {
     success: boolean;
     data?: T;
     error?: string;
@@ -48,12 +49,12 @@ export declare class ApiClient {
     private buildURL;
     private getHeaders;
     private request;
-    get<T = unknown>(endpoint: string, config?: RequestConfig): Promise<T>;
-    post<T = unknown>(endpoint: string, data?: unknown, config?: RequestConfig): Promise<T>;
-    put<T = unknown>(endpoint: string, data?: unknown, config?: RequestConfig): Promise<T>;
-    patch<T = unknown>(endpoint: string, data?: unknown, config?: RequestConfig): Promise<T>;
-    delete<T = unknown>(endpoint: string, config?: RequestConfig): Promise<T>;
-    upload<T = unknown>(endpoint: string, formData: FormData, config?: RequestConfig): Promise<T>;
+    get<T = JsonValue>(endpoint: string, config?: RequestConfig): Promise<T>;
+    post<T = JsonValue>(endpoint: string, data?: unknown, config?: RequestConfig): Promise<T>;
+    put<T = JsonValue>(endpoint: string, data?: unknown, config?: RequestConfig): Promise<T>;
+    patch<T = JsonValue>(endpoint: string, data?: unknown, config?: RequestConfig): Promise<T>;
+    delete<T = JsonValue>(endpoint: string, config?: RequestConfig): Promise<T>;
+    upload<T = JsonValue>(endpoint: string, formData: FormData, config?: RequestConfig): Promise<T>;
 }
 /** Default singleton instance — reads NEXT_PUBLIC_APP_URL from env */
 export declare const apiClient: ApiClient;

package/dist/http/ApiClient.js

@@ -17,7 +17,9 @@
  * ```
  */
 export class ApiClientError extends Error {
-    constructor(message, status, data) {
+    constructor(message, status, 
+    // audit-unknown-ok: HTTP body/response — arbitrary JSON
+    data) {
         super(message);
         this.status = status;
         this.data = data;
@@ -108,21 +110,27 @@ export class ApiClient {
     async get(endpoint, config) {
         return this.request(endpoint, { ...config, method: "GET" });
     }
-    async post(endpoint, data, config) {
+    async post(endpoint, 
+    // audit-unknown-ok: HTTP body/response — arbitrary JSON
+    data, config) {
         return this.request(endpoint, {
             ...config,
             method: "POST",
             body: data != null ? JSON.stringify(data) : undefined,
         });
     }
-    async put(endpoint, data, config) {
+    async put(endpoint, 
+    // audit-unknown-ok: HTTP body/response — arbitrary JSON
+    data, config) {
         return this.request(endpoint, {
             ...config,
             method: "PUT",
             body: data != null ? JSON.stringify(data) : undefined,
         });
     }
-    async patch(endpoint, data, config) {
+    async patch(endpoint, 
+    // audit-unknown-ok: HTTP body/response — arbitrary JSON
+    data, config) {
         return this.request(endpoint, {
             ...config,
             method: "PATCH",

package/dist/index.d.ts

@@ -3,7 +3,6 @@ export { FLUID_GRID_MIN_WIDTHS } from "./tokens/index";
 export { LOCALE_CONFIG } from "./tokens/index";
 export { RADIUS } from "./tokens/index";
 export { SHADOWS } from "./tokens/index";
-export { THEME_CONSTANTS } from "./tokens/index";
 export { TOKENS } from "./tokens/index";
 export { Z_INDEX } from "./tokens/index";
 export { token } from "./tokens/index";
@@ -32,6 +31,10 @@ export { Container } from "./ui/index";
 export { DEFAULT_PAGINATION_CONFIG } from "./ui/index";
 export { DEFAULT_STICKY_CONFIG } from "./ui/index";
 export { DataTable } from "./ui/index";
+export { Table, Thead, Tbody, Tr, Th, Td } from "./ui/index";
+export type { TableProps, TheadProps, TbodyProps, TrProps, ThProps, TdProps } from "./ui/index";
+export { Code, Pre, Blockquote } from "./ui/index";
+export type { CodeProps, PreProps, BlockquoteProps } from "./ui/index";
 export { DescriptionField } from "./ui/index";
 export { Div } from "./ui/index";
 export { Divider } from "./ui/index";
@@ -69,6 +72,36 @@ export type { PaginatedSelectProps } from "./ui/index";
 export { PaginatedSelect } from "./ui/index";
 export { EmptyState } from "./ui/index";
 export type { EmptyStateProps } from "./ui/index";
+export { FallbackShell } from "./ui/components/FallbackShell";
+export type { FallbackShellProps, FallbackShellTone, } from "./ui/components/FallbackShell";
+export { HotspotMarker } from "./ui/components/HotspotMarker";
+export type { HotspotMarkerProps, HotspotMarkerShape, HotspotMarkerSize, HotspotMarkerTone, } from "./ui/components/HotspotMarker";
+export { Anchor } from "./ui/components/Anchor";
+export type { AnchorProps, AnchorTone, AnchorUnderline, } from "./ui/components/Anchor";
+export { Iframe } from "./ui/components/Iframe";
+export type { IframeAspect, IframeProps, IframeRounded, } from "./ui/components/Iframe";
+export { HorizontalRule } from "./ui/components/HorizontalRule";
+export type { HorizontalRuleProps, HorizontalRuleSpacing, HorizontalRuleTone, } from "./ui/components/HorizontalRule";
+export { Scrim } from "./ui/components/Scrim";
+export type { ScrimProps, ScrimDirection, ScrimIntensity } from "./ui/components/Scrim";
+export { Kbd } from "./ui/components/Kbd";
+export type { KbdProps, KbdSize, KbdTone } from "./ui/components/Kbd";
+export { Quote } from "./ui/components/Quote";
+export type { QuoteProps, QuoteTone } from "./ui/components/Quote";
+export { IconBox } from "./ui/components/IconBox";
+export type { IconBoxProps, IconBoxRounded, IconBoxSize, IconBoxTone, } from "./ui/components/IconBox";
+export { StickyToolbar } from "./ui/components/StickyToolbar";
+export type { StickyToolbarOffset, StickyToolbarPadding, StickyToolbarProps, StickyToolbarTone, } from "./ui/components/StickyToolbar";
+export { Fieldset, Legend } from "./ui/components/Fieldset";
+export type { FieldsetPadding, FieldsetProps, FieldsetTone, LegendProps, } from "./ui/components/Fieldset";
+export { Details, Summary } from "./ui/components/Details";
+export type { DetailsPadding, DetailsProps, DetailsTone, SummaryProps, } from "./ui/components/Details";
+export { Dialog } from "./ui/components/Dialog";
+export type { DialogPadding, DialogProps } from "./ui/components/Dialog";
+export { Hide, Show } from "./ui/components/Responsive";
+export type { Breakpoint, HideProps, ShowProps, } from "./ui/components/Responsive";
+export { MediaAudio } from "./features/media/MediaAudio";
+export type { MediaAudioControls, MediaAudioProps, } from "./features/media/MediaAudio";
 export type { FilterDrawerProps } from "./ui/index";
 export type { FlowDiagramProps } from "./ui/index";
 export type { FlowStep } from "./ui/index";
@@ -294,6 +327,12 @@ export { handleApiError } from "./errors/index";
 export { isAppError } from "./errors/index";
 export { logError } from "./errors/index";
 export type { ErrorCode } from "./errors/index";
+export { RazorpayUnreachableError } from "./errors/index";
+export { mapToHttpError, HTTP_ERROR_CODES } from "./errors/index";
+export type { MappedError, HttpErrorCode } from "./errors/index";
+export { ERROR_DISPLAY_MAP, getErrorDisplay } from "./errors/index";
+export type { ErrorDisplayEntry } from "./errors/index";
+export { parseJsonBody } from "./next/api/parseJsonBody";
 export { SEO_CONFIG } from "./seo/index";
 export { aggregateRatingJsonLd } from "./seo/index";
 export { auctionJsonLd } from "./seo/index";
@@ -527,6 +566,7 @@ export { productRepository } from "./repositories/index";
 export { reviewRepository } from "./repositories/index";
 export { sessionRepository } from "./repositories/index";
 export { siteSettingsRepository } from "./repositories/index";
+export { ADMIN_CHECKOUT_BYPASS_FLAG_KEY } from "./features/admin/schemas/firestore";
 export { smsCounterRepository } from "./repositories/index";
 export { storeRepository } from "./repositories/index";
 export { scammerRepository } from "./repositories/index";
@@ -2984,7 +3024,7 @@ export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDP
 export { WishlistFullError } from "./features/wishlist/server";
 export { useHistory, useHistoryMergeOnLogin, getGuestHistory, trackGuestHistory, removeGuestHistoryItem, clearGuestHistory, getGuestHistoryCount, type GuestHistoryItem, type GuestHistoryType, type UserHistoryItem, type HistoryProductType, type HistoryItemSnapshot, type TrackArgs as TrackHistoryArgs, } from "./features/history";
 export { historyRepository, UserHistoryRepository, trackHistoryView, getHistoryForUser, removeHistoryItem, clearHistory, mergeGuestHistory, } from "./features/history/server";
-export { useMediaQuery, useBreakpoint, useClickOutside, useKeyPress, useLongPress, useGesture, useSwipe, ThemeProvider, useTheme, useSession, useAuth, useCountdown, useCamera, useBulkSelection, useUrlTable, usePendingFilters, usePendingTable, useUnsavedChanges, UNSAVED_CHANGES_EVENT, useBulkAction, useEntityDelete, useContainerGrid, useMessage, useVisibleItems, useModalStack, RTDBPayloadStatus, } from "./react/index";
+export { useMediaQuery, useBreakpoint, useClickOutside, useKeyPress, useLongPress, useGesture, useSwipe, useSession, useAuth, useCountdown, useCamera, useBulkSelection, useUrlTable, usePendingFilters, usePendingTable, useUnsavedChanges, UNSAVED_CHANGES_EVENT, useBulkAction, useEntityDelete, useContainerGrid, useMessage, useVisibleItems, useModalStack, RTDBPayloadStatus, } from "./react/index";
 export { RoleGate, ProtectedRoute, SocialAuthButtons, AuthStatusPanel, LoginForm, RegisterForm, ForgotPasswordView, ResetPasswordView, VerifyEmailView, OAuthLoadingView, } from "./features/auth/index";
 export type { RoleGateProps, ProtectedRouteProps, AuthGuardUser, AuthRouteConfig, LoginFormProps, LoginFormValues, RegisterFormProps, RegisterFormValues, ForgotPasswordViewProps, ResetPasswordViewProps, VerifyEmailViewProps, } from "./features/auth/index";
 export { CartItemRow, CartDrawer, CartView, CartSummary, ShippingPicker } from "./features/cart/index";
@@ -2994,6 +3034,7 @@ export { CheckoutStepper, useCheckout } from "./features/checkout/index";
 export { useProfile as useCurrentProfile, useUpdateProfile as useUpdateCurrentProfile } from "./features/account/index";
 export { useLogout } from "./features/auth/index";
 export { Text, Label, Span } from "./ui/index";
+export type { ColorVariant, FontFamily, TextAlign, TextGradient, TextTransform, TextTruncate, } from "./ui/components/Typography";
 export { Input } from "./ui/index";
 export { Section, Main, Nav, Ul, Li } from "./ui/index";
 export { coerceMediaField, coerceMediaFieldArray, getMediaUrl, mediaFieldSchema } from "./features/media/index";
@@ -3010,7 +3051,7 @@ export { formatFileSize } from "./utils/number.formatter";
 export { formatMonthYear } from "./utils/date.formatter";
 export { generateMediaFilename } from "./utils/id-generators";
 export type { MediaFilenameContext } from "./utils/id-generators";
-export { resolveMediaUrl } from "./utils/media-url";
+export { resolveMediaUrl, FIREBASE_STORAGE_HOST, GCS_HOST } from "./utils/media-url";
 export { generateFAQId } from "./utils/id-generators";
 export type { GenerateFAQIdInput } from "./utils/id-generators";
 export { generateCroppedImageFilename } from "./utils/id-generators";
@@ -3116,6 +3157,8 @@ export { buildSearchTokens, tokenizeQuery } from "./utils/search-tokens";
 export { ActionPermissionsManager } from "./features/site-settings/components/ActionPermissionsManager";
 export type { ActionPermissionsManagerProps } from "./features/site-settings/components/ActionPermissionsManager";
 export { NavPermissionsManager } from "./features/site-settings/components/NavPermissionsManager";
+export { ThemeManagerView } from "./features/site-settings/components/ThemeManagerView";
+export type { ThemeManagerValue, ThemeManagerViewProps, } from "./features/site-settings/components/ThemeManagerView";
 export type { NavPermissionsManagerProps, NavGroup as NavPermissionsGroup, NavItem as NavPermissionsItem } from "./features/site-settings/components/NavPermissionsManager";
 export { getClassifiedForDetail } from "./_internal/server/features/classified/data";
 export { startClassifiedConversationAction } from "./_internal/server/features/classified/actions";
@@ -3143,3 +3186,7 @@ export { SellerDigitalCodesView } from "./features/seller/components/SellerDigit
 export type { SellerDigitalCodesViewProps } from "./features/seller/components/SellerDigitalCodesView";
 export { SellerLiveView } from "./features/seller/components/SellerLiveView";
 export type { SellerLiveViewProps } from "./features/seller/components/SellerLiveView";
+export { SCHEMAS, lookupApiSchema, lookupFirestoreSchema, } from "./schemas/index";
+export type { ApiRouteKey, ApiRouteSchema, FirestoreDocument, FirestoreValue, FormFieldValue, FormValues, HttpVerb, JsonArray, JsonObject, JsonObjectWithUndefined, JsonPrimitive, JsonValue, JsonValueWithUndefined, RegisteredApiRouteKey, RegisteredFirestoreCollection, RegisteredFormId, RegisteredRtdbChannel, RegisteredSieveCollection, RegisteredStorageOp, RegisteredWebhookProvider, RegistryEntry, SchemaRegistry, SchemasShape, WebhookSchemaBucket, } from "./schemas/index";
+export { normalizeError, getErrorMessage, isApiNormalized, isAppNormalized, isFirebaseAuthNormalized, isFirebaseFirestoreNormalized, isFirebaseStorageNormalized, isNativeNormalized, isNetworkNormalized, isUnknownNormalized, isZodNormalized, } from "./errors/normalize";
+export type { NormalizedError, NormalizedApiError, NormalizedAppError, NormalizedFirebaseAuthError, NormalizedFirebaseFirestoreError, NormalizedFirebaseStorageError, NormalizedNativeError, NormalizedNetworkError, NormalizedUnknownThrownValue, NormalizedZodError, } from "./errors/normalize";

package/dist/index.js

@@ -17,9 +17,6 @@ export { RADIUS } from "./tokens/index";
 // SHADOWS - Constant used across modules.
 export { SHADOWS } from "./tokens/index";
 // [CONFIG]-Application configuration constant â€" route path, API endpoint, design token, or feature flag.
-// THEME_CONSTANTS - Constant used across modules.
-export { THEME_CONSTANTS } from "./tokens/index";
-// [CONFIG]-Application configuration constant â€" route path, API endpoint, design token, or feature flag.
 // TOKENS - Constant used across modules.
 export { TOKENS } from "./tokens/index";
 // [CONFIG]-Application configuration constant â€" route path, API endpoint, design token, or feature flag.
@@ -104,6 +101,10 @@ export { DEFAULT_STICKY_CONFIG } from "./ui/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // DataTable - Component for data table.
 export { DataTable } from "./ui/index";
+// Table family primitives — replace raw <table>/<tr>/<td>/etc. (W-E).
+export { Table, Thead, Tbody, Tr, Th, Td } from "./ui/index";
+// Inline-text primitives — replace raw <code>/<pre>/<blockquote>/<kbd>/<q> (W-E).
+export { Code, Pre, Blockquote } from "./ui/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // DescriptionField - Shared export for description field.
 export { DescriptionField } from "./ui/index";
@@ -157,6 +158,49 @@ export { useToast } from "./ui/index";
 export { PaginatedSelect } from "./ui/index";
 // EmptyState - Component for empty state display.
 export { EmptyState } from "./ui/index";
+// FallbackShell — primitive used by ErrorBoundary / global-error route.
+// Inlines critical CSS so it renders before/without Tailwind.
+export { FallbackShell } from "./ui/components/FallbackShell";
+// HotspotMarker — primitive for dynamically positioned overlay markers
+// (campaign image pins, character hotspots). Owns the inline left/top style
+// so consumer code never authors `style={{ left, top }}` manually.
+export { HotspotMarker } from "./ui/components/HotspotMarker";
+// Anchor — primitive for external links / `mailto:` / `tel:`. Internal Next.js
+// routes use `<TextLink>` instead. Tone + underline are typed enums.
+export { Anchor } from "./ui/components/Anchor";
+// Iframe — primitive for embedded third-party documents (YouTube, Maps).
+// Aspect + rounded + sandbox come from typed enums; consumer code never
+// authors a raw <iframe>.
+export { Iframe } from "./ui/components/Iframe";
+// HorizontalRule — primitive for <hr>. `tone="accent"` consumes
+// --appkit-gradient-accent-divider so dividers follow the active theme.
+export { HorizontalRule } from "./ui/components/HorizontalRule";
+// Scrim — primitive for dark fade overlays (image legibility / hero scrims).
+export { Scrim } from "./ui/components/Scrim";
+// Kbd — primitive for <kbd> (keyboard key affordance).
+export { Kbd } from "./ui/components/Kbd";
+// Quote — primitive for inline <q> + multi-line <blockquote> (via `block`).
+export { Quote } from "./ui/components/Quote";
+// IconBox — square-icon container (catalogue replacement for the recurrent
+// `flex-shrink-0 w-N h-N rounded-X flex items-center justify-center` pattern).
+export { IconBox } from "./ui/components/IconBox";
+// StickyToolbar — sticky translucent bar under the AppLayoutShell header.
+// Sources its offset from --header-height; consumer code never authors
+// the offset manually.
+export { StickyToolbar } from "./ui/components/StickyToolbar";
+// Fieldset + Legend — primitives for grouped form controls.
+export { Fieldset, Legend } from "./ui/components/Fieldset";
+// Details + Summary — primitives for native <details> disclosure widget.
+export { Details, Summary } from "./ui/components/Details";
+// Dialog — primitive for native <dialog> (top-layer rendering + focus trap).
+// Distinct from <Modal> (portal + AnimatePresence).
+export { Dialog } from "./ui/components/Dialog";
+// Show + Hide — primitives for breakpoint-conditional render. Hydration-safe
+// (server renders both trees; CSS hides the inactive branch).
+export { Hide, Show } from "./ui/components/Responsive";
+// MediaAudio — primitive for `<audio>`. Routes through the media proxy for
+// both internal slugs and external (HMAC-signed) URLs.
+export { MediaAudio } from "./features/media/MediaAudio";
 // [TYPE]-TypeScript type-only export â€" erased at compile time, zero runtime cost.
 // UlProps - Type contract for ul props.
 // [CLIENT-ONLY]-Cannot run in SSR mode â€" uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
@@ -509,6 +553,19 @@ export { isAppError } from "./errors/index";
 // [UTIL]-Pure utility â€" no framework or runtime dependency; safe to import from any environment.
 // logError - Helper for log error.
 export { logError } from "./errors/index";
+// [UTIL]-Pure utility — no framework or runtime dependency; safe to import from any environment.
+// RazorpayUnreachableError - Thrown when Razorpay API exhausts retries.
+export { RazorpayUnreachableError } from "./errors/index";
+// [UTIL]-Pure utility — server boundary code/HTTP mapper for any thrown value.
+// mapToHttpError - Map any thrown value to { status, code, message, issues? }.
+export { mapToHttpError, HTTP_ERROR_CODES } from "./errors/index";
+// [UTIL]-Pure utility — client-safe lookup of inline-field + i18n key per error code.
+// ERROR_DISPLAY_MAP - CLAUDE.md Rule #9 source-of-truth for client error rendering.
+export { ERROR_DISPLAY_MAP, getErrorDisplay } from "./errors/index";
+// [SERVER-ONLY] parseJsonBody — strict JSON request-body parser for API routes.
+// Replaces the silent `request.json().catch(() => ({}))` anti-pattern. Throws
+// ValidationError on malformed JSON → routeHandler wrapper maps to 400.
+export { parseJsonBody } from "./next/api/parseJsonBody";
 // ./seo/index
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // SEO_CONFIG - Constant used across modules.
@@ -1068,6 +1125,8 @@ export { sessionRepository } from "./repositories/index";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // siteSettingsRepository - Shared export for site settings repository.
 export { siteSettingsRepository } from "./repositories/index";
+// ADMIN_CHECKOUT_BYPASS_FLAG_KEY - field name for the admin checkout bypass flag.
+export { ADMIN_CHECKOUT_BYPASS_FLAG_KEY } from "./features/admin/schemas/firestore";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // smsCounterRepository - Shared export for sms counter repository.
 export { smsCounterRepository } from "./repositories/index";
@@ -5397,7 +5456,7 @@ export { WishlistFullError } from "./features/wishlist/server";
 export { useHistory, useHistoryMergeOnLogin, getGuestHistory, trackGuestHistory, removeGuestHistoryItem, clearGuestHistory, getGuestHistoryCount, } from "./features/history";
 export { historyRepository, UserHistoryRepository, trackHistoryView, getHistoryForUser, removeHistoryItem, clearHistory, mergeGuestHistory, } from "./features/history/server";
 // Missing React hooks and providers
-export { useMediaQuery, useBreakpoint, useClickOutside, useKeyPress, useLongPress, useGesture, useSwipe, ThemeProvider, useTheme, useSession, useAuth, useCountdown, useCamera, useBulkSelection, useUrlTable, usePendingFilters, usePendingTable, useUnsavedChanges, UNSAVED_CHANGES_EVENT, useBulkAction, useEntityDelete, useContainerGrid, useMessage, useVisibleItems, useModalStack, RTDBPayloadStatus, } from "./react/index";
+export { useMediaQuery, useBreakpoint, useClickOutside, useKeyPress, useLongPress, useGesture, useSwipe, useSession, useAuth, useCountdown, useCamera, useBulkSelection, useUrlTable, usePendingFilters, usePendingTable, useUnsavedChanges, UNSAVED_CHANGES_EVENT, useBulkAction, useEntityDelete, useContainerGrid, useMessage, useVisibleItems, useModalStack, RTDBPayloadStatus, } from "./react/index";
 // Missing core types (already exported above; skipped to avoid duplicates)
 // Missing auth feature components
 export { RoleGate, ProtectedRoute, SocialAuthButtons, AuthStatusPanel, LoginForm, RegisterForm, ForgotPasswordView, ResetPasswordView, VerifyEmailView, OAuthLoadingView, } from "./features/auth/index";
@@ -5431,7 +5490,7 @@ export { buildSieveFilters } from "./utils/filter.helper";
 export { formatFileSize } from "./utils/number.formatter";
 export { formatMonthYear } from "./utils/date.formatter";
 export { generateMediaFilename } from "./utils/id-generators"; // generateProductImageFilename already exported from "./utils/id-generators";
-export { resolveMediaUrl } from "./utils/media-url";
+export { resolveMediaUrl, FIREBASE_STORAGE_HOST, GCS_HOST } from "./utils/media-url";
 export { generateFAQId } from "./utils/id-generators";
 export { generateCroppedImageFilename } from "./utils/id-generators";
 // Messages / Conversations feature schemas
@@ -5539,6 +5598,9 @@ export { buildSearchTokens, tokenizeQuery } from "./utils/search-tokens";
 // [CLIENT-ONLY] — Admin panel components for action/nav permission management.
 export { ActionPermissionsManager } from "./features/site-settings/components/ActionPermissionsManager";
 export { NavPermissionsManager } from "./features/site-settings/components/NavPermissionsManager";
+// ThemeManagerView — Site Settings → Themes tab UI. Manages
+// siteSettings.theme.themes[] + defaultLightThemeId + defaultDarkThemeId.
+export { ThemeManagerView } from "./features/site-settings/components/ThemeManagerView";
 // ── Classified listing feature ─────────────────────────────────────────────────
 export { getClassifiedForDetail } from "./_internal/server/features/classified/data";
 export { startClassifiedConversationAction } from "./_internal/server/features/classified/actions";
@@ -5560,3 +5622,13 @@ export { SellerBundlesView } from "./features/seller/components/SellerBundlesVie
 export { SellerClassifiedView } from "./features/seller/components/SellerClassifiedView";
 export { SellerDigitalCodesView } from "./features/seller/components/SellerDigitalCodesView";
 export { SellerLiveView } from "./features/seller/components/SellerLiveView";
+// ── Central schema registry (W1) ──────────────────────────────────────────────
+// SCHEMAS is the single source of truth for every Zod schema at a system
+// boundary (Firestore docs, API routes, forms, sieve, webhooks, RTDB, storage).
+// Per-feature `schemas/index.ts` files register into the relevant bucket.
+// Pure Zod, isomorphic — safe on both client and server.
+export { SCHEMAS, lookupApiSchema, lookupFirestoreSchema, } from "./schemas/index";
+// ── W3 catch-clause normalizer ──────────────────────────────────────────────
+// Every catch (e: unknown) funnels through normalizeError(e) which returns
+// a NormalizedError discriminated union. Audit-catch-normalize enforces this.
+export { normalizeError, getErrorMessage, isApiNormalized, isAppNormalized, isFirebaseAuthNormalized, isFirebaseFirestoreNormalized, isFirebaseStorageNormalized, isNativeNormalized, isNetworkNormalized, isUnknownNormalized, isZodNormalized, } from "./errors/normalize";

package/dist/instrumentation/index.d.ts

@@ -29,9 +29,9 @@
  * import { createInstrumentation } from "./";
  *
  * const { register } = createInstrumentation({
- *   onNodeServer: async () => {
- *     await import("./src/providers.config");
- *   },
+ * onNodeServer: async () => {
+ * await import("./src/providers.config");
+ * },
  * });
  *
  * export { register };

package/dist/instrumentation/index.js

@@ -29,9 +29,9 @@
  * import { createInstrumentation } from "./";
  *
  * const { register } = createInstrumentation({
- *   onNodeServer: async () => {
- *     await import("./src/providers.config");
- *   },
+ * onNodeServer: async () => {
+ * await import("./src/providers.config");
+ * },
  * });
  *
  * export { register };

package/dist/jobs.d.ts

@@ -21,4 +21,6 @@
  *   } from "@mohasinac/appkit/jobs";
  */
 export { couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onBidPlacedHandler, onReviewWriteHandler, promotionsHandler, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, payoutBatchHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, storeAnalyticsHandler, listingProcessorHandler, supportedListingCollections, prizeRevealOpenHandler, prizeRevealCloseHandler, prizeRevealExpiryHandler, prizeRevealReminderHandler, bundleStockSyncHandler, onProductStockChangeHandler, triggerEventRaffleHandler, assignSpinPrizeHandler, draftPruneHandler, onSupportTicketCreateHandler, onSupportTicketUpdateHandler, onUserBanChangeHandler, onScamReportCreateHandler, onScamReportUpdateHandler, bindSchedule, bindDocumentWritten, bindDocumentCreated, bindDocumentUpdated, bindCallable, bindHttps, bindToFirebase, } from "./_internal/server/jobs/index.js";
+export { defineFunction, mergeFunctionRegistries, bindAllFromRegistry, APPKIT_FUNCTIONS, APPKIT_FUNCTIONS_BY_NAME, } from "./_internal/server/functions/index.js";
 export type { PromotionsCallableResult, AdminAnalyticsResult, StoreAnalyticsInput, StoreAnalyticsResult, ListingRequestBody, ListingResponseBody, JobContext, JobLogger, JobHandlers, ScheduleHandler, FirestoreTriggerHandler, FirestoreTriggerEvent, CallableHandler, BindHttpsOptions, } from "./_internal/server/jobs/index.js";
+export type { DocumentCreatedTrigger, DocumentTriggerFunctionDefinition, DocumentUpdatedTrigger, DocumentWrittenTrigger, FunctionDefinition, FunctionMemory, FunctionOptions, FunctionTrigger, HttpsFunctionDefinition, HttpsTrigger, ScheduledFunctionDefinition, ScheduleTrigger, } from "./_internal/server/functions/index.js";

package/dist/jobs.js

@@ -35,3 +35,8 @@ onSupportTicketCreateHandler, onSupportTicketUpdateHandler, onUserBanChangeHandl
 onScamReportCreateHandler, onScamReportUpdateHandler, 
 // Firebase binder adapter
 bindSchedule, bindDocumentWritten, bindDocumentCreated, bindDocumentUpdated, bindCallable, bindHttps, bindToFirebase, } from "./_internal/server/jobs/index.js";
+// Function registry (Track A) — typed declarative manifest of every appkit
+// Firebase function. Consumers extend by passing a second registry to
+// mergeFunctionRegistries(...) and binding the result with
+// bindAllFromRegistry(...).
+export { defineFunction, mergeFunctionRegistries, bindAllFromRegistry, APPKIT_FUNCTIONS, APPKIT_FUNCTIONS_BY_NAME, } from "./_internal/server/functions/index.js";

package/dist/monitoring/analytics.d.ts

@@ -1,3 +1,4 @@
+import type { JsonValue } from "@mohasinac/appkit";
 export declare const ANALYTICS_EVENTS: {
     readonly PAGE_VIEW: "page_view";
     readonly LOGIN: "login";
@@ -13,11 +14,11 @@ export declare const ANALYTICS_EVENTS: {
 };
 export type AnalyticsEvent = (typeof ANALYTICS_EVENTS)[keyof typeof ANALYTICS_EVENTS];
 export declare function initializeAnalytics(params: {
-    app: unknown;
+    app: JsonValue;
     enabled?: boolean;
     currency?: string;
 }): Promise<void>;
-export declare const trackEvent: (eventName: string, eventParams?: Record<string, unknown>) => void;
+export declare const trackEvent: (eventName: string, eventParams?: Record<string, JsonValue>) => void;
 export declare const setAnalyticsUserId: (userId: string | null) => void;
 export declare const setAnalyticsUserProperties: (properties: Record<string, string | number | boolean>) => void;
 export declare const trackPageView: (page_path: string, page_title: string) => void;