@mohasinac/appkit 3.3.2 → 3.3.4

package/dist/_internal/client/features/lottery/LotteryAdminSlotView.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { Stack, Text, Heading, Badge, Section, Container, DataTable, } from "../../../../ui";
+import { Stack, Text, Heading, Badge, Section, Container, DataTable } from "../../../../ui";
 /**
  * Admin-only view showing slots with price + weight + % chance.
  * Separate from LotterySlotGrid (public) which never shows price/weight.

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

@@ -2,7 +2,7 @@
 import { wrapAction } from "@mohasinac/appkit/server";
 import { cartRepository } from "../../../../repositories";
 import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
-import { addToCartSchema, removeFromCartSchema, mergeGuestCartSchema, } from "../../../shared/features/cart/schema";
+import { addToCartSchema, removeFromCartSchema, mergeGuestCartSchema } from "../../../shared/features/cart/schema";
 import { upsertCartItem, mergeGuestItems } from "./service";
 import { ValidationError } from "../../../shared/errors/index";
 export async function addToCartAction(input) {

package/dist/_internal/server/features/lottery/data.d.ts

@@ -1,6 +1,5 @@
 import type { SieveModel } from "../../../../providers/db-firebase";
 import type { EventDocument } from "../../../../features/events/schemas/firestore";
-import type { LotteryEntryDocument } from "../../../../features/lottery/schemas/firestore";
 import type { ClientLotteryConfig } from "../../../../features/lottery/types";
 /** Event shape with lottery config stripped of price/weight. */
 export type LotteryEventClient = Omit<EventDocument, "lotteryConfig"> & {
@@ -15,6 +14,6 @@ export declare const listLotteryEvents: (opts?: {
     pageSize?: number;
 }) => Promise<LotteryEventClient[]>;
 /** Fetch lottery entries for admin view (includes phone + txId via PII decrypt). */
-export declare function getLotteryEntriesForAdmin(sourceType: "event" | "product", sourceId: string, model: SieveModel): Promise<import("../../../..").FirebaseSieveResult<LotteryEntryDocument>>;
+export declare function getLotteryEntriesForAdmin(sourceType: "event" | "product", sourceId: string, model: SieveModel): Promise<import("../../../..").FirebaseSieveResult<import("../../../..").LotteryEntryDocument>>;
 /** Fetch lottery entries for a specific user (own entries only). */
-export declare function getLotteryEntriesForUser(userId: string, model: SieveModel): Promise<import("../../../..").FirebaseSieveResult<LotteryEntryDocument>>;
+export declare function getLotteryEntriesForUser(userId: string, model: SieveModel): Promise<import("../../../..").FirebaseSieveResult<import("../../../..").LotteryEntryDocument>>;

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

@@ -3,7 +3,7 @@ import { wrapAction } from "@mohasinac/appkit/server";
 import { productRepository } from "../../../../repositories";
 import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
 import { isAdminUser } from "../../../../features/auth/role-predicates";
-import { productInputSchema, productUpdateSchema, auctionInputSchema, preOrderInputSchema, setFeaturedSchema, setStatusSchema, } from "../../../shared/features/products/schema";
+import { productInputSchema, productUpdateSchema, auctionInputSchema, preOrderInputSchema, setFeaturedSchema, setStatusSchema } from "../../../shared/features/products/schema";
 import { assertProductOwnership, assertStatusTransition } from "./service";
 import { ValidationError } from "../../../shared/errors/index";
 export async function createProductAction(input) {

package/dist/client/api/surface-error.js

@@ -1,13 +1,13 @@
 import { isApiError } from "./ApiError";
+import { ApiClientError } from "../../http/ApiClient";
 import { normalizeError } from "../../errors/normalize";
 import { getErrorDisplay } from "../../errors/error-display-map";
-/** True for `ApiError` instances and for any other thrown error (e.g. the
- * lower-level `ApiClientError` from `ApiClient.request()`) that carries the
- * same stable `code: string` field — both shapes route through the same
- * toast-vs-inline-field-error logic below. */
+/** True for `ApiError` instances and for `ApiClientError` (the lower-level
+ * error `ApiClient.request()` throws) when it carries a stable `code` —
+ * both shapes route through the same toast-vs-inline-field-error logic
+ * below. */
 function hasStableErrorCode(err) {
-    return (isApiError(err) ||
-        (err instanceof Error && typeof err.code === "string"));
+    return isApiError(err) || (err instanceof ApiClientError && typeof err.code === "string");
 }
 export function surfaceError(err, opts) {
     const { showToast, setFieldError, translate, report } = opts;

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

@@ -12,7 +12,7 @@ import { ADMIN_ENDPOINTS, DEMO_ENDPOINTS } from "../../../constants";
 import { useAdminSectionsListing } from "../hooks/useAdminSectionsListing";
 import { DataTable } from "./DataTable";
 import { SECTION_TYPE_OPTIONS, SUPPORTED_TYPED_BUILDERS, RESOURCE_SORT_OPTIONS, FAQ_CATEGORY_OPTIONS, DEFAULT_PRODUCTS_BUILDER, DEFAULT_AUCTIONS_BUILDER, DEFAULT_STATS_BUILDER, DEFAULT_PRE_ORDERS_BUILDER, DEFAULT_STORES_BUILDER, DEFAULT_EVENTS_BUILDER, DEFAULT_SOCIAL_FEED_BUILDER, DEFAULT_WELCOME_BUILDER, DEFAULT_TRUST_INDICATORS_BUILDER, DEFAULT_CATEGORIES_BUILDER, DEFAULT_BRANDS_BUILDER, DEFAULT_BANNER_BUILDER, DEFAULT_FEATURES_BUILDER, DEFAULT_REVIEWS_BUILDER, DEFAULT_WHATSAPP_BUILDER, DEFAULT_FAQ_BUILDER, DEFAULT_BLOG_BUILDER, DEFAULT_NEWSLETTER_BUILDER, DEFAULT_CAROUSEL_BUILDER, DEFAULT_CUSTOM_CARDS_BUILDER, DEFAULT_GOOGLE_REVIEWS_BUILDER, DEFAULT_FEATURED_BUNDLES_BUILDER, DEFAULT_PRIZE_DRAWS_BUILDER, DEFAULT_EVENT_RAFFLES_BUILDER, DEFAULT_COLLECTION_CARDS_BUILDER, } from "./sections/adminSectionsTypes";
-import { toStringValue, buildProductsConfig, buildAuctionsConfig, buildStatsConfig, buildPreOrdersConfig, buildStoresConfig, buildEventsConfig, buildSocialFeedConfig, buildWelcomeConfig, buildTrustIndicatorsConfig, buildCategoriesConfig, buildBrandsConfig, buildBannerConfig, buildFeaturesConfig, buildReviewsConfig, buildWhatsAppConfig, buildFAQConfig, buildBlogConfig, buildNewsletterConfig, buildCarouselConfig, buildCustomCardsConfig, buildGoogleReviewsConfig, buildFeaturedBundlesConfig, buildPrizeDrawsConfig, buildEventRafflesConfig, buildCollectionCardsConfig, parseProductsBuilder, parseAuctionsBuilder, parseStatsBuilder, parsePreOrdersBuilder, parseStoresBuilder, parseEventsBuilder, parseSocialFeedBuilder, parseWelcomeBuilder, parseTrustIndicatorsBuilder, parseCategoriesBuilder, parseBrandsBuilder, parseBannerBuilder, parseFeaturesBuilder, parseReviewsBuilder, parseWhatsAppBuilder, parseFAQBuilder, parseBlogBuilder, parseNewsletterBuilder, parseCarouselBuilder, parseCustomCardsBuilder, parseGoogleReviewsBuilder, parseFeaturedBundlesBuilder, parsePrizeDrawsBuilder, parseEventRafflesBuilder, parseCollectionCardsBuilder, } from "./sections/adminSectionsBuildParse";
+import { toStringValue, buildProductsConfig, buildAuctionsConfig, buildStatsConfig, buildPreOrdersConfig, buildStoresConfig, buildEventsConfig, buildSocialFeedConfig, buildWelcomeConfig, buildTrustIndicatorsConfig, buildCategoriesConfig, buildBrandsConfig, buildBannerConfig, buildFeaturesConfig, buildReviewsConfig, buildWhatsAppConfig, buildFAQConfig, buildBlogConfig, buildNewsletterConfig, buildCarouselConfig, buildCustomCardsConfig, buildGoogleReviewsConfig, buildFeaturedBundlesConfig, buildPrizeDrawsConfig, buildEventRafflesConfig, buildCollectionCardsConfig, parseProductsBuilder, parseAuctionsBuilder, parseStatsBuilder, parsePreOrdersBuilder, parseStoresBuilder, parseEventsBuilder, parseSocialFeedBuilder, parseWelcomeBuilder, parseTrustIndicatorsBuilder, parseCategoriesBuilder, parseBrandsBuilder, parseBannerBuilder, parseFeaturesBuilder, parseReviewsBuilder, parseWhatsAppBuilder, parseFAQBuilder, parseBlogBuilder, parseNewsletterBuilder, parseCarouselBuilder, parseCustomCardsBuilder, parseGoogleReviewsBuilder, parseFeaturedBundlesBuilder, parsePrizeDrawsBuilder, parseEventRafflesBuilder, parseCollectionCardsBuilder } from "./sections/adminSectionsBuildParse";
 const __P = {
     p3: "p-3",
     p4: "p-4",
@@ -944,6 +944,12 @@ export function AdminSectionsView({ children }) {
             default: return null;
         }
     }
+    // React.useMemo must run unconditionally on every render — it was
+    // previously declared after the `hasChildren` early return below, which
+    // skips the hook call in passthrough mode, violating the Rules of Hooks.
+    const sectionOrderMap = React.useMemo(() => {
+        return new Map(sections.map((section) => [section.id, section.order]));
+    }, [sections]);
     // If children exist, render passthrough mode (detail view)
     if (hasChildren) {
         return _jsx(_Fragment, { children: children });
@@ -956,9 +962,6 @@ export function AdminSectionsView({ children }) {
         status: section.enabled ? "Active" : "Inactive",
         updatedAt: new Date(section.updatedAt).toLocaleDateString(),
     }));
-    const sectionOrderMap = React.useMemo(() => {
-        return new Map(sections.map((section) => [section.id, section.order]));
-    }, [sections]);
     const hasReorderChanges = reorderDraft.some((item) => sectionOrderMap.get(item.id) !== item.order);
     const canUndoReorderChanges = reorderUndoStack.length > 0;
     return (_jsxs(_Fragment, { children: [_jsxs(Div, { paddingX: "x-sm-md", padding: "y-md", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "3", children: [_jsxs(Div, { children: [_jsx(Text, { size: "base", weight: "semibold", color: "primary", children: "Homepage Sections" }), _jsx(Text, { size: "sm", color: "muted", children: "Manage homepage sections and their display order" })] }), _jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => setSeedResetOpen(true), children: "Reset seed data" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => setIsModalOpen(true), children: "Manage Sections" })] })] }), errorMessage && (_jsx(Div, { textSize: "sm", className: "mb-4 border border-error/20", color: "error", surface: "danger-surface", padding: "inline", rounded: "xl", children: errorMessage })), _jsx(DataTable, { rows: rows, isLoading: isLoading, emptyLabel: "No sections found" })] }), _jsxs(Stack, { className: `mt-4 ${__P.p4}`, gap: "3", rounded: "xl", surface: "default", border: "default", children: [_jsxs(Row, { align: "center", justify: "between", gap: "3", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: "Reorder Sections" }), _jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: reindexDraft, disabled: reorderSections.isPending || reorderDraft.length === 0, children: "Reindex 1..N" }), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: undoReorderChange, disabled: reorderSections.isPending || !canUndoReorderChanges, children: "Undo unsaved" }), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: resetToServerOrder, disabled: reorderSections.isPending || !hasReorderChanges, children: "Reset to server" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => reorderSections.mutate(), disabled: !hasReorderChanges || reorderSections.isPending, children: reorderSections.isPending ? "Saving order..." : "Save order" })] })] }), reorderDraft.length === 0 ? (_jsx(Text, { size: "sm", color: "muted", children: "No sections to reorder." })) : (_jsx(Stack, { gap: "sm", children: reorderDraft.map((item, index) => (_jsxs(Div, { layout: "grid", gap: "2", align: "center", className: "grid-cols-[auto_1fr_auto_auto_auto]", rounded: "md", padding: "xs", border: "default", draggable: true, onDragStart: () => setDragIndex(index), onDragOver: (event) => event.preventDefault(), onDrop: () => handleReorderDrop(index), onDragEnd: () => setDragIndex(null), children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "\u2261" }), _jsxs(Text, { size: "sm", color: "primary", children: [item.type, " #", item.order] }), _jsx(Input, { type: "number", min: 1, max: reorderDraft.length, value: String(item.order), onChange: (event) => updateReorderItemOrder(index, Number(event.target.value) || 1), className: "w-24" }), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => moveReorderItem(index, -1), disabled: index === 0, children: "Up" }), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => moveReorderItem(index, 1), disabled: index === reorderDraft.length - 1, children: "Down" })] }, `reorder-${item.id}`))) }))] }), _jsx(ConfirmDeleteModal, { isOpen: seedResetOpen, onClose: () => setSeedResetOpen(false), onConfirm: () => resetSeed.mutate(), title: "Reset homepage sections seed data?", message: "This will reload the 19 default homepage sections from seed data. Any manual changes made in Firestore will be overwritten.", confirmText: "Reset seed", cancelText: "Cancel", isDeleting: resetSeed.isPending, variant: "danger" }), _jsx(Modal, { isOpen: isModalOpen, onClose: () => setIsModalOpen(false), title: "Manage Homepage Section", size: "lg", children: _jsxs(Form, { onSubmit: (event) => {

package/dist/features/admin/constants/filter-tabs.js

@@ -1,3 +1,14 @@
+/**
+ * Admin filter-chip tab sets (SB10-C completion, S8 2026-05-13).
+ *
+ * Match current view-filter values exactly so migrating an inline
+ * `STATUS_OPTIONS` array to one of these constants is a behaviour-preserving
+ * rename. The `ALL_TAB` sentinel collapses to an empty filter string when
+ * clicked.
+ *
+ * Each entry is a typed `{ id, label }` row so views render with one
+ * primitive and stay in sync when statuses are added.
+ */
 export const ALL_TAB = { id: "All", label: "All" };
 /** Admin > Products — listing status filter chip set. */
 export const ADMIN_PRODUCT_STATUS_TABS = [

package/dist/features/auctions/columns/index.js

@@ -1,4 +1,4 @@
-import { buildColumns, } from "../../../ui/columns";
+import { buildColumns } from "../../../ui/columns";
 // --- Auction columns ----------------------------------------------------------
 /**
  * Default admin column definitions for an auction table.

package/dist/features/auctions/schemas/index.d.ts

@@ -58,8 +58,8 @@ export declare const auctionItemSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    status: "draft" | "published" | "archived" | "sold";
     currency: string;
+    status: "draft" | "published" | "archived" | "sold";
     featured: boolean;
     listingType: "auction";
     createdAt: string;
@@ -87,8 +87,8 @@ export declare const auctionItemSchema: z.ZodObject<{
     }[] | undefined;
     storeSlug?: string | undefined;
 }, {
-    status: "draft" | "published" | "archived" | "sold";
     currency: string;
+    status: "draft" | "published" | "archived" | "sold";
     featured: boolean;
     listingType: "auction";
     createdAt: string;

package/dist/features/auth/hooks/useRBAC.js

@@ -51,9 +51,14 @@ export function useRoleChecks() {
 }
 export function useIsOwner(resourceOwnerId) {
     const { user } = useCurrentUser();
+    // useHasRole must run unconditionally on every render — it was previously
+    // called after the early return below, which skips the hook call whenever
+    // !user || !resourceOwnerId, violating the Rules of Hooks (call-count
+    // mismatch risk when that condition flips between renders).
+    const isAdmin = useHasRole("admin");
     if (!user || !resourceOwnerId)
         return false;
-    if (useHasRole("admin"))
+    if (isAdmin)
         return true;
     return user.id === resourceOwnerId;
 }

package/dist/features/blog/columns/index.js

@@ -1,4 +1,4 @@
-import { buildColumns, } from "../../../ui/columns";
+import { buildColumns } from "../../../ui/columns";
 /**
  * Default admin column definitions for a blog post table.
  *

package/dist/features/categories/schemas/firestore.d.ts

@@ -194,7 +194,7 @@ export declare const categoryQueryHelpers: {
     /** @deprecated Use byCategoryType("brand"). */
     readonly brands: () => readonly ["isBrand", "==", true];
     /** SB-UNI B + C + D — discriminator-based listing. */
-    readonly byCategoryType: (type: import("../types").CategoryType) => readonly ["categoryType", "==", import("@mohasinac/appkit").CategoryType];
+    readonly byCategoryType: (type: import("../types").CategoryType) => readonly ["categoryType", "==", import("..").CategoryType];
     readonly sublistings: () => readonly ["categoryType", "==", "sublisting"];
     readonly brandPages: () => readonly ["categoryType", "==", "brand"];
     readonly active: () => readonly ["isActive", "==", true];

package/dist/features/contact/email.js

@@ -8,7 +8,6 @@ import "server-only";
 // → providers.config.ts → @mohasinac/appkit/server → ... → email.tsx).
 // `require()` is opaque to Next's static analyser so the chain stops here.
 function renderToStaticMarkup(el) {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
     const m = require("react-dom/server");
     return m.renderToStaticMarkup(el);
 }

package/dist/features/faq/actions/faq-actions.d.ts

@@ -27,8 +27,8 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     template: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     category: string;
-    order: number;
     priority: number;
+    order: number;
     isActive: boolean;
     question: string;
     showOnHomepage: boolean;
@@ -51,9 +51,9 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
         format?: "html" | "plain" | "markdown" | undefined;
     };
     tags?: string[] | undefined;
+    priority?: number | undefined;
     template?: string | undefined;
     order?: number | undefined;
-    priority?: number | undefined;
     isActive?: boolean | undefined;
     variables?: Record<string, string> | undefined;
     showOnHomepage?: boolean | undefined;
@@ -63,8 +63,8 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     useSiteSettings?: boolean | undefined;
 }>, {
     category: string;
-    order: number;
     priority: number;
+    order: number;
     isActive: boolean;
     question: string;
     showOnHomepage: boolean;
@@ -87,9 +87,9 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
         format?: "html" | "plain" | "markdown" | undefined;
     };
     tags?: string[] | undefined;
+    priority?: number | undefined;
     template?: string | undefined;
     order?: number | undefined;
-    priority?: number | undefined;
     isActive?: boolean | undefined;
     variables?: Record<string, string> | undefined;
     showOnHomepage?: boolean | undefined;
@@ -125,9 +125,9 @@ export declare const faqUpdateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     category?: string | undefined;
     tags?: string[] | undefined;
+    priority?: number | undefined;
     template?: string | undefined;
     order?: number | undefined;
-    priority?: number | undefined;
     isActive?: boolean | undefined;
     variables?: Record<string, string> | undefined;
     question?: string | undefined;
@@ -143,9 +143,9 @@ export declare const faqUpdateSchema: z.ZodObject<{
 }, {
     category?: string | undefined;
     tags?: string[] | undefined;
+    priority?: number | undefined;
     template?: string | undefined;
     order?: number | undefined;
-    priority?: number | undefined;
     isActive?: boolean | undefined;
     variables?: Record<string, string> | undefined;
     question?: string | undefined;

package/dist/features/faq/schemas/index.d.ts

@@ -92,8 +92,8 @@ export declare const faqSchema: z.ZodObject<{
     createdAt?: string | undefined;
     tags?: string[] | undefined;
     updatedAt?: string | undefined;
-    order?: number | undefined;
     priority?: number | undefined;
+    order?: number | undefined;
     stats?: {
         views?: number | undefined;
         helpful?: number | undefined;
@@ -118,8 +118,8 @@ export declare const faqSchema: z.ZodObject<{
     createdAt?: string | undefined;
     tags?: string[] | undefined;
     updatedAt?: string | undefined;
-    order?: number | undefined;
     priority?: number | undefined;
+    order?: number | undefined;
     stats?: {
         views?: number | undefined;
         helpful?: number | undefined;
@@ -283,8 +283,8 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    order: number;
     priority: number;
+    order: number;
     stats: {
         views: number;
         helpful: number;
@@ -322,8 +322,8 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    order: number;
     priority: number;
+    order: number;
     stats: {
         views: number;
         helpful: number;

package/dist/features/forms/Slider.js

@@ -9,7 +9,10 @@ import { cn, LABEL_BASE, ERROR_BASE } from "./utils";
 export function Slider({ value: controlledValue, defaultValue = 0, min = 0, max = 100, step = 1, onChange, label, error, disabled = false, showValue = true, formatValue, className = "", id, }) {
     const [internalValue, setInternalValue] = React.useState(defaultValue);
     const value = controlledValue !== undefined ? controlledValue : internalValue;
-    const sliderId = id ?? React.useId();
+    // React.useId() must run unconditionally on every render — using `id ?? React.useId()`
+    // skips the hook call whenever `id` is provided, violating the Rules of Hooks.
+    const generatedId = React.useId();
+    const sliderId = id ?? generatedId;
     const pct = ((value - min) / (max - min)) * 100;
     const fillRef = useRef(null);
     useEffect(() => {

package/dist/features/forms/Toggle.js

@@ -38,7 +38,10 @@ export function Toggle({ checked: controlledChecked, defaultChecked = false, onC
             setInternalChecked(newChecked);
         onChange?.(newChecked);
     };
-    const toggleId = id ?? React.useId();
+    // React.useId() must run unconditionally on every render — using `id ?? React.useId()`
+    // skips the hook call whenever `id` is provided, violating the Rules of Hooks.
+    const generatedId = React.useId();
+    const toggleId = id ?? generatedId;
     const cfg = SIZE_CONFIG[size];
     return (_jsxs(Row, { className: cn("gap-3", className), children: [_jsx(Button, { type: "button", role: "switch", id: toggleId, "aria-checked": checked, disabled: disabled, onClick: handleChange, className: cn("relative inline-flex items-center rounded-full transition-colors duration-200 focus:outline-none focus:ring-2 focus:ring-primary-500/30 dark:focus:ring-secondary-400/30 focus:ring-offset-2 dark:focus:ring-offset-slate-900", cfg.track, checked
                     ? "bg-primary-600 dark:bg-secondary-500"

package/dist/features/homepage/components/NewsletterBanner.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
 import { useState } from "react";
-import { Button, Div, Heading, Span, Text, } from "../../../ui";
+import { Button, Div, Heading, Span, Text } from "../../../ui";
 import { DynamicBgDiv } from "../../../ui/components/DynamicBgDiv";
 import { Form } from "../../../ui/components/Form";
 import { FieldInput } from "../../../ui/forms/FieldInput";

package/dist/features/layout/BottomActions.js

@@ -1,5 +1,32 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * BottomActions Component
+ *
+ * A fixed-bottom mobile action bar rendered **above** BottomNavbar (bottom-14).
+ * Reads from `BottomActionsContext` — features register their actions via the
+ * `useBottomActions` hook; this component just renders whatever is registered.
+ *
+ * Two modes:
+ *  - **Page mode** — shows registered page-level actions inline (Add to Cart,
+ *    Buy Now, Place Bid, Proceed to Checkout, etc.) with an optional info label.
+ *  - **Bulk mode** — activates when sieveFilter("bulk.selectedCount", SIEVE_OP.GT, "0"); shows:
+ *      • Selection count pill on the left (tap to deselect all)
+ *      • An upward-opening type-picker dropdown (middle, flex-1) — tap to
+ *        choose WHICH action to run; the chosen label is always visible.
+ *      • An "Apply" submit button on the right — executes the selected action,
+ *        styled with the selected action's variant (danger = red, etc.).
+ *
+ * Layout rules:
+ *  - Hidden on lg+ screens (`lg:hidden`) — desktop shows inline action panels.
+ *  - The bar slides up with a 300 ms ease-out transition; `pointer-events-none`
+ *    while off-screen.
+ *
+ * @component
+ * @example
+ * // Automatically rendered by LayoutClient — no manual usage required.
+ * // Features use `useBottomActions` to register their actions.
+ */
 import { useState, useRef, useEffect } from "react";
 import { X, ChevronUp, ChevronDown, Check } from "lucide-react";
 import { useBottomActionsContext } from "./BottomActionsContext";

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

@@ -1,3 +1,39 @@
+/**
+ * BottomActionsContext
+ *
+ * Provides a context for registering page-level mobile action bars.
+ * Features call `useBottomActions` to push actions; the `<BottomActions>`
+ * layout component reads this context and renders the bar above BottomNavbar.
+ *
+ * Supports two modes:
+ *  - Page mode: primary page actions (Add to Cart, Buy Now, Place Bid, etc.)
+ *  - Bulk mode: activated when sieveFilter("bulk.selectedCount", SIEVE_OP.GT, "0") — shows selection
+ *    count + custom bulk action buttons (Delete, Archive, Export, etc.)
+ *
+ * @example — product detail page
+ * ```tsx
+ * useBottomActions({
+ * actions: [
+ * { id: "wishlist", icon: <Heart className="w-4 h-4" />, label: t("wishlist"), variant: "ghost", grow: false, onClick: handleWishlist },
+ * { id: "cart", label: t("addToCart"), variant: "outline", onClick: handleAddToCart },
+ * { id: "buy", label: t("buyNow"), variant: "primary", onClick: handleBuyNow },
+ * ],
+ * });
+ * ```
+ *
+ * @example — admin listing with bulk select
+ * ```tsx
+ * useBottomActions({
+ * bulk: {
+ * selectedCount: selectedIds.length,
+ * onClearSelection: () => setSelectedIds([]),
+ * actions: [
+ * { id: "delete", label: t("bulkDelete", { count: selectedIds.length }), variant: "danger", onClick: handleBulkDelete },
+ * ],
+ * },
+ * });
+ * ```
+ */
 import React from "react";
 import type { ButtonProps } from "../../ui";
 export interface BottomAction {

package/dist/features/layout/BottomActionsContext.js

@@ -1,5 +1,41 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * BottomActionsContext
+ *
+ * Provides a context for registering page-level mobile action bars.
+ * Features call `useBottomActions` to push actions; the `<BottomActions>`
+ * layout component reads this context and renders the bar above BottomNavbar.
+ *
+ * Supports two modes:
+ *  - Page mode: primary page actions (Add to Cart, Buy Now, Place Bid, etc.)
+ *  - Bulk mode: activated when sieveFilter("bulk.selectedCount", SIEVE_OP.GT, "0") — shows selection
+ *    count + custom bulk action buttons (Delete, Archive, Export, etc.)
+ *
+ * @example — product detail page
+ * ```tsx
+ * useBottomActions({
+ * actions: [
+ * { id: "wishlist", icon: <Heart className="w-4 h-4" />, label: t("wishlist"), variant: "ghost", grow: false, onClick: handleWishlist },
+ * { id: "cart", label: t("addToCart"), variant: "outline", onClick: handleAddToCart },
+ * { id: "buy", label: t("buyNow"), variant: "primary", onClick: handleBuyNow },
+ * ],
+ * });
+ * ```
+ *
+ * @example — admin listing with bulk select
+ * ```tsx
+ * useBottomActions({
+ * bulk: {
+ * selectedCount: selectedIds.length,
+ * onClearSelection: () => setSelectedIds([]),
+ * actions: [
+ * { id: "delete", label: t("bulkDelete", { count: selectedIds.length }), variant: "danger", onClick: handleBulkDelete },
+ * ],
+ * },
+ * });
+ * ```
+ */
 import { createContext, useCallback, useContext, useMemo, useRef, useState, } from "react";
 const EMPTY = { actions: [] };
 const BottomActionsContext = createContext(null);

package/dist/features/orders/schemas/index.d.ts

@@ -521,8 +521,8 @@ export declare const orderFirestoreSchema: z.ZodObject<{
         bin: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    status: "cancelled" | "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "return_requested" | "returned";
     currency: string;
+    status: "cancelled" | "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "return_requested" | "returned";
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
@@ -666,8 +666,8 @@ export declare const orderFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough"> | undefined;
     shippingProofUploadedBy?: string | undefined;
 }, {
-    status: "cancelled" | "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "return_requested" | "returned";
     currency: string;
+    status: "cancelled" | "pending" | "processing" | "refunded" | "confirmed" | "shipped" | "delivered" | "return_requested" | "returned";
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;

package/dist/features/payments/schemas/index.d.ts

@@ -150,8 +150,8 @@ export declare const payoutFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">>]>>;
 }, "strip", z.ZodTypeAny, {
-    status: "pending" | "paid" | "failed" | "processing";
     currency: string;
+    status: "pending" | "paid" | "failed" | "processing";
     storeId: string;
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
@@ -200,8 +200,8 @@ export declare const payoutFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
-    status: "pending" | "paid" | "failed" | "processing";
     currency: string;
+    status: "pending" | "paid" | "failed" | "processing";
     storeId: string;
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
@@ -289,8 +289,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
     status: z.ZodDefault<z.ZodEnum<["pending", "authorized", "captured", "failed", "refunded", "partially_refunded"]>>;
     createdAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "pending" | "failed" | "captured" | "authorized" | "refunded" | "partially_refunded";
     currency: string;
+    status: "pending" | "failed" | "captured" | "authorized" | "refunded" | "partially_refunded";
     id: string;
     amount: number;
     orderId: string;
@@ -302,8 +302,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
     amount: number;
     orderId: string;
     gateway: "bank_transfer" | "upi" | "razorpay" | "stripe" | "paypal" | "cod" | "whatsapp";
-    status?: "pending" | "failed" | "captured" | "authorized" | "refunded" | "partially_refunded" | undefined;
     currency?: string | undefined;
+    status?: "pending" | "failed" | "captured" | "authorized" | "refunded" | "partially_refunded" | undefined;
     createdAt?: string | undefined;
     gatewayPaymentId?: string | undefined;
 }>;

package/dist/features/products/repository/products.repository.js

@@ -4,7 +4,7 @@ import { DatabaseError } from "../../../errors";
 import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
 import { cacheManager } from "../../../core";
 import { generateUniqueId, slugify, buildSearchTokens, tokenizeQuery, generateBarcodeId } from "../../../utils";
-import { PRODUCT_COLLECTION, ProductStatusValues, } from "../schemas";
+import { PRODUCT_COLLECTION, ProductStatusValues } from "../schemas";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
 /**
  * Canonical listing-kind tokens used in `listingType`. Note: the public Sieve

package/dist/features/products/schemas/product-features.validators.d.ts

@@ -22,7 +22,7 @@ export declare const productFeatureAdminCreateSchema: z.ZodObject<{
     isActive: z.ZodBoolean;
     displayOrder: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    category: "custom" | "seller" | "auction" | "condition" | "shipping" | "preorder" | "platform";
+    category: "seller" | "custom" | "auction" | "condition" | "shipping" | "preorder" | "platform";
     label: string;
     scope: "store" | "platform";
     icon: string;
@@ -33,7 +33,7 @@ export declare const productFeatureAdminCreateSchema: z.ZodObject<{
     description?: string | undefined;
     iconColor?: string | undefined;
 }, {
-    category: "custom" | "seller" | "auction" | "condition" | "shipping" | "preorder" | "platform";
+    category: "seller" | "custom" | "auction" | "condition" | "shipping" | "preorder" | "platform";
     label: string;
     scope: "store" | "platform";
     icon: string;
@@ -55,7 +55,7 @@ export declare const productFeatureStoreCreateSchema: z.ZodObject<{
     isActive: z.ZodBoolean;
     displayOrder: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    category: "custom" | "seller" | "auction" | "condition" | "shipping" | "preorder" | "platform";
+    category: "seller" | "custom" | "auction" | "condition" | "shipping" | "preorder" | "platform";
     label: string;
     icon: string;
     isActive: boolean;
@@ -64,7 +64,7 @@ export declare const productFeatureStoreCreateSchema: z.ZodObject<{
     description?: string | undefined;
     iconColor?: string | undefined;
 }, {
-    category: "custom" | "seller" | "auction" | "condition" | "shipping" | "preorder" | "platform";
+    category: "seller" | "custom" | "auction" | "condition" | "shipping" | "preorder" | "platform";
     label: string;
     icon: string;
     isActive: boolean;
@@ -84,7 +84,7 @@ export declare const productFeatureUpdateSchema: z.ZodObject<{
     isActive: z.ZodOptional<z.ZodBoolean>;
     displayOrder: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    category?: "custom" | "seller" | "auction" | "condition" | "shipping" | "preorder" | "platform" | undefined;
+    category?: "seller" | "custom" | "auction" | "condition" | "shipping" | "preorder" | "platform" | undefined;
     description?: string | undefined;
     label?: string | undefined;
     icon?: string | undefined;
@@ -93,7 +93,7 @@ export declare const productFeatureUpdateSchema: z.ZodObject<{
     iconColor?: string | undefined;
     productTypes?: ("auction" | "prize-draw" | "classified" | "digital-code" | "live" | "all" | "product" | "preorder")[] | undefined;
 }, {
-    category?: "custom" | "seller" | "auction" | "condition" | "shipping" | "preorder" | "platform" | undefined;
+    category?: "seller" | "custom" | "auction" | "condition" | "shipping" | "preorder" | "platform" | undefined;
     description?: string | undefined;
     label?: string | undefined;
     icon?: string | undefined;

package/dist/features/promotions/repository/claimed-coupons.repository.js

@@ -7,7 +7,7 @@
  */
 import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
 import { normalizeError } from "../../../errors/normalize";
-import { CLAIMED_COUPONS_COLLECTION, createClaimedCouponId, } from "../schemas";
+import { CLAIMED_COUPONS_COLLECTION, createClaimedCouponId } from "../schemas";
 import { DatabaseError } from "../../../errors";
 import { COUPON_USAGE_FIELDS } from "../../../constants/field-names";
 export class ClaimedCouponsRepository extends BaseRepository {

package/dist/features/reviews/columns/index.js

@@ -1,4 +1,4 @@
-import { buildColumns, } from "../../../ui/columns";
+import { buildColumns } from "../../../ui/columns";
 /**
  * Default admin column definitions for a review table.
  *

package/dist/features/search/schemas/index.d.ts

@@ -24,8 +24,8 @@ export declare const searchProductItemSchema: z.ZodObject<{
     title: string;
     slug: string;
     id: string;
-    status?: string | undefined;
     currency?: string | undefined;
+    status?: string | undefined;
     featured?: boolean | undefined;
     listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle" | undefined;
     isPromoted?: boolean | undefined;
@@ -35,8 +35,8 @@ export declare const searchProductItemSchema: z.ZodObject<{
     title: string;
     slug: string;
     id: string;
-    status?: string | undefined;
     currency?: string | undefined;
+    status?: string | undefined;
     featured?: boolean | undefined;
     listingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "bundle" | undefined;
     isPromoted?: boolean | undefined;