@shopgate/engage 7.32.0-beta.1 → 7.32.0-beta.11

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

@@ -2,131 +2,129 @@
  * Visibility settings for a widget.
  */
 export interface WidgetDefinitionVisibility {
-  /**
-   * Whether the widget is hidden.
-   */
-  isHidden: boolean;
-  /**
-   * Start date for scheduled widgets.
-   */
-  scheduleStartDate: string;
-  /**
-   * End date for scheduled widgets.
-   */
-  scheduleEndDate: string
+    /**
+     * Whether the widget is hidden.
+     */
+    isHidden: boolean;
+    /**
+     * Start date for scheduled widgets.
+     */
+    scheduleStartDate: string;
+    /**
+     * End date for scheduled widgets.
+     */
+    scheduleEndDate: string;
 }
-
 /**
  * Layout settings for a widget.
  */
 export interface WidgetDefinitionLayout {
-  /**
-   * Top margin for the widget.
-   */
-  marginTop: number;
-  /**
-   * Bottom margin for the widget.
-   */
-  marginBottom: number;
-  /**
-   * Left margin for the widget.
-   */
-  marginLeft: number;
-  /**
-   * Right margin for the widget.
-   */
-  marginRight: number;
+    /**
+     * Top margin for the widget.
+     */
+    marginTop: number;
+    /**
+     * Bottom margin for the widget.
+     */
+    marginBottom: number;
+    /**
+     * Left margin for the widget.
+     */
+    marginLeft: number;
+    /**
+     * Right margin for the widget.
+     */
+    marginRight: number;
 }
-
 /**
  * Definition of a API widget
  */
 export interface WidgetDefinition {
-  /**
-   * Unique code for the widget.
-   */
-  code: string;
-  /**
-   * Name of the widget
-   */
-  widgetConfigDefinitionCode: string;
-  /**
-   * Individual configuration for the widget.
-   */
-  widgetConfig: Record<string, any>;
-  /**
-   * 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;
-  /**
-   * Visibility settings for the widget.
-   */
-  visibility: WidgetDefinitionVisibility;
-  /**
-   * Layout settings for the widget.
-   */
-  layout: WidgetDefinitionLayout;
-  /**
-   * Optional metadata for the widget (only available in preview mode)
-   */
-  meta?: {
-    /**
-     * Hidden state related data
-     */
-    hidden: {
-      /**
-       * Whether the widget is hidden.
-       */
-      isHidden: boolean;
-      /**
-       * Tooltip text for hidden related UI elements.
-       */
-      tooltip: string;
-      /**
-       * Label text for hidden related UI elements.
-       */
-      label: string;
-    };
     /**
-     * Scheduled state related data
-     */
-    scheduled: {
-      /**
-       * Indicates if the widget is scheduled.
-       */
-      isScheduled: boolean;
-      /**
-       * Indicates that the widget schedule time frame is currently active.
-       */
-      isActive: boolean;
-      /**
-       * Indicates if the scheduled time frame has expired
-       */
-      isExpired: boolean;
-      /**
-       * Tooltip text for schedule related UI elements.
-       */
-      tooltip: string;
-      /**
-       * Label text for schedule related UI elements.
-       */
-      label: string;
+     * Unique code for the widget.
+     */
+    code: string;
+    /**
+     * Name of the widget
+     */
+    widgetConfigDefinitionCode: string;
+    /**
+     * Individual configuration for the widget.
+     */
+    widgetConfig: Record<string, unknown>;
+    /**
+     * 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;
+    /**
+     * Visibility settings for the widget.
+     */
+    visibility: WidgetDefinitionVisibility;
+    /**
+     * Layout settings for the widget.
+     */
+    layout: WidgetDefinitionLayout;
+    /**
+     * Optional metadata for the widget (only available in preview mode)
+     */
+    meta?: {
+        /**
+         * Hidden state related data
+         */
+        hidden: {
+            /**
+             * Whether the widget is hidden.
+             */
+            isHidden: boolean;
+            /**
+             * Tooltip text for hidden related UI elements.
+             */
+            tooltip: string;
+            /**
+             * Label text for hidden related UI elements.
+             */
+            label: string;
+        };
+        /**
+         * Scheduled state related data
+         */
+        scheduled: {
+            /**
+             * Indicates if the widget is scheduled.
+             */
+            isScheduled: boolean;
+            /**
+             * Indicates that the widget schedule time frame is currently active.
+             */
+            isActive: boolean;
+            /**
+             * Indicates if the scheduled time frame has expired
+             */
+            isExpired: boolean;
+            /**
+             * Tooltip text for schedule related UI elements.
+             */
+            tooltip: string;
+            /**
+             * Label text for schedule related UI elements.
+             */
+            label: string;
+        };
     };
-  }
 }
-
 export interface ScheduledStatus {
-  /**
-   * Indicates if the widget is scheduled.
-   */
-  isScheduled: boolean;
-  /**
-   * Indicates if the widget is currently hidden based on the scheduling
-   */
-  isHidden: boolean;
-  /**
-   * Indicates if the scheduled time frame has expired.
-   */
-  isExpired: boolean;
+    /**
+     * Indicates if the widget is scheduled.
+     */
+    isScheduled: boolean;
+    /**
+     * Indicates if the widget is currently hidden based on the scheduling
+     */
+    isHidden: boolean;
+    /**
+     * Indicates if the scheduled time frame has expired.
+     */
+    isExpired: boolean;
 }
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../page/components/Widgets/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,0BAA0B,EAAE,MAAM,CAAC;IACnC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;OAEG;IACH,UAAU,EAAE,0BAA0B,CAAC;IACvC;;OAEG;IACH,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE;QACL;;WAEG;QACH,MAAM,EAAE;YACN;;eAEG;YACH,QAAQ,EAAE,OAAO,CAAC;YAClB;;eAEG;YACH,OAAO,EAAE,MAAM,CAAC;YAChB;;eAEG;YACH,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF;;WAEG;QACH,SAAS,EAAE;YACT;;eAEG;YACH,WAAW,EAAE,OAAO,CAAC;YACrB;;eAEG;YACH,QAAQ,EAAE,OAAO,CAAC;YAClB;;eAEG;YACH,SAAS,EAAE,OAAO,CAAC;YACnB;;eAEG;YACH,OAAO,EAAE,MAAM,CAAC;YAChB;;eAEG;YACH,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAA;CACF;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/page/components/Widgets/types.js

@@ -0,0 +1 @@
+export {};

package/page/components/index.d.ts

@@ -0,0 +1,5 @@
+export { default as NotFound } from './NotFound';
+export { default as Widgets } from './Widgets';
+export { default as ResponsiveWidgetImage } from './ResponsiveWidgetImage';
+export { default as WidgetRichText } from './WidgetRichText';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../page/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/page/constants/actionTypes.d.ts

@@ -0,0 +1,4 @@
+export declare const REQUEST_PAGE_CONFIG_V2 = "REQUEST_PAGE_CONFIG_V2";
+export declare const RECEIVE_PAGE_CONFIG_V2 = "RECEIVE_PAGE_CONFIG_V2";
+export declare const ERROR_PAGE_CONFIG_V2 = "ERROR_PAGE_CONFIG_V2";
+//# sourceMappingURL=actionTypes.d.ts.map

package/page/constants/actionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionTypes.d.ts","sourceRoot":"","sources":["../../../page/constants/actionTypes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,oBAAoB,yBAAyB,CAAC"}

package/page/constants/index.d.ts

@@ -0,0 +1,25 @@
+import { PAGE_PATH, PAGE_PATTERN } from '@shopgate/pwa-common/constants/RoutePaths';
+export { PAGE_PREVIEW_PATTERN } from '@shopgate/engage/admin-preview/constants';
+export * from '@shopgate/pwa-common/constants/PageIDs';
+export { PAGE_PATH, PAGE_PATTERN };
+export * from './actionTypes';
+export declare const IMPRINT_PATH = "/page/imprint";
+export declare const PAYMENT_PATH = "/page/payment";
+export declare const PRIVACY_PATH = "/page/privacy";
+export declare const RETURN_POLICY_PATH = "/page/return_policy";
+export declare const SHIPPING_PATH = "/page/shipping";
+export declare const TERMS_PATH = "/page/terms";
+export declare const PAGE_PREVIEW_SLUG = "page_preview";
+/**
+ * Checks if the app is currently in page preview mode.
+ * @todo For backwards compatibility, this constant is still exported from the page package and
+ * mapped to the isAdminPreviewActive helper. It should be removed in the future. Note that this
+ * is a snapshot taken when this module is evaluated - consumers that can call
+ * isAdminPreviewActive() at usage time should do that instead.
+ */
+export declare const IS_PAGE_PREVIEW_ACTIVE: boolean;
+/**
+ * One hour in milliseconds
+ */
+export declare const PAGE_STATE_LIFETIME = 3600000;
+//# sourceMappingURL=index.d.ts.map

package/page/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../page/constants/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAEpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAEhF,cAAc,wCAAwC,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AACnC,cAAc,eAAe,CAAC;AAE9B,eAAO,MAAM,YAAY,kBAAyB,CAAC;AACnD,eAAO,MAAM,YAAY,kBAAyB,CAAC;AACnD,eAAO,MAAM,YAAY,kBAAyB,CAAC;AACnD,eAAO,MAAM,kBAAkB,wBAA+B,CAAC;AAC/D,eAAO,MAAM,aAAa,mBAA0B,CAAC;AACrD,eAAO,MAAM,UAAU,gBAAuB,CAAC;AAE/C,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,SAAyB,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAAU,CAAC"}

package/page/constants/index.js

@@ -1,4 +1,4 @@
-import { IS_ADMIN_PREVIEW_ACTIVE } from '@shopgate/engage/admin-preview/constants';
+import { isAdminPreviewActive } from '@shopgate/engage/admin-preview/helpers';
 import { PAGE_PATH, PAGE_PATTERN } from '@shopgate/pwa-common/constants/RoutePaths';
 export { PAGE_PREVIEW_PATTERN } from '@shopgate/engage/admin-preview/constants';
 export * from '@shopgate/pwa-common/constants/PageIDs';
@@ -15,9 +15,11 @@ export const PAGE_PREVIEW_SLUG = 'page_preview';
 /**
  * Checks if the app is currently in page preview mode.
  * @todo For backwards compatibility, this constant is still exported from the page package and
- * mapped to the IS_ADMIN_PREVIEW_ACTIVE constant. It should be removed in the future.
+ * mapped to the isAdminPreviewActive helper. It should be removed in the future. Note that this
+ * is a snapshot taken when this module is evaluated - consumers that can call
+ * isAdminPreviewActive() at usage time should do that instead.
  */
-export const IS_PAGE_PREVIEW_ACTIVE = IS_ADMIN_PREVIEW_ACTIVE;
+export const IS_PAGE_PREVIEW_ACTIVE = isAdminPreviewActive();
 
 /**
  * One hour in milliseconds

package/page/helpers/index.d.ts

@@ -1,84 +1,92 @@
-export type ProductsWidgetInputConfig = {
-  /**
-   * A search term to filter products by
-   */
-  searchTerm: string;
-  /**
-   * A brand to filter products by
-   */
-  brand: string;
-  /**
-   * A category to filter products by
-   */
-  category: string;
-  /**
-   * Array of product item numbers (selected via manual input)
-   */
-  manualItemNumbers: string[];
-  /**
-   * Array of product item numbers (selected via product selector)
-   */
-  selectorItemNumbers: string[];
+/**
+ * Configuration of the "Products" widget input.
+ */
+export interface ProductsWidgetInputConfig {
+    /**
+     * A search term to filter products by.
+     */
+    searchTerm: string;
+    /**
+     * A brand to filter products by.
+     */
+    brand: string;
+    /**
+     * A category to filter products by.
+     */
+    category: string;
+    /**
+     * Array of product item numbers (selected via manual input).
+     */
+    manualItemNumbers: string[];
+    /**
+     * Array of product item numbers (selected via product selector).
+     */
+    selectorItemNumbers: string[];
 }
-
-export type GetProductSearchParamsFromProductsInputConfigReturnValue = {
-  /**
-   * The type of product search to perform.
-   */
-  productsSearchType: 'searchTerm' | 'brand' | 'category' | 'productIds';
-  /**
-   * The value to use for the product search. Can be a string or an array of strings (for product IDs).
-   */
-  productsSearchValue: string | string[];
+/**
+ * Return value of {@link getProductSearchParamsFromProductsInputConfig}.
+ */
+export interface GetProductSearchParamsFromProductsInputConfigReturnValue {
+    /**
+     * The type of product search to perform.
+     */
+    productsSearchType: 'searchTerm' | 'brand' | 'category' | 'productIds';
+    /**
+     * The value to use for the product search. Can be a string or an array of strings
+     * (for product IDs).
+     */
+    productsSearchValue: string | string[];
 }
-
 /**
  * Helper to extract relevant search parameters from the widget configuration of the "Products"
  * input.
- *
  * The return value can be used to e.g. parametrize the useWidgetProducts hook.
+ * @param products Config object of the "Products" input.
+ * @returns The extracted product search parameters.
  */
-export declare function getProductSearchParamsFromProductsInputConfig(
-  products: ProductsWidgetInputConfig
-): GetProductSearchParamsFromProductsInputConfigReturnValue;
-
+export declare const getProductSearchParamsFromProductsInputConfig: (products?: Partial<ProductsWidgetInputConfig>) => GetProductSearchParamsFromProductsInputConfigReturnValue;
 /**
- * Helper to parse the image URL to return a high resolution version if required.
+ * Parses the image URL to return a high resolution version if required.
+ * @param url The original image URL.
+ * @param useHighRes Whether to return a high resolution version.
+ * @returns The parsed image URL.
  */
-export declare function parseImageUrl(
-  url: string,
-  useHighRes?: boolean
-): string;
-
-type BorderRadiusParams = {
-  /**
-   * The border radius option
-   */
-  borderRadius: 'default' | 'none' |'rounded' | 'custom';
-  /**
-   * The custom border radius value
-   */
-  customBorderRadius?: number
-};
-
+export declare const parseImageUrl: (url: string, useHighRes?: boolean) => string;
 /**
- * Retrieves the border radius based on the widget config
- * @returns The resolved border radius
+ * Parameters for {@link resolveBorderRadiusFromWidgetConfig}.
+ */
+interface BorderRadiusParams {
+    /**
+     * The border radius option.
+     */
+    borderRadius: 'default' | 'none' | 'rounded' | 'custom';
+    /**
+     * The custom border radius value.
+     */
+    borderRadiusCustom?: number;
+}
+/**
+ * Retrieves the border radius based on the widget config.
+ *
+ * `default` follows the app wide corner style, so it is returned as a reference to the theme's
+ * shape variable rather than a resolved length.
+ * @param params The helper parameters.
+ * @param params.borderRadius The border radius option.
+ * @param params.borderRadiusCustom The custom border radius value.
+ * @returns The resolved border radius as a CSS length.
  */
-export declare function resolveBorderRadiusFromWidgetConfig(
-  params: BorderRadiusParams
-)
-
+export declare const resolveBorderRadiusFromWidgetConfig: ({ borderRadius, borderRadiusCustom }: BorderRadiusParams) => string;
 /**
  * Validator factory for regular expressions.
  * @param regex The regular expression to match.
  * @returns A function that validates if a value matches the regex.
  */
-export declare function matchesRegex(regex: RegExp): (val: string) => boolean;
-
+export declare const matchesRegex: (regex: RegExp) => (val: string) => boolean;
 /**
  * Validates if a given string is a valid HTTPS URL.
  * @param val The string to validate.
  * @returns True if the string is a valid HTTPS URL, false otherwise.
  */
 export declare const isHttpsUrl: (val: string) => boolean;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/page/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../page/helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B;;OAEG;IACH,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,wDAAwD;IACvE;;OAEG;IACH,kBAAkB,EAAE,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC;IACvE;;;OAGG;IACH,mBAAmB,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,6CAA6C,GACxD,WAAU,OAAO,CAAC,yBAAyB,CAAM,KAChD,wDAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,aAAa,OAAO,KAAG,MAQjE,CAAC;AAEF;;GAEG;AACH,UAAU,kBAAkB;IAC1B;;OAEG;IACH,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxD;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC,GAC9C,sCAAsC,kBAAkB,KACvD,MAKF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,MAAM,KAAK,MAAM,KAAG,OAAkC,CAAC;AAEjG;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAP8B,MAAM,KAAG,OAOgB,CAAC"}

package/page/helpers/index.js

@@ -1,21 +1,17 @@
-/* eslint-disable max-len */
-
 /**
- * @typedef {import('./').ProductsWidgetInputConfig} ProductsWidgetInputConfig
+ * Configuration of the "Products" widget input.
  */
 
 /**
- * @typedef {import('./').GetProductSearchParamsFromProductsInputConfigReturnValue} GetProductSearchParamsFromProductsInputConfigReturnValue
+ * Return value of {@link getProductSearchParamsFromProductsInputConfig}.
  */
 
-/* eslint-enable max-len */
-
 /**
  * Helper to extract relevant search parameters from the widget configuration of the "Products"
  * input.
  * The return value can be used to e.g. parametrize the useWidgetProducts hook.
- * @param {ProductsWidgetInputConfig} products Config object of the "Products" input.
- * @returns {GetProductSearchParamsFromProductsInputConfigReturnValue}
+ * @param products Config object of the "Products" input.
+ * @returns The extracted product search parameters.
  */
 export const getProductSearchParamsFromProductsInputConfig = (products = {}) => {
   const {
@@ -28,8 +24,7 @@ export const getProductSearchParamsFromProductsInputConfig = (products = {}) =>
   const mapping = [['brand', brand], ['category', category], ['searchTerm', searchTerm], ['productIds', manualItemNumbers], ['productIds', selectorItemNumbers]];
 
   // Pick the first non-undefined value
-  // eslint-disable-next-line prefer-const
-  let [productsSearchType, productsSearchValue] = mapping.find(([, value]) => value !== undefined) || ['searchTerm', searchTerm];
+  const [productsSearchType, productsSearchValue] = mapping.find(([, value]) => value !== undefined) || ['searchTerm', searchTerm];
   return {
     productsSearchType,
     productsSearchValue
@@ -38,9 +33,9 @@ export const getProductSearchParamsFromProductsInputConfig = (products = {}) =>
 
 /**
  * Parses the image URL to return a high resolution version if required.
- * @param {string} url The original image URL.
- * @param {boolean} useHighRes Whether to return a high resolution version.
- * @returns {string} The parsed image URL.
+ * @param url The original image URL.
+ * @param useHighRes Whether to return a high resolution version.
+ * @returns The parsed image URL.
  */
 export const parseImageUrl = (url, useHighRes) => {
   if (!url || !useHighRes) {
@@ -51,32 +46,39 @@ export const parseImageUrl = (url, useHighRes) => {
 };
 
 /**
- * Retrieves the border radius based on the widget config
- * @param {Object} params The helper parameters.
- * @param {"default"|"none"|"rounded"|"custom"} params.borderRadius The border radius option.
- * @param {number} params.borderRadiusCustom The custom border radius value.
- * @returns {number} The resolved border radius.
+ * Parameters for {@link resolveBorderRadiusFromWidgetConfig}.
+ */
+
+/**
+ * Retrieves the border radius based on the widget config.
+ *
+ * `default` follows the app wide corner style, so it is returned as a reference to the theme's
+ * shape variable rather than a resolved length.
+ * @param params The helper parameters.
+ * @param params.borderRadius The border radius option.
+ * @param params.borderRadiusCustom The custom border radius value.
+ * @returns The resolved border radius as a CSS length.
  */
 export const resolveBorderRadiusFromWidgetConfig = ({
   borderRadius,
   borderRadiusCustom
 }) => {
-  if (borderRadius === 'none') return 0;
-  if (borderRadius === 'rounded') return 16;
-  if (borderRadius === 'custom' && typeof borderRadiusCustom === 'number') return borderRadiusCustom;
-  return 0;
+  if (borderRadius === 'none') return '0';
+  if (borderRadius === 'rounded') return '16px';
+  if (borderRadius === 'custom' && typeof borderRadiusCustom === 'number') return `${borderRadiusCustom}px`;
+  return 'var(--sg-shape-borderRadius)';
 };
 
 /**
- * Validator factory for regular expressions
- * @param {RegExp} regex the regex
- * @return {Function}
+ * Validator factory for regular expressions.
+ * @param regex The regular expression to match.
+ * @returns A function that validates if a value matches the regex.
  */
 export const matchesRegex = regex => val => !val || regex.test(val);
 
 /**
- * Returns a function that validates if input is a valid url with the https protocol
- * @param {string} val the string to be validated
- * @return {boolean}
+ * Validates if a given string is a valid HTTPS URL.
+ * @param val The string to validate.
+ * @returns True if the string is a valid HTTPS URL, false otherwise.
  */
-export const isHttpsUrl = matchesRegex(new RegExp('^\\s*https://[^\\s/$.?#].[^\\s]*\\s*$', 'i'));
+export const isHttpsUrl = matchesRegex(/^\s*https:\/\/[^\s/$.?#].[^\s]*\s*$/i);