@mohasinac/appkit 2.4.10 → 2.5.0

package/dist/client.js

@@ -6,97 +6,101 @@
 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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [CLIENT-ONLY]-Cannot run in SSR mode — uses IntersectionObserver.
+// useInfiniteScroll - IntersectionObserver primitive for cursor-based listings (Q6 — S13).
+export { useInfiniteScroll } from "./react/hooks/useInfiniteScroll";
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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, EventPollWidget } 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.
+// [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.
+export { ImageUpload } 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.
 // 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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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.
+// [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
@@ -128,7 +132,7 @@ export { UserSidebar } from "./features/account/components/UserSidebar";
 export { CouponsIndexListing } from "./features/promotions/components/CouponsIndexListing";
 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 { useLogout, useLogin, useGoogleLogin, useRegister, useForgotPassword, useResetPassword, useVerifyEmail, useChangePassword, useChangeEmail } from "./features/auth/index";
 export { CartView, CartItemRow, CartSummary, CartDrawer, CheckoutView, CheckoutSuccessView, CheckoutAddressStep, useGuestCart, useCartCount, useAddToCart, useCart, useGuestCartMerge, useCartQuery } from "./features/cart/index";
 export { useAddresses, useCreateAddress, useUpdateAddress, useDeleteAddress, useSetDefaultAddress, useAddress } from "./features/account/index";
 export { AddressBook, AddressCard, AddressForm } from "./features/account/index";
@@ -144,14 +148,40 @@ export { AdSlot } from "./features/homepage/components/AdSlot";
 export { useActiveAd } from "./features/homepage/hooks/useActiveAd";
 export { registerAdSlot, registerAdSlots, unregisterAdSlot, clearAdRegistry, setAdConsentGranted, isAdConsentGranted, isAdSlotRenderable, } from "./features/homepage/ad-registry";
 export { WishlistView, useGuestWishlist, useWishlistWithGuest } from "./features/wishlist/index";
+export { WishlistCapWatcher } from "./features/wishlist/components/WishlistCapWatcher";
+export { useWishlistCount, useWishlistCountWithLimit, WISHLIST_CAP_EVENT } from "./features/wishlist/hooks/useWishlistCount";
 export { getGuestWishlistItems, addToGuestWishlist, removeFromGuestWishlist, isInGuestWishlist, clearGuestWishlist, getGuestWishlistCount, getGuestWishlistByType, } from "./features/wishlist/utils/guest-wishlist";
 export { InteractiveProductCard } from "./features/products/index";
+export { CompareOverlay } from "./features/products/components/CompareOverlay";
+export { COMPARE_MAX_ITEMS } from "./features/products/constants/action-defs";
+// Messages — RTDB-pinged Firestore conversations (D5 + VC7)
+export { MessagesView } from "./features/account/components/MessagesView";
+export { ChatList } from "./features/account/components/ChatList";
+export { ChatWindow } from "./features/account/components/ChatWindow";
+export { useConversations, useConversation } from "./features/messages/index";
+export { CONVERSATIONS_COLLECTION, CONVERSATIONS_INDEXED_FIELDS, } from "./features/messages/index";
+export { CONVERSATIONS_PING_PATH, CONVERSATIONS_PING_USER_PATH, } from "./features/messages/hooks/useConversation";
+// Product / listing actions
+export { ACTION_ID, ACTION_META, DETAIL_ACTIONS, MOBILE_PRIMARY_ACTIONS, LISTING_BULK_ACTIONS } from "./features/products/index";
+// Row / table actions (admin, seller, user dashboards)
+export { ROW_ACTION_ID, ROW_ACTION_META, ADMIN_ROW_ACTIONS, SELLER_ROW_ACTIONS, USER_ROW_ACTIONS, ADMIN_BULK_ACTIONS, SELLER_BULK_ACTIONS } from "./features/products/index";
+// Form shell actions
+export { FORM_ACTION_ID, FORM_ACTION_META, FORM_FOOTER_PRESET } from "./features/products/index";
+// Dashboard quick actions
+export { DASHBOARD_QUICK_ACTION_ID, DASHBOARD_QUICK_ACTION_META, DASHBOARD_QUICK_ACTIONS } from "./features/products/index";
+// Action dispatch hook + panel store
+export { useActionDispatch } from "./react/hooks/use-action-dispatch";
+export { usePanelStore } from "./stores/panel-store";
+export { usePanelUrlSync } from "./react/hooks/use-panel-url-sync";
 export { MakeOfferButton } from "./features/products/components/MakeOfferButton";
+// productFeatures (FI6) — client-safe components + context
+export { ProductFeaturesProvider, useProductFeatures, } from "./features/products/components/ProductFeaturesContext";
+export { FeatureBadge, FeatureBadgeList } from "./features/products/components/FeatureBadge";
 export { SellerOffersPanel } from "./features/seller/components/SellerOffersPanel";
 export { UserOffersPanel } from "./features/account/components/UserOffersPanel";
 export { SellerDashboardView as StoreDashboardView, SellerDashboardView, useSellerDashboard as useStoreDashboard, useSellerDashboard } from "./features/seller/index";
 export { SellerPayoutSettingsView, SellerShippingView, SellerReviewsView, SellerPayoutRequestView, SellerAnalyticsStats, SellerTopProducts, SellerAnalyticsView, SellerPayoutsView, SellerCouponEditorView, SellerBidsView, SellerAddressesView } from "./features/seller/components/index";
-export { UserAccountHubView, UserOrdersView, OrderDetailView, UserNotificationsView } from "./features/account/index";
+export { UserAccountHubView, UserOrdersView, OrderDetailView, UserNotificationsView, UserReturnsView } from "./features/account/index";
 export { useOrders, useOrder, OrdersList } from "./features/orders/index";
 export { useCouponValidate } from "./features/promotions/hooks/useCouponValidate";
 export { BlogPostView } from "./features/blog/components/BlogPostView";
@@ -163,3 +193,8 @@ export { RichTextRenderer } from "./ui/rich-text/RichTextRenderer";
 // Scam registry — pure data constants safe for client bundle
 export { SCAM_TYPES, SCAM_CATEGORIES, SCAM_TYPE_LABELS, SCAM_CATEGORY_LABELS, getScamType, getScamTypesByCategory, } from "./features/scams/constants/scam-types";
 export { SCAM_PLATFORM_LABELS, ScamPlatformValues, } from "./features/scams/schemas/firestore";
+// History (recently-viewed) — client hook + guest util + cap constants
+export { useHistory, useHistoryMergeOnLogin, getGuestHistory, trackGuestHistory, removeGuestHistoryItem, clearGuestHistory, getGuestHistoryCount, HistoryTracker, } from "./features/history/index";
+export { WISHLIST_MAX, HISTORY_MAX, CART_MAX_ITEMS, } from "./constants/limits";
+// SB1-G canonical listing-type accessors (pure functions, client-safe).
+export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, } from "./features/products/utils/listing-type";

package/dist/configs/eslint.d.ts

@@ -0,0 +1,29 @@
+/**
+ * defineEslintConfig — appkit-aware ESLint flat-config factory.
+ *
+ * Returns a base config array with TypeScript + React + Next.js rules.
+ * Consumer-specific rules are merged in.
+ *
+ * @example
+ * ```js
+ * // eslint.config.js
+ * const { defineEslintConfig } = require("@mohasinac/appkit/configs");
+ * module.exports = defineEslintConfig();
+ * ```
+ */
+export interface EslintConfigOverride {
+    rules?: Record<string, unknown>;
+    ignores?: string[];
+}
+export declare function defineEslintConfig(override?: EslintConfigOverride): ({
+    ignores: string[];
+    rules?: undefined;
+} | {
+    rules: {
+        "no-restricted-syntax": (string | {
+            selector: string;
+            message: string;
+        })[];
+    };
+    ignores?: undefined;
+})[];

package/dist/configs/eslint.js

@@ -0,0 +1,38 @@
+/**
+ * defineEslintConfig — appkit-aware ESLint flat-config factory.
+ *
+ * Returns a base config array with TypeScript + React + Next.js rules.
+ * Consumer-specific rules are merged in.
+ *
+ * @example
+ * ```js
+ * // eslint.config.js
+ * const { defineEslintConfig } = require("@mohasinac/appkit/configs");
+ * module.exports = defineEslintConfig();
+ * ```
+ */
+export function defineEslintConfig(override = {}) {
+    return [
+        {
+            ignores: [
+                "node_modules/**",
+                ".next/**",
+                "dist/**",
+                ...(override.ignores ?? []),
+            ],
+        },
+        {
+            rules: {
+                // Prohibit hardcoded route strings — use ROUTES.* constants
+                "no-restricted-syntax": [
+                    "warn",
+                    {
+                        selector: "Literal[value=/^\\/[a-z]+(\\?|#|$)/]",
+                        message: "Use ROUTES.* constants from @mohasinac/appkit instead of hardcoded route strings.",
+                    },
+                ],
+                ...override.rules,
+            },
+        },
+    ];
+}

package/dist/configs/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * appkit consumer build-config helpers.
+ *
+ * Each helper ships opinionated defaults and accepts consumer overrides.
+ * Deep-merges arrays by default; pass `{ replace: true }` to fully replace.
+ *
+ * Usage:
+ *   const { defineNextConfig } = require("@mohasinac/appkit/configs");
+ *   module.exports = defineNextConfig({ images: { domains: [...] } });
+ */
+export { defineNextConfig } from "./next.js";
+export { definePostcssConfig } from "./postcss.js";
+export { defineTailwindConfig } from "./tailwind.js";
+export { defineEslintConfig } from "./eslint.js";

package/dist/configs/index.js

@@ -0,0 +1,14 @@
+/**
+ * appkit consumer build-config helpers.
+ *
+ * Each helper ships opinionated defaults and accepts consumer overrides.
+ * Deep-merges arrays by default; pass `{ replace: true }` to fully replace.
+ *
+ * Usage:
+ *   const { defineNextConfig } = require("@mohasinac/appkit/configs");
+ *   module.exports = defineNextConfig({ images: { domains: [...] } });
+ */
+export { defineNextConfig } from "./next.js";
+export { definePostcssConfig } from "./postcss.js";
+export { defineTailwindConfig } from "./tailwind.js";
+export { defineEslintConfig } from "./eslint.js";

package/dist/configs/next.d.ts

@@ -0,0 +1,38 @@
+/**
+ * defineNextConfig — appkit-aware Next.js config factory.
+ *
+ * Provides sensible defaults for projects consuming @mohasinac/appkit.
+ * Consumer overrides deep-merge with the defaults (arrays concatenate).
+ *
+ * Notable defaults:
+ * - `serverExternalPackages` includes firebase-admin + GCP deps
+ * - `outputFileTracingIncludes` forces firebase-admin/lib/database/** into Lambda bundles
+ * - `experimental.serverActions.bodySizeLimit` set to "4mb"
+ * - Optional `IgnorePlugin` for optional native deps (request, fast-crc32c)
+ *
+ * When the _internal/ dual-entry migration completes in S7, the firebase-admin
+ * workarounds are removed from this helper because the client entry will never
+ * import firebase-admin. Until then they remain for backward compatibility.
+ */
+export interface NextConfigOverride {
+    serverExternalPackages?: string[];
+    experimental?: Record<string, unknown>;
+    outputFileTracingIncludes?: Record<string, string[]>;
+    images?: Record<string, unknown>;
+    webpack?: (config: unknown, ctx: unknown) => unknown;
+    [key: string]: unknown;
+}
+/**
+ * Returns a Next.js config object with appkit defaults applied.
+ * Pass consumer-specific overrides as the argument; they deep-merge with defaults.
+ *
+ * @example
+ * ```js
+ * // next.config.js
+ * const { defineNextConfig } = require("@mohasinac/appkit/configs");
+ * module.exports = defineNextConfig({
+ *   images: { domains: ["lh3.googleusercontent.com"] }
+ * });
+ * ```
+ */
+export declare function defineNextConfig(override?: NextConfigOverride): NextConfigOverride;

package/dist/configs/next.js

@@ -0,0 +1,116 @@
+/**
+ * defineNextConfig — appkit-aware Next.js config factory.
+ *
+ * Provides sensible defaults for projects consuming @mohasinac/appkit.
+ * Consumer overrides deep-merge with the defaults (arrays concatenate).
+ *
+ * Notable defaults:
+ * - `serverExternalPackages` includes firebase-admin + GCP deps
+ * - `outputFileTracingIncludes` forces firebase-admin/lib/database/** into Lambda bundles
+ * - `experimental.serverActions.bodySizeLimit` set to "4mb"
+ * - Optional `IgnorePlugin` for optional native deps (request, fast-crc32c)
+ *
+ * When the _internal/ dual-entry migration completes in S7, the firebase-admin
+ * workarounds are removed from this helper because the client entry will never
+ * import firebase-admin. Until then they remain for backward compatibility.
+ */
+const FIREBASE_EXTERNAL_PACKAGES = [
+    "firebase-admin",
+    "@google-cloud/firestore",
+    "@google-cloud/storage",
+    "@google-cloud/common",
+    "google-auth-library",
+    "google-gax",
+    "gaxios",
+    "gtoken",
+    "jws",
+    "teeny-request",
+    "http-proxy-agent",
+    "https-proxy-agent",
+    "configstore",
+    "graceful-fs",
+    "make-dir",
+    "write-file-atomic",
+    "dot-prop",
+    "json-file-plus",
+    "@mohasinac/sievejs",
+    "retry-request",
+    "hash-stream-validation",
+    "fast-crc32c",
+    "request",
+];
+/**
+ * Returns a Next.js config object with appkit defaults applied.
+ * Pass consumer-specific overrides as the argument; they deep-merge with defaults.
+ *
+ * @example
+ * ```js
+ * // next.config.js
+ * const { defineNextConfig } = require("@mohasinac/appkit/configs");
+ * module.exports = defineNextConfig({
+ *   images: { domains: ["lh3.googleusercontent.com"] }
+ * });
+ * ```
+ */
+export function defineNextConfig(override = {}) {
+    const { serverExternalPackages: consumerExternal = [], experimental: consumerExperimental = {}, webpack: consumerWebpack, outputFileTracingIncludes: consumerOutputFileTracingIncludes = {}, ...rest } = override;
+    const mergedExternal = [
+        ...FIREBASE_EXTERNAL_PACKAGES,
+        ...consumerExternal.filter((p) => !FIREBASE_EXTERNAL_PACKAGES.includes(p)),
+    ];
+    const defaultExperimental = {
+        serverActions: { bodySizeLimit: "4mb" },
+    };
+    const mergedExperimental = {
+        ...defaultExperimental,
+        ...consumerExperimental,
+    };
+    // Next 16 moved `outputFileTracingIncludes` out of `experimental` to the
+    // top-level config. Keep the same firebase-admin/lib/database forcing the
+    // old position used, and merge consumer overrides if provided.
+    const defaultOutputFileTracingIncludes = {
+        "/api/**": [
+            "./node_modules/firebase-admin/lib/database/**",
+            "./node_modules/firebase-admin/lib/esm/database/**",
+        ],
+    };
+    const mergedOutputFileTracingIncludes = {
+        ...defaultOutputFileTracingIncludes,
+        ...consumerOutputFileTracingIncludes,
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function mergedWebpack(config, ctx) {
+        const { isServer, webpack } = ctx;
+        if (isServer) {
+            const externalFn = ({ request }, callback) => {
+                if (request &&
+                    mergedExternal.some((pkg) => request === pkg || request.startsWith(pkg + "/"))) {
+                    return callback(null, "commonjs " + request);
+                }
+                callback(null);
+            };
+            config.externals = [
+                ...(Array.isArray(config.externals) ? config.externals : [config.externals]),
+                externalFn,
+            ];
+            // Suppress "Module not found" warnings for optional native deps that
+            // firebase-admin wraps in try/catch and degrades gracefully without.
+            config.plugins.push(new webpack.IgnorePlugin({ resourceRegExp: /^(request|fast-crc32c)$/ }));
+        }
+        return consumerWebpack ? consumerWebpack(config, ctx) : config;
+    }
+    return {
+        images: {
+            remotePatterns: [
+                { protocol: "https", hostname: "**" },
+                { protocol: "http", hostname: "**" },
+            ],
+            ...(override.images ?? {}),
+        },
+        ...rest,
+        serverExternalPackages: mergedExternal,
+        experimental: mergedExperimental,
+        outputFileTracingIncludes: mergedOutputFileTracingIncludes,
+        webpack: mergedWebpack,
+    };
+}

package/dist/configs/postcss.d.ts

@@ -0,0 +1,22 @@
+/**
+ * definePostcssConfig — appkit-aware PostCSS config factory.
+ *
+ * Ships autoprefixer as the only default plugin for the consumer's own CSS
+ * (appkit's Tailwind utilities are pre-compiled into dist/tailwind-utilities.css
+ * and never need to pass through the consumer's PostCSS pipeline).
+ *
+ * @example
+ * ```js
+ * // postcss.config.js
+ * const { definePostcssConfig } = require("@mohasinac/appkit/configs");
+ * module.exports = definePostcssConfig();
+ * ```
+ */
+export interface PostcssConfigOverride {
+    plugins?: Record<string, unknown>;
+}
+export declare function definePostcssConfig(override?: PostcssConfigOverride): {
+    plugins: {
+        autoprefixer: {};
+    };
+};

package/dist/configs/postcss.js

@@ -0,0 +1,22 @@
+/**
+ * definePostcssConfig — appkit-aware PostCSS config factory.
+ *
+ * Ships autoprefixer as the only default plugin for the consumer's own CSS
+ * (appkit's Tailwind utilities are pre-compiled into dist/tailwind-utilities.css
+ * and never need to pass through the consumer's PostCSS pipeline).
+ *
+ * @example
+ * ```js
+ * // postcss.config.js
+ * const { definePostcssConfig } = require("@mohasinac/appkit/configs");
+ * module.exports = definePostcssConfig();
+ * ```
+ */
+export function definePostcssConfig(override = {}) {
+    return {
+        plugins: {
+            autoprefixer: {},
+            ...override.plugins,
+        },
+    };
+}

package/dist/configs/tailwind.d.ts

@@ -0,0 +1,59 @@
+/**
+ * defineTailwindConfig — appkit-aware Tailwind CSS config factory.
+ *
+ * appkit ships pre-compiled dist/tailwind-utilities.css covering every class
+ * appkit components emit. The consumer's Tailwind config does NOT need to scan
+ * node_modules/@mohasinac/appkit/** and does NOT need a safelist.
+ *
+ * Consumer must provide `content` globs for their own source files.
+ *
+ * @example
+ * ```js
+ * // tailwind.config.js
+ * const { defineTailwindConfig } = require("@mohasinac/appkit/configs");
+ * module.exports = defineTailwindConfig({
+ *   content: ["./src/**\/*.{ts,tsx}"],
+ * });
+ * ```
+ */
+export interface TailwindConfigOverride {
+    content?: string[];
+    theme?: Record<string, unknown>;
+    plugins?: unknown[];
+    safelist?: unknown[];
+    [key: string]: unknown;
+}
+export declare function defineTailwindConfig(override?: TailwindConfigOverride): {
+    darkMode: "class";
+    content: string[];
+    safelist: unknown[];
+    theme: {
+        extend: {
+            colors: {
+                primary: string;
+                secondary: string;
+                accent: string;
+                surface: string;
+                "surface-muted": string;
+                "surface-elevated": string;
+                "on-surface": string;
+                "on-surface-muted": string;
+                border: string;
+                "border-strong": string;
+                divider: string;
+                "text-primary": string;
+                "text-secondary": string;
+                "text-tertiary": string;
+                "text-disabled": string;
+                "text-inverse": string;
+                link: string;
+                "link-hover": string;
+                success: string;
+                warning: string;
+                danger: string;
+                info: string;
+            };
+        };
+    };
+    plugins: unknown[];
+};

package/dist/configs/tailwind.js

@@ -0,0 +1,62 @@
+/**
+ * defineTailwindConfig — appkit-aware Tailwind CSS config factory.
+ *
+ * appkit ships pre-compiled dist/tailwind-utilities.css covering every class
+ * appkit components emit. The consumer's Tailwind config does NOT need to scan
+ * node_modules/@mohasinac/appkit/** and does NOT need a safelist.
+ *
+ * Consumer must provide `content` globs for their own source files.
+ *
+ * @example
+ * ```js
+ * // tailwind.config.js
+ * const { defineTailwindConfig } = require("@mohasinac/appkit/configs");
+ * module.exports = defineTailwindConfig({
+ *   content: ["./src/**\/*.{ts,tsx}"],
+ * });
+ * ```
+ */
+export function defineTailwindConfig(override = {}) {
+    const { content: consumerContent = [], theme: consumerTheme = {}, plugins: consumerPlugins = [], safelist: consumerSafelist = [], ...rest } = override;
+    return {
+        darkMode: "class",
+        content: [...consumerContent],
+        safelist: [...consumerSafelist],
+        theme: {
+            extend: {
+                colors: {
+                    // Brand
+                    primary: "var(--appkit-color-primary)",
+                    secondary: "var(--appkit-color-secondary)",
+                    accent: "var(--appkit-color-accent)",
+                    // Surface
+                    surface: "var(--appkit-color-surface)",
+                    "surface-muted": "var(--appkit-color-surfaceMuted)",
+                    "surface-elevated": "var(--appkit-color-surfaceElevated)",
+                    "on-surface": "var(--appkit-color-onSurface)",
+                    "on-surface-muted": "var(--appkit-color-onSurfaceMuted)",
+                    border: "var(--appkit-color-border)",
+                    "border-strong": "var(--appkit-color-borderStrong)",
+                    divider: "var(--appkit-color-divider)",
+                    // Text
+                    "text-primary": "var(--appkit-color-textPrimary)",
+                    "text-secondary": "var(--appkit-color-textSecondary)",
+                    "text-tertiary": "var(--appkit-color-textTertiary)",
+                    "text-disabled": "var(--appkit-color-textDisabled)",
+                    "text-inverse": "var(--appkit-color-textInverse)",
+                    link: "var(--appkit-color-link)",
+                    "link-hover": "var(--appkit-color-linkHover)",
+                    // State
+                    success: "var(--appkit-color-success)",
+                    warning: "var(--appkit-color-warning)",
+                    danger: "var(--appkit-color-danger)",
+                    info: "var(--appkit-color-info)",
+                },
+                ...(consumerTheme.extend ?? {}),
+            },
+            ...Object.fromEntries(Object.entries(consumerTheme).filter(([k]) => k !== "extend")),
+        },
+        plugins: [...consumerPlugins],
+        ...rest,
+    };
+}