@se-studio/core-ui 0.0.0-next16-20260822103555

package/dist/components/VisualComponent.js

@@ -0,0 +1,136 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { isVisualDownload } from '@se-studio/core-data-types';
+import { cn } from '../utils/cn';
+import { UnsupportedWarning } from '../utils/UnsupportedWarning';
+import { HeroLoopVideo } from './HeroLoopVideo';
+import { shouldRenderHeroLoop } from './heroLoop';
+import ImageComponent from './ImageComponent';
+import { LazyAnimation } from './LazyAnimation';
+import { LazyVideo } from './LazyVideo';
+/**
+ * Determines if a mask value is a URL (for CSS mask-image) or Tailwind classes.
+ * URLs start with '/' or 'http', everything else is treated as Tailwind classes.
+ */
+function isMaskUrl(mask) {
+    return mask.startsWith('/') || mask.startsWith('http');
+}
+/**
+ * Visual component for rendering images, videos, and animations.
+ *
+ * Automatically selects the appropriate renderer based on the visual type:
+ * - Animations (Lottie) are rendered via AnimationComponent
+ * - Videos are rendered via VideoComponent with Next.js optimization
+ * - Images are rendered via ImageComponent with Next.js Image optimization
+ *
+ * SVG images from icon fields are automatically rendered using the sprite system,
+ * which enables currentColor support for theming.
+ *
+ * When a mask is set on the visual, the component wraps the content in a
+ * container with the mask applied. Masks can be:
+ * - URL-based (starts with '/' or 'http'): Uses CSS mask-image
+ * - Class-based (Tailwind classes): Applied directly to the container
+ *
+ * @param visual - Visual data containing image, video, or animation
+ * @param muted - Whether video should be muted (default: false)
+ * @param controls - Whether video should show controls (default: false)
+ * @param autoPlay - Whether video/animation should autoplay (default: false)
+ * @param visualSizes - Responsive size configuration for the visual
+ * @param fullPlayer - Whether video should use full player mode (default: false)
+ * @param loop - Whether video/animation should loop (default: false)
+ * @param loopDelay - Delay between loops in milliseconds
+ * @param analyticsContext - Analytics context for tracking
+ * @param componentLabel - Label for analytics tracking
+ * @param className - Additional CSS classes
+ * @param style - Additional inline styles
+ *
+ * @example Basic image
+ * ```tsx
+ * <Visual visual={imageVisual} className="w-full h-auto" />
+ * ```
+ *
+ * @example Icon with currentColor support (automatic for icons from icon fields)
+ * ```tsx
+ * <Visual visual={component.icon} className="w-6 h-6 text-blue-500" />
+ * ```
+ *
+ * @example Video with autoplay
+ * ```tsx
+ * <Visual
+ *   visual={videoVisual}
+ *   autoPlay
+ *   muted
+ *   loop
+ *   className="w-full"
+ * />
+ * ```
+ *
+ * @example Animation with loop delay
+ * ```tsx
+ * <Visual
+ *   visual={animationVisual}
+ *   autoPlay
+ *   loop
+ *   loopDelay={1000}
+ * />
+ * ```
+ *
+ * @example Image with URL-based mask (CSS mask-image)
+ * ```tsx
+ * <Visual
+ *   visual={{ ...imageVisual, mask: '/assets/masks/circle.svg' }}
+ *   className="w-64"
+ * />
+ * ```
+ *
+ * @example Image with class-based mask (Tailwind classes)
+ * ```tsx
+ * <Visual
+ *   visual={{ ...imageVisual, mask: 'aspect-square rounded-full' }}
+ *   className="w-64"
+ * />
+ * ```
+ */
+export const Visual = ({ visual, muted, controls, autoPlay, visualSizes, fullPlayer, loop, loopDelay, contained, analyticsContext, componentLabel, className, style, ...props }) => {
+    const { animation, image, video, mask, gradient } = visual;
+    // Render the appropriate visual type
+    let content;
+    if (animation) {
+        content = (_jsx(LazyAnimation, { ...props, animation: animation, autoPlay: autoPlay, loop: loop, loopDelay: loopDelay, analyticsContext: analyticsContext, componentLabel: componentLabel, className: cn(className, mask && 'size-full object-cover'), style: mask ? undefined : style }));
+    }
+    else if (video) {
+        const videoClassName = cn(className, mask && 'size-full object-cover');
+        const videoStyle = mask ? undefined : style;
+        if (shouldRenderHeroLoop(video, { autoPlay, loop })) {
+            content = (_jsx(HeroLoopVideo, { delivery: video.heroDelivery, autoPlay: video.autoPlay ?? autoPlay, loop: video.loop ?? loop, visualSizes: visualSizes, contained: contained, dontCrop: video.dontCrop, verticalCropPosition: video.verticalCropPosition, horizontalCropPosition: video.horizontalCropPosition, loading: props.loading, fetchPriority: props.fetchPriority, className: videoClassName, style: videoStyle }));
+        }
+        else {
+            content = (_jsx(LazyVideo, { ...props, video: video, autoPlay: autoPlay, muted: muted, controls: controls, visualSizes: visualSizes, fullPlayer: fullPlayer, loop: loop, contained: contained, analyticsContext: analyticsContext, componentLabel: componentLabel, className: videoClassName, style: videoStyle }));
+        }
+    }
+    else if (image) {
+        content = (_jsx(ImageComponent, { ...props, image: image, visualSizes: visualSizes, className: cn(className, mask && 'size-full object-cover'), style: mask ? undefined : style }));
+    }
+    else if (isVisualDownload(visual)) {
+        const label = visual.name ?? visual.download.filename;
+        return (_jsx("a", { href: visual.download.href, className: cn('underline hover:opacity-80', className), style: style, children: label }));
+    }
+    else {
+        return (_jsx(UnsupportedWarning, { className: className, style: style, children: "Not supporting non images yet" }));
+    }
+    // If mask is set, wrap in a container with mask applied
+    if (mask) {
+        if (isMaskUrl(mask)) {
+            // URL-based mask: use CSS mask-image with 1:1 aspect ratio
+            const maskStyle = { '--mask-url': `url(${mask})`, ...style };
+            return (_jsxs("div", { className: cn('relative aspect-square overflow-hidden', 'mask-[image:var(--mask-url)] mask-[size:100%_100%] mask-no-repeat mask-center', className), style: maskStyle, children: [content, gradient && (_jsx("div", { className: "absolute inset-0 pointer-events-none", style: { background: gradient }, "aria-hidden": "true" }))] }));
+        }
+        // Class-based mask: apply Tailwind classes directly
+        return (_jsxs("div", { className: cn('relative overflow-hidden', mask, className), style: style, children: [content, gradient && (_jsx("div", { className: "absolute inset-0 pointer-events-none", style: { background: gradient }, "aria-hidden": "true" }))] }));
+    }
+    // If gradient is set (no mask), wrap in a relative container with overlay
+    if (gradient) {
+        return (_jsxs("div", { className: cn('relative', className), style: style, children: [content, _jsx("div", { className: "absolute inset-0 pointer-events-none", style: { background: gradient }, "aria-hidden": "true" })] }));
+    }
+    return content;
+};
+//# sourceMappingURL=VisualComponent.js.map

package/dist/components/VisualComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisualComponent.js","sourceRoot":"","sources":["../../src/components/VisualComponent.tsx"],"names":[],"mappings":"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"}

package/dist/components/banner/BannerClient.d.ts

@@ -0,0 +1,13 @@
+import type { IBanner } from '@se-studio/core-data-types';
+interface BannerClientProps {
+    banners: readonly IBanner[];
+    BannerComponent: React.ComponentType<{
+        banner: IBanner;
+        onDismiss: () => void;
+        onClick?: () => void;
+    }>;
+    debug?: boolean;
+}
+declare const BannerClient: React.FC<BannerClientProps>;
+export default BannerClient;
+//# sourceMappingURL=BannerClient.d.ts.map

package/dist/components/banner/BannerClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerClient.d.ts","sourceRoot":"","sources":["../../../src/components/banner/BannerClient.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAU1D,UAAU,iBAAiB;IACzB,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IAC5B,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC;QACnC,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,MAAM,IAAI,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAkD7C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/banner/BannerClient.js

@@ -0,0 +1,38 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useLayoutEffect, useState } from 'react';
+import { readDismissedBannerStorage, readDismissedSessionBannerIds, selectVisibleBannerId, sortBannersByPriority, writeBannerDismissal, } from './bannerVisibility';
+const BannerClient = ({ banners, BannerComponent, debug }) => {
+    const sortedBanners = sortBannersByPriority(banners);
+    const [visibleBannerId, setVisibleBannerId] = useState(() => sortedBanners[0]?.id ?? null);
+    useLayoutEffect(() => {
+        if (debug) {
+            console.log('[BannerClient] Syncing visibility with dismissal storage:', banners);
+        }
+        setVisibleBannerId(selectVisibleBannerId(banners, {
+            dismissedBanners: readDismissedBannerStorage(),
+            dismissedSessionBannerIds: readDismissedSessionBannerIds(banners),
+        }));
+    }, [banners, debug]);
+    const handleClick = useCallback((banner) => {
+        if (debug)
+            console.debug('Banner clicked:', banner.id);
+    }, [debug]);
+    const handleDismiss = useCallback((banner) => {
+        if (debug)
+            console.log(`[BannerClient] Dismissing banner ${banner.id}`);
+        writeBannerDismissal(banner);
+        setVisibleBannerId(null);
+    }, [debug]);
+    if (!visibleBannerId) {
+        if (debug && banners.length > 0)
+            console.log('[BannerClient] No visible banner selected.');
+        return null;
+    }
+    const visibleBanner = banners.find((banner) => banner.id === visibleBannerId);
+    if (!visibleBanner)
+        return null;
+    return (_jsx(BannerComponent, { banner: visibleBanner, onDismiss: () => handleDismiss(visibleBanner), onClick: () => handleClick(visibleBanner) }));
+};
+export default BannerClient;
+//# sourceMappingURL=BannerClient.js.map

package/dist/components/banner/BannerClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerClient.js","sourceRoot":"","sources":["../../../src/components/banner/BannerClient.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAY5B,MAAM,YAAY,GAAgC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,EAAE;IACxF,MAAM,aAAa,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CACpD,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CACnC,CAAC;IAEF,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,2DAA2D,EAAE,OAAO,CAAC,CAAC;QACpF,CAAC;QAED,kBAAkB,CAChB,qBAAqB,CAAC,OAAO,EAAE;YAC7B,gBAAgB,EAAE,0BAA0B,EAAE;YAC9C,yBAAyB,EAAE,6BAA6B,CAAC,OAAO,CAAC;SAClE,CAAC,CACH,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAErB,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,MAAe,EAAE,EAAE;QAClB,IAAI,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,MAAe,EAAE,EAAE;QAClB,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,oCAAoC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACxE,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7B,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,IAAI,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC;IAC9E,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAEhC,OAAO,CACL,KAAC,eAAe,IACd,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,EAC7C,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,GACzC,CACH,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/banner/BannerManager.d.ts

@@ -0,0 +1,26 @@
+import type { BannerPlacement, IBanner, IBaseModel, ITyped } from '@se-studio/core-data-types';
+interface BannerManagerProps {
+    content: IBaseModel & {
+        tags?: ReadonlyArray<ITyped>;
+    };
+    banners: ReadonlyArray<IBanner>;
+    BannerComponent: React.ComponentType<{
+        banner: IBanner;
+        onDismiss: () => void;
+        onClick?: () => void;
+    }>;
+    /**
+     * Layout slot this manager instance renders.
+     * Defaults to `top` (under nav / before main). Mount separate managers for
+     * `afterHero` and `bottomSticky` slots.
+     */
+    placement?: BannerPlacement;
+}
+/**
+ * Filter banners for a layout placement slot (default top).
+ * Missing/null placement on a banner is treated as `top`.
+ */
+export declare function filterBannersByPlacement(banners: ReadonlyArray<IBanner>, placement?: BannerPlacement): IBanner[];
+export declare function BannerManager({ content, banners, BannerComponent, placement, }: BannerManagerProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=BannerManager.d.ts.map

package/dist/components/banner/BannerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerManager.d.ts","sourceRoot":"","sources":["../../../src/components/banner/BannerManager.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAM/F,UAAU,kBAAkB;IAC1B,OAAO,EAAE,UAAU,GAAG;QAAE,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IACvD,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAChC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC;QACnC,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,MAAM,IAAI,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;KACtB,CAAC,CAAC;IACH;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,EAC/B,SAAS,GAAE,eAAuB,GACjC,OAAO,EAAE,CAEX;AAED,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,OAAO,EACP,eAAe,EACf,SAAiB,GAClB,EAAE,kBAAkB,sCA4BpB"}

package/dist/components/banner/BannerManager.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { resolveBannerPlacement } from '@se-studio/core-data-types';
+import BannerClient from './BannerClient';
+import { BannerTargetingEngine } from './BannerTargeting';
+import { isBannerWithinSchedule, sortBannersByPriority } from './bannerVisibility';
+/**
+ * Filter banners for a layout placement slot (default top).
+ * Missing/null placement on a banner is treated as `top`.
+ */
+export function filterBannersByPlacement(banners, placement = 'top') {
+    return banners.filter((banner) => resolveBannerPlacement(banner) === placement);
+}
+export function BannerManager({ content, banners, BannerComponent, placement = 'top', }) {
+    const debug = process.env.BANNER_DEBUG === 'true';
+    if (!banners || banners.length === 0) {
+        if (debug)
+            console.log('[BannerManager] No banners found.');
+        return null;
+    }
+    const slotBanners = filterBannersByPlacement(banners, placement);
+    if (slotBanners.length === 0) {
+        if (debug)
+            console.log(`[BannerManager] No banners for placement=${placement}.`);
+        return null;
+    }
+    const targetedBanners = BannerTargetingEngine.filterBannersForPage(slotBanners, content);
+    const activeBanners = sortBannersByPriority(targetedBanners).filter((banner) => isBannerWithinSchedule(banner));
+    if (debug) {
+        console.log(`[BannerManager] placement=${placement}: ${activeBanners.length} banners passed targeting and schedule.`);
+    }
+    if (activeBanners.length === 0)
+        return null;
+    return _jsx(BannerClient, { banners: activeBanners, BannerComponent: BannerComponent, debug: debug });
+}
+//# sourceMappingURL=BannerManager.js.map

package/dist/components/banner/BannerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerManager.js","sourceRoot":"","sources":["../../../src/components/banner/BannerManager.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAkBnF;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA+B,EAC/B,YAA6B,KAAK;IAElC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAC5B,OAAO,EACP,OAAO,EACP,eAAe,EACf,SAAS,GAAG,KAAK,GACE;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,MAAM,CAAC;IAElD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,wBAAwB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,4CAA4C,SAAS,GAAG,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,eAAe,GAAG,qBAAqB,CAAC,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACzF,MAAM,aAAa,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAC7E,sBAAsB,CAAC,MAAM,CAAC,CAC/B,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CACT,6BAA6B,SAAS,KAAK,aAAa,CAAC,MAAM,yCAAyC,CACzG,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,OAAO,KAAC,YAAY,IAAC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAI,CAAC;AAClG,CAAC"}

package/dist/components/banner/BannerTargeting.d.ts

@@ -0,0 +1,20 @@
+import type { IBanner, IBaseModel } from '@se-studio/core-data-types';
+export declare const BannerTargetingEngine: {
+    /**
+     * Evaluates whether a banner should be shown on the current page with comprehensive logging
+     * @param banner Banner configuration with targeting rules
+     * @param content Current page/content model (IBaseModel or similar ITyped)
+     * @param url Current page URL
+     * @returns true if banner should be shown
+     */
+    evaluateBannerRules(banner: IBanner, content: IBaseModel): boolean;
+    /**
+     * Process all banners for a page with summary logging
+     * @param banners Array of banners to evaluate
+     * @param content Current content model
+     * @param url Current URL
+     * @returns Array of banners that should be shown
+     */
+    filterBannersForPage(banners: readonly IBanner[], content: IBaseModel): IBanner[];
+};
+//# sourceMappingURL=BannerTargeting.d.ts.map

package/dist/components/banner/BannerTargeting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerTargeting.d.ts","sourceRoot":"","sources":["../../../src/components/banner/BannerTargeting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAU,MAAM,4BAA4B,CAAC;AAmG9E,eAAO,MAAM,qBAAqB;IAChC;;;;;;OAMG;gCACyB,OAAO,WAAW,UAAU,GAAG,OAAO;IA0GlE;;;;;;OAMG;kCAC2B,SAAS,OAAO,EAAE,WAAW,UAAU,GAAG,OAAO,EAAE;CAuBlF,CAAC"}

package/dist/components/banner/BannerTargeting.js

@@ -0,0 +1,204 @@
+const BANNER_DEBUG = process.env.BANNER_DEBUG === 'true';
+// Debug logging function for banner targeting
+const debugLog = (message, data) => {
+    if (BANNER_DEBUG) {
+        console.log(message, data);
+    }
+};
+/**
+ * Normalize URL for consistent pattern matching
+ * @param url URL to normalize
+ * @returns Normalized URL
+ */
+function normalizeUrl(url) {
+    // Ensure leading slash, remove trailing slash (except root), lowercase
+    let normalized = url.toLowerCase();
+    if (!normalized.startsWith('/')) {
+        normalized = `/${normalized}`;
+    }
+    if (normalized.length > 1 && normalized.endsWith('/')) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+}
+/**
+ * Check if a URL matches a pattern with wildcard support
+ * @param pattern Pattern with * wildcards
+ * @param url URL to check
+ * @returns true if URL matches pattern
+ */
+function matchesPattern(pattern, url) {
+    // Escape special regex characters except *
+    const escapedPattern = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+    // Replace * with regex equivalent (match any characters)
+    const regexPattern = escapedPattern.replace(/\*/g, '(.*)?');
+    // Create regex with anchors for exact matching
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(url);
+}
+/**
+ * Check if any URL pattern matches the current URL
+ * @param patterns Array of URL patterns to check
+ * @param url Current page URL
+ * @returns Matched pattern or null
+ */
+function matchesAnyPattern(patterns, url) {
+    const normalizedUrl = normalizeUrl(url);
+    for (const pattern of patterns) {
+        const normalizedPattern = normalizeUrl(pattern);
+        if (matchesPattern(normalizedPattern, normalizedUrl)) {
+            return pattern;
+        }
+    }
+    return null;
+}
+/**
+ * Check if any content reference matches the current page context
+ * @param references Array of content references to check
+ * @param content Current page content
+ * @returns Matched reference or null
+ */
+function matchesAnyReference(references, content) {
+    for (const ref of references) {
+        // Direct ID match
+        if (ref.id === content.id) {
+            return ref;
+        }
+    }
+    return null;
+}
+export const BannerTargetingEngine = {
+    /**
+     * Evaluates whether a banner should be shown on the current page with comprehensive logging
+     * @param banner Banner configuration with targeting rules
+     * @param content Current page/content model (IBaseModel or similar ITyped)
+     * @param url Current page URL
+     * @returns true if banner should be shown
+     */
+    evaluateBannerRules(banner, content) {
+        const url = content.href;
+        debugLog('Looking at banner', banner);
+        const evaluation = {
+            excludePatterns: { matched: false },
+            excludeContent: { matched: false },
+            includePatterns: { matched: false },
+            includeContent: { matched: false },
+        };
+        let decision = 'DEFAULT';
+        let reason = 'default_behavior';
+        let matchedPattern;
+        let matchedContent;
+        let hasInclude = false;
+        let hasExclude = false;
+        // Step 1: Check exclude patterns first (highest priority)
+        if (banner.excludePatterns?.length) {
+            hasExclude = true;
+            const excludePatternMatch = matchesAnyPattern(banner.excludePatterns, url);
+            evaluation.excludePatterns.matched = !!excludePatternMatch;
+            if (excludePatternMatch) {
+                evaluation.excludePatterns.pattern = excludePatternMatch;
+                decision = 'EXCLUDED';
+                reason = 'matched_exclude_pattern';
+                matchedPattern = excludePatternMatch;
+            }
+        }
+        // Step 2: Check exclude content references
+        if (decision === 'DEFAULT' && content && banner.hideOn?.length) {
+            hasExclude = true;
+            const excludeContentMatch = matchesAnyReference(banner.hideOn, content);
+            evaluation.excludeContent.matched = !!excludeContentMatch;
+            if (excludeContentMatch) {
+                evaluation.excludeContent.contentType = excludeContentMatch.type;
+                evaluation.excludeContent.id = excludeContentMatch.id;
+                decision = 'EXCLUDED';
+                reason = 'matched_exclude_content';
+                matchedContent = {
+                    type: excludeContentMatch.type,
+                    id: excludeContentMatch.id,
+                };
+            }
+        }
+        // Step 3: Check include patterns
+        if (decision === 'DEFAULT' && url && banner.includePatterns?.length) {
+            hasInclude = true;
+            const includePatternMatch = matchesAnyPattern(banner.includePatterns, url);
+            evaluation.includePatterns.matched = !!includePatternMatch;
+            if (includePatternMatch) {
+                evaluation.includePatterns.pattern = includePatternMatch;
+                decision = 'INCLUDED';
+                reason = 'matched_include_pattern';
+                matchedPattern = includePatternMatch;
+            }
+        }
+        // Step 4: Check include content references (only if no include patterns or if patterns matched)
+        if (decision === 'DEFAULT' && content && banner.showOn?.length) {
+            hasInclude = true;
+            const includeContentMatch = matchesAnyReference(banner.showOn, content);
+            evaluation.includeContent.matched = !!includeContentMatch;
+            if (includeContentMatch) {
+                evaluation.includeContent.contentType = includeContentMatch.type;
+                evaluation.includeContent.id = includeContentMatch.id;
+                decision = 'INCLUDED';
+                reason = 'matched_include_content';
+                matchedContent = {
+                    type: includeContentMatch.type,
+                    id: includeContentMatch.id,
+                };
+            }
+        }
+        if (decision === 'DEFAULT') {
+            if (hasInclude) {
+                decision = 'EXCLUDED';
+                reason = 'no_include_match';
+            }
+            else if (hasExclude) {
+                decision = 'INCLUDED';
+                reason = 'no_exclude_match';
+            }
+        }
+        const finalDecision = decision === 'DEFAULT' ? 'INCLUDED' : decision;
+        // Debug logging
+        if (BANNER_DEBUG) {
+            const debugInfo = {
+                bannerId: banner.id,
+                bannerMessage: banner.message ?? null,
+                currentUrl: url,
+                decision: finalDecision,
+                reason,
+                matchedPattern,
+                matchedContent,
+                evaluation,
+            };
+            debugLog(`🎯 Banner Decision for "${banner.message}":`, debugInfo);
+        }
+        return finalDecision === 'INCLUDED';
+    },
+    /**
+     * Process all banners for a page with summary logging
+     * @param banners Array of banners to evaluate
+     * @param content Current content model
+     * @param url Current URL
+     * @returns Array of banners that should be shown
+     */
+    filterBannersForPage(banners, content) {
+        const results = banners.map((banner) => ({
+            banner,
+            shouldShow: this.evaluateBannerRules(banner, content),
+        }));
+        const includedBanners = results.filter((r) => r.shouldShow).map((r) => r.banner);
+        debugLog('📊 Banner filtering summary:', {
+            pageUrl: content.href,
+            contentId: content.id,
+            totalBanners: banners.length,
+            includedBanners: includedBanners.length,
+            excludedBanners: banners.length - includedBanners.length,
+            bannerDetails: results.map((r) => ({
+                id: r.banner.id,
+                message: r.banner.message,
+                status: r.shouldShow ? 'INCLUDED' : 'EXCLUDED',
+            })),
+        });
+        return includedBanners;
+    },
+};
+//# sourceMappingURL=BannerTargeting.js.map

package/dist/components/banner/BannerTargeting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerTargeting.js","sourceRoot":"","sources":["../../../src/components/banner/BannerTargeting.ts"],"names":[],"mappings":"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"}

package/dist/components/banner/bannerVisibility.d.ts

@@ -0,0 +1,20 @@
+import type { IBanner } from '@se-studio/core-data-types';
+export type DismissedBannerRecord = Record<string, {
+    timestamp?: string;
+    type?: string;
+}>;
+export declare function sortBannersByPriority(banners: readonly IBanner[]): IBanner[];
+export declare function isBannerWithinSchedule(banner: IBanner, referenceDate?: Date): boolean;
+/**
+ * Picks the highest-priority banner that is within schedule and not dismissed.
+ * Storage arguments are injected so this stays testable without browser APIs.
+ */
+export declare function selectVisibleBannerId(banners: readonly IBanner[], { dismissedBanners, dismissedSessionBannerIds, referenceDate, }?: {
+    dismissedBanners?: DismissedBannerRecord;
+    dismissedSessionBannerIds?: ReadonlySet<string>;
+    referenceDate?: Date;
+}): string | null;
+export declare function readDismissedBannerStorage(): DismissedBannerRecord;
+export declare function readDismissedSessionBannerIds(banners: readonly IBanner[]): Set<string>;
+export declare function writeBannerDismissal(banner: IBanner): void;
+//# sourceMappingURL=bannerVisibility.d.ts.map

package/dist/components/banner/bannerVisibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerVisibility.d.ts","sourceRoot":"","sources":["../../../src/components/banner/bannerVisibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE1F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAE5E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,OAAa,GAAG,OAAO,CAQ3F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,EACE,gBAAqB,EACrB,yBAA6C,EAC7C,aAA0B,GAC3B,GAAE;IACD,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,yBAAyB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,IAAI,CAAC;CACjB,GACL,MAAM,GAAG,IAAI,CA6Bf;AAED,wBAAgB,0BAA0B,IAAI,qBAAqB,CAMlE;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAatF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAe1D"}

package/dist/components/banner/bannerVisibility.js

@@ -0,0 +1,73 @@
+export function sortBannersByPriority(banners) {
+    return [...banners].sort((a, b) => (b.priority || 0) - (a.priority || 0));
+}
+export function isBannerWithinSchedule(banner, referenceDate = new Date()) {
+    if (banner.startDate && new Date(banner.startDate) > referenceDate) {
+        return false;
+    }
+    if (banner.endDate && new Date(banner.endDate) < referenceDate) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Picks the highest-priority banner that is within schedule and not dismissed.
+ * Storage arguments are injected so this stays testable without browser APIs.
+ */
+export function selectVisibleBannerId(banners, { dismissedBanners = {}, dismissedSessionBannerIds = new Set(), referenceDate = new Date(), } = {}) {
+    const sortedBanners = sortBannersByPriority(banners);
+    for (const banner of sortedBanners) {
+        if (!isBannerWithinSchedule(banner, referenceDate)) {
+            continue;
+        }
+        const dismissed = dismissedBanners[banner.id];
+        if (!dismissed) {
+            return banner.id;
+        }
+        if (banner.dismissType === 'Timed' && dismissed.timestamp) {
+            const hoursSinceDismiss = (referenceDate.getTime() - new Date(dismissed.timestamp).getTime()) / (1000 * 60 * 60);
+            if (hoursSinceDismiss >= (banner.dismissDurationHours || 24)) {
+                return banner.id;
+            }
+        }
+        if (banner.dismissType === 'Session') {
+            if (!dismissedSessionBannerIds.has(banner.id)) {
+                return banner.id;
+            }
+        }
+    }
+    return null;
+}
+export function readDismissedBannerStorage() {
+    if (typeof window === 'undefined') {
+        return {};
+    }
+    return JSON.parse(localStorage.getItem('dismissedBanners') || '{}');
+}
+export function readDismissedSessionBannerIds(banners) {
+    const dismissed = new Set();
+    if (typeof window === 'undefined') {
+        return dismissed;
+    }
+    for (const banner of banners) {
+        if (sessionStorage.getItem(`banner_session_${banner.id}`)) {
+            dismissed.add(banner.id);
+        }
+    }
+    return dismissed;
+}
+export function writeBannerDismissal(banner) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    const dismissedBanners = readDismissedBannerStorage();
+    dismissedBanners[banner.id] = {
+        timestamp: new Date().toISOString(),
+        type: banner.dismissType ?? undefined,
+    };
+    localStorage.setItem('dismissedBanners', JSON.stringify(dismissedBanners));
+    if (banner.dismissType === 'Session') {
+        sessionStorage.setItem(`banner_session_${banner.id}`, 'true');
+    }
+}
+//# sourceMappingURL=bannerVisibility.js.map

package/dist/components/banner/bannerVisibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerVisibility.js","sourceRoot":"","sources":["../../../src/components/banner/bannerVisibility.ts"],"names":[],"mappings":"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"}

package/dist/components/clientMonitorVideos.d.ts

@@ -0,0 +1,6 @@
+export declare function isAutoplayVideo(video: HTMLVideoElement): boolean;
+export declare function handleVideo(video: HTMLVideoElement, isIntersecting: boolean): void;
+/** Test-only: drop cached IntersectionObservers so stubs can be replaced. */
+export declare function resetVideoObserversForTests(): void;
+export declare function findAllVideos(defaultThreshold: number, shouldDebug?: (element?: HTMLElement) => boolean): () => void;
+//# sourceMappingURL=clientMonitorVideos.d.ts.map

package/dist/components/clientMonitorVideos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientMonitorVideos.d.ts","sourceRoot":"","sources":["../../src/components/clientMonitorVideos.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAEhE;AAiBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,QAoB3E;AAoBD,6EAA6E;AAC7E,wBAAgB,2BAA2B,SAK1C;AAED,wBAAgB,aAAa,CAC3B,gBAAgB,EAAE,MAAM,EACxB,WAAW,GAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAqB,cAgE9D"}