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

package/components/v2/CircularProgress/CircularProgress.js

@@ -17,6 +17,7 @@ const CircularProgress = /*#__PURE__*/forwardRef((props, ref) => {
     thickness = 3.6,
     style,
     className,
+    classes: classesProp,
     ...other
   } = props;
   const {
@@ -26,7 +27,7 @@ const CircularProgress = /*#__PURE__*/forwardRef((props, ref) => {
     color
   }, {
     props: {
-      classes: props.classes
+      classes: classesProp
     }
   });
   const circleStyle = {};
@@ -40,10 +41,10 @@ const CircularProgress = /*#__PURE__*/forwardRef((props, ref) => {
     rootStyle.transform = 'rotate(-90deg)';
   }
   return /*#__PURE__*/_jsx("div", {
-    className: cx(classes.root, className, {
+    className: cx(classes.root, {
       [classes.indeterminate]: variant === 'indeterminate',
       [classes.determinate]: variant === 'determinate'
-    }),
+    }, 'engage__circular-progress', className),
     style: {
       width: size,
       height: size,
@@ -52,6 +53,9 @@ const CircularProgress = /*#__PURE__*/forwardRef((props, ref) => {
     },
     ref: ref,
     role: "progressbar",
+    "data-variant": variant,
+    "data-color": color,
+    "data-disable-shrink": disableShrink || undefined,
     ...rootProps,
     ...other,
     children: /*#__PURE__*/_jsx("svg", {
@@ -108,8 +112,8 @@ const useStyles = makeStyles({
   return {
     root: {
       display: 'inline-block',
-      '--sg-circular-progress-circle-color': cssColor,
-      color: 'var(--sg-circular-progress-circle-color)'
+      '--circular-progress-color': cssColor,
+      color: 'var(--circular-progress-color)'
     },
     svg: {
       display: 'block'
@@ -136,4 +140,5 @@ const useStyles = makeStyles({
     }
   };
 });
+CircularProgress.displayName = 'CircularProgress';
 export default CircularProgress;

package/core/helpers/getFullImageSource.d.ts

@@ -1,5 +1,9 @@
-export function getFullImageSource(src: string, { width, height }?: {
+export function getFullImageSource(src: string | null, { width, height }?: {
     width: number;
     height: number;
+}, settings?: {
+    quality?: number | undefined;
+    fillColor?: string | undefined;
+    fillTransparent?: boolean | undefined;
 }): string;
 //# sourceMappingURL=getFullImageSource.d.ts.map

package/core/helpers/getFullImageSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFullImageSource.d.ts","sourceRoot":"","sources":["../../../core/helpers/getFullImageSource.js"],"names":[],"mappings":"AA+CO,wCANI,MAAM,sBAEd;IAA0B,KAAK,EAAvB,MAAM;IACY,MAAM,EAAxB,MAAM;CACd,GAAU,MAAM,CAgDlB"}
+{"version":3,"file":"getFullImageSource.d.ts","sourceRoot":"","sources":["../../../core/helpers/getFullImageSource.js"],"names":[],"mappings":"AAiEO,wCAVI,MAAM,GAAC,IAAI,sBAEnB;IAA0B,KAAK,EAAvB,MAAM;IACY,MAAM,EAAxB,MAAM;CACd,aACA;IAA0B,OAAO;IACP,SAAS;IACR,eAAe;CAC1C,GAAU,MAAM,CAyDlB"}

package/core/helpers/getFullImageSource.js

@@ -5,9 +5,18 @@ import "core-js/modules/web.url.to-json.js";
 import "core-js/modules/web.url-search-params.js";
 import { CONFIGURATION_COLLECTION_CREATE_EXTERNAL_IMAGE_URL } from '@shopgate/engage/core/constants';
 import { configuration } from '@shopgate/engage/core/collections';
-import { getProductImageSettings } from "../../product/helpers";
+import { DEFAULT_IMAGE_FILL_COLOR, DEFAULT_IMAGE_FILL_TRANSPARENT, DEFAULT_IMAGE_QUALITY } from '@shopgate/engage/settings/constants/imageSettings';
 import { getImageFormat } from "./getImageFormat";
 
+/**
+ * The settings applied when the caller passes none.
+ */
+const defaultSettings = {
+  quality: DEFAULT_IMAGE_QUALITY,
+  fillColor: DEFAULT_IMAGE_FILL_COLOR,
+  fillTransparent: DEFAULT_IMAGE_FILL_TRANSPARENT
+};
+
 /**
  * Regex to detect the "fill" query parameter
  */
@@ -43,29 +52,38 @@ const buildUrl = (baseUrl, params = {}) => {
 };
 
 /**
- * Returns the actual url to the image, by adding url parameters with the dimensions for img-cdn
- * @param {string} src Source to the image.
+ * Builds the url that requests an image at a given size. A src that no known image source
+ * recognizes is returned untouched.
+ * @param {string|null} src Source to the image.
  * @param {Object} dimension Dimension of the requested image.
  * @param {number} dimension.width Width in pixels.
  * @param {number} dimension.height Height in pixels.
+ * @param {Object} [settings] Image service settings, as resolved by useImageServiceSettings.
+ * @param {number} [settings.quality] Compression quality.
+ * @param {string} [settings.fillColor] Fill color as a hash free hex, not a CSS color.
+ * @param {boolean} [settings.fillTransparent] Whether transparent areas are filled too.
  * @returns {string}
  */
 export const getFullImageSource = (src, {
   width,
   height
-} = {}) => {
+} = {}, settings = {}) => {
+  const {
+    quality,
+    fillColor,
+    fillTransparent
+  } = {
+    ...defaultSettings,
+    ...settings
+  };
   if (src && src.includes('images.shopgate.services')) {
-    const {
-      fillColor,
-      quality
-    } = getProductImageSettings();
     const format = getImageFormat();
     return buildUrl(src, {
       format,
       width,
       height,
       quality,
-      fill: fillColor.replace('#', '')
+      fill: fillTransparent ? `${fillColor},1` : fillColor
     });
   }
   if (src && src.startsWith('https://img-cdn.shopgate.com') && !src.includes('?')) {
@@ -74,17 +92,14 @@ export const getFullImageSource = (src, {
       h: height,
       q: 70,
       zd: 'resize',
-      fillc: 'FFFFFF'
+      // No transparency flag here - the legacy cdn only understands a plain color.
+      fillc: fillColor
     });
   }
 
   // Check if an extension registered an external image url handler within the config collection.
   const createUrlFn = configuration.get(CONFIGURATION_COLLECTION_CREATE_EXTERNAL_IMAGE_URL);
   if (typeof createUrlFn === 'function') {
-    const {
-      fillColor,
-      quality
-    } = getProductImageSettings();
     const format = getImageFormat();
 
     // Invoke the handler with all relevant parameters.
@@ -92,6 +107,7 @@ export const getFullImageSource = (src, {
       width,
       height,
       fillColor,
+      fillTransparent,
       quality,
       format
     });

package/core/helpers/i18n.d.ts

@@ -40,6 +40,10 @@ export type I18nHelpers = {
      * - Get locale data by path
      */
     getPath: Function;
+    /**
+     * - Check whether a translation key resolves to a value
+     */
+    has: Function;
     /**
      * - Get locale lang code, eg de-DE
      */

package/core/helpers/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../core/helpers/i18n.js"],"names":[],"mappings":"AAyEA;;GAEG;AACH,mBAFU,WAAW,CAEM;AAMpB,oCAFM,MAAM,EAAE,CAQpB"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../core/helpers/i18n.js"],"names":[],"mappings":"AA4EA;;GAEG;AACH,mBAFU,WAAW,CAEM;AAMpB,oCAFM,MAAM,EAAE,CAQpB"}

package/core/helpers/i18n.js

@@ -13,6 +13,7 @@ import { logger } from '@shopgate/pwa-core/helpers';
  * @property {Function} number - Number translator
  * @property {Function} getSupplementalData - Get Supplemental Data
  * @property {Function} getPath - Get locale data by path
+ * @property {Function} has - Check whether a translation key resolves to a value
  * @property {Function} getLang - Get locale lang code, eg de-DE
  */
 
@@ -50,6 +51,7 @@ const I18n = () => {
       this.number = getNumberFormatter(lang);
       this.getSupplementalData = () => locales.supplementalData || {};
       this.getPath = path => get(locales, path);
+      this.has = path => this.getPath(path) !== undefined;
       this.getLang = () => lang;
       // If component decides to act accordingly this information should be exposed.
       this.ready = true;
@@ -62,6 +64,7 @@ const I18n = () => {
     number: notReadyCb,
     getSupplementalData: notReadyCb,
     getPath: notReadyCb,
+    has: notReadyCb,
     getLang: notReadyCb,
     ready: false
   };

package/core/hooks/html/useLoadImage.d.ts

@@ -1,7 +1,7 @@
 /**
  * Load image hook
- * @param {string} src .
- * @returns {boolean}
+ * @param {string|null} src The image to preload. A falsy src is a no-op.
+ * @returns {boolean} Whether the image has finished loading.
  */
-export function useLoadImage(src: string): boolean;
+export function useLoadImage(src: string | null): boolean;
 //# sourceMappingURL=useLoadImage.d.ts.map

package/core/hooks/html/useLoadImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLoadImage.d.ts","sourceRoot":"","sources":["../../../../core/hooks/html/useLoadImage.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,kCAHW,MAAM,GACJ,OAAO,CAUnB"}
+{"version":3,"file":"useLoadImage.d.ts","sourceRoot":"","sources":["../../../../core/hooks/html/useLoadImage.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,kCAHW,MAAM,GAAC,IAAI,GACT,OAAO,CAUnB"}

package/core/hooks/html/useLoadImage.js

@@ -3,8 +3,8 @@ import { loadImage } from '@shopgate/pwa-common/helpers/html/handleDOM';
 
 /**
  * Load image hook
- * @param {string} src .
- * @returns {boolean}
+ * @param {string|null} src The image to preload. A falsy src is a no-op.
+ * @returns {boolean} Whether the image has finished loading.
  */
 export function useLoadImage(src) {
   const [loaded, setIsLoaded] = useState(false);

package/core/hooks/useLocalStorage.d.ts

@@ -11,6 +11,14 @@ interface UseLocalStorageOptions<T> {
      * @default true
      */
     sync?: boolean;
+    /**
+     * Whether the value is written to localStorage at all. Set to false in contexts that must not
+     * leak state into the visitor's browser and should stay ephemeral. With this off the hook is a
+     * plain useState: it neither reads nor writes localStorage, and it ignores updates from other
+     * tabs.
+     * @default true
+     */
+    persist?: boolean;
 }
 type SetValueAction<T> = T | null | ((prev: T | null) => T | null);
 /**

package/core/hooks/useLocalStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../../core/hooks/useLocalStorage.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,UAAU,sBAAsB,CAAC,CAAC;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,CAAC,EACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,GACtC,SAAS,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CA8EzD"}
+{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../../core/hooks/useLocalStorage.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,UAAU,sBAAsB,CAAC,CAAC;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,CAAC,EACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,GACtC,SAAS,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAqFzD"}

package/core/hooks/useLocalStorage.js

@@ -19,10 +19,12 @@ const {
 export default function useLocalStorage(key, options = {}) {
   const {
     initialValue = null,
-    sync = true
+    sync = true,
+    persist = true
   } = options;
   const storageKey = useMemo(() => `${appId}_${key}`, [key]);
   const readValue = useCallback(() => {
+    if (!persist) return initialValue;
     try {
       const item = window.localStorage.getItem(storageKey);
       if (item == null) return initialValue;
@@ -30,7 +32,7 @@ export default function useLocalStorage(key, options = {}) {
     } catch (error) {
       return initialValue;
     }
-  }, [storageKey, initialValue]);
+  }, [storageKey, initialValue, persist]);
   const [storedValue, setStoredValue] = useState(readValue);
 
   /**
@@ -38,20 +40,25 @@ export default function useLocalStorage(key, options = {}) {
    * @param value The new value to store.
    */
   const setValue = useCallback(value => {
-    try {
-      const valueToStore = typeof value === 'function' ? value(readValue()) : value;
-      setStoredValue(valueToStore);
-      if (valueToStore == null) {
-        window.localStorage.removeItem(storageKey);
-      } else {
-        window.localStorage.setItem(storageKey, JSON.stringify(valueToStore));
+    // Resolve an updater against the live React state, so it sees the current value whether or not
+    // the value is persisted (when persist is off there is nothing to read back from storage).
+    setStoredValue(prev => {
+      const valueToStore = typeof value === 'function' ? value(prev) : value;
+      if (!persist) return valueToStore;
+      try {
+        if (valueToStore == null) {
+          window.localStorage.removeItem(storageKey);
+        } else {
+          window.localStorage.setItem(storageKey, JSON.stringify(valueToStore));
+        }
+      } catch (error) {
+        //
       }
-    } catch (error) {
-      //
-    }
-  }, [storageKey, readValue]);
+      return valueToStore;
+    });
+  }, [storageKey, persist]);
   useEffect(() => {
-    if (!sync) return undefined;
+    if (!sync || !persist) return undefined;
 
     /**
      * Handles cross-document localStorage updates.
@@ -78,6 +85,6 @@ export default function useLocalStorage(key, options = {}) {
     return () => {
       window.removeEventListener('storage', handleStorageChange);
     };
-  }, [storageKey, initialValue, sync]);
+  }, [storageKey, initialValue, sync, persist]);
   return [storedValue, setValue];
 }

package/core/hooks/useNavigation.d.ts

@@ -1,6 +1,14 @@
+import { push, pop, replace, reset, update } from '../router/helpers';
+export interface Navigation {
+    push: typeof push;
+    pop: typeof pop;
+    replace: typeof replace;
+    reset: typeof reset;
+    update: typeof update;
+}
 /**
  * Provides functions for navigation.
- * @returns {Object}
+ * @returns The navigation functions.
  */
-export function useNavigation(): Object;
+export declare function useNavigation(): Navigation;
 //# sourceMappingURL=useNavigation.d.ts.map

package/core/hooks/useNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigation.d.ts","sourceRoot":"","sources":["../../../core/hooks/useNavigation.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,iCAFa,MAAM,CAUlB"}
+{"version":3,"file":"useNavigation.d.ts","sourceRoot":"","sources":["../../../core/hooks/useNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAClC,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,MAAM,EAAE,OAAO,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAQ1C"}

package/core/hooks/useNavigation.js

@@ -1,8 +1,7 @@
 import { push, pop, replace, reset, update } from "../router/helpers";
-
 /**
  * Provides functions for navigation.
- * @returns {Object}
+ * @returns The navigation functions.
  */
 export function useNavigation() {
   return {

package/core/initialization/fetchSettings.d.ts

@@ -0,0 +1,12 @@
+interface SettingsStore {
+    dispatch: (action: unknown) => void;
+}
+/**
+ * Fetches all configured JSONP settings sources in parallel. Sources without a configured url
+ * are skipped. Never rejects - every source falls back to the defaults of its reducer.
+ * @param store Reference to the store.
+ * @returns A promise that resolves once all configured sources settled.
+ */
+export declare const fetchSettings: (store: SettingsStore) => Promise<void>;
+export {};
+//# sourceMappingURL=fetchSettings.d.ts.map

package/core/initialization/fetchSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchSettings.d.ts","sourceRoot":"","sources":["../../../core/initialization/fetchSettings.ts"],"names":[],"mappings":"AA0BA,UAAU,aAAa;IACrB,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAwHD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAU,OAAO,aAAa,KAAG,OAAO,CAAC,IAAI,CA0CtE,CAAC"}

package/core/initialization/fetchSettings.js

@@ -0,0 +1,134 @@
+import { withScope, captureMessage, Severity as SentrySeverity } from '@sentry/browser';
+import appConfig from '@shopgate/pwa-common/helpers/config';
+import { receiveShopSettings, errorShopSettings } from '@shopgate/engage/settings/action-creators/shopSettings';
+import { receiveMerchantSettings } from '@shopgate/engage/settings/action-creators/merchantSettings';
+import { receiveAppSettings } from '@shopgate/engage/settings/action-creators/appSettings';
+const REQUEST_TIMEOUT = 3000;
+
+/**
+ * The payload types the settings action creators declare. Derived rather than written out,
+ * because shopSettings and merchantSettings are untyped JS whose JSDoc describes their payload
+ * as `{Array}` / `{Object}` whereas the JSONP files actually send a settings object. Deriving
+ * keeps this file honest about the mismatch and picks up the real types once that JSDoc is fixed.
+ */
+
+/**
+ * Injects a script tag to fetch a settings JSONP.
+ * @param id The script id.
+ * @param src The script url.
+ * @param onError Callback for error situations.
+ */
+const injectScript = (id, src, onError) => {
+  const existingTag = document.querySelector(`#${id}`);
+  if (existingTag) {
+    existingTag.remove();
+  }
+  const scriptTag = document.createElement('script');
+  scriptTag.setAttribute('src', src);
+  scriptTag.setAttribute('id', id);
+  scriptTag.onerror = onError;
+  document.head.appendChild(scriptTag);
+};
+
+/**
+ * Loads a single JSONP settings source. Resolves when the payload arrived, when the script
+ * failed to load, or when REQUEST_TIMEOUT elapsed - it never rejects, so that no single
+ * source can block or delay app start indefinitely.
+ * @param params The loader params.
+ * @returns A promise that resolves once the source settled.
+ */
+const loadJsonpSettings = params => new Promise(resolve => {
+  const {
+    id,
+    url,
+    callbackName,
+    onReceive,
+    onError
+  } = params;
+  let settled = false;
+  let timeout;
+
+  /**
+   * Resolves the promise once, whichever of payload / error / timeout comes first.
+   */
+  const settle = () => {
+    if (settled) {
+      return;
+    }
+    settled = true;
+    clearTimeout(timeout);
+    resolve();
+  };
+
+  // Started before the callback and the script are wired up, so that a synchronously firing
+  // callback / error (e.g. a data: url) settles against an already assigned timeout - otherwise
+  // clearTimeout would no-op and this timer would still fire a false timeout warning.
+  timeout = setTimeout(() => {
+    withScope(scope => {
+      scope.setLevel(SentrySeverity.Warning);
+      scope.setExtra('settingsUrl', url);
+      scope.setExtra('timeout', REQUEST_TIMEOUT);
+      captureMessage(`Fetching settings took too long: ${id}`);
+    });
+    settle();
+  }, REQUEST_TIMEOUT);
+
+  // Registered before the script is injected, since the JSONP files guard their call with
+  // `window.setX && window.setX(...)` - a callback assigned too late is a silent no-op.
+  // Deliberately never removed: the timeout may settle while the script is still in flight,
+  // and a payload arriving after that should still hydrate the store.
+  window[callbackName] = settings => {
+    onReceive(settings);
+    settle();
+  };
+  injectScript(id, url, error => {
+    withScope(scope => {
+      scope.setLevel(SentrySeverity.Error);
+      scope.setExtra('settingsUrl', url);
+      captureMessage(`Fetching settings failed: ${id}`);
+    });
+    onError?.(error);
+    settle();
+  });
+});
+
+/**
+ * Fetches all configured JSONP settings sources in parallel. Sources without a configured url
+ * are skipped. Never rejects - every source falls back to the defaults of its reducer.
+ * @param store Reference to the store.
+ * @returns A promise that resolves once all configured sources settled.
+ */
+export const fetchSettings = async store => {
+  const {
+    settingsUrl,
+    merchantSettingsUrl,
+    appSettingsUrl
+  } = appConfig;
+  const loaders = [];
+  if (settingsUrl) {
+    loaders.push(loadJsonpSettings({
+      id: 'shop-settings-jsonp',
+      url: settingsUrl,
+      callbackName: 'setShopSettings',
+      onReceive: settings => store.dispatch(receiveShopSettings(settings)),
+      onError: error => store.dispatch(errorShopSettings(error))
+    }));
+  }
+  if (merchantSettingsUrl) {
+    loaders.push(loadJsonpSettings({
+      id: 'merchant-settings-jsonp',
+      url: merchantSettingsUrl,
+      callbackName: 'setMerchantSettings',
+      onReceive: settings => store.dispatch(receiveMerchantSettings(settings))
+    }));
+  }
+  if (appSettingsUrl) {
+    loaders.push(loadJsonpSettings({
+      id: 'app-settings-jsonp',
+      url: appSettingsUrl,
+      callbackName: 'setAppSettings',
+      onReceive: settings => store.dispatch(receiveAppSettings(settings))
+    }));
+  }
+  await Promise.all(loaders);
+};

package/core/initialization/index.d.ts

@@ -1,4 +1,35 @@
-export function initialize(locales: Object, reducers: Function, subscribers: any[]): Promise<{
-    store: Object;
+import type { Store as ReduxStore, UnknownAction } from 'redux';
+import { configureStore } from '@shopgate/pwa-common/store';
+declare global {
+    interface Window {
+        SGConnectDev?: {
+            isDevBrowser: boolean;
+            isDev: boolean;
+        };
+    }
+}
+/**
+ * The app's redux store. Assembled here because configureStore is untyped JS whose JSDoc widens
+ * the return value to `Object`.
+ *
+ * dispatch stays permissive rather than using redux-thunk's ThunkDispatch: the action creators
+ * this module dispatches are untyped JS annotated `@returns {Object}` / `{Function}`, which match
+ * neither UnknownAction nor ThunkAction. Tightening it here would only force casts at every call
+ * site - it needs the JSDoc on those action creators to be fixed first.
+ */
+type Store = Omit<ReduxStore<unknown, UnknownAction>, 'dispatch'> & {
+    dispatch: (action: unknown) => unknown;
+};
+/**
+ * Initializes the app: sets up i18n, creates the store, fetches the client information and the
+ * dynamic settings, and runs all registered app initialization handlers.
+ * @param locales An object with locales.
+ * @param reducers The reducers from the theme.
+ * @param subscribers The subscribers to the streams middleware.
+ * @returns The initialized store.
+ */
+export declare const initialize: (locales: Record<string, unknown>, reducers: Parameters<typeof configureStore>[0], subscribers: Parameters<typeof configureStore>[1]) => Promise<{
+    store: Store;
 }>;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/core/initialization/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/initialization/index.js"],"names":[],"mappings":"AAuIO,oCAJI,MAAM;;GAuDhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/initialization/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,IAAI,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAqB5D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,YAAY,CAAC,EAAE;YACb,YAAY,EAAE,OAAO,CAAC;YACtB,KAAK,EAAE,OAAO,CAAC;SAChB,CAAC;KACH;CACF;AAED;;;;;;;;GAQG;AACH,KAAK,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,UAAU,CAAC,GAAG;IAClE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CACxC,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,EAC9C,aAAa,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;;EA4ElD,CAAC"}