@mohasinac/appkit 3.3.3 → 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/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/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;

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

@@ -9,7 +9,7 @@
  * (src/actions/seller.actions.ts) alongside the other seller server actions.
  */
 import type { JsonValue } from "../../../schemas/types";
-import type { SellerPayoutDetails, SellerShippingConfig } from "../../auth/schemas/firestore";
+import type { SellerPayoutDetails } from "../../auth/schemas/firestore";
 import type { StoreDocument } from "../../stores/schemas/firestore";
 import type { ProductDocument } from "../../products/schemas/firestore";
 import type { OrderDocument } from "../../orders/schemas/firestore";
@@ -115,7 +115,7 @@ export declare function requestPayout(userId: string, userName: string, userEmai
 export declare function bulkSellerOrder(userId: string, userRole: string, userDisplayName: string, userEmail: string, orderIds: string[]): Promise<BulkSellerOrderResult>;
 export declare function createSellerProduct(userId: string, userName: string, userEmail: string, input: Record<string, JsonValue>): Promise<void>;
 export declare function getSellerStore(userId: string): Promise<StoreDocument | null>;
-export declare function getSellerShipping(userId: string): Promise<SellerShippingConfig | null>;
+export declare function getSellerShipping(userId: string): Promise<import("../../auth").SellerShippingConfig | null>;
 export declare function getSellerPayoutSettings(userId: string): Promise<SellerPayoutDetails | {
     method: string;
     isConfigured: boolean;

package/dist/features/seller/components/SellerOrdersView.js

@@ -358,9 +358,12 @@ export function SellerOrdersView({ orderDetailApiBase = SELLER_ENDPOINTS.ORDERS,
         buildBulkAction(ACTIONS.STORE["set-location"], () => setSetLocationOpen(true), { icon: _jsx(MapPin, { className: "w-4 h-4" }) }),
         buildBulkAction(ACTIONS.STORE["request-payout"], () => void requestPayoutForSelection(), { variant: "primary" }),
     ];
+    // useBottomActions must run unconditionally on every render — it was
+    // previously called after the `hasChildren` early return below, which
+    // skips the hook call in passthrough mode, violating the Rules of Hooks.
+    useBottomActions(selection.selectedCount > 0 ? { bulk: { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: bulkActions } } : {});
     if (hasChildren) {
         return _jsx(ListingLayout, { portal: "seller", ...props, children: children });
     }
-    useBottomActions(selection.selectedCount > 0 ? { bulk: { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: bulkActions } } : {});
     return (_jsxs(Div, { className: "min-h-screen", children: [_jsx(ListingToolbar, { filterCount: activeFilterCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: "Search by order ID or buyer name", onSearchChange: setSearchInput, onSearchCommit: commitSearch, sortValue: table.get("sort") || DEFAULT_SORT, sortOptions: SORT_OPTIONS, onSortChange: (v) => { table.set("sort", v); }, showTableView: true, view: view, onViewChange: (v) => setView(v), onResetAll: resetAll, hasActiveState: hasActiveState }), totalPages > 1 && (_jsx(Row, { border: "bottom", className: "sticky top-[calc(var(--header-height,0px)+44px)] z-10 backdrop-blur-sm", surface: "default", padding: "toolbar", justify: "center", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) })), selection.selectedIds.length > 0 && (_jsx(Div, { border: "default", paddingX: "x-sm-md", className: "sticky top-[calc(var(--header-height,0px)+88px)] z-20 backdrop-blur-sm border-b", surface: "default", padding: "y-xs", children: _jsx(BulkActionBar, { selectedCount: selection.selectedIds.length, onClearSelection: selection.clearSelection, actions: bulkActions }) })), _jsxs(Div, { paddingX: "x-sm-md", padding: "y-md", children: [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, columns: columns, isLoading: isLoading, emptyLabel: "No orders yet", selectedIds: selection.selectedIdSet, onToggleSelect: selection.toggle, onToggleSelectAll: () => selection.toggleAll(), renderRowActions: renderRowActions })] }), _jsx(ListingFilterDrawer, { open: filterOpen, onClose: () => setFilterOpen(false), onApply: applyFilters, onClear: clearFilters, activeCount: activeFilterCount, children: _jsx(FilterChipGroup, { label: "Status", tabs: STATUS_OPTIONS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) }) }), selectedOrderId && (_jsx(OrderDetailDrawer, { orderId: selectedOrderId, apiBase: orderDetailApiBase, onClose: () => setSelectedOrderId(null) })), setLocationOpen && (_jsx(PhysicalLocationModal, { count: selection.selectedIds.length, onSave: handleSetLocation, onClose: () => setSetLocationOpen(false) }))] }));
 }

package/dist/features/seller/components/SellerProductsView.js

@@ -214,6 +214,41 @@ export function SellerProductsView({ onDeleteProduct, onCreateClick, children, .
         .filter((r) => !deletedIds.has(r.id))
         .map((r) => statusOverrides.has(r.id) ? { ...r, status: statusOverrides.get(r.id) } : r);
     const selection = useBulkSelection({ items: visibleRows, keyExtractor: (r) => r.id });
+    // handleBulkPrintLabels/handleSetLocation (useCallback) and useBottomActions
+    // must run unconditionally on every render — they were previously declared
+    // after the `hasChildren` early return below, which skips these hook calls
+    // in passthrough mode, violating the Rules of Hooks.
+    const handleBulkPrintLabels = useCallback(() => {
+        const ids = selection.selectedIds.join(",");
+        void dispatch({
+            type: "NAVIGATE",
+            href: `${String(ROUTES.STORE.INVENTORY_PRINT)}?type=product&ids=${ids}&autoprint=1`,
+        });
+    }, [selection.selectedIds, dispatch]);
+    const handleSetLocation = useCallback(async (loc) => {
+        try {
+            const res = await fetch(SELLER_ENDPOINTS.PRODUCTS_BULK_LOCATION, {
+                method: "PATCH",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ productIds: selection.selectedIds, physicalLocation: loc }),
+            });
+            if (!res.ok) {
+                const body = await res.json().catch(() => null);
+                throw new Error(body?.error ?? "Failed to update location");
+            }
+            showToast("Location updated.", "success");
+            setSetLocationOpen(false);
+        }
+        catch (err) {
+            void normalizeError(err);
+            showToast(err instanceof Error ? err.message : "Failed to update location.", "error");
+        }
+    }, [selection.selectedIds, showToast]);
+    const bulkActions = [
+        buildBulkAction(ACTIONS.STORE["print-labels"], handleBulkPrintLabels, { icon: _jsx(Printer, { className: "w-4 h-4" }) }),
+        buildBulkAction(ACTIONS.STORE["set-location"], () => setSetLocationOpen(true), { icon: _jsx(MapPin, { className: "w-4 h-4" }) }),
+    ];
+    useBottomActions(selection.selectedCount > 0 ? { bulk: { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: bulkActions } } : {});
     if (hasChildren) {
         return (_jsx(ListingLayout, { portal: "seller", ...props, children: children }));
     }
@@ -262,37 +297,6 @@ export function SellerProductsView({ onDeleteProduct, onCreateClick, children, .
             setPublishingId(null);
         }
     };
-    const handleBulkPrintLabels = useCallback(() => {
-        const ids = selection.selectedIds.join(",");
-        void dispatch({
-            type: "NAVIGATE",
-            href: `${String(ROUTES.STORE.INVENTORY_PRINT)}?type=product&ids=${ids}&autoprint=1`,
-        });
-    }, [selection.selectedIds, dispatch]);
-    const handleSetLocation = useCallback(async (loc) => {
-        try {
-            const res = await fetch(SELLER_ENDPOINTS.PRODUCTS_BULK_LOCATION, {
-                method: "PATCH",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({ productIds: selection.selectedIds, physicalLocation: loc }),
-            });
-            if (!res.ok) {
-                const body = await res.json().catch(() => null);
-                throw new Error(body?.error ?? "Failed to update location");
-            }
-            showToast("Location updated.", "success");
-            setSetLocationOpen(false);
-        }
-        catch (err) {
-            void normalizeError(err);
-            showToast(err instanceof Error ? err.message : "Failed to update location.", "error");
-        }
-    }, [selection.selectedIds, showToast]);
-    const bulkActions = [
-        buildBulkAction(ACTIONS.STORE["print-labels"], handleBulkPrintLabels, { icon: _jsx(Printer, { className: "w-4 h-4" }) }),
-        buildBulkAction(ACTIONS.STORE["set-location"], () => setSetLocationOpen(true), { icon: _jsx(MapPin, { className: "w-4 h-4" }) }),
-    ];
-    useBottomActions(selection.selectedCount > 0 ? { bulk: { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: bulkActions } } : {});
     return (_jsxs(_Fragment, { children: [_jsxs(Div, { className: "min-h-screen", children: [_jsx(ListingToolbar, { filterCount: activeFilterCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: "Search products by name\u2026", onSearchChange: setSearchInput, onSearchCommit: commitSearch, sortValue: table.get("sort") || DEFAULT_SORT, sortOptions: SORT_OPTIONS, onSortChange: (v) => { table.set("sort", v); }, showTableView: true, view: view, onViewChange: (v) => setView(v), onResetAll: resetAll, hasActiveState: hasActiveState, toggles: [
                             { label: "Show sold", active: showSold, onChange: (next) => table.set("showSold", next ? "true" : "") },
                         ], extra: onCreateClick ? (_jsx(Button, { variant: "primary", size: "sm", onClick: onCreateClick, children: "+ New Listing" })) : null }), _jsx(TypeDropdown, { active: listingKind, onChange: handleKindChange }), totalPages > 1 && (_jsx(Row, { className: "sticky top-[calc(var(--header-height,0px)+44px)] z-10 bg-[var(--appkit-color-surface)]/95 backdrop-blur-sm border-b border-[var(--appkit-color-border)] py-[0.375rem]", padding: "x-sm", justify: "center", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) })), selection.selectedIds.length > 0 && (_jsx(Div, { paddingX: "x-sm-lg-md", className: "sticky top-[calc(var(--header-height,0px)+88px)] z-20 bg-[var(--appkit-color-surface)]/95 backdrop-blur-sm border-b border-[var(--appkit-color-border)]", padding: "y-xs", children: _jsx(BulkActionBar, { selectedCount: selection.selectedIds.length, onClearSelection: selection.clearSelection, actions: bulkActions }) })), _jsxs(Div, { paddingX: "x-sm-lg-md", padding: "y-md", children: [errorMessage && (_jsx(Alert, { variant: "error", className: "mb-4", children: errorMessage })), view !== "table" && (_jsx(SellerProductsCards, { view: view, rows: visibleRows, isLoading: isLoading, listingKind: listingKind, selectedIds: selection.selectedIdSet, toggle: selection.toggle, onEdit: handleEdit, onDuplicate: (row) => void handleDuplicate(row), onDelete: onDeleteProduct ? (row) => void handleDelete(row) : undefined })), view === "table" && (_jsx(DataTable, { columns: PRODUCT_COLUMNS, rows: visibleRows, isLoading: isLoading, emptyLabel: listingKind !== "all"