@mohasinac/appkit 4.3.2 → 4.4.1

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

@@ -47,6 +47,16 @@ export interface EventDocument extends BaseDocument {
     spinMaxPerUser?: number;
     spinWindowStart?: Date;
     spinWindowEnd?: Date;
+    /**
+     * Per-event admin toggle — when true, `enterEvent()` (and the spin-prize
+     * find-or-create step) allow an unauthenticated caller to participate,
+     * identified by a hashed IP instead of a `userId`. Default/undefined
+     * preserves the prior per-type login rules (poll/survey require login;
+     * non-anonymous feedback requires login; raffle/spin_wheel now also
+     * require login unless this flag is set — see Root Cause callout in
+     * CLAUDE.md "SSR Architecture" era docs / event-actions.ts `enterEvent`).
+     */
+    allowGuestParticipation?: boolean;
     /** Full lottery config including server-only price/weight fields. */
     lotteryConfig?: LotteryConfig;
     stats: {
@@ -74,14 +84,24 @@ export type EventEntryDocument = {
     points?: number;
     raffleEligible?: boolean;
     spinUsed?: boolean;
+    /** Count of spins consumed by this identity, enforced against `EventDocument.spinMaxPerUser`. `spinUsed` is kept as a cheap boolean mirror (count > 0) for existing readers. */
+    spinCount?: number;
     spinPrizeId?: string;
     spinPrizeCouponCode?: string | null;
     spinWonAt?: Date;
     ipAddress?: string;
+    /**
+     * HMAC-SHA256 blind index of a guest (non-logged-in) participant's IP,
+     * scoped per event — `hmacBlindIndex(eventId + ":" + rawIp)`. Set only
+     * when `userId` is absent and the event's `allowGuestParticipation` is
+     * true. Never the raw IP — see `ipAddress` above, which is a separate,
+     * currently-unused field; do not repurpose it for this hash.
+     */
+    guestIpHash?: string;
     submittedAt: Date;
 };
 export declare const EVENT_INDEXED_FIELDS: readonly ["type", "status", "startsAt", "endsAt", "createdAt"];
-export declare const EVENT_ENTRY_INDEXED_FIELDS: readonly ["eventId", "userId", "reviewStatus", "status", "submittedAt", "points"];
+export declare const EVENT_ENTRY_INDEXED_FIELDS: readonly ["eventId", "userId", "guestIpHash", "reviewStatus", "status", "submittedAt", "points", "spinWonAt"];
 export declare const EVENT_FIELDS: {
     readonly ID: "id";
     readonly SLUG: "slug";
@@ -97,6 +117,7 @@ export declare const EVENT_FIELDS: {
     readonly WINNER_IMAGES: "winnerImages";
     readonly ADDITIONAL_IMAGES: "additionalImages";
     readonly TAGS: "tags";
+    readonly ALLOW_GUEST_PARTICIPATION: "allowGuestParticipation";
     readonly CREATED_BY: "createdBy";
     readonly CREATED_AT: "createdAt";
     readonly UPDATED_AT: "updatedAt";
@@ -131,6 +152,12 @@ export declare const EVENT_ENTRY_FIELDS: {
     readonly REVIEWED_AT: "reviewedAt";
     readonly SUBMITTED_AT: "submittedAt";
     readonly POINTS: "points";
+    readonly GUEST_IP_HASH: "guestIpHash";
+    readonly SPIN_USED: "spinUsed";
+    readonly SPIN_COUNT: "spinCount";
+    readonly SPIN_PRIZE_ID: "spinPrizeId";
+    readonly SPIN_PRIZE_COUPON_CODE: "spinPrizeCouponCode";
+    readonly SPIN_WON_AT: "spinWonAt";
     readonly REVIEW_STATUS_VALUES: {
         readonly PENDING: EntryReviewStatus;
         readonly APPROVED: EntryReviewStatus;

package/dist/features/events/schemas/firestore.js

@@ -13,10 +13,12 @@ export const EVENT_INDEXED_FIELDS = [
 export const EVENT_ENTRY_INDEXED_FIELDS = [
     "eventId",
     "userId",
+    "guestIpHash",
     "reviewStatus",
     "status",
     "submittedAt",
     "points",
+    "spinWonAt",
 ];
 export const EVENT_FIELDS = {
     ID: "id",
@@ -33,6 +35,7 @@ export const EVENT_FIELDS = {
     WINNER_IMAGES: "winnerImages",
     ADDITIONAL_IMAGES: "additionalImages",
     TAGS: "tags",
+    ALLOW_GUEST_PARTICIPATION: "allowGuestParticipation",
     CREATED_BY: "createdBy",
     CREATED_AT: "createdAt",
     UPDATED_AT: "updatedAt",
@@ -67,6 +70,12 @@ export const EVENT_ENTRY_FIELDS = {
     REVIEWED_AT: "reviewedAt",
     SUBMITTED_AT: "submittedAt",
     POINTS: "points",
+    GUEST_IP_HASH: "guestIpHash",
+    SPIN_USED: "spinUsed",
+    SPIN_COUNT: "spinCount",
+    SPIN_PRIZE_ID: "spinPrizeId",
+    SPIN_PRIZE_COUPON_CODE: "spinPrizeCouponCode",
+    SPIN_WON_AT: "spinWonAt",
     REVIEW_STATUS_VALUES: {
         PENDING: "pending",
         APPROVED: "approved",

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

@@ -923,7 +923,7 @@ export declare const eventItemSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: "lottery" | "raffle" | "offer" | "feedback" | "sale" | "poll" | "survey" | "spin_wheel";
+    type: "lottery" | "sale" | "offer" | "poll" | "survey" | "feedback" | "raffle" | "spin_wheel";
     status: "ended" | "cancelled" | "draft" | "active" | "paused";
     id: string;
     title: string;
@@ -949,7 +949,7 @@ export declare const eventItemSchema: z.ZodObject<{
         url: string;
         type: "image";
     } | null;
-    additionalImages: {
+    eventImages: {
         type: "video" | "image" | "file";
         url: string;
         source?: "upload" | "youtube" | "external" | undefined;
@@ -957,7 +957,7 @@ export declare const eventItemSchema: z.ZodObject<{
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
     }[];
-    eventImages: {
+    winnerImages: {
         type: "video" | "image" | "file";
         url: string;
         source?: "upload" | "youtube" | "external" | undefined;
@@ -965,7 +965,7 @@ export declare const eventItemSchema: z.ZodObject<{
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
     }[];
-    winnerImages: {
+    additionalImages: {
         type: "video" | "image" | "file";
         url: string;
         source?: "upload" | "youtube" | "external" | undefined;
@@ -989,7 +989,7 @@ export declare const eventItemSchema: z.ZodObject<{
         maxPullsPerUser: number;
     } | undefined;
     hasRaffle?: boolean | undefined;
-    raffleType?: "spin_wheel" | "open_raffle" | "top_n_scorers" | "top_n_participants" | undefined;
+    raffleType?: "spin_wheel" | "top_n_scorers" | "top_n_participants" | "open_raffle" | undefined;
     raffleTopN?: number | undefined;
     rafflePrize?: string | undefined;
     rafflePrizeCouponId?: string | undefined;
@@ -1074,7 +1074,7 @@ export declare const eventItemSchema: z.ZodObject<{
     } | undefined;
     rafflePrizeProductIds?: string[] | undefined;
 }, {
-    type: "lottery" | "raffle" | "offer" | "feedback" | "sale" | "poll" | "survey" | "spin_wheel";
+    type: "lottery" | "sale" | "offer" | "poll" | "survey" | "feedback" | "raffle" | "spin_wheel";
     status: "ended" | "cancelled" | "draft" | "active" | "paused";
     id: string;
     title: string;
@@ -1105,7 +1105,7 @@ export declare const eventItemSchema: z.ZodObject<{
         maxPullsPerUser: number;
     } | undefined;
     hasRaffle?: boolean | undefined;
-    raffleType?: "spin_wheel" | "open_raffle" | "top_n_scorers" | "top_n_participants" | undefined;
+    raffleType?: "spin_wheel" | "top_n_scorers" | "top_n_participants" | "open_raffle" | undefined;
     raffleTopN?: number | undefined;
     rafflePrize?: string | undefined;
     rafflePrizeCouponId?: string | undefined;
@@ -1132,7 +1132,8 @@ export declare const eventItemSchema: z.ZodObject<{
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
     } | null | undefined;
-    additionalImages?: {
+    coverImageUrl?: string | undefined;
+    eventImages?: {
         type: "video" | "image" | "file";
         url: string;
         source?: "upload" | "youtube" | "external" | undefined;
@@ -1140,8 +1141,7 @@ export declare const eventItemSchema: z.ZodObject<{
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
-    coverImageUrl?: string | undefined;
-    eventImages?: {
+    winnerImages?: {
         type: "video" | "image" | "file";
         url: string;
         source?: "upload" | "youtube" | "external" | undefined;
@@ -1149,7 +1149,7 @@ export declare const eventItemSchema: z.ZodObject<{
         thumbnailUrl?: string | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
-    winnerImages?: {
+    additionalImages?: {
         type: "video" | "image" | "file";
         url: string;
         source?: "upload" | "youtube" | "external" | undefined;
@@ -1231,14 +1231,14 @@ export declare const eventListParamsSchema: z.ZodObject<{
     perPage: z.ZodOptional<z.ZodNumber>;
     sort: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type?: "lottery" | "raffle" | "offer" | "feedback" | "sale" | "poll" | "survey" | "spin_wheel" | undefined;
+    type?: "lottery" | "sale" | "offer" | "poll" | "survey" | "feedback" | "raffle" | "spin_wheel" | undefined;
     sort?: string | undefined;
     status?: "ended" | "cancelled" | "draft" | "active" | "paused" | undefined;
     page?: number | undefined;
     q?: string | undefined;
     perPage?: number | undefined;
 }, {
-    type?: "lottery" | "raffle" | "offer" | "feedback" | "sale" | "poll" | "survey" | "spin_wheel" | undefined;
+    type?: "lottery" | "sale" | "offer" | "poll" | "survey" | "feedback" | "raffle" | "spin_wheel" | undefined;
     sort?: string | undefined;
     status?: "ended" | "cancelled" | "draft" | "active" | "paused" | undefined;
     page?: number | undefined;

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

@@ -97,6 +97,8 @@ export interface EventItem {
     spinMaxPerUser?: number;
     spinWindowStart?: string;
     spinWindowEnd?: string;
+    /** Per-event admin toggle — unauthenticated visitors may participate when true. */
+    allowGuestParticipation?: boolean;
     /** Lottery config — slots have price/weight stripped for client consumption. */
     lotteryConfig?: ClientLotteryConfig;
     stats: {
@@ -136,6 +138,30 @@ export interface LeaderboardEntry {
     totalPoints: number;
     entryCount: number;
 }
+/**
+ * Tallied vote count for a single poll option — used in place of
+ * LeaderboardEntry for event.type === "poll" (a voter-ranked leaderboard is
+ * meaningless for a poll; this is a per-option result instead).
+ */
+export interface PollResultEntry {
+    optionId: string;
+    label: string;
+    count: number;
+    percent: number;
+}
+/**
+ * One row of the public "Last 10 Spin Results" feed for a spin_wheel event.
+ * `userDisplayName` is undefined for guest spins (`isGuest: true`) — callers
+ * should render a generic "Guest" label in that case, never a raw hash.
+ */
+export interface SpinResultEntry {
+    id: string;
+    userDisplayName?: string;
+    isGuest: boolean;
+    spinPrizeId?: string;
+    spinPrizeTitle?: string;
+    spinWonAt?: string;
+}
 export interface EventListResponse {
     items: EventItem[];
     total: number;

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

@@ -30,8 +30,8 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     priority: number;
     order: number;
     isActive: boolean;
-    question: string;
     showOnHomepage: boolean;
+    question: string;
     answer: {
         text: string;
         format: "html" | "plain" | "markdown";
@@ -54,8 +54,8 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     tags?: string[] | undefined;
     priority?: number | undefined;
     order?: number | undefined;
-    isActive?: boolean | undefined;
     variables?: Record<string, string> | undefined;
+    isActive?: boolean | undefined;
     showOnHomepage?: boolean | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
@@ -66,8 +66,8 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     priority: number;
     order: number;
     isActive: boolean;
-    question: string;
     showOnHomepage: boolean;
+    question: string;
     answer: {
         text: string;
         format: "html" | "plain" | "markdown";
@@ -90,8 +90,8 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     tags?: string[] | undefined;
     priority?: number | undefined;
     order?: number | undefined;
-    isActive?: boolean | undefined;
     variables?: Record<string, string> | undefined;
+    isActive?: boolean | undefined;
     showOnHomepage?: boolean | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
@@ -128,10 +128,10 @@ export declare const faqUpdateSchema: z.ZodObject<{
     tags?: string[] | undefined;
     priority?: number | undefined;
     order?: number | undefined;
-    isActive?: boolean | undefined;
     variables?: Record<string, string> | undefined;
-    question?: string | undefined;
+    isActive?: boolean | undefined;
     showOnHomepage?: boolean | undefined;
+    question?: string | undefined;
     answer?: {
         text: string;
         format: "html" | "plain" | "markdown";
@@ -146,10 +146,10 @@ export declare const faqUpdateSchema: z.ZodObject<{
     tags?: string[] | undefined;
     priority?: number | undefined;
     order?: number | undefined;
-    isActive?: boolean | undefined;
     variables?: Record<string, string> | undefined;
-    question?: string | undefined;
+    isActive?: boolean | undefined;
     showOnHomepage?: boolean | undefined;
+    question?: string | undefined;
     answer?: {
         text: string;
         format?: "html" | "plain" | "markdown" | undefined;

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

@@ -94,19 +94,19 @@ export declare const faqSchema: z.ZodObject<{
     tags?: string[] | undefined;
     priority?: number | undefined;
     order?: number | undefined;
+    isActive?: boolean | undefined;
     stats?: {
         views?: number | undefined;
         helpful?: number | undefined;
         notHelpful?: number | undefined;
     } | undefined;
-    isActive?: boolean | undefined;
-    seo?: {
-        slug?: string | undefined;
-    } | undefined;
     showOnHomepage?: boolean | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
+    seo?: {
+        slug?: string | undefined;
+    } | undefined;
 }, {
     id: string;
     category: "orders_payment" | "shipping_delivery" | "returns_refunds" | "product_information" | "account_security" | "technical_support" | "general";
@@ -120,19 +120,19 @@ export declare const faqSchema: z.ZodObject<{
     tags?: string[] | undefined;
     priority?: number | undefined;
     order?: number | undefined;
+    isActive?: boolean | undefined;
     stats?: {
         views?: number | undefined;
         helpful?: number | undefined;
         notHelpful?: number | undefined;
     } | undefined;
-    isActive?: boolean | undefined;
-    seo?: {
-        slug?: string | undefined;
-    } | undefined;
     showOnHomepage?: boolean | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
+    seo?: {
+        slug?: string | undefined;
+    } | undefined;
 }>;
 /** Base schema for list-query parameters. */
 export declare const faqListParamsSchema: z.ZodObject<{
@@ -285,6 +285,7 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     tags: string[];
     priority: number;
     order: number;
+    isActive: boolean;
     stats: {
         views: number;
         helpful: number;
@@ -293,15 +294,9 @@ export declare const faqFirestoreSchema: z.ZodObject<{
             toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     };
-    isActive: boolean;
-    question: string;
-    seo: {
-        slug: string;
-        metaTitle?: string | undefined;
-        metaDescription?: string | undefined;
-    };
     createdBy: string;
     showOnHomepage: boolean;
+    question: string;
     answer: {
         text: string;
         format: "html" | "plain" | "markdown";
@@ -310,6 +305,11 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     isPinned: boolean;
     relatedFAQs: string[];
     useSiteSettings: boolean;
+    seo: {
+        slug: string;
+        metaTitle?: string | undefined;
+        metaDescription?: string | undefined;
+    };
     searchTokens?: string[] | undefined;
     variables?: Record<string, string> | undefined;
 }, {
@@ -324,6 +324,7 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     tags: string[];
     priority: number;
     order: number;
+    isActive: boolean;
     stats: {
         views: number;
         helpful: number;
@@ -332,15 +333,9 @@ export declare const faqFirestoreSchema: z.ZodObject<{
             toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     };
-    isActive: boolean;
-    question: string;
-    seo: {
-        slug: string;
-        metaTitle?: string | undefined;
-        metaDescription?: string | undefined;
-    };
     createdBy: string;
     showOnHomepage: boolean;
+    question: string;
     answer: {
         text: string;
         format: "html" | "plain" | "markdown";
@@ -349,6 +344,11 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     isPinned: boolean;
     relatedFAQs: string[];
     useSiteSettings: boolean;
+    seo: {
+        slug: string;
+        metaTitle?: string | undefined;
+        metaDescription?: string | undefined;
+    };
     searchTokens?: string[] | undefined;
     variables?: Record<string, string> | undefined;
 }>;

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

@@ -43,8 +43,8 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     slug: string;
-    isActive: boolean;
     isFeatured: boolean;
+    isActive: boolean;
     createdBy: string;
     productIds: string[];
     groupTheme: "set" | "related" | "character" | "lineage" | "generic";
@@ -66,8 +66,8 @@ export declare const groupedListingFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     slug: string;
-    isActive: boolean;
     isFeatured: boolean;
+    isActive: boolean;
     createdBy: string;
     productIds: string[];
     groupTheme: "set" | "related" | "character" | "lineage" | "generic";

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

@@ -5,5 +5,13 @@ export interface AnnouncementBarProps {
     className?: string;
     /** Called when the user dismisses — consumer wires this to a server action to persist. */
     onDismiss?: (hash: string) => void;
+    /**
+     * Renders as a translucent, backdrop-blurred strip pinned to the top edge
+     * of the nearest positioned ancestor, instead of the default full-bleed
+     * in-flow bar. Used on the homepage to overlay the banner over the first
+     * section (e.g. the Welcome hero) rather than pushing it down with extra
+     * vertical space.
+     */
+    overlay?: boolean;
 }
-export declare function AnnouncementBar({ message, className, onDismiss }: AnnouncementBarProps): React.JSX.Element | null;
+export declare function AnnouncementBar({ message, 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";
+import { IconButton, Row, Span } 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 }) {
+export function AnnouncementBar({ message, className = "", onDismiss, overlay = false }) {
     const { user } = useAuth();
     const bannerHash = hashBannerMessage(message);
     const userAlreadyDismissed = !!user?.dismissedBannerHash && user.dismissedBannerHash === bannerHash;
@@ -55,7 +55,10 @@ export function AnnouncementBar({ message, className = "", onDismiss }) {
     }, [message, userAlreadyDismissed]);
     if (dismissed)
         return null;
-    return (_jsx(Div, { className: `relative left-1/2 right-1/2 w-screen -translate-x-1/2 bg-primary-700 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: () => {
+    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: () => {
                             saveLocalDismissal(message);
                             onDismiss?.(bannerHash);
                             setDismissed(true);

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

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
 import { sortBy } from "@mohasinac/appkit";
-import { Main } from "../../../ui";
+import { Div, Main } from "../../../ui";
 import { carouselRepository, faqsRepository, siteSettingsRepository } from "../../../repositories";
 import { fetchLiveStats } from "../lib/live-stats";
 import { renderSection, AnnouncementBar } from "../lib/section-renderer";
@@ -115,5 +115,5 @@ export async function MarketplaceHomepageView({ adSlots, newsletterFormSlot, onB
             : undefined,
     };
     const carouselSlides = toCarouselSlides(slides);
-    return (_jsxs(Main, { children: [showAnnouncement ? _jsx(AnnouncementBar, { message: announcementMessage, onDismiss: onBannerDismiss }) : null, orderedSections.map((section) => renderSection(section, adSlots, newsletterFormSlot ?? null, faqItems, carouselSlides, liveStats, sectionData))] }));
+    return (_jsx(Main, { children: _jsxs(Div, { className: "relative", children: [showAnnouncement ? (_jsx(AnnouncementBar, { overlay: true, message: announcementMessage, onDismiss: onBannerDismiss })) : null, orderedSections.map((section) => renderSection(section, adSlots, newsletterFormSlot ?? null, faqItems, carouselSlides, liveStats, sectionData))] }) }));
 }

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

@@ -41,5 +41,9 @@ export function SectionCarousel({ title, description, headingVariant = "editoria
                                     headingClass,
                                 ]
                                     .filter(Boolean)
-                                    .join(" "), children: title }), headingVariant === "editorial" && (_jsxs(Row, { align: "center", justify: "center", gap: "sm", textSize: "xs", color: "faint", className: "mt-1 select-none", "aria-hidden": "true", children: [_jsx(Span, { className: "h-px w-6 bg-current" }), _jsx(Span, { size: "xs", children: "\u2736" }), _jsx(Span, { className: "h-px w-6 bg-current" })] })), description && (_jsx(Text, { className: `${descVariant} mt-2`, size: "base", children: description }))] }), isLoading ? (_jsx(CarouselSkeleton, { count: skeletonCount })) : (_jsx(HorizontalScroller, { items: items, renderItem: renderItem, perView: perView, gap: gap, autoScroll: autoScroll, autoScrollInterval: autoScrollInterval, loop: loop, keyExtractor: keyExtractor, rows: rows, minItemWidth: minItemWidth, showArrows: true, snapToItems: true, showFadeEdges: true, showScrollbar: false, pauseOnHover: true })), viewMoreHref && !isLoading && (_jsx(Row, { className: "mt-6", justify: "start", children: _jsx(TextLink, { rounded: "lg", paddingX: "xl", paddingY: "sm", href: viewMoreHref, shadow: useLightText ? "lg" : "none", className: "inline-flex items-[center] gap-[0.375rem] transition-colors bg-primary text-white hover:bg-primary-600", size: "sm", weight: "semibold", children: viewMoreLabel }) }))] })] }));
+                                    .join(" "), children: title }), headingVariant === "editorial" && (_jsxs(Row, { align: "center", justify: "center", gap: "sm", textSize: "xs", color: "faint", className: "mt-1 select-none", "aria-hidden": "true", children: [_jsx(Span, { className: "h-px w-6 bg-current" }), _jsx(Span, { size: "xs", children: "\u2736" }), _jsx(Span, { className: "h-px w-6 bg-current" })] })), description && (_jsx(Text, { className: `${descVariant} mt-2`, size: "base", children: description }))] }), isLoading ? (_jsx(CarouselSkeleton, { count: skeletonCount })) : (_jsx(HorizontalScroller, { items: items, renderItem: renderItem, perView: perView, gap: gap, autoScroll: autoScroll, autoScrollInterval: autoScrollInterval, loop: loop, keyExtractor: keyExtractor, rows: rows, minItemWidth: minItemWidth, showArrows: true, 
+                        // Double-row grids (e.g. the homepage Auctions section's
+                        // rows:2 config) get the full-height sliver arrows — much
+                        // easier to hit than a small circle when the track is tall.
+                        arrowStyle: rows > 1 ? "full-height" : "circle", snapToItems: true, showFadeEdges: true, showScrollbar: false, pauseOnHover: true })), viewMoreHref && !isLoading && (_jsx(Row, { className: "mt-6", justify: "start", children: _jsx(TextLink, { rounded: "lg", paddingX: "xl", paddingY: "sm", href: viewMoreHref, shadow: useLightText ? "lg" : "none", className: "inline-flex items-[center] gap-[0.375rem] transition-colors bg-primary text-white hover:bg-primary-600", size: "sm", weight: "semibold", children: viewMoreLabel }) }))] })] }));
 }

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

@@ -7,7 +7,7 @@ export function WelcomeSection({ title, subtitle, pillLabel, showCTA = true, cta
     const themed = { textSecondary: THEMED_TEXT_SECONDARY };
     const flex = { center: FLEX_CENTER };
     if (isLoading) {
-        return (_jsx(Section, { className: `relative overflow-hidden md:py-[6rem] ${className}`, paddingY: "y-4xl", paddingX: "x-md", children: _jsxs(Div, { className: "animate-pulse max-w-4xl mx-auto text-left", children: [_jsx(Div, { className: "h-6 w-52 mb-6", surface: "subtle", rounded: "full" }), _jsx(Div, { className: "h-20 mb-4 max-w-2xl", surface: "subtle", rounded: "lg" }), _jsx(Div, { className: "h-6 mb-8 max-w-lg", surface: "subtle", rounded: "lg" }), _jsxs(Row, { justify: "start", gap: "md", children: [_jsx(Div, { className: "h-12 w-36", surface: "subtle", rounded: "xl" }), _jsx(Div, { className: "h-12 w-36", surface: "subtle", rounded: "xl" })] })] }) }));
+        return (_jsx(Section, { className: `relative overflow-hidden pt-[0px] pb-[var(--appkit-space-16)] md:pt-[0px] md:pb-[6rem] ${className}`, paddingX: "x-md", children: _jsxs(Div, { className: "animate-pulse max-w-4xl mx-auto text-left", children: [_jsx(Div, { className: "h-6 w-52 mb-6", surface: "subtle", rounded: "full" }), _jsx(Div, { className: "h-20 mb-4 max-w-2xl", surface: "subtle", rounded: "lg" }), _jsx(Div, { className: "h-6 mb-8 max-w-lg", surface: "subtle", rounded: "lg" }), _jsxs(Row, { justify: "start", gap: "md", children: [_jsx(Div, { className: "h-12 w-36", surface: "subtle", rounded: "xl" }), _jsx(Div, { className: "h-12 w-36", surface: "subtle", rounded: "xl" })] })] }) }));
     }
-    return (_jsxs(Section, { className: `relative overflow-hidden md:py-[7rem] ${className}`, paddingY: "y-5xl", paddingX: "x-md", children: [_jsx(Div, { className: "pointer-events-none absolute -top-32 -left-32 w-[28rem] h-[28rem] bg-primary/10 blur-3xl", rounded: "full", "aria-hidden": "true" }), _jsx(Div, { className: "pointer-events-none absolute -bottom-40 -right-40 w-[36rem] h-[36rem] bg-secondary/10 dark:bg-secondary/15 blur-3xl", rounded: "full", "aria-hidden": "true" }), _jsx(Div, { className: "relative z-10 max-w-7xl mx-auto", children: _jsxs(Grid, { align: "center", gap: "2xl", className: "grid-cols-1 lg:grid-cols-2 xl:grid-cols-2 2xl:grid-cols-2", children: [_jsxs(Div, { className: "text-left", children: [pillLabel && (_jsx(Div, { children: _jsxs(Span, { layout: "inline-flex", gap: "md", size: "xs", weight: "medium", className: "border border-primary-[500]/30 bg-primary-500/10 px-[1.25rem] py-[0.375rem] tracking-[0.2em] text-primary-700 dark:text-primary-400 backdrop-blur-sm", rounded: "full", transform: "uppercase", children: [_jsx(Span, { className: "w-1.5 h-1.5 bg-primary-500 inline-block", rounded: "full", "aria-hidden": "true" }), pillLabel, _jsx(Span, { className: "w-1.5 h-1.5 bg-primary-500 inline-block", rounded: "full", "aria-hidden": "true" })] }) })), _jsx(Heading, { level: 1, variant: "none", gradient: "brand-tri", className: "mt-4 font-display leading-[1.1] tracking-tight break-words", size: "5xl", mdSize: "6xl", lgSize: "7xl", xlSize: "7xl", children: title }), subtitle && (_jsx(Text, { className: `mt-4 ${themed.textSecondary} max-w-xl leading-relaxed`, size: "xl", children: subtitle })), showCTA && (_jsxs(Row, { wrap: true, gap: "md", className: "mt-8", justify: "start", children: [ctaHref ? (_jsx(TextLink, { rounded: "xl", href: ctaHref, className: "inline-flex items-[center] justify-[center] px-[2rem] py-[0.875rem] !bg-primary hover:!bg-primary-600 text-white dark:!bg-primary dark:hover:!bg-primary-600 dark:text-white btn-glow transition-all hover:scale-[1.02]", size: "base", weight: "bold", children: ctaLabel })) : (_jsx(Button, { variant: "primary", size: "lg", onClick: onCtaClick, children: ctaLabel })), secondaryCtaHref ? (_jsx(TextLink, { rounded: "xl", href: secondaryCtaHref, className: "inline-flex items-[center] justify-[center] border-2 border-cobalt/40 dark:border-cobalt-400/40 px-[2rem] py-[0.875rem] text-cobalt-700 dark:text-cobalt-300 hover:bg-cobalt-50 dark:hover:bg-cobalt-900/20 transition-all hover:scale-[1.02]", size: "base", weight: "semibold", children: secondaryCtaLabel })) : (_jsx(Button, { variant: "outline", size: "lg", onClick: onSecondaryCtaClick, children: secondaryCtaLabel }))] })), trustChips.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mt-6", justify: "start", children: trustChips.map((chip) => (_jsxs(Span, { layout: "inline-flex", gap: "xs", size: "xs", weight: "medium", className: "border border-zinc-[200] dark:border-slate-[700] px-[0.875rem] py-[0.375rem]", rounded: "full", surface: "subtle", color: "muted", children: [chip.emoji, " ", chip.label] }, chip.key))) }))] }), _jsx(Div, { className: "hidden lg:block", children: _jsxs(Div, { className: `relative overflow-hidden aspect-[4/3] bg-[image:var(--appkit-gradient-section-mesh)]`, shadow: "2xl", border: "default", rounded: "3xl", children: [_jsx(Div, { className: "absolute inset-0 bg-[image:var(--appkit-gradient-glass)]" }), _jsxs(Stack, { centered: true, gap: "sm", className: `absolute inset-0 ${flex.center} p-[2.5rem]`, children: [_jsx(SiteMark, { title: brandLogoText || "LetItRip.in", size: "xl" }), _jsx(SiteLogo, { title: brandLogoText || "LetItRip.in", size: "xl" })] })] }) })] }) })] }));
+    return (_jsxs(Section, { className: `relative overflow-hidden pt-[0px] pb-[var(--appkit-space-20)] md:pt-[0px] md:pb-[7rem] ${className}`, paddingX: "x-md", children: [_jsx(Div, { className: "pointer-events-none absolute -top-32 -left-32 w-[28rem] h-[28rem] bg-primary/10 blur-3xl", rounded: "full", "aria-hidden": "true" }), _jsx(Div, { className: "pointer-events-none absolute -bottom-40 -right-40 w-[36rem] h-[36rem] bg-secondary/10 dark:bg-secondary/15 blur-3xl", rounded: "full", "aria-hidden": "true" }), _jsx(Div, { className: "relative z-10 max-w-7xl mx-auto", children: _jsxs(Grid, { align: "center", gap: "2xl", className: "grid-cols-1 lg:grid-cols-2 xl:grid-cols-2 2xl:grid-cols-2", children: [_jsxs(Div, { className: "text-left", children: [pillLabel && (_jsx(Div, { children: _jsxs(Span, { layout: "inline-flex", gap: "md", size: "xs", weight: "medium", className: "border border-primary-[500]/30 bg-primary-500/10 px-[1.25rem] py-[0.375rem] tracking-[0.2em] text-primary-700 dark:text-primary-400 backdrop-blur-sm", rounded: "full", transform: "uppercase", children: [_jsx(Span, { className: "w-1.5 h-1.5 bg-primary-500 inline-block", rounded: "full", "aria-hidden": "true" }), pillLabel, _jsx(Span, { className: "w-1.5 h-1.5 bg-primary-500 inline-block", rounded: "full", "aria-hidden": "true" })] }) })), _jsx(Heading, { level: 1, variant: "none", gradient: "brand-tri", className: "mt-4 font-display leading-[1.1] tracking-tight break-words", size: "5xl", mdSize: "6xl", lgSize: "7xl", xlSize: "7xl", children: title }), subtitle && (_jsx(Text, { className: `mt-4 ${themed.textSecondary} max-w-xl leading-relaxed`, size: "xl", children: subtitle })), showCTA && (_jsxs(Row, { wrap: true, gap: "md", className: "mt-8", justify: "start", children: [ctaHref ? (_jsx(TextLink, { rounded: "xl", href: ctaHref, className: "inline-flex items-[center] justify-[center] px-[2rem] py-[0.875rem] !bg-primary hover:!bg-primary-600 text-white dark:!bg-primary dark:hover:!bg-primary-600 dark:text-white btn-glow transition-all hover:scale-[1.02]", size: "base", weight: "bold", children: ctaLabel })) : (_jsx(Button, { variant: "primary", size: "lg", onClick: onCtaClick, children: ctaLabel })), secondaryCtaHref ? (_jsx(TextLink, { rounded: "xl", href: secondaryCtaHref, className: "inline-flex items-[center] justify-[center] border-2 border-cobalt/40 dark:border-cobalt-400/40 px-[2rem] py-[0.875rem] text-cobalt-700 dark:text-cobalt-300 hover:bg-cobalt-50 dark:hover:bg-cobalt-900/20 transition-all hover:scale-[1.02]", size: "base", weight: "semibold", children: secondaryCtaLabel })) : (_jsx(Button, { variant: "outline", size: "lg", onClick: onSecondaryCtaClick, children: secondaryCtaLabel }))] })), trustChips.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mt-6", justify: "start", children: trustChips.map((chip) => (_jsxs(Span, { layout: "inline-flex", gap: "xs", size: "xs", weight: "medium", className: "border border-zinc-[200] dark:border-slate-[700] px-[0.875rem] py-[0.375rem]", rounded: "full", surface: "subtle", color: "muted", children: [chip.emoji, " ", chip.label] }, chip.key))) }))] }), _jsx(Div, { className: "hidden lg:block", children: _jsxs(Div, { className: `relative overflow-hidden aspect-[4/3] bg-[image:var(--appkit-gradient-section-mesh)]`, shadow: "2xl", border: "default", rounded: "3xl", children: [_jsx(Div, { className: "absolute inset-0 bg-[image:var(--appkit-gradient-glass)]" }), _jsxs(Stack, { centered: true, gap: "sm", className: `absolute inset-0 ${flex.center} p-[2.5rem]`, children: [_jsx(SiteMark, { title: brandLogoText || "LetItRip.in", size: "xl" }), _jsx(SiteLogo, { title: brandLogoText || "LetItRip.in", size: "xl" })] })] }) })] }) })] }));
 }

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

@@ -23,7 +23,7 @@ export declare const homepageSectionFirestoreSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     config: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>>;
 }, "strip", z.ZodTypeAny, {
-    type: "banner" | "products" | "features" | "stats" | "faq" | "categories" | "reviews" | "events" | "auctions" | "stores" | "pre-orders" | "welcome" | "trust-indicators" | "whatsapp-community" | "blog-articles" | "newsletter" | "carousel" | "brands" | "social-feed" | "custom-cards" | "google-reviews" | "featured-bundles" | "prize-draws" | "event-raffles" | "collection-cards";
+    type: "banner" | "products" | "features" | "categories" | "reviews" | "events" | "auctions" | "stores" | "brands" | "carousel" | "newsletter" | "stats" | "welcome" | "trust-indicators" | "whatsapp-community" | "faq" | "blog-articles" | "pre-orders" | "social-feed" | "custom-cards" | "google-reviews" | "featured-bundles" | "prize-draws" | "event-raffles" | "collection-cards";
     id: string;
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
@@ -35,7 +35,7 @@ export declare const homepageSectionFirestoreSchema: z.ZodObject<{
     order: number;
     config: Record<string, JsonValue>;
 }, {
-    type: "banner" | "products" | "features" | "stats" | "faq" | "categories" | "reviews" | "events" | "auctions" | "stores" | "pre-orders" | "welcome" | "trust-indicators" | "whatsapp-community" | "blog-articles" | "newsletter" | "carousel" | "brands" | "social-feed" | "custom-cards" | "google-reviews" | "featured-bundles" | "prize-draws" | "event-raffles" | "collection-cards";
+    type: "banner" | "products" | "features" | "categories" | "reviews" | "events" | "auctions" | "stores" | "brands" | "carousel" | "newsletter" | "stats" | "welcome" | "trust-indicators" | "whatsapp-community" | "faq" | "blog-articles" | "pre-orders" | "social-feed" | "custom-cards" | "google-reviews" | "featured-bundles" | "prize-draws" | "event-raffles" | "collection-cards";
     id: string;
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;