@mohasinac/appkit 4.2.0 → 4.3.0

package/dist/features/blog/repository/blog.repository.js

@@ -95,6 +95,50 @@ class BlogRepository extends BaseRepository {
             throw new DatabaseError(`Failed to find related posts: ${error instanceof Error ? error.message : "Unknown error"}`);
         }
     }
+    /**
+     * Published posts sharing at least one tag with the given list.
+     * `array-contains-any` caps at 10 values, so only the first 10 tags are used.
+     */
+    async findByTagsOverlap(tags, excludeId, limit = 3) {
+        if (tags.length === 0)
+            return [];
+        try {
+            const snapshot = await this.db
+                .collection(this.collection)
+                .where(BLOG_POST_FIELDS.STATUS, "==", "published")
+                .where(BLOG_POST_FIELDS.TAGS, "array-contains-any", tags.slice(0, 10))
+                .limit(limit + 1)
+                .get();
+            return snapshot.docs
+                .map((doc) => this.mapDoc(doc))
+                .filter((post) => post.id !== excludeId)
+                .slice(0, limit);
+        }
+        catch (error) {
+            void normalizeError(error);
+            throw new DatabaseError(`Failed to find posts by tag overlap: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /** Other published posts by the same author. */
+    async findByAuthor(authorId, excludeId, limit = 3) {
+        try {
+            const snapshot = await this.db
+                .collection(this.collection)
+                .where(BLOG_POST_FIELDS.STATUS, "==", "published")
+                .where(BLOG_POST_FIELDS.AUTHOR_ID, "==", authorId)
+                .orderBy(BLOG_POST_FIELDS.PUBLISHED_AT, "desc")
+                .limit(limit + 1)
+                .get();
+            return snapshot.docs
+                .map((doc) => this.mapDoc(doc))
+                .filter((post) => post.id !== excludeId)
+                .slice(0, limit);
+        }
+        catch (error) {
+            void normalizeError(error);
+            throw new DatabaseError(`Failed to find posts by author: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
     async listPublished(opts, model) {
         let baseQuery = this.getCollection().where(BLOG_POST_FIELDS.STATUS, "==", "published");
         if (opts?.category) {

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

@@ -22,6 +22,8 @@ export interface BlogPostDocument extends BaseDocument {
     coverImage?: MediaFieldInput;
     contentImages?: MediaField[];
     additionalImages?: MediaField[];
+    /** YouTube video ID (11 chars, e.g. "dQw4w9WgXcQ") embedded above the article content. */
+    youtubeId?: string;
     category: BlogPostCategory;
     tags: string[];
     isFeatured: boolean;
@@ -46,6 +48,7 @@ export declare const BLOG_POST_FIELDS: {
     readonly COVER_IMAGE: "coverImage";
     readonly CONTENT_IMAGES: "contentImages";
     readonly ADDITIONAL_IMAGES: "additionalImages";
+    readonly YOUTUBE_ID: "youtubeId";
     readonly CATEGORY: "category";
     readonly TAGS: "tags";
     readonly IS_FEATURED: "isFeatured";

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

@@ -25,6 +25,7 @@ export const BLOG_POST_FIELDS = {
     COVER_IMAGE: "coverImage",
     CONTENT_IMAGES: "contentImages",
     ADDITIONAL_IMAGES: "additionalImages",
+    YOUTUBE_ID: "youtubeId",
     CATEGORY: "category",
     TAGS: "tags",
     IS_FEATURED: "isFeatured",

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

@@ -10,6 +10,8 @@ export interface BlogPost {
     coverImage?: MediaFieldInput;
     contentImages?: MediaField[];
     additionalImages?: MediaField[];
+    /** YouTube video ID (11 chars, e.g. "dQw4w9WgXcQ") embedded above the article content. */
+    youtubeId?: string;
     category: BlogPostCategory;
     tags?: string[];
     isFeatured?: boolean;

package/dist/features/cart/components/index.d.ts

@@ -7,8 +7,6 @@ export { CheckoutView } from "./CheckoutView";
 export type { CheckoutViewProps } from "./CheckoutView";
 export { CheckoutAddressStep } from "./CheckoutAddressStep";
 export type { CheckoutAddressStepProps, CheckoutAddressStepLabels, } from "./CheckoutAddressStep";
-export { CheckoutOtpModal } from "./CheckoutOtpModal";
-export type { CheckoutOtpModalProps } from "./CheckoutOtpModal";
 export { CheckoutSuccessView } from "./CheckoutSuccessView";
 export type { CheckoutSuccessViewProps } from "./CheckoutSuccessView";
 export { ShippingPicker } from "./ShippingPicker";

package/dist/features/cart/components/index.js

@@ -3,6 +3,5 @@ export { CartView } from "./CartView";
 export { CartSummary } from "./CartSummary";
 export { CheckoutView } from "./CheckoutView";
 export { CheckoutAddressStep } from "./CheckoutAddressStep";
-export { CheckoutOtpModal } from "./CheckoutOtpModal";
 export { CheckoutSuccessView } from "./CheckoutSuccessView";
 export { ShippingPicker } from "./ShippingPicker";

package/dist/features/cart/hooks/useCartCount.js

@@ -1,7 +1,10 @@
+"use client";
+import { useEffect, useState } from "react";
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { useGuestCart } from "./useGuestCart";
 import { CART_ENDPOINTS } from "../../../constants/api-endpoints";
+import { CART_OPS_CHANGE_EVENT, getCartOpsDelta } from "../utils/pending-ops";
 /**
  * useCartCount
  *
@@ -16,11 +19,25 @@ export function useCartCount(enabled = false) {
         queryFn: () => apiClient.get(CART_ENDPOINTS.GET),
         enabled,
     });
-    // When authenticated, the server is authoritative — never mix in the guest
-    // count, otherwise stale localStorage entries leak into the badge after
-    // login (the cart-merge clears the local store but `useGuestCart`'s React
-    // state holds the pre-clear snapshot until remount).
+    // "Add to cart" quick actions (listing grid, product cards) write local-
+    // first — see useSyncManager — and queue an unsynced op that only reaches
+    // the server on the next ~30s background sync. Layer that pending delta on
+    // top of the server count so the badge updates the instant the op is
+    // queued instead of lagging up to 30s behind the toast.
+    const [pendingDelta, setPendingDelta] = useState(0);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const recompute = () => setPendingDelta(getCartOpsDelta());
+        recompute();
+        window.addEventListener(CART_OPS_CHANGE_EVENT, recompute);
+        return () => window.removeEventListener(CART_OPS_CHANGE_EVENT, recompute);
+    }, [enabled]);
+    // When authenticated, the server + pending-ops delta is authoritative —
+    // never mix in the guest count, otherwise stale localStorage entries leak
+    // into the badge after login (the cart-merge clears the local store but
+    // `useGuestCart`'s React state holds the pre-clear snapshot until remount).
     if (enabled)
-        return data?.itemCount ?? 0;
+        return (data?.itemCount ?? 0) + pendingDelta;
     return guestCount;
 }

package/dist/features/cart/hooks/useGuestCart.js

@@ -1,6 +1,6 @@
 "use client";
 import { useState, useEffect, useCallback } from "react";
-import { getGuestCartItems, addToGuestCart, clearGuestCart, removeFromGuestCart, updateGuestCartQuantity, } from "../utils/guest-cart";
+import { getGuestCartItems, addToGuestCart, clearGuestCart, removeFromGuestCart, updateGuestCartQuantity, GUEST_CART_CHANGE_EVENT, } from "../utils/guest-cart";
 /**
  * useGuestCart
  *
@@ -10,6 +10,16 @@ export function useGuestCart() {
     const [items, setItems] = useState([]);
     useEffect(() => {
         setItems(getGuestCartItems());
+        // Cross-instance sync within the same tab (e.g. a listing-page "Add to
+        // cart" quick action writing storage while the header badge's own
+        // useGuestCart() instance is mounted elsewhere) + cross-tab via "storage".
+        const onChange = () => setItems(getGuestCartItems());
+        window.addEventListener(GUEST_CART_CHANGE_EVENT, onChange);
+        window.addEventListener("storage", onChange);
+        return () => {
+            window.removeEventListener(GUEST_CART_CHANGE_EVENT, onChange);
+            window.removeEventListener("storage", onChange);
+        };
     }, []);
     const add = useCallback((productId, quantity, snapshot) => {
         const updated = addToGuestCart(productId, quantity, snapshot);

package/dist/features/cart/utils/guest-cart.d.ts

@@ -1,3 +1,7 @@
+/** Fired whenever guest cart storage is written, so every `useGuestCart()`
+ *  instance in the tab (header badge, listing quick-add, cart page) can
+ *  re-read storage and stay in sync without waiting for a remount. */
+export declare const GUEST_CART_CHANGE_EVENT = "appkit/cart/guest-changed";
 export declare class CartFullError extends Error {
     readonly code: "CART_FULL";
     readonly limit = 50;

package/dist/features/cart/utils/guest-cart.js

@@ -6,6 +6,15 @@ const DEFAULT_GUEST_CART_KEY = process.env.NEXT_PUBLIC_APP_ID
 const DEFAULT_GUEST_RETURN_TO_KEY = process.env.NEXT_PUBLIC_APP_ID
     ? `${process.env.NEXT_PUBLIC_APP_ID}_guest_return_to`
     : "guest_return_to";
+/** Fired whenever guest cart storage is written, so every `useGuestCart()`
+ *  instance in the tab (header badge, listing quick-add, cart page) can
+ *  re-read storage and stay in sync without waiting for a remount. */
+export const GUEST_CART_CHANGE_EVENT = "appkit/cart/guest-changed";
+function dispatchGuestCartChange() {
+    if (typeof window === "undefined")
+        return;
+    window.dispatchEvent(new Event(GUEST_CART_CHANGE_EVENT));
+}
 export class CartFullError extends Error {
     constructor(current) {
         super(`Cart full (${current}/${CART_MAX_ITEMS})`);
@@ -39,6 +48,7 @@ function writeItems(storage, key, items) {
     if (!storage)
         return;
     storage.setItem(key, JSON.stringify(items));
+    dispatchGuestCartChange();
 }
 export function getGuestCartItems(storage = getDefaultStorage(), key = DEFAULT_GUEST_CART_KEY) {
     return readItems(storage, key);

package/dist/features/cart/utils/pending-ops.d.ts

@@ -5,6 +5,12 @@
  * Written to localStorage so they survive page refreshes.
  * The sync manager replays these and clears them after a successful push.
  */
+/** Fired whenever the pending cart/wishlist op queue changes, so a badge
+ *  reading server-authoritative counts (authenticated users) can layer the
+ *  not-yet-synced local delta on top instead of waiting for the next
+ *  useSyncManager interval (up to 30s) to reflect a just-added item. */
+export declare const CART_OPS_CHANGE_EVENT = "appkit/cart/ops-changed";
+export declare const WISHLIST_OPS_CHANGE_EVENT = "appkit/wishlist/ops-changed";
 export type CartOpKind = "add" | "remove";
 export type WishlistOpKind = "add" | "remove";
 export interface CartOp {
@@ -34,6 +40,17 @@ export interface WishlistOp {
 export declare function getCartOps(): CartOp[];
 export declare function pushCartOp(op: Omit<CartOp, "ts">): void;
 export declare function clearCartOps(): void;
+/** Net quantity of unsynced "add" ops — layered on top of the server's
+ *  authoritative itemCount so the header badge updates immediately instead
+ *  of waiting for the next useSyncManager interval. Cart never queues
+ *  "remove" ops (removal from an authenticated cart is always a synchronous
+ *  API call), so summing "add" quantities is exact, not an approximation. */
+export declare function getCartOpsDelta(): number;
 export declare function getWishlistOps(): WishlistOp[];
 export declare function pushWishlistOp(op: Omit<WishlistOp, "ts">): void;
+/** Net count of unsynced wishlist ops — add/remove pairs for the same item
+ *  are already collapsed by `pushWishlistOp`, so this is exact: +1 per
+ *  queued "add", -1 per queued "remove" (an item already on the server
+ *  being removed before the next sync). */
+export declare function getWishlistOpsDelta(): number;
 export declare function clearWishlistOps(): void;

package/dist/features/cart/utils/pending-ops.js

@@ -11,6 +11,22 @@ const APP_ID = () => typeof process !== "undefined" && process.env.NEXT_PUBLIC_A
     : "letitrip";
 const CART_OPS_KEY = () => `${APP_ID()}_cart_ops`;
 const WL_OPS_KEY = () => `${APP_ID()}_wl_ops`;
+/** Fired whenever the pending cart/wishlist op queue changes, so a badge
+ *  reading server-authoritative counts (authenticated users) can layer the
+ *  not-yet-synced local delta on top instead of waiting for the next
+ *  useSyncManager interval (up to 30s) to reflect a just-added item. */
+export const CART_OPS_CHANGE_EVENT = "appkit/cart/ops-changed";
+export const WISHLIST_OPS_CHANGE_EVENT = "appkit/wishlist/ops-changed";
+function dispatchCartOpsChange() {
+    if (typeof window === "undefined")
+        return;
+    window.dispatchEvent(new Event(CART_OPS_CHANGE_EVENT));
+}
+function dispatchWishlistOpsChange() {
+    if (typeof window === "undefined")
+        return;
+    window.dispatchEvent(new Event(WISHLIST_OPS_CHANGE_EVENT));
+}
 // ---------------------------------------------------------------------------
 // Storage helpers
 // ---------------------------------------------------------------------------
@@ -40,6 +56,14 @@ function write(key, items) {
         // storage quota exceeded — best effort
     }
 }
+function writeCartOps(items) {
+    write(CART_OPS_KEY(), items);
+    dispatchCartOpsChange();
+}
+function writeWishlistOps(items) {
+    write(WL_OPS_KEY(), items);
+    dispatchWishlistOpsChange();
+}
 // ---------------------------------------------------------------------------
 // Cart ops
 // ---------------------------------------------------------------------------
@@ -53,7 +77,7 @@ export function pushCartOp(op) {
         const withoutProduct = ops.filter((o) => o.productId !== op.productId);
         if (withoutProduct.length < ops.length) {
             // There was a pending add — cancelling
-            write(CART_OPS_KEY(), withoutProduct);
+            writeCartOps(withoutProduct);
             return;
         }
     }
@@ -64,16 +88,25 @@ export function pushCartOp(op) {
             const merged = ops.map((o) => o.op === "add" && o.productId === op.productId
                 ? { ...o, quantity: Math.min((o.quantity ?? 1) + (op.quantity ?? 1), 99) }
                 : o);
-            write(CART_OPS_KEY(), merged);
+            writeCartOps(merged);
             return;
         }
     }
-    write(CART_OPS_KEY(), [...ops, { ...op, ts: Date.now() }]);
+    writeCartOps([...ops, { ...op, ts: Date.now() }]);
 }
 export function clearCartOps() {
     if (typeof window === "undefined")
         return;
     localStorage.removeItem(CART_OPS_KEY());
+    dispatchCartOpsChange();
+}
+/** Net quantity of unsynced "add" ops — layered on top of the server's
+ *  authoritative itemCount so the header badge updates immediately instead
+ *  of waiting for the next useSyncManager interval. Cart never queues
+ *  "remove" ops (removal from an authenticated cart is always a synchronous
+ *  API call), so summing "add" quantities is exact, not an approximation. */
+export function getCartOpsDelta() {
+    return getCartOps().reduce((sum, op) => (op.op === "add" ? sum + (op.quantity ?? 1) : sum), 0);
 }
 // ---------------------------------------------------------------------------
 // Wishlist ops
@@ -88,7 +121,7 @@ export function pushWishlistOp(op) {
     if (op.op === "remove") {
         const withoutItem = ops.filter((o) => key(o) !== key(op));
         if (withoutItem.length < ops.length) {
-            write(WL_OPS_KEY(), withoutItem);
+            writeWishlistOps(withoutItem);
             return;
         }
     }
@@ -96,10 +129,18 @@ export function pushWishlistOp(op) {
     if (op.op === "add" && ops.some((o) => o.op === "add" && key(o) === key(op))) {
         return;
     }
-    write(WL_OPS_KEY(), [...ops, { ...op, ts: Date.now() }]);
+    writeWishlistOps([...ops, { ...op, ts: Date.now() }]);
+}
+/** Net count of unsynced wishlist ops — add/remove pairs for the same item
+ *  are already collapsed by `pushWishlistOp`, so this is exact: +1 per
+ *  queued "add", -1 per queued "remove" (an item already on the server
+ *  being removed before the next sync). */
+export function getWishlistOpsDelta() {
+    return getWishlistOps().reduce((sum, op) => sum + (op.op === "add" ? 1 : -1), 0);
 }
 export function clearWishlistOps() {
     if (typeof window === "undefined")
         return;
     localStorage.removeItem(WL_OPS_KEY());
+    dispatchWishlistOpsChange();
 }

package/dist/features/categories/components/BrandDetailPageView.js

@@ -8,6 +8,7 @@ import { Container, Div, Heading, Main, Nav, Section, Span, Text } from "../../.
 import { DynamicBgDiv } from "../../../ui/components/DynamicBgDiv";
 import { MediaImage } from "../../media/MediaImage";
 import { BrandDetailTabs } from "./BrandDetailTabs";
+import { CategoryGrid } from "./CategoryGrid";
 const __O = {
     hidden: "overflow-hidden",
 };
@@ -16,7 +17,7 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
         .getCategoryBySlug(slug)
         .catch(() => undefined)));
     const brandName = brand?.name;
-    const [productsResult, auctionsResult, preOrdersResult, prizeDrawsResult, allBundles] = await Promise.all([
+    const [productsResult, auctionsResult, preOrdersResult, prizeDrawsResult, allBundles, activeBrands] = await Promise.all([
         brandName
             ? productRepository
                 .list({
@@ -65,6 +66,8 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
                 .listByType("bundle", { activeOnly: true, limit: 50 })
                 .catch(() => [])
             : Promise.resolve([]),
+        // Related brands — every other active brand row, excluding this one.
+        categoriesRepository.findActiveBrands().catch(() => []),
     ]);
     const brandLower = brandName?.toLowerCase();
     const brandBundles = brandLower
@@ -73,6 +76,7 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
             return seo.includes(brandLower);
         })
         : [];
+    const relatedBrands = activeBrands.filter((b) => b.id !== brand?.id);
     const coverImage = brand?.display?.coverImage;
     const hasCover = Boolean(coverImage);
     // Brand accent — falls back to the primary theme token when the brand hasn't
@@ -91,5 +95,5 @@ export async function BrandDetailPageView({ slug, initialBrand }) {
         counts.preOrders +
         counts.prizeDraws +
         counts.bundles;
-    return (_jsxs(Main, { children: [_jsxs(Section, { className: `relative ${__O.hidden} ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-[var(--appkit-color-bg)]"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: coverImage, alt: "", size: "banner" }) }), _jsx(Div, { surface: "overlay-md", className: "absolute inset-0" })] })), !hasCover && (_jsx(DynamicBgDiv, { color: brandColor, className: "absolute inset-0 opacity-10" })), _jsxs(Div, { className: "relative z-10 max-w-7xl mx-auto", paddingY: hasCover ? "y-3xl" : "y-xl", padding: "x-md", children: [_jsxs(Nav, { layout: "flex", gap: "2xs", textSize: "sm", className: "mb-4", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-[var(--appkit-color-text-muted)] hover:text-primary-600 transition-colors", children: "Home" }), _jsx(Span, { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.BRANDS), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-[var(--appkit-color-text-muted)] hover:text-primary-600 transition-colors", children: "Brands" }), _jsx(Span, { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Span, { weight: "medium", className: hasCover ? "text-white" : "text-[var(--appkit-color-text)]", children: brand?.name ?? slug })] }), _jsxs(Row, { className: "mb-3", align: "center", gap: "md", children: [brand?.display?.icon && (_jsx(Span, { className: "leading-none", size: "5xl", children: brand.display.icon })), _jsxs(_Fragment, { children: [_jsx(Heading, { color: "inverse", level: 1, className: `${hasCover ? "" : "text-[var(--appkit-color-text)]"}`, size: "3xl", mdSize: "4xl", weight: "bold", children: brand?.name ?? slug }), brand?.description && typeof brand.description === "string" && !brand.description.startsWith("{") && (_jsx(Text, { color: hasCover ? "inverse" : "muted", className: `max-w-2xl mt-1 ${hasCover ? "/80" : ""}`, size: "base", children: brand.description }))] })] }), _jsxs(Row, { gap: "sm", wrap: true, className: "mt-3", children: [counts.products > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: "inverse", size: "xs", weight: "medium", className: `${hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "bg-primary/10 text-primary-700 dark:text-primary-400"}`, rounded: "full", padding: "pill-sm-tall", children: [counts.products.toLocaleString(), " ", counts.products === 1 ? "product" : "products"] })), counts.auctions > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: hasCover ? "inverse" : "warning", surface: hasCover ? undefined : "warning-surface", size: "xs", weight: "medium", className: hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "", rounded: "full", padding: "pill-sm-tall", children: [counts.auctions.toLocaleString(), " ", counts.auctions === 1 ? "auction" : "auctions"] })), counts.preOrders > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: hasCover ? "inverse" : "info", surface: hasCover ? undefined : "info-surface", size: "xs", weight: "medium", className: hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "", rounded: "full", padding: "pill-sm-tall", children: [counts.preOrders.toLocaleString(), " ", counts.preOrders === 1 ? "pre-order" : "pre-orders"] })), totalItems === 0 && (_jsx(Span, { size: "sm", className: hasCover ? "text-white/60" : "text-zinc-400", children: "No items listed yet" }))] })] })] }), _jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "xl", children: brandName ? (_jsx(BrandDetailTabs, { brandName: brandName, initialProductsData: productsResult ?? undefined, initialBundles: brandBundles, counts: counts })) : (_jsx(Text, { paddingY: "3xl", color: "muted", size: "sm", align: "start", children: "Brand not found." })) }) })] }));
+    return (_jsxs(Main, { children: [_jsxs(Section, { className: `relative ${__O.hidden} ${hasCover ? "min-h-[220px] md:min-h-[280px]" : "bg-[var(--appkit-color-bg)]"}`, children: [hasCover && (_jsxs(_Fragment, { children: [_jsx(Div, { className: "absolute inset-0", children: _jsx(MediaImage, { src: coverImage, alt: "", size: "banner" }) }), _jsx(Div, { surface: "overlay-md", className: "absolute inset-0" })] })), !hasCover && (_jsx(DynamicBgDiv, { color: brandColor, className: "absolute inset-0 opacity-10" })), _jsxs(Div, { className: "relative z-10 max-w-7xl mx-auto", paddingY: hasCover ? "y-3xl" : "y-xl", padding: "x-md", children: [_jsxs(Nav, { layout: "flex", gap: "2xs", textSize: "sm", className: "mb-4", "aria-label": "Breadcrumb", children: [_jsx(Link, { href: String(ROUTES.HOME), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-[var(--appkit-color-text-muted)] hover:text-primary-600 transition-colors", children: "Home" }), _jsx(Span, { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.BRANDS), className: hasCover ? "text-white/70 hover:text-white transition-colors" : "text-[var(--appkit-color-text-muted)] hover:text-primary-600 transition-colors", children: "Brands" }), _jsx(Span, { className: hasCover ? "text-white/40" : "text-zinc-400", children: "/" }), _jsx(Span, { weight: "medium", className: hasCover ? "text-white" : "text-[var(--appkit-color-text)]", children: brand?.name ?? slug })] }), _jsxs(Row, { className: "mb-3", align: "center", gap: "md", children: [brand?.display?.icon && (_jsx(Span, { className: "leading-none", size: "5xl", children: brand.display.icon })), _jsxs(_Fragment, { children: [_jsx(Heading, { color: "inverse", level: 1, className: `${hasCover ? "" : "text-[var(--appkit-color-text)]"}`, size: "3xl", mdSize: "4xl", weight: "bold", children: brand?.name ?? slug }), brand?.description && typeof brand.description === "string" && !brand.description.startsWith("{") && (_jsx(Text, { color: hasCover ? "inverse" : "muted", className: `max-w-2xl mt-1 ${hasCover ? "/80" : ""}`, size: "base", children: brand.description }))] })] }), _jsxs(Row, { gap: "sm", wrap: true, className: "mt-3", children: [counts.products > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: "inverse", size: "xs", weight: "medium", className: `${hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "bg-primary/10 text-primary-700 dark:text-primary-400"}`, rounded: "full", padding: "pill-sm-tall", children: [counts.products.toLocaleString(), " ", counts.products === 1 ? "product" : "products"] })), counts.auctions > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: hasCover ? "inverse" : "warning", surface: hasCover ? undefined : "warning-surface", size: "xs", weight: "medium", className: hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "", rounded: "full", padding: "pill-sm-tall", children: [counts.auctions.toLocaleString(), " ", counts.auctions === 1 ? "auction" : "auctions"] })), counts.preOrders > 0 && (_jsxs(Span, { layout: "inline-flex", gap: "xs", color: hasCover ? "inverse" : "info", surface: hasCover ? undefined : "info-surface", size: "xs", weight: "medium", className: hasCover ? "bg-[rgba(255,255,255,0.2)] backdrop-blur-sm" : "", rounded: "full", padding: "pill-sm-tall", children: [counts.preOrders.toLocaleString(), " ", counts.preOrders === 1 ? "pre-order" : "pre-orders"] })), totalItems === 0 && (_jsx(Span, { size: "sm", className: hasCover ? "text-white/60" : "text-zinc-400", children: "No items listed yet" }))] })] })] }), _jsx(Section, { padding: "y-lg", children: _jsx(Container, { size: "xl", children: brandName ? (_jsx(BrandDetailTabs, { brandName: brandName, initialProductsData: productsResult ?? undefined, initialBundles: brandBundles, counts: counts })) : (_jsx(Text, { paddingY: "3xl", color: "muted", size: "sm", align: "start", children: "Brand not found." })) }) }), relatedBrands.length > 0 && (_jsx(Section, { border: "subtle", surface: "default", className: "border-t", padding: "y-lg", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 2, className: "mb-4", size: "xl", weight: "semibold", children: "Related Brands" }), _jsx(CategoryGrid, { categories: relatedBrands, getHref: (b) => String(ROUTES.PUBLIC.BRAND_DETAIL(b.slug)) })] }) }))] }));
 }

package/dist/features/categories/components/BundleDetailView.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { Badge, Container, Div, Heading, Li, Main, Row, Section, Span, Stack, Text, Ul, } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
 import Link from "next/link";
@@ -7,6 +7,7 @@ import { BundleBuyNowCta } from "./BundleBuyNowCta";
 import { BundleCollage } from "./BundleCollage";
 import { MediaImage } from "../../media/MediaImage";
 import { ROUTES } from "../../../next/routing/route-map";
+import { computeBundleDiscount } from "../../../_internal/shared/features/categories/bundle-pricing";
 const __O = {
     hidden: "overflow-hidden",
 };
@@ -22,5 +23,6 @@ export function BundleDetailView({ bundle, members = [], onBuyNow, }) {
     const priceLabel = bundle.bundlePrice
         ? formatCurrency(bundle.bundlePrice, "INR")
         : BUNDLE_COPY.detail.priceFallback;
-    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsx(Container, { size: "xl", children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Stack, { gap: "lg", direction: "md-row", align: "start", children: [_jsx(Div, { className: "w-full md:w-2/5", children: members.length > 0 ? (_jsx(BundleCollage, { members: members })) : (_jsx(Div, { className: `aspect-video w-full ${__O.hidden}`, rounded: "2xl", surface: "subtle", children: _jsx(Div, { className: "h-full w-full", children: _jsx(MediaImage, { src: cover, alt: bundle.name, size: "hero", fallback: PLACEHOLDER_EMOJI }) }) })) }), _jsxs(Stack, { gap: "md", className: "flex-1", children: [_jsx(Heading, { level: 1, size: "3xl", weight: "semibold", color: "primary", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", children: [_jsx(Text, { size: "lg", weight: "bold", children: priceLabel }), _jsxs(Text, { size: "sm", color: "muted", children: ["\u00B7 ", BUNDLE_COPY.detail.itemCount(memberCount)] }), _jsx(Badge, { variant: BUNDLE_STOCK_VARIANT[stock], children: STOCK_BADGE_TEXT[stock] })] }), bundle.description && (_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text-muted)]", size: "sm", weight: "semibold", children: BUNDLE_COPY.detailDescriptionHeading }), _jsx(Text, { className: "whitespace-pre-line", children: bundle.description })] })), onBuyNow ? (_jsx(BundleBuyNowCta, { bundleSlug: bundle.slug, outOfStock: stock === "out_of_stock", onBuyNow: onBuyNow })) : (_jsxs(Div, { textSize: "sm", className: "border-dashed", border: "strong", surface: "muted", rounded: "xl", padding: "md", "aria-live": "polite", children: [_jsx(Text, { weight: "semibold", className: "mb-1 block", children: BUNDLE_COPY.detail.ctaDisabled }), _jsx(Text, { size: "sm", color: "muted", children: BUNDLE_COPY.detail.ctaHint })] }))] })] }), _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 2, size: "xl", weight: "semibold", color: "primary", children: BUNDLE_COPY.detailItemsHeading }), members.length === 0 ? (_jsx(Text, { color: "muted", children: BUNDLE_COPY.detail.emptyMembers })) : (_jsx(Ul, { gap: "2", className: "grid grid-cols-1 sm:grid-cols-2", children: members.map((p, i) => (_jsxs(Li, { layout: "flex-center", gap: "2", rounded: "lg", border: "subtle", padding: "inlineSm", textSize: "sm", children: [_jsxs(Span, { size: "xs", weight: "semibold", className: "w-5", color: "faint", children: ["#", i + 1] }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRODUCT_DETAIL?.(p.slug ?? p.id) ?? "#"), className: "flex-1 truncate font-medium hover:underline hover:text-primary", children: p.title })] }, p.id))) }))] })] }) }) }) }));
+    const discount = computeBundleDiscount(bundle.bundlePrice, bundle.bundleOriginalTotal);
+    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsx(Container, { size: "xl", children: _jsxs(Stack, { gap: "lg", children: [_jsxs(Stack, { gap: "lg", direction: "md-row", align: "start", children: [_jsx(Div, { className: "w-full md:w-2/5", children: members.length > 0 ? (_jsx(BundleCollage, { members: members })) : (_jsx(Div, { className: `aspect-video w-full ${__O.hidden}`, rounded: "2xl", surface: "subtle", children: _jsx(Div, { className: "h-full w-full", children: _jsx(MediaImage, { src: cover, alt: bundle.name, size: "hero", fallback: PLACEHOLDER_EMOJI }) }) })) }), _jsxs(Stack, { gap: "md", className: "flex-1", children: [_jsx(Heading, { level: 1, size: "3xl", weight: "semibold", color: "primary", children: bundle.name }), _jsxs(Row, { gap: "sm", align: "center", wrap: true, children: [_jsx(Text, { size: "lg", weight: "bold", children: priceLabel }), discount && (_jsxs(_Fragment, { children: [_jsx(Text, { size: "sm", color: "muted", className: "line-through", children: formatCurrency(discount.originalTotal, "INR") }), _jsx(Badge, { variant: "success", children: BUNDLE_COPY.detail.discountBadge(discount.percent) })] })), _jsxs(Text, { size: "sm", color: "muted", children: ["\u00B7 ", BUNDLE_COPY.detail.itemCount(memberCount)] }), _jsx(Badge, { variant: BUNDLE_STOCK_VARIANT[stock], children: STOCK_BADGE_TEXT[stock] })] }), discount && (_jsx(Text, { size: "sm", color: "success", weight: "medium", children: BUNDLE_COPY.detail.savingsLabel(formatCurrency(discount.savings, "INR")) })), bundle.description && (_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text-muted)]", size: "sm", weight: "semibold", children: BUNDLE_COPY.detailDescriptionHeading }), _jsx(Text, { className: "whitespace-pre-line", children: bundle.description })] })), onBuyNow ? (_jsx(BundleBuyNowCta, { bundleSlug: bundle.slug, outOfStock: stock === "out_of_stock", onBuyNow: onBuyNow })) : (_jsxs(Div, { textSize: "sm", className: "border-dashed", border: "strong", surface: "muted", rounded: "xl", padding: "md", "aria-live": "polite", children: [_jsx(Text, { weight: "semibold", className: "mb-1 block", children: BUNDLE_COPY.detail.ctaDisabled }), _jsx(Text, { size: "sm", color: "muted", children: BUNDLE_COPY.detail.ctaHint })] }))] })] }), _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 2, size: "xl", weight: "semibold", color: "primary", children: BUNDLE_COPY.detailItemsHeading }), members.length === 0 ? (_jsx(Text, { color: "muted", children: BUNDLE_COPY.detail.emptyMembers })) : (_jsx(Ul, { gap: "2", className: "grid grid-cols-1 sm:grid-cols-2", children: members.map((p, i) => (_jsxs(Li, { layout: "flex-center", gap: "2", rounded: "lg", border: "subtle", padding: "inlineSm", textSize: "sm", children: [_jsxs(Span, { size: "xs", weight: "semibold", className: "w-5", color: "faint", children: ["#", i + 1] }), _jsx(Link, { href: String(ROUTES.PUBLIC.PRODUCT_DETAIL?.(p.slug ?? p.id) ?? "#"), className: "flex-1 truncate font-medium hover:underline hover:text-primary", children: p.title }), _jsx(Span, { size: "xs", color: "muted", children: formatCurrency(p.price ?? 0, p.currency ?? "INR") })] }, p.id))) }))] })] }) }) }) }));
 }

package/dist/features/categories/components/CategoryDetailPageView.js

@@ -7,6 +7,7 @@ import { ROUTES } from "../../../next";
 import { Container, Div, Heading, Main, Nav, Section, Span, Text } from "../../../ui";
 import { MediaImage } from "../../media/MediaImage";
 import { CategoryDetailTabs } from "./CategoryDetailTabs";
+import { CategoryGrid } from "./CategoryGrid";
 const __O = {
     hidden: "overflow-hidden",
     xAuto: "overflow-x-auto",
@@ -18,7 +19,7 @@ export async function CategoryDetailPageView({ slug }) {
     // Use categorySlugs@=<id> (array-contains) — products store category FK in
     // the categorySlugs[] array, not the legacy `category` string field.
     const catFilter = category?.id ? sieveFilter("categorySlugs", SIEVE_OP.CONTAINS, category.id) : null;
-    const [productsResult, auctionsCountResult, preOrdersCountResult, prizeDrawsCountResult, bundlesResult, childCategories] = await Promise.all([
+    const [productsResult, auctionsCountResult, preOrdersCountResult, prizeDrawsCountResult, bundlesResult, childCategories, rootSiblingCategories] = await Promise.all([
         catFilter
             ? productRepository
                 .list({
@@ -69,7 +70,14 @@ export async function CategoryDetailPageView({ slug }) {
         category?.id
             ? categoriesRepository.getChildren(category.id).catch(() => [])
             : Promise.resolve([]),
+        // Related categories — every other category sharing this category's root
+        // (siblings + cousins across the tree, up to the tier-0/1/2 depth the
+        // catalog actually uses), not just direct children.
+        category?.rootId
+            ? categoriesRepository.getCategoriesByRootId(category.rootId).catch(() => [])
+            : Promise.resolve([]),
     ]);
+    const relatedCategories = rootSiblingCategories.filter((c) => c.id !== category?.id && (!c.categoryType || c.categoryType === "category"));
     // Stores tab — query stores whose storeCategory matches this category or any child
     const storeCategorySlugs = [
         slug,
@@ -121,5 +129,5 @@ export async function CategoryDetailPageView({ slug }) {
                             prizeDraws: prizeDrawCount,
                             bundles: bundleCount,
                             stores: storeCount,
-                        } }) }) })] }));
+                        } }) }) }), relatedCategories.length > 0 && (_jsx(Section, { border: "subtle", surface: "default", className: "border-t", padding: "y-lg", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 2, className: "mb-4", size: "xl", weight: "semibold", children: "Related Categories" }), _jsx(CategoryGrid, { categories: relatedCategories, getHref: (c) => String(ROUTES.PUBLIC.CATEGORY_DETAIL(c.slug)) })] }) }))] }));
 }

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

@@ -145,6 +145,13 @@ export interface CategoryDocument extends BaseDocument {
     bundleQueryResolvedAt?: Date;
     /** Hand-picked products list (mirror of bundleQueryRule for static rules); kept for index-friendly queries. */
     bundleProductIds?: string[];
+    /**
+     * Sum of member products' individual prices (decimal rupees) — the "buy
+     * separately" total the discount badge is measured against. Denormalised
+     * at bundle create/update time and refreshed by the daily bundle stock
+     * sync job; undefined when a member price couldn't be resolved.
+     */
+    bundleOriginalTotal?: number;
     /**
      * Per-member metadata parallel to `bundleProductIds`.
      * Carries `drawCount` for prize-draw members (how many raffle entries

package/dist/features/checkout/actions/index.d.ts

@@ -1,2 +1 @@
-export * from "./checkout-actions";
 export * from "./checkout-value-otp-actions";

package/dist/features/checkout/actions/index.js

@@ -1,2 +1 @@
-export * from "./checkout-actions";
 export * from "./checkout-value-otp-actions";

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

@@ -2,8 +2,8 @@
  * Checkout Feature Firestore Document Types & Constants
  * Covers: failed checkouts, failed payments
  */
-export type FailedCheckoutReason = "otp_not_verified" | "consent_expired" | "stock_failed" | "address_not_found" | "cart_empty" | "validation_error" | "unknown";
-export type FailedPaymentReason = "signature_mismatch" | "payment_cancelled" | "amount_mismatch" | "otp_not_verified" | "consent_expired" | "product_unavailable" | "stock_insufficient" | "unknown";
+export type FailedCheckoutReason = "stock_failed" | "address_not_found" | "cart_empty" | "validation_error" | "unknown";
+export type FailedPaymentReason = "signature_mismatch" | "payment_cancelled" | "amount_mismatch" | "product_unavailable" | "stock_insufficient" | "unknown";
 export type FailedCheckoutDocument = {
     id: string;
     uid: string;

package/dist/features/events/actions/event-actions.d.ts

@@ -66,6 +66,8 @@ export declare function listPublicEvents(params?: string | {
 }): Promise<FirebaseSieveResult<EventDocument>>;
 export declare function getPublicEventById(id: string): Promise<EventDocument | null>;
 export declare function getEventLeaderboard(eventId: string): Promise<import("../types").LeaderboardEntry[]>;
+/** Related events — other active events sharing at least one tag, excluding this one. */
+export declare function getRelatedEvents(tags: string[], excludeId: string, limit?: number): Promise<EventDocument[]>;
 export declare function adminListEvents(params?: {
     filters?: string;
     sorts?: string;

package/dist/features/events/actions/event-actions.js

@@ -148,6 +148,11 @@ export async function getEventLeaderboard(eventId) {
         return [];
     return eventEntryRepository.getLeaderboard(event.id);
 }
+/** Related events — other active events sharing at least one tag, excluding this one. */
+export async function getRelatedEvents(tags, excludeId, limit = 6) {
+    const docs = await eventRepository.findByTagsOverlap(tags, limit + 1);
+    return docs.filter((e) => e.id !== excludeId).slice(0, limit);
+}
 export async function adminListEvents(params) {
     const sieve = {
         filters: params?.filters,

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

@@ -3,7 +3,6 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Link from "next/link";
 import { Article, BaseListingCard, Button, Div, Heading, RichText, Row, Span, Stack, TextLink } from "../../../ui";
 import { MediaImage } from "../../media/MediaImage";
-import { LAYOUT } from "../../../tokens";
 import { normalizeRichTextHtml } from "../../../utils/string.formatter";
 import { EVENT_FIELDS } from "../schemas";
 import { EventStatusBadge } from "./EventStatusBadge";
@@ -33,6 +32,6 @@ export function EventCard({ event, labels = {}, onParticipate, className = "", s
     const msLeft = endsAt.getTime() - now.getTime();
     const daysLeft = Math.max(0, Math.ceil(msLeft / (1000 * 60 * 60 * 24)));
     const detailHref = String(ROUTES.PUBLIC.EVENT_DETAIL(event.slug ?? event.id));
-    return (_jsxs(Article, { border: "default", rounded: "xl", shadow: "hover-md", className: `group relative h-full ${LAYOUT.cardHeight.event} overflow-hidden bg-[var(--appkit-color-surface)] ${isSelected ? "border-primary outline outline-2 outline-primary" : " "} ${className}`, onMouseDown: onSelect && !isSelected ? longPress.onMouseDown : undefined, onMouseUp: onSelect && !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: onSelect && !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: onSelect && !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: onSelect && !isSelected ? longPress.onTouchEnd : undefined, onTouchCancel: onSelect && !isSelected ? longPress.onTouchCancel : undefined, children: [onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (e) => { e.preventDefault(); onSelect(event.id, !isSelected); }, label: isSelected ? "Deselect event" : "Select event", position: "top-2 left-2", className: selectable || isSelected ? "opacity-100" : "opacity-0 group-hover:opacity-100 transition-opacity" })), _jsx(Link, { href: detailHref, className: "block flex-shrink-0", children: event.coverImageUrl ? (_jsx(Div, { className: `relative aspect-video ${__O.hidden}`, children: _jsx(MediaImage, { src: event.coverImageUrl, alt: safeTitle, size: "card", className: "transition-transform duration-300 group-hover:scale-105" }) })) : (_jsx(Row, { surface: "muted", className: "aspect-video", align: "center", justify: "center", children: _jsx(Span, { className: "opacity-40", size: "5xl", "aria-hidden": "true", children: TYPE_ICONS[event.type] }) })) }), _jsxs(Stack, { className: `flex-1 ${__P.p4}`, children: [_jsxs(Row, { className: "mb-2", align: "start", justify: "between", gap: "sm", children: [_jsx(Span, { size: "lg", "aria-hidden": "true", children: TYPE_ICONS[event.type] }), _jsx(EventStatusBadge, { status: event.status })] }), _jsx(Link, { href: detailHref, className: "block", children: _jsx(Heading, { level: 3, className: "text-[var(--appkit-color-text)] leading-snug mb-1 group-hover:text-primary transition-colors", size: "base", weight: "semibold", children: safeTitle }) }), _jsx(RichText, { html: normalizeRichTextHtml(event.description ?? ""), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "mb-3 line-clamp-3 text-[length:var(--appkit-text-sm)] text-[var(--appkit-color-text-muted)]" }), _jsxs(Row, { color: "muted", textSize: "xs", className: "mb-3 mt-auto", align: "center", justify: "between", children: [event.status === EVENT_FIELDS.STATUS_VALUES.ACTIVE &&
+    return (_jsxs(Article, { border: "default", rounded: "xl", shadow: "hover-md", className: `group relative flex h-full flex-col overflow-hidden bg-[var(--appkit-color-surface)] ${isSelected ? "border-primary outline outline-2 outline-primary" : " "} ${className}`, onMouseDown: onSelect && !isSelected ? longPress.onMouseDown : undefined, onMouseUp: onSelect && !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: onSelect && !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: onSelect && !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: onSelect && !isSelected ? longPress.onTouchEnd : undefined, onTouchCancel: onSelect && !isSelected ? longPress.onTouchCancel : undefined, children: [onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (e) => { e.preventDefault(); onSelect(event.id, !isSelected); }, label: isSelected ? "Deselect event" : "Select event", position: "top-2 left-2", className: selectable || isSelected ? "opacity-100" : "opacity-0 group-hover:opacity-100 transition-opacity" })), _jsx(Link, { href: detailHref, className: "block flex-shrink-0", children: event.coverImageUrl || event.coverImage?.url ? (_jsx(Div, { className: `relative aspect-video ${__O.hidden}`, children: _jsx(MediaImage, { src: event.coverImageUrl || event.coverImage?.url || "", alt: safeTitle, size: "card", className: "transition-transform duration-300 group-hover:scale-105" }) })) : (_jsx(Row, { surface: "muted", className: "aspect-video", align: "center", justify: "center", children: _jsx(Span, { className: "opacity-40", size: "5xl", "aria-hidden": "true", children: TYPE_ICONS[event.type] }) })) }), _jsxs(Stack, { className: `flex-1 ${__P.p4}`, children: [_jsxs(Row, { className: "mb-2", align: "start", justify: "between", gap: "sm", children: [_jsx(Span, { size: "lg", "aria-hidden": "true", children: TYPE_ICONS[event.type] }), _jsx(EventStatusBadge, { status: event.status })] }), _jsx(Link, { href: detailHref, className: "block", children: _jsx(Heading, { level: 3, className: "text-[var(--appkit-color-text)] leading-snug mb-1 group-hover:text-primary transition-colors", size: "base", weight: "semibold", children: safeTitle }) }), _jsx(RichText, { html: normalizeRichTextHtml(event.description ?? ""), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "mb-3 line-clamp-3 text-[length:var(--appkit-text-sm)] text-[var(--appkit-color-text-muted)]" }), _jsxs(Row, { color: "muted", textSize: "xs", className: "mb-3 mt-auto", align: "center", justify: "between", children: [event.status === EVENT_FIELDS.STATUS_VALUES.ACTIVE &&
                                 daysLeft > 0 && _jsxs(Span, { children: ["\u23F1 ", daysLeft, "d remaining"] }), _jsxs(Span, { children: ["\uD83D\uDC65 ", event.stats.totalEntries, " ", labels.entries ?? "entries"] })] }), event.status === EVENT_FIELDS.STATUS_VALUES.ACTIVE && onParticipate ? (_jsx(Button, { rounded: "lg", type: "button", onClick: () => onParticipate(event), className: "w-full bg-primary py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] font-medium text-white transition-colors hover:bg-primary-600", children: labels.participate ?? "Participate" })) : (_jsxs(TextLink, { rounded: "lg", paddingX: "sm", paddingY: "xs", href: detailHref, layout: "inline-flex", align: "center", justify: "center", gap: "xs", className: "w-full border border-[var(--appkit-color-border)] transition-colors hover:bg-[var(--appkit-color-bg)]", color: "primary", size: "sm", weight: "medium", children: [labels.viewDetails ?? "View details", " \u2192"] }))] })] }));
 }

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

@@ -0,0 +1,15 @@
+import React from "react";
+import type { MediaField } from "../../media/types";
+export interface RelatedEventItem {
+    id: string;
+    slug?: string;
+    title: string;
+    coverImage?: MediaField | null;
+    coverImageUrl?: string;
+}
+interface RelatedEventsCarouselProps {
+    items: RelatedEventItem[];
+    title?: string;
+}
+export declare function RelatedEventsCarousel({ items, title, }: RelatedEventsCarouselProps): React.JSX.Element | null;
+export {};

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

@@ -0,0 +1,13 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { ROUTES } from "../../../next";
+import { SectionCarousel } from "../../homepage/components/SectionCarousel";
+import { MediaImage } from "../../media/MediaImage";
+import { Div, Heading, Stack } from "../../../ui";
+import { CAROUSEL_PER_VIEW } from "../../homepage/constants/carousel-per-view";
+export function RelatedEventsCarousel({ items, title = "Related Events", }) {
+    if (items.length === 0)
+        return null;
+    return (_jsx(SectionCarousel, { title: title, pillLabel: "Related Events", headingVariant: "editorial", items: items, isLoading: false, perView: CAROUSEL_PER_VIEW.standard, keyExtractor: (item) => item.id, renderItem: (item) => (_jsx(Link, { href: String(ROUTES.PUBLIC.EVENT_DETAIL(item.slug || item.id)), className: "block h-full", children: _jsxs(Stack, { className: "h-full", surface: "default", rounded: "xl", border: "default", overflow: "hidden", children: [_jsx(Div, { surface: "muted", overflow: "hidden", className: "relative aspect-[4/3] w-full flex-shrink-0", children: (item.coverImage?.url || item.coverImageUrl) && (_jsx(MediaImage, { src: (item.coverImage?.url || item.coverImageUrl), alt: item.title, size: "card" })) }), _jsx(Heading, { level: 3, className: "p-[var(--appkit-space-3)]", truncate: 2, size: "sm", weight: "semibold", children: item.title })] }) })) }));
+}

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

@@ -2,6 +2,8 @@ export { EventStatusBadge } from "./EventStatusBadge";
 export { EventFilters, EVENT_SORT_OPTIONS, EVENT_FILTER_KEYS, EVENT_ADMIN_SORT_OPTIONS, EVENT_SELLER_SORT_OPTIONS, EVENT_PUBLIC_SORT_OPTIONS, getEventFilterKeys, getEventSortOptions, } from "./EventFilters";
 export type { EventFiltersProps, EventFilterVariant } from "./EventFilters";
 export { EventCard } from "./EventCard";
+export { RelatedEventsCarousel } from "./RelatedEventsCarousel";
+export type { RelatedEventItem } from "./RelatedEventsCarousel";
 export { EventsListView } from "./EventsListView";
 export { EventsIndexListing } from "./EventsIndexListing";
 export type { EventsIndexListingProps } from "./EventsIndexListing";

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

@@ -1,6 +1,7 @@
 export { EventStatusBadge } from "./EventStatusBadge";
 export { EventFilters, EVENT_SORT_OPTIONS, EVENT_FILTER_KEYS, EVENT_ADMIN_SORT_OPTIONS, EVENT_SELLER_SORT_OPTIONS, EVENT_PUBLIC_SORT_OPTIONS, getEventFilterKeys, getEventSortOptions, } from "./EventFilters";
 export { EventCard } from "./EventCard";
+export { RelatedEventsCarousel } from "./RelatedEventsCarousel";
 export { EventsListView } from "./EventsListView";
 export { EventsIndexListing } from "./EventsIndexListing";
 export { EventDetailView } from "./EventDetailView";