@mohasinac/appkit 2.2.0 → 2.3.1

package/README.md

@@ -1,53 +1,116 @@
 # @mohasinac/appkit
 
-Standalone core library repository for shared contracts, providers, UI primitives, and feature modules used by consumer apps such as `letitrip.in`.
+Appkit is a TypeScript package that provides shared contracts, feature modules, UI helpers, repositories, and runtime-aware utilities for Next.js and React applications.
 
-## Standalone Model
+## Package Info
 
-- `appkit` is published to npm as `@mohasinac/appkit`.
-- Consumer apps install from npm registry in production/CI/server flows.
-- Local watch/prerelease testing can be done manually without coupling repositories.
+- Name: `@mohasinac/appkit`
+- Current version: `2.3.1`
+- Module type: ESM
+- Entrypoints:
+  - Root: `dist/index.js`
+  - Client-only: `dist/client.js`
+  - Server-only: `dist/server.js`
 
-## Install (Consumer Apps)
+## Installation
 
 ```bash
 npm install @mohasinac/appkit
 ```
 
-## Common Subpath Imports
+Install peer dependencies required by the features you use:
 
-- `@mohasinac/appkit/contracts`
-- `@mohasinac/appkit/core`
-- `@mohasinac/appkit/http`
-- `@mohasinac/appkit/errors`
-- `@mohasinac/appkit/utils`
-- `@mohasinac/appkit/validation`
-- `@mohasinac/appkit/ui`
-- `@mohasinac/appkit/next`
-- `@mohasinac/appkit/react`
-- `@mohasinac/appkit/providers/*`
-- `@mohasinac/appkit/features/*`
+```bash
+npm install react react-dom next next-intl @tanstack/react-query
+```
+
+Optional peer dependencies (only if your integration uses them):
 
-## Development
+- `firebase-admin`
+- `resend`
+- `razorpay`
+
+## Build Appkit Locally
 
 ```bash
-npm install
-npm run watch
+npm run build
 ```
 
-## Type Safety and Quality
+This compiles the package to `dist/` using `tsconfig.build.json`.
 
-```bash
-npm run lint
-npm run typecheck
+## Basic Consumer Usage
+
+```ts
+import {
+  // contracts
+  type ApiResponse,
+  // constants
+  API_ENDPOINTS,
+  // utilities
+  createApiEndpointResolver,
+} from "@mohasinac/appkit";
+```
+
+Appkit exposes three runtime-aware entrypoints:
+
+- `@mohasinac/appkit`: shared/runtime-safe exports
+- `@mohasinac/appkit/client`: browser-only exports
+- `@mohasinac/appkit/server`: server-only exports
+
+Use the smallest runtime-specific entrypoint possible.
+
+## Runtime Handling for Consumers
+
+Because Appkit includes both server-capable and browser-only modules, consumers must choose where code runs.
+
+1. Use shared utilities, types, schemas, and config constants anywhere.
+2. Use server-only code only in server contexts (server actions, route handlers, backend code).
+3. Render browser-only modules from client components.
+4. If a browser-only component must be loaded from an SSR route, use dynamic import with SSR disabled.
+
+Example for browser-only modules in an SSR page:
+
+```tsx
+import dynamic from "next/dynamic";
+
+const ClientWidget = dynamic(
+  () => import("@mohasinac/appkit/client").then((m) => m.ClientWidget),
+  { ssr: false },
+);
+```
+
+Example for server-only modules:
+
+```ts
+import { createApiHandler } from "@mohasinac/appkit/server";
 ```
 
-No bundler or custom build pipeline is required. The package is source-first and
-exports TypeScript entry points directly for modern Next.js and TypeScript
-toolchains.
+## Consumer Responsibilities
+
+When integrating Appkit, keep these boundaries in your application:
+
+1. Keep secrets in server-only environment files and never expose them in client bundles.
+2. Initialize SDKs once in provider/config bootstrap code.
+3. Keep page-level data fetching in your app's page or server layer; pass data to Appkit views/components.
+4. Wrap writes/mutations in server actions or backend handlers.
+5. Use Appkit repositories/contracts rather than bypassing with ad hoc direct SDK calls.
+
+## Adding New Components or Code to Appkit
+
+Use this checklist when contributing:
+
+1. Place code in the appropriate domain folder under `src/` (`features/`, `core/`, `contracts/`, `utils/`, etc.).
+2. Export new symbols from the local domain barrel (`index.ts`) and then from `src/index.ts` if public.
+3. Keep runtime boundaries explicit:
+   - Browser API usage (`window`, `document`, `navigator`, `localStorage`) belongs to client-only modules.
+   - Node/server SDK usage belongs to server-only modules.
+   - Pure helpers stay framework-agnostic.
+4. Prefer type-safe contracts and schema validation for new APIs and forms.
+5. Run `npm run build` and fix all TypeScript errors before publishing.
+6. Add or update docs when new exports change consumer behavior.
 
 ## Publishing Notes
 
-- Publish new versions from this repository only.
-- Keep exported API and subpath entries aligned with `package.json` exports.
-- Consumer repositories should depend on registry versions, not committed file/link specs.
+- Only `dist/` is published (`files` field in `package.json`).
+- Ensure build output is up to date before release.
+- Validate exported API surface from `src/index.ts`, `src/client.ts`, and `src/server.ts` before version bump.

package/dist/client.d.ts

@@ -1,15 +1,95 @@
-export * from "./ui/index";
-export * from "./react/index";
-export * from "./tokens/index";
-export * from "./values/index";
-export * from "./utils/index";
-export * from "./constants/index";
-export * from "./contracts/index";
-export * from "./validation/index";
-export * from "./errors/index";
-export * from "./seo/index";
-export * from "./cli/index";
-export { getMarketProfile, getDefaultCurrency, getDefaultLocale, getDefaultCountry, getDefaultPhonePrefix, getDefaultTimezone, getDefaultCurrencySymbol, } from "./core/baseline-resolver";
-export { GlobalError, type GlobalErrorProps, ErrorView, type ErrorViewProps, NotFoundView, type NotFoundViewProps, UnauthorizedView, type UnauthorizedViewProps, } from "./next/index";
-export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES, DEFAULT_ROUTE_MAP, createRouteMap, type RouteMap, type RoutePath, } from "./next/routing/route-map";
-export { getSearchParams, getOptionalSessionCookie, getRequiredSessionCookie, getBooleanParam, getStringParam, getNumberParam, } from "./next/request-helpers";
+export { registerClientAuthProvider, getClientAuthProvider, type IClientAuthProvider, } from "./contracts/client-auth";
+export { registerClientRealtimeProvider, getClientRealtimeProvider, type IClientRealtimeProvider, type RealtimeSnapshot, type Unsubscribe, } from "./contracts/client-realtime";
+export { registerClientSessionAdapter, getClientSessionAdapter, type IClientSessionAdapter, type AdapterAuthUser, type AuthUnsubscribe, } from "./contracts/client-session";
+export { ConfirmDeleteModal } from "./ui/components/ConfirmDeleteModal";
+export { Drawer } from "./ui/components/Drawer";
+export { FilterDrawer } from "./ui/components/FilterDrawer";
+export { Modal } from "./ui/components/Modal";
+export { SideDrawer } from "./ui/components/SideDrawer";
+export { SideModal } from "./ui/components/SideModal";
+export { UnsavedChangesModal } from "./ui/components/UnsavedChangesModal";
+export { useToast } from "./ui/components/Toast";
+export { useAuth } from "./react/contexts/SessionContext";
+export { useCamera } from "./react/hooks/useCamera";
+export { useClickOutside } from "./react/hooks/useClickOutside";
+export { useContainerGrid } from "./react/hooks/useContainerGrid";
+export { useGesture } from "./react/hooks/useGesture";
+export { useKeyPress } from "./react/hooks/useKeyPress";
+export { useMediaQuery } from "./react/hooks/useMediaQuery";
+export { usePullToRefresh } from "./react/hooks/usePullToRefresh";
+export { useSwipe } from "./react/hooks/useSwipe";
+export { useTheme } from "./react/contexts/ThemeContext";
+export { useUnsavedChanges } from "./react/hooks/useUnsavedChanges";
+export { useVisibleItems } from "./react/hooks/useVisibleItems";
+export { FirebaseClientAuthProvider } from "./providers/firebase-client/index";
+export { FirebaseClientRealtimeProvider } from "./providers/firebase-client/index";
+export { EventFormDrawer, EventParticipateView } from "./features/events/index";
+export type { EventParticipateViewProps } from "./features/events/index";
+export { BottomSheet } from "./features/layout/index";
+export { ImageCropModal } from "./features/media/index";
+export { VideoTrimModal } from "./features/media/index";
+export { useMediaAbort } from "./features/media/index";
+export { useMediaCleanup } from "./features/media/index";
+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 type { SessionProviderProps } from "./react/contexts/SessionContext";
+export { ThemeProvider } from "./react/contexts/ThemeContext";
+export { useUrlTable } from "./react/hooks/useUrlTable";
+export type { UseUrlTableOptions } from "./react/hooks/useUrlTable";
+export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "./constants/index";
+export { Container, Grid, Row, Stack } from "./ui/components/Layout";
+export { Div } from "./ui/components/Div";
+export { Main, Section } from "./ui/components/Semantic";
+export { Badge } from "./ui/components/Badge";
+export { Button } from "./ui/components/Button";
+export { Checkbox } from "./ui/components/Checkbox";
+export { Input } from "./ui/components/Input";
+export { Heading } from "./ui/components/Typography";
+export { Label, Text } from "./ui/components/Typography";
+export { Textarea } from "./ui/components/Textarea";
+export { GlobalError } from "./next/components/GlobalError";
+export { AppLayoutShell, LocaleSwitcher, useDashboardNav, BottomActionsProvider, DashboardNavProvider, LayoutClient } from "./features/layout/index";
+export type { AppLayoutShellProps, DashboardNavState, MainNavbarItem, LayoutClientProps } from "./features/layout/index";
+export { Search } from "./features/search/components";
+export type { SearchLabels, SearchProps, SearchQuickLink, SearchRouterAdapter } from "./features/search/components";
+export { ToastProvider, SkipToMain, NavigationLoader } from "./ui/index";
+export type { NavigationLoaderProps } from "./ui/index";
+export { ZodSetup } from "./validation/ZodSetup";
+export type { ZodSetupProps } from "./validation/ZodSetup";
+export { AdminSidebar } from "./features/admin/components/AdminSidebar";
+export { AdminDashboardView, AdminAnalyticsView } from "./features/admin/index";
+export type { AdminDashboardViewProps, AdminAnalyticsViewProps, AdminAnalyticsViewLabels } from "./features/admin/index";
+export { UserSidebar } from "./features/account/components/UserSidebar";
+export type { UserSidebarProps, UserNavItem } from "./features/account/components/UserSidebar";
+export { NotificationBell } from "./features/account/components/NotificationBell";
+export { ProtectedRoute, AuthStatusPanel, ForgotPasswordView, LoginForm, RegisterForm, ResetPasswordView, VerifyEmailView } from "./features/auth/index";
+export type { AuthGuardUser, ForgotPasswordViewProps, LoginFormProps, LoginFormValues, RegisterFormProps, RegisterFormValues, ResetPasswordViewProps, VerifyEmailViewProps, } from "./features/auth/index";
+export { useLogout, useLogin, useGoogleLogin, useRegister, useForgotPassword, useResetPassword, useVerifyEmail } from "./features/auth/index";
+export type { LoginCredentials, RegisterData, ForgotPasswordData, ResetPasswordData, VerifyEmailData } from "./features/auth/index";
+export { CartView, CartItemRow, CartSummary, CartDrawer, CheckoutView, CheckoutSuccessView, CheckoutAddressStep, useGuestCart, useCartCount, useAddToCart, useCart, useGuestCartMerge, useCartQuery } from "./features/cart/index";
+export type { CartItem, CartItemMeta, CartData, GuestCartItem } from "./features/cart/index";
+export { useAddresses } from "./features/account/index";
+export type { Address, AddressFormData } from "./features/account/index";
+export { CategoryProductsView, CategoriesListView } from "./features/categories/index";
+export type { CategoryItem } from "./features/categories/index";
+export { MediaImage } from "./features/media/index";
+export { ReviewsListView } from "./features/reviews/index";
+export { SellerSidebar } from "./features/seller/components/SellerSidebar";
+export type { SellerNavItem } from "./features/seller/components/SellerSidebar";
+export { StoreProductsView } from "./features/stores/index";
+export type { StoreProductItem } from "./features/stores/index";
+export { AdSlot } from "./features/homepage/components/AdSlot";
+export { registerAdSlot, registerAdSlots, unregisterAdSlot, clearAdRegistry, setAdConsentGranted, isAdConsentGranted, isAdSlotRenderable, } from "./features/homepage/ad-registry";
+export type { AdSlotId, AdProvider, AdSlotConfig } from "./features/homepage/ad-registry";
+export { WishlistView } from "./features/wishlist/index";
+export type { WishlistViewProps } from "./features/wishlist/index";
+export { InteractiveProductCard } from "./features/products/index";
+export type { InteractiveProductCardProps } from "./features/products/index";
+export { SellerDashboardView, useSellerDashboard } from "./features/seller/index";
+export type { SellerDashboardViewProps } from "./features/seller/index";
+export { UserAccountHubView, UserOrdersView } from "./features/account/index";
+export type { UserAccountHubViewProps, UserAccountHubViewLabels, UserOrdersViewProps, UserOrdersViewLabels } from "./features/account/index";
+export { useOrders, OrdersList } from "./features/orders/index";
+export { useCouponValidate } from "./features/promotions/hooks/useCouponValidate";

package/dist/client.js

@@ -1,15 +1,143 @@
-export * from "./ui/index";
-export * from "./react/index";
-export * from "./tokens/index";
-export * from "./values/index";
-export * from "./utils/index";
-export * from "./constants/index";
-export * from "./contracts/index";
-export * from "./validation/index";
-export * from "./errors/index";
-export * from "./seo/index";
-export * from "./cli/index";
-export { getMarketProfile, getDefaultCurrency, getDefaultLocale, getDefaultCountry, getDefaultPhonePrefix, getDefaultTimezone, getDefaultCurrencySymbol, } from "./core/baseline-resolver";
-export { GlobalError, ErrorView, NotFoundView, UnauthorizedView, } from "./next/index";
-export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES, DEFAULT_ROUTE_MAP, createRouteMap, } from "./next/routing/route-map";
-export { getSearchParams, getOptionalSessionCookie, getRequiredSessionCookie, getBooleanParam, getStringParam, getNumberParam, } from "./next/request-helpers";
+"use client";
+// Client-only public exports
+// Provider registration — pure contract modules with zero server dependencies.
+// Exported here so consumers can import registration functions from
+// @mohasinac/appkit/client without pulling in firebase-admin or other server code.
+export { registerClientAuthProvider, getClientAuthProvider, } from "./contracts/client-auth";
+export { registerClientRealtimeProvider, getClientRealtimeProvider, } from "./contracts/client-realtime";
+export { registerClientSessionAdapter, getClientSessionAdapter, } from "./contracts/client-session";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// ConfirmDeleteModal - Component for confirm delete modal.
+export { ConfirmDeleteModal } from "./ui/components/ConfirmDeleteModal";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// Drawer - Component for drawer.
+export { Drawer } from "./ui/components/Drawer";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// FilterDrawer - Component for filter drawer.
+export { FilterDrawer } from "./ui/components/FilterDrawer";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// Modal - Component for modal.
+export { Modal } from "./ui/components/Modal";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// SideDrawer - Component for side drawer.
+export { SideDrawer } from "./ui/components/SideDrawer";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// SideModal - Component for side modal.
+export { SideModal } from "./ui/components/SideModal";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// UnsavedChangesModal - Component for unsaved changes modal.
+export { UnsavedChangesModal } from "./ui/components/UnsavedChangesModal";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useToast - React hook for use toast.
+export { useToast } from "./ui/components/Toast";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useAuth - React hook for use auth.
+export { useAuth } from "./react/contexts/SessionContext";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useCamera - React hook for use camera.
+export { useCamera } from "./react/hooks/useCamera";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useClickOutside - React hook for use click outside.
+export { useClickOutside } from "./react/hooks/useClickOutside";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useContainerGrid - React hook for use container grid.
+export { useContainerGrid } from "./react/hooks/useContainerGrid";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useGesture - React hook for use gesture.
+export { useGesture } from "./react/hooks/useGesture";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useKeyPress - React hook for use key press.
+export { useKeyPress } from "./react/hooks/useKeyPress";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useMediaQuery - React hook for use media query.
+export { useMediaQuery } from "./react/hooks/useMediaQuery";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// usePullToRefresh - React hook for use pull to refresh.
+export { usePullToRefresh } from "./react/hooks/usePullToRefresh";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useSwipe - React hook for use swipe.
+export { useSwipe } from "./react/hooks/useSwipe";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useTheme - React hook for use theme.
+export { useTheme } from "./react/contexts/ThemeContext";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useUnsavedChanges - React hook for use unsaved changes.
+export { useUnsavedChanges } from "./react/hooks/useUnsavedChanges";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useVisibleItems - React hook for use visible items.
+export { useVisibleItems } from "./react/hooks/useVisibleItems";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// FirebaseClientAuthProvider - Component for firebase client auth provider.
+export { FirebaseClientAuthProvider } from "./providers/firebase-client/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// FirebaseClientRealtimeProvider - Component for firebase client realtime provider.
+export { FirebaseClientRealtimeProvider } from "./providers/firebase-client/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// EventFormDrawer - Component for event form drawer.
+export { EventFormDrawer, EventParticipateView } from "./features/events/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// BottomSheet - Shared export for bottom sheet.
+export { BottomSheet } from "./features/layout/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// ImageCropModal - Component for image crop modal.
+export { ImageCropModal } from "./features/media/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// VideoTrimModal - Component for video trim modal.
+export { VideoTrimModal } from "./features/media/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useMediaAbort - React hook for use media abort.
+export { useMediaAbort } from "./features/media/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useMediaCleanup - React hook for use media cleanup.
+export { useMediaCleanup } from "./features/media/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useMediaCrop - React hook for use media crop.
+export { useMediaCrop } from "./features/media/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useMediaTrim - React hook for use media trim.
+export { useMediaTrim } from "./features/media/index";
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
+// useMediaUpload - React hook for use media upload.
+export { useMediaUpload } from "./features/media/index";
+// Client-side context providers
+export { SessionProvider, useSession } from "./react/contexts/SessionContext";
+export { ThemeProvider } from "./react/contexts/ThemeContext";
+export { useUrlTable } from "./react/hooks/useUrlTable";
+// Client-safe constants, UI primitives, and views
+export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "./constants/index";
+export { Container, Grid, Row, Stack } from "./ui/components/Layout";
+export { Div } from "./ui/components/Div";
+export { Main, Section } from "./ui/components/Semantic";
+export { Badge } from "./ui/components/Badge";
+export { Button } from "./ui/components/Button";
+export { Checkbox } from "./ui/components/Checkbox";
+export { Input } from "./ui/components/Input";
+export { Heading } from "./ui/components/Typography";
+export { Label, Text } from "./ui/components/Typography";
+export { Textarea } from "./ui/components/Textarea";
+export { GlobalError } from "./next/components/GlobalError";
+export { AppLayoutShell, LocaleSwitcher, useDashboardNav, BottomActionsProvider, DashboardNavProvider, LayoutClient } from "./features/layout/index";
+export { Search } from "./features/search/components";
+export { ToastProvider, SkipToMain, NavigationLoader } from "./ui/index";
+export { ZodSetup } from "./validation/ZodSetup";
+export { AdminSidebar } from "./features/admin/components/AdminSidebar";
+export { AdminDashboardView, AdminAnalyticsView } from "./features/admin/index";
+export { UserSidebar } from "./features/account/components/UserSidebar";
+export { NotificationBell } from "./features/account/components/NotificationBell";
+export { ProtectedRoute, AuthStatusPanel, ForgotPasswordView, LoginForm, RegisterForm, ResetPasswordView, VerifyEmailView } from "./features/auth/index";
+export { useLogout, useLogin, useGoogleLogin, useRegister, useForgotPassword, useResetPassword, useVerifyEmail } from "./features/auth/index";
+export { CartView, CartItemRow, CartSummary, CartDrawer, CheckoutView, CheckoutSuccessView, CheckoutAddressStep, useGuestCart, useCartCount, useAddToCart, useCart, useGuestCartMerge, useCartQuery } from "./features/cart/index";
+export { useAddresses } from "./features/account/index";
+export { CategoryProductsView, CategoriesListView } from "./features/categories/index";
+export { MediaImage } from "./features/media/index";
+export { ReviewsListView } from "./features/reviews/index";
+export { SellerSidebar } from "./features/seller/components/SellerSidebar";
+export { StoreProductsView } from "./features/stores/index";
+export { AdSlot } from "./features/homepage/components/AdSlot";
+export { registerAdSlot, registerAdSlots, unregisterAdSlot, clearAdRegistry, setAdConsentGranted, isAdConsentGranted, isAdSlotRenderable, } from "./features/homepage/ad-registry";
+export { WishlistView } from "./features/wishlist/index";
+export { InteractiveProductCard } from "./features/products/index";
+export { SellerDashboardView, useSellerDashboard } from "./features/seller/index";
+export { UserAccountHubView, UserOrdersView } from "./features/account/index";
+export { useOrders, OrdersList } from "./features/orders/index";
+export { useCouponValidate } from "./features/promotions/hooks/useCouponValidate";

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

@@ -49,11 +49,28 @@ export declare const SITE_SETTINGS_ENDPOINTS: {
 };
 export declare const ADMIN_ENDPOINTS: {
     readonly STATS: "/api/admin/stats";
+    readonly DASHBOARD: "/api/admin/dashboard";
+    readonly ANALYTICS: "/api/admin/analytics";
+    readonly ADS: "/api/admin/ads";
+    readonly AD_BY_ID: (id: string) => string;
     readonly REALTIME_TOKEN: "/api/realtime/token";
     readonly PAYMENTS_SETTINGS: "/api/admin/payments/settings";
+    readonly PRODUCTS: "/api/admin/products";
+    readonly ORDERS: "/api/admin/orders";
+    readonly USERS: "/api/admin/users";
+    readonly REVIEWS: "/api/admin/reviews";
+    readonly BIDS: "/api/admin/bids";
     readonly BLOG: "/api/admin/blog";
+    readonly CATEGORIES: "/api/admin/categories";
+    readonly FAQS: "/api/admin/faqs";
+    readonly STORES: "/api/admin/stores";
+    readonly PAYOUTS: "/api/admin/payouts";
     readonly EVENTS: "/api/admin/events";
+    readonly EVENT_STATS: (id: string) => string;
+    readonly EVENT_ENTRIES: (id: string) => string;
+    readonly EVENT_ENTRY_BY_ID: (eventId: string, entryId: string) => string;
     readonly COUPONS: "/api/admin/coupons";
+    readonly SECTIONS: "/api/admin/sections";
 };
 export declare const CHAT_ENDPOINTS: {
     readonly LIST: "/api/chat";
@@ -159,6 +176,12 @@ export declare const SEARCH_ENDPOINTS: {
 };
 export declare const SELLER_ENDPOINTS: {
     readonly BECOME: "/api/seller/become";
+    readonly PRODUCTS: "/api/seller/products";
+    readonly ORDERS: "/api/seller/orders";
+    readonly ORDERS_BY_ID: (orderId: string) => string;
+    readonly AUCTIONS: "/api/seller/auctions";
+    readonly COUPONS: "/api/seller/coupons";
+    readonly OFFERS: "/api/seller/offers";
     readonly PAYOUTS: "/api/seller/payouts";
     readonly PAYOUT_SETTINGS: "/api/seller/payout-settings";
     readonly STORE: "/api/seller/store";
@@ -239,11 +262,28 @@ export declare const API_ENDPOINTS: {
     };
     readonly ADMIN: {
         readonly STATS: "/api/admin/stats";
+        readonly DASHBOARD: "/api/admin/dashboard";
+        readonly ANALYTICS: "/api/admin/analytics";
+        readonly ADS: "/api/admin/ads";
+        readonly AD_BY_ID: (id: string) => string;
         readonly REALTIME_TOKEN: "/api/realtime/token";
         readonly PAYMENTS_SETTINGS: "/api/admin/payments/settings";
+        readonly PRODUCTS: "/api/admin/products";
+        readonly ORDERS: "/api/admin/orders";
+        readonly USERS: "/api/admin/users";
+        readonly REVIEWS: "/api/admin/reviews";
+        readonly BIDS: "/api/admin/bids";
         readonly BLOG: "/api/admin/blog";
+        readonly CATEGORIES: "/api/admin/categories";
+        readonly FAQS: "/api/admin/faqs";
+        readonly STORES: "/api/admin/stores";
+        readonly PAYOUTS: "/api/admin/payouts";
         readonly EVENTS: "/api/admin/events";
+        readonly EVENT_STATS: (id: string) => string;
+        readonly EVENT_ENTRIES: (id: string) => string;
+        readonly EVENT_ENTRY_BY_ID: (eventId: string, entryId: string) => string;
         readonly COUPONS: "/api/admin/coupons";
+        readonly SECTIONS: "/api/admin/sections";
     };
     readonly CHAT: {
         readonly LIST: "/api/chat";
@@ -352,6 +392,12 @@ export declare const API_ENDPOINTS: {
     };
     readonly SELLER: {
         readonly BECOME: "/api/seller/become";
+        readonly PRODUCTS: "/api/seller/products";
+        readonly ORDERS: "/api/seller/orders";
+        readonly ORDERS_BY_ID: (orderId: string) => string;
+        readonly AUCTIONS: "/api/seller/auctions";
+        readonly COUPONS: "/api/seller/coupons";
+        readonly OFFERS: "/api/seller/offers";
         readonly PAYOUTS: "/api/seller/payouts";
         readonly PAYOUT_SETTINGS: "/api/seller/payout-settings";
         readonly STORE: "/api/seller/store";

package/dist/constants/api-endpoints.js

@@ -67,11 +67,28 @@ export const SITE_SETTINGS_ENDPOINTS = {
 // ---------------------------------------------------------------------------
 export const ADMIN_ENDPOINTS = {
     STATS: "/api/admin/stats",
+    DASHBOARD: "/api/admin/dashboard",
+    ANALYTICS: "/api/admin/analytics",
+    ADS: "/api/admin/ads",
+    AD_BY_ID: (id) => `/api/admin/ads/${id}`,
     REALTIME_TOKEN: "/api/realtime/token",
     PAYMENTS_SETTINGS: "/api/admin/payments/settings",
+    PRODUCTS: "/api/admin/products",
+    ORDERS: "/api/admin/orders",
+    USERS: "/api/admin/users",
+    REVIEWS: "/api/admin/reviews",
+    BIDS: "/api/admin/bids",
     BLOG: "/api/admin/blog",
+    CATEGORIES: "/api/admin/categories",
+    FAQS: "/api/admin/faqs",
+    STORES: "/api/admin/stores",
+    PAYOUTS: "/api/admin/payouts",
     EVENTS: "/api/admin/events",
+    EVENT_STATS: (id) => `/api/admin/events/${id}/stats`,
+    EVENT_ENTRIES: (id) => `/api/admin/events/${id}/entries`,
+    EVENT_ENTRY_BY_ID: (eventId, entryId) => `/api/admin/events/${eventId}/entries/${entryId}`,
     COUPONS: "/api/admin/coupons",
+    SECTIONS: "/api/admin/sections",
 };
 // ---------------------------------------------------------------------------
 // Chat
@@ -246,6 +263,12 @@ export const SEARCH_ENDPOINTS = {
 // ---------------------------------------------------------------------------
 export const SELLER_ENDPOINTS = {
     BECOME: "/api/seller/become",
+    PRODUCTS: "/api/seller/products",
+    ORDERS: "/api/seller/orders",
+    ORDERS_BY_ID: (orderId) => `/api/seller/orders/${orderId}`,
+    AUCTIONS: "/api/seller/auctions",
+    COUPONS: "/api/seller/coupons",
+    OFFERS: "/api/seller/offers",
     PAYOUTS: "/api/seller/payouts",
     PAYOUT_SETTINGS: "/api/seller/payout-settings",
     STORE: "/api/seller/store",

package/dist/constants/index.d.ts

@@ -12,3 +12,4 @@
 export { API_ENDPOINTS, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, CHAT_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, COPILOT_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_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, DEMO_ENDPOINTS, } from "./api-endpoints";
 export { COLLECTION_CACHE_PATHS } from "./cache-invalidation";
 export { resolveEndpoint, resolveEndpointFn } from "./api-endpoint-resolver";
+export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "../next/routing/route-map";

package/dist/constants/index.js

@@ -12,3 +12,4 @@
 export { API_ENDPOINTS, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, CHAT_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, COPILOT_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_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, DEMO_ENDPOINTS, } from "./api-endpoints";
 export { COLLECTION_CACHE_PATHS } from "./cache-invalidation";
 export { resolveEndpoint, resolveEndpointFn } from "./api-endpoint-resolver";
+export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "../next/routing/route-map";

package/dist/contracts/auth.js

@@ -1,2 +1,2 @@
-// ─── Auth Shared Types ────────────────────────────────────────────────────────
+// --- Auth Shared Types --------------------------------------------------------
 export {};

package/dist/contracts/client-auth.js

@@ -4,7 +4,7 @@
  * Abstracts client-side authentication operations so hooks
  * never import a specific auth SDK directly.
  */
-// ─── Runtime registry ──────────────────────────────────────────────────────
+// --- Runtime registry ------------------------------------------------------
 let _provider = null;
 export function registerClientAuthProvider(provider) {
     _provider = provider;

package/dist/contracts/client-payment-gateway.js

@@ -7,7 +7,7 @@
  *
  * Implementations: Razorpay, Stripe, PayPal, etc.
  */
-// ─── Runtime Registry ──────────────────────────────────────────────────────
+// --- Runtime Registry ------------------------------------------------------
 const _gateways = new Map();
 export function registerClientPaymentGateway(adapter) {
     _gateways.set(adapter.gateway, adapter);

package/dist/contracts/client-realtime.js

@@ -5,7 +5,7 @@
  * Register a concrete implementation (Firebase, Supabase, Ably, etc.)
  * via `registerClientRealtimeProvider()`.
  */
-// ─── Runtime registry ──────────────────────────────────────────────────────
+// --- Runtime registry ------------------------------------------------------
 let _provider = null;
 export function registerClientRealtimeProvider(provider) {
     _provider = provider;