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

package/context/WidgetProvider.js

@@ -228,7 +228,6 @@ var WidgetProvider = exports.WidgetProvider = function WidgetProvider(_ref) {
   }, children));
 };
 var usePageContext = exports.usePageContext = function usePageContext(standalone) {
-  var context = (0, _react.useContext)(WidgetContext);
   if (standalone) {
     return {
       pageContext: {},
@@ -237,16 +236,17 @@ var usePageContext = exports.usePageContext = function usePageContext(standalone
       destroy: function destroy() {}
     };
   }
+  var context = (0, _react.useContext)(WidgetContext);
   if (!context) {
     throw new Error("useWidgetContext must be used within a WidgetProvider");
   }
   return context;
 };
 var useWidgetProxy = exports.useWidgetProxy = function useWidgetProxy(name, standalone) {
-  var context = (0, _react.useContext)(WidgetContext);
   if (standalone) {
     return {};
   }
+  var context = (0, _react.useContext)(WidgetContext);
   if (!context) {
     throw new Error("useWidgetProxy must be used within a WidgetProvider");
   }

package/core/app.service.js

@@ -20,7 +20,6 @@ var _authSlice = require("@wavemaker-ai/react-runtime/store/slices/authSlice");
 var _get = _interopRequireDefault(require("lodash-es/get"));
 var _isEmpty = _interopRequireDefault(require("lodash-es/isEmpty"));
 var _appstore = _interopRequireDefault(require("./appstore"));
-var _constants = require("@wavemaker-ai/react-runtime/core/constants");
 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 loadWmProperties(_x) {
@@ -124,7 +123,7 @@ var getRedirectPage = exports.getRedirectPage = function getRedirectPage(config,
 };
 var handle401 = exports.handle401 = /*#__PURE__*/function () {
   var _ref5 = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee(page, options) {
-    var state, securityConfig, router, loginConfig, userInfo, loginMethod, basePath, getCurrentPageName, sessionTimeoutConfig, sessionTimeoutMethod, sessionTimeoutQueryParams, sessionTimeoutLoginPage, queryString, loginPath, loginPageName, _loginPath, loginQueryParams, _queryString, isOnLoginPage;
+    var state, securityConfig, router, loginConfig, userInfo, loginMethod, sessionTimeoutConfig, sessionTimeoutMethod, sessionTimeoutQueryParams, queryString, loginQueryParams, _queryString, isNotOnLoginPage, hasQueryString;
     return _regenerator["default"].wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
@@ -153,12 +152,8 @@ var handle401 = exports.handle401 = /*#__PURE__*/function () {
           loginConfig = securityConfig.loginConfig || {};
           userInfo = securityConfig.userInfo;
           loginMethod = ((loginConfig === null || loginConfig === void 0 ? void 0 : loginConfig.type) || LOGIN_METHOD.PAGE).toUpperCase();
-          basePath = (0, _constants.getActiveRoutingBasePath)();
-          getCurrentPageName = function getCurrentPageName() {
-            return window.location.pathname.split("/").filter(Boolean).pop() || "";
-          };
           if (!(userInfo !== null && userInfo !== void 0 && userInfo.userName)) {
-            _context.next = 33;
+            _context.next = 30;
             break;
           }
           sessionTimeoutConfig = loginConfig.sessionTimeout || {
@@ -166,57 +161,57 @@ var handle401 = exports.handle401 = /*#__PURE__*/function () {
           };
           sessionTimeoutMethod = (sessionTimeoutConfig.type || LOGIN_METHOD.DIALOG).toUpperCase();
           _context.t0 = sessionTimeoutMethod;
-          _context.next = _context.t0 === LOGIN_METHOD.DIALOG ? 21 : _context.t0 === LOGIN_METHOD.PAGE ? 23 : _context.t0 === LOGIN_METHOD.SSO ? 28 : 31;
+          _context.next = _context.t0 === LOGIN_METHOD.DIALOG ? 19 : _context.t0 === LOGIN_METHOD.PAGE ? 21 : _context.t0 === LOGIN_METHOD.SSO ? 25 : 28;
           break;
-        case 21:
+        case 19:
           showLoginDialog();
-          return _context.abrupt("break", 31);
-        case 23:
-          page = page || getCurrentPageName();
+          return _context.abrupt("break", 28);
+        case 21:
+          page = page || "";
           sessionTimeoutQueryParams = mergeQueryParams({
             redirectTo: page
           }, options === null || options === void 0 ? void 0 : options.queryParams);
-          sessionTimeoutLoginPage = sessionTimeoutConfig.pageName || "Login";
-          if (page !== sessionTimeoutLoginPage) {
+          if (page !== sessionTimeoutConfig.pageName) {
             queryString = createQueryString(sessionTimeoutQueryParams);
-            loginPath = "/".concat(basePath, "/").concat(sessionTimeoutLoginPage);
-            router.push("".concat(loginPath).concat(queryString ? "?".concat(queryString) : ""));
+            router.push("".concat(sessionTimeoutConfig.pageName).concat(queryString ? "?".concat(queryString) : ""));
           }
-          return _context.abrupt("break", 31);
-        case 28:
-          _context.next = 30;
+          return _context.abrupt("break", 28);
+        case 25:
+          _context.next = 27;
           return handleSSOLogin(loginConfig, options);
-        case 30:
-          return _context.abrupt("break", 31);
-        case 31:
-          _context.next = 49;
+        case 27:
+          return _context.abrupt("break", 28);
+        case 28:
+          _context.next = 45;
           break;
-        case 33:
+        case 30:
           _context.t1 = loginMethod;
-          _context.next = _context.t1 === LOGIN_METHOD.DIALOG ? 36 : _context.t1 === LOGIN_METHOD.PAGE ? 38 : _context.t1 === LOGIN_METHOD.SSO ? 46 : 49;
+          _context.next = _context.t1 === LOGIN_METHOD.DIALOG ? 33 : _context.t1 === LOGIN_METHOD.PAGE ? 35 : _context.t1 === LOGIN_METHOD.SSO ? 42 : 45;
           break;
-        case 36:
+        case 33:
           showLoginDialog(true);
-          return _context.abrupt("break", 49);
-        case 38:
-          page = page || getRedirectPage(securityConfig, page) || getCurrentPageName();
-          loginPageName = loginConfig.pageName || "Login";
-          _loginPath = "/".concat(basePath, "/").concat(loginPageName);
+          return _context.abrupt("break", 45);
+        case 35:
+          page = page || getRedirectPage(securityConfig, page) || "";
           loginQueryParams = mergeQueryParams({
             redirectTo: page
           }, options === null || options === void 0 ? void 0 : options.queryParams);
           _queryString = createQueryString(loginQueryParams);
-          isOnLoginPage = window.location.pathname.endsWith(loginPageName);
-          if (!isOnLoginPage && page) {
-            router.push("".concat(_loginPath).concat(_queryString ? "?".concat(_queryString) : ""));
+          /*
+            Prevents the page from refreshing if the user is already on the login page.
+          */
+          isNotOnLoginPage = window.location.pathname.endsWith(loginConfig.pageName);
+          hasQueryString = _queryString !== "";
+          if (!isNotOnLoginPage && hasQueryString) {
+            router.push("".concat(loginConfig.pageName).concat(_queryString ? "?".concat(_queryString) : ""));
           }
-          return _context.abrupt("break", 49);
-        case 46:
-          _context.next = 48;
+          return _context.abrupt("break", 45);
+        case 42:
+          _context.next = 44;
           return handleSSOLogin(loginConfig, options);
-        case 48:
-          return _context.abrupt("break", 49);
-        case 49:
+        case 44:
+          return _context.abrupt("break", 45);
+        case 45:
         case "end":
           return _context.stop();
       }

package/core/constants/events.js

@@ -10,12 +10,6 @@ var partialStateSyncEmitter = new _events["default"]();
 var prefabStateSyncEmitter = new _events["default"]();
 var layoutSyncEmitter = new _events["default"]();
 
-// Pages with many partials/prefabs legitimately register one listener each.
-// The default limit of 10 is too low for widget-heavy WaveMaker pages.
-partialStateSyncEmitter.setMaxListeners(50);
-prefabStateSyncEmitter.setMaxListeners(50);
-layoutSyncEmitter.setMaxListeners(50);
-
 // NOTE: Form-related events (CHILD_FORM_DATA_UPDATE, CHILD_FORM_FIELD_REGISTER) have been removed.
 // Form communication now uses context-based callbacks via ParentFormDataContext:
 // - onChildDataChange: For child forms to send data UP to root parent

package/core/constants/index.d.ts

@@ -1,10 +1,2 @@
-/** Production / default SPA URL segment (embedded apps, classic deploy). */
-export declare const ROUTING_BASEPATH_PRODUCTION = "react-pages";
-/** Studio / dynamic preview uses this segment in the browser URL (runtime-dynamic). */
-export declare const PREVIEW_ROUTING_BASEPATH = "react-preview";
-/**
- * SPA routing segment for the current window (`react-pages` vs `react-preview`).
- * Call when building navigation targets — not a one-time module-load constant.
- */
-export declare function getActiveRoutingBasePath(): string;
+export declare const ROUTING_BASEPATH = "react-pages";
 export declare const hyperLinkMofify: (link: string) => string;

package/core/constants/index.js

@@ -3,44 +3,17 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.ROUTING_BASEPATH_PRODUCTION = exports.PREVIEW_ROUTING_BASEPATH = void 0;
-exports.getActiveRoutingBasePath = getActiveRoutingBasePath;
-exports.hyperLinkMofify = void 0;
-/** Production / default SPA URL segment (embedded apps, classic deploy). */
-var ROUTING_BASEPATH_PRODUCTION = exports.ROUTING_BASEPATH_PRODUCTION = "react-pages";
-
-/** Studio / dynamic preview uses this segment in the browser URL (runtime-dynamic). */
-var PREVIEW_ROUTING_BASEPATH = exports.PREVIEW_ROUTING_BASEPATH = "react-preview";
-
-/**
- * SPA routing segment for the current window (`react-pages` vs `react-preview`).
- * Call when building navigation targets — not a one-time module-load constant.
- */
-function getActiveRoutingBasePath() {
-  if (typeof window === "undefined") {
-    return ROUTING_BASEPATH_PRODUCTION;
-  }
-  var pathname = window.location.pathname;
-  var preview = "/".concat(PREVIEW_ROUTING_BASEPATH);
-  var prod = "/".concat(ROUTING_BASEPATH_PRODUCTION);
-  if (pathname.includes("".concat(preview, "/")) || pathname.endsWith(preview)) {
-    return PREVIEW_ROUTING_BASEPATH;
-  }
-  if (pathname.includes("".concat(prod, "/")) || pathname.endsWith(prod)) {
-    return ROUTING_BASEPATH_PRODUCTION;
-  }
-  return ROUTING_BASEPATH_PRODUCTION;
-}
+exports.hyperLinkMofify = exports.ROUTING_BASEPATH = void 0;
+var ROUTING_BASEPATH = exports.ROUTING_BASEPATH = "react-pages";
 var hyperLinkMofify = exports.hyperLinkMofify = function hyperLinkMofify(link) {
   var hrefLink = "#";
   if (link) {
-    var segment = getActiveRoutingBasePath();
+    var baseRegex = new RegExp("^/".concat(ROUTING_BASEPATH, "(/|$)"));
     if (/^#/.test(link)) {
       var suffix = link.replace(/^#/, "");
-      hrefLink = /^\/.*/.test(suffix) ? "/".concat(segment).concat(suffix) : "/".concat(segment, "/").concat(suffix);
+      hrefLink = /^\/.*/.test(suffix) ? "/".concat(ROUTING_BASEPATH).concat(suffix) : "/".concat(ROUTING_BASEPATH, "/").concat(suffix);
     } else if (/^\//.test(link)) {
-      var normalized = link.replace(new RegExp("^/".concat(ROUTING_BASEPATH_PRODUCTION, "(?=/|$)")), "/".concat(segment)).replace(new RegExp("^/".concat(PREVIEW_ROUTING_BASEPATH, "(?=/|$)")), "/".concat(segment));
-      hrefLink = normalized.match(new RegExp("^/".concat(segment, "(/|$)"))) ? normalized : "/".concat(segment).concat(link);
+      hrefLink = baseRegex.test(link) ? link : "/".concat(ROUTING_BASEPATH).concat(link);
     } else {
       hrefLink = link;
     }

package/core/formatter/date-formatters.d.ts

@@ -1,7 +1,7 @@
 import { DateFormatter } from "@wavemaker-ai/variables/src/types/date-formatter";
 import { Formatter } from "./types";
 export declare class DateToStringFormatter implements DateFormatter {
-    format(input: Date | string | number | null | undefined, format?: string | null): string;
+    format(input: Date | string | number | null | undefined, format: string): string;
     private tryReconstructDateFromDecimal;
 }
 export declare class TimeFromNowFormatter implements Formatter {

package/core/formatter/date-formatters.js

@@ -9,41 +9,11 @@ exports.TimeFromNowFormatter = exports.DateToStringFormatter = void 0;
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var momentLib = _interopRequireWildcard(require("moment-timezone/moment-timezone"));
-var _appstore = _interopRequireDefault(require("../appstore"));
 var _store = require("../../store");
 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); }
 // @ts-ignore
 
 var moment = momentLib["default"] || window["moment"];
-function resolveDateFormattingLocale() {
-  try {
-    var _appstore$I18nService, _appstore$I18nService2;
-    var fromI18n = (_appstore$I18nService = _appstore["default"].I18nService.get()) === null || _appstore$I18nService === void 0 || (_appstore$I18nService2 = _appstore$I18nService.getSelectedLocale) === null || _appstore$I18nService2 === void 0 ? void 0 : _appstore$I18nService2.call(_appstore$I18nService);
-    if (fromI18n != null && String(fromI18n).trim() !== "") {
-      return String(fromI18n).replace(/_/g, "-");
-    }
-  } catch (_unused) {
-    /* ignore */
-  }
-  try {
-    var _store$getState;
-    var lang = ((_store$getState = _store.store.getState()) === null || _store$getState === void 0 || (_store$getState = _store$getState.info) === null || _store$getState === void 0 || (_store$getState = _store$getState.appConfig) === null || _store$getState === void 0 || (_store$getState = _store$getState.appProperties) === null || _store$getState === void 0 ? void 0 : _store$getState.defaultLanguage) || "en";
-    return String(lang).replace(/_/g, "-");
-  } catch (_unused2) {
-    return "en";
-  }
-}
-
-/** Mirrors Angular DatePipe when format is omitted: default medium date (`DATE_PIPE_DEFAULT_OPTIONS` or `mediumDate`). */
-function formatMediumDateDefault(_moment, localeTag) {
-  try {
-    return new Intl.DateTimeFormat(localeTag || "en", {
-      dateStyle: "medium"
-    }).format(_moment.toDate());
-  } catch (_unused3) {
-    return _moment.isValid() ? _moment.locale(localeTag.split("-")[0] || "en").format("LL") : "";
-  }
-}
 var DateToStringFormatter = exports.DateToStringFormatter = /*#__PURE__*/function () {
   function DateToStringFormatter() {
     (0, _classCallCheck2["default"])(this, DateToStringFormatter);
@@ -52,6 +22,9 @@ var DateToStringFormatter = exports.DateToStringFormatter = /*#__PURE__*/functio
     key: "format",
     value: function format(input, _format) {
       if (!input && input !== 0) return "";
+
+      // Normalize format string
+      _format = _format.replaceAll("y", "Y").replaceAll("d", "D").replaceAll("E", "d");
       var _moment;
 
       // Handle different input types
@@ -97,17 +70,19 @@ var DateToStringFormatter = exports.DateToStringFormatter = /*#__PURE__*/functio
       if (_format === "UTC") {
         return _moment.isValid() ? moment.utc(_moment).toString() : "";
       }
-      var localeTag = resolveDateFormattingLocale();
 
-      // Align with Angular ToDatePipe + DatePipe: omitted format → mediumDate-style output (no throw).
-      if (_format == null || String(_format).trim() === "") {
-        return _moment.isValid() ? formatMediumDateDefault(_moment, localeTag) : "";
+      // Get default language from store (with fallback)
+      var defaultLanguage = "en";
+      try {
+        var _store$getState;
+        defaultLanguage = ((_store$getState = _store.store.getState()) === null || _store$getState === void 0 || (_store$getState = _store$getState.info) === null || _store$getState === void 0 || (_store$getState = _store$getState.appConfig) === null || _store$getState === void 0 || (_store$getState = _store$getState.appProperties) === null || _store$getState === void 0 ? void 0 : _store$getState.defaultLanguage) || "en";
+      } catch (error) {
+        // Fallback to "en" if store is not available or not properly initialized
+        defaultLanguage = "en";
       }
 
-      // Normalize pattern tokens (moment + Angular-style lowercase tokens); match ng ToDatePipe `replace('a','A')` for am/pm.
-      var pattern = String(_format).replaceAll("y", "Y").replaceAll("d", "D").replaceAll("E", "d").replace("a", "A");
-      var primaryLang = localeTag.split("-")[0] || "en";
-      return _moment.isValid() ? _moment.locale(primaryLang).format(pattern) : "";
+      // Return formatted date or empty string if invalid
+      return _moment.isValid() ? _moment.locale(defaultLanguage).format(_format) : "";
     }
   }, {
     key: "tryReconstructDateFromDecimal",

package/core/formatter/types.d.ts

@@ -29,5 +29,5 @@ export declare enum SecurityContext {
     RESOURCE_URL = 5
 }
 export interface DateFormatter {
-    format: (input: Date | string | number | null | undefined, format?: string | null) => string;
+    format: (input: Date | string | number | null | undefined, format: string) => string;
 }

package/core/proxy-service.js

@@ -219,9 +219,6 @@ var createWidgetProxy = exports.createWidgetProxy = function createWidgetProxy(w
   if (!(0, _isString["default"])(widgetName)) {
     return widget;
   }
-  if (widget == null) {
-    return widget;
-  }
   var proxy = new Proxy(widget, {
     set: function set(target, prop, value, receiver) {
       // Ignore internal properties
@@ -377,26 +374,19 @@ var createPageProxy = exports.createPageProxy = function createPageProxy(target,
       if (widgetProxies.has(widgetName)) {
         var _proxy = widgetProxies.get(widgetName);
         var originalTarget = originalTargets.get(_proxy);
-        var safeWidget = widget != null && (0, _typeof2["default"])(widget) === "object" ? widget : null;
-        var safeOriginal = originalTarget != null && (0, _typeof2["default"])(originalTarget) === "object" ? originalTarget : null;
 
         // Always sync properties to ensure proxy has latest data
         // This is important when widget was initially created with minimal data
-        if (safeWidget && safeOriginal && (widget !== originalTarget || Object.keys(safeWidget).length > Object.keys(safeOriginal).length)) {
+        if (widget !== originalTarget || Object.keys(widget).length > Object.keys(originalTarget).length) {
           // Copy all properties from widget to originalTarget
-          for (var key in safeWidget) {
-            Reflect.defineProperty(safeOriginal, key, {
-              value: safeWidget[key],
+          for (var key in widget) {
+            Reflect.defineProperty(originalTarget, key, {
+              value: widget[key],
               writable: true,
               configurable: true,
               enumerable: true
             });
           }
-          // Pin widgetsTarget back to originalTarget so that subsequent GETs within the
-          // same synchronous call stack see widget === originalTarget (no re-sync).
-          // This prevents the sync from overwriting proxy mutations (e.g. selectedItems
-          // set via createWidgetProxy.set) with stale values from widgetsTarget.
-          widgetsTarget[widgetName] = safeOriginal;
         }
         return _proxy;
       }
@@ -501,7 +491,7 @@ var _createStateProxy = exports.createStateProxy = function createStateProxy(obj
       if ((0, _dom.isDOMElement)(value)) {
         return value;
       }
-      if (value instanceof Map || value instanceof Date) {
+      if (value instanceof Map) {
         return value;
       }
 

package/core/util/index.js

@@ -40,9 +40,8 @@ var MONTHNAMES = exports.MONTHNAMES = ["January", "February", "March", "April",
 var checkPublicAccess = exports.checkPublicAccess = function checkPublicAccess(page) {
   var _window$location$path, _store$getState$info$;
   var pageName = page || ((_window$location$path = window.location.pathname) === null || _window$location$path === void 0 ? void 0 : _window$location$path.split("/").at(-1));
-  if (!pageName) return false;
-  return ((_store$getState$info$ = _store.store.getState().info.appConfig) === null || _store$getState$info$ === void 0 || (_store$getState$info$ = _store$getState$info$.pages) === null || _store$getState$info$ === void 0 || (_store$getState$info$ = _store$getState$info$.find(function (p) {
-    return p.name === pageName;
+  return ((_store$getState$info$ = _store.store.getState().info.appConfig) === null || _store$getState$info$ === void 0 || (_store$getState$info$ = _store$getState$info$.pages) === null || _store$getState$info$ === void 0 || (_store$getState$info$ = _store$getState$info$.find(function (page) {
+    return page.name === pageName;
   })) === null || _store$getState$info$ === void 0 ? void 0 : _store$getState$info$.permission) === "PermitAll";
 };
 var setSessionStorageItem = exports.setSessionStorageItem = function setSessionStorageItem(key, value) {

package/higherOrder/BaseApp.js

@@ -216,8 +216,8 @@ var BaseApp = exports.BaseApp = function BaseApp(WrappedComponent, addAppScript,
     function openActionDialog(notification, title) {
       setAppContext(function (prev) {
         if (title) {
-          var _prev$Widgets, _prev$Widgets$open;
-          prev === null || prev === void 0 || (_prev$Widgets = prev.Widgets) === null || _prev$Widgets === void 0 || (_prev$Widgets = _prev$Widgets[title]) === null || _prev$Widgets === void 0 || (_prev$Widgets$open = _prev$Widgets.open) === null || _prev$Widgets$open === void 0 || _prev$Widgets$open.call(_prev$Widgets);
+          var _prev$Common, _prev$Common$open;
+          (_prev$Common = prev.Common) === null || _prev$Common === void 0 || (_prev$Common = _prev$Common.Widgets) === null || _prev$Common === void 0 || (_prev$Common = _prev$Common[title]) === null || _prev$Common === void 0 || (_prev$Common$open = _prev$Common.open) === null || _prev$Common$open === void 0 || _prev$Common$open.call(_prev$Common);
         }
         return _objectSpread(_objectSpread({}, prev), {}, {
           notification: notification

package/higherOrder/BasePage.d.ts

@@ -1,5 +1,22 @@
 import React from "react";
 import { ProxyTarget, MockApp, WithPageContextProps, ComponentInfo } from "@wavemaker-ai/react-runtime/types";
+/**
+ * Hook to signal that a page component has rendered and is ready.
+ * Call this at the top of your page component to trigger startup operations.
+ *
+ * This ensures widgets have mounted and subscribed before variables are invoked.
+ *
+ * @param componentName - The unique name of the component (e.g., "ChooseAPlansGrid")
+ *
+ * @example
+ * import { usePageReady } from '@wavemaker-ai/react-runtime/higherOrder/BasePage';
+ *
+ * const ChooseAPlansGridComponent = () => {
+ *   usePageReady("ChooseAPlansGrid"); // Signal ready on mount
+ *   return <WmPage>...</WmPage>;
+ * };
+ */
+export declare const usePageReady: (componentName: string) => void;
 export declare const withPageContext: <P extends object>(WrappedComponent: React.ComponentType<P>, addPageScript: (app: MockApp, pageProxy: ProxyTarget) => void, getVariables: (pageProxy: ProxyTarget) => {
     Variables: Record<string, any>;
     Actions: Record<string, any>;