@uxland/primary-shell 7.40.4 → 7.41.0

package/dist/primary/shell/src/api/region-manager/region-manager.d.ts

@@ -13,6 +13,7 @@ export interface PrimariaRegionManager extends HarmonixRegionManager {
     registerNavigationMenu(view: HarmonixViewDefinition): Promise<void>;
     registerMainView(view: HarmonixViewDefinition): Promise<void>;
     activateMainView(viewId: string): Promise<void>;
+    activatePluginView(regionName: string, pluginId: string, viewId: string): Promise<void>;
     getCurrentMainViewActive(): string | undefined;
     _destroy(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uxland/primary-shell",
-  "version": "7.40.4",
+  "version": "7.41.0",
   "description": "Primaria Shell",
   "author": "UXLand <dev@uxland.es>",
   "homepage": "https://github.com/uxland/harmonix/tree/app#readme",

package/src/api/region-manager/region-manager.test.ts

@@ -106,6 +106,18 @@ describe("RegionManagerProxy", () => {
     expect(broker.publish).toHaveBeenCalledWith(BROKER_EVENTS.shell.mainViewChanged, { viewId: "view1" });
   });
 
+  it("activatePluginView should activate using the owner pluginId, not the caller's", async () => {
+    await proxy.activatePluginView("test-region", "other-plugin", "view1");
+    expect(regionMock.activate).toHaveBeenCalledWith("other-plugin::view1");
+    expect(broker.publish).not.toHaveBeenCalled();
+  });
+
+  it("activatePluginView should notify when activating in the main region", async () => {
+    await proxy.activatePluginView(proxy.regions.shell.main, "other-plugin", "view1");
+    expect(regionMock.activate).toHaveBeenCalledWith("other-plugin::view1");
+    expect(broker.publish).toHaveBeenCalledWith(BROKER_EVENTS.shell.mainViewChanged, { viewId: "view1" });
+  });
+
   it("getCurrentMainViewActive should return id of the active main view", () => {
     const result = proxy.getCurrentMainViewActive();
     expect(result).toBe("view1");

package/src/api/region-manager/region-manager.ts

@@ -16,6 +16,7 @@ export interface PrimariaRegionManager extends HarmonixRegionManager {
   registerNavigationMenu(view: HarmonixViewDefinition): Promise<void>;
   registerMainView(view: HarmonixViewDefinition): Promise<void>;
   activateMainView(viewId: string): Promise<void>;
+  activatePluginView(regionName: string, pluginId: string, viewId: string): Promise<void>;
   getCurrentMainViewActive(): string | undefined;
   _destroy(): void;
 }
@@ -130,6 +131,23 @@ class RegionManagerProxy implements PrimariaRegionManager {
     this._notifyMainViewChanged(viewId);
     return Promise.resolve();
   }
+  /**
+   * Activates a view that was registered by another plugin.
+   *
+   * Unlike `activateView`, which always prefixes with the calling plugin's id, this method
+   * lets an orchestrator activate views owned by a different plugin by passing the owner's
+   * pluginId explicitly. Use only when crossing plugin boundaries.
+   *
+   * @param {string} regionName - The name of the region where the view is located.
+   * @param {string} pluginId - The id of the plugin that registered the view.
+   * @param {string} viewId - The id of the view to be activated.
+   * @return {Promise<void>} A promise that resolves when the view is successfully activated.
+   */
+  activatePluginView(regionName: string, pluginId: string, viewId: string): Promise<void> {
+    this.regionManager.getRegion(regionName).activate(`${pluginId}::${viewId}`);
+    if (regionName === this.regions.shell.main) this._notifyMainViewChanged(viewId);
+    return Promise.resolve();
+  }
 
   getCurrentMainViewActive() {
     const mainView = this.regionManager.getRegion(this.regions.shell.main).currentActiveViews[0] as HarmonixViewDefinition;