@shopgate/engage 7.32.0-beta.4 → 7.32.0-beta.6

package/page/components/WidgetVideo/WidgetVideo.js

@@ -1,11 +1,19 @@
-import React, { useEffect, useMemo, useState } from 'react';
+import { useEffect, useMemo, useState, useRef } from 'react';
 import { makeStyles } from '@shopgate/engage/styles';
 import { useReduceMotion } from '@shopgate/engage/a11y/hooks';
 import { usePrevious, useAppEventOnReturnFromBackground } from '@shopgate/engage/core/hooks';
-import { ConditionalWrapper, Link } from '@shopgate/engage/components';
-import PropTypes from 'prop-types';
+import { ConditionalWrapper, Link as EngageLink } from '@shopgate/engage/components';
 import { isHttpsUrl } from "../../helpers";
+
+// `Link` is a redux-connected component whose react-redux connect() typing resolves its own props
+// (href/children) to `never`; alias it to its actual usable prop shape.
 import { jsx as _jsx } from "react/jsx-runtime";
+const Link = EngageLink;
+
+/**
+ * Style parameters for the widget video.
+ */
+
 const useStyles = makeStyles()((_theme, {
   borderRadius
 }) => ({
@@ -36,28 +44,22 @@ const useStyles = makeStyles()((_theme, {
   }
 }));
 
+/**
+ * Props of the {@link WidgetVideo} component.
+ */
+
 /**
  * The WidgetVideo component is used to display a video in a widget.
- * @param {Object} props The component props.
- * @param {boolean} props.isBanner Whether the video is used in a banner.
- * @param {string} props.url The video URL.
- * @param {boolean} props.muted Whether the video is muted.
- * @param {boolean} props.loop Whether the video is looping.
- * @param {boolean} props.controls Whether the video controls are shown.
- * @param {boolean} props.autoplay Whether the video should autoplay.
- * @param {number} props.borderRadius The border radius value.
- * @param {string} props.link The link URL.
- * @returns {JSX.Element}
  */
 const WidgetVideo = ({
-  isBanner,
-  url,
-  muted,
-  loop,
-  controls,
-  autoplay,
-  borderRadius,
-  link
+  isBanner = false,
+  url = null,
+  muted = false,
+  loop = false,
+  controls = false,
+  autoplay = false,
+  borderRadius = 0,
+  link = null
 }) => {
   const reduceMotion = useReduceMotion();
   const autoplayValue = reduceMotion ? false : isBanner || autoplay;
@@ -68,7 +70,7 @@ const WidgetVideo = ({
     borderRadius
   });
   const [hasError, setHasError] = useState(false);
-  const videoRef = React.useRef(null);
+  const videoRef = useRef(null);
   const prevUrl = usePrevious(url);
   const isValidUrl = useMemo(() => url ? isHttpsUrl(url) : false, [url]);
   const showControls = useMemo(() => {
@@ -81,25 +83,27 @@ const WidgetVideo = ({
 
   // Resume video playback when app returned from background
   useAppEventOnReturnFromBackground(() => {
-    if (!videoRef.current || reduceMotion || !autoplayValue) {
+    const video = videoRef.current;
+    if (!video || reduceMotion || !autoplayValue) {
       return;
     }
-    videoRef.current.play();
+    video.play();
   });
   useEffect(() => {
-    if (!videoRef.current) {
+    const video = videoRef.current;
+    if (!video) {
       return;
     }
     if (reduceMotion) {
       // Pause playback when reduced motion settings changed after video was rendered
-      videoRef.current.pause();
+      video.pause();
       return;
     }
     if (autoplayValue) {
-      videoRef.current.play();
+      video.play();
     } else {
-      videoRef.current.pause();
-      videoRef.current.currentTime = 0;
+      video.pause();
+      video.currentTime = 0;
     }
   }, [autoplayValue, reduceMotion]);
   useEffect(() => {
@@ -146,14 +150,4 @@ const WidgetVideo = ({
     })
   });
 };
-WidgetVideo.defaultProps = {
-  isBanner: false,
-  link: null,
-  url: null,
-  muted: false,
-  loop: false,
-  controls: false,
-  autoplay: false,
-  borderRadius: 0
-};
 export default WidgetVideo;

package/page/components/WidgetVideo/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './WidgetVideo';
+//# sourceMappingURL=index.d.ts.map

package/page/components/WidgetVideo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../page/components/WidgetVideo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/page/components/Widgets/Overlay.d.ts

@@ -0,0 +1,17 @@
+import { type RefObject } from 'react';
+/**
+ * Props of the {@link Overlay} component.
+ */
+export interface OverlayProps {
+    /**
+     * The reference to the container element that holds the widgets.
+     */
+    containerRef: RefObject<HTMLDivElement>;
+}
+/**
+ * The Overlay component is used to highlight the active widget when preview mode is active.
+ * It also visualizes the margins of the widget and the borders to its sibling widgets.
+ */
+declare const Overlay: ({ containerRef, }: OverlayProps) => import("react").JSX.Element | null;
+export default Overlay;
+//# sourceMappingURL=Overlay.d.ts.map

package/page/components/Widgets/Overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Overlay.d.ts","sourceRoot":"","sources":["../../../../page/components/Widgets/Overlay.tsx"],"names":[],"mappings":"AAAA,OAAO,EACqC,KAAK,SAAS,EACzD,MAAM,OAAO,CAAC;AA+Ff;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,QAAA,MAAM,OAAO,GAAI,mBAEd,YAAY,uCAmNd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/page/components/Widgets/Overlay.js

@@ -1,5 +1,4 @@
-import React, { useState, useRef, useEffect, useCallback } from 'react';
-import PropTypes from 'prop-types';
+import { useState, useRef, useEffect, useCallback } from 'react';
 import { makeStyles, keyframes, colorToRgba } from '@shopgate/engage/styles';
 import { useRoute } from '@shopgate/engage/core/hooks';
 import { getScrollContainer } from "./helpers";
@@ -7,19 +6,15 @@ import { useWidgetPreviewEvent } from "./events";
 import { useWidgetsPreview } from "./hooks";
 
 /**
- * @typedef {Object} OverlayStyle
- * @property {number} top Style for the top position of the overlay.
- * @property {number} left Style for the left position of the overlay.
- * @property {number} width Style for the width of the overlay.
- * @property {number} height Style for the height of the overlay.
+ * Position and dimensions of a single overlay rectangle.
  */
 
 /**
- * @typedef {Object} MarginOverlayStyles
- * @property {OverlayStyle} top Style for the top margin overlay.
- * @property {OverlayStyle} left Style for the left margin overlay.
- * @property {OverlayStyle} bottom Style for the bottom margin overlay.
- * @property {OverlayStyle} right Style for the right margin overlay.
+ * Styles for the four margin overlays surrounding the active widget.
+ */
+
+/**
+ * Style parameters for the overlay.
  */
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const useStyles = makeStyles({
@@ -62,13 +57,13 @@ const useStyles = makeStyles({
   }
 }));
 
+/**
+ * Props of the {@link Overlay} component.
+ */
+
 /**
  * The Overlay component is used to highlight the active widget when preview mode is active.
  * It also visualizes the margins of the widget and the borders to its sibling widgets.
- * @param {Object} props The component props.
- * @param {React.Ref<HTMLDivElement>} props.containerRef The reference to the container element that
- * holds the widgets.
- * @returns {JSX.Element|null}
  */
 const Overlay = ({
   containerRef
@@ -84,17 +79,10 @@ const Overlay = ({
     activeWidget
   } = useWidgetsPreview();
 
-  /**
-   * State to hold the style for the main overlay that highlights the active widget.
-   * @type {[OverlayStyle|null, React.Dispatch<React.SetStateAction<OverlayStyle|null>>]}
-   */
+  // State to hold the style for the main overlay that highlights the active widget.
   const [mainOverlayStyle, setMainOverlayStyle] = useState(null);
 
-  /**
-   * State to hold the styles for the margin overlays that visualize the widget margins.
-   * @type {[MarginOverlayStyles|null,
-   * React.Dispatch<React.SetStateAction<MarginOverlayStyles|null>>]}
-   */
+  // State to hold the styles for the margin overlays that visualize the widget margins.
   const [marginOverlays, setMarginOverlays] = useState(null);
   const [isFlashing, setIsFlashing] = useState(false);
   const {
@@ -105,14 +93,7 @@ const Overlay = ({
     marginOverlayColor,
     isFlashing
   });
-
-  /**
-   * @type {import('react').MutableRefObject<ResizeObserver|null>}
-   */
   const resizeRef = useRef(null);
-  /**
-   * @type {import('react').MutableRefObject<MutationObserver|null>}
-   */
   const mutationRef = useRef(null);
 
   /**
@@ -128,6 +109,9 @@ const Overlay = ({
       return;
     }
     const scrollContainer = getScrollContainer();
+    if (!scrollContainer) {
+      return;
+    }
 
     // Get the computed styles of the active widget to calculate margins
     const styles = window.getComputedStyle(target);
@@ -191,33 +175,34 @@ const Overlay = ({
     if (!containerEl) return undefined;
 
     // Create a ResizeObserver to watch for size changes of children
-    resizeRef.current = new ResizeObserver(() => {
+    const resizeObserver = new ResizeObserver(() => {
       // Whenever any observed child resizes, update overlay
       updateOverlay();
     });
+    resizeRef.current = resizeObserver;
 
     // Observe all existing children
     Array.from(containerEl.children).forEach(child => {
       if (child.nodeType === Node.ELEMENT_NODE) {
-        resizeRef.current.observe(child);
+        resizeObserver.observe(child);
       }
     });
 
     // Create one MutationObserver on the container to watch for changes in the DOM
-    mutationRef.current = new MutationObserver(mutations => {
+    const mutationObserver = new MutationObserver(mutations => {
       for (const mutation of mutations) {
         if (mutation.type === 'childList') {
           // Handle newly added nodes - observe them for size changes
           mutation.addedNodes.forEach(node => {
             if (node.nodeType === Node.ELEMENT_NODE) {
-              resizeRef.current.observe(node);
+              resizeObserver.observe(node);
             }
           });
 
           // Handle removed nodes - remove them from observation
           mutation.removedNodes.forEach(node => {
             if (node.nodeType === Node.ELEMENT_NODE) {
-              resizeRef.current.unobserve(node);
+              resizeObserver.unobserve(node);
             }
           });
 
@@ -231,11 +216,12 @@ const Overlay = ({
         }
       }
     });
+    mutationRef.current = mutationObserver;
 
     // Start observing:
     // - childList:true → to catch added/removed children
     // - subtree:true + attributes:true → to catch any class/style changes in descendants
-    mutationRef.current.observe(containerEl, {
+    mutationObserver.observe(containerEl, {
       childList: true,
       subtree: true,
       attributes: true,

package/page/components/Widgets/Tooltip.d.ts

@@ -0,0 +1,20 @@
+import { type ReactNode } from 'react';
+/**
+ * Props of the {@link Tooltip} component.
+ */
+export interface TooltipProps {
+    /**
+     * The child elements to wrap.
+     */
+    children: ReactNode;
+    /**
+     * The tooltip text to display.
+     */
+    text?: string | null;
+}
+/**
+ * AI generated Tooltip component to display additional information on hover.
+ */
+declare function Tooltip({ children, text }: TooltipProps): import("react").JSX.Element;
+export default Tooltip;
+//# sourceMappingURL=Tooltip.d.ts.map

package/page/components/Widgets/Tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../../page/components/Widgets/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,EACwB,KAAK,SAAS,EAC5C,MAAM,OAAO,CAAC;AAwDf;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,iBAAS,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,YAAY,+BA0IhD;AAED,eAAe,OAAO,CAAC"}

package/page/components/Widgets/Tooltip.js

@@ -1,6 +1,5 @@
-import React, { useState, useRef, useEffect } from 'react';
+import { useState, useRef, useEffect } from 'react';
 import ReactDOM from 'react-dom';
-import PropTypes from 'prop-types';
 import { Typography } from '@shopgate/engage/components';
 import { makeStyles } from '@shopgate/engage/styles';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
@@ -56,12 +55,12 @@ const useStyles = makeStyles()(theme => ({
   }
 }));
 
+/**
+ * Props of the {@link Tooltip} component.
+ */
+
 /**
  * AI generated Tooltip component to display additional information on hover.
- * @param {Object} props The component props.
- * @param {React.ReactNode} props.children The child elements to wrap.
- * @param {string} props.text The tooltip text to display.
- * @returns {JSX.Element}
  */
 function Tooltip({
   children,
@@ -80,7 +79,7 @@ function Tooltip({
     top: 0
   });
   const [arrowLeft, setArrowLeft] = useState(null);
-  const [positionState, setPositionState] = useState('top'); // 'top' or 'bottom'
+  const [positionState, setPositionState] = useState('top');
   const tooltipId = useRef(Math.random().toString(36).slice(2, 11));
 
   // Handle mounting/unmounting and trigger fade animation
@@ -196,7 +195,4 @@ function Tooltip({
     }), document.body)]
   });
 }
-Tooltip.defaultProps = {
-  text: null
-};
 export default Tooltip;

package/page/components/Widgets/Widget.d.ts

@@ -0,0 +1,32 @@
+import { type ComponentType } from 'react';
+import { type WidgetDefinition } from './types';
+/**
+ * Props of the {@link Widget} component.
+ */
+export interface WidgetProps {
+    /**
+     * The widget component to render.
+     */
+    component: ComponentType<{
+        settings?: WidgetDefinition['widgetConfig'];
+    }>;
+    /**
+     * The widget definition data.
+     */
+    definition: WidgetDefinition;
+    /**
+     * Whether the widget is in preview mode.
+     */
+    isPreview: boolean;
+    /**
+     * Whether the widget is a legacy custom widget provided by an extension that's configured
+     * via an HTML comment inside a HTML widget.
+     */
+    isCustomLegacyWidget?: boolean;
+}
+/**
+ * The Widget component.
+ */
+declare const Widget: ({ component: Component, definition, isPreview, isCustomLegacyWidget, }: WidgetProps) => import("react").JSX.Element | null;
+export default Widget;
+//# sourceMappingURL=Widget.d.ts.map

package/page/components/Widgets/Widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Widget.d.ts","sourceRoot":"","sources":["../../../../page/components/Widgets/Widget.tsx"],"names":[],"mappings":"AAAA,OAAO,EACkB,KAAK,aAAa,EAC1C,MAAM,OAAO,CAAC;AAQf,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAiDhD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC,CAAC;IAC1E;;OAEG;IACH,UAAU,EAAE,gBAAgB,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,QAAA,MAAM,MAAM,GAAI,wEAKb,WAAW,uCAqEb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/page/components/Widgets/Widget.js

@@ -1,5 +1,4 @@
-import React, { Suspense, useCallback } from 'react';
-import PropTypes from 'prop-types';
+import { Suspense, useCallback } from 'react';
 import { makeStyles } from '@shopgate/engage/styles';
 import { VisibilityOffIcon, TimeIcon, Loading } from '@shopgate/engage/components';
 import { usePressHandler } from '@shopgate/engage/core/hooks';
@@ -7,6 +6,10 @@ import WidgetProvider from "./WidgetProvider";
 import { dispatchWidgetPreviewEvent } from "./events";
 import { useWidgetsPreview } from "./hooks";
 import Tooltip from "./Tooltip";
+
+/**
+ * Style parameters for the widget, derived from its layout margins.
+ */
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const useStyles = makeStyles()((theme, {
   marginTop,
@@ -46,28 +49,17 @@ const useStyles = makeStyles()((theme, {
 }));
 
 /**
- * @typedef {import('./types').WidgetDefinition} WidgetDefinition
- */
-
-/**
- * @typedef {import('./types').ScheduledStatus} ScheduledStatus
+ * Props of the {@link Widget} component.
  */
 
 /**
  * The Widget component.
- * @param {Object} props The component props.
- * @param {React.ComponentType} props.component The widget component to render.
- * @param {WidgetDefinition} props.definition The widget definition data.
- * @param {boolean} props.isPreview Whether the widget is in preview mode.
- * @param {boolean} props.isCustomLegacyWidget Whether the widget is a legacy custom widget provided
- * by an extension that's configured via an HTML comment inside a HTML widget.
- * @returns {JSX.Element}
  */
 const Widget = ({
   component: Component,
   definition,
   isPreview,
-  isCustomLegacyWidget
+  isCustomLegacyWidget = false
 }) => {
   const {
     classes,
@@ -138,7 +130,4 @@ const Widget = ({
     })]
   });
 };
-Widget.defaultProps = {
-  isCustomLegacyWidget: false
-};
 export default Widget;

package/page/components/Widgets/WidgetContext.d.ts

@@ -1,42 +1,36 @@
-import { type Context } from 'react';
-import {
-  type WidgetDefinitionLayout,
-  type WidgetDefinitionVisibility,
-  type WidgetDefinition,
-} from './types'
-
-export { WidgetDefinition } from './types';
-
-export interface WidgetContextType<C = Record<string, any>> {
-  /**
-   * The unique code of the widget instance
-   */
-  code: string;
-  /**
-   * The name of the widget
-   */
-  name: string;
-  /**
-   * The widget configuration
-   */
-  config: C;
-  /**
-   * The widget layout settings
-   */
-  layout: WidgetDefinitionLayout;
-  /**
-   * The widget visibility settings
-   */
-  visibility: WidgetDefinitionVisibility;
-  /**
-   * Whether the widget is rendered in preview mode
-   */
-  isPreview: boolean;
+import { type WidgetDefinitionLayout, type WidgetDefinitionVisibility } from './types';
+export { type WidgetDefinition } from './types';
+/**
+ * Context value provided by the {@link WidgetContext} for a single widget instance.
+ */
+export interface WidgetContextType<C = Record<string, unknown>> {
+    /**
+     * The unique code of the widget instance.
+     */
+    code: string;
+    /**
+     * The name of the widget.
+     */
+    name: string;
+    /**
+     * The widget configuration.
+     */
+    config: C;
+    /**
+     * The widget layout settings.
+     */
+    layout: WidgetDefinitionLayout;
+    /**
+     * The widget visibility settings.
+     */
+    visibility: WidgetDefinitionVisibility;
+    /**
+     * Whether the widget is rendered in preview mode.
+     */
+    isPreview: boolean;
 }
-
 /**
  * React context for widgets.
  */
-declare const WidgetContext: Context<WidgetContextType>;
-
-export default WidgetContext;
+export declare const WidgetContext: import("react").Context<WidgetContextType<Record<string, unknown>>>;
+//# sourceMappingURL=WidgetContext.d.ts.map

package/page/components/Widgets/WidgetContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetContext.d.ts","sourceRoot":"","sources":["../../../../page/components/Widgets/WidgetContext.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAChC,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IACV;;OAEG;IACH,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;OAEG;IACH,UAAU,EAAE,0BAA0B,CAAC;IACvC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,qEAA4D,CAAC"}

package/page/components/Widgets/WidgetContext.js

@@ -1,16 +1,10 @@
 import { createContext } from 'react';
 
 /**
- * @typedef {import('./Widgets.jsx').WidgetDefinition} WidgetDefinition
+ * Context value provided by the {@link WidgetContext} for a single widget instance.
  */
 
 /**
- * @typedef {Object} WidgetContextType
- * @property {WidgetDefinition['code']} code The unique widget code.
- * @property {WidgetDefinition['widgetConfig']} config The widget configuration.
- * @property {WidgetDefinition['layout']} layout The widget layout settings.
- * @property {WidgetDefinition['visibility']} visibility The widget visibility settings.
+ * React context for widgets.
  */
-
-/** @type {React.Context<WidgetContextType>} */
 export const WidgetContext = /*#__PURE__*/createContext({});

package/page/components/Widgets/WidgetProvider.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from 'react';
+import { type WidgetDefinition } from './types';
+/**
+ * Props of the {@link WidgetProvider} component.
+ */
+export interface WidgetProviderProps {
+    /**
+     * The child components to render.
+     */
+    children: ReactNode;
+    /**
+     * The widget definition data.
+     */
+    definition: WidgetDefinition;
+    /**
+     * Whether the widget is in preview mode.
+     */
+    isPreview: boolean;
+}
+/**
+ * The WidgetProvider component provides the context for a single widget.
+ */
+declare const WidgetProvider: ({ children, definition, isPreview }: WidgetProviderProps) => import("react").JSX.Element;
+export default WidgetProvider;
+//# sourceMappingURL=WidgetProvider.d.ts.map

package/page/components/Widgets/WidgetProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetProvider.d.ts","sourceRoot":"","sources":["../../../../page/components/Widgets/WidgetProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,gBAAgB,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,QAAA,MAAM,cAAc,GAAI,qCAAqC,mBAAmB,gCAoB/E,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/page/components/Widgets/WidgetProvider.js

@@ -1,25 +1,18 @@
-import React, { useMemo } from 'react';
-import PropTypes from 'prop-types';
+import { useMemo } from 'react';
 import { WidgetContext } from "./WidgetContext";
 
-/**  @typedef {import('./WidgetContext').WidgetContextType} WidgetContextType */
-/**  @typedef {import('./WidgetContext').WidgetDefinition} WidgetDefinition */
-
 /**
- * The WidgetProvider component provides the context for a single widget.
- * @param {Object} props The component props.
- * @param {WidgetDefinition} props.definition The widget definition data.
- * @param {boolean} props.isPreview Whether the widget is in preview mode.
- * @param {React.ReactNode} props.children The child components to render.
- * @returns {JSX.Element}
+ * Props of the {@link WidgetProvider} component.
  */
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The WidgetProvider component provides the context for a single widget.
+ */
 const WidgetProvider = ({
   children,
   definition,
   isPreview
 }) => {
-  /** @type {WidgetContextType} */
   const value = useMemo(() => {
     const {
       widgetConfig,

package/page/components/Widgets/Widgets.d.ts

@@ -0,0 +1,16 @@
+import { type WidgetDefinition } from './types';
+/**
+ * Props of the {@link Widgets} component.
+ */
+export interface WidgetsProps {
+    /**
+     * The list of widgets to render.
+     */
+    widgets?: WidgetDefinition[];
+}
+/**
+ * The Widgets component renders a list of widgets.
+ */
+declare const Widgets: ({ widgets: widgetsProp, }: WidgetsProps) => import("react").JSX.Element | null;
+export default Widgets;
+//# sourceMappingURL=Widgets.d.ts.map

package/page/components/Widgets/Widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Widgets.d.ts","sourceRoot":"","sources":["../../../../page/components/Widgets/Widgets.tsx"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAYhD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,QAAA,MAAM,OAAO,GAAI,2BAEd,YAAY,uCA+Dd,CAAC;AAEF,eAAe,OAAO,CAAC"}