@konitif/workbench 0.285.8 → 0.285.9

package/README.md

@@ -13,6 +13,7 @@ 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.
 - Runtime lifecycle, checkpoint, recovery and observability contracts.
 - Project preflight and repository-quality contracts.
 - Explicit workspace persistence, synchronization and surface ports.

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/index.d.ts

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

package/package.json

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

package/reference/catalog.json

@@ -107,7 +107,9 @@
       ],
       "symbolNames": [
         "createWorkbenchWidgetAdapter",
-        "WorkbenchWidgetHosting"
+        "WorkbenchWidgetHosting",
+        "projectWorkbenchWidgetZone",
+        "WorkbenchWidgetZoneProjection"
       ]
     },
     {