@mohasinac/appkit 4.13.1 → 4.15.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";
@@ -493,7 +493,7 @@ export type { ResolvedUser } from "./security/index";
 export type { RoleDefinition } from "./security/index";
 export type { UserRole } from "./security/index";
 export { AddressesRepository } from "./repositories/index";
-export { type PayoutMethodType, type PayoutMethodDocument, PAYOUT_METHODS_COLLECTION, PAYOUT_METHOD_INDEXED_FIELDS, DEFAULT_PAYOUT_METHOD_DATA, type ShippingMethod as ShippingConfigMethod, type ShippingConfigDocument, SHIPPING_CONFIGS_COLLECTION, SHIPPING_CONFIG_INDEXED_FIELDS, DEFAULT_SHIPPING_CONFIG_DATA, type AnalyticsScope, type AnalyticsCardType, type AnalyticsCardDocument, ANALYTICS_CARDS_COLLECTION, ANALYTICS_CARD_INDEXED_FIELDS, DEFAULT_ANALYTICS_CARD_DATA, type AlertOperator, type AnalyticsAlertDocument, ANALYTICS_ALERTS_COLLECTION, ANALYTICS_ALERT_INDEXED_FIELDS, DEFAULT_ANALYTICS_ALERT_DATA, type StoreCategoryDocument, STORE_CATEGORIES_COLLECTION, STORE_CATEGORY_INDEXED_FIELDS, DEFAULT_STORE_CATEGORY_DATA, type ListingTemplateType, type ListingTemplateDocument, LISTING_TEMPLATES_COLLECTION, LISTING_TEMPLATE_INDEXED_FIELDS, DEFAULT_LISTING_TEMPLATE_DATA, type ModerationStatus, type ModerationMediaType, type ModerationQueueDocument, MODERATION_QUEUE_COLLECTION, MODERATION_QUEUE_INDEXED_FIELDS, DEFAULT_MODERATION_QUEUE_DATA, type ReportEntityType, type ReportStatus, type ReportReason, type ReportDocument, REPORTS_COLLECTION, REPORT_INDEXED_FIELDS, DEFAULT_REPORT_DATA, type AdminNotificationCategory, type AdminNotificationDocument, ADMIN_NOTIFICATIONS_COLLECTION, ADMIN_NOTIFICATION_INDEXED_FIELDS, DEFAULT_ADMIN_NOTIFICATION_DATA, type ItemRequestStatus, type ItemRequestReply, type ItemRequestDocument, ITEM_REQUESTS_COLLECTION, ITEM_REQUEST_INDEXED_FIELDS, DEFAULT_ITEM_REQUEST_DATA, type StoreGoogleConfigDocument, STORE_GOOGLE_CONFIG_COLLECTION, STORE_GOOGLE_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_GOOGLE_CONFIG_DATA, type StoreWhatsAppConfigDocument, STORE_WHATSAPP_CONFIG_COLLECTION, STORE_WHATSAPP_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_WHATSAPP_CONFIG_DATA, type CustomRoleDocument, CUSTOM_ROLES_COLLECTION, CUSTOM_ROLE_INDEXED_FIELDS, DEFAULT_CUSTOM_ROLE_DATA, type RoleOverrideDocument, ROLE_OVERRIDES_COLLECTION, ROLE_OVERRIDE_INDEXED_FIELDS, DEFAULT_ROLE_OVERRIDE_DATA, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, AdminNotificationsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, StoreWhatsAppConfigRepository, CustomRolesRepository, RoleOverridesRepository, payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, adminNotificationsRepository, itemRequestsRepository, storeGoogleConfigRepository, storeWhatsAppConfigRepository, customRolesRepository, roleOverridesRepository, } from "./features/store-extensions/index";
+export { type PayoutMethodType, type PayoutMethodDocument, PAYOUT_METHODS_COLLECTION, PAYOUT_METHOD_INDEXED_FIELDS, DEFAULT_PAYOUT_METHOD_DATA, type ShippingMethod as ShippingConfigMethod, type ShippingConfigDocument, SHIPPING_CONFIGS_COLLECTION, SHIPPING_CONFIG_INDEXED_FIELDS, DEFAULT_SHIPPING_CONFIG_DATA, type AnalyticsScope, type AnalyticsCardType, type AnalyticsCardDocument, ANALYTICS_CARDS_COLLECTION, ANALYTICS_CARD_INDEXED_FIELDS, DEFAULT_ANALYTICS_CARD_DATA, type AlertOperator, type AnalyticsAlertDocument, ANALYTICS_ALERTS_COLLECTION, ANALYTICS_ALERT_INDEXED_FIELDS, DEFAULT_ANALYTICS_ALERT_DATA, type StoreCategoryDocument, storeCategoryFormSchema, storeCategoryCreateSchema, type StoreCategoryFormValues, listingTemplateFormSchema, listingTemplateCreateSchema, listingTemplateUpdateSchema, type ListingTemplateFormValues, LISTING_TEMPLATE_TYPES, payoutMethodFormSchema, payoutMethodCreateSchema, payoutMethodUpdateSchema, type PayoutMethodFormValues, shippingConfigFormSchema, shippingConfigCreateSchema, shippingConfigUpdateSchema, type ShippingConfigFormValues, customRoleFormSchema, customRoleCreateSchema, customRoleUpdateSchema, isKnownPermission, type CustomRoleFormValues, moderationReviewFormSchema, moderationReviewUpdateSchema, MODERATION_REVIEWER_STATUSES, type ModerationReviewFormValues, reportReviewFormSchema, reportReviewUpdateSchema, REPORT_REVIEWER_STATUSES, REPORT_TERMINAL_STATUSES, type ReportReviewFormValues, reportCreateSchema, type ReportCreateValues, itemRequestCreateSchema, type ItemRequestCreateValues, REPORT_ENTITY_TYPES, REPORT_REASONS, analyticsAlertCreateSchema, type AnalyticsAlertCreateValues, analyticsCardCreateSchema, type AnalyticsCardCreateValues, ANALYTICS_ALERT_OPERATORS, ANALYTICS_CARD_TYPES, storeGoogleConfigUpdateSchema, type StoreGoogleConfigFormValues, toSellerGoogleConfig, type SellerGoogleConfig, adminNotificationCreateSchema, type AdminNotificationCreateValues, ADMIN_NOTIFICATION_CATEGORIES, ADMIN_NOTIFICATION_SEVERITIES, STORE_CATEGORIES_COLLECTION, STORE_CATEGORY_INDEXED_FIELDS, DEFAULT_STORE_CATEGORY_DATA, type ListingTemplateType, type ListingTemplateDocument, LISTING_TEMPLATES_COLLECTION, LISTING_TEMPLATE_INDEXED_FIELDS, DEFAULT_LISTING_TEMPLATE_DATA, type ModerationStatus, type ModerationMediaType, type ModerationQueueDocument, MODERATION_QUEUE_COLLECTION, MODERATION_QUEUE_INDEXED_FIELDS, DEFAULT_MODERATION_QUEUE_DATA, type ReportEntityType, type ReportStatus, type ReportReason, type ReportDocument, REPORTS_COLLECTION, REPORT_INDEXED_FIELDS, DEFAULT_REPORT_DATA, type AdminNotificationCategory, type AdminNotificationDocument, ADMIN_NOTIFICATIONS_COLLECTION, ADMIN_NOTIFICATION_INDEXED_FIELDS, DEFAULT_ADMIN_NOTIFICATION_DATA, type ItemRequestStatus, type ItemRequestReply, type ItemRequestDocument, ITEM_REQUESTS_COLLECTION, ITEM_REQUEST_INDEXED_FIELDS, DEFAULT_ITEM_REQUEST_DATA, type StoreGoogleConfigDocument, STORE_GOOGLE_CONFIG_COLLECTION, STORE_GOOGLE_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_GOOGLE_CONFIG_DATA, type StoreWhatsAppConfigDocument, STORE_WHATSAPP_CONFIG_COLLECTION, STORE_WHATSAPP_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_WHATSAPP_CONFIG_DATA, type CustomRoleDocument, CUSTOM_ROLES_COLLECTION, CUSTOM_ROLE_INDEXED_FIELDS, DEFAULT_CUSTOM_ROLE_DATA, type RoleOverrideDocument, ROLE_OVERRIDES_COLLECTION, ROLE_OVERRIDE_INDEXED_FIELDS, DEFAULT_ROLE_OVERRIDE_DATA, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, AdminNotificationsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, StoreWhatsAppConfigRepository, CustomRolesRepository, RoleOverridesRepository, payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, adminNotificationsRepository, itemRequestsRepository, storeGoogleConfigRepository, storeWhatsAppConfigRepository, customRolesRepository, roleOverridesRepository, } from "./features/store-extensions/index";
 export { BaseRepository } from "./repositories/index";
 export { BlogRepository } from "./repositories/index";
 export { CartRepository } from "./repositories/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";
@@ -2241,6 +2240,10 @@ export type { OrderSiblingPaymentsProps } from "./features/orders/index";
 export { OrderPaymentSummary } from "./features/orders/index";
 export type { OrderPaymentSummaryProps } from "./features/orders/index";
 export { OrderStatusTimeline } from "./features/orders/index";
+export { StatusTimeline, stepsFromEntries } from "./features/status-history/index";
+export type { StatusTimelineProps, TimelineEntry, TimelineStep } from "./features/status-history/index";
+export { OfferPhaseTimeline } from "./features/seller/components/OfferPhaseTimeline";
+export type { OfferPhaseTimelineProps, OfferChainRound } from "./features/seller/components/OfferPhaseTimeline";
 export type { OrderStatusTimelineProps } from "./features/orders/index";
 export type { OrderPaymentRecord, OrderPaymentRecordMethod, OrderPaymentVerificationMethod, } from "./features/orders/index";
 export { RefundHistoryTable } from "./features/orders/index";
@@ -2280,6 +2283,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 +2397,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 +2468,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 +2491,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 +2727,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 +2862,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";
@@ -3031,6 +3034,10 @@ export { getWishlistForUser } from "./features/wishlist/server";
 export { removeFromWishlist } from "./features/wishlist/server";
 export type { EnrichedWishlistItem } from "./features/wishlist/server";
 export { BANNER_HEIGHTS } from "./features/homepage/schemas/index";
+export { homepageSectionTypeSchema } from "./features/homepage/schemas/index";
+export { homepageSectionCreateSchema } from "./features/homepage/schemas/index";
+export { resolveNextSectionOrder } from "./features/homepage/actions/homepage-section-actions";
+export type { HomepageSectionCreateValues } from "./features/homepage/schemas/index";
 export { CAROUSEL_SLIDES_COLLECTION } from "./features/homepage/schemas/index";
 export { CAROUSEL_SLIDES_INDEXED_FIELDS } from "./features/homepage/schemas/index";
 export { CAROUSEL_SLIDES_PUBLIC_FIELDS } from "./features/homepage/schemas/index";
@@ -3154,6 +3161,8 @@ export { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "./_internal/shared/features/
 export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
 export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, type BundleCreateBody, type BundleUpdateBody, } from "./_internal/shared/features/categories/bundle-schemas";
 export type { GroupedListingDocument, GroupTheme, GroupVisibility } from "./features/grouped/schemas/firestore";
+export { navItemFormSchema, navItemCreateSchema, navItemUpdateSchema, type NavItemFormValues, } from "./features/admin/schemas/nav-item-form";
+export { groupedListingFormSchema, groupedListingCreateSchema, groupedListingUpdateSchema, type GroupedListingFormValues, } from "./features/grouped/schemas/grouped-listing-form";
 export { scammersSeedData } from "./seed/index";
 export { productFeaturesSeedData } from "./seed/index";
 export { SCAMMER_COLLECTION, SCAMMER_ID_PREFIX, SCAMMER_MATCH_FIELDS, SCAMMER_INDEXED_FIELDS, SCAMMER_FIELDS, SCAMMER_INCIDENTS_SUBCOLLECTION, SCAMMER_COMMENTS_SUBCOLLECTION, SCAMMER_CONTESTS_SUBCOLLECTION, MAX_COMMENT_BODY_LENGTH, MAX_PENDING_SCAMMER_REPORTS_PER_USER, ScammerStatusValues, ScamPlatformValues, SocialPlatformValues, ContestTypeValues, ContestStatusValues, SCAM_PLATFORM_LABELS, SOCIAL_PLATFORM_LABELS, SCAMMER_STATUS_LABELS, CONTEST_TYPE_LABELS, CONTEST_STATUS_LABELS, DEFAULT_SCAMMER_DATA, DEFAULT_SCAMMER_INCIDENT_DATA, DEFAULT_SCAMMER_COMMENT_DATA, DEFAULT_SCAMMER_CONTEST_DATA, } from "./features/scams/schemas/firestore";
@@ -3196,6 +3205,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";
@@ -3264,7 +3277,7 @@ export { SellerDigitalCodesView } from "./features/seller/components/SellerDigit
 export type { SellerDigitalCodesViewProps } from "./features/seller/components/SellerDigitalCodesView";
 export { SellerLiveView } from "./features/seller/components/SellerLiveView";
 export type { SellerLiveViewProps } from "./features/seller/components/SellerLiveView";
-export { SCHEMAS, lookupApiSchema, lookupFirestoreSchema, } from "./schemas/index";
+export { SCHEMAS, lookupApiSchema, lookupFormSchema, lookupFirestoreSchema, } from "./schemas/index";
 export type { ApiRouteKey, ApiRouteSchema, FirestoreDocument, FirestoreValue, FormFieldValue, FormValues, HttpVerb, JsonArray, JsonObject, JsonObjectWithUndefined, JsonPrimitive, JsonValue, JsonValueWithUndefined, RegisteredApiRouteKey, RegisteredFirestoreCollection, RegisteredFormId, RegisteredRtdbChannel, RegisteredSieveCollection, RegisteredStorageOp, RegisteredWebhookProvider, RegistryEntry, SchemaRegistry, SchemasShape, WebhookSchemaBucket, } from "./schemas/index";
 export { safeFireAndForget } from "./utils/safe-fire-forget";
 export { withRetry } from "./http/retry";

package/dist/index.js

@@ -910,7 +910,7 @@ export { resolvePermissions } from "./security/index";
 // AddressesRepository - unified top-level addresses collection (SB-UNI-A 2026-05-13).
 export { AddressesRepository } from "./repositories/index";
 // S-STORE foundation — 14 schemas + 14 repositories + RBAC.
-export { PAYOUT_METHODS_COLLECTION, PAYOUT_METHOD_INDEXED_FIELDS, DEFAULT_PAYOUT_METHOD_DATA, SHIPPING_CONFIGS_COLLECTION, SHIPPING_CONFIG_INDEXED_FIELDS, DEFAULT_SHIPPING_CONFIG_DATA, ANALYTICS_CARDS_COLLECTION, ANALYTICS_CARD_INDEXED_FIELDS, DEFAULT_ANALYTICS_CARD_DATA, ANALYTICS_ALERTS_COLLECTION, ANALYTICS_ALERT_INDEXED_FIELDS, DEFAULT_ANALYTICS_ALERT_DATA, STORE_CATEGORIES_COLLECTION, STORE_CATEGORY_INDEXED_FIELDS, DEFAULT_STORE_CATEGORY_DATA, LISTING_TEMPLATES_COLLECTION, LISTING_TEMPLATE_INDEXED_FIELDS, DEFAULT_LISTING_TEMPLATE_DATA, MODERATION_QUEUE_COLLECTION, MODERATION_QUEUE_INDEXED_FIELDS, DEFAULT_MODERATION_QUEUE_DATA, REPORTS_COLLECTION, REPORT_INDEXED_FIELDS, DEFAULT_REPORT_DATA, ADMIN_NOTIFICATIONS_COLLECTION, ADMIN_NOTIFICATION_INDEXED_FIELDS, DEFAULT_ADMIN_NOTIFICATION_DATA, ITEM_REQUESTS_COLLECTION, ITEM_REQUEST_INDEXED_FIELDS, DEFAULT_ITEM_REQUEST_DATA, STORE_GOOGLE_CONFIG_COLLECTION, STORE_GOOGLE_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_GOOGLE_CONFIG_DATA, STORE_WHATSAPP_CONFIG_COLLECTION, STORE_WHATSAPP_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_WHATSAPP_CONFIG_DATA, CUSTOM_ROLES_COLLECTION, CUSTOM_ROLE_INDEXED_FIELDS, DEFAULT_CUSTOM_ROLE_DATA, ROLE_OVERRIDES_COLLECTION, ROLE_OVERRIDE_INDEXED_FIELDS, DEFAULT_ROLE_OVERRIDE_DATA, 
+export { PAYOUT_METHODS_COLLECTION, PAYOUT_METHOD_INDEXED_FIELDS, DEFAULT_PAYOUT_METHOD_DATA, SHIPPING_CONFIGS_COLLECTION, SHIPPING_CONFIG_INDEXED_FIELDS, DEFAULT_SHIPPING_CONFIG_DATA, ANALYTICS_CARDS_COLLECTION, ANALYTICS_CARD_INDEXED_FIELDS, DEFAULT_ANALYTICS_CARD_DATA, ANALYTICS_ALERTS_COLLECTION, ANALYTICS_ALERT_INDEXED_FIELDS, DEFAULT_ANALYTICS_ALERT_DATA, storeCategoryFormSchema, storeCategoryCreateSchema, listingTemplateFormSchema, listingTemplateCreateSchema, listingTemplateUpdateSchema, LISTING_TEMPLATE_TYPES, payoutMethodFormSchema, payoutMethodCreateSchema, payoutMethodUpdateSchema, shippingConfigFormSchema, shippingConfigCreateSchema, shippingConfigUpdateSchema, customRoleFormSchema, customRoleCreateSchema, customRoleUpdateSchema, isKnownPermission, moderationReviewFormSchema, moderationReviewUpdateSchema, MODERATION_REVIEWER_STATUSES, reportReviewFormSchema, reportReviewUpdateSchema, REPORT_REVIEWER_STATUSES, REPORT_TERMINAL_STATUSES, reportCreateSchema, itemRequestCreateSchema, REPORT_ENTITY_TYPES, REPORT_REASONS, analyticsAlertCreateSchema, analyticsCardCreateSchema, ANALYTICS_ALERT_OPERATORS, ANALYTICS_CARD_TYPES, storeGoogleConfigUpdateSchema, toSellerGoogleConfig, adminNotificationCreateSchema, ADMIN_NOTIFICATION_CATEGORIES, ADMIN_NOTIFICATION_SEVERITIES, STORE_CATEGORIES_COLLECTION, STORE_CATEGORY_INDEXED_FIELDS, DEFAULT_STORE_CATEGORY_DATA, LISTING_TEMPLATES_COLLECTION, LISTING_TEMPLATE_INDEXED_FIELDS, DEFAULT_LISTING_TEMPLATE_DATA, MODERATION_QUEUE_COLLECTION, MODERATION_QUEUE_INDEXED_FIELDS, DEFAULT_MODERATION_QUEUE_DATA, REPORTS_COLLECTION, REPORT_INDEXED_FIELDS, DEFAULT_REPORT_DATA, ADMIN_NOTIFICATIONS_COLLECTION, ADMIN_NOTIFICATION_INDEXED_FIELDS, DEFAULT_ADMIN_NOTIFICATION_DATA, ITEM_REQUESTS_COLLECTION, ITEM_REQUEST_INDEXED_FIELDS, DEFAULT_ITEM_REQUEST_DATA, STORE_GOOGLE_CONFIG_COLLECTION, STORE_GOOGLE_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_GOOGLE_CONFIG_DATA, STORE_WHATSAPP_CONFIG_COLLECTION, STORE_WHATSAPP_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_WHATSAPP_CONFIG_DATA, CUSTOM_ROLES_COLLECTION, CUSTOM_ROLE_INDEXED_FIELDS, DEFAULT_CUSTOM_ROLE_DATA, ROLE_OVERRIDES_COLLECTION, ROLE_OVERRIDE_INDEXED_FIELDS, DEFAULT_ROLE_OVERRIDE_DATA, 
 // Repositories — classes
 PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, AdminNotificationsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, StoreWhatsAppConfigRepository, CustomRolesRepository, RoleOverridesRepository, 
 // Repositories — singletons
@@ -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";
@@ -4104,6 +4104,11 @@ export { OrdersList } from "./features/orders/index";
 export { OrderSiblingPayments } from "./features/orders/index";
 export { OrderPaymentSummary } from "./features/orders/index";
 export { OrderStatusTimeline } from "./features/orders/index";
+// [CLIENT] StatusTimeline — the ONE rail both orders and offers render.
+// Each feature supplies only its phase vocabulary; the never-fabricate-a-
+// timestamp rule and the dot/connector rail live in one place.
+export { StatusTimeline, stepsFromEntries } from "./features/status-history/index";
+export { OfferPhaseTimeline } from "./features/seller/components/OfferPhaseTimeline";
 export { RefundHistoryTable } from "./features/orders/index";
 export { RefundRequestView } from "./features/orders/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
@@ -4170,6 +4175,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 +4340,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 +4478,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 +4922,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 +5137,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";
@@ -5413,6 +5416,9 @@ export { removeFromWishlist } from "./features/wishlist/server";
 // [SCHEMA]-Schema / data-shape constant â€" Zod validator, default-value object, or Firestore collection/field name constant.
 // BANNER_HEIGHTS - Constant used across modules.
 export { BANNER_HEIGHTS } from "./features/homepage/schemas/index";
+export { homepageSectionTypeSchema } from "./features/homepage/schemas/index";
+export { homepageSectionCreateSchema } from "./features/homepage/schemas/index";
+export { resolveNextSectionOrder } from "./features/homepage/actions/homepage-section-actions";
 // [SCHEMA]-Schema / data-shape constant â€" Zod validator, default-value object, or Firestore collection/field name constant.
 // CAROUSEL_SLIDES_COLLECTION - Constant used across modules.
 export { CAROUSEL_SLIDES_COLLECTION } from "./features/homepage/schemas/index";
@@ -5562,6 +5568,8 @@ export { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "./_internal/shared/features/
 export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
 // S-SBUNI-4 follow-up â€" shared admin bundle zod schemas.
 export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, } from "./_internal/shared/features/categories/bundle-schemas";
+export { navItemFormSchema, navItemCreateSchema, navItemUpdateSchema, } from "./features/admin/schemas/nav-item-form";
+export { groupedListingFormSchema, groupedListingCreateSchema, groupedListingUpdateSchema, } from "./features/grouped/schemas/grouped-listing-form";
 // Scam registry â€" seed data
 export { scammersSeedData } from "./seed/index";
 // Product features â€" seed data (FI2)
@@ -5602,6 +5610,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";
@@ -5664,7 +5679,7 @@ export { SellerLiveView } from "./features/seller/components/SellerLiveView";
 // boundary (Firestore docs, API routes, forms, sieve, webhooks, RTDB, storage).
 // Per-feature `schemas/index.ts` files register into the relevant bucket.
 // Pure Zod, isomorphic — safe on both client and server.
-export { SCHEMAS, lookupApiSchema, lookupFirestoreSchema, } from "./schemas/index";
+export { SCHEMAS, lookupApiSchema, lookupFormSchema, lookupFirestoreSchema, } from "./schemas/index";
 // ── Fire-and-forget safety wrapper ─────────────────────────────────────────
 // Replaces .catch(console.error) for non-critical background operations.
 export { safeFireAndForget } from "./utils/safe-fire-forget";

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";
@@ -128,8 +130,15 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly WISHLIST: "/wishlist";
         readonly HISTORY: "/user/history";
         readonly ADDRESSES: "/user/addresses";
-        readonly ADDRESSES_ADD: "/user/addresses/add";
+        /**
+         * Canonical shapes. `/add` and `/edit/[id]` were the only two
+         * non-standard route shapes in the codebase — every other entity uses
+         * `/new` and `/[id]/edit`. Both old paths still resolve, as redirects.
+         */
+        readonly ADDRESSES_NEW: "/user/addresses/new";
         readonly ADDRESSES_EDIT: (id: string) => string;
+        /** @deprecated Use ADDRESSES_NEW. Kept so existing links keep resolving. */
+        readonly ADDRESSES_ADD: "/user/addresses/new";
         readonly ORDER_DETAIL: (id: string) => string;
         readonly ORDER_CANCEL: (id: string) => string;
         readonly ORDER_TRACK: (id: string) => string;
@@ -293,6 +302,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 +446,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";
@@ -500,8 +512,15 @@ export declare const ROUTES: {
         readonly WISHLIST: "/wishlist";
         readonly HISTORY: "/user/history";
         readonly ADDRESSES: "/user/addresses";
-        readonly ADDRESSES_ADD: "/user/addresses/add";
+        /**
+         * Canonical shapes. `/add` and `/edit/[id]` were the only two
+         * non-standard route shapes in the codebase — every other entity uses
+         * `/new` and `/[id]/edit`. Both old paths still resolve, as redirects.
+         */
+        readonly ADDRESSES_NEW: "/user/addresses/new";
         readonly ADDRESSES_EDIT: (id: string) => string;
+        /** @deprecated Use ADDRESSES_NEW. Kept so existing links keep resolving. */
+        readonly ADDRESSES_ADD: "/user/addresses/new";
         readonly ORDER_DETAIL: (id: string) => string;
         readonly ORDER_CANCEL: (id: string) => string;
         readonly ORDER_TRACK: (id: string) => string;
@@ -665,6 +684,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 +860,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",
@@ -132,8 +134,15 @@ export const DEFAULT_ROUTE_MAP = {
         WISHLIST: "/wishlist",
         HISTORY: "/user/history",
         ADDRESSES: "/user/addresses",
-        ADDRESSES_ADD: "/user/addresses/add",
-        ADDRESSES_EDIT: (id) => `/user/addresses/edit/${id}`,
+        /**
+         * Canonical shapes. `/add` and `/edit/[id]` were the only two
+         * non-standard route shapes in the codebase — every other entity uses
+         * `/new` and `/[id]/edit`. Both old paths still resolve, as redirects.
+         */
+        ADDRESSES_NEW: "/user/addresses/new",
+        ADDRESSES_EDIT: (id) => `/user/addresses/${id}/edit`,
+        /** @deprecated Use ADDRESSES_NEW. Kept so existing links keep resolving. */
+        ADDRESSES_ADD: "/user/addresses/new",
         ORDER_DETAIL: (id) => `/user/orders/view/${id}`,
         ORDER_CANCEL: (id) => `/user/orders/${id}/cancel`,
         ORDER_TRACK: (id) => `/user/orders/${id}/track`,
@@ -303,6 +312,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 +459,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>;
 }