@mohasinac/appkit 4.13.1 → 4.14.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/index.d.ts

@@ -43,9 +43,9 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     slug: string;
-    isFeatured: boolean;
     isActive: boolean;
     createdBy: string;
+    isFeatured: boolean;
     productIds: string[];
     groupTheme: "set" | "related" | "character" | "lineage" | "generic";
     visibilityStatus: "hidden" | "visible";
@@ -53,8 +53,8 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
     activeMemberCount: number;
     storeId?: string | undefined;
     description?: string | undefined;
-    brandSlug?: string | undefined;
     categorySlug?: string | undefined;
+    brandSlug?: string | undefined;
     coverImage?: string | undefined;
 }, {
     id: string;
@@ -66,9 +66,9 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     slug: string;
-    isFeatured: boolean;
     isActive: boolean;
     createdBy: string;
+    isFeatured: boolean;
     productIds: string[];
     groupTheme: "set" | "related" | "character" | "lineage" | "generic";
     visibilityStatus: "hidden" | "visible";
@@ -76,8 +76,8 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
     activeMemberCount: number;
     storeId?: string | undefined;
     description?: string | undefined;
-    brandSlug?: string | undefined;
     categorySlug?: string | undefined;
+    brandSlug?: string | undefined;
     coverImage?: string | undefined;
 }>;
 export type GroupedListingFromSchema = z.infer<typeof groupedListingFirestoreSchema>;

package/dist/features/homepage/components/AnnouncementBar.d.ts

@@ -2,6 +2,12 @@ import React from "react";
 export declare function hashBannerMessage(msg: string): string;
 export interface AnnouncementBarProps {
     message: string;
+    /**
+     * Optional destination for the message. The admin editor has collected this
+     * (and `backgroundColor`) since it was built, but neither was ever rendered —
+     * so both were silently discarded on save. Wired 2026-08-24.
+     */
+    link?: string;
     className?: string;
     /** Called when the user dismisses — consumer wires this to a server action to persist. */
     onDismiss?: (hash: string) => void;
@@ -14,4 +20,4 @@ export interface AnnouncementBarProps {
      */
     overlay?: boolean;
 }
-export declare function AnnouncementBar({ message, className, onDismiss, overlay }: AnnouncementBarProps): React.JSX.Element | null;
+export declare function AnnouncementBar({ message, link, className, onDismiss, overlay }: AnnouncementBarProps): React.JSX.Element | null;

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

@@ -5,7 +5,7 @@ import { useState, useEffect } from "react";
 import { X } from "lucide-react";
 import { useAuth } from "../../../react/contexts/SessionContext";
 import { Div } from "../../../ui/components/Div";
-import { IconButton, Row, Span } from "@mohasinac/appkit/client";
+import { IconButton, Row, Span, TextLink } from "@mohasinac/appkit/client";
 const STORAGE_KEY = "letitrip:announcement-dismissed";
 const ONE_WEEK_MS = 7 * 24 * 60 * 60 * 1000;
 export function hashBannerMessage(msg) {
@@ -38,7 +38,7 @@ function saveLocalDismissal(message) {
         void normalizeError(_err); /* quota exceeded — ignore */
     }
 }
-export function AnnouncementBar({ message, className = "", onDismiss, overlay = false }) {
+export function AnnouncementBar({ message, link, className = "", onDismiss, overlay = false }) {
     const { user } = useAuth();
     const bannerHash = hashBannerMessage(message);
     const userAlreadyDismissed = !!user?.dismissedBannerHash && user.dismissedBannerHash === bannerHash;
@@ -58,7 +58,7 @@ export function AnnouncementBar({ message, className = "", onDismiss, overlay =
     const positionCls = overlay
         ? "absolute inset-x-0 top-0 z-20 bg-primary-700/85 backdrop-blur-sm"
         : "relative left-1/2 right-1/2 w-screen -translate-x-1/2 bg-primary-700";
-    return (_jsx(Div, { className: `${positionCls} transition-opacity duration-200 ${mounted ? "opacity-100" : "opacity-0"} ${className}`, role: "banner", children: _jsx(Div, { paddingX: "x-page", className: "container mx-auto max-w-[1920px]", children: _jsxs(Row, { textWeight: "medium", textSize: "sm", className: "relative text-left text-white", padding: "y-xs", align: "center", justify: "start", children: [_jsx(Span, { children: message }), _jsx(IconButton, { type: "button", onClick: () => {
+    return (_jsx(Div, { className: `${positionCls} transition-opacity duration-200 ${mounted ? "opacity-100" : "opacity-0"} ${className}`, role: "banner", children: _jsx(Div, { paddingX: "x-page", className: "container mx-auto max-w-[1920px]", children: _jsxs(Row, { textWeight: "medium", textSize: "sm", className: "relative text-left text-white", padding: "y-xs", align: "center", justify: "start", children: [link ? (_jsx(TextLink, { href: link, className: "text-white underline", children: message })) : (_jsx(Span, { children: message })), _jsx(IconButton, { type: "button", onClick: () => {
                             saveLocalDismissal(message);
                             onDismiss?.(bannerHash);
                             setDismissed(true);