@konitif/workbench 0.285.9 → 0.285.11

package/README.md

@@ -14,6 +14,9 @@ npm install @konitif/workbench
 - Workspace, layout, panel and shell contracts.
 - Tool and widget admission, registries and hosting adapters.
 - Generic widget-zone visibility and placement-drop projection.
+- Generic tabbed-region visibility coordination for grouped widgets.
+- Atomic visibility normalization for internal tool docks sharing a region.
+- Root Widget admission that preserves restored region state.
 - Runtime lifecycle, checkpoint, recovery and observability contracts.
 - Project preflight and repository-quality contracts.
 - Explicit workspace persistence, synchronization and surface ports.

package/dist/application/widgets/rootShellWidgetAdmission.d.ts

@@ -0,0 +1,13 @@
+import type { ShellRegionId, ShellState, ShellWidgetPlacement } from "../../domain/shell/model.js";
+export interface RootShellWidgetAdmissionActions {
+    moveShellWidgetToRegion(regionId: ShellRegionId, widgetId: string, placement?: ShellWidgetPlacement): void;
+    activateShellWidget(regionId: ShellRegionId, widgetId: string): void;
+    setShellRegionVisible(regionId: ShellRegionId, isVisible: boolean): void;
+    setShellRegionOpen(regionId: ShellRegionId, isOpen: boolean): void;
+}
+export declare function isShellWidgetAlreadyPlaced(shell: ShellState, widgetId: string): boolean;
+/**
+ * Admits one missing root Widget without allowing the placement operation to
+ * overwrite the region state restored from the Workspace.
+ */
+export declare function admitShellWidgetPlacementPreservingRegionState(shell: ShellState, actions: RootShellWidgetAdmissionActions, regionId: ShellRegionId, widgetId: string, placement?: ShellWidgetPlacement): boolean;

package/dist/application/widgets/rootShellWidgetAdmission.js

@@ -0,0 +1,20 @@
+export function isShellWidgetAlreadyPlaced(shell, widgetId) {
+    return Object.values(shell.regions).some((region) => region.widgetIds.includes(widgetId));
+}
+/**
+ * Admits one missing root Widget without allowing the placement operation to
+ * overwrite the region state restored from the Workspace.
+ */
+export function admitShellWidgetPlacementPreservingRegionState(shell, actions, regionId, widgetId, placement = {}) {
+    if (isShellWidgetAlreadyPlaced(shell, widgetId)) {
+        return false;
+    }
+    const region = shell.regions[regionId];
+    actions.moveShellWidgetToRegion(regionId, widgetId, placement);
+    if (region.activeWidgetId) {
+        actions.activateShellWidget(regionId, region.activeWidgetId);
+    }
+    actions.setShellRegionVisible(regionId, region.isVisible);
+    actions.setShellRegionOpen(regionId, region.isOpen);
+    return true;
+}

package/dist/application/widgets/tabbedShellRegionVisibility.d.ts

@@ -0,0 +1,14 @@
+import type { ShellRegionState } from "../../domain/shell/model.js";
+export type TabbedShellRegionVisibilityIntent = {
+    kind: 'widget';
+} | {
+    kind: 'close-group';
+} | {
+    kind: 'open-group';
+    revealWidgetIds: string[];
+};
+/**
+ * Projects a widget visibility request into the coordination required by a
+ * tabbed shell region. The host remains responsible for applying the intent.
+ */
+export declare function resolveTabbedShellRegionVisibilityIntent(region: ShellRegionState, widgetId: string, isVisible: boolean): TabbedShellRegionVisibilityIntent;

package/dist/application/widgets/tabbedShellRegionVisibility.js

@@ -0,0 +1,18 @@
+/**
+ * Projects a widget visibility request into the coordination required by a
+ * tabbed shell region. The host remains responsible for applying the intent.
+ */
+export function resolveTabbedShellRegionVisibilityIntent(region, widgetId, isVisible) {
+    if ((region.presentation ?? 'tabs') !== 'tabs'
+        || region.widgetIds.length < 2
+        || !region.widgetIds.includes(widgetId)) {
+        return { kind: 'widget' };
+    }
+    if (!isVisible) {
+        return { kind: 'close-group' };
+    }
+    return {
+        kind: 'open-group',
+        revealWidgetIds: region.widgetIds.filter((candidateId) => candidateId !== widgetId),
+    };
+}

package/dist/domain/widget/toolDock.d.ts

@@ -1,4 +1,4 @@
-import type { ShellRegionId, ShellRegionPresentation } from "../shell/model.js";
+import type { ShellRegionId, ShellRegionPresentation, ShellState } from "../shell/model.js";
 import type { JsonObject } from "../shared/json.js";
 export type WorkbenchToolDockActionSide = 'top' | 'right' | 'bottom' | 'left';
 export interface WorkbenchToolDockVisibilityConfig {
@@ -6,6 +6,10 @@ export interface WorkbenchToolDockVisibilityConfig {
     legacyVisibleKey?: string | null;
     defaultVisible?: boolean;
 }
+export interface WorkbenchGroupedToolDockConfig extends WorkbenchToolDockVisibilityConfig {
+    defaultRegionId: ShellRegionId;
+    rootWidgetId?: string | null;
+}
 export interface WorkbenchToolDockRootConfig extends WorkbenchToolDockVisibilityConfig {
     commandId: string;
     widgetId: string;
@@ -17,6 +21,7 @@ export interface WorkbenchToolDockRootLocation {
     isOpen: boolean;
     activeWidgetId: string | null;
     presentation?: ShellRegionPresentation;
+    size?: number;
 }
 export declare function resolveWorkbenchToolDockSide(regionId: ShellRegionId | null | undefined): WorkbenchToolDockActionSide;
 export declare function readWorkbenchToolDockVisibility(state: unknown, config: WorkbenchToolDockVisibilityConfig): boolean;
@@ -25,6 +30,14 @@ export declare function resolveWorkbenchToolDockEffectiveVisibility(input: {
     internalVisible: boolean;
     widgetId: string;
 }): boolean;
+export declare function resolveWorkbenchToolDockRootLocation(shellState: ShellState, widgetId: string): WorkbenchToolDockRootLocation | null;
 export declare function patchWorkbenchToolDockVisibilityState(state: unknown, input: WorkbenchToolDockVisibilityConfig & {
     isVisible: boolean;
 }): JsonObject;
+/**
+ * Normalizes the single-dock visibility request emitted by a tabbed tool dock
+ * into one atomic state snapshot for every dock sharing the same region.
+ * Docks projected into a root shell region remain independently managed.
+ */
+export declare function normalizeGroupedWorkbenchToolDockVisibility(currentState: JsonObject, requestedState: JsonObject, docks: readonly WorkbenchGroupedToolDockConfig[], individuallyManagedDockIds?: ReadonlySet<string>): JsonObject;
+export declare function normalizeGroupedWorkbenchToolDockVisibilityForShellState(currentState: JsonObject, requestedState: JsonObject, docks: readonly WorkbenchGroupedToolDockConfig[], shellState: ShellState): JsonObject;

package/dist/domain/widget/toolDock.js

@@ -27,6 +27,23 @@ export function resolveWorkbenchToolDockEffectiveVisibility(input) {
     }
     return location.isVisible && location.isOpen && (location.presentation === 'stack' || location.activeWidgetId === input.widgetId);
 }
+export function resolveWorkbenchToolDockRootLocation(shellState, widgetId) {
+    const regionIds = ['left', 'right', 'bottom'];
+    for (const regionId of regionIds) {
+        const region = shellState.regions[regionId];
+        if (region.widgetIds.includes(widgetId)) {
+            return {
+                regionId,
+                isVisible: region.isVisible && !(region.hiddenWidgetIds ?? []).includes(widgetId),
+                isOpen: region.isOpen,
+                activeWidgetId: region.activeWidgetId,
+                presentation: region.presentation ?? 'tabs',
+                size: region.size
+            };
+        }
+    }
+    return null;
+}
 export function patchWorkbenchToolDockVisibilityState(state, input) {
     const currentState = isRecord(state) ? state : {};
     const dockContainers = isRecord(currentState.dockContainers) ? currentState.dockContainers : {};
@@ -47,6 +64,37 @@ export function patchWorkbenchToolDockVisibilityState(state, input) {
     }
     return nextState;
 }
+/**
+ * Normalizes the single-dock visibility request emitted by a tabbed tool dock
+ * into one atomic state snapshot for every dock sharing the same region.
+ * Docks projected into a root shell region remain independently managed.
+ */
+export function normalizeGroupedWorkbenchToolDockVisibility(currentState, requestedState, docks, individuallyManagedDockIds = new Set()) {
+    const changedDocks = docks.filter((dock) => readWorkbenchToolDockVisibility(currentState, dock) !==
+        readWorkbenchToolDockVisibility(requestedState, dock));
+    if (changedDocks.length !== 1) {
+        return requestedState;
+    }
+    const changedDock = changedDocks[0];
+    if (individuallyManagedDockIds.has(changedDock.dockId)) {
+        return requestedState;
+    }
+    const groupedDocks = docks.filter((dock) => dock.defaultRegionId === changedDock.defaultRegionId);
+    if (groupedDocks.length < 2) {
+        return requestedState;
+    }
+    const isVisible = readWorkbenchToolDockVisibility(requestedState, changedDock);
+    return groupedDocks.reduce((state, dock) => patchWorkbenchToolDockVisibilityState(state, {
+        ...dock,
+        isVisible
+    }), requestedState);
+}
+export function normalizeGroupedWorkbenchToolDockVisibilityForShellState(currentState, requestedState, docks, shellState) {
+    const rootManagedDockIds = new Set(docks.flatMap((dock) => dock.rootWidgetId && resolveWorkbenchToolDockRootLocation(shellState, dock.rootWidgetId)
+        ? [dock.dockId]
+        : []));
+    return normalizeGroupedWorkbenchToolDockVisibility(currentState, requestedState, docks, rootManagedDockIds);
+}
 function isRecord(value) {
     return !!value && typeof value === 'object' && !Array.isArray(value);
 }

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export * from "./boot/index.js";
 export * from "./application/launch/workbenchLaunchPolicy.js";
 export * from "./application/launch/catalogShareReference.js";
 export * from "./application/widgets/createWorkbenchWidgetAdapter.js";
+export * from "./application/widgets/rootShellWidgetAdmission.js";
+export * from "./application/widgets/tabbedShellRegionVisibility.js";
 export * from "./application/widgets/widgetZoneProjection.js";
 export * from "./application/tool/experienceToolSelection.js";
 export * from "./stage/index.js";

package/dist/index.js

@@ -2,6 +2,8 @@ export * from "./boot/index.js";
 export * from "./application/launch/workbenchLaunchPolicy.js";
 export * from "./application/launch/catalogShareReference.js";
 export * from "./application/widgets/createWorkbenchWidgetAdapter.js";
+export * from "./application/widgets/rootShellWidgetAdmission.js";
+export * from "./application/widgets/tabbedShellRegionVisibility.js";
 export * from "./application/widgets/widgetZoneProjection.js";
 export * from "./application/tool/experienceToolSelection.js";
 export * from "./stage/index.js";

package/dist/workspace-contracts.d.ts

@@ -1,3 +1,4 @@
+export { admitShellWidgetPlacementPreservingRegionState, isShellWidgetAlreadyPlaced } from "./application/widgets/rootShellWidgetAdmission.js";
 export { setShellRegionArrangement, setShellRegionWidgetProportions, createShellState, setShellRegionVisible, setShellRegionOpen, setShellRegionSize, activateShellWidget, setShellRegionWidgetVisible, addShellWidgetToRegion, moveShellWidgetToRegion, removeShellWidgetFromRegion } from "./application/shell/state.js";
 export { collapseSplit } from "./application/workspace/collapseSplit.js";
 export { collapseSplitBoundary } from "./application/workspace/collapseSplitBoundary.js";

package/dist/workspace-contracts.js

@@ -1,5 +1,6 @@
 // Explicit workspace contracts for state orchestration. No host adapters.
 // Reexports preserve the authority and identity of the existing implementations.
+export { admitShellWidgetPlacementPreservingRegionState, isShellWidgetAlreadyPlaced } from "./application/widgets/rootShellWidgetAdmission.js";
 export { setShellRegionArrangement, setShellRegionWidgetProportions, createShellState, setShellRegionVisible, setShellRegionOpen, setShellRegionSize, activateShellWidget, setShellRegionWidgetVisible, addShellWidgetToRegion, moveShellWidgetToRegion, removeShellWidgetFromRegion } from "./application/shell/state.js";
 export { collapseSplit } from "./application/workspace/collapseSplit.js";
 export { collapseSplitBoundary } from "./application/workspace/collapseSplitBoundary.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@konitif/workbench",
   "license": "PolyForm-Noncommercial-1.0.0",
-  "version": "0.285.9",
+  "version": "0.285.11",
   "description": "Workspace composition, docking, registries and hosting contracts for KONITIF.",
   "repository": {
     "type": "git",

package/reference/catalog.json

@@ -109,7 +109,12 @@
         "createWorkbenchWidgetAdapter",
         "WorkbenchWidgetHosting",
         "projectWorkbenchWidgetZone",
-        "WorkbenchWidgetZoneProjection"
+        "WorkbenchWidgetZoneProjection",
+        "resolveTabbedShellRegionVisibilityIntent",
+        "TabbedShellRegionVisibilityIntent",
+        "normalizeGroupedWorkbenchToolDockVisibility",
+        "WorkbenchGroupedToolDockConfig",
+        "admitShellWidgetPlacementPreservingRegionState"
       ]
     },
     {