@mohasinac/appkit 4.64.1 → 4.66.0

package/dist/features/events/components/EventTypeBadge.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Span } from "../../../ui/index.js";
+import { Span } from "../../../ui/components/Typography.js";
 import { eventTypeMeta } from "../constants/event-type-meta.js";
 export function EventTypeBadge({ type, compact = false, className = "" }) {
     const meta = eventTypeMeta(type);

package/dist/features/events/components/EventsIndexListing.js

@@ -3,7 +3,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useCallback, useMemo } from "react";
 import { useUrlTable } from "../../../react/hooks/useUrlTable.js";
 import { useEvents } from "../hooks/useEvents.js";
-import { Div, Grid, ListingFilterDrawer, ListingToolbar, Pagination, Row, Stack, Text, StickyToolbar } from "../../../ui/index.js";
+import { Div } from "../../../ui/components/Div.js";
+import { Grid, Row, Stack } from "../../../ui/components/Layout.js";
+import { ListingFilterDrawer } from "../../../ui/components/ListingFilterDrawer.js";
+import { ListingToolbar } from "../../../ui/components/ListingToolbar.js";
+import { Pagination } from "../../../ui/components/Pagination.js";
+import { Text } from "../../../ui/components/Typography.js";
+import { StickyToolbar } from "../../../ui/components/StickyToolbar.js";
 import { EventCard } from "./EventCard.js";
 import { EventFilters, EVENT_PUBLIC_SORT_OPTIONS } from "./EventFilters.js";
 import { EVENT_FIELDS } from "../../../constants/field-names.js";

package/dist/features/events/components/EventsListPageView.d.ts

@@ -1,7 +1,6 @@
 import React from "react";
-type SearchParams = Record<string, string | string[]>;
+import type { SearchParamsRecord } from "../../../utils/search-params";
 export interface EventsListPageViewProps {
-    searchParams?: SearchParams;
+    searchParams?: SearchParamsRecord;
 }
 export declare function EventsListPageView({ searchParams }: EventsListPageViewProps): Promise<React.JSX.Element>;
-export {};

package/dist/features/events/components/EventsListPageView.js

@@ -1,7 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { eventRepository } from "../../../repositories/index.js";
 import { AdSlot } from "../../homepage/components/AdSlot.js";
-import { Container, Main, Section, PageHeroHeading } from "../../../ui/index.js";
+import { Container } from "../../../ui/components/Layout.js";
+import { Main, Section } from "../../../ui/components/Semantic.js";
+import { PageHeroHeading } from "../../../ui/components/PageHeroHeading.js";
 import { EventsIndexListing } from "./EventsIndexListing.js";
 import { EVENT_FIELDS } from "../../../constants/field-names.js";
 import { sieveFilter, sieveMultiEq, sieveAnd, SIEVE_OP } from "../../../utils/sieve-builder.js";
@@ -9,12 +11,9 @@ import { sortBy } from "../../../constants/sort.js";
 import { safeRead } from "../../../errors/safe-read.js";
 import { hidePublicTestData } from "../../../_internal/server/features/tester/visibility.js";
 import { sortPinnedFirst } from "../utils/sort-pinned.js";
-function sp(params, key) {
-    const v = params[key];
-    return Array.isArray(v) ? v[0] ?? "" : v ?? "";
-}
+import { firstParam } from "../../../utils/search-params.js";
 function buildEventFilters(params) {
-    const statusRaw = sp(params, "status");
+    const statusRaw = firstParam(params, "status");
     const parts = [];
     if (statusRaw) {
         const values = statusRaw.split("|").filter(Boolean);
@@ -27,7 +26,7 @@ function buildEventFilters(params) {
     else {
         parts.push(sieveFilter(EVENT_FIELDS.STATUS, SIEVE_OP.EQ, EVENT_FIELDS.STATUS_VALUES.ACTIVE));
     }
-    const type = sp(params, "type");
+    const type = firstParam(params, "type");
     if (type) {
         const values = type.split("|").filter(Boolean);
         if (values.length === 1)
@@ -35,8 +34,8 @@ function buildEventFilters(params) {
         else if (values.length > 1)
             parts.push(sieveMultiEq(EVENT_FIELDS.TYPE, values));
     }
-    const dateFrom = sp(params, "dateFrom");
-    const dateTo = sp(params, "dateTo");
+    const dateFrom = firstParam(params, "dateFrom");
+    const dateTo = firstParam(params, "dateTo");
     if (dateFrom)
         parts.push(sieveFilter(EVENT_FIELDS.STARTS_AT, SIEVE_OP.GTE, dateFrom));
     if (dateTo)
@@ -44,9 +43,9 @@ function buildEventFilters(params) {
     return sieveAnd(...parts);
 }
 export async function EventsListPageView({ searchParams = {} }) {
-    const sort = sp(searchParams, "sort") || sortBy(EVENT_FIELDS.STARTS_AT, "ASC");
-    const page = Number(sp(searchParams, "page")) || 1;
-    const pageSize = Number(sp(searchParams, "pageSize")) || 24;
+    const sort = firstParam(searchParams, "sort") || sortBy(EVENT_FIELDS.STARTS_AT, "ASC");
+    const page = Number(firstParam(searchParams, "page")) || 1;
+    const pageSize = Number(firstParam(searchParams, "pageSize")) || 24;
     const filters = buildEventFilters(searchParams);
     const [result, facetCounts] = await Promise.all([
         safeRead(() => eventRepository.list({ filters, sorts: sort, page, pageSize }), {

package/dist/features/events/components/EventsListView.js

@@ -1,6 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React from "react";
-import { Div, Grid, Pagination, Row, Stack, Text } from "../../../ui/index.js";
+import { Div } from "../../../ui/components/Div.js";
+import { Grid, Row, Stack } from "../../../ui/components/Layout.js";
+import { Pagination } from "../../../ui/components/Pagination.js";
+import { Text } from "../../../ui/components/Typography.js";
 import { EventCard } from "./EventCard.js";
 const __P = {
     p4: "p-[var(--appkit-space-4)]",

package/dist/features/events/components/RelatedEventsCarousel.js

@@ -4,7 +4,9 @@ import Link from "next/link.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
 import { SectionCarousel } from "../../homepage/components/SectionCarousel.js";
 import { MediaImage } from "../../media/MediaImage.js";
-import { Div, Heading, Stack } from "../../../ui/index.js";
+import { Div } from "../../../ui/components/Div.js";
+import { Heading } from "../../../ui/components/Typography.js";
+import { Stack } from "../../../ui/components/Layout.js";
 import { CAROUSEL_PER_VIEW } from "../../homepage/constants/carousel-per-view.js";
 export function RelatedEventsCarousel({ items, title = "Related Events", }) {
     if (items.length === 0)

package/dist/features/events/components/SpinWheel.js

@@ -27,7 +27,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import { useMemo } from "react";
 import { motion, useReducedMotion } from "motion/react";
-import { Div } from "../../../ui/index.js";
+import { Div } from "../../../ui/components/Div.js";
 /** Full turns before landing. Enough to read as a spin, short enough to wait. */
 const TURNS = 4;
 /** Degrees past the target before easing back — the "breath" at the end. */

package/dist/features/events/components/SpinWheelView.js

@@ -2,7 +2,13 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useMemo, useState } from "react";
 import { useTranslations } from "next-intl";
-import { Button, ClaimCouponButton, Div, Heading, LoginRequiredModal, Row, Span, Stack, Text, useToast } from "../../../ui/index.js";
+import { Button } from "../../../ui/components/Button.js";
+import { ClaimCouponButton } from "../../../ui/components/ClaimCouponButton.js";
+import { Div } from "../../../ui/components/Div.js";
+import { Heading, Span, Text } from "../../../ui/components/Typography.js";
+import { LoginRequiredModal } from "../../../ui/components/LoginRequiredModal.js";
+import { Row, Stack } from "../../../ui/components/Layout.js";
+import { useToast } from "../../../ui/components/toast-context.js";
 import { isAuthError } from "../../../utils/auth-error.js";
 import { SpinWheel } from "./SpinWheel.js";
 import { normalizeError } from "../../../errors/normalize.js";

package/dist/features/events/schemas/event-form.d.ts

@@ -44,6 +44,7 @@ export declare const eventDraftSchema: z.ZodEffects<z.ZodObject<{
     }>, "many">;
     couponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
     rafflePrizeCouponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
+    showOnCarousel: z.ZodOptional<z.ZodBoolean>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     type: z.ZodString;
     title: z.ZodString;
@@ -63,6 +64,7 @@ export declare const eventDraftSchema: z.ZodEffects<z.ZodObject<{
     }>, "many">;
     couponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
     rafflePrizeCouponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
+    showOnCarousel: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     type: z.ZodString;
     title: z.ZodString;
@@ -82,6 +84,7 @@ export declare const eventDraftSchema: z.ZodEffects<z.ZodObject<{
     }>, "many">;
     couponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
     rafflePrizeCouponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
+    showOnCarousel: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
     type: z.ZodString;
     title: z.ZodString;
@@ -101,6 +104,7 @@ export declare const eventDraftSchema: z.ZodEffects<z.ZodObject<{
     }>, "many">;
     couponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
     rafflePrizeCouponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
+    showOnCarousel: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     type: z.ZodString;
     title: z.ZodString;
@@ -120,4 +124,5 @@ export declare const eventDraftSchema: z.ZodEffects<z.ZodObject<{
     }>, "many">;
     couponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
     rafflePrizeCouponIds: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
+    showOnCarousel: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">>;

package/dist/features/events/schemas/event-form.js

@@ -86,6 +86,23 @@ export const eventDraftSchema = z.object({
     rafflePrizeCouponIds: annotate(attachedCouponIdsSchema, {
         section: "raffle", sectionLabel: "Raffle & Spin Wheel", order: 5, row: "full", kind: "list",
     }),
+    /*
+     * Whether this event is published to the homepage hero rail.
+     *
+     * 🛑 SEPARATE FROM THE SLIDE'S CONTENT (`carouselConfig`), which is the
+     * whole reason the field exists — see `EventDocument.showOnCarousel`. The
+     * publish decision is a one-click toggle an editor can reverse without
+     * touching artwork; the artwork is a nested discriminated union they should
+     * not have to open in order to pull a promotion off the front page.
+     *
+     * `.optional()` so absent keeps meaning "not on the rail", and so every
+     * event saved before this field existed round-trips unchanged — a required
+     * boolean here would make the admin editor refuse to save any of them.
+     */
+    showOnCarousel: annotate(z.boolean().optional(), {
+        section: "settings", order: 6, row: "pair", kind: "toggle",
+        help: "Show this event as a slide on the homepage carousel. Needs carousel artwork to be configured.",
+    }),
 }).passthrough().superRefine((v, ctx) => {
     if (v.type === "offer") {
         if (!v.couponId.trim()) {

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

@@ -20,7 +20,25 @@ export declare const EVENT_ENTRIES_COLLECTION: "eventEntries";
 interface EventCarouselBase {
     /** Slide order in the hero rail. Lower is earlier. */
     order?: number;
-    /** Whether the generated slide is live. Absent means false — opt in. */
+    /**
+     * @deprecated Use the top-level `EventDocument.showOnCarousel` instead.
+     *
+     * 🛑 READ-ONLY LEGACY FALLBACK — DO NOT SET THIS ON NEW EVENTS.
+     * This was the publish decision until `showOnCarousel` took that job, and it
+     * is still read by `buildSlideFromEvent` for one reason only: every event
+     * document already in Firestore carries it and carries no `showOnCarousel`.
+     * A strict gate on the new flag would therefore pull every existing slide off
+     * the live homepage the moment this shipped, with nothing in any log saying
+     * why.
+     *
+     * The fallback is deliberately ONE-DIRECTIONAL: `showOnCarousel` wins
+     * wherever it is present, and nothing ever writes back to this field. That
+     * is what keeps it a migration shim rather than a second owner — a mirror
+     * field that both sides write is Root Cause #42, and this one has no writer.
+     *
+     * REMOVE IT once every stored event carries `showOnCarousel`, which is true
+     * after one `appkit-seed load` plus one `push-editorial-content.mjs` run.
+     */
     active?: boolean;
     /**
      * Background image slug for the slide. Defaults to the event's own
@@ -157,6 +175,36 @@ export interface EventDocument extends BaseDocument {
      * long as everyone remembers to do it.
      */
     carouselConfig?: EventCarouselConfig;
+    /**
+     * Whether this event is published to the homepage hero rail.
+     *
+     * 🛑 SEPARATE FROM `carouselConfig`, AND THAT SEPARATION IS THE POINT.
+     * `carouselConfig` is the slide's CONTENT — its artwork, headline, zones and
+     * copy. This is the DECISION TO PUBLISH it. Before this field the two were
+     * the same boolean (`carouselConfig.active`), which made three ordinary
+     * things impossible:
+     *
+     *  1. Authoring a slide ahead of time without it going live. An editor had
+     *     to either publish immediately or leave the event with no slide at all.
+     *  2. Pulling an event off the rail without touching its artwork. Flipping a
+     *     nested field inside a discriminated union is a content edit, and it
+     *     reads as one in the audit log.
+     *  3. Seeing, from the events LIST, which events are on the rail — a nested
+     *     boolean inside an optional union is not something a list column or a
+     *     Sieve filter can reach.
+     *
+     * Absent means NOT on the rail — opt in, never opt out. Every event that
+     * predates this field therefore stays off it until someone says otherwise,
+     * which is the safe direction for a field that controls what the homepage
+     * shows.
+     *
+     * 🛑 BOTH are required for a slide to exist: this flag says "publish it" and
+     * `carouselConfig` says "publish WHAT". `buildSlideFromEvent` returns `null`
+     * unless it has both, rather than inventing a slide out of the event's bare
+     * title — a slide with no authored artwork is a grey rectangle on the first
+     * screen of the site.
+     */
+    showOnCarousel?: boolean;
     saleConfig?: SaleConfig;
     offerConfig?: OfferConfig;
     pollConfig?: PollConfig;