@bikdotai/bik-component-library 0.0.738-0 → 0.0.738-1

package/dist/cjs/components/feature-announcements/MinorUpdatePopup.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),t=require("react"),s=require("./constants/index.js");require("../../constants/Theme.js"),require("./constants/animations.js");var r=require("./styles/minorPopup.styles.js"),n=require("./utils/htmlHelpers.js"),i=require("./utils/animationHelpers.js"),a=require("./utils/elementHelpers.js");exports.default=l=>{let{feature:c,currentIndex:o,totalFeatures:u,onSkip:d,onExplore:g,onPrevious:j,onNext:T,setIsClosing:x}=l;const[y,f]=t.useState(!1),[h,m]=t.useState(!1),[E,p]=t.useState(""),b=t.useRef(null);t.useEffect((()=>{y&&m(!0)}),[y]);const O=r.getMinorPopupStyles(h,E);return e.jsxs("div",Object.assign({ref:b,style:O.container},{children:[e.jsx("div",Object.assign({style:O.imageContainer},{children:c.displayImage?e.jsxs("div",Object.assign({style:O.imageWrapper},{children:[e.jsx("img",{src:c.displayImage,alt:c.title,style:O.image,onError:e=>{c.image&&(e.target.src=c.image)}}),e.jsx("div",Object.assign({style:O.badge},{children:e.jsx("span",Object.assign({style:O.badgeText},{children:s.TEXT.NEW_FEATURE_BADGE}))}))]})):e.jsx("div",Object.assign({style:O.imagePlaceholder},{children:s.TEXT.FEATURE_PREVIEW_PLACEHOLDER}))})),e.jsxs("div",Object.assign({style:O.contentContainer},{children:[e.jsxs("div",{children:[e.jsx("h3",Object.assign({style:O.title},{children:c.title})),e.jsx("div",{style:O.content,dangerouslySetInnerHTML:{__html:n.decodeHTMLEntities(c.content||c.body||"")}})]}),e.jsxs("div",Object.assign({style:O.actionsContainer},{children:[e.jsx("span",Object.assign({onClick:()=>{(e=>{if(i.hideJoyrideArrow(b.current),b.current&&c.featureTag){const e=a.findFeatureTagElement(c.featureTag);if(e){const t=i.calculateCloseTransform(b.current,e);p(t)}else p("scale(0)")}else p("scale(0)");null==x||x(!0),f(!0),i.executeAfterAnimation(e)})(d)},style:O.understoodText},{children:s.TEXT.UNDERSTOOD})),c.productVideo&&e.jsx("button",Object.assign({onClick:()=>{if(g(),i.hideJoyrideArrow(b.current),b.current&&c.featureTag){const e=c.featureTag.startsWith("#")||c.featureTag.startsWith(".")||c.featureTag.startsWith("[")?c.featureTag:`#${c.featureTag}`,t=document.querySelector(e);if(t){const e=i.calculateCloseTransform(b.current,t);p(e)}else p("scale(0)")}else p("scale(0)");null==x||x(!0),f(!0)},style:O.exploreButton},{children:c.buttonText||s.TEXT.DEFAULT_BUTTON_TEXT}))]}))]}))]}))};

package/dist/cjs/components/feature-announcements/VideoModal.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { VideoModalProps } from './types';
+export declare const VideoModal: React.FC<VideoModalProps>;

package/dist/cjs/components/feature-announcements/VideoModal.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),s=require("./constants/index.js");require("../../constants/Theme.js"),require("./constants/animations.js");var t=require("./styles/videoModal.styles.js"),o=require("./utils/htmlHelpers.js");exports.VideoModal=r=>{let{isOpen:i,videoUrl:l,onClose:a}=r;if(!i)return null;const d=o.formatVideoUrl(l),n=o.isYouTubeVideo(l);return e.jsx("div",Object.assign({style:t.videoModalStyles.backdrop,onClick:e=>{e.target===e.currentTarget&&a()}},{children:e.jsxs("div",Object.assign({style:t.videoModalStyles.container,onClick:e=>e.stopPropagation()},{children:[e.jsx("button",Object.assign({onClick:a,style:t.videoModalStyles.closeButton.base,onMouseOver:e=>Object.assign(e.currentTarget.style,t.videoModalStyles.closeButton.hover),onMouseOut:e=>Object.assign(e.currentTarget.style,t.videoModalStyles.closeButton.base)},{children:"×"})),e.jsx("div",Object.assign({style:t.videoModalStyles.videoWrapper},{children:l?n?e.jsx("iframe",{width:"100%",height:"100%",src:d,title:s.TEXT.VIDEO_MODAL_TITLE,frameBorder:"0",allow:"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share",allowFullScreen:!0,style:t.videoModalStyles.iframe}):e.jsxs("video",Object.assign({controls:!0,autoPlay:!0,style:t.videoModalStyles.video},{children:[e.jsx("source",{src:l,type:"video/mp4"}),e.jsx("source",{src:l,type:"video/webm"}),e.jsx("source",{src:l,type:"video/ogg"}),"Your browser does not support the video tag."]})):e.jsx("div",Object.assign({style:t.videoModalStyles.noVideoMessage},{children:s.TEXT.NO_VIDEO_AVAILABLE}))}))]}))}))};

package/dist/cjs/components/feature-announcements/constants/animations.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Animation timing constants
+ */
+export declare const ANIMATION_TIMING: {
+    readonly CLOSE_DURATION: 1150;
+    readonly PROCESSING_DELAY: 500;
+    readonly MINOR_POPUP_DELAY: 2000;
+    readonly TRANSITION_DURATION: "1s";
+};
+/**
+ * Animation easing functions
+ */
+export declare const ANIMATION_EASING: {
+    readonly STANDARD: "cubic-bezier(0.4, 0, 0.2, 1)";
+};
+/**
+ * Element check configuration
+ */
+export declare const ELEMENT_CHECK_CONFIG: {
+    readonly MAX_ATTEMPTS: 25;
+    readonly RETRY_INTERVAL_MS: 200;
+    readonly SCROLL_DEBOUNCE_MS: 300;
+};
+/**
+ * Combined transition string
+ */
+export declare const POPUP_TRANSITION: string;

package/dist/cjs/components/feature-announcements/constants/animations.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const N={CLOSE_DURATION:1150,PROCESSING_DELAY:500,MINOR_POPUP_DELAY:2e3,TRANSITION_DURATION:"1s"},A={STANDARD:"cubic-bezier(0.4, 0, 0.2, 1)"},I=`transform ${N.TRANSITION_DURATION} ${A.STANDARD}, opacity ${N.TRANSITION_DURATION} ${A.STANDARD}`;exports.ANIMATION_EASING=A,exports.ANIMATION_TIMING=N,exports.POPUP_TRANSITION=I;

package/dist/cjs/components/feature-announcements/constants/dimensions.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Popup dimension constants
+ */
+export declare const POPUP_DIMENSIONS: {
+    readonly MAJOR: {
+        readonly width: 959;
+        readonly height: 274;
+        readonly imageWidth: 480;
+        readonly imageHeight: 274;
+        readonly imageInnerWidth: 464;
+        readonly imageInnerHeight: 258;
+        readonly imagePlaceholderWidth: 290;
+        readonly imagePlaceholderHeight: 258;
+    };
+    readonly MINOR: {
+        readonly width: 519;
+        readonly height: 160;
+        readonly imageWidth: 235;
+        readonly imageHeight: 134;
+        readonly badgeHeight: 27;
+    };
+};
+/**
+ * Spacing constants
+ */
+export declare const SPACING: {
+    readonly MAJOR: {
+        readonly contentMargin: "0 8px 0 0";
+        readonly imagePadding: "8px";
+        readonly titlePadding: "36px 0 0 0";
+        readonly buttonMarginTop: "16px";
+        readonly skipButtonTop: "10px";
+        readonly skipButtonRight: "10px";
+        readonly navigationBottom: "16px";
+        readonly navigationRight: "16px";
+        readonly navigationGap: "8px";
+    };
+    readonly MINOR: {
+        readonly imageMargin: "13px 10px 13px 10px";
+        readonly contentMargin: "13px 13px 13px 3px";
+        readonly actionsBottom: "13px";
+        readonly actionsRight: "10px";
+        readonly actionsGap: "16px";
+    };
+};
+/**
+ * Border radius constants
+ */
+export declare const BORDER_RADIUS: {
+    readonly POPUP: "4px";
+    readonly IMAGE: "4px";
+    readonly BUTTON: "4px";
+    readonly VIDEO_MODAL: "12px";
+    readonly CLOSE_BUTTON: "50%";
+    readonly SPOTLIGHT: "8px";
+};

package/dist/cjs/components/feature-announcements/constants/dimensions.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.BORDER_RADIUS={POPUP:"4px",IMAGE:"4px",BUTTON:"4px",VIDEO_MODAL:"12px",CLOSE_BUTTON:"50%",SPOTLIGHT:"8px"},exports.POPUP_DIMENSIONS={MAJOR:{width:959,height:274,imageWidth:480,imageHeight:274,imageInnerWidth:464,imageInnerHeight:258,imagePlaceholderWidth:290,imagePlaceholderHeight:258},MINOR:{width:519,height:160,imageWidth:235,imageHeight:134,badgeHeight:27}},exports.SPACING={MAJOR:{contentMargin:"0 8px 0 0",imagePadding:"8px",titlePadding:"36px 0 0 0",buttonMarginTop:"16px",skipButtonTop:"10px",skipButtonRight:"10px",navigationBottom:"16px",navigationRight:"16px",navigationGap:"8px"},MINOR:{imageMargin:"13px 10px 13px 10px",contentMargin:"13px 13px 13px 3px",actionsBottom:"13px",actionsRight:"10px",actionsGap:"16px"}};

package/dist/cjs/components/feature-announcements/constants/index.d.ts

@@ -0,0 +1,19 @@
+export * from './animations';
+export * from './dimensions';
+export * from './selectors';
+export * from './zIndex';
+export * from './localStorageKeys';
+/**
+ * Text constants
+ */
+export declare const TEXT: {
+    readonly DEFAULT_BUTTON_TEXT: "Explore the feature";
+    readonly SKIP_BUTTON: "Skip";
+    readonly UNDERSTOOD: "Understood";
+    readonly NEW_FEATURE_BADGE: "New feature";
+    readonly FEATURE_PREVIEW_PLACEHOLDER: "Feature Preview";
+    readonly NO_VIDEO_AVAILABLE: "No video available";
+    readonly VIDEO_MODAL_TITLE: "Product Video";
+    readonly NAVIGATION_PREVIOUS: "‹";
+    readonly NAVIGATION_NEXT: "›";
+};

package/dist/cjs/components/feature-announcements/constants/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./animations.js");exports.ANIMATION_EASING=e.ANIMATION_EASING,exports.ANIMATION_TIMING=e.ANIMATION_TIMING,exports.POPUP_TRANSITION=e.POPUP_TRANSITION,exports.TEXT={DEFAULT_BUTTON_TEXT:"Explore the feature",SKIP_BUTTON:"Skip",UNDERSTOOD:"Understood",NEW_FEATURE_BADGE:"New feature",FEATURE_PREVIEW_PLACEHOLDER:"Feature Preview",NO_VIDEO_AVAILABLE:"No video available",VIDEO_MODAL_TITLE:"Product Video",NAVIGATION_PREVIOUS:"‹",NAVIGATION_NEXT:"›"};

package/dist/cjs/components/feature-announcements/constants/localStorageKeys.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Local storage keys for feature announcements
+ */
+export declare const LOCAL_STORAGE_KEYS: {
+    readonly STORE_ID: "storeId";
+    readonly BIK_STORE_ID: "Bik/StoreId";
+    readonly CURRENT_STORE: "currentStore";
+    readonly STORE: "store";
+    readonly CURRENT_USER: "Bik/CurrentUser";
+    readonly QUERY_PARAM: "storeId";
+};
+/**
+ * URL query parameters
+ */
+export declare const QUERY_PARAMS: {
+    readonly FEATURE_ID: "featureId";
+    readonly STORE_ID: "storeId";
+};

package/dist/cjs/components/feature-announcements/constants/localStorageKeys.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.LOCAL_STORAGE_KEYS={STORE_ID:"storeId",BIK_STORE_ID:"Bik/StoreId",CURRENT_STORE:"currentStore",STORE:"store",CURRENT_USER:"Bik/CurrentUser",QUERY_PARAM:"storeId"},exports.QUERY_PARAMS={FEATURE_ID:"featureId",STORE_ID:"storeId"};

package/dist/cjs/components/feature-announcements/constants/selectors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CSS selectors for feature announcements
+ */
+export declare const SELECTORS: {
+    readonly WHATS_NEW_BUTTON: "[data-testid=\"whats-new-button\"]";
+    readonly MAIN_ICON_CLASS: ".main-icon-class";
+    readonly SVG_VIEWBOX: "svg[viewBox=\"0 0 32 32\"]";
+    readonly CLIPPATH_PATTERN: "clipPath[id*=\"clip\"]";
+    readonly JOYRIDE_TOOLTIP: "[class*=\"react-joyride__tooltip\"]";
+    readonly JOYRIDE_ARROW: "[class*=\"react-joyride__arrow\"]";
+    readonly JOYRIDE_SPOTLIGHT: ".react-joyride__spotlight";
+};
+/**
+ * Data test IDs
+ */
+export declare const TEST_IDS: {
+    readonly WHATS_NEW_BUTTON: "whats-new-button";
+    readonly MAJOR_POPUP: "major-update-popup";
+    readonly MINOR_POPUP: "minor-update-popup";
+    readonly VIDEO_MODAL: "video-modal";
+};

package/dist/cjs/components/feature-announcements/constants/selectors.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.SELECTORS={WHATS_NEW_BUTTON:'[data-testid="whats-new-button"]',MAIN_ICON_CLASS:".main-icon-class",SVG_VIEWBOX:'svg[viewBox="0 0 32 32"]',CLIPPATH_PATTERN:'clipPath[id*="clip"]',JOYRIDE_TOOLTIP:'[class*="react-joyride__tooltip"]',JOYRIDE_ARROW:'[class*="react-joyride__arrow"]',JOYRIDE_SPOTLIGHT:".react-joyride__spotlight"};

package/dist/cjs/components/feature-announcements/constants/zIndex.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Z-index constants
+ */
+export declare const Z_INDEX: {
+    readonly JOYRIDE: 10000;
+    readonly VIDEO_MODAL: 2000;
+    readonly SKIP_BUTTON: 10;
+    readonly IMAGE_BADGE: 10;
+    readonly CLOSE_BUTTON: 10;
+};

package/dist/cjs/components/feature-announcements/constants/zIndex.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.Z_INDEX={JOYRIDE:1e4,VIDEO_MODAL:2e3,SKIP_BUTTON:10,IMAGE_BADGE:10,CLOSE_BUTTON:10};

package/dist/cjs/components/feature-announcements/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useFeatureAnnouncements } from './useFeatureAnnouncements';

package/dist/cjs/components/feature-announcements/hooks/useFeatureAnnouncements.d.ts

@@ -0,0 +1,13 @@
+import { FeatureAnnouncement, FeatureAnnouncementRepository, RouterProps } from '../types';
+export declare const useFeatureAnnouncements: ({ fetchVisibleFeatures, getStoreFeatureProgress, fetchFeatureById, markFeatureAsViewedForStore, isFeatureApplicableToCurrentPage, module, router, }: FeatureAnnouncementRepository & {
+    module?: string | undefined;
+    router?: RouterProps | undefined;
+}) => {
+    features: FeatureAnnouncement[];
+    majorUpdateFeatures: FeatureAnnouncement[];
+    minorUpdateFeatures: FeatureAnnouncement[];
+    isLoading: boolean;
+    error: string | null;
+    markFeatureAsViewed: (featureId: string) => Promise<void>;
+    refetch: () => Promise<void>;
+};

package/dist/cjs/components/feature-announcements/hooks/useFeatureAnnouncements.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../../../_virtual/_tslib.js"),t=require("react"),r=require("../constants/animations.js"),a=require("../constants/localStorageKeys.js");exports.useFeatureAnnouncements=i=>{let{fetchVisibleFeatures:o,getStoreFeatureProgress:n,fetchFeatureById:l,markFeatureAsViewedForStore:u,isFeatureApplicableToCurrentPage:s,module:c,router:d}=i;var f;const p=(()=>{const[e,r]=t.useState(null);return t.useEffect((()=>{if("undefined"!=typeof window){let e=null;try{if(e=localStorage.getItem(a.LOCAL_STORAGE_KEYS.STORE_ID)||localStorage.getItem(a.LOCAL_STORAGE_KEYS.BIK_STORE_ID)||localStorage.getItem(a.LOCAL_STORAGE_KEYS.CURRENT_STORE)||localStorage.getItem(a.LOCAL_STORAGE_KEYS.STORE),!e){const t=localStorage.getItem(a.LOCAL_STORAGE_KEYS.CURRENT_USER);t&&(e=JSON.parse(t).storeId)}e||(e=new URLSearchParams(window.location.search).get(a.LOCAL_STORAGE_KEYS.QUERY_PARAM))}catch(e){}r(e)}}),[]),e})(),[S,_]=t.useState([]),[A,E]=t.useState([]),[g,v]=t.useState([]),[y,R]=t.useState(!1),[T,U]=t.useState(null),D=t.useCallback((()=>e.__awaiter(void 0,void 0,void 0,(function*(){if(p){R(!0),U(null);try{const[e,t]=yield o(c);if(e||!t)return void U("Failed to fetch features");const[a,i]=yield n(p),l=new Date,u="undefined"!=typeof window?window.location.pathname:"",d=e=>{if(!e.expirationDate)return!0;let t;return"object"==typeof e.expirationDate&&null!==e.expirationDate&&("seconds"in e.expirationDate||"nanoseconds"in e.expirationDate)?t=new Date(1e3*e.expirationDate.seconds):"string"==typeof e.expirationDate?t=new Date(e.expirationDate):e.expirationDate instanceof Date&&(t=e.expirationDate),!(!t||isNaN(t.getTime()))&&l<t},f=e=>{if("Major"===e.featureUpdateType){let t=[];return Array.isArray(e.pageUrls)?t=e.pageUrls:"object"==typeof e.pageUrls&&null!==e.pageUrls&&"length"in e.pageUrls&&(t=Array.from(e.pageUrls)),t.some((e=>{if(e===u)return!0;const t=e.replace(/\[([^\]]+)\]/g,"[^/]+").replace(/\//g,"\\/");return new RegExp(`^${t}$`).test(u)}))}return!0},S=t.filter((e=>{var t;const r=(null===(t=null==i?void 0:i.viewedFeatures)||void 0===t?void 0:t[e.id])||!1,a=e.archived||!1,o=s(e),n=d(e),l=f(e);return!r&&!a&&o&&n&&l})),A=S.filter((e=>"Major"===e.featureUpdateType)),g=S.filter((e=>"Minor"===e.featureUpdateType));_(S),E(A),setTimeout((()=>{v(g)}),r.ANIMATION_TIMING.MINOR_POPUP_DELAY)}catch(e){U("An unexpected error occurred")}finally{R(!1)}}}))),[p,o,n,s,c]),O=t.useCallback((t=>e.__awaiter(void 0,void 0,void 0,(function*(){R(!0),U(null);try{const[e,r]=yield l(t);if(e||!r)return void U("Failed to fetch feature by ID");"Major"===r.featureUpdateType?E([r]):v([r]),_([r])}catch(e){U("An unexpected error occurred while fetching by ID")}finally{R(!1)}}))),[l]),w=t.useCallback((t=>e.__awaiter(void 0,void 0,void 0,(function*(){if(!p)return;const[e]=yield u(p,t);_((e=>e.filter((e=>e.id!==t)))),E((e=>e.filter((e=>e.id!==t)))),v((e=>e.filter((e=>e.id!==t))))}))),[p,u]);return t.useEffect((()=>{var e;const t=null===(e=null==d?void 0:d.query)||void 0===e?void 0:e[a.QUERY_PARAMS.FEATURE_ID];t&&d?O(t):D()}),[null==d?void 0:d.pathname,null===(f=null==d?void 0:d.query)||void 0===f?void 0:f[a.QUERY_PARAMS.FEATURE_ID],p,D,O,d]),{features:S,majorUpdateFeatures:A,minorUpdateFeatures:g,isLoading:y,error:T,markFeatureAsViewed:w,refetch:D}};

package/dist/cjs/components/feature-announcements/index.d.ts

@@ -0,0 +1,7 @@
+export { default as FeatureAnnouncementProvider } from './FeatureAnnouncementProvider';
+export { default as MajorUpdatePopup } from './MajorUpdatePopup';
+export { default as MinorUpdatePopup } from './MinorUpdatePopup';
+export { VideoModal } from './VideoModal';
+export { useFeatureAnnouncements } from './hooks/useFeatureAnnouncements';
+export * from './types';
+export { TEXT, ANIMATION_TIMING, POPUP_DIMENSIONS } from './constants';

package/dist/cjs/components/feature-announcements/styles/index.d.ts

@@ -0,0 +1,4 @@
+export * from './majorPopup.styles';
+export * from './minorPopup.styles';
+export * from './videoModal.styles';
+export * from './joyride.styles';

package/dist/cjs/components/feature-announcements/styles/joyride.styles.d.ts

@@ -0,0 +1,125 @@
+export declare const majorStepStyles: {
+    tooltip: {
+        padding: number;
+        backgroundColor: string;
+        borderRadius: string;
+        border: string;
+        filter: string;
+        boxShadow: string;
+    };
+    tooltipContent: {
+        padding: number;
+    };
+    buttonNext: {
+        display: string;
+    };
+    buttonBack: {
+        display: string;
+    };
+    buttonClose: {
+        display: string;
+    };
+    buttonSkip: {
+        display: string;
+    };
+};
+export declare const minorStepStyles: {
+    tooltip: {
+        padding: number;
+        backgroundColor: string;
+        borderRadius: "4px";
+        border: string;
+        filter: string;
+        boxShadow: string;
+    };
+    tooltipContent: {
+        padding: number;
+    };
+    buttonNext: {
+        display: string;
+    };
+    buttonBack: {
+        display: string;
+    };
+    buttonClose: {
+        display: string;
+    };
+    buttonSkip: {
+        display: string;
+    };
+};
+export declare const getMajorJoyrideStyles: (isClosing: boolean) => {
+    options: {
+        arrowColor: string;
+        backgroundColor: string;
+        overlayColor: string;
+        primaryColor: string;
+        textColor: string;
+        zIndex: 10000;
+    };
+    tooltip: {
+        padding: number;
+        backgroundColor: string;
+        borderRadius: string;
+        border: string;
+        filter: string;
+        boxShadow: string;
+        position: "fixed";
+        top: string;
+        left: string;
+        transform: string;
+    };
+    tooltipContent: {
+        padding: number;
+    };
+    buttonNext: {
+        display: string;
+    };
+    buttonBack: {
+        display: string;
+    };
+    buttonClose: {
+        display: string;
+    };
+    buttonSkip: {
+        display: string;
+    };
+};
+export declare const getMinorJoyrideStyles: (isClosing: boolean) => {
+    options: {
+        arrowColor: string;
+        backgroundColor: string;
+        overlayColor: string;
+        primaryColor: string;
+        textColor: string;
+        zIndex: 10000;
+    };
+    spotlight: {
+        boxShadow: string;
+        borderRadius: "8px";
+    };
+    tooltip: {
+        padding: number;
+        backgroundColor: string;
+        borderRadius: "4px";
+        border: string;
+        filter: string;
+        boxShadow: string;
+        maxWidth: string;
+    };
+    tooltipContent: {
+        padding: number;
+    };
+    buttonNext: {
+        display: string;
+    };
+    buttonBack: {
+        display: string;
+    };
+    buttonClose: {
+        display: string;
+    };
+    buttonSkip: {
+        display: string;
+    };
+};

package/dist/cjs/components/feature-announcements/styles/majorPopup.styles.d.ts

@@ -0,0 +1,23 @@
+import { CSSProperties } from 'react';
+export declare const getMajorPopupStyles: (startAnimation: boolean, transform: string) => {
+    container: CSSProperties;
+    skipButton: {
+        base: CSSProperties;
+        hover: CSSProperties;
+    };
+    imageContainer: CSSProperties;
+    image: CSSProperties;
+    imagePlaceholder: CSSProperties;
+    contentContainer: CSSProperties;
+    title: CSSProperties;
+    content: CSSProperties;
+    exploreButton: {
+        base: CSSProperties;
+        hover: CSSProperties;
+    };
+    navigationContainer: CSSProperties;
+    navigationButton: (disabled: boolean) => {
+        base: CSSProperties;
+        hover: CSSProperties;
+    };
+};

package/dist/cjs/components/feature-announcements/styles/majorPopup.styles.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../../../constants/Theme.js"),t=require("../constants/animations.js"),n=require("../constants/dimensions.js"),i=require("../constants/zIndex.js");exports.getMajorPopupStyles=(o,r)=>({container:{width:`${n.POPUP_DIMENSIONS.MAJOR.width}px`,height:`${n.POPUP_DIMENSIONS.MAJOR.height}px`,display:"flex",backgroundColor:e.BASE_COLORS.grayscale[900],borderRadius:n.BORDER_RADIUS.POPUP,overflow:"hidden",position:"relative",transform:o?r:"scale(1)",opacity:o?0:1,transition:t.POPUP_TRANSITION},skipButton:{base:{position:"absolute",top:n.SPACING.MAJOR.skipButtonTop,right:n.SPACING.MAJOR.skipButtonRight,background:"transparent",border:"none",color:e.BASE_COLORS.grayscale[400],fontSize:"14px",fontWeight:"500",cursor:"pointer",zIndex:i.Z_INDEX.SKIP_BUTTON,transition:"all 0.2s"},hover:{backgroundColor:e.BASE_COLORS.grayscale[100],color:e.BASE_COLORS.grayscale[700]}},imageContainer:{backgroundColor:e.BASE_COLORS.grayscale[900],width:`${n.POPUP_DIMENSIONS.MAJOR.imageWidth}px`,height:`${n.POPUP_DIMENSIONS.MAJOR.imageHeight}px`,position:"relative",display:"flex",alignItems:"center",justifyContent:"center",padding:n.SPACING.MAJOR.imagePadding},image:{width:`${n.POPUP_DIMENSIONS.MAJOR.imageInnerWidth}px`,height:`${n.POPUP_DIMENSIONS.MAJOR.imageInnerHeight}px`,objectFit:"cover"},imagePlaceholder:{color:e.BASE_COLORS.grayscale[500],fontSize:"14px",textAlign:"center",width:`${n.POPUP_DIMENSIONS.MAJOR.imagePlaceholderWidth}px`,height:`${n.POPUP_DIMENSIONS.MAJOR.imagePlaceholderHeight}px`,display:"flex",alignItems:"center",justifyContent:"center"},contentContainer:{flex:1,display:"flex",margin:n.SPACING.MAJOR.contentMargin,flexDirection:"column",justifyContent:"space-between",background:"transparent"},title:{fontSize:"16px",fontWeight:"600",padding:n.SPACING.MAJOR.titlePadding,color:e.BASE_COLORS.grayscale.white,lineHeight:"1.25",textAlign:"left"},content:{fontSize:"14px",lineHeight:"1.5",color:"rgba(255, 255, 255, 0.8)",textAlign:"left"},exploreButton:{base:{backgroundColor:"transparent",border:`1px solid ${e.BASE_COLORS.warning[500]}`,color:e.BASE_COLORS.warning[500],borderRadius:n.BORDER_RADIUS.BUTTON,fontSize:"14px",fontWeight:"600",cursor:"pointer",width:"154px",height:"32px",transition:"all 0.2s",textAlign:"center",display:"flex",alignItems:"center",justifyContent:"center",marginTop:n.SPACING.MAJOR.buttonMarginTop},hover:{backgroundColor:"rgba(254, 192, 45, 0.1)"}},navigationContainer:{position:"absolute",bottom:n.SPACING.MAJOR.navigationBottom,right:n.SPACING.MAJOR.navigationRight,display:"flex",gap:n.SPACING.MAJOR.navigationGap,alignItems:"center"},navigationButton:t=>({base:{width:"24px",height:"24px",backgroundColor:"transparent",border:"none",color:t?e.BASE_COLORS.grayscale[700]:e.BASE_COLORS.grayscale.white,fontSize:"20px",cursor:t?"not-allowed":"pointer",display:"flex",alignItems:"center",justifyContent:"center",transition:"all 0.2s"},hover:{color:e.BASE_COLORS.warning[500]}})});

package/dist/cjs/components/feature-announcements/styles/minorPopup.styles.d.ts

@@ -0,0 +1,16 @@
+import { CSSProperties } from 'react';
+export declare const getMinorPopupStyles: (startAnimation: boolean, transform: string) => {
+    container: CSSProperties;
+    imageContainer: CSSProperties;
+    imageWrapper: CSSProperties;
+    image: CSSProperties;
+    badge: CSSProperties;
+    badgeText: CSSProperties;
+    imagePlaceholder: CSSProperties;
+    contentContainer: CSSProperties;
+    title: CSSProperties;
+    content: CSSProperties;
+    actionsContainer: CSSProperties;
+    understoodText: CSSProperties;
+    exploreButton: CSSProperties;
+};

package/dist/cjs/components/feature-announcements/styles/minorPopup.styles.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../../../constants/Theme.js"),t=require("../constants/animations.js"),i=require("../constants/dimensions.js"),o=require("../constants/zIndex.js");exports.getMinorPopupStyles=(n,a)=>({container:{width:`${i.POPUP_DIMENSIONS.MINOR.width}px`,height:`${i.POPUP_DIMENSIONS.MINOR.height}px`,display:"flex",backgroundColor:e.BASE_COLORS.grayscale.white,borderRadius:i.BORDER_RADIUS.POPUP,overflow:"hidden",position:"relative",boxShadow:"0 20px 25px rgba(0, 0, 0, 0.1), 0 10px 10px rgba(0, 0, 0, 0.04)",transform:n?a:"scale(1)",opacity:n?0:1,transition:t.POPUP_TRANSITION},imageContainer:{backgroundColor:e.BASE_COLORS.grayscale[50],borderRadius:i.BORDER_RADIUS.IMAGE,position:"relative",display:"flex",alignItems:"center",justifyContent:"center",margin:i.SPACING.MINOR.imageMargin,width:`${i.POPUP_DIMENSIONS.MINOR.imageWidth}px`,minWidth:`${i.POPUP_DIMENSIONS.MINOR.imageWidth}px`,maxWidth:`${i.POPUP_DIMENSIONS.MINOR.imageWidth}px`,height:`${i.POPUP_DIMENSIONS.MINOR.imageHeight}px`},imageWrapper:{position:"relative",width:`${i.POPUP_DIMENSIONS.MINOR.imageWidth}px`,height:`${i.POPUP_DIMENSIONS.MINOR.imageHeight}px`},image:{width:`${i.POPUP_DIMENSIONS.MINOR.imageWidth}px`,height:`${i.POPUP_DIMENSIONS.MINOR.imageHeight}px`,objectFit:"cover",borderRadius:i.BORDER_RADIUS.IMAGE,display:"block"},badge:{position:"absolute",top:"0px",left:"0px",right:"0px",height:`${i.POPUP_DIMENSIONS.MINOR.badgeHeight}px`,backgroundColor:"rgba(0, 0, 0, 0.26)",borderRadius:`${i.BORDER_RADIUS.IMAGE} ${i.BORDER_RADIUS.IMAGE} ${i.BORDER_RADIUS.IMAGE} ${i.BORDER_RADIUS.IMAGE}`,display:"flex",alignItems:"center",justifyContent:"center",zIndex:o.Z_INDEX.IMAGE_BADGE},badgeText:{color:e.BASE_COLORS.grayscale.white,fontWeight:"600",fontSize:"14px"},imagePlaceholder:{color:e.BASE_COLORS.grayscale[500],fontSize:"14px",textAlign:"center",width:"100%",height:"100%",display:"flex",alignItems:"center",justifyContent:"center",backgroundColor:e.BASE_COLORS.grayscale[100],borderRadius:i.BORDER_RADIUS.IMAGE},contentContainer:{flex:1,display:"flex",margin:i.SPACING.MINOR.contentMargin,flexDirection:"column",justifyContent:"space-between",background:"transparent"},title:{fontSize:"16px",fontWeight:"600",padding:"0 0 0 0",color:e.BASE_COLORS.grayscale[900],lineHeight:"1.25",textAlign:"left"},content:{fontSize:"12px",fontWeight:"400",lineHeight:"1.2",color:e.BASE_COLORS.grayscale[700],textAlign:"left",maxHeight:"48px",overflow:"hidden",display:"-webkit-box",WebkitLineClamp:3,WebkitBoxOrient:"vertical"},actionsContainer:{position:"absolute",bottom:i.SPACING.MINOR.actionsBottom,right:i.SPACING.MINOR.actionsRight,display:"flex",gap:i.SPACING.MINOR.actionsGap,alignItems:"center"},understoodText:{color:e.BASE_COLORS.brand[800],fontSize:"14px",fontWeight:"500",cursor:"pointer",transition:"all 0.2s"},exploreButton:{backgroundColor:e.BASE_COLORS.brand[800],border:"none",color:e.BASE_COLORS.grayscale.white,borderRadius:i.BORDER_RADIUS.BUTTON,fontSize:"14px",fontWeight:"600",cursor:"pointer",width:"154px",height:"32px",transition:"all 0.2s",textAlign:"center",display:"flex",alignItems:"center",justifyContent:"center"}});

package/dist/cjs/components/feature-announcements/styles/videoModal.styles.d.ts

@@ -0,0 +1,13 @@
+import { CSSProperties } from 'react';
+export declare const videoModalStyles: {
+    backdrop: CSSProperties;
+    container: CSSProperties;
+    closeButton: {
+        base: CSSProperties;
+        hover: CSSProperties;
+    };
+    videoWrapper: CSSProperties;
+    iframe: CSSProperties;
+    video: CSSProperties;
+    noVideoMessage: CSSProperties;
+};

package/dist/cjs/components/feature-announcements/styles/videoModal.styles.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),require("../constants/animations.js");var e=require("../constants/dimensions.js"),t=require("../constants/zIndex.js");const o={backdrop:{position:"fixed",top:0,left:0,right:0,bottom:0,backgroundColor:"rgba(0, 0, 0, 0.9)",zIndex:t.Z_INDEX.VIDEO_MODAL,display:"flex",justifyContent:"center",alignItems:"center",padding:"20px"},container:{position:"relative",width:"90vw",height:"90vh",maxWidth:"1200px",maxHeight:"800px",backgroundColor:"black",borderRadius:e.BORDER_RADIUS.VIDEO_MODAL,overflow:"hidden",boxShadow:"0 25px 50px rgba(0, 0, 0, 0.8)"},closeButton:{base:{position:"absolute",top:"20px",right:"20px",background:"rgba(0, 0, 0, 0.7)",border:"none",color:"white",fontSize:"24px",width:"40px",height:"40px",borderRadius:e.BORDER_RADIUS.CLOSE_BUTTON,cursor:"pointer",display:"flex",alignItems:"center",justifyContent:"center",zIndex:t.Z_INDEX.CLOSE_BUTTON,transition:"background-color 0.2s"},hover:{backgroundColor:"rgba(0, 0, 0, 0.9)"}},videoWrapper:{width:"100%",height:"100%",display:"flex",alignItems:"center",justifyContent:"center"},iframe:{borderRadius:e.BORDER_RADIUS.VIDEO_MODAL},video:{width:"100%",height:"100%",objectFit:"contain",borderRadius:e.BORDER_RADIUS.VIDEO_MODAL},noVideoMessage:{color:"white",fontSize:"18px",textAlign:"center"}};exports.videoModalStyles=o;

package/dist/cjs/components/feature-announcements/types/feature.types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Firestore Timestamp type
+ */
+export interface FirestoreTimestamp {
+    seconds: number;
+    nanoseconds?: number;
+}
+/**
+ * Feature announcement data model
+ */
+export interface FeatureAnnouncement {
+    id: string;
+    title: string;
+    body: string;
+    content: string;
+    buttonText: string;
+    displayImage: string;
+    featureTag: string;
+    featureUpdateType: 'Major' | 'Minor';
+    image: string;
+    module: string[];
+    pageUrls: string[];
+    productVideo: string;
+    redirectUrl: string;
+    updates: string;
+    visibility: boolean;
+    archived?: boolean;
+    createdAt: FirestoreTimestamp;
+    expirationDate?: FirestoreTimestamp | string | Date;
+}
+/**
+ * Store feature progress tracking
+ */
+export interface StoreFeatureProgress {
+    storeId: string;
+    viewedFeatures: Record<string, boolean>;
+}
+/**
+ * Feature update types
+ */
+export type FeatureUpdateType = 'Major' | 'Minor';

package/dist/cjs/components/feature-announcements/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './feature.types';
+export * from './props.types';
+export * from './repository.types';
+export * from './router.types';

package/dist/cjs/components/feature-announcements/types/props.types.d.ts

@@ -0,0 +1,43 @@
+/// <reference types="react" />
+import { FeatureAnnouncement } from './feature.types';
+import { FeatureAnnouncementRepository } from './repository.types';
+import { RouterProps } from './router.types';
+/**
+ * Base popup component props
+ */
+export interface PopupBaseProps {
+    feature: FeatureAnnouncement;
+    currentIndex: number;
+    totalFeatures: number;
+    onSkip: () => void;
+    onExplore: () => void;
+    onPrevious: () => void;
+    onNext: () => void;
+    setIsClosing?: (isClosing: boolean) => void;
+}
+/**
+ * Major update popup props
+ */
+export interface MajorUpdatePopupProps extends PopupBaseProps {
+}
+/**
+ * Minor update popup props
+ */
+export interface MinorUpdatePopupProps extends PopupBaseProps {
+}
+/**
+ * Video modal props
+ */
+export interface VideoModalProps {
+    isOpen: boolean;
+    videoUrl: string;
+    onClose: () => void;
+}
+/**
+ * Feature announcement provider props
+ */
+export interface FeatureAnnouncementProviderProps extends FeatureAnnouncementRepository {
+    children: React.ReactNode;
+    module?: string;
+    router?: RouterProps;
+}

package/dist/cjs/components/feature-announcements/types/repository.types.d.ts

@@ -0,0 +1,11 @@
+import { FeatureAnnouncement, StoreFeatureProgress } from './feature.types';
+/**
+ * Repository function types for dependency injection
+ */
+export interface FeatureAnnouncementRepository {
+    fetchVisibleFeatures: (module?: string) => Promise<[Error | null, FeatureAnnouncement[] | null]>;
+    getStoreFeatureProgress: (storeId: string) => Promise<[Error | null, StoreFeatureProgress | null]>;
+    fetchFeatureById: (featureId: string) => Promise<[Error | null, FeatureAnnouncement | null]>;
+    markFeatureAsViewedForStore: (storeId: string, featureId: string) => Promise<[Error | null]>;
+    isFeatureApplicableToCurrentPage: (feature: FeatureAnnouncement) => boolean;
+}

package/dist/cjs/components/feature-announcements/types/router.types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Router properties
+ */
+export interface RouterProps {
+    pathname: string;
+    query: Record<string, string | string[] | undefined>;
+}

package/dist/cjs/components/feature-announcements/useFeatureAnnouncements.d.ts

@@ -0,0 +1,13 @@
+import { FeatureAnnouncement, FeatureAnnouncementRepository, RouterProps } from './types';
+export declare const useFeatureAnnouncements: ({ fetchVisibleFeatures, getStoreFeatureProgress, fetchFeatureById, markFeatureAsViewedForStore, isFeatureApplicableToCurrentPage, module, router, }: FeatureAnnouncementRepository & {
+    module?: string | undefined;
+    router?: RouterProps | undefined;
+}) => {
+    features: FeatureAnnouncement[];
+    majorUpdateFeatures: FeatureAnnouncement[];
+    minorUpdateFeatures: FeatureAnnouncement[];
+    isLoading: boolean;
+    error: string | null;
+    markFeatureAsViewed: (featureId: string) => Promise<void>;
+    refetch: () => Promise<void>;
+};

package/dist/cjs/components/feature-announcements/utils/animationHelpers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Calculate transform for closing animation
+ * @param popupElement - Popup element reference
+ * @param targetElement - Target element to animate towards
+ * @returns Transform CSS string
+ */
+export declare const calculateCloseTransform: (popupElement: HTMLElement, targetElement: Element) => string;
+/**
+ * Hide Joyride arrow element
+ * @param popupRef - Reference to popup element
+ */
+export declare const hideJoyrideArrow: (popupRef: HTMLElement | null) => void;
+/**
+ * Execute callback after animation completes
+ * @param callback - Function to execute
+ * @param delay - Optional delay override
+ */
+export declare const executeAfterAnimation: (callback: () => void, delay?: number) => void;

package/dist/cjs/components/feature-announcements/utils/animationHelpers.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../constants/animations.js");exports.calculateCloseTransform=(e,t)=>{const i=e.getBoundingClientRect(),o=t.getBoundingClientRect();return`translate(${o.left+o.width/2-(i.left+i.width/2)}px, ${o.top+o.height/2-(i.top+i.height/2)}px) scale(0)`},exports.executeAfterAnimation=function(t){let i=arguments.length>1&&void 0!==arguments[1]?arguments[1]:e.ANIMATION_TIMING.CLOSE_DURATION;setTimeout(t,i)},exports.hideJoyrideArrow=e=>{if(!e)return;const t=e.closest('[class*="react-joyride__tooltip"]');if(!t)return;const i=t.querySelector('[class*="react-joyride__arrow"]');i&&(i.style.display="none",i.style.visibility="hidden",i.style.opacity="0")};

package/dist/cjs/components/feature-announcements/utils/elementHelpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Find What's New button using multiple strategies
+ * @returns Element or null
+ */
+export declare const findWhatsNewButton: () => Element | null;
+/**
+ * Find target element for minor update
+ * @param featureTag - Feature tag selector
+ * @returns Element or null
+ */
+export declare const findFeatureTagElement: (featureTag: string) => Element | null;
+/**
+ * Normalize selector string
+ * @param selector - Selector string
+ * @returns Normalized selector
+ */
+export declare const normalizeSelector: (selector: string) => string;
+/**
+ * Check if element is fully visible in viewport
+ * @param element - Element to check
+ * @returns True if element is fully visible
+ */
+export declare const isElementInViewport: (element: Element) => boolean;
+/**
+ * Scroll to element smoothly with offset
+ * @param element - Element to scroll to
+ * @param offset - Offset from top (default 120px for popup space)
+ * @returns Promise that resolves when scroll completes
+ */
+export declare const scrollToElementSmooth: (element: Element, offset?: number) => Promise<void>;

package/dist/cjs/components/feature-announcements/utils/elementHelpers.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),require("../constants/animations.js");var e=require("../constants/selectors.js");const t=e=>{const t=e.getBoundingClientRect(),o=window.innerHeight||document.documentElement.clientHeight,n=window.innerWidth||document.documentElement.clientWidth,r=t.top>=120&&t.bottom<=o,s=t.left>=0&&t.right<=n;return r&&s};exports.findFeatureTagElement=e=>{const t=e.startsWith("#")||e.startsWith(".")||e.startsWith("[")?e:`#${e}`;return document.querySelector(t)},exports.findWhatsNewButton=()=>{let t=document.querySelector(e.SELECTORS.WHATS_NEW_BUTTON);if(t)return t;if(t=document.querySelector(e.SELECTORS.MAIN_ICON_CLASS),t)return t;const o=document.querySelector(e.SELECTORS.SVG_VIEWBOX);if(o){if(o.querySelector(e.SELECTORS.CLIPPATH_PATTERN))return o.closest(e.SELECTORS.WHATS_NEW_BUTTON)||o.parentElement}return null},exports.isElementInViewport=t,exports.normalizeSelector=e=>e.startsWith("#")||e.startsWith(".")||e.startsWith("[")?e:`#${e}`,exports.scrollToElementSmooth=function(e){let o=arguments.length>1&&void 0!==arguments[1]?arguments[1]:120;return new Promise((n=>{if(t(e))return void n();const r=e.getBoundingClientRect().top+window.pageYOffset-o;let s;window.scrollTo({top:r,behavior:"smooth"});const i=()=>{clearTimeout(s),s=setTimeout((()=>{window.removeEventListener("scroll",i),setTimeout((()=>n()),100)}),100)};window.addEventListener("scroll",i,{passive:!0}),setTimeout((()=>{window.removeEventListener("scroll",i),n()}),1e3)}))};