@trops/dash-core 0.1.327 → 0.1.330

package/dist/index.js

@@ -606,6 +606,41 @@ var DashboardApi = {
   }
 };
 
+/**
+ * DashboardActionsApi
+ *
+ * Provides programmatic control over dashboard-level actions.
+ * Widgets can call these methods directly (not via events) to
+ * control the dashboard they are rendered in.
+ *
+ * Internally dispatches CustomEvents on `window` so the API
+ * stays decoupled from the React component tree.
+ */
+var DashboardActionsApi = {
+  /**
+   * Switch the active page by its internal ID.
+   * @param {string} pageId - The ID of the page to switch to
+   */
+  switchPage: function switchPage(pageId) {
+    window.dispatchEvent(new CustomEvent("dash:switch-page", {
+      detail: {
+        pageId: pageId
+      }
+    }));
+  },
+  /**
+   * Switch the active page by its display name.
+   * @param {string} pageName - The display name of the page (e.g. "Opp Detail")
+   */
+  switchPageByName: function switchPageByName(pageName) {
+    window.dispatchEvent(new CustomEvent("dash:switch-page", {
+      detail: {
+        pageName: pageName
+      }
+    }));
+  }
+};
+
 var SECURE_STORE_ENCRYPTION_CHECK = "secure-storage-encryption-check";
 var SECURE_STORE_ENCRYPTION_CHECK_COMPLETE = "secure-storage-encryption-check-complete";
 var SECURE_STORE_ENCRYPTION_CHECK_ERROR = "secure-storage-encryption-check-error";
@@ -1895,6 +1930,7 @@ var DashboardContext = /*#__PURE__*/React.createContext({
   pub: DashboardPublisher,
   widgetApi: buildWidgetApi(),
   dashApi: null,
+  dashboardApi: DashboardActionsApi,
   providers: {}
 });
 
@@ -2623,6 +2659,7 @@ var DashboardWrapper = function DashboardWrapper(_ref) {
       widgetApi: widgetApi,
       pub: DashboardPublisher,
       dashApi: dashApi,
+      dashboardApi: DashboardActionsApi,
       credentials: credentials,
       providers: providers
     };
@@ -23925,7 +23962,8 @@ var WidgetRenderer = function WidgetRenderer(_ref) {
         publishEvent: function publishEvent(eventName, payload) {
           return helpers.publishEvent(eventName, payload);
         },
-        api: w
+        api: w,
+        dashboardApi: DashboardActionsApi
       }, params), userPrefs), {}, {
         backgroundColor: bgColor,
         widgetConfig: helpers.config(),
@@ -23938,6 +23976,7 @@ var WidgetRenderer = function WidgetRenderer(_ref) {
           return helpers.publishEvent(eventName, payload);
         },
         api: w,
+        dashboardApi: DashboardActionsApi,
         id: "widget-kids-".concat(widgetKey)
       }, params), userPrefs), {}, {
         backgroundColor: bgColor,
@@ -51486,6 +51525,28 @@ var DashboardStageInner = function DashboardStageInner(_ref3) {
     _useState48 = _slicedToArray(_useState47, 2),
     activePageId = _useState48[0],
     setActivePageId = _useState48[1];
+
+  // Listen for programmatic page switches via DashboardActionsApi
+  React.useEffect(function () {
+    function onSwitchPage(e) {
+      var _ref4 = e.detail || {},
+        pageId = _ref4.pageId,
+        pageName = _ref4.pageName;
+      if (pageId) {
+        setActivePageId(pageId);
+      } else if (pageName) {
+        var pages = (workspaceSelected === null || workspaceSelected === void 0 ? void 0 : workspaceSelected.pages) || [];
+        var match = pages.find(function (p) {
+          return p.name.toLowerCase() === pageName.toLowerCase();
+        });
+        if (match) setActivePageId(match.id);
+      }
+    }
+    window.addEventListener("dash:switch-page", onSwitchPage);
+    return function () {
+      return window.removeEventListener("dash:switch-page", onSwitchPage);
+    };
+  }, [workspaceSelected === null || workspaceSelected === void 0 ? void 0 : workspaceSelected.pages]);
   var workspacePages = (workspaceSelected === null || workspaceSelected === void 0 ? void 0 : workspaceSelected.pages) || [];
 
   // Memoize sorted pages so page object references stay stable across re-renders
@@ -54882,6 +54943,7 @@ exports.DashNavbar = DashNavbar;
 exports.DashSidebar = DashSidebar;
 exports.DashTabBar = DashTabBar;
 exports.Dashboard = DashboardStage;
+exports.DashboardActionsApi = DashboardActionsApi;
 exports.DashboardApi = DashboardApi;
 exports.DashboardContext = DashboardContext;
 exports.DashboardFooter = DashboardFooter;