@konitif/workbench 0.285.8 → 0.285.10

package/README.md

@@ -13,6 +13,10 @@ 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/application/widgets/widgetZoneProjection.d.ts

@@ -0,0 +1,15 @@
+export type WorkbenchWidgetZoneProjectionReason = 'closed' | 'visible-content' | 'empty-edit-drop-target' | 'empty-runtime';
+export interface WorkbenchWidgetZoneProjection {
+    visible: boolean;
+    acceptsPlacementDrop: boolean;
+    reason: WorkbenchWidgetZoneProjectionReason;
+}
+/**
+ * Projects an authored widget-zone state into host-facing visibility and drop
+ * affordances without owning either the zone content or its renderer.
+ */
+export declare function projectWorkbenchWidgetZone(input: {
+    containerOpen: boolean;
+    visiblePlacementCount: number;
+    layoutEditingEnabled: boolean;
+}): WorkbenchWidgetZoneProjection;

package/dist/application/widgets/widgetZoneProjection.js

@@ -0,0 +1,20 @@
+/**
+ * Projects an authored widget-zone state into host-facing visibility and drop
+ * affordances without owning either the zone content or its renderer.
+ */
+export function projectWorkbenchWidgetZone(input) {
+    if (!input.containerOpen) {
+        return { visible: false, acceptsPlacementDrop: false, reason: 'closed' };
+    }
+    if (input.visiblePlacementCount > 0) {
+        return {
+            visible: true,
+            acceptsPlacementDrop: input.layoutEditingEnabled,
+            reason: 'visible-content'
+        };
+    }
+    if (input.layoutEditingEnabled) {
+        return { visible: true, acceptsPlacementDrop: true, reason: 'empty-edit-drop-target' };
+    }
+    return { visible: false, acceptsPlacementDrop: false, reason: 'empty-runtime' };
+}

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

@@ -6,6 +6,9 @@ export interface WorkbenchToolDockVisibilityConfig {
     legacyVisibleKey?: string | null;
     defaultVisible?: boolean;
 }
+export interface WorkbenchGroupedToolDockConfig extends WorkbenchToolDockVisibilityConfig {
+    defaultRegionId: ShellRegionId;
+}
 export interface WorkbenchToolDockRootConfig extends WorkbenchToolDockVisibilityConfig {
     commandId: string;
     widgetId: string;
@@ -28,3 +31,9 @@ export declare function resolveWorkbenchToolDockEffectiveVisibility(input: {
 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;

package/dist/domain/widget/toolDock.js

@@ -47,6 +47,31 @@ 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);
+}
 function isRecord(value) {
     return !!value && typeof value === 'object' && !Array.isArray(value);
 }

package/dist/index.d.ts

@@ -2,6 +2,9 @@ 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";
 export * from "./application/shell/state.js";

package/dist/index.js

@@ -2,6 +2,9 @@ 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";
 export * from "./application/shell/state.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.8",
+  "version": "0.285.10",
   "description": "Workspace composition, docking, registries and hosting contracts for KONITIF.",
   "repository": {
     "type": "git",

package/reference/catalog.json

@@ -107,7 +107,14 @@
       ],
       "symbolNames": [
         "createWorkbenchWidgetAdapter",
-        "WorkbenchWidgetHosting"
+        "WorkbenchWidgetHosting",
+        "projectWorkbenchWidgetZone",
+        "WorkbenchWidgetZoneProjection",
+        "resolveTabbedShellRegionVisibilityIntent",
+        "TabbedShellRegionVisibilityIntent",
+        "normalizeGroupedWorkbenchToolDockVisibility",
+        "WorkbenchGroupedToolDockConfig",
+        "admitShellWidgetPlacementPreservingRegionState"
       ]
     },
     {