@uxland/primary-shell 7.49.2 → 7.50.0

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

@@ -2,6 +2,11 @@ import { HarmonixRegionManager, HarmonixViewDefinition, IRegionManager } from '@
 import { PluginInfo } from '../../handle-plugins';
 import { PrimariaBroker } from '../broker/primaria-broker';
 import { activityHistoryRegions, administrativeManagementRegions, clinicalMonitoringRegions, shellRegions } from './regions';
+/** Una vista de la region main, amb el plugin que l'ha registrada. */
+export interface RegisteredMainView {
+    pluginId: string;
+    viewId: string;
+}
 export interface PrimariaRegionManager extends HarmonixRegionManager {
     regions: {
         shell: typeof shellRegions;
@@ -15,6 +20,7 @@ export interface PrimariaRegionManager extends HarmonixRegionManager {
     activateMainView(viewId: string): Promise<void>;
     activatePluginView(regionName: string, pluginId: string, viewId: string): Promise<void>;
     getCurrentMainViewActive(): string | undefined;
+    getRegisteredMainViews(): RegisteredMainView[];
     _removeAllViews(): Promise<void>;
     _destroy(): Promise<void>;
 }

package/dist/primary/shell/src/index.d.ts

@@ -1,6 +1,7 @@
 export * from './bootstrapper';
 export * from './disposer';
 export * from './api/region-manager/regions';
+export type { RegisteredMainView } from './api/region-manager/region-manager';
 export * from './handle-plugins';
 export type { PrimariaApi } from './api/api';
 export { PrimariaRegionHost, shellApi } from './api/api';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uxland/primary-shell",
-  "version": "7.49.2",
+  "version": "7.50.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

@@ -125,6 +125,59 @@ describe("RegionManagerProxy", () => {
     expect(result).toBe("view1");
   });
 
+  describe("getRegisteredMainViews", () => {
+    // `id: undefined` vol dir una definicio que no en declara, no una amb l'id a undefined.
+    const registeredView = (key: string, id?: string) => ({
+      key,
+      view: id === undefined ? { factory: mockView.factory } : { ...mockView, id },
+    });
+
+    it("desglossa la clau del registry en pluginId i viewId", () => {
+      regionManager.getRegisteredViews.mockReturnValue([
+        registeredView("appointments::main", "main"),
+        registeredView("activity-history::timeline", "timeline"),
+      ]);
+
+      expect(proxy.getRegisteredMainViews()).toEqual([
+        { pluginId: "appointments", viewId: "main" },
+        { pluginId: "activity-history", viewId: "timeline" },
+      ]);
+      expect(regionManager.getRegisteredViews).toHaveBeenCalledWith(proxy.regions.shell.main);
+    });
+
+    /**
+     * El registry s'omple en registrar la vista; `getRegion(main).currentViews` només té
+     * les vistes afegides a un host ja muntat, i `getRegion` retorna `undefined` mentre la
+     * regio no hi es. Per aixo el metode no ha de dependre de la regio.
+     */
+    it("no depen que la regio main estigui muntada", () => {
+      regionManager.getRegion.mockReturnValue(undefined);
+      regionManager.getRegisteredViews.mockReturnValue([registeredView("appointments::main", "main")]);
+
+      expect(proxy.getRegisteredMainViews()).toEqual([{ pluginId: "appointments", viewId: "main" }]);
+    });
+
+    it("retorna una llista buida quan no hi ha res registrat", () => {
+      regionManager.getRegisteredViews.mockReturnValue([]);
+
+      expect(proxy.getRegisteredMainViews()).toEqual([]);
+    });
+
+    // Les vistes dels plugins de tercers (econsulta, allergies...) es poden registrar
+    // directament contra el regionManager, sense el prefix que hi posa aquest proxy.
+    it("deixa el pluginId buit si la clau no porta prefix de plugin", () => {
+      regionManager.getRegisteredViews.mockReturnValue([registeredView("legacy-view", "legacy-view")]);
+
+      expect(proxy.getRegisteredMainViews()).toEqual([{ pluginId: "", viewId: "legacy-view" }]);
+    });
+
+    it("cau a la clau quan la definicio no declara id", () => {
+      regionManager.getRegisteredViews.mockReturnValue([registeredView("appointments::main", undefined)]);
+
+      expect(proxy.getRegisteredMainViews()).toEqual([{ pluginId: "appointments", viewId: "main" }]);
+    });
+  });
+
   it("_destroy should call regionManager.destroy", () => {
     proxy._destroy();
     expect(regionManager.destroy).toHaveBeenCalled();

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

@@ -5,6 +5,12 @@ import { BROKER_EVENTS } from "../broker/broker-events";
 import { PrimariaBroker } from "../broker/primaria-broker";
 import { activityHistoryRegions, administrativeManagementRegions, clinicalMonitoringRegions, shellRegions } from "./regions";
 
+/** Una vista de la region main, amb el plugin que l'ha registrada. */
+export interface RegisteredMainView {
+  pluginId: string;
+  viewId: string;
+}
+
 export interface PrimariaRegionManager extends HarmonixRegionManager {
   regions: {
     shell: typeof shellRegions;
@@ -18,6 +24,7 @@ export interface PrimariaRegionManager extends HarmonixRegionManager {
   activateMainView(viewId: string): Promise<void>;
   activatePluginView(regionName: string, pluginId: string, viewId: string): Promise<void>;
   getCurrentMainViewActive(): string | undefined;
+  getRegisteredMainViews(): RegisteredMainView[];
   _removeAllViews(): Promise<void>;
   _destroy(): Promise<void>;
 }
@@ -168,6 +175,32 @@ class RegionManagerProxy implements PrimariaRegionManager {
     return mainView?.id;
   }
 
+  /**
+   * Totes les vistes registrades a la region main, amb el plugin que les ha registrat.
+   *
+   * Va pel registry del regionManager i no per `getRegion(main).currentViews`, i és a
+   * propòsit: el registry s'omple en registrar la vista, mentre que `currentViews` només
+   * té les que s'han afegit a un host de regió ja muntat —i `getRegion` retorna
+   * `undefined` si la regió encara no hi és—, així que cridar-ho des de l'`initialize()`
+   * d'un plugin donaria una llista incompleta o petaria.
+   *
+   * Les claus del registry són `pluginId::viewId`. El `viewId` es llegeix de la
+   * definició, que és qui en manda; de la clau només se'n treu el prefix del plugin, que
+   * pot no ser-hi si la vista l'ha registrada un plugin de tercers directament contra el
+   * regionManager, sense passar per aquest proxy.
+   */
+  getRegisteredMainViews(): RegisteredMainView[] {
+    return this.regionManager.getRegisteredViews(this.regions.shell.main).map(({ key, view }) => {
+      const separatorIndex = key.indexOf("::");
+      const hasPluginPrefix = separatorIndex !== -1;
+
+      return {
+        pluginId: hasPluginPrefix ? key.slice(0, separatorIndex) : "",
+        viewId: (view as HarmonixViewDefinition).id ?? (hasPluginPrefix ? key.slice(separatorIndex + 2) : key),
+      };
+    });
+  }
+
   /**
    * Activates a view if it is marked as default and the region currently has no active views.
    *

package/src/index.ts

@@ -5,12 +5,15 @@ import fontsCSS from "./UI/fonts/fonts.css?inline";
 // Inject CSS automatically
 if (typeof document !== "undefined") {
   const style = document.createElement("style");
-  style.textContent = fontsCSS + "\n" + dssCSS;
+  style.textContent = `${fontsCSS}\n${dssCSS}`;
   document.head.appendChild(style);
 }
 export * from "./bootstrapper";
 export * from "./disposer";
 export * from "./api/region-manager/regions";
+// Tipus de retorn de `regionManager.getRegisteredMainViews()`. El regionManager
+// arriba als plugins tipat via `PrimariaApi`; això només és per poder-lo anomenar.
+export type { RegisteredMainView } from "./api/region-manager/region-manager";
 export * from "./handle-plugins";
 // Superfície pública explícita: `primariaApiFactory`, `activityMonitor` i
 // `sessionRefreshTimer` són singletons interns del shell i no s'exposen.