@shopgate/engage 7.32.0-beta.2 → 7.32.0-beta.3

package/admin-preview/constants/index.d.ts

@@ -1,25 +1,4 @@
-export { PAGE_PREVIEW_PATTERN } from '../detection';
-/**
- * Whether the app is currently in page admin preview mode.
- *
- * Snapshot taken when this module is first evaluated. Prefer the isPageAdminPreviewActive()
- * helper, which re-evaluates on every call.
- */
-export declare const IS_PAGE_ADMIN_PREVIEW_ACTIVE: boolean;
-/**
- * Whether the app is currently in frontend settings admin preview mode.
- *
- * Snapshot taken when this module is first evaluated. Prefer the
- * isFrontendSettingsAdminPreviewActive() helper, which re-evaluates on every call.
- */
-export declare const IS_FRONTEND_SETTINGS_ADMIN_PREVIEW_ACTIVE: boolean;
-/**
- * Whether the app is currently in admin preview mode (pages or frontend settings).
- *
- * Snapshot taken when this module is first evaluated. Prefer the isAdminPreviewActive() helper,
- * which re-evaluates on every call.
- */
-export declare const IS_ADMIN_PREVIEW_ACTIVE: boolean;
+export declare const PAGE_PREVIEW_PATTERN = "/shopgate-internal-page-preview";
 /**
  * List of allowed origins for cms page preview iFrame communication.
  */

package/admin-preview/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../admin-preview/constants/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,SAA2B,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,yCAAyC,SAAuC,CAAC;AAE9F;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,SAAuB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,6BAA6B,UAMzC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../admin-preview/constants/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,oCAAoC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,6BAA6B,UAMzC,CAAC"}

package/admin-preview/constants/index.js

@@ -1,29 +1,4 @@
-import { detectAdminPreview, detectFrontendSettingsAdminPreview, detectPageAdminPreview } from "../detection";
-export { PAGE_PREVIEW_PATTERN } from "../detection";
-
-/**
- * Whether the app is currently in page admin preview mode.
- *
- * Snapshot taken when this module is first evaluated. Prefer the isPageAdminPreviewActive()
- * helper, which re-evaluates on every call.
- */
-export const IS_PAGE_ADMIN_PREVIEW_ACTIVE = detectPageAdminPreview();
-
-/**
- * Whether the app is currently in frontend settings admin preview mode.
- *
- * Snapshot taken when this module is first evaluated. Prefer the
- * isFrontendSettingsAdminPreviewActive() helper, which re-evaluates on every call.
- */
-export const IS_FRONTEND_SETTINGS_ADMIN_PREVIEW_ACTIVE = detectFrontendSettingsAdminPreview();
-
-/**
- * Whether the app is currently in admin preview mode (pages or frontend settings).
- *
- * Snapshot taken when this module is first evaluated. Prefer the isAdminPreviewActive() helper,
- * which re-evaluates on every call.
- */
-export const IS_ADMIN_PREVIEW_ACTIVE = detectAdminPreview();
+export const PAGE_PREVIEW_PATTERN = '/shopgate-internal-page-preview';
 
 /**
  * List of allowed origins for cms page preview iFrame communication.

package/admin-preview/{detection.d.ts → helpers/_internal/detection.d.ts}

@@ -1,17 +1,19 @@
-export declare const PAGE_PREVIEW_PATTERN = "/shopgate-internal-page-preview";
+/**
+ * Internal to the admin-preview package - do not import this module from anywhere else. Consume
+ * the isAdminPreviewActive / isPageAdminPreviewActive / isFrontendSettingsAdminPreviewActive
+ * helpers from @shopgate/engage/admin-preview/helpers instead.
+ */
 export declare const FRONTEND_SETTINGS_PREVIEW_PARAM = "frontendSettingsPreview=true";
-export declare const SESSION_STORAGE_KEY_PAGE_PREVIEW = "sgPageAdminPreview";
-export declare const SESSION_STORAGE_KEY_FRONTEND_SETTINGS_PREVIEW = "sgFrontendSettingsAdminPreview";
 /**
- * Detects whether the app is in page admin preview mode. Once detected, the result is remembered
- * for the rest of the session, because the url is not guaranteed to keep the preview marker.
+ * Detects whether the app is in page admin preview mode. Once detected, the result is latched for
+ * the lifetime of the document, because the url is not guaranteed to keep the preview marker.
  * @returns True if the app is in page admin preview mode, false otherwise.
  */
 export declare const detectPageAdminPreview: () => boolean;
 /**
  * Detects whether the app is in frontend settings admin preview mode. Once detected, the result is
- * remembered for the rest of the session, because the url is not guaranteed to keep the query
- * param.
+ * latched for the lifetime of the document, because the app keeps navigating while the preview is
+ * open and the query param only exists on the url it started on.
  * @returns True if the app is in frontend settings admin preview mode, false otherwise.
  */
 export declare const detectFrontendSettingsAdminPreview: () => boolean;
@@ -26,6 +28,8 @@ export declare const detectAdminPreview: () => boolean;
  *
  *   window.SGAdminPreviewDebug()
  *
+ * Compare initialHref with currentHref to see whether the url changed since the app booted, and
+ * check latched to see whether a result came from the latch rather than the current url.
  * @returns A snapshot of everything detection depends on.
  */
 export declare const getAdminPreviewDebugInfo: () => {
@@ -36,7 +40,7 @@ export declare const getAdminPreviewDebugInfo: () => {
     urlChangedSinceBoot: boolean;
     isInIframe: boolean;
     referrer: string;
-    stickyFlags: {
+    latched: {
         page: boolean;
         frontendSettings: boolean;
     };

package/admin-preview/helpers/_internal/detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../../../admin-preview/helpers/_internal/detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,+BAA+B,iCAAiC,CAAC;AAsB9E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAO,OAQzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,QAAO,OAWrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAC4B,CAAC;AAEnE;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;CAiBnC,CAAC"}

package/admin-preview/helpers/_internal/detection.js

@@ -0,0 +1,93 @@
+import "core-js/modules/es.array.includes.js";
+/**
+ * Internal to the admin-preview package - do not import this module from anywhere else. Consume
+ * the isAdminPreviewActive / isPageAdminPreviewActive / isFrontendSettingsAdminPreviewActive
+ * helpers from @shopgate/engage/admin-preview/helpers instead.
+ */
+
+import { PAGE_PREVIEW_PATTERN } from "../../constants";
+export const FRONTEND_SETTINGS_PREVIEW_PARAM = 'frontendSettingsPreview=true';
+
+/**
+ * The url as it was when this module was first evaluated. Captured here because detection can run
+ * again later, when the url may already have been rewritten.
+ */
+const INITIAL_HREF = window.location.href;
+
+/**
+ * Preview mode is latched in memory rather than persisted. Session storage is scoped per origin
+ * per tab, not per iframe - the admin shows the preview in same-origin iframes on several screens
+ * within one tab, so a persisted flag from one screen would leak into the next. Module state is
+ * per document, so each iframe gets its own.
+ *
+ * The latches only ever go false -> true. Detection must not fall back to re-reading the url,
+ * because the frontend settings preview navigates the app normally: once the admin opens another
+ * page, the query param is gone from the url even though preview mode is still on.
+ */
+let pageAdminPreviewLatched = false;
+let frontendSettingsAdminPreviewLatched = false;
+
+/**
+ * Detects whether the app is in page admin preview mode. Once detected, the result is latched for
+ * the lifetime of the document, because the url is not guaranteed to keep the preview marker.
+ * @returns True if the app is in page admin preview mode, false otherwise.
+ */
+export const detectPageAdminPreview = () => {
+  if (pageAdminPreviewLatched) {
+    return true;
+  }
+  pageAdminPreviewLatched = window.location.pathname.startsWith(PAGE_PREVIEW_PATTERN);
+  return pageAdminPreviewLatched;
+};
+
+/**
+ * Detects whether the app is in frontend settings admin preview mode. Once detected, the result is
+ * latched for the lifetime of the document, because the app keeps navigating while the preview is
+ * open and the query param only exists on the url it started on.
+ * @returns True if the app is in frontend settings admin preview mode, false otherwise.
+ */
+export const detectFrontendSettingsAdminPreview = () => {
+  if (frontendSettingsAdminPreviewLatched) {
+    return true;
+  }
+  frontendSettingsAdminPreviewLatched = window.location.search.includes(FRONTEND_SETTINGS_PREVIEW_PARAM);
+  return frontendSettingsAdminPreviewLatched;
+};
+
+/**
+ * Detects whether the app is in admin preview mode (pages or frontend settings).
+ * @returns True if the app is in admin preview mode, false otherwise.
+ */
+export const detectAdminPreview = () => detectPageAdminPreview() || detectFrontendSettingsAdminPreview();
+
+/**
+ * Returns the current detection state. Exposed on window as SGAdminPreviewDebug so the values can
+ * be inspected on a deployed build, from the console of the preview iframe:
+ *
+ *   window.SGAdminPreviewDebug()
+ *
+ * Compare initialHref with currentHref to see whether the url changed since the app booted, and
+ * check latched to see whether a result came from the latch rather than the current url.
+ * @returns A snapshot of everything detection depends on.
+ */
+export const getAdminPreviewDebugInfo = () => ({
+  initialHref: INITIAL_HREF,
+  currentHref: window.location.href,
+  pathname: window.location.pathname,
+  search: window.location.search,
+  urlChangedSinceBoot: INITIAL_HREF !== window.location.href,
+  isInIframe: window.parent !== window,
+  referrer: document.referrer,
+  latched: {
+    page: pageAdminPreviewLatched,
+    frontendSettings: frontendSettingsAdminPreviewLatched
+  },
+  detected: {
+    page: detectPageAdminPreview(),
+    frontendSettings: detectFrontendSettingsAdminPreview(),
+    any: detectAdminPreview()
+  }
+});
+
+// @ts-expect-error - debug-only global, intentionally not on the Window type.
+window.SGAdminPreviewDebug = getAdminPreviewDebugInfo;

package/admin-preview/helpers/index.d.ts

@@ -13,4 +13,11 @@ export declare const isPageAdminPreviewActive: () => boolean;
  * @returns True if the app is in frontend settings admin preview mode, false otherwise.
  */
 export declare const isFrontendSettingsAdminPreviewActive: () => boolean;
+/**
+ * Checks if navigation is blocked. Page admin preview renders a single page in an iframe, so
+ * leaving that page would only ever show the admin something it did not ask to preview.
+ * Frontend settings preview is not affected - it previews styling on the regular app.
+ * @returns True if the app must not navigate, false otherwise.
+ */
+export declare const isNavigationBlocked: () => boolean;
 //# sourceMappingURL=index.d.ts.map

package/admin-preview/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../admin-preview/helpers/index.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAO,OAClB,CAAC;AAEvB;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAAO,OAClB,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,oCAAoC,QAAO,OAClB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../admin-preview/helpers/index.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAO,OAClB,CAAC;AAEvB;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAAO,OAClB,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,oCAAoC,QAAO,OAClB,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAO,OACX,CAAC"}

package/admin-preview/helpers/index.js

@@ -1,4 +1,4 @@
-import { detectAdminPreview, detectFrontendSettingsAdminPreview, detectPageAdminPreview } from "../detection";
+import { detectAdminPreview, detectFrontendSettingsAdminPreview, detectPageAdminPreview } from "./_internal/detection";
 
 /**
  * Checks if the app is currently in admin preview mode (pages or frontend settings).
@@ -16,4 +16,12 @@ export const isPageAdminPreviewActive = () => detectPageAdminPreview();
  * Checks if the app is currently in frontend settings admin preview mode.
  * @returns True if the app is in frontend settings admin preview mode, false otherwise.
  */
-export const isFrontendSettingsAdminPreviewActive = () => detectFrontendSettingsAdminPreview();
+export const isFrontendSettingsAdminPreviewActive = () => detectFrontendSettingsAdminPreview();
+
+/**
+ * Checks if navigation is blocked. Page admin preview renders a single page in an iframe, so
+ * leaving that page would only ever show the admin something it did not ask to preview.
+ * Frontend settings preview is not affected - it previews styling on the regular app.
+ * @returns True if the app must not navigate, false otherwise.
+ */
+export const isNavigationBlocked = () => isPageAdminPreviewActive();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopgate/engage",
-  "version": "7.32.0-beta.2",
+  "version": "7.32.0-beta.3",
   "description": "Shopgate's ENGAGE library.",
   "license": "Apache-2.0",
   "author": "Shopgate <support@shopgate.com>",
@@ -18,12 +18,12 @@
   "dependencies": {
     "@emotion/react": "^11.14.0",
     "@shopgate/native-modules": "1.0.0-beta.25",
-    "@shopgate/pwa-common": "7.32.0-beta.2",
-    "@shopgate/pwa-common-commerce": "7.32.0-beta.2",
-    "@shopgate/pwa-core": "7.32.0-beta.2",
-    "@shopgate/pwa-ui-ios": "7.32.0-beta.2",
-    "@shopgate/pwa-ui-material": "7.32.0-beta.2",
-    "@shopgate/pwa-ui-shared": "7.32.0-beta.2",
+    "@shopgate/pwa-common": "7.32.0-beta.3",
+    "@shopgate/pwa-common-commerce": "7.32.0-beta.3",
+    "@shopgate/pwa-core": "7.32.0-beta.3",
+    "@shopgate/pwa-ui-ios": "7.32.0-beta.3",
+    "@shopgate/pwa-ui-material": "7.32.0-beta.3",
+    "@shopgate/pwa-ui-shared": "7.32.0-beta.3",
     "@stripe/react-stripe-js": "^1.16.5",
     "@stripe/stripe-js": "^1.44.1",
     "@virtuous/conductor": "~2.5.0",
@@ -46,7 +46,7 @@
     "validate.js": "^0.13.1"
   },
   "devDependencies": {
-    "@shopgate/pwa-unit-test": "7.32.0-beta.2",
+    "@shopgate/pwa-unit-test": "7.32.0-beta.3",
     "@types/color": "^4.2.0",
     "@types/lodash": "^4.17.24",
     "@types/react-dom": "^17.0.2",

package/page/components/ResponsiveWidgetImage/ResponsiveWidgetImage.js

@@ -2,7 +2,7 @@ import React, { useMemo, useState, useEffect } from 'react';
 import PropTypes from 'prop-types';
 import { makeStyles, useResponsiveValue } from '@shopgate/engage/styles';
 import { useParallax } from 'react-scroll-parallax';
-import { IS_PAGE_PREVIEW_ACTIVE } from "../../constants";
+import { isAdminPreviewActive } from '@shopgate/engage/admin-preview/helpers';
 import { parseImageUrl } from "../../helpers";
 
 /**
@@ -143,7 +143,7 @@ const ResponsiveWidgetImage = ({
       // height 0 until a resize forces the browser to re-evaluate. Load eagerly there; keep lazy
       // loading for the live app.
       ,
-      loading: IS_PAGE_PREVIEW_ACTIVE ? 'eager' : 'lazy',
+      loading: isAdminPreviewActive() ? 'eager' : 'lazy',
       className: cx(classes.preventSave, classes.image, {
         [classes.banner]: isBanner
       }, className),

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/styles/theme/providers/ThemeProvider.js

@@ -1,7 +1,7 @@
 import { createContext, memo, useMemo, useLayoutEffect } from 'react';
 import useLocalStorage from '@shopgate/engage/core/hooks/useLocalStorage';
 import { GlobalStyles } from '@shopgate/engage/styles';
-import { IS_FRONTEND_SETTINGS_ADMIN_PREVIEW_ACTIVE } from '@shopgate/engage/admin-preview/constants';
+import { isFrontendSettingsAdminPreviewActive } from '@shopgate/engage/admin-preview/helpers';
 import { FrontendSettingsPreviewBridge } from '@shopgate/engage/admin-preview/components';
 import ActiveBreakpointProvider from "./ActiveBreakpointProvider";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
@@ -32,7 +32,7 @@ const ThemeProvider = ({
   const styleSheets = useMemo(() => theme.generateStyleSheets(), [theme]);
   return /*#__PURE__*/_jsxs(ColorSchemeContext.Provider, {
     value: colorSchemeContextValue,
-    children: [IS_FRONTEND_SETTINGS_ADMIN_PREVIEW_ACTIVE && /*#__PURE__*/_jsx(FrontendSettingsPreviewBridge, {}), /*#__PURE__*/_jsxs(ThemeContext.Provider, {
+    children: [isFrontendSettingsAdminPreviewActive() && /*#__PURE__*/_jsx(FrontendSettingsPreviewBridge, {}), /*#__PURE__*/_jsxs(ThemeContext.Provider, {
       value: theme,
       children: [/*#__PURE__*/_jsx(ActiveBreakpointProvider, {
         children: children

package/admin-preview/detection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../admin-preview/detection.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,oCAAoC,CAAC;AAEtE,eAAO,MAAM,+BAA+B,iCAAiC,CAAC;AAE9E,eAAO,MAAM,gCAAgC,uBAAuB,CAAC;AAErE,eAAO,MAAM,6CAA6C,mCAAmC,CAAC;AAyF9F;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAO,OAYzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,QAAO,OAYrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAC4B,CAAC;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;CAiBnC,CAAC"}

package/admin-preview/detection.js

@@ -1,166 +0,0 @@
-import "core-js/modules/es.array.includes.js";
-// The logger is imported from @shopgate/pwa-core/helpers rather than @shopgate/engage/core/helpers
-// on purpose: that barrel pulls in scrollContainer, which imports this module back. Since detection
-// runs while the constants module is evaluated, the cycle would resolve to undefined at boot.
-import { logger } from '@shopgate/pwa-core/helpers';
-export const PAGE_PREVIEW_PATTERN = '/shopgate-internal-page-preview';
-export const FRONTEND_SETTINGS_PREVIEW_PARAM = 'frontendSettingsPreview=true';
-export const SESSION_STORAGE_KEY_PAGE_PREVIEW = 'sgPageAdminPreview';
-export const SESSION_STORAGE_KEY_FRONTEND_SETTINGS_PREVIEW = 'sgFrontendSettingsAdminPreview';
-const LOG_PREFIX = '[AdminPreview]';
-
-/**
- * The url as it was when this module was first evaluated. Captured here because detection can run
- * again later, when the url may already have been rewritten.
- */
-const INITIAL_HREF = window.location.href;
-
-/**
- * Remembers the last logged result per detector, so repeated calls only log on a real change.
- * isAdminPreviewActive() is called from hot paths like breakpoints and scroll handling.
- */
-const lastLoggedResults = {};
-
-/**
- * Reads a sticky preview flag. Storage access throws in a sandboxed iframe without
- * "allow-same-origin", and is blocked by some browsers in cross-origin iframes - the preview
- * runs in exactly that context, so a throw here would break app boot for everyone.
- * @param key The session storage key to read.
- * @returns True when the flag was persisted before, false otherwise.
- */
-const readStickyFlag = key => {
-  try {
-    return window.sessionStorage.getItem(key) === '1';
-  } catch (error) {
-    logger.warn(`${LOG_PREFIX} session storage is not readable`, {
-      key,
-      error
-    });
-    return false;
-  }
-};
-
-/**
- * Persists a sticky preview flag, so preview mode survives a reload or a url rewrite that drops
- * the query string. See readStickyFlag for why this can throw.
- * @param key The session storage key to write.
- */
-const writeStickyFlag = key => {
-  try {
-    window.sessionStorage.setItem(key, '1');
-  } catch (error) {
-    logger.warn(`${LOG_PREFIX} session storage is not writable`, {
-      key,
-      error
-    });
-  }
-};
-
-/**
- * Logs how a detection result was reached, but only when it differs from the previous result for
- * that detector. Kept verbose on purpose: it exists to investigate why preview mode is not picked
- * up on deployed builds.
- * @param name The detector that produced the result.
- * @param result The detected result.
- * @param matchedUrl Whether the current url carries the preview marker.
- * @param matchedStickyFlag Whether the persisted sticky flag was set.
- */
-const logDetection = (name, result, matchedUrl, matchedStickyFlag) => {
-  if (lastLoggedResults[name] === result) {
-    return;
-  }
-  lastLoggedResults[name] = result;
-  logger.log(`${LOG_PREFIX} ${name} -> ${result}`, {
-    result,
-    // True when the url still carries the marker.
-    matchedUrl,
-    // True when the result came from the persisted flag - i.e. the url lost the marker.
-    matchedStickyFlag,
-    // Compare these two to see whether the url changed since the app booted.
-    initialHref: INITIAL_HREF,
-    currentHref: window.location.href,
-    pathname: window.location.pathname,
-    search: window.location.search,
-    // A cross-origin parent means the app really is embedded in the admin.
-    isInIframe: window.parent !== window,
-    referrer: document.referrer
-  });
-};
-
-/**
- * Detects whether the app is in page admin preview mode. Once detected, the result is remembered
- * for the rest of the session, because the url is not guaranteed to keep the preview marker.
- * @returns True if the app is in page admin preview mode, false otherwise.
- */
-export const detectPageAdminPreview = () => {
-  const matchedUrl = window.location.pathname.startsWith(PAGE_PREVIEW_PATTERN);
-  if (matchedUrl) {
-    writeStickyFlag(SESSION_STORAGE_KEY_PAGE_PREVIEW);
-    logDetection('detectPageAdminPreview', true, true, false);
-    return true;
-  }
-  const matchedStickyFlag = readStickyFlag(SESSION_STORAGE_KEY_PAGE_PREVIEW);
-  logDetection('detectPageAdminPreview', matchedStickyFlag, false, matchedStickyFlag);
-  return matchedStickyFlag;
-};
-
-/**
- * Detects whether the app is in frontend settings admin preview mode. Once detected, the result is
- * remembered for the rest of the session, because the url is not guaranteed to keep the query
- * param.
- * @returns True if the app is in frontend settings admin preview mode, false otherwise.
- */
-export const detectFrontendSettingsAdminPreview = () => {
-  const matchedUrl = window.location.search.includes(FRONTEND_SETTINGS_PREVIEW_PARAM);
-  if (matchedUrl) {
-    writeStickyFlag(SESSION_STORAGE_KEY_FRONTEND_SETTINGS_PREVIEW);
-    logDetection('detectFrontendSettingsAdminPreview', true, true, false);
-    return true;
-  }
-  const matchedStickyFlag = readStickyFlag(SESSION_STORAGE_KEY_FRONTEND_SETTINGS_PREVIEW);
-  logDetection('detectFrontendSettingsAdminPreview', matchedStickyFlag, false, matchedStickyFlag);
-  return matchedStickyFlag;
-};
-
-/**
- * Detects whether the app is in admin preview mode (pages or frontend settings).
- * @returns True if the app is in admin preview mode, false otherwise.
- */
-export const detectAdminPreview = () => detectPageAdminPreview() || detectFrontendSettingsAdminPreview();
-
-/**
- * Returns the current detection state. Exposed on window as SGAdminPreviewDebug so the values can
- * be inspected on a deployed build, from the console of the preview iframe:
- *
- *   window.SGAdminPreviewDebug()
- *
- * @returns A snapshot of everything detection depends on.
- */
-export const getAdminPreviewDebugInfo = () => ({
-  initialHref: INITIAL_HREF,
-  currentHref: window.location.href,
-  pathname: window.location.pathname,
-  search: window.location.search,
-  urlChangedSinceBoot: INITIAL_HREF !== window.location.href,
-  isInIframe: window.parent !== window,
-  referrer: document.referrer,
-  stickyFlags: {
-    page: readStickyFlag(SESSION_STORAGE_KEY_PAGE_PREVIEW),
-    frontendSettings: readStickyFlag(SESSION_STORAGE_KEY_FRONTEND_SETTINGS_PREVIEW)
-  },
-  detected: {
-    page: detectPageAdminPreview(),
-    frontendSettings: detectFrontendSettingsAdminPreview(),
-    any: detectAdminPreview()
-  }
-});
-logger.log(`${LOG_PREFIX} module evaluated`, {
-  href: INITIAL_HREF,
-  search: window.location.search,
-  hasParamAtBoot: window.location.search.includes(FRONTEND_SETTINGS_PREVIEW_PARAM),
-  isInIframe: window.parent !== window,
-  referrer: document.referrer
-});
-
-// @ts-expect-error - debug-only global, intentionally not on the Window type.
-window.SGAdminPreviewDebug = getAdminPreviewDebugInfo;