@uxland/primary-shell 7.38.0 → 7.38.1

package/dist/primary/shell/src/UI/shared-components/primaria-region/primaria-region.d.ts

@@ -26,6 +26,13 @@ export declare class PrimariaRegion extends PrimariaRegion_base {
      * and to generate the container ID.
      */
     name: string;
+    /**
+     * Rendering mode for the region.
+     * - "multi" (default): all registered views are shown simultaneously (MultipleActiveAdapter).
+     * - "single": only one view is shown at a time (SelectableAdapter via primaria-content-switcher).
+     *   Each plugin activates its own view; the adapter deactivates the rest automatically.
+     */
+    mode: "multi" | "single";
     /**
      * Render in light DOM instead of shadow DOM.
      * This allows the region content to be visible in the parent's DOM tree.

package/package.json

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

package/src/UI/shared-components/primaria-region/primaria-region.ts

@@ -31,7 +31,14 @@ export class PrimariaRegion extends PrimariaRegionHost(LitElement) {
    */
   @property({ type: String })
   name = "";
-
+  /**
+   * Rendering mode for the region.
+   * - "multi" (default): all registered views are shown simultaneously (MultipleActiveAdapter).
+   * - "single": only one view is shown at a time (SelectableAdapter via primaria-content-switcher).
+   *   Each plugin activates its own view; the adapter deactivates the rest automatically.
+   */
+  @property({ type: String })
+  mode: "multi" | "single" = "multi";
   /**
    * Render in light DOM instead of shadow DOM.
    * This allows the region content to be visible in the parent's DOM tree.
@@ -88,10 +95,16 @@ export class PrimariaRegion extends PrimariaRegionHost(LitElement) {
     if (this.name) {
       const targetId = `${this.name}-container`;
 
-      // Create the container div immediately in the light DOM
-      const container = document.createElement("div");
+      // Create the container element based on mode.
+      // "single" uses primaria-content-switcher so the region mixin picks up
+      // selectableAdapterFactory (already registered in UI bootstrapper), giving
+      // SingleActiveAdapter behaviour: activating one view auto-deactivates the rest.
+      const container =
+        this.mode === "single" ? document.createElement("primaria-content-switcher") : document.createElement("div");
       container.id = targetId;
-      container.style.cssText = "width: 100%; height: 100%; min-height: 1px";
+      if (this.mode !== "single") {
+        (container as HTMLElement).style.cssText = "width: 100%; height: 100%; min-height: 1px";
+      }
       this.appendChild(container);
 
       // Set the region metadata directly on the instance constructor

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

@@ -39,7 +39,10 @@ class RegionManagerProxy implements PrimariaRegionManager {
    * @return {Promise<void>} A promise that resolves when the view is successfully registered.
    */
   registerView(regionName: string, view: HarmonixViewDefinition): Promise<void> {
-    this.regionManager.registerViewWithRegion(regionName, `${this.pluginInfo.pluginId}::${view.id}`, view);
+    const key = `${this.pluginInfo.pluginId}::${view.id}`;
+
+    this.regionManager.registerViewWithRegion(regionName, key, view);
+    this.activateIfDefault(regionName, key, view);
     return Promise.resolve();
   }
   /**
@@ -131,6 +134,26 @@ class RegionManagerProxy implements PrimariaRegionManager {
     return mainView?.id;
   }
 
+  /**
+   * Activates a view if it is marked as default and the region currently has no active views.
+   *
+   * @param {string} regionName - The name of the region to activate the view in.
+   * @param {string} key - The key of the view to activate.
+   * @param {HarmonixViewDefinition} view - The view to activate.
+   * @return {void}
+   */
+  activateIfDefault(regionName: string, key: string, view: HarmonixViewDefinition) {
+    if (!(view as any).isDefault) return;
+
+    const region = this.regionManager.getRegion(regionName);
+    if (!region || typeof (region as any).activate !== "function") return;
+
+    const hasActiveView = region.currentActiveViews?.length > 0;
+    if (!hasActiveView) {
+      (region as any).activate(key);
+    }
+  }
+
   _notifyMainViewChanged(viewId: string) {
     this.broker.publish(BROKER_EVENTS.shell.mainViewChanged, { viewId });
   }