@mohasinac/appkit 4.13.1 → 4.15.0

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

@@ -90,7 +90,7 @@ export declare const surveyFormFieldSchema: z.ZodObject<{
     }>>;
     order: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+    type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
     id: string;
     label: string;
     required: boolean;
@@ -105,7 +105,7 @@ export declare const surveyFormFieldSchema: z.ZodObject<{
     } | undefined;
     placeholder?: string | undefined;
 }, {
-    type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+    type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
     id: string;
     label: string;
     required: boolean;
@@ -155,7 +155,7 @@ export declare const surveyConfigSchema: z.ZodObject<{
         }>>;
         order: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
         id: string;
         label: string;
         required: boolean;
@@ -170,7 +170,7 @@ export declare const surveyConfigSchema: z.ZodObject<{
         } | undefined;
         placeholder?: string | undefined;
     }, {
-        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
         id: string;
         label: string;
         required: boolean;
@@ -192,7 +192,7 @@ export declare const surveyConfigSchema: z.ZodObject<{
     hasPointSystem: boolean;
     entryReviewRequired: boolean;
     formFields: {
-        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
         id: string;
         label: string;
         required: boolean;
@@ -215,7 +215,7 @@ export declare const surveyConfigSchema: z.ZodObject<{
     hasPointSystem: boolean;
     entryReviewRequired: boolean;
     formFields: {
-        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
         id: string;
         label: string;
         required: boolean;
@@ -261,7 +261,7 @@ export declare const feedbackConfigSchema: z.ZodObject<{
         }>>;
         order: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
         id: string;
         label: string;
         required: boolean;
@@ -276,7 +276,7 @@ export declare const feedbackConfigSchema: z.ZodObject<{
         } | undefined;
         placeholder?: string | undefined;
     }, {
-        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
         id: string;
         label: string;
         required: boolean;
@@ -295,7 +295,7 @@ export declare const feedbackConfigSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     anonymous: boolean;
     formFields: {
-        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
         id: string;
         label: string;
         required: boolean;
@@ -313,7 +313,7 @@ export declare const feedbackConfigSchema: z.ZodObject<{
 }, {
     anonymous: boolean;
     formFields: {
-        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+        type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
         id: string;
         label: string;
         required: boolean;
@@ -661,7 +661,7 @@ export declare const eventItemSchema: z.ZodObject<{
             }>>;
             order: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -676,7 +676,7 @@ export declare const eventItemSchema: z.ZodObject<{
             } | undefined;
             placeholder?: string | undefined;
         }, {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -698,7 +698,7 @@ export declare const eventItemSchema: z.ZodObject<{
         hasPointSystem: boolean;
         entryReviewRequired: boolean;
         formFields: {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -721,7 +721,7 @@ export declare const eventItemSchema: z.ZodObject<{
         hasPointSystem: boolean;
         entryReviewRequired: boolean;
         formFields: {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -767,7 +767,7 @@ export declare const eventItemSchema: z.ZodObject<{
             }>>;
             order: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -782,7 +782,7 @@ export declare const eventItemSchema: z.ZodObject<{
             } | undefined;
             placeholder?: string | undefined;
         }, {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -801,7 +801,7 @@ export declare const eventItemSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         anonymous: boolean;
         formFields: {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -819,7 +819,7 @@ export declare const eventItemSchema: z.ZodObject<{
     }, {
         anonymous: boolean;
         formFields: {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -992,20 +992,6 @@ export declare const eventItemSchema: z.ZodObject<{
         duration?: number | undefined;
     }[];
     slug?: string | undefined;
-    lotteryConfig?: {
-        slots: {
-            name: string;
-            slotNumber: number;
-            isBooked: boolean;
-            bookedByUserLotteryNumber?: number | undefined;
-            bookedByDisplayName?: string | undefined;
-        }[];
-        totalSlots: number;
-        pricingMode: "uniform" | "variable";
-        drawWindowDurationMinutes: number;
-        maxPullsPerTransaction: number;
-        maxPullsPerUser: number;
-    } | undefined;
     hasRaffle?: boolean | undefined;
     raffleType?: "spin_wheel" | "open_raffle" | "top_n_scorers" | "top_n_participants" | undefined;
     raffleTopN?: number | undefined;
@@ -1026,6 +1012,20 @@ export declare const eventItemSchema: z.ZodObject<{
     spinMaxPerUser?: number | undefined;
     spinWindowStart?: string | undefined;
     spinWindowEnd?: string | undefined;
+    lotteryConfig?: {
+        slots: {
+            name: string;
+            slotNumber: number;
+            isBooked: boolean;
+            bookedByUserLotteryNumber?: number | undefined;
+            bookedByDisplayName?: string | undefined;
+        }[];
+        totalSlots: number;
+        pricingMode: "uniform" | "variable";
+        drawWindowDurationMinutes: number;
+        maxPullsPerTransaction: number;
+        maxPullsPerUser: number;
+    } | undefined;
     coverImageUrl?: string | undefined;
     saleConfig?: {
         discountPercent: number;
@@ -1054,7 +1054,7 @@ export declare const eventItemSchema: z.ZodObject<{
         hasPointSystem: boolean;
         entryReviewRequired: boolean;
         formFields: {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -1074,7 +1074,7 @@ export declare const eventItemSchema: z.ZodObject<{
     feedbackConfig?: {
         anonymous: boolean;
         formFields: {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -1108,20 +1108,6 @@ export declare const eventItemSchema: z.ZodObject<{
         flaggedEntries: number;
     };
     slug?: string | undefined;
-    lotteryConfig?: {
-        slots: {
-            name: string;
-            slotNumber: number;
-            isBooked: boolean;
-            bookedByUserLotteryNumber?: number | undefined;
-            bookedByDisplayName?: string | undefined;
-        }[];
-        totalSlots: number;
-        pricingMode: "uniform" | "variable";
-        drawWindowDurationMinutes: number;
-        maxPullsPerTransaction: number;
-        maxPullsPerUser: number;
-    } | undefined;
     hasRaffle?: boolean | undefined;
     raffleType?: "spin_wheel" | "open_raffle" | "top_n_scorers" | "top_n_participants" | undefined;
     raffleTopN?: number | undefined;
@@ -1151,6 +1137,20 @@ export declare const eventItemSchema: z.ZodObject<{
         youtubeId?: string | undefined;
         duration?: number | undefined;
     } | null | undefined;
+    lotteryConfig?: {
+        slots: {
+            name: string;
+            slotNumber: number;
+            isBooked: boolean;
+            bookedByUserLotteryNumber?: number | undefined;
+            bookedByDisplayName?: string | undefined;
+        }[];
+        totalSlots: number;
+        pricingMode: "uniform" | "variable";
+        drawWindowDurationMinutes: number;
+        maxPullsPerTransaction: number;
+        maxPullsPerUser: number;
+    } | undefined;
     coverImageUrl?: string | undefined;
     eventImages?: {
         type: "video" | "image" | "file";
@@ -1206,7 +1206,7 @@ export declare const eventItemSchema: z.ZodObject<{
         hasPointSystem: boolean;
         entryReviewRequired: boolean;
         formFields: {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;
@@ -1226,7 +1226,7 @@ export declare const eventItemSchema: z.ZodObject<{
     feedbackConfig?: {
         anonymous: boolean;
         formFields: {
-            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "phone" | "rating";
+            type: "number" | "checkbox" | "radio" | "text" | "email" | "select" | "textarea" | "date" | "file" | "multiselect" | "rating" | "phone";
             id: string;
             label: string;
             required: boolean;

package/dist/features/events/types/index.d.ts

@@ -2,6 +2,14 @@ import type { MediaField } from "../../media/types/index";
 import type { JsonValue } from "@mohasinac/appkit";
 import type { ClientLotteryConfig } from "../../lottery/types";
 export type EventType = "sale" | "offer" | "poll" | "survey" | "feedback" | "raffle" | "spin_wheel" | "lottery";
+export declare const ALL_EVENT_TYPES: EventType[];
+/**
+ * Display labels for the admin/seller dashboards, which are not i18n-wrapped.
+ * Public surfaces use the `filters.eventType*` message keys instead.
+ *
+ * `Record<EventType, string>` so a new union member is a compile error here too.
+ */
+export declare const EVENT_TYPE_LABELS: Record<EventType, string>;
 export type RaffleType = "top_n_scorers" | "top_n_participants" | "open_raffle" | "spin_wheel";
 export interface SpinPrize {
     id: string;
@@ -11,6 +19,9 @@ export interface SpinPrize {
     isActive: boolean;
 }
 export type EventStatus = "draft" | "active" | "paused" | "ended" | "cancelled";
+export declare const ALL_EVENT_STATUSES: EventStatus[];
+/** Dashboard display labels — see `EVENT_TYPE_LABELS`. */
+export declare const EVENT_STATUS_LABELS: Record<EventStatus, string>;
 export type EntryReviewStatus = "pending" | "approved" | "flagged";
 export type PollResultsVisibility = "always" | "after_vote" | "after_end";
 export type FormFieldType = "text" | "textarea" | "email" | "phone" | "number" | "select" | "multiselect" | "checkbox" | "radio" | "date" | "rating" | "file";

package/dist/features/events/types/index.js

@@ -1 +1,57 @@
-export {};
+/**
+ * Every event type, in canonical iteration order — the single array every
+ * filter chip group, tab bar and dropdown derives from.
+ *
+ * Declared as `Record<EventType, true>` rather than a plain array on purpose:
+ * adding a member to the union without adding it here is then a COMPILE error,
+ * not a silent omission. It exists because there were THREE hand-written
+ * enumerations of this union and all three had drifted — the admin chips
+ * offered `contest`/`giveaway`/`flash-sale` (values `EventType` never had, so
+ * they matched zero rows) while omitting five real types, the public filter
+ * omitted `lottery`, and `EVENT_FIELDS.TYPE_VALUES` omitted it too. Same shape
+ * as `ALL_LISTING_TYPES_MAP`; same reason (Root Cause #61).
+ */
+const ALL_EVENT_TYPES_MAP = {
+    sale: true,
+    offer: true,
+    poll: true,
+    survey: true,
+    feedback: true,
+    raffle: true,
+    spin_wheel: true,
+    lottery: true,
+};
+export const ALL_EVENT_TYPES = Object.keys(ALL_EVENT_TYPES_MAP);
+/**
+ * Display labels for the admin/seller dashboards, which are not i18n-wrapped.
+ * Public surfaces use the `filters.eventType*` message keys instead.
+ *
+ * `Record<EventType, string>` so a new union member is a compile error here too.
+ */
+export const EVENT_TYPE_LABELS = {
+    sale: "Sale",
+    offer: "Offer",
+    poll: "Poll",
+    survey: "Survey",
+    feedback: "Feedback",
+    raffle: "Raffle",
+    spin_wheel: "Spin the Wheel",
+    lottery: "Lottery",
+};
+/** Every event status, in lifecycle order. Compile-checked like `ALL_EVENT_TYPES`. */
+const ALL_EVENT_STATUSES_MAP = {
+    draft: true,
+    active: true,
+    paused: true,
+    ended: true,
+    cancelled: true,
+};
+export const ALL_EVENT_STATUSES = Object.keys(ALL_EVENT_STATUSES_MAP);
+/** Dashboard display labels — see `EVENT_TYPE_LABELS`. */
+export const EVENT_STATUS_LABELS = {
+    draft: "Draft",
+    active: "Active",
+    paused: "Paused",
+    ended: "Ended",
+    cancelled: "Cancelled",
+};

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

@@ -27,10 +27,10 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     template: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     category: string;
-    priority: number;
-    order: number;
     isActive: boolean;
+    order: number;
     showOnHomepage: boolean;
+    priority: number;
     question: string;
     answer: {
         text: string;
@@ -52,10 +52,10 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     };
     template?: string | undefined;
     tags?: string[] | undefined;
-    priority?: number | undefined;
-    order?: number | undefined;
     isActive?: boolean | undefined;
+    order?: number | undefined;
     showOnHomepage?: boolean | undefined;
+    priority?: number | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
@@ -63,10 +63,10 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     variables?: Record<string, string> | undefined;
 }>, {
     category: string;
-    priority: number;
-    order: number;
     isActive: boolean;
+    order: number;
     showOnHomepage: boolean;
+    priority: number;
     question: string;
     answer: {
         text: string;
@@ -88,10 +88,10 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     };
     template?: string | undefined;
     tags?: string[] | undefined;
-    priority?: number | undefined;
-    order?: number | undefined;
     isActive?: boolean | undefined;
+    order?: number | undefined;
     showOnHomepage?: boolean | undefined;
+    priority?: number | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
@@ -126,10 +126,10 @@ export declare const faqUpdateSchema: z.ZodObject<{
     template?: string | undefined;
     category?: string | undefined;
     tags?: string[] | undefined;
-    priority?: number | undefined;
-    order?: number | undefined;
     isActive?: boolean | undefined;
+    order?: number | undefined;
     showOnHomepage?: boolean | undefined;
+    priority?: number | undefined;
     question?: string | undefined;
     answer?: {
         text: string;
@@ -144,10 +144,10 @@ export declare const faqUpdateSchema: z.ZodObject<{
     template?: string | undefined;
     category?: string | undefined;
     tags?: string[] | undefined;
-    priority?: number | undefined;
-    order?: number | undefined;
     isActive?: boolean | undefined;
+    order?: number | undefined;
     showOnHomepage?: boolean | undefined;
+    priority?: number | undefined;
     question?: string | undefined;
     answer?: {
         text: string;

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

@@ -92,15 +92,15 @@ export declare const faqSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     tags?: string[] | undefined;
-    priority?: number | undefined;
-    order?: number | undefined;
     isActive?: boolean | undefined;
+    order?: number | undefined;
     stats?: {
         views?: number | undefined;
         helpful?: number | undefined;
         notHelpful?: number | undefined;
     } | undefined;
     showOnHomepage?: boolean | undefined;
+    priority?: number | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
@@ -118,15 +118,15 @@ export declare const faqSchema: z.ZodObject<{
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     tags?: string[] | undefined;
-    priority?: number | undefined;
-    order?: number | undefined;
     isActive?: boolean | undefined;
+    order?: number | undefined;
     stats?: {
         views?: number | undefined;
         helpful?: number | undefined;
         notHelpful?: number | undefined;
     } | undefined;
     showOnHomepage?: boolean | undefined;
+    priority?: number | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
@@ -283,9 +283,8 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     category: "orders_payment" | "shipping_delivery" | "returns_refunds" | "product_information" | "account_security" | "technical_support" | "general";
     tags: string[];
-    priority: number;
-    order: number;
     isActive: boolean;
+    order: number;
     createdBy: string;
     stats: {
         views: number;
@@ -296,6 +295,7 @@ export declare const faqFirestoreSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough"> | undefined;
     };
     showOnHomepage: boolean;
+    priority: number;
     question: string;
     answer: {
         text: string;
@@ -322,9 +322,8 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     category: "orders_payment" | "shipping_delivery" | "returns_refunds" | "product_information" | "account_security" | "technical_support" | "general";
     tags: string[];
-    priority: number;
-    order: number;
     isActive: boolean;
+    order: number;
     createdBy: string;
     stats: {
         views: number;
@@ -335,6 +334,7 @@ export declare const faqFirestoreSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough"> | undefined;
     };
     showOnHomepage: boolean;
+    priority: number;
     question: string;
     answer: {
         text: string;

package/dist/features/filters/FilterFacetSection.d.ts

@@ -20,10 +20,16 @@ export interface FilterFacetSectionProps {
      * "dropdown" — compact pill button with a floating panel; use in horizontal toolbars.
      */
     displayAs?: "accordion" | "dropdown";
+    /**
+     * Hide options whose `count` is exactly 0. Requires the caller to populate
+     * `FacetOption.count`; opt-in so the existing callers that pass no counts are
+     * unaffected. A selected option, or one with no count, is always kept.
+     */
+    hideEmpty?: boolean;
 }
 /**
  * FilterFacetSection — collapsible checkbox/radio filter section.
  * Supports single-select and multi-select modes.
  * When searchable, the search input is always visible and typing auto-expands.
  */
-export declare function FilterFacetSection({ title, options, selected, onChange, selectionMode, defaultCollapsed, searchable, isOpen: controlledOpen, onToggle, onClear, className, displayAs, }: FilterFacetSectionProps): import("react").JSX.Element;
+export declare function FilterFacetSection({ title, options, selected, onChange, selectionMode, defaultCollapsed, searchable, isOpen: controlledOpen, onToggle, onClear, className, displayAs, hideEmpty, }: FilterFacetSectionProps): import("react").JSX.Element;

package/dist/features/filters/FilterFacetSection.js

@@ -16,7 +16,7 @@ const CLS_CLEAR_ICON = "inline-flex items-center justify-center w-5 h-5 p-[var(-
  * Supports single-select and multi-select modes.
  * When searchable, the search input is always visible and typing auto-expands.
  */
-export function FilterFacetSection({ title, options, selected, onChange, selectionMode = "multi", defaultCollapsed = true, searchable = false, isOpen: controlledOpen, onToggle, onClear, className = "", displayAs = "accordion", }) {
+export function FilterFacetSection({ title, options, selected, onChange, selectionMode = "multi", defaultCollapsed = true, searchable = false, isOpen: controlledOpen, onToggle, onClear, className = "", displayAs = "accordion", hideEmpty = false, }) {
     const isControlled = controlledOpen !== undefined;
     const [internalCollapsed, setInternalCollapsed] = useState(defaultCollapsed);
     const [search, setSearch] = useState("");
@@ -47,9 +47,17 @@ export function FilterFacetSection({ title, options, selected, onChange, selecti
             setInternalCollapsed(false);
         }
     }
-    const filtered = search
-        ? options.filter((o) => o.label.toLowerCase().includes(search.toLowerCase()))
+    // Drop options that would return nothing, when the caller supplies counts and
+    // opts in. A selected option is always kept — a facet vanishing while it is
+    // applied would strand a value in the URL with no control to clear it — and
+    // so is an option with no count, since `undefined` means "not counted", not
+    // "zero" (Root Cause #59).
+    const scoped = hideEmpty
+        ? options.filter((o) => selected.includes(o.value) || o.count === undefined || o.count > 0)
         : options;
+    const filtered = search
+        ? scoped.filter((o) => o.label.toLowerCase().includes(search.toLowerCase()))
+        : scoped;
     const toggle = (value) => {
         if (selectionMode === "single") {
             onChange(selected.includes(value) ? [] : [value]);

package/dist/features/grouped/schemas/grouped-listing-form.d.ts

@@ -0,0 +1,101 @@
+import { z } from "zod";
+/**
+ * 🛑 `annotate()` must be the OUTERMOST call on each field — it keys a WeakMap
+ * by schema instance and every zod wrapper returns a new one.
+ */
+export declare const groupedListingFormSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    groupTheme: z.ZodEnum<["related", "character", "lineage", "set", "generic"]>;
+    productIds: z.ZodArray<z.ZodString, "many">;
+    minActiveMembers: z.ZodNumber;
+    coverImage: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodBoolean;
+    isFeatured: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    isActive: boolean;
+    isFeatured: boolean;
+    productIds: string[];
+    groupTheme: "set" | "related" | "character" | "lineage" | "generic";
+    minActiveMembers: number;
+    description?: string | undefined;
+    coverImage?: string | undefined;
+}, {
+    title: string;
+    isActive: boolean;
+    isFeatured: boolean;
+    productIds: string[];
+    groupTheme: "set" | "related" | "character" | "lineage" | "generic";
+    minActiveMembers: number;
+    description?: string | undefined;
+    coverImage?: string | undefined;
+}>;
+export type GroupedListingFormValues = z.infer<typeof groupedListingFormSchema>;
+/**
+ * Create contract. `storeId` is absent — the store route sets it from the
+ * session, so a seller cannot file a group under another store.
+ */
+export declare const groupedListingCreateSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    isActive: z.ZodBoolean;
+    isFeatured: z.ZodOptional<z.ZodBoolean>;
+    coverImage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    productIds: z.ZodArray<z.ZodString, "many">;
+    groupTheme: z.ZodEnum<["related", "character", "lineage", "set", "generic"]>;
+    minActiveMembers: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    isActive: boolean;
+    productIds: string[];
+    groupTheme: "set" | "related" | "character" | "lineage" | "generic";
+    description?: string | undefined;
+    isFeatured?: boolean | undefined;
+    coverImage?: string | undefined;
+    minActiveMembers?: number | undefined;
+}, {
+    title: string;
+    isActive: boolean;
+    productIds: string[];
+    groupTheme: "set" | "related" | "character" | "lineage" | "generic";
+    description?: string | undefined;
+    isFeatured?: boolean | undefined;
+    coverImage?: string | undefined;
+    minActiveMembers?: number | undefined;
+}>;
+/** Update contract — partial, `.strict()` so an unknown key is a 400. */
+export declare const groupedListingUpdateSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    groupTheme: z.ZodOptional<z.ZodEnum<["related", "character", "lineage", "set", "generic"]>>;
+    productIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    minActiveMembers: z.ZodOptional<z.ZodNumber>;
+    coverImage: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    isFeatured: z.ZodOptional<z.ZodBoolean>;
+    brandSlug: z.ZodOptional<z.ZodString>;
+    categorySlug: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    title?: string | undefined;
+    description?: string | undefined;
+    categorySlug?: string | undefined;
+    brandSlug?: string | undefined;
+    isActive?: boolean | undefined;
+    isFeatured?: boolean | undefined;
+    coverImage?: string | undefined;
+    productIds?: string[] | undefined;
+    groupTheme?: "set" | "related" | "character" | "lineage" | "generic" | undefined;
+    minActiveMembers?: number | undefined;
+}, {
+    title?: string | undefined;
+    description?: string | undefined;
+    categorySlug?: string | undefined;
+    brandSlug?: string | undefined;
+    isActive?: boolean | undefined;
+    isFeatured?: boolean | undefined;
+    coverImage?: string | undefined;
+    productIds?: string[] | undefined;
+    groupTheme?: "set" | "related" | "character" | "lineage" | "generic" | undefined;
+    minActiveMembers?: number | undefined;
+}>;