@wavemaker-ai/react-runtime 1.0.0-rc.309

package/runtime-dynamic/factories/utils.js

@@ -0,0 +1,131 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildDynamicComponent = buildDynamicComponent;
+exports.createDynamicInnerComponent = createDynamicInnerComponent;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _react = _interopRequireWildcard(require("react"));
+var _WidgetProvider = require("@wavemaker-ai/react-runtime/context/WidgetProvider");
+var _AppContext = require("@wavemaker-ai/react-runtime/context/AppContext");
+var _scriptExecutor = require("../services/script-executor");
+var _variableTranspiler = require("../services/variable-transpiler");
+var _markupTranspiler = require("../services/markup-transpiler");
+var _cssScoping = require("../services/css-scoping");
+var _utils = require("../utils");
+var _startupInfo = require("./startup-info");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t2 in e) "default" !== _t2 && {}.hasOwnProperty.call(e, _t2) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t2)) && (i.get || i.set) ? o(f, _t2, i) : f[_t2] = e[_t2]); return f; })(e, t); }
+var __jsx = _react["default"].createElement;
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2["default"])(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function usePageEvents(appState, componentType) {
+  var appStateRef = (0, _react.useRef)(appState);
+  appStateRef.current = appState;
+  (0, _react.useEffect)(function () {
+    var _appStateRef$current, _appStateRef$current$;
+    if (componentType !== "page") return;
+    (_appStateRef$current = appStateRef.current) === null || _appStateRef$current === void 0 || (_appStateRef$current$ = _appStateRef$current.attach) === null || _appStateRef$current$ === void 0 || _appStateRef$current$.call(_appStateRef$current);
+    var onOrientationChange = function onOrientationChange() {
+      var _appStateRef$current2, _appStateRef$current3;
+      return (_appStateRef$current2 = appStateRef.current) === null || _appStateRef$current2 === void 0 || (_appStateRef$current3 = _appStateRef$current2.orientationchange) === null || _appStateRef$current3 === void 0 ? void 0 : _appStateRef$current3.call(_appStateRef$current2);
+    };
+    var onResize = function onResize() {
+      var _appStateRef$current4, _appStateRef$current5;
+      return (_appStateRef$current4 = appStateRef.current) === null || _appStateRef$current4 === void 0 || (_appStateRef$current5 = _appStateRef$current4.resize) === null || _appStateRef$current5 === void 0 ? void 0 : _appStateRef$current5.call(_appStateRef$current4);
+    };
+    window.addEventListener("orientationchange", onOrientationChange);
+    window.addEventListener("resize", onResize);
+    return function () {
+      var _appStateRef$current6, _appStateRef$current7;
+      window.removeEventListener("orientationchange", onOrientationChange);
+      window.removeEventListener("resize", onResize);
+      (_appStateRef$current6 = appStateRef.current) === null || _appStateRef$current6 === void 0 || (_appStateRef$current7 = _appStateRef$current6.destroy) === null || _appStateRef$current7 === void 0 || _appStateRef$current7.call(_appStateRef$current6);
+    };
+  }, []);
+}
+function createDynamicInnerComponent(_ref) {
+  var componentName = _ref.componentName,
+    componentType = _ref.componentType,
+    transpiled = _ref.transpiled,
+    styles = _ref.styles;
+  var InnerComponent = function InnerComponent(props) {
+    var _useAppContext;
+    var appState = (0, _WidgetProvider.useAppState)();
+    var stateProxy = (0, _WidgetProvider.useProxy)();
+    usePageEvents(appState, componentType);
+    var appStateRef = (0, _react.useRef)(appState);
+    appStateRef.current = appState;
+    var notification = (_useAppContext = (0, _AppContext.useAppContext)()) === null || _useAppContext === void 0 ? void 0 : _useAppContext.notification;
+    (0, _react.useEffect)(function () {
+      if (styles) {
+        (0, _cssScoping.scopeComponentStyles)(componentName, componentType, styles);
+      }
+      return function () {
+        (0, _cssScoping.removeComponentStyles)(componentName, componentType);
+      };
+    }, []);
+    (0, _react.useEffect)(function () {
+      if (appState) {
+        appState.pageReady();
+      }
+    }, []);
+    (0, _react.useEffect)(function () {
+      var _props$onRender;
+      props === null || props === void 0 || (_props$onRender = props.onRender) === null || _props$onRender === void 0 || _props$onRender.call(props, stateProxy);
+    }, []);
+    if (!transpiled) return null;
+    var renderState = notification ? _objectSpread(_objectSpread({}, appState), {}, {
+      notification: notification
+    }) : appState;
+    return __jsx(_react["default"].Fragment, null, (0, _markupTranspiler.renderTranspiledMarkup)(transpiled, renderState));
+  };
+  return InnerComponent;
+}
+
+// --- Shared builder used by page, partial, and prefab factories ---
+function buildDynamicComponent(_x, _x2) {
+  return _buildDynamicComponent.apply(this, arguments);
+}
+function _buildDynamicComponent() {
+  _buildDynamicComponent = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee(fragment, config) {
+    var markup, script, styles, variables, componentName, componentType, scriptScope, hoc, componentInfo, transpileOptions, addPageScript, transpiled, variablesCodeString, getVariables, InnerComponent, startupInfo, info;
+    return _regenerator["default"].wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          markup = fragment.markup, script = fragment.script, styles = fragment.styles, variables = fragment.variables;
+          componentName = config.componentName, componentType = config.componentType, scriptScope = config.scriptScope, hoc = config.hoc, componentInfo = config.componentInfo, transpileOptions = config.transpileOptions;
+          addPageScript = (0, _scriptExecutor.buildAddPageScript)(script, scriptScope, componentName);
+          transpiled = (0, _markupTranspiler.transpileFragment)(markup, transpileOptions ? _objectSpread({
+            variables: variables
+          }, transpileOptions) : variables);
+          _context.next = 6;
+          return (0, _utils.yieldToMain)();
+        case 6:
+          variablesCodeString = (transpiled === null || transpiled === void 0 ? void 0 : transpiled.variables) || "";
+          getVariables = (0, _variableTranspiler.transpileAndBuildGetVariables)(variablesCodeString, variables);
+          _context.next = 10;
+          return (0, _utils.yieldToMain)();
+        case 10:
+          InnerComponent = createDynamicInnerComponent({
+            componentName: componentName,
+            componentType: componentType,
+            transpiled: transpiled,
+            styles: styles
+          });
+          InnerComponent.displayName = config.displayName || "Dynamic".concat(componentType.charAt(0).toUpperCase() + componentType.slice(1), "(").concat(componentName, ")");
+          startupInfo = (0, _startupInfo.buildStartupInfo)(variables);
+          info = componentInfo(startupInfo);
+          return _context.abrupt("return", hoc(InnerComponent, addPageScript, getVariables, info));
+        case 15:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return _buildDynamicComponent.apply(this, arguments);
+}

package/runtime-dynamic/index.d.ts

@@ -0,0 +1,14 @@
+export { App, initPreviewRuntimeRouter } from "./App";
+export { createAppRouter } from "./routes";
+export { isRuntimePreviewPrefab, PREFAB_PREVIEW_PATH, PREFAB_PREVIEW_ROUTE_PATH, PREFAB_PREVIEW_ROUTE_SEGMENT, } from "./preview-mode";
+export { initializeApp, getProjectConfig } from "./app-initializer";
+export { getComponent, hasComponent, registerComponent, getAllComponentNames } from "./registry";
+export { registerCustomWidget, getCustomWidget, hasCustomWidget } from "./registry";
+export { transpileAndRender, transpileFragment, renderTranspiledMarkup, clearTranspileCache, } from "./services/markup-transpiler";
+export { transpileAndBuildGetVariables, clearVariablesCache } from "./services/variable-transpiler";
+export { getComponentRef, clearComponentRefCache, ComponentType } from "./services";
+export { buildBasePageLikeComponent, type BasePageLikeKind, } from "./factories/build-base-page-like-component";
+export { buildPrefabComponent } from "./factories/prefab-factory";
+export { PageWrapper } from "./components/PageWrapper";
+export { PrefabPreview } from "./components/PrefabPreview";
+export type { DecodedFragment, PageMinJSON } from "./services";

package/runtime-dynamic/index.js

@@ -0,0 +1,191 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "App", {
+  enumerable: true,
+  get: function get() {
+    return _App.App;
+  }
+});
+Object.defineProperty(exports, "ComponentType", {
+  enumerable: true,
+  get: function get() {
+    return _services.ComponentType;
+  }
+});
+Object.defineProperty(exports, "PREFAB_PREVIEW_PATH", {
+  enumerable: true,
+  get: function get() {
+    return _previewMode.PREFAB_PREVIEW_PATH;
+  }
+});
+Object.defineProperty(exports, "PREFAB_PREVIEW_ROUTE_PATH", {
+  enumerable: true,
+  get: function get() {
+    return _previewMode.PREFAB_PREVIEW_ROUTE_PATH;
+  }
+});
+Object.defineProperty(exports, "PREFAB_PREVIEW_ROUTE_SEGMENT", {
+  enumerable: true,
+  get: function get() {
+    return _previewMode.PREFAB_PREVIEW_ROUTE_SEGMENT;
+  }
+});
+Object.defineProperty(exports, "PageWrapper", {
+  enumerable: true,
+  get: function get() {
+    return _PageWrapper.PageWrapper;
+  }
+});
+Object.defineProperty(exports, "PrefabPreview", {
+  enumerable: true,
+  get: function get() {
+    return _PrefabPreview.PrefabPreview;
+  }
+});
+Object.defineProperty(exports, "buildBasePageLikeComponent", {
+  enumerable: true,
+  get: function get() {
+    return _buildBasePageLikeComponent.buildBasePageLikeComponent;
+  }
+});
+Object.defineProperty(exports, "buildPrefabComponent", {
+  enumerable: true,
+  get: function get() {
+    return _prefabFactory.buildPrefabComponent;
+  }
+});
+Object.defineProperty(exports, "clearComponentRefCache", {
+  enumerable: true,
+  get: function get() {
+    return _services.clearComponentRefCache;
+  }
+});
+Object.defineProperty(exports, "clearTranspileCache", {
+  enumerable: true,
+  get: function get() {
+    return _markupTranspiler.clearTranspileCache;
+  }
+});
+Object.defineProperty(exports, "clearVariablesCache", {
+  enumerable: true,
+  get: function get() {
+    return _variableTranspiler.clearVariablesCache;
+  }
+});
+Object.defineProperty(exports, "createAppRouter", {
+  enumerable: true,
+  get: function get() {
+    return _routes.createAppRouter;
+  }
+});
+Object.defineProperty(exports, "getAllComponentNames", {
+  enumerable: true,
+  get: function get() {
+    return _registry.getAllComponentNames;
+  }
+});
+Object.defineProperty(exports, "getComponent", {
+  enumerable: true,
+  get: function get() {
+    return _registry.getComponent;
+  }
+});
+Object.defineProperty(exports, "getComponentRef", {
+  enumerable: true,
+  get: function get() {
+    return _services.getComponentRef;
+  }
+});
+Object.defineProperty(exports, "getCustomWidget", {
+  enumerable: true,
+  get: function get() {
+    return _registry.getCustomWidget;
+  }
+});
+Object.defineProperty(exports, "getProjectConfig", {
+  enumerable: true,
+  get: function get() {
+    return _appInitializer.getProjectConfig;
+  }
+});
+Object.defineProperty(exports, "hasComponent", {
+  enumerable: true,
+  get: function get() {
+    return _registry.hasComponent;
+  }
+});
+Object.defineProperty(exports, "hasCustomWidget", {
+  enumerable: true,
+  get: function get() {
+    return _registry.hasCustomWidget;
+  }
+});
+Object.defineProperty(exports, "initPreviewRuntimeRouter", {
+  enumerable: true,
+  get: function get() {
+    return _App.initPreviewRuntimeRouter;
+  }
+});
+Object.defineProperty(exports, "initializeApp", {
+  enumerable: true,
+  get: function get() {
+    return _appInitializer.initializeApp;
+  }
+});
+Object.defineProperty(exports, "isRuntimePreviewPrefab", {
+  enumerable: true,
+  get: function get() {
+    return _previewMode.isRuntimePreviewPrefab;
+  }
+});
+Object.defineProperty(exports, "registerComponent", {
+  enumerable: true,
+  get: function get() {
+    return _registry.registerComponent;
+  }
+});
+Object.defineProperty(exports, "registerCustomWidget", {
+  enumerable: true,
+  get: function get() {
+    return _registry.registerCustomWidget;
+  }
+});
+Object.defineProperty(exports, "renderTranspiledMarkup", {
+  enumerable: true,
+  get: function get() {
+    return _markupTranspiler.renderTranspiledMarkup;
+  }
+});
+Object.defineProperty(exports, "transpileAndBuildGetVariables", {
+  enumerable: true,
+  get: function get() {
+    return _variableTranspiler.transpileAndBuildGetVariables;
+  }
+});
+Object.defineProperty(exports, "transpileAndRender", {
+  enumerable: true,
+  get: function get() {
+    return _markupTranspiler.transpileAndRender;
+  }
+});
+Object.defineProperty(exports, "transpileFragment", {
+  enumerable: true,
+  get: function get() {
+    return _markupTranspiler.transpileFragment;
+  }
+});
+var _App = require("./App");
+var _routes = require("./routes");
+var _previewMode = require("./preview-mode");
+var _appInitializer = require("./app-initializer");
+var _registry = require("./registry");
+var _markupTranspiler = require("./services/markup-transpiler");
+var _variableTranspiler = require("./services/variable-transpiler");
+var _services = require("./services");
+var _buildBasePageLikeComponent = require("./factories/build-base-page-like-component");
+var _prefabFactory = require("./factories/prefab-factory");
+var _PageWrapper = require("./components/PageWrapper");
+var _PrefabPreview = require("./components/PrefabPreview");

package/runtime-dynamic/main.d.ts

@@ -0,0 +1,2 @@
+declare const noop: () => void;
+export default noop;

package/runtime-dynamic/main.js

@@ -0,0 +1,84 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _react = _interopRequireDefault(require("react"));
+var _client = require("react-dom/client");
+var _wmStyles = _interopRequireDefault(require("@wavemaker-ai/react-codegen/styles/wm-styles.css"));
+var _App = require("./App");
+var _appInitializer = require("./app-initializer");
+var _routes = require("./routes");
+var __jsx = _react["default"].createElement;
+function injectGlobalStyles() {
+  if (document.querySelector('style[data-wm-scope="globals"]')) return;
+  var style = document.createElement("style");
+  style.setAttribute("data-wm-scope", "globals");
+  style.textContent = _wmStyles["default"];
+  document.head.appendChild(style);
+}
+function hoistBodyStylesheetsToHead() {
+  var bodyLinks = document.body.querySelectorAll('link[rel="stylesheet"], link[rel="preload"][as="style"]');
+  bodyLinks.forEach(function (link) {
+    return document.head.appendChild(link);
+  });
+}
+var DEBUG_MODE = "debugMode";
+function bootstrap() {
+  return _bootstrap.apply(this, arguments);
+}
+function _bootstrap() {
+  _bootstrap = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee() {
+    var container, root, tree;
+    return _regenerator["default"].wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          console.time("bootstrap");
+          hoistBodyStylesheetsToHead();
+          injectGlobalStyles();
+          _context.next = 5;
+          return (0, _appInitializer.initializeApp)();
+        case 5:
+          (0, _App.initPreviewRuntimeRouter)((0, _routes.createAppRouter)());
+          container = document.getElementById("app-root");
+          if (container) {
+            _context.next = 9;
+            break;
+          }
+          throw new Error("Root element #app-root not found");
+        case 9:
+          root = (0, _client.createRoot)(container); // StrictMode double-invokes effects and renders intentionally in development.
+          // In production it adds no benefit and doubles component work, so we skip it.
+          tree = process.env.NODE_ENV === "development" ? __jsx(_react["default"].StrictMode, null, __jsx(_App.App, null)) : __jsx(_App.App, null);
+          root.render(tree);
+          console.timeEnd("bootstrap");
+          window.addEventListener("unload", function () {
+            root.unmount();
+          });
+        case 14:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return _bootstrap.apply(this, arguments);
+}
+document.addEventListener("DOMContentLoaded", function () {
+  bootstrap()["catch"](function (error) {
+    return console.error("Error bootstrapping app:", error);
+  });
+});
+window.debugMode = function (enabled) {
+  var isEnabled = enabled !== null && enabled !== void 0 ? enabled : true;
+  var value = isEnabled ? "true" : "false";
+  if (sessionStorage.getItem(DEBUG_MODE) !== value) {
+    sessionStorage.setItem(DEBUG_MODE, value);
+    window.location.reload();
+  }
+};
+var noop = function noop() {};
+var _default = exports["default"] = noop;

package/runtime-dynamic/preview-mode.d.ts

@@ -0,0 +1,15 @@
+/** Leaf URL segment for prefab preview (under {@link PREVIEW_ROUTING_BASEPATH}). */
+export declare const PREFAB_PREVIEW_ROUTE_SEGMENT = "prefab-preview";
+/**
+ * Route path under the preview basename, same prefix as application pages (`react-preview/…`),
+ * so the backend can serve `index.html` for that subtree.
+ */
+export declare const PREFAB_PREVIEW_ROUTE_PATH = "react-preview/prefab-preview";
+/** Absolute-style path for `Navigate`, `toPreviewRouterPath`, and parity with app preview URLs. */
+export declare const PREFAB_PREVIEW_PATH = "/react-preview/prefab-preview";
+/**
+ * Prefab vs application preview routing. Uses `appProperties` from Redux after
+ * `loadWmProperties` / `dispatchInitialConfig` (same payload as wmProperties.js), not
+ * `window._WM_APP_PROPERTIES` (often unset when wmProperties is only fetched via HTTP).
+ */
+export declare function isRuntimePreviewPrefab(): boolean;

package/runtime-dynamic/preview-mode.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PREFAB_PREVIEW_ROUTE_SEGMENT = exports.PREFAB_PREVIEW_ROUTE_PATH = exports.PREFAB_PREVIEW_PATH = void 0;
+exports.isRuntimePreviewPrefab = isRuntimePreviewPrefab;
+var _store = require("@wavemaker-ai/react-runtime/store");
+var _constants = require("../core/constants");
+/** Leaf URL segment for prefab preview (under {@link PREVIEW_ROUTING_BASEPATH}). */
+var PREFAB_PREVIEW_ROUTE_SEGMENT = exports.PREFAB_PREVIEW_ROUTE_SEGMENT = "prefab-preview";
+
+/**
+ * Route path under the preview basename, same prefix as application pages (`react-preview/…`),
+ * so the backend can serve `index.html` for that subtree.
+ */
+var PREFAB_PREVIEW_ROUTE_PATH = exports.PREFAB_PREVIEW_ROUTE_PATH = "".concat(_constants.PREVIEW_ROUTING_BASEPATH, "/").concat(PREFAB_PREVIEW_ROUTE_SEGMENT);
+
+/** Absolute-style path for `Navigate`, `toPreviewRouterPath`, and parity with app preview URLs. */
+var PREFAB_PREVIEW_PATH = exports.PREFAB_PREVIEW_PATH = "/".concat(PREFAB_PREVIEW_ROUTE_PATH);
+
+/**
+ * Prefab vs application preview routing. Uses `appProperties` from Redux after
+ * `loadWmProperties` / `dispatchInitialConfig` (same payload as wmProperties.js), not
+ * `window._WM_APP_PROPERTIES` (often unset when wmProperties is only fetched via HTTP).
+ */
+function isRuntimePreviewPrefab() {
+  var _info;
+  var type = (_info = _store.store.getState().info) === null || _info === void 0 || (_info = _info.appConfig) === null || _info === void 0 || (_info = _info.appProperties) === null || _info === void 0 ? void 0 : _info.type;
+  return type === "PREFAB";
+}

package/runtime-dynamic/preview-navigation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared app code may push `/${ROUTING_BASEPATH_PRODUCTION}/…`; this bundle's router only
+ * registers `/${PREVIEW_ROUTING_BASEPATH}/…`, so normalize before `router.navigate`.
+ * Prefab preview keeps the URL on {@link PREFAB_PREVIEW_PATH} (`/react-preview/prefab-preview`, same prefix as app preview).
+ */
+export declare function toPreviewRouterPath(path: string): string;

package/runtime-dynamic/preview-navigation.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.toPreviewRouterPath = toPreviewRouterPath;
+var _constants = require("../core/constants");
+var _previewMode = require("./preview-mode");
+/**
+ * Shared app code may push `/${ROUTING_BASEPATH_PRODUCTION}/…`; this bundle's router only
+ * registers `/${PREVIEW_ROUTING_BASEPATH}/…`, so normalize before `router.navigate`.
+ * Prefab preview keeps the URL on {@link PREFAB_PREVIEW_PATH} (`/react-preview/prefab-preview`, same prefix as app preview).
+ */
+function toPreviewRouterPath(path) {
+  var q = path.indexOf("?");
+  var pathOnly = q >= 0 ? path.slice(0, q) : path;
+  var search = q >= 0 ? path.slice(q) : "";
+  if ((0, _previewMode.isRuntimePreviewPrefab)()) {
+    var previewSeg = "/".concat(_constants.PREVIEW_ROUTING_BASEPATH);
+    var prodSeg = "/".concat(_constants.ROUTING_BASEPATH_PRODUCTION);
+    var p = pathOnly;
+    if (p.startsWith("".concat(previewSeg, "/")) || p.startsWith("".concat(prodSeg, "/")) || p === previewSeg || p === prodSeg) {
+      p = _previewMode.PREFAB_PREVIEW_PATH;
+    } else if (p !== _previewMode.PREFAB_PREVIEW_PATH && p.startsWith("/")) {
+      var rest = p.slice(1);
+      if (rest && !rest.includes("/")) {
+        p = _previewMode.PREFAB_PREVIEW_PATH;
+      }
+    }
+    return p + search;
+  }
+  var prodPrefix = "/".concat(_constants.ROUTING_BASEPATH_PRODUCTION);
+  var previewPrefix = "/".concat(_constants.PREVIEW_ROUTING_BASEPATH);
+  if (pathOnly.startsWith(prodPrefix)) {
+    return pathOnly.replace(prodPrefix, previewPrefix) + search;
+  }
+  return path;
+}

package/runtime-dynamic/preview-resource-base.d.ts

@@ -0,0 +1,12 @@
+/**
+ * When the document path is `…/${PREVIEW_ROUTING_BASEPATH}/:page` (or prefab preview under the same
+ * prefix), same-origin relative URLs like `./config.json` would otherwise resolve under
+ * `…/react-preview/`. This returns the app static-file base (origin + path ending with `/`) before
+ * that segment, so assets load from the real app root. Returns `null` when the marker is absent.
+ */
+export declare function getPreviewBundledAssetBaseUrl(): string | null;
+/**
+ * Resolves a fetch/DOM URL for preview: relative and `./` URLs use {@link getPreviewBundledAssetBaseUrl};
+ * `http(s):`, `//`, `blob:`, and `data:` are unchanged. Path-absolute URLs (`/services/…`) resolve from `origin` only.
+ */
+export declare function resolvePreviewFetchUrl(url: string): string;

package/runtime-dynamic/preview-resource-base.js

@@ -0,0 +1,65 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getPreviewBundledAssetBaseUrl = getPreviewBundledAssetBaseUrl;
+exports.resolvePreviewFetchUrl = resolvePreviewFetchUrl;
+var _constants = require("../core/constants");
+/**
+ * When the document path is `…/${PREVIEW_ROUTING_BASEPATH}/:page` (or prefab preview under the same
+ * prefix), same-origin relative URLs like `./config.json` would otherwise resolve under
+ * `…/react-preview/`. This returns the app static-file base (origin + path ending with `/`) before
+ * that segment, so assets load from the real app root. Returns `null` when the marker is absent.
+ */
+function getPreviewBundledAssetBaseUrl() {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  var _window$location = window.location,
+    pathname = _window$location.pathname,
+    origin = _window$location.origin;
+  var marker = "/".concat(_constants.PREVIEW_ROUTING_BASEPATH, "/");
+  var idx = pathname.indexOf(marker);
+  if (idx < 0) {
+    return null;
+  }
+  var rootPath = pathname.slice(0, idx);
+  if (!rootPath.endsWith("/")) {
+    rootPath += "/";
+  }
+  return "".concat(origin).concat(rootPath);
+}
+
+/**
+ * Resolves a fetch/DOM URL for preview: relative and `./` URLs use {@link getPreviewBundledAssetBaseUrl};
+ * `http(s):`, `//`, `blob:`, and `data:` are unchanged. Path-absolute URLs (`/services/…`) resolve from `origin` only.
+ */
+function resolvePreviewFetchUrl(url) {
+  var trimmed = url === null || url === void 0 ? void 0 : url.trim();
+  if (!trimmed) {
+    return url;
+  }
+  if (/^https?:\/\//i.test(trimmed) || trimmed.startsWith("//")) {
+    return trimmed;
+  }
+  if (trimmed.startsWith("blob:") || trimmed.startsWith("data:")) {
+    return trimmed;
+  }
+  var base = getPreviewBundledAssetBaseUrl();
+  if (!base) {
+    return trimmed;
+  }
+  if (trimmed.startsWith("/") && !trimmed.startsWith("//")) {
+    try {
+      return new URL(trimmed, window.location.origin).href;
+    } catch (_unused) {
+      return trimmed;
+    }
+  }
+  try {
+    return new URL(trimmed, base).href;
+  } catch (_unused2) {
+    return trimmed;
+  }
+}

package/runtime-dynamic/registry/component-registry.d.ts

@@ -0,0 +1,3 @@
+import COMPONENT_REGISTRY from "./store";
+export { getComponent, hasComponent, getAllComponentNames, registerComponent } from "./store";
+export default COMPONENT_REGISTRY;