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

package/dist/esm/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/esm/components/feature-announcements/constants/dimensions.js

@@ -0,0 +1 @@
+const i={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}},t={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"}},p={POPUP:"4px",IMAGE:"4px",BUTTON:"4px",VIDEO_MODAL:"12px",CLOSE_BUTTON:"50%",SPOTLIGHT:"8px"};export{p as BORDER_RADIUS,i as POPUP_DIMENSIONS,t as SPACING};

package/dist/esm/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/esm/components/feature-announcements/constants/index.js

@@ -0,0 +1 @@
+export{ANIMATION_EASING,ANIMATION_TIMING,POPUP_TRANSITION}from"./animations.js";const E={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:"›"};export{E as TEXT};

package/dist/esm/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/esm/components/feature-announcements/constants/localStorageKeys.js

@@ -0,0 +1 @@
+const r={STORE_ID:"storeId",BIK_STORE_ID:"Bik/StoreId",CURRENT_STORE:"currentStore",STORE:"store",CURRENT_USER:"Bik/CurrentUser",QUERY_PARAM:"storeId"},R={FEATURE_ID:"featureId",STORE_ID:"storeId"};export{r as LOCAL_STORAGE_KEYS,R as QUERY_PARAMS};

package/dist/esm/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/esm/components/feature-announcements/constants/selectors.js

@@ -0,0 +1 @@
+const t={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"};export{t as SELECTORS};

package/dist/esm/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/esm/components/feature-announcements/constants/zIndex.js

@@ -0,0 +1 @@
+const O={JOYRIDE:1e4,VIDEO_MODAL:2e3,SKIP_BUTTON:10,IMAGE_BADGE:10,CLOSE_BUTTON:10};export{O as Z_INDEX};

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

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

package/dist/esm/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/esm/components/feature-announcements/hooks/useFeatureAnnouncements.js

@@ -0,0 +1 @@
+import{__awaiter as e}from"../../../_virtual/_tslib.js";import{useState as t,useCallback as r,useEffect as o}from"react";import{ANIMATION_TIMING as i}from"../constants/animations.js";import{QUERY_PARAMS as a,LOCAL_STORAGE_KEYS as n}from"../constants/localStorageKeys.js";const l=l=>{let{fetchVisibleFeatures:d,getStoreFeatureProgress:u,fetchFeatureById:s,markFeatureAsViewedForStore:c,isFeatureApplicableToCurrentPage:f,module:p,router:g}=l;var v;const y=(()=>{const[e,r]=t(null);return o((()=>{if("undefined"!=typeof window){let e=null;try{if(e=localStorage.getItem(n.STORE_ID)||localStorage.getItem(n.BIK_STORE_ID)||localStorage.getItem(n.CURRENT_STORE)||localStorage.getItem(n.STORE),!e){const t=localStorage.getItem(n.CURRENT_USER);t&&(e=JSON.parse(t).storeId)}e||(e=new URLSearchParams(window.location.search).get(n.QUERY_PARAM))}catch(e){}r(e)}}),[]),e})(),[m,D]=t([]),[U,w]=t([]),[h,R]=t([]),[I,S]=t(!1),[T,x]=t(null),E=r((()=>e(void 0,void 0,void 0,(function*(){if(y){S(!0),x(null);try{const[e,t]=yield d(p);if(e||!t)return void x("Failed to fetch features");const[r,o]=yield u(y),a=new Date,n="undefined"!=typeof window?window.location.pathname:"",l=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()))&&a<t},s=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===n)return!0;const t=e.replace(/\[([^\]]+)\]/g,"[^/]+").replace(/\//g,"\\/");return new RegExp(`^${t}$`).test(n)}))}return!0},c=t.filter((e=>{var t;const r=(null===(t=null==o?void 0:o.viewedFeatures)||void 0===t?void 0:t[e.id])||!1,i=e.archived||!1,a=f(e),n=l(e),d=s(e);return!r&&!i&&a&&n&&d})),g=c.filter((e=>"Major"===e.featureUpdateType)),v=c.filter((e=>"Minor"===e.featureUpdateType));D(c),w(g),setTimeout((()=>{R(v)}),i.MINOR_POPUP_DELAY)}catch(e){x("An unexpected error occurred")}finally{S(!1)}}}))),[y,d,u,f,p]),F=r((t=>e(void 0,void 0,void 0,(function*(){S(!0),x(null);try{const[e,r]=yield s(t);if(e||!r)return void x("Failed to fetch feature by ID");"Major"===r.featureUpdateType?w([r]):R([r]),D([r])}catch(e){x("An unexpected error occurred while fetching by ID")}finally{S(!1)}}))),[s]),A=r((t=>e(void 0,void 0,void 0,(function*(){if(!y)return;const[e]=yield c(y,t);D((e=>e.filter((e=>e.id!==t)))),w((e=>e.filter((e=>e.id!==t)))),R((e=>e.filter((e=>e.id!==t))))}))),[y,c]);return o((()=>{var e;const t=null===(e=null==g?void 0:g.query)||void 0===e?void 0:e[a.FEATURE_ID];t&&g?F(t):E()}),[null==g?void 0:g.pathname,null===(v=null==g?void 0:g.query)||void 0===v?void 0:v[a.FEATURE_ID],y,E,F,g]),{features:m,majorUpdateFeatures:U,minorUpdateFeatures:h,isLoading:I,error:T,markFeatureAsViewed:A,refetch:E}};export{l as useFeatureAnnouncements};

package/dist/esm/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/esm/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/esm/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/esm/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/esm/components/feature-announcements/styles/majorPopup.styles.js

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

package/dist/esm/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/esm/components/feature-announcements/styles/minorPopup.styles.js

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

package/dist/esm/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/esm/components/feature-announcements/styles/videoModal.styles.js

@@ -0,0 +1 @@
+import"../constants/animations.js";import{BORDER_RADIUS as o}from"../constants/dimensions.js";import{Z_INDEX as t}from"../constants/zIndex.js";const e={backdrop:{position:"fixed",top:0,left:0,right:0,bottom:0,backgroundColor:"rgba(0, 0, 0, 0.9)",zIndex:t.VIDEO_MODAL,display:"flex",justifyContent:"center",alignItems:"center",padding:"20px"},container:{position:"relative",width:"90vw",height:"90vh",maxWidth:"1200px",maxHeight:"800px",backgroundColor:"black",borderRadius:o.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:o.CLOSE_BUTTON,cursor:"pointer",display:"flex",alignItems:"center",justifyContent:"center",zIndex:t.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:o.VIDEO_MODAL},video:{width:"100%",height:"100%",objectFit:"contain",borderRadius:o.VIDEO_MODAL},noVideoMessage:{color:"white",fontSize:"18px",textAlign:"center"}};export{e as videoModalStyles};

package/dist/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/components/feature-announcements/utils/animationHelpers.js

@@ -0,0 +1 @@
+import{ANIMATION_TIMING as t}from"../constants/animations.js";const e=(t,e)=>{const i=t.getBoundingClientRect(),o=e.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)`},i=t=>{if(!t)return;const e=t.closest('[class*="react-joyride__tooltip"]');if(!e)return;const i=e.querySelector('[class*="react-joyride__arrow"]');i&&(i.style.display="none",i.style.visibility="hidden",i.style.opacity="0")},o=function(e){let i=arguments.length>1&&void 0!==arguments[1]?arguments[1]:t.CLOSE_DURATION;setTimeout(e,i)};export{e as calculateCloseTransform,o as executeAfterAnimation,i as hideJoyrideArrow};

package/dist/esm/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/esm/components/feature-announcements/utils/elementHelpers.js

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

package/dist/esm/components/feature-announcements/utils/htmlHelpers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Decode HTML entities in text
+ * @param text - Text containing HTML entities
+ * @returns Decoded text
+ */
+export declare const decodeHTMLEntities: (text: string) => string;
+/**
+ * Format video URL for embedding
+ * @param videoUrl - Original video URL
+ * @returns Formatted video URL
+ */
+export declare const formatVideoUrl: (videoUrl: string) => string;
+/**
+ * Check if URL is a YouTube video
+ * @param videoUrl - Video URL to check
+ * @returns True if YouTube video
+ */
+export declare const isYouTubeVideo: (videoUrl: string) => boolean;

package/dist/esm/components/feature-announcements/utils/htmlHelpers.js

@@ -0,0 +1 @@
+const e=e=>{if(!e)return"";const t=document.createElement("textarea");return t.innerHTML=e,t.value},t=e=>e.replace("watch?v=","embed/").replace("youtu.be/","youtube.com/embed/"),u=e=>e.includes("youtube.com")||e.includes("youtu.be");export{e as decodeHTMLEntities,t as formatVideoUrl,u as isYouTubeVideo};

package/dist/esm/components/feature-announcements/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './htmlHelpers';
+export * from './animationHelpers';
+export * from './elementHelpers';