@tutti-os/workbench-surface 0.0.15 → 0.0.16

package/dist/index.d.ts

@@ -449,6 +449,7 @@ interface WorkbenchHostDockEntryAction {
     label: string;
     pendingLabel?: string;
 }
+type WorkbenchHostDockEntryDiagnostics = Record<string, unknown>;
 interface WorkbenchHostDockPopupItemInput {
     externalNodeState?: unknown;
     externalWorkspaceState?: unknown;
@@ -490,6 +491,7 @@ interface WorkbenchHostDockEntry {
     iconSize?: "default" | "large";
     id: string;
     label: string;
+    diagnostics?: WorkbenchHostDockEntryDiagnostics;
     instanceMode?: WorkbenchHostNodeInstanceStrategy["mode"];
     launchBehavior?: WorkbenchHostDockEntryLaunchBehavior;
     launchPayload?: unknown;
@@ -504,7 +506,7 @@ interface WorkbenchHostDockEntry {
     typeId: string;
     visibility?: WorkbenchHostDockEntryVisibility;
 }
-type WorkbenchHostDockEntryDynamicState = Partial<Pick<WorkbenchHostDockEntry, "attentionToken" | "badge" | "hoverActions" | "launchBehavior" | "order" | "state" | "visibility">>;
+type WorkbenchHostDockEntryDynamicState = Partial<Pick<WorkbenchHostDockEntry, "attentionToken" | "badge" | "diagnostics" | "hoverActions" | "launchBehavior" | "order" | "state" | "visibility">>;
 interface WorkbenchHostDockEntryStateSource {
     getEntryState(entryId: string): WorkbenchHostDockEntryDynamicState | null | undefined;
     subscribe(listener: () => void): () => void;

package/dist/index.js

@@ -3896,6 +3896,8 @@ var initializedMetadataKeys = [
 ];
 var COMPACT_LAUNCH_WIDTH_THRESHOLD = 1440;
 var COMPACT_LAUNCH_FRAME_SCALE = 0.85;
+var closedDockWindowFramesMetadataKey = "workbenchHostClosedDockWindowFrames";
+var maxClosedDockWindowFrameEntries = 128;
 function createDefaultLaunchResult(definition, input) {
   return {
     defaultFrame: definition.frame,
@@ -4013,6 +4015,81 @@ function resolveWorkbenchLaunchedHostNodeFrame(input) {
     constraints: input.currentState.layoutConstraints
   });
 }
+function closedDockWindowFrameEntryKey(input) {
+  return JSON.stringify([input.typeId, input.dockEntryId]);
+}
+function readClosedDockWindowFrameEntries(metadata) {
+  const value = metadata?.[closedDockWindowFramesMetadataKey];
+  if (!isRecord(value) || value.version !== 1 || !Array.isArray(value.entries)) {
+    return /* @__PURE__ */ new Map();
+  }
+  const entries = /* @__PURE__ */ new Map();
+  for (const entry of value.entries.slice(0, maxClosedDockWindowFrameEntries)) {
+    const normalized = normalizeClosedDockWindowFrameEntry(entry);
+    if (!normalized) {
+      continue;
+    }
+    entries.set(closedDockWindowFrameEntryKey(normalized), normalized);
+  }
+  return entries;
+}
+function writeClosedDockWindowFrameEntries(metadata, entries) {
+  const normalizedEntries = Array.from(entries).map(normalizeClosedDockWindowFrameEntry).filter((entry) => entry !== null).slice(-maxClosedDockWindowFrameEntries);
+  const nextMetadata = { ...metadata ?? {} };
+  if (normalizedEntries.length === 0) {
+    delete nextMetadata[closedDockWindowFramesMetadataKey];
+  } else {
+    nextMetadata[closedDockWindowFramesMetadataKey] = {
+      version: 1,
+      entries: normalizedEntries
+    };
+  }
+  return Object.keys(nextMetadata).length > 0 ? nextMetadata : void 0;
+}
+function normalizeClosedDockWindowFrameEntry(value) {
+  if (!isRecord(value)) {
+    return null;
+  }
+  const typeId = normalizeNonEmptyString(value.typeId);
+  const dockEntryId = normalizeNonEmptyString(value.dockEntryId);
+  const frame = normalizeWorkbenchFrame(value.frame);
+  if (!typeId || !dockEntryId || !frame) {
+    return null;
+  }
+  return {
+    dockEntryId,
+    frame,
+    typeId
+  };
+}
+function normalizeWorkbenchFrame(value) {
+  if (!isRecord(value)) {
+    return null;
+  }
+  const x = normalizeFiniteNumber(value.x);
+  const y = normalizeFiniteNumber(value.y);
+  const width = normalizeFiniteNumber(value.width);
+  const height = normalizeFiniteNumber(value.height);
+  if (x === null || y === null || width === null || height === null) {
+    return null;
+  }
+  if (width < 160 || height < 120) {
+    return null;
+  }
+  return { height, width, x, y };
+}
+function normalizeFiniteNumber(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    return null;
+  }
+  return Math.round(value);
+}
+function normalizeNonEmptyString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function resolveLaunchFramePolicy(result) {
   return result.framePolicy;
 }
@@ -4506,6 +4583,12 @@ function sanitizeMetadata(metadata) {
       sanitized[key] = true;
     }
   }
+  if (metadata?.[closedDockWindowFramesMetadataKey] !== void 0) {
+    return writeClosedDockWindowFrameEntries(
+      sanitized,
+      readClosedDockWindowFrameEntries(metadata).values()
+    );
+  }
   return Object.keys(sanitized).length > 0 ? sanitized : void 0;
 }
 
@@ -4525,6 +4608,7 @@ var WorkbenchHostSessionController = class {
   isDisposed = false;
   isSnapshotLoaded = false;
   loadedSnapshot;
+  closedDockWindowFrameEntries = /* @__PURE__ */ new Map();
   loadGeneration = 0;
   loadPromise = null;
   nodeLeases = /* @__PURE__ */ new Map();
@@ -4550,6 +4634,9 @@ var WorkbenchHostSessionController = class {
       this.nodeDefinitionByType.set(definition.typeId, definition);
     }
     this.loadedSnapshot = this.readCachedSnapshot();
+    this.closedDockWindowFrameEntries = readClosedDockWindowFrameEntries(
+      this.loadedSnapshot?.metadata
+    );
     this.projectedNodes = input.projectedNodes ?? [];
     this.controller = createWorkbenchController(
       stateFromSnapshotOrDefinitions(
@@ -4655,6 +4742,7 @@ var WorkbenchHostSessionController = class {
   }
   closeNode(nodeId) {
     this.runWhenReady(this.loadGeneration, () => {
+      this.rememberClosedDockWindowFrame(nodeId);
       this.controller.commands.closeNode(nodeId);
     });
   }
@@ -4777,6 +4865,9 @@ var WorkbenchHostSessionController = class {
         return;
       }
       this.loadedSnapshot = snapshot;
+      this.closedDockWindowFrameEntries = readClosedDockWindowFrameEntries(
+        snapshot?.metadata
+      );
       this.controller.commands.replaceState(
         stateFromSnapshotOrDefinitions(
           snapshot,
@@ -4790,6 +4881,7 @@ var WorkbenchHostSessionController = class {
         return;
       }
       this.loadedSnapshot = null;
+      this.closedDockWindowFrameEntries = /* @__PURE__ */ new Map();
       this.controller.commands.replaceState(
         stateFromSnapshotOrDefinitions(
           null,
@@ -4833,6 +4925,7 @@ var WorkbenchHostSessionController = class {
       if (this.isDisposed || resolvedDecision === "keep-open" || generation !== this.loadGeneration) {
         return;
       }
+      this.rememberClosedDockWindowFrame(node.id);
       this.controller.commands.closeNode(node.id);
     }, noop);
   }
@@ -4964,18 +5057,19 @@ var WorkbenchHostSessionController = class {
     if (!definition) {
       return null;
     }
+    const launchResult = this.applyClosedDockWindowFrame(result);
     const exactExisting = this.findExistingNodeByTarget({
-      instanceId: result.instanceId,
-      typeId: result.typeId
+      instanceId: launchResult.instanceId,
+      typeId: launchResult.typeId
     });
-    const dockEntryExisting = exactExisting ? null : this.findExistingNodeByDockEntry(result);
+    const dockEntryExisting = exactExisting ? null : this.findExistingNodeByDockEntry(launchResult);
     const existing = exactExisting ?? dockEntryExisting;
     if (existing) {
       this.controller.commands.setNodeSizeConstraints(
         existing.id,
-        result.sizeConstraints ?? definition.sizeConstraints ?? null
+        launchResult.sizeConstraints ?? definition.sizeConstraints ?? null
       );
-      if (exactExisting && result.framePolicy === "cascade-same-type-centered") {
+      if (exactExisting && launchResult.framePolicy === "cascade-same-type-centered") {
         const currentState = this.controller.getSnapshot();
         const resolvedFrame2 = resolveWorkbenchLaunchedHostNodeFrame({
           currentState: {
@@ -4986,26 +5080,26 @@ var WorkbenchHostSessionController = class {
             )
           },
           definition,
-          result
+          result: launchResult
         });
         this.controller.commands.resizeNode(existing.id, resolvedFrame2);
       }
       this.restoreAndFocusNode(existing.id);
-      if (result.activation) {
-        this.activateNodeNow({ nodeId: existing.id }, result.activation);
+      if (launchResult.activation) {
+        this.activateNodeNow({ nodeId: existing.id }, launchResult.activation);
       }
       return existing.id;
     }
     const resolvedFrame = resolveWorkbenchLaunchedHostNodeFrame({
       currentState: this.controller.getSnapshot(),
       definition,
-      result
+      result: launchResult
     });
     const nextNode = createWorkbenchLaunchedHostNode({
-      activation: this.createActivationEnvelope(result.activation),
+      activation: this.createActivationEnvelope(launchResult.activation),
       definition,
       resolvedFrame,
-      result
+      result: launchResult
     });
     this.controller.commands.openNode(nextNode);
     this.controller.commands.focusNode(nextNode.id);
@@ -5161,10 +5255,13 @@ var WorkbenchHostSessionController = class {
         ),
         {
           activeSpaceId: this.loadedSnapshot?.activeSpaceId,
-          metadata: {
-            ...this.loadedSnapshot?.metadata ?? {},
-            [initializedMetadataKey]: true
-          },
+          metadata: writeClosedDockWindowFrameEntries(
+            {
+              ...this.loadedSnapshot?.metadata ?? {},
+              [initializedMetadataKey]: true
+            },
+            this.closedDockWindowFrameEntries.values()
+          ),
           spaces: this.loadedSnapshot?.spaces
         }
       )
@@ -5178,6 +5275,42 @@ var WorkbenchHostSessionController = class {
       this.loadedSnapshot = savedSnapshot;
     }, noop);
   }
+  rememberClosedDockWindowFrame(nodeId) {
+    const node = this.controller.getSnapshot().nodes.find((entry2) => entry2.id === nodeId);
+    const dockEntryId = node?.data.dockEntryId?.trim();
+    if (!node || !dockEntryId) {
+      return;
+    }
+    const entry = {
+      dockEntryId,
+      frame: node.displayMode === "fullscreen" && node.restoreFrame ? node.restoreFrame : node.frame,
+      typeId: node.data.typeId
+    };
+    this.closedDockWindowFrameEntries.set(
+      closedDockWindowFrameEntryKey(entry),
+      entry
+    );
+  }
+  applyClosedDockWindowFrame(result) {
+    const dockEntryId = result.dockEntryId?.trim();
+    if (!dockEntryId) {
+      return result;
+    }
+    const entry = this.closedDockWindowFrameEntries.get(
+      closedDockWindowFrameEntryKey({
+        dockEntryId,
+        typeId: result.typeId
+      })
+    );
+    if (!entry) {
+      return result;
+    }
+    return {
+      ...result,
+      defaultFrame: entry.frame,
+      framePolicy: "absolute"
+    };
+  }
   loadedSnapshotSaveKey() {
     if (!this.loadedSnapshot) {
       return null;
@@ -5602,6 +5735,9 @@ function resolveWorkbenchDockEntryClick(input) {
     }
     return { actionId: input.entry.clickActionId, kind: "action" };
   }
+  if (isWorkbenchDockEntryBlocked(input.entry)) {
+    return { kind: "blocked" };
+  }
   if (input.instanceMode === "multi" && input.matchedNodes.length > 0) {
     return { kind: "open-popup" };
   }
@@ -5611,9 +5747,6 @@ function resolveWorkbenchDockEntryClick(input) {
   if (input.matchedNodes.length > 1) {
     return { kind: "open-popup" };
   }
-  if (isWorkbenchDockEntryBlocked(input.entry)) {
-    return { kind: "blocked" };
-  }
   return { kind: "launch" };
 }
 function isWorkbenchDockEntryBlocked(entry) {
@@ -8107,13 +8240,13 @@ function WorkbenchHostDock({
                           "aria-expanded": currentPopup ? true : void 0,
                           "aria-haspopup": clickResolution.kind === "open-popup" ? "dialog" : void 0,
                           "aria-label": i18n.t("launch", { title: entry.label }),
-                          "aria-disabled": clickResolution.kind === "blocked" && !resolvedEntry.hasMatchingNodes,
+                          "aria-disabled": clickResolution.kind === "blocked" ? true : void 0,
                           className: "desktop-dock__btn",
-                          "data-interactive": clickResolution.kind === "blocked" && !resolvedEntry.hasMatchingNodes ? "false" : "true",
+                          "data-interactive": clickResolution.kind === "blocked" ? "false" : "true",
                           title: entry.label,
                           type: "button",
                           onPointerDown: () => {
-                            if (clickResolution.kind === "blocked" && !resolvedEntry.hasMatchingNodes) {
+                            if (clickResolution.kind === "blocked") {
                               return;
                             }
                             beginDockIconInteraction(anchorKey);
@@ -8122,8 +8255,18 @@ function WorkbenchHostDock({
                             logWorkbenchDockDebug("dock.click", debugDiagnostics, {
                               anchorKey,
                               clickResolution,
+                              dockDiagnostics: entry.diagnostics ?? null,
                               dockNodeState: resolvedEntry.dockNodeState,
                               entryId: entry.id,
+                              entryLaunchBehavior: entry.launchBehavior ?? "enabled",
+                              entryOrder: entry.order ?? null,
+                              entryState: entry.state ?? { kind: "enabled" },
+                              entryVisibility: entry.visibility ?? "always",
+                              hoverActions: entry.hoverActions?.map((action) => ({
+                                disabled: action.disabled === true,
+                                id: action.id,
+                                pending: Boolean(action.pendingLabel)
+                              })) ?? [],
                               instanceMode: instanceMode ?? null,
                               matchedNodeCount: resolvedEntry.matchedNodes.length,
                               matchedNodeIds: resolvedEntry.matchedNodes.map(