@mohasinac/appkit 4.13.0 → 4.14.0

package/dist/index.d.ts

@@ -45,7 +45,7 @@ export { DropdownTrigger } from "./ui/index";
 export { FormFieldSpan } from "./ui/index";
 export { FormGrid } from "./ui/index";
 export { FormGroup } from "./ui/index";
-export type { FormShellStep, FormShellContextValue } from "./ui/index";
+export type { FormShellStep, FormShellNav, FormShellContextValue } from "./ui/index";
 export type { FieldInputProps } from "./ui/index";
 export { FieldInput } from "./ui/index";
 export type { FieldSelectProps } from "./ui/index";
@@ -966,7 +966,6 @@ export { ProfileView } from "./features/account/index";
 export { UserAccountHubView } from "./features/account/index";
 export { UserAddressesView } from "./features/account/index";
 export { UserNotificationsView } from "./features/account/index";
-export { UserOffersView } from "./features/account/index";
 export { UserOffersPanel } from "./features/account/index";
 export type { UserOffersPanelProps } from "./features/account/index";
 export { UserOrderTrackView } from "./features/account/index";
@@ -1052,8 +1051,6 @@ export type { UserNotification } from "./features/account/index";
 export type { UserNotificationsViewLabels } from "./features/account/index";
 export type { UserNotificationsViewProps } from "./features/account/index";
 export type { UserOffer } from "./features/account/index";
-export type { UserOffersViewLabels } from "./features/account/index";
-export type { UserOffersViewProps } from "./features/account/index";
 export type { UserOrder } from "./features/account/index";
 export type { UserOrderTrackViewLabels } from "./features/account/index";
 export type { UserOrderTrackViewProps } from "./features/account/index";
@@ -1075,6 +1072,7 @@ export { AdminAnalyticsView } from "./features/admin/index";
 export { AdminAdsView } from "./features/admin/index";
 export { AdminAdEditorView } from "./features/admin/index";
 export { AdminBidsView } from "./features/admin/index";
+export { AdminOffersView } from "./features/admin/index";
 export { AdminBlogView } from "./features/admin/index";
 export { AdminBlogEditorView } from "./features/admin/index";
 export type { AdminBlogEditorViewProps } from "./features/admin/index";
@@ -1236,6 +1234,7 @@ export type { AdminAnalyticsViewProps } from "./features/admin/index";
 export type { AdminAdsViewProps } from "./features/admin/index";
 export type { AdminAdEditorViewProps } from "./features/admin/index";
 export type { AdminBidsViewProps } from "./features/admin/index";
+export type { AdminOffersViewProps } from "./features/admin/index";
 export type { AdminBlogViewProps } from "./features/admin/index";
 export type { AdminCarouselViewProps } from "./features/admin/index";
 export type { AdminCategoriesViewProps } from "./features/admin/index";
@@ -2280,6 +2279,8 @@ export type { OrderDocument } from "./features/orders/index";
 export type { OrderRefundEvent, RefundType } from "./features/orders/schemas/firestore";
 export { MANUAL_PAYMENT_METHODS, isManualPaymentMethod, PAYMENT_REVIEW_QUEUE_MODES, isPaymentReviewQueueMode, PAYMENT_REVIEW_QUEUE_SCAN_LIMIT, } from "./features/orders/constants/payment-window";
 export type { PaymentReviewQueueMode } from "./features/orders/constants/payment-window";
+export { ORDER_SCOPE_VALUES, ORDER_SCOPE_TABS, isOrderScope, statusesForScope, mergeOrderScopeFilter, } from "./features/orders/constants/order-scope";
+export type { OrderScope } from "./features/orders/constants/order-scope";
 export type { OrderDocumentItem } from "./features/orders/index";
 export type { OrderFilterVariant } from "./features/orders/index";
 export type { OrderFiltersProps } from "./features/orders/index";
@@ -2392,7 +2393,6 @@ export type { BundleBuyNowCtaProps } from "./features/categories/components/Bund
 export { BidHistory } from "./features/products/index";
 export { DEFAULT_PRODUCT_DATA } from "./features/products/index";
 export { InteractiveProductCard } from "./features/products/index";
-export { MakeOfferForm } from "./features/products/index";
 export { ACTION_ID, ACTION_META, DETAIL_ACTIONS, MOBILE_PRIMARY_ACTIONS, LISTING_BULK_ACTIONS } from "./features/products/index";
 export type { ActionId, ActionMeta, ActionVariant } from "./features/products/index";
 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";
@@ -2464,7 +2464,10 @@ export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLa
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers";
 export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
 export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, WhatsAppNotifyFeeRates, GiftWrapFeeRates, ShipmentProtectionFeeRates, GstBreakdown, } from "./_internal/shared/fees/calculator";
-export { checkEmiEligibility, computeEmiSchedule } from "./_internal/shared/features/emi/schedule";
+export { checkEmiEligibility, computeEmiSchedule, computeBuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
+export type { BuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
+export { toBuyerFacingFees, toBuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees";
+export type { BuyerFacingFees, BuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees";
 export type { EmiSettings, EmiIneligibleReason, EmiEligibility, EmiInstallmentPlan, EmiScheduleResult, } from "./_internal/shared/features/emi/schedule";
 export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, isEffectiveAdminUser, } from "./features/auth/role-predicates";
 export { sanitizeProductForPublic, sanitizeProductsForPublic } from "./features/products/index";
@@ -2484,7 +2487,6 @@ export type { BidHistoryEntry } from "./features/products/index";
 export type { BidHistoryProps } from "./features/products/index";
 export type { InteractiveProductCardProps } from "./features/products/index";
 export type { ListingType } from "./features/products/index";
-export type { MakeOfferFormProps } from "./features/products/index";
 export type { PlaceBidFormProps } from "./features/products/index";
 export type { PreOrderDetailViewProps } from "./features/products/index";
 export type { ProductAdminUpdateInput } from "./features/products/index";
@@ -2721,8 +2723,6 @@ export { SellerGroupedListingsView as StoreGroupedListingsView } from "./feature
 export { SellerAnalyticsAlertsView } from "./features/seller/index";
 export type { SellerAnalyticsAlertsViewProps } from "./features/seller/index";
 export { SellerAnalyticsAlertsView as StoreAnalyticsAlertsView } from "./features/seller/index";
-export { SellerOffersPanel } from "./features/seller/index";
-export type { SellerOffersPanelProps, SellerOfferAction } from "./features/seller/index";
 export { SellerOrdersView } from "./features/seller/index";
 export { SellerOrderDetailPanel } from "./features/seller/index";
 export { SellerPayoutHistoryTable } from "./features/seller/index";
@@ -2858,7 +2858,6 @@ export { requestPayout } from "./features/seller/server";
 export { respondToOffer } from "./features/seller/server";
 export { sellerCouponsGET } from "./features/seller/server";
 export { sellerDeleteProduct } from "./features/seller/server";
-export { sellerOffersGET } from "./features/seller/server";
 export { sellerProductsGET } from "./features/seller/server";
 export { sellerStoreGET } from "./features/seller/server";
 export { sellerUpdateProduct } from "./features/seller/server";
@@ -3196,6 +3195,10 @@ export { QuickFormDrawer } from "./features/shell/index";
 export type { QuickFieldType, QuickFieldDef, QuickFormDrawerProps } from "./features/shell/index";
 export { StepForm, StepFormActions, StepIndicator } from "./features/shell/index";
 export type { StepDef, StepFormProps, StepFormActionsProps } from "./features/shell/index";
+export { SectionForm, useSectionFormNav, orderSections, buildFieldToSectionIndex, sectionAnchorId, } from "./features/shell/index";
+export type { SectionDef, SectionFormProps, UseSectionFormNavResult } from "./features/shell/index";
+export { deriveQuickFields, deriveQuickFieldNames, allDefinitionFields, applyDerive, assertNoDeriveCollision, humaniseFieldName, } from "./features/shell/index";
+export type { EntityFormDefinition } from "./features/shell/index";
 export { renderProductOgImage } from "./_internal/server/features/products/og";
 export type { ProductOgData } from "./_internal/server/features/products/og";
 export { renderAuctionOgImage } from "./_internal/server/features/auctions/og";

package/dist/index.js

@@ -1964,8 +1964,6 @@ export { UserAddressesView } from "./features/account/index";
 // UserNotificationsView - Component for user notifications view.
 export { UserNotificationsView } from "./features/account/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// UserOffersView - Component for user offers view.
-export { UserOffersView } from "./features/account/index";
 // [CLIENT]-Runs in browser only â€" interactive buyer offers panel with accept/withdraw actions.
 // UserOffersPanel - Interactive buyer offers panel.
 export { UserOffersPanel } from "./features/account/index";
@@ -2085,6 +2083,8 @@ export { AdminAdEditorView } from "./features/admin/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // AdminBidsView - Component for admin bids view.
 export { AdminBidsView } from "./features/admin/index";
+// AdminOffersView - Component for admin offers view.
+export { AdminOffersView } from "./features/admin/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // AdminBlogView - Component for admin blog view.
 export { AdminBlogView } from "./features/admin/index";
@@ -4170,6 +4170,7 @@ export { useTrackOrder } from "./features/orders/index";
 // queue discriminator. Pure data + predicates — no firebase-admin in the
 // import chain, so safe on the main barrel (see "appkit Export Rules").
 export { MANUAL_PAYMENT_METHODS, isManualPaymentMethod, PAYMENT_REVIEW_QUEUE_MODES, isPaymentReviewQueueMode, PAYMENT_REVIEW_QUEUE_SCAN_LIMIT, } from "./features/orders/constants/payment-window";
+export { ORDER_SCOPE_VALUES, ORDER_SCOPE_TABS, isOrderScope, statusesForScope, mergeOrderScopeFilter, } from "./features/orders/constants/order-scope";
 // ./features/orders/server
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // cancelOrderForUser - Shared export for cancel order for user.
@@ -4334,8 +4335,6 @@ export { DEFAULT_PRODUCT_DATA } from "./features/products/index";
 // InteractiveProductCard - Component for interactive product card.
 export { InteractiveProductCard } from "./features/products/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// MakeOfferForm - Component for make offer form.
-export { MakeOfferForm } from "./features/products/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // ACTION_ID / ACTION_META / DETAIL_ACTIONS / MOBILE_PRIMARY_ACTIONS / LISTING_BULK_ACTIONS - Single source of truth for all product-type action constants.
 // Product / listing actions
@@ -4474,7 +4473,10 @@ export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers";
 // Shared fee calculator — platform/gateway/GST/COD handling/WhatsApp-addon fee math (pure, client-safe).
 export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
 // EMI eligibility + schedule computation (pure, client-safe — used for checkout quotes).
-export { checkEmiEligibility, computeEmiSchedule } from "./_internal/shared/features/emi/schedule";
+export { checkEmiEligibility, computeEmiSchedule, computeBuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
+// Buyer-facing projections of siteSettings.commissions / .emi — the single
+// definition of "safe to send to a browser" for fee data. See fees.ts header.
+export { toBuyerFacingFees, toBuyerEmiSettings, } from "./_internal/shared/features/site-settings/fees";
 // User-role predicates â€" SB-UNI-E 2026-05-13.
 export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, isEffectiveAdminUser, } from "./features/auth/role-predicates";
 // [SERVER-ONLY]-Safe in browser but intended for server routes.
@@ -4915,8 +4917,6 @@ export { SellerGroupedListingsView as StoreGroupedListingsView } from "./feature
 export { SellerAnalyticsAlertsView } from "./features/seller/index";
 export { SellerAnalyticsAlertsView as StoreAnalyticsAlertsView } from "./features/seller/index";
 // [CLIENT]-Runs in browser only â€" uses useState/useEffect/fetch.
-// SellerOffersPanel - Interactive panel with accept/decline/counter actions for seller offers.
-export { SellerOffersPanel } from "./features/seller/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // SellerOrdersView - Component for seller orders view.
 export { SellerOrdersView } from "./features/seller/index";
@@ -5132,8 +5132,6 @@ export { sellerCouponsGET } from "./features/seller/server";
 // sellerDeleteProduct - Shared export for seller delete product.
 export { sellerDeleteProduct } from "./features/seller/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sellerOffersGET - Shared export for seller offers get.
-export { sellerOffersGET } from "./features/seller/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // sellerProductsGET - Shared export for seller products get.
 export { sellerProductsGET } from "./features/seller/server";
@@ -5602,6 +5600,13 @@ export { CommandPalette, useCommandPaletteHotkey } from "./features/shell/index"
 export { QuickFormDrawer } from "./features/shell/index";
 // [CLIENT] StepForm â€" multi-step wizard with step indicator, prev/next, localStorage persistence.
 export { StepForm, StepFormActions, StepIndicator } from "./features/shell/index";
+// [CLIENT] SectionForm — collapsible-section form engine replacing StepForm.
+// Required section first and always open, one shared submit at the bottom, no
+// per-section gate blocking a later section.
+export { SectionForm, useSectionFormNav, orderSections, buildFieldToSectionIndex, sectionAnchorId, } from "./features/shell/index";
+// [CLIENT] EntityFormDefinition — one definition per entity, rendered as both a
+// self-submitting quick drawer and a full page, so the two cannot drift.
+export { deriveQuickFields, deriveQuickFieldNames, allDefinitionFields, applyDerive, assertNoDeriveCollision, humaniseFieldName, } from "./features/shell/index";
 // OG image renderers (server-side JSX, used with next/og ImageResponse)
 export { renderProductOgImage } from "./_internal/server/features/products/og";
 export { renderAuctionOgImage } from "./_internal/server/features/auctions/og";

package/dist/next/routing/route-map.d.ts

@@ -64,6 +64,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly HELP_ACCOUNT: "/help/account";
         readonly TERMS: "/terms";
         readonly PRIVACY: "/privacy";
+        readonly ETHICS: "/ethics";
+        readonly CODE_OF_CONDUCT: "/code-of-conduct";
         readonly SECURITY: "/security";
         readonly TRACK_ORDER: "/track";
         readonly SELLER_GUIDE: "/seller-guide";
@@ -293,6 +295,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ORDERS: "/admin/orders";
         readonly ORDER_DETAIL: (id: string) => string;
         readonly BIDS: "/admin/bids";
+        readonly OFFERS: "/admin/offers";
         readonly BLOG: "/admin/blog";
         readonly BLOG_NEW: "/admin/blog/new";
         readonly BLOG_EDIT: (id: string) => string;
@@ -436,6 +439,8 @@ export declare const ROUTES: {
         readonly HELP_ACCOUNT: "/help/account";
         readonly TERMS: "/terms";
         readonly PRIVACY: "/privacy";
+        readonly ETHICS: "/ethics";
+        readonly CODE_OF_CONDUCT: "/code-of-conduct";
         readonly SECURITY: "/security";
         readonly TRACK_ORDER: "/track";
         readonly SELLER_GUIDE: "/seller-guide";
@@ -665,6 +670,7 @@ export declare const ROUTES: {
         readonly ORDERS: "/admin/orders";
         readonly ORDER_DETAIL: (id: string) => string;
         readonly BIDS: "/admin/bids";
+        readonly OFFERS: "/admin/offers";
         readonly BLOG: "/admin/blog";
         readonly BLOG_NEW: "/admin/blog/new";
         readonly BLOG_EDIT: (id: string) => string;
@@ -840,6 +846,6 @@ export declare const SELLER_ROUTES: {
     readonly GUIDE_SETTINGS: "/store/guide/settings";
     readonly GUIDE_WHATSAPP: "/store/guide/whatsapp";
 };
-export declare const PUBLIC_ROUTES: readonly ["/", string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, "/unauthorized", "/auth/login", "/auth/register", "/auth/forgot-password", "/auth/reset-password", "/auth/verify-email"];
+export declare const PUBLIC_ROUTES: readonly ["/", string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, "/unauthorized", "/auth/login", "/auth/register", "/auth/forgot-password", "/auth/reset-password", "/auth/verify-email"];
 export declare const PROTECTED_ROUTES: readonly [string, string, string, string, string, string, string];
 export declare const AUTH_ROUTES: readonly ["/auth/login", "/auth/register"];

package/dist/next/routing/route-map.js

@@ -57,6 +57,8 @@ export const DEFAULT_ROUTE_MAP = {
         HELP_ACCOUNT: "/help/account",
         TERMS: "/terms",
         PRIVACY: "/privacy",
+        ETHICS: "/ethics",
+        CODE_OF_CONDUCT: "/code-of-conduct",
         SECURITY: "/security",
         TRACK_ORDER: "/track",
         SELLER_GUIDE: "/seller-guide",
@@ -303,6 +305,7 @@ export const DEFAULT_ROUTE_MAP = {
         ORDERS: "/admin/orders",
         ORDER_DETAIL: (id) => `/admin/orders/${id}/view`,
         BIDS: "/admin/bids",
+        OFFERS: "/admin/offers",
         BLOG: "/admin/blog",
         BLOG_NEW: "/admin/blog/new",
         BLOG_EDIT: (id) => `/admin/blog/${id}/edit`,
@@ -449,6 +452,8 @@ export const PUBLIC_ROUTES = [
     ROUTES.PUBLIC.HELP,
     ROUTES.PUBLIC.TERMS,
     ROUTES.PUBLIC.PRIVACY,
+    ROUTES.PUBLIC.ETHICS,
+    ROUTES.PUBLIC.CODE_OF_CONDUCT,
     ROUTES.ERRORS.UNAUTHORIZED,
     ROUTES.AUTH.LOGIN,
     ROUTES.AUTH.REGISTER,

package/dist/providers/db-firebase/base.repository.d.ts

@@ -21,6 +21,36 @@ export declare abstract class BaseRepository<T extends DocumentData> {
     protected sieveQuery<TResult extends DocumentData = T>(model: SieveModel, fields: FirebaseSieveFields, options?: FirebaseSieveOptions & {
         baseQuery?: CollectionReference | Query;
     }): Promise<FirebaseSieveResult<TResult>>;
+    /**
+     * Count matches for a Sieve model without reading any documents.
+     *
+     * Prefer this over `sieveQuery({ pageSize: 1 }).total` whenever only the
+     * number is wanted — that idiom pays for a wasted document read per call,
+     * which matters once a surface issues one query per union member.
+     */
+    protected sieveCount(model: SieveModel, fields: FirebaseSieveFields, options?: FirebaseSieveOptions & {
+        baseQuery?: CollectionReference | Query;
+    }): Promise<number>;
+    /**
+     * How many documents match each value of a discriminator field, given a
+     * shared base filter — the "N rows of each type" behind every faceted tab
+     * bar and filter chip group.
+     *
+     * One `.count()` aggregation per value, all in parallel. A value whose query
+     * fails maps to `undefined`, NOT to 0: callers hide a facet at zero, and a
+     * swallowed failure that reads as "none of these exist" would hide a facet
+     * holding real rows (Root Cause #59). `undefined` means "unknown", and every
+     * caller is expected to keep the facet visible in that case.
+     *
+     * `values` may contain a pipe-joined OR-group (`"art|stickers"`) — it is
+     * passed through untouched so the enhanced adapter upgrades it to a
+     * Firestore `in` query, exactly as it does on the list path.
+     */
+    protected facetCounts(field: string, values: readonly string[], fields: FirebaseSieveFields, options?: FirebaseSieveOptions & {
+        baseQuery?: CollectionReference | Query;
+        /** Sieve clauses ANDed into every count (e.g. `status==published`). */
+        baseFilters?: string;
+    }): Promise<Record<string, number | undefined>>;
     findByIdInTx(tx: Transaction, id: string): Promise<T | null>;
     findByIdOrFailInTx(tx: Transaction, id: string): Promise<T>;
     createInTx(tx: Transaction, data: Partial<T> | FirestoreDocument): DocumentReference;

package/dist/providers/db-firebase/base.repository.js

@@ -1,7 +1,7 @@
 import { normalizeError } from "../../errors/normalize";
 import { DatabaseError, NotFoundError } from "../../errors";
 import { serverLogger } from "../../monitoring";
-import { applySieveToFirestore, } from "./sieve";
+import { applySieveToFirestore, countSieveMatches, } from "./sieve";
 import { deserializeTimestamps, prepareForFirestore } from "./helpers";
 import { getAdminDb } from "./admin";
 export class BaseRepository {
@@ -174,6 +174,55 @@ export class BaseRepository {
             options: sieveOptions,
         });
     }
+    /**
+     * Count matches for a Sieve model without reading any documents.
+     *
+     * Prefer this over `sieveQuery({ pageSize: 1 }).total` whenever only the
+     * number is wanted — that idiom pays for a wasted document read per call,
+     * which matters once a surface issues one query per union member.
+     */
+    async sieveCount(model, fields, options) {
+        const { baseQuery, ...sieveOptions } = options ?? {};
+        return countSieveMatches({
+            baseQuery: baseQuery ?? this.getCollection(),
+            model,
+            fields,
+            options: sieveOptions,
+        });
+    }
+    /**
+     * How many documents match each value of a discriminator field, given a
+     * shared base filter — the "N rows of each type" behind every faceted tab
+     * bar and filter chip group.
+     *
+     * One `.count()` aggregation per value, all in parallel. A value whose query
+     * fails maps to `undefined`, NOT to 0: callers hide a facet at zero, and a
+     * swallowed failure that reads as "none of these exist" would hide a facet
+     * holding real rows (Root Cause #59). `undefined` means "unknown", and every
+     * caller is expected to keep the facet visible in that case.
+     *
+     * `values` may contain a pipe-joined OR-group (`"art|stickers"`) — it is
+     * passed through untouched so the enhanced adapter upgrades it to a
+     * Firestore `in` query, exactly as it does on the list path.
+     */
+    async facetCounts(field, values, fields, options) {
+        const { baseFilters, ...rest } = options ?? {};
+        const entries = await Promise.all(values.map(async (value) => {
+            // Sieve ANDs clauses with a comma; see utils/sieve-builder.ts.
+            const filters = [baseFilters, `${field}==${value}`]
+                .filter(Boolean)
+                .join(",");
+            try {
+                return [value, await this.sieveCount({ filters }, fields, rest)];
+            }
+            catch (error) {
+                void normalizeError(error);
+                serverLogger.warn(`facetCounts: count failed for ${this.collection}.${field}==${value}; facet will stay visible`);
+                return [value, undefined];
+            }
+        }));
+        return Object.fromEntries(entries);
+    }
     async findByIdInTx(tx, id) {
         const docRef = this.getCollection().doc(id);
         const snap = await tx.get(docRef);

package/dist/providers/db-firebase/index.d.ts

@@ -27,4 +27,4 @@ export declare const firebaseDbProvider: IDbProvider;
 export { buildFirebaseClientConfig, normalizeFirebaseConfigValue, } from "./client-config";
 export type { FirebaseClientConfig } from "./client-config";
 export type { SieveModel, SieveFields, SieveFieldConfig, SieveOptions, SieveResult, SieveFilterAlias, SieveFilterAliases, FirebaseSieveFieldConfig, FirebaseSieveFields, FirebaseSieveOptions, FirebaseSieveResult, } from "./sieve";
-export { applySieveToFirestore, expandFilterAliases, parseSieveDateValue } from "./sieve";
+export { applySieveToFirestore, countSieveMatches, expandFilterAliases, parseSieveDateValue } from "./sieve";

package/dist/providers/db-firebase/index.js

@@ -38,4 +38,4 @@ export const firebaseDbProvider = {
 };
 // Firebase client config builder (for consumer app bundles)
 export { buildFirebaseClientConfig, normalizeFirebaseConfigValue, } from "./client-config";
-export { applySieveToFirestore, expandFilterAliases, parseSieveDateValue } from "./sieve";
+export { applySieveToFirestore, countSieveMatches, expandFilterAliases, parseSieveDateValue } from "./sieve";

package/dist/providers/db-firebase/sieve.d.ts

@@ -129,6 +129,22 @@ export type FirebaseSieveFieldConfig = SieveFieldConfig;
 export type FirebaseSieveFields = SieveFields;
 export type FirebaseSieveOptions = SieveOptions;
 export type FirebaseSieveResult<T> = SieveResult<T>;
+/**
+ * Count matching documents WITHOUT reading any of them.
+ *
+ * `applySieveToFirestore(...).total` already counts via the `.count()`
+ * aggregation, but it also fetches a page of documents on the way — so the
+ * `list({ pageSize: 1 }).total` idiom used across the codebase pays for one
+ * wasted document read per call. Facet/tab counts issue one query per union
+ * member, so that waste multiplies; this path skips the document read
+ * entirely.
+ */
+export declare function countSieveMatches(params: {
+    baseQuery: CollectionReference | Query;
+    model: SieveModel;
+    fields: SieveFields;
+    options?: SieveOptions;
+}): Promise<number>;
 /**
  * Apply Sieve DSL to a CollectionReference/Query without requiring repository subclassing.
  */
@@ -149,4 +165,13 @@ export declare abstract class FirebaseSieveRepository<T extends DocumentData> ex
     protected sieveQuery<TResult extends DocumentData = T>(model: SieveModel, fields: SieveFields, options?: SieveOptions & {
         baseQuery?: CollectionReference | Query;
     }): Promise<SieveResult<TResult>>;
+    /**
+     * Count matches for a Sieve model without reading any documents.
+     *
+     * Same filter pipeline as `sieveQuery` (aliases included) — see
+     * `countSieveMatches`.
+     */
+    protected sieveCount(model: SieveModel, fields: SieveFields, options?: SieveOptions & {
+        baseQuery?: CollectionReference | Query;
+    }): Promise<number>;
 }

package/dist/providers/db-firebase/sieve.js

@@ -128,12 +128,15 @@ function withAliasesExpanded(model, aliases) {
     return { ...model, filters: expanded };
 }
 /**
- * Apply Sieve DSL to a CollectionReference/Query without requiring repository subclassing.
+ * Build the filtered (unpaginated) Firestore query for a Sieve model.
+ *
+ * Extracted so the count-only path and the full list path apply the SAME
+ * filter pipeline — alias expansion included. Hand-building a Firestore query
+ * for a "just give me the total" call would skip `expandFilterAliases`, and a
+ * same-field OR group like `listingType==art|stickers` would silently vanish
+ * (Root Cause #58). Never reimplement this; call it.
  */
-export async function applySieveToFirestore(params) {
-    const { baseQuery, model, fields, options } = params;
-    const { aliases, ...rest } = options ?? {};
-    const merged = { ...SIEVE_DEFAULTS, ...rest };
+function buildFilteredSieveQuery(baseQuery, model, fields, merged, aliases) {
     const effective = withAliasesExpanded(model, aliases);
     const processor = new SieveProcessorBase({
         // MUST be the enhanced adapter, not the stock one. This is the path
@@ -150,12 +153,37 @@ export async function applySieveToFirestore(params) {
         options: merged,
         fields,
     });
+    return processor.apply(effective, baseQuery, {
+        applyPagination: false,
+    });
+}
+/**
+ * Count matching documents WITHOUT reading any of them.
+ *
+ * `applySieveToFirestore(...).total` already counts via the `.count()`
+ * aggregation, but it also fetches a page of documents on the way — so the
+ * `list({ pageSize: 1 }).total` idiom used across the codebase pays for one
+ * wasted document read per call. Facet/tab counts issue one query per union
+ * member, so that waste multiplies; this path skips the document read
+ * entirely.
+ */
+export async function countSieveMatches(params) {
+    const { baseQuery, model, fields, options } = params;
+    const { aliases, ...rest } = options ?? {};
+    const merged = { ...SIEVE_DEFAULTS, ...rest };
+    return getFirestoreCount(buildFilteredSieveQuery(baseQuery, model, fields, merged, aliases));
+}
+/**
+ * Apply Sieve DSL to a CollectionReference/Query without requiring repository subclassing.
+ */
+export async function applySieveToFirestore(params) {
+    const { baseQuery, model, fields, options } = params;
+    const { aliases, ...rest } = options ?? {};
+    const merged = { ...SIEVE_DEFAULTS, ...rest };
     const page = Math.max(1, Number(model.page ?? 1));
     const pageSize = Math.min(merged.maxPageSize, Math.max(1, Number(model.pageSize ?? merged.defaultPageSize)));
     // Apply filters + sorts once; count without reading docs.
-    const filteredQ = processor.apply(effective, baseQuery, {
-        applyPagination: false,
-    });
+    const filteredQ = buildFilteredSieveQuery(baseQuery, model, fields, merged, aliases);
     const total = await getFirestoreCount(filteredQ);
     // Apply pagination on top of the already-filtered query — avoids re-applying
     // the full Sieve DSL from the base.
@@ -185,19 +213,10 @@ export class FirebaseSieveRepository extends FirebaseRepository {
         const { baseQuery, aliases, ...sieveOptions } = options ?? {};
         const merged = { ...SIEVE_DEFAULTS, ...sieveOptions };
         const base = baseQuery ?? this.getCollection();
-        const effective = withAliasesExpanded(model, aliases);
-        const processor = new SieveProcessorBase({
-            adapter: createEnhancedFirebaseAdapter(),
-            autoLoadConfig: false,
-            options: merged,
-            fields,
-        });
         const page = Math.max(1, Number(model.page ?? 1));
         const pageSize = Math.min(merged.maxPageSize, Math.max(1, Number(model.pageSize ?? merged.defaultPageSize)));
         // Apply filters + sorts once; count without reading docs.
-        const filteredQ = processor.apply(effective, base, {
-            applyPagination: false,
-        });
+        const filteredQ = buildFilteredSieveQuery(base, model, fields, merged, aliases);
         const total = await getFirestoreCount(filteredQ);
         // Apply pagination on top of the already-filtered query — avoids re-applying
         // the full Sieve DSL from the base.
@@ -214,4 +233,19 @@ export class FirebaseSieveRepository extends FirebaseRepository {
             hasMore: page < totalPages,
         };
     }
+    /**
+     * Count matches for a Sieve model without reading any documents.
+     *
+     * Same filter pipeline as `sieveQuery` (aliases included) — see
+     * `countSieveMatches`.
+     */
+    async sieveCount(model, fields, options) {
+        const { baseQuery, ...rest } = options ?? {};
+        return countSieveMatches({
+            baseQuery: baseQuery ?? this.getCollection(),
+            model,
+            fields,
+            options: rest,
+        });
+    }
 }

package/dist/react/hooks/useUrlTable.js

@@ -35,7 +35,16 @@
 import { useRouter, usePathname, useSearchParams } from "next/navigation";
 import { useCallback, useRef } from "react";
 import { TABLE_KEYS } from "../../constants/table-keys";
-const NON_RESETTING_KEYS = [TABLE_KEYS.PAGE, TABLE_KEYS.PAGE_SIZE, TABLE_KEYS.VIEW];
+// Keys whose change must NOT reset pagination. `SECTION` is here because
+// expanding a form section is not a filter change: without it, opening a
+// section inside a listing's drawer would rewrite the listing's own URL with
+// `page=1` and refetch the table behind it.
+const NON_RESETTING_KEYS = [
+    TABLE_KEYS.PAGE,
+    TABLE_KEYS.PAGE_SIZE,
+    TABLE_KEYS.VIEW,
+    TABLE_KEYS.SECTION,
+];
 export function useUrlTable(options) {
     // Always call native hooks unconditionally (React rules).
     const nativeRouter = useRouter();