@mohasinac/appkit 2.2.0 → 2.3.1

package/dist/contracts/client-session.js

@@ -10,13 +10,25 @@
 // Runtime registry (same pattern as IClientAuthProvider / IClientRealtimeProvider)
 // ---------------------------------------------------------------------------
 let _adapter = null;
+/**
+ * No-op guest adapter used when no real adapter has been registered.
+ * Allows SessionProvider to render in "not signed in" mode without crashing.
+ */
+const GUEST_ADAPTER = {
+    onAuthStateChanged(callback) {
+        callback(null);
+        return () => { };
+    },
+    getCurrentUser() {
+        return null;
+    },
+    signOut() {
+        return Promise.resolve();
+    },
+};
 export function registerClientSessionAdapter(adapter) {
     _adapter = adapter;
 }
 export function getClientSessionAdapter() {
-    if (!_adapter) {
-        throw new Error("Client session adapter not registered. " +
-            "Call registerClientSessionAdapter() before using SessionProvider.");
-    }
-    return _adapter;
+    return _adapter ?? GUEST_ADAPTER;
 }

package/dist/contracts/config.js

@@ -1,2 +1,2 @@
-// ─── Site Config ─────────────────────────────────────────────────────────────
+// --- Site Config -------------------------------------------------------------
 export {};

package/dist/contracts/email.js

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

package/dist/contracts/feature.js

@@ -1,2 +1,2 @@
-// ─── Feature Manifest ─────────────────────────────────────────────────────────
+// --- Feature Manifest ---------------------------------------------------------
 export {};

package/dist/contracts/field-ops.js

@@ -6,7 +6,7 @@
  * The active DB provider registers its concrete implementations
  * at startup via `registerFieldOps()`.
  */
-// ─── Runtime registry ──────────────────────────────────────────────────────
+// --- Runtime registry ------------------------------------------------------
 let _ops = null;
 export function registerFieldOps(ops) {
     _ops = ops;
@@ -17,7 +17,7 @@ function getOps() {
     }
     return _ops;
 }
-// ─── Public helpers (used by feature repositories) ─────────────────────────
+// --- Public helpers (used by feature repositories) -------------------------
 export function serverTimestamp() {
     return getOps().serverTimestamp();
 }

package/dist/contracts/form.js

@@ -38,7 +38,7 @@
  * />
  * ```
  */
-// ─── Global registry ──────────────────────────────────────────────────────────
+// --- Global registry ----------------------------------------------------------
 const _fieldRegistry = new Map();
 /**
  * Register extra fields for a specific form by its form key (e.g. `"product"`,

package/dist/contracts/infra.js

@@ -1,2 +1,2 @@
-// ─── Infra Interfaces ─────────────────────────────────────────────────────────
+// --- Infra Interfaces ---------------------------------------------------------
 export {};

package/dist/contracts/payment.js

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

package/dist/contracts/repository.js

@@ -1,6 +1,6 @@
-// ─── Repository Interfaces ────────────────────────────────────────────────────
+// --- Repository Interfaces ----------------------------------------------------
 // Segregated per ISP: features that only read never depend on IWriteRepository.
-// ─── Global hooks registry ────────────────────────────────────────────────────
+// --- Global hooks registry ----------------------------------------------------
 const _hooksRegistry = new Map();
 /**
  * Register lifecycle hooks for a specific Firestore collection (or any

package/dist/contracts/search.js

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

package/dist/contracts/shipping.js

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

package/dist/contracts/storage.js

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

package/dist/contracts/style.js

@@ -1,2 +1,2 @@
-// ─── Style Adapter Interface ──────────────────────────────────────────────────
+// --- Style Adapter Interface --------------------------------------------------
 export {};

package/dist/core/hooks/useSiteSettings.js

@@ -1,4 +1,3 @@
-"use client";
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../http";
 import { SITE_SETTINGS_ENDPOINTS } from "../../constants/api-endpoints";

package/dist/core/index.d.ts

@@ -30,5 +30,6 @@ export type { ActionResult, ActionMiddleware, ActionMiddlewareContext, ServerAct
 export { MUTATION_EVENTS, emitMutation, onMutation, inferMutationEvent, } from "./mutation-events";
 export type { MutationEventPayload } from "./mutation-events";
 export type { ResolvedKeys } from "./integration-keys";
+export { invalidateIntegrationKeysCache } from "./integration-keys";
 export { configureMarketDefaults, resetMarketDefaults, getMarketProfile, getDefaultCurrency, getDefaultLocale, getDefaultCountry, getDefaultPhonePrefix, getDefaultTimezone, getDefaultCurrencySymbol, } from "./baseline-resolver";
 export type { MarketProfile } from "./baseline-resolver";

package/dist/core/index.js

@@ -18,4 +18,5 @@ export { subscribeNewsletter, } from "./newsletter-actions";
 export { unitOfWork } from "./unit-of-work";
 export { createServerAction, setActionMiddleware, _resetActionMiddleware, } from "./server-action";
 export { MUTATION_EVENTS, emitMutation, onMutation, inferMutationEvent, } from "./mutation-events";
+export { invalidateIntegrationKeysCache } from "./integration-keys";
 export { configureMarketDefaults, resetMarketDefaults, getMarketProfile, getDefaultCurrency, getDefaultLocale, getDefaultCountry, getDefaultPhonePrefix, getDefaultTimezone, getDefaultCurrencySymbol, } from "./baseline-resolver";

package/dist/core/integration-keys.d.ts

@@ -1,19 +1,3 @@
-/**
- * Integration Keys — Centralised Credential Resolver
- *
- * Server-only. Resolves all provider credentials with a two-tier priority:
- *   1. Firestore siteSettings.credentials (encrypted with AES-256-GCM)
- *   2. Environment variables (fallback for local dev / initial setup)
- *
- * Results are cached in process memory for 60 seconds so Firestore is not
- * hit on every API request. Call invalidateIntegrationKeysCache() after an
- * admin saves new credentials so the next request picks up the fresh values.
- *
- * Usage:
- *   const keys = await resolveKeys();
- *   const razorpay = new Razorpay({ key_id: keys.razorpayKeyId, key_secret: keys.razorpayKeySecret });
- */
-import "server-only";
 export interface ResolvedKeys {
     razorpayKeyId: string;
     razorpayKeySecret: string;

package/dist/core/integration-keys.js

@@ -13,7 +13,6 @@
  *   const keys = await resolveKeys();
  *   const razorpay = new Razorpay({ key_id: keys.razorpayKeyId, key_secret: keys.razorpayKeySecret });
  */
-import "server-only";
 import { siteSettingsRepository } from "../repositories";
 const EMPTY_KEYS = {
     razorpayKeyId: "",

package/dist/core/mutation-events.js

@@ -24,7 +24,7 @@
  * ```
  */
 import { eventBus } from "./EventBus";
-// ─── Typed event name registry ────────────────────────────────────────────────
+// --- Typed event name registry ------------------------------------------------
 /**
  * Canonical event name constants for all appkit feature mutations.
  * Use these when subscribing or emitting to ensure consistent naming.
@@ -109,7 +109,7 @@ export const MUTATION_EVENTS = {
         SETTLED: "appkit/auction/settled",
     },
 };
-// ─── Helpers ──────────────────────────────────────────────────────────────────
+// --- Helpers ------------------------------------------------------------------
 /**
  * Emit a typed mutation event on the shared `eventBus`.
  *

package/dist/core/server-action.js

@@ -59,7 +59,7 @@ export function _resetActionMiddleware() {
 export function createServerAction(options) {
     const actionName = options.name ?? options.handler.name ?? "anonymous";
     return async function serverAction(rawInput) {
-        // ── 1. Validate input ──────────────────────────────────────────────────
+        // -- 1. Validate input --------------------------------------------------
         let input = rawInput;
         if (options.schema) {
             const parsed = options.schema.safeParse(rawInput);
@@ -70,7 +70,7 @@ export function createServerAction(options) {
             input = parsed.data;
         }
         const ctx = { actionName, input };
-        // ── 2. Before hooks (global → per-action) ─────────────────────────────
+        // -- 2. Before hooks (global → per-action) -----------------------------
         try {
             await _globalMiddleware.beforeAction?.(ctx);
             await options.beforeAction?.(ctx);
@@ -78,7 +78,7 @@ export function createServerAction(options) {
         catch (err) {
             logger.error(`[createServerAction] beforeAction error in "${actionName}"`, { err });
         }
-        // ── 3. Run handler ─────────────────────────────────────────────────────
+        // -- 3. Run handler -----------------------------------------------------
         let result;
         try {
             const data = await options.handler({ input });
@@ -91,7 +91,7 @@ export function createServerAction(options) {
             });
             result = { ok: false, error: message };
         }
-        // ── 4. After hooks (per-action → global) ──────────────────────────────
+        // -- 4. After hooks (per-action → global) ------------------------------
         try {
             await options.afterAction?.({ ...ctx, result });
             await _globalMiddleware.afterAction?.({
@@ -102,7 +102,7 @@ export function createServerAction(options) {
         catch (err) {
             logger.error(`[createServerAction] afterAction error in "${actionName}"`, { err });
         }
-        // ── 5. Auto-emit mutation event ───────────────────────────────────────
+        // -- 5. Auto-emit mutation event ---------------------------------------
         if (result.ok) {
             const eventName = inferMutationEvent(actionName);
             if (eventName) {

package/dist/core/unit-of-work.d.ts

@@ -1,29 +1,28 @@
-import "server-only";
 import type { Transaction, WriteBatch } from "firebase-admin/firestore";
 export declare class UnitOfWork {
     private get db();
-    get users(): import("../repositories").UserRepository;
-    get addresses(): import("../repositories").AddressRepository;
+    get users(): import("..").UserRepository;
+    get addresses(): import("..").AddressRepository;
     get tokens(): {
-        email: import("../repositories").EmailVerificationTokenRepository;
-        password: import("../repositories").PasswordResetTokenRepository;
+        email: import("..").EmailVerificationTokenRepository;
+        password: import("..").PasswordResetTokenRepository;
         getExpiredEmailVerificationRefs(now: Date): Promise<FirebaseFirestore.DocumentReference[]>;
         getExpiredPasswordResetRefs(now: Date): Promise<FirebaseFirestore.DocumentReference[]>;
     };
-    get products(): import("../repositories").ProductRepository;
-    get orders(): import("../repositories").OrderRepository;
-    get reviews(): import("../repositories").ReviewRepository;
-    get sessions(): import("../repositories").SessionRepository;
+    get products(): import("..").ProductRepository;
+    get orders(): import("..").OrderRepository;
+    get reviews(): import("..").ReviewRepository;
+    get sessions(): import("..").SessionRepository;
     get bids(): import("../features/auctions/repository/bid.repository").BidRepository;
-    get carts(): import("../repositories").CartRepository;
+    get carts(): import("..").CartRepository;
     get siteSettings(): import("../features/admin/repository/site-settings.repository").SiteSettingsRepository;
     get carousel(): import("../features/homepage/repository/carousel.repository").CarouselRepository;
     get homepageSections(): import("../features/homepage/repository/homepage-sections.repository").HomepageSectionsRepository;
-    get categories(): import("../repositories").CategoriesRepository;
+    get categories(): import("..").CategoriesRepository;
     get coupons(): import("../features/promotions/repository/coupons.repository").CouponsRepository;
-    get faqs(): import("../repositories").FirebaseFAQsRepository;
-    get wishlists(): import("../server").UserWishlistRepository;
-    get blogs(): import("../repositories").BlogRepository;
+    get faqs(): import("..").FirebaseFAQsRepository;
+    get wishlists(): import("..").UserWishlistRepository;
+    get blogs(): import("..").BlogRepository;
     get payouts(): import("../features/payments/repository/payout.repository").PayoutRepository;
     get notifications(): import("../features/admin/repository/notification.repository").NotificationRepository;
     runTransaction<TResult>(fn: (tx: Transaction) => Promise<TResult>): Promise<TResult>;

package/dist/core/unit-of-work.js

@@ -1,4 +1,3 @@
-import "server-only";
 // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports
 const getAdminDb = () => module.require("../providers/db-firebase").getAdminDb();
 import { DatabaseError } from "../errors";

package/dist/errors/messages.d.ts

@@ -123,6 +123,7 @@ export declare const ERROR_MESSAGES: {
         readonly NOT_IMPLEMENTED: "This feature is not yet implemented";
         readonly TRY_AGAIN: "Something went wrong. Please try again in a moment.";
         readonly RATE_LIMIT_EXCEEDED: "Too many requests. Please try again later.";
+        readonly UNSAVED_CHANGES: "You have unsaved changes. Leave without saving?";
     };
     readonly NETWORK: {
         readonly OFFLINE: "You appear to be offline. Check your connection and try again.";

package/dist/errors/messages.js

@@ -130,6 +130,7 @@ export const ERROR_MESSAGES = {
         NOT_IMPLEMENTED: "This feature is not yet implemented",
         TRY_AGAIN: "Something went wrong. Please try again in a moment.",
         RATE_LIMIT_EXCEEDED: "Too many requests. Please try again later.",
+        UNSAVED_CHANGES: "You have unsaved changes. Leave without saving?",
     },
     // Network Errors
     NETWORK: {

package/dist/features/about/components/AboutView.d.ts

@@ -15,21 +15,21 @@ export interface AboutMilestone {
     text: string;
 }
 export interface AboutViewProps {
-    labels: {
-        title: string;
-        subtitle: string;
-        missionTitle: string;
-        missionText: string;
-        howItWorksTitle: string;
-        valuesTitle: string;
-        milestonesTitle: string;
-        ctaTitle: string;
-        ctaSell: string;
-        ctaShop: string;
+    labels?: {
+        title?: string;
+        subtitle?: string;
+        missionTitle?: string;
+        missionText?: string;
+        howItWorksTitle?: string;
+        valuesTitle?: string;
+        milestonesTitle?: string;
+        ctaTitle?: string;
+        ctaSell?: string;
+        ctaShop?: string;
     };
-    howItems: AboutHowItem[];
-    valueItems: AboutValueItem[];
-    milestones: AboutMilestone[];
+    howItems?: AboutHowItem[];
+    valueItems?: AboutValueItem[];
+    milestones?: AboutMilestone[];
     heroBannerClass?: string;
     ctaBannerClass?: string;
     /** Render the CTA action buttons  */

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

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Heading, Section, Span, Text } from "../../../ui";
-export function AboutView({ labels, howItems, valueItems, milestones, heroBannerClass = "bg-gradient-to-br from-violet-600 to-indigo-600", ctaBannerClass = "bg-gradient-to-br from-violet-600 to-indigo-600", renderCtaButtons, }) {
-    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-16 md:py-20 lg:py-24`, children: _jsxs("div", { className: "max-w-4xl mx-auto px-4 sm:px-6 lg:px-8 text-center", children: [_jsx(Heading, { level: 1, variant: "none", className: "text-4xl md:text-5xl font-bold mb-6 text-white", children: labels.title }), _jsx(Text, { variant: "none", className: "text-xl text-white/80 max-w-2xl mx-auto", children: labels.subtitle })] }) }), _jsxs("div", { className: "max-w-5xl mx-auto px-4 sm:px-6 lg:px-8 py-16 md:py-20 space-y-16 md:space-y-20", children: [_jsxs(Section, { className: "text-center max-w-3xl mx-auto", children: [_jsx(Heading, { level: 2, className: "mb-4", children: labels.missionTitle }), _jsx(Text, { size: "lg", variant: "secondary", className: "leading-relaxed", children: labels.missionText })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-12", children: labels.howItWorksTitle }), _jsx("div", { className: "grid md:grid-cols-3 gap-6 md:gap-8", children: howItems.map(({ title, text, icon, color }) => (_jsxs("div", { className: `bg-gradient-to-br ${color ?? "from-primary/5 to-primary/5"} rounded-2xl p-6 space-y-3`, children: [_jsx("div", { className: "text-4xl", children: icon }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-12", children: labels.valuesTitle }), _jsx("div", { className: "grid md:grid-cols-3 gap-5 md:gap-6", children: valueItems.map(({ title, text, icon }) => (_jsxs("div", { className: "bg-white dark:bg-slate-800 rounded-xl p-6 space-y-3 border border-neutral-200 dark:border-slate-700", children: [_jsx("div", { className: "text-3xl", children: icon }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-10", children: labels.milestonesTitle }), _jsx("div", { className: "relative border-l-2 border-primary/30 pl-8 space-y-8 max-w-2xl mx-auto", children: milestones.map(({ year, text }) => (_jsxs("div", { className: "relative", children: [_jsx("div", { className: "absolute -left-10 top-1 w-4 h-4 rounded-full bg-primary border-2 border-white dark:border-slate-900" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary uppercase tracking-wide", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] }), _jsxs(Section, { className: `text-center ${ctaBannerClass} rounded-2xl p-8 md:p-12 text-white`, children: [_jsx(Heading, { level: 2, variant: "none", className: "text-3xl font-bold mb-8 text-white", children: labels.ctaTitle }), renderCtaButtons ? (renderCtaButtons()) : (_jsx("div", { className: "flex justify-center gap-3 flex-wrap", children: _jsxs(Span, { className: "text-white/70 text-sm", children: [labels.ctaSell, " \u00B7 ", labels.ctaShop] }) }))] })] })] }));
+export function AboutView({ labels = {}, howItems = [], valueItems = [], milestones = [], heroBannerClass = "bg-gradient-to-br from-violet-600 to-indigo-600", ctaBannerClass = "bg-gradient-to-br from-violet-600 to-indigo-600", renderCtaButtons, }) {
+    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", "data-section": "aboutview-div-81", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-16 md:py-20 lg:py-24`, children: _jsxs("div", { className: "max-w-4xl mx-auto px-4 sm:px-6 lg:px-8 text-center", "data-section": "aboutview-div-82", children: [_jsx(Heading, { level: 1, variant: "none", className: "text-4xl md:text-5xl font-bold mb-6 text-white", children: labels.title }), _jsx(Text, { variant: "none", className: "text-xl text-white/80 max-w-2xl mx-auto", children: labels.subtitle })] }) }), _jsxs("div", { className: "max-w-5xl mx-auto px-4 sm:px-6 lg:px-8 py-16 md:py-20 space-y-16 md:space-y-20", "data-section": "aboutview-div-83", children: [_jsxs(Section, { className: "text-center max-w-3xl mx-auto", children: [_jsx(Heading, { level: 2, className: "mb-4", children: labels.missionTitle }), _jsx(Text, { size: "lg", variant: "secondary", className: "leading-relaxed", children: labels.missionText })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-12", children: labels.howItWorksTitle }), _jsx("div", { className: "grid md:grid-cols-3 gap-6 md:gap-8", "data-section": "aboutview-div-84", children: howItems.map(({ title, text, icon, color }) => (_jsxs("div", { className: `bg-gradient-to-br ${color ?? "from-primary/5 to-primary/5"} rounded-2xl p-6 space-y-3`, "data-section": "aboutview-div-85", children: [_jsx("div", { className: "text-4xl", "data-section": "aboutview-div-86", children: icon }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-12", children: labels.valuesTitle }), _jsx("div", { className: "grid md:grid-cols-3 gap-5 md:gap-6", "data-section": "aboutview-div-87", children: valueItems.map(({ title, text, icon }) => (_jsxs("div", { className: "bg-white dark:bg-slate-800 rounded-xl p-6 space-y-3 border border-neutral-200 dark:border-slate-700", "data-section": "aboutview-div-88", children: [_jsx("div", { className: "text-3xl", "data-section": "aboutview-div-89", children: icon }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-10", children: labels.milestonesTitle }), _jsx("div", { className: "relative border-l-2 border-primary/30 pl-8 space-y-8 max-w-2xl mx-auto", "data-section": "aboutview-div-90", children: milestones.map(({ year, text }) => (_jsxs("div", { className: "relative", "data-section": "aboutview-div-91", children: [_jsx("div", { className: "absolute -left-10 top-1 w-4 h-4 rounded-full bg-primary border-2 border-white dark:border-slate-900" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary uppercase tracking-wide", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] }), _jsxs(Section, { className: `text-center ${ctaBannerClass} rounded-2xl p-8 md:p-12 text-white`, children: [_jsx(Heading, { level: 2, variant: "none", className: "text-3xl font-bold mb-8 text-white", children: labels.ctaTitle }), renderCtaButtons ? (renderCtaButtons()) : (_jsx("div", { className: "flex justify-center gap-3 flex-wrap", "data-section": "aboutview-div-92", children: _jsxs(Span, { className: "text-white/70 text-sm", children: [labels.ctaSell, " \u00B7 ", labels.ctaShop] }) }))] })] })] }));
 }

package/dist/features/about/components/FAQPageView.d.ts

@@ -0,0 +1,6 @@
+export interface FAQPageViewProps {
+    /** If provided, filter to this category slug */
+    category?: string;
+    heroBannerClass?: string;
+}
+export declare function FAQPageView({ category, heroBannerClass, }?: FAQPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;

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

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ROUTES } from "../../../constants";
+import { THEME_CONSTANTS } from "../../../tokens";
+import { Heading, Text, Section, Stack } from "../../../ui";
+import { TextLink } from "../../../ui";
+import { HelpCircle, ChevronRight } from "lucide-react";
+const DEFAULT_HERO_CLASS = "bg-gradient-to-br from-violet-700 to-indigo-700 dark:from-violet-800 dark:to-indigo-800";
+export async function FAQPageView({ category, heroBannerClass = DEFAULT_HERO_CLASS, } = {}) {
+    const { themed, flex, page } = THEME_CONSTANTS;
+    const { getTranslations } = await import("next-intl/server");
+    const t = await getTranslations("faqs");
+    // Each FAQ namespace must export:
+    //   title, subtitle, searchPlaceholder
+    //   categories: [{ slug, label, icon }]
+    //   items (or per-category items keyed by category slug): [{ question, answer }]
+    const rawCategories = t.raw("categories");
+    const categories = Array.isArray(rawCategories) ? rawCategories : [];
+    const rawItems = t.raw("items");
+    const allItems = Array.isArray(rawItems) ? rawItems : [];
+    const visibleItems = category
+        ? allItems.filter((item) => item.category === category)
+        : allItems;
+    const activeCategory = categories.find((c) => c.slug === category);
+    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", "data-section": "faqpageview-div-93", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-14 md:py-16 lg:py-20`, children: _jsxs("div", { className: `${page.container.md} text-center`, "data-section": "faqpageview-div-94", children: [_jsx(Heading, { level: 1, variant: "none", className: "mb-3 text-white", children: activeCategory ? activeCategory.label : t("title") }), _jsx(Text, { variant: "none", className: "text-white/80 max-w-2xl mx-auto", children: t("subtitle") })] }) }), _jsx("div", { className: `${page.container.md} py-10 md:py-12 lg:py-16`, "data-section": "faqpageview-div-95", children: _jsxs("div", { className: "flex flex-col md:flex-row gap-8", "data-section": "faqpageview-div-96", children: [categories.length > 0 && (_jsxs("aside", { className: "md:w-56 flex-shrink-0", children: [_jsx(Heading, { level: 3, className: "text-sm font-semibold uppercase tracking-wide text-neutral-500 mb-3", children: t("categoriesLabel") }), _jsxs("nav", { className: "space-y-1", children: [_jsxs(TextLink, { href: String(ROUTES.PUBLIC.FAQS), className: `flex items-center justify-between px-3 py-2 rounded-lg text-sm transition-colors ${!category
+                                                ? "bg-primary/10 text-primary font-semibold"
+                                                : "hover:bg-neutral-100 dark:hover:bg-neutral-800"}`, children: [_jsxs("span", { className: `${flex.row} gap-2`, children: [_jsx(HelpCircle, { className: "w-4 h-4" }), t("allCategories")] }), _jsx(ChevronRight, { className: "w-3.5 h-3.5 opacity-50" })] }), categories.map((cat) => (_jsxs(TextLink, { href: String(ROUTES.PUBLIC.FAQ_CATEGORY(cat.slug)), className: `flex items-center justify-between px-3 py-2 rounded-lg text-sm transition-colors ${category === cat.slug
+                                                ? "bg-primary/10 text-primary font-semibold"
+                                                : "hover:bg-neutral-100 dark:hover:bg-neutral-800"}`, children: [_jsxs("span", { className: `${flex.row} gap-2`, children: [_jsx("span", { children: cat.icon }), cat.label] }), _jsx(ChevronRight, { className: "w-3.5 h-3.5 opacity-50" })] }, cat.slug)))] })] })), _jsxs("div", { className: "flex-1 min-w-0", "data-section": "faqpageview-div-97", children: [visibleItems.length === 0 ? (_jsxs(Section, { className: `text-center py-16 rounded-2xl border ${themed.border} ${themed.bgSecondary}`, children: [_jsx(HelpCircle, { className: "w-10 h-10 mx-auto mb-3 text-neutral-300 dark:text-neutral-600" }), _jsx(Heading, { level: 3, className: "mb-2 text-base", children: t("emptyTitle") }), _jsx(Text, { variant: "secondary", className: "text-sm", children: t("emptyText") })] })) : (_jsx(Stack, { gap: "sm", className: "space-y-3", children: visibleItems.map((item, i) => (_jsxs("details", { className: `group rounded-xl border ${themed.border} ${themed.bgPrimary} overflow-hidden`, children: [_jsxs("summary", { className: `flex items-center justify-between px-5 py-4 cursor-pointer list-none select-none font-medium text-sm hover:bg-neutral-50 dark:hover:bg-neutral-800/50 transition-colors`, children: [_jsx("span", { children: item.question }), _jsx(ChevronRight, { className: "w-4 h-4 flex-shrink-0 ml-3 transition-transform group-open:rotate-90" })] }), _jsx("div", { className: "px-5 pb-5 pt-1", "data-section": "faqpageview-div-98", children: _jsx(Text, { variant: "secondary", className: "text-sm leading-relaxed whitespace-pre-line", children: item.answer }) })] }, i))) })), _jsxs(Section, { className: `mt-10 rounded-2xl p-6 text-center border ${themed.border} ${themed.bgSecondary}`, children: [_jsx(Heading, { level: 3, className: "mb-2 text-base", children: t("stillNeedHelpTitle") }), _jsx(Text, { variant: "secondary", className: "text-sm mb-4", children: t("stillNeedHelpText") }), _jsxs("div", { className: `${flex.center} gap-4 flex-wrap`, "data-section": "faqpageview-div-99", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.HELP), children: t("helpCenter") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.CONTACT), variant: "muted", children: t("contactUs") })] })] })] })] }) })] }));
+}

package/dist/features/about/components/FeesView.d.ts

@@ -0,0 +1,4 @@
+export interface FeesViewProps {
+    heroBannerClass?: string;
+}
+export declare function FeesView({ heroBannerClass, }?: FeesViewProps): Promise<import("react/jsx-runtime").JSX.Element>;

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

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ROUTES } from "../../../constants";
+import { THEME_CONSTANTS } from "../../../tokens";
+import { Heading, Text, Section, Caption } from "../../../ui";
+const DEFAULT_HERO_CLASS = "bg-gradient-to-br from-violet-700 to-indigo-700 dark:from-violet-800 dark:to-indigo-800";
+export async function FeesView({ heroBannerClass = DEFAULT_HERO_CLASS, } = {}) {
+    const { themed, page } = THEME_CONSTANTS;
+    const { getTranslations } = await import("next-intl/server");
+    const t = await getTranslations("fees");
+    const FEE_ROWS = [
+        {
+            category: t("platformFeeTitle"),
+            rate: t("platformFeeRate"),
+            who: t("paidBySeller"),
+            note: t("platformFeeNote"),
+        },
+        {
+            category: t("gatewayFeeTitle"),
+            rate: t("gatewayFeeRate"),
+            who: t("paidBySeller"),
+            note: t("gatewayFeeNote"),
+        },
+        {
+            category: t("gstTitle"),
+            rate: t("gstRate"),
+            who: t("paidBySeller"),
+            note: t("gstNote"),
+        },
+        {
+            category: t("buyerFeeTitle"),
+            rate: t("buyerFeeRate"),
+            who: t("paidByBuyer"),
+            note: t("buyerFeeNote"),
+        },
+        {
+            category: t("offerFeeTitle"),
+            rate: t("offerFeeRate"),
+            who: t("paidByBuyer"),
+            note: t("offerFeeNote"),
+        },
+        {
+            category: t("shippingFeeTitle"),
+            rate: t("shippingFeeRate"),
+            who: t("paidByBuyer"),
+            note: t("shippingFeeNote"),
+        },
+    ];
+    const OFFER_PAYOUT_ROWS = [
+        { label: t("grossSale"), example: "₹1,000" },
+        { label: `${t("platformFeeTitle")} (5%)`, example: "− ₹50" },
+        { label: `${t("gatewayFeeTitle")} (2.36%)`, example: "− ₹23.60" },
+        { label: `${t("gstTitle")} on platform fee (18%)`, example: "− ₹9" },
+        { label: t("netPayoutLabel"), example: "= ₹917.40", highlight: true },
+    ];
+    void ROUTES; // ROUTES imported for future CTA links if needed
+    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", "data-section": "feesview-div-100", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-14 md:py-16 lg:py-20`, children: _jsxs("div", { className: `${page.container.sm} text-center`, "data-section": "feesview-div-101", children: [_jsx(Heading, { level: 1, variant: "none", className: "mb-4 text-white", children: t("title") }), _jsx(Text, { variant: "none", className: "text-white/80 max-w-2xl mx-auto", children: t("subtitle") })] }) }), _jsxs("div", { className: `${page.container.sm} py-10 md:py-12 lg:py-16 space-y-12`, "data-section": "feesview-div-102", children: [_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-6", children: t("tableTitle") }), _jsx("div", { className: `overflow-x-auto rounded-xl border ${themed.border}`, "data-section": "feesview-div-103", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { className: themed.bgSecondary, children: _jsxs("tr", { children: [_jsx("th", { className: "py-3 px-4 text-left font-semibold", children: t("colFeeType") }), _jsx("th", { className: "py-3 px-4 text-left font-semibold", children: t("colRate") }), _jsx("th", { className: "py-3 px-4 text-left font-semibold", children: t("colPaidBy") }), _jsx("th", { className: "py-3 px-4 text-left font-semibold hidden md:table-cell", children: t("colNote") })] }) }), _jsx("tbody", { className: "divide-y divide-neutral-100 dark:divide-neutral-800", children: FEE_ROWS.map((row) => (_jsxs("tr", { className: `${themed.bgPrimary} hover:bg-neutral-50 dark:hover:bg-neutral-800/50`, children: [_jsx("td", { className: "py-3 px-4 font-medium", children: row.category }), _jsx("td", { className: "py-3 px-4 font-semibold text-violet-700 dark:text-violet-400", children: row.rate }), _jsx("td", { className: "py-3 px-4", children: _jsx(Caption, { children: row.who }) }), _jsx("td", { className: "py-3 px-4 text-neutral-500 dark:text-neutral-400 hidden md:table-cell text-xs", children: row.note })] }, row.category))) })] }) }), _jsx(Caption, { className: "mt-3 block text-neutral-500", children: t("tableNote") })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-3", children: t("payoutExampleTitle") }), _jsx(Text, { variant: "secondary", className: "mb-6", children: t("payoutExampleSubtitle") }), _jsxs("div", { className: `rounded-xl border ${themed.border} ${themed.bgPrimary} p-5 max-w-sm`, "data-section": "feesview-div-104", children: [_jsx(Heading, { level: 3, className: "text-base mb-4", children: t("payoutExampleProduct") }), _jsx("div", { className: "space-y-2", "data-section": "feesview-div-105", children: OFFER_PAYOUT_ROWS.map((row, i) => (_jsxs("div", { className: `flex justify-between text-sm ${row.highlight
+                                                ? "border-t border-neutral-200 dark:border-neutral-700 pt-2 mt-2 font-bold"
+                                                : ""}`, "data-section": "feesview-div-106", children: [_jsx(Text, { className: row.highlight
+                                                        ? "font-bold"
+                                                        : "text-neutral-600 dark:text-neutral-400", children: row.label }), _jsx(Text, { className: row.highlight
+                                                        ? "font-bold text-green-700 dark:text-green-400"
+                                                        : "", children: row.example })] }, i))) })] })] }), _jsxs(Section, { className: `rounded-xl border ${themed.border} p-5 ${themed.bgSecondary}`, children: [_jsx(Heading, { level: 3, className: "text-base mb-2", children: t("disclaimerTitle") }), _jsx(Caption, { className: "leading-relaxed", children: t("disclaimerText") })] })] })] }));
+}

package/dist/features/about/components/HelpPageView.d.ts

@@ -0,0 +1,4 @@
+export interface HelpPageViewProps {
+    heroBannerClass?: string;
+}
+export declare function HelpPageView({ heroBannerClass, }?: HelpPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;

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

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ROUTES } from "../../../constants";
+import { THEME_CONSTANTS } from "../../../tokens";
+import { Heading, Text, Section, Stack } from "../../../ui";
+import { TextLink } from "../../../ui";
+import { BookOpen, MessageCircle, ShoppingBag, Truck, CreditCard, Store, ShieldCheck, ChevronRight, } from "lucide-react";
+const DEFAULT_HERO_CLASS = "bg-gradient-to-br from-violet-700 to-indigo-700 dark:from-violet-800 dark:to-indigo-800";
+export async function HelpPageView({ heroBannerClass = DEFAULT_HERO_CLASS, } = {}) {
+    const { themed, flex, page } = THEME_CONSTANTS;
+    const { getTranslations } = await import("next-intl/server");
+    const t = await getTranslations("helpPage");
+    const TOPICS = [
+        {
+            icon: ShoppingBag,
+            title: t("topicBuying"),
+            desc: t("topicBuyingDesc"),
+            href: String(ROUTES.PUBLIC.HOW_ORDERS_WORK),
+            color: "bg-primary/5 border-primary/20 dark:bg-primary/10 dark:border-primary/30",
+            iconColor: "text-primary",
+        },
+        {
+            icon: Truck,
+            title: t("topicShipping"),
+            desc: t("topicShippingDesc"),
+            href: String(ROUTES.PUBLIC.SHIPPING_POLICY),
+            color: "bg-sky-50 border-sky-200 dark:bg-sky-900/20 dark:border-sky-700",
+            iconColor: "text-sky-600 dark:text-sky-400",
+        },
+        {
+            icon: CreditCard,
+            title: t("topicPayment"),
+            desc: t("topicPaymentDesc"),
+            href: String(ROUTES.PUBLIC.HOW_CHECKOUT_WORKS),
+            color: "bg-emerald-50 border-emerald-200 dark:bg-emerald-900/20 dark:border-emerald-700",
+            iconColor: "text-emerald-600 dark:text-emerald-400",
+        },
+        {
+            icon: Store,
+            title: t("topicSelling"),
+            desc: t("topicSellingDesc"),
+            href: String(ROUTES.PUBLIC.SELLER_GUIDE),
+            color: "bg-amber-50 border-amber-200 dark:bg-amber-900/20 dark:border-amber-700",
+            iconColor: "text-amber-600 dark:text-amber-400",
+        },
+        {
+            icon: BookOpen,
+            title: t("topicFAQs"),
+            desc: t("topicFAQsDesc"),
+            href: String(ROUTES.PUBLIC.FAQS),
+            color: "bg-violet-50 border-violet-200 dark:bg-violet-900/20 dark:border-violet-700",
+            iconColor: "text-violet-600 dark:text-violet-400",
+        },
+        {
+            icon: ShieldCheck,
+            title: t("topicSecurity"),
+            desc: t("topicSecurityDesc"),
+            href: String(ROUTES.PUBLIC.SECURITY),
+            color: "bg-rose-50 border-rose-200 dark:bg-rose-900/20 dark:border-rose-700",
+            iconColor: "text-rose-600 dark:text-rose-400",
+        },
+    ];
+    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", "data-section": "helppageview-div-107", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-14 md:py-16 lg:py-20`, children: _jsxs("div", { className: `${page.container.md} text-center`, "data-section": "helppageview-div-108", children: [_jsx(Heading, { level: 1, variant: "none", className: "mb-4 text-white", children: t("title") }), _jsx(Text, { variant: "none", className: "text-white/80 max-w-2xl mx-auto", children: t("subtitle") })] }) }), _jsxs("div", { className: `${page.container.md} py-10 md:py-12 lg:py-16 space-y-14`, "data-section": "helppageview-div-109", children: [_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "mb-6 text-center", children: t("browseTopics") }), _jsx("div", { className: "grid gap-4 sm:grid-cols-2 lg:grid-cols-3", "data-section": "helppageview-div-110", children: TOPICS.map(({ icon: Icon, title, desc, href, color, iconColor }) => (_jsxs(TextLink, { href: href, className: `group rounded-xl border p-5 transition-shadow hover:shadow-md ${color} no-underline`, children: [_jsx("div", { className: `w-10 h-10 rounded-lg bg-white/60 dark:bg-white/10 ${flex.center} mb-3`, "data-section": "helppageview-div-111", children: _jsx(Icon, { className: `w-5 h-5 ${iconColor}` }) }), _jsxs("div", { className: `${flex.row} justify-between items-start`, "data-section": "helppageview-div-112", children: [_jsxs("div", { "data-section": "helppageview-div-113", children: [_jsx(Text, { className: "font-semibold mb-1", children: title }), _jsx(Text, { variant: "secondary", className: "text-sm leading-relaxed", children: desc })] }), _jsx(ChevronRight, { className: "w-4 h-4 mt-1 flex-shrink-0 opacity-40 group-hover:opacity-80 transition-opacity" })] })] }, href))) })] }), _jsxs(Section, { className: `rounded-2xl p-6 border ${themed.border} ${themed.bgSecondary} flex flex-col sm:flex-row items-center gap-4`, children: [_jsxs("div", { className: "flex-1", "data-section": "helppageview-div-114", children: [_jsx(Heading, { level: 3, className: "mb-1 text-base", children: t("trackOrderTitle") }), _jsx(Text, { variant: "secondary", className: "text-sm", children: t("trackOrderText") })] }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.TRACK_ORDER), className: "flex-shrink-0", children: t("trackOrderCta") })] }), _jsxs(Section, { className: `rounded-2xl p-8 text-center border ${themed.border} ${themed.bgSecondary}`, children: [_jsx(MessageCircle, { className: "w-10 h-10 mx-auto mb-3 text-primary/70" }), _jsx(Heading, { level: 2, className: "mb-3", children: t("contactTitle") }), _jsx(Text, { variant: "secondary", className: "mb-6 max-w-lg mx-auto", children: t("contactText") }), _jsxs(Stack, { gap: "sm", className: "flex-row flex-wrap justify-center gap-4", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.CONTACT), children: t("contactCta") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.FAQS), variant: "muted", children: t("faqCta") })] })] })] })] }));
+}

package/dist/features/about/components/HowAuctionsWorkView.d.ts

@@ -0,0 +1,4 @@
+export interface HowAuctionsWorkViewProps {
+    heroBannerClass?: string;
+}
+export declare function HowAuctionsWorkView({ heroBannerClass, }?: HowAuctionsWorkViewProps): Promise<import("react/jsx-runtime").JSX.Element>;