@floegence/floe-webapp-core 0.36.18 → 0.36.20

package/dist/components/workbench/WorkbenchWidget.js

@@ -1,51 +1,66 @@
-import { spread as L, mergeProps as at, insert as l, createComponent as c, memo as rt, template as q, use as dt, delegateEvents as lt } from "solid-js/web";
-import { createSignal as C, onCleanup as ct, untrack as S, createMemo as f } from "solid-js";
-import { startHotInteraction as A } from "../../utils/hotInteraction.js";
-import { X as O, Minus as F, Maximize as N, GripVertical as st } from "../icons/index.js";
-import { CANVAS_WHEEL_INTERACTIVE_ATTR as wt, WORKBENCH_WIDGET_SHELL_ATTR as gt, shouldActivateWorkbenchWidgetLocalTarget as ht, resolveWorkbenchWidgetEventOwnership as ut } from "../ui/localInteractionSurface.js";
-import { startPointerSession as j } from "../ui/pointerSession.js";
-import { createWorkbenchWidgetSurfaceMetrics as ft } from "./workbenchHelpers.js";
-var _t = /* @__PURE__ */ q('<article class=workbench-widget data-floe-dialog-surface-host=true><header class=workbench-widget__header><span class=workbench-widget__traffic role=group aria-label="Window controls"><button type=button class="workbench-widget__traffic-dot workbench-widget__traffic-dot--close"aria-label="Close widget"title="Close widget"data-floe-canvas-interactive=true></button><button type=button class="workbench-widget__traffic-dot workbench-widget__traffic-dot--min"aria-label="Minimize widget to overview"title="Minimize widget to overview"data-floe-canvas-interactive=true></button><button type=button class="workbench-widget__traffic-dot workbench-widget__traffic-dot--max"aria-label="Zoom widget to fit viewport"title="Zoom widget to fit viewport"data-floe-canvas-interactive=true></button></span><span class=workbench-widget__badge aria-hidden=true></span><button type=button class=workbench-widget__drag aria-label="Drag widget"data-floe-canvas-interactive=true></button><div class=workbench-widget__title-area><span class=workbench-widget__title-dot aria-hidden=true></span><span class=workbench-widget__title></span></div><span class=workbench-widget__window-controls role=group aria-label="Window controls"><button type=button class="workbench-widget__window-control workbench-widget__window-control--min"aria-label="Minimize widget to overview"title="Minimize widget to overview"data-floe-canvas-interactive=true></button><button type=button class="workbench-widget__window-control workbench-widget__window-control--max"aria-label="Zoom widget to fit viewport"title="Zoom widget to fit viewport"data-floe-canvas-interactive=true></button><button type=button class="workbench-widget__window-control workbench-widget__window-control--close"aria-label="Remove widget"title="Remove widget"data-floe-canvas-interactive=true></button></span></header><div class=workbench-widget__body data-floe-canvas-interactive=true>'), bt = /* @__PURE__ */ q('<div class=workbench-widget__resize aria-label="Resize widget"data-floe-canvas-interactive=true><svg class=workbench-widget__resize-glyph viewBox="0 0 12 12"aria-hidden=true><path d="M12 0 L0 12"></path><path d="M12 4 L4 12"></path><path d="M12 8 L8 12">');
-const mt = 220, vt = 160, B = '[data-floe-canvas-interactive="true"]', V = '[data-floe-canvas-pan-surface="true"]';
-function Ct(t) {
-  const [_, I] = C(null), [b, x] = C(null), [G, Z] = C();
-  let h, u, g;
-  ct(() => {
-    h?.stop({
+import { spread as F, mergeProps as rt, insert as l, createComponent as c, memo as dt, template as B, use as lt, delegateEvents as ct } from "solid-js/web";
+import { createMemo as u, createSignal as W, onCleanup as st, untrack as f } from "solid-js";
+import { startHotInteraction as wt } from "../../utils/hotInteraction.js";
+import { X as j, Minus as O, Maximize as q, GripVertical as gt } from "../icons/index.js";
+import { CANVAS_WHEEL_INTERACTIVE_ATTR as ht, WORKBENCH_WIDGET_SHELL_ATTR as ut, shouldActivateWorkbenchWidgetLocalTarget as ft } from "../ui/localInteractionSurface.js";
+import { startPointerSession as N } from "../ui/pointerSession.js";
+import { createWorkbenchWidgetSurfaceMetrics as _t } from "./workbenchHelpers.js";
+import { resolveWorkbenchInteractionAdapter as bt } from "./workbenchInteractionAdapter.js";
+var mt = /* @__PURE__ */ B('<article class=workbench-widget><header class=workbench-widget__header><span class=workbench-widget__traffic role=group aria-label="Window controls"><button type=button class="workbench-widget__traffic-dot workbench-widget__traffic-dot--close"aria-label="Close widget"title="Close widget"data-floe-canvas-interactive=true></button><button type=button class="workbench-widget__traffic-dot workbench-widget__traffic-dot--min"aria-label="Minimize widget to overview"title="Minimize widget to overview"data-floe-canvas-interactive=true></button><button type=button class="workbench-widget__traffic-dot workbench-widget__traffic-dot--max"aria-label="Zoom widget to fit viewport"title="Zoom widget to fit viewport"data-floe-canvas-interactive=true></button></span><span class=workbench-widget__badge aria-hidden=true></span><button type=button class=workbench-widget__drag aria-label="Drag widget"data-floe-canvas-interactive=true></button><div class=workbench-widget__title-area><span class=workbench-widget__title-dot aria-hidden=true></span><span class=workbench-widget__title></span></div><span class=workbench-widget__window-controls role=group aria-label="Window controls"><button type=button class="workbench-widget__window-control workbench-widget__window-control--min"aria-label="Minimize widget to overview"title="Minimize widget to overview"data-floe-canvas-interactive=true></button><button type=button class="workbench-widget__window-control workbench-widget__window-control--max"aria-label="Zoom widget to fit viewport"title="Zoom widget to fit viewport"data-floe-canvas-interactive=true></button><button type=button class="workbench-widget__window-control workbench-widget__window-control--close"aria-label="Remove widget"title="Remove widget"data-floe-canvas-interactive=true></button></span></header><div class=workbench-widget__body data-floe-canvas-interactive=true>'), vt = /* @__PURE__ */ B('<div class=workbench-widget__resize aria-label="Resize widget"data-floe-canvas-interactive=true><svg class=workbench-widget__resize-glyph viewBox="0 0 12 12"aria-hidden=true><path d="M12 0 L0 12"></path><path d="M12 4 L4 12"></path><path d="M12 8 L8 12">');
+const $t = 220, St = 160;
+function Rt(t) {
+  const s = u(() => bt(t.interactionAdapter)), [m, y] = W(null), [v, x] = W(null), [V, Z] = W();
+  let _, b, g;
+  const z = (e, i) => {
+    const r = wt({
+      kind: e,
+      cursor: i
+    });
+    let d = !1;
+    return f(() => t.onLayoutInteractionStart?.()), () => {
+      d || (d = !0, r(), f(() => t.onLayoutInteractionEnd?.()));
+    };
+  };
+  st(() => {
+    _?.stop({
       reason: "manual_stop",
       commit: !1
-    }), h = void 0, u?.stop({
+    }), _ = void 0, b?.stop({
       reason: "manual_stop",
       commit: !1
-    }), u = void 0, S(_)?.stopInteraction(), S(b)?.stopInteraction();
+    }), b = void 0, f(m)?.stopInteraction(), f(v)?.stopInteraction();
   });
-  const W = () => _() !== null, R = () => b() !== null, p = (e) => ut({
+  const R = () => m() !== null, T = () => v() !== null, G = u(() => t.filtered ? "cold" : t.selected ? "hot" : "warm"), X = (e) => s().resolveWidgetEventOwnership({
     target: e,
     widgetRoot: g ?? null,
-    interactiveSelector: B,
-    panSurfaceSelector: V
-  }), K = (e) => {
+    interactiveSelector: s().interactiveSelector,
+    panSurfaceSelector: s().panSurfaceSelector
+  }), K = () => {
+    t.onSelect(t.widgetId), t.onCommitFront(t.widgetId), g?.focus({
+      preventScroll: !0
+    });
+  }, J = (e) => {
     if (e.button !== 0) return;
     t.onSelect(t.widgetId), t.onCommitFront(t.widgetId);
-    const i = p(e.target);
+    const i = X(e.target);
     if (i === "widget_shell") {
       g?.focus({
         preventScroll: !0
       });
       return;
     }
-    i === "widget_local" && ht({
+    i === "widget_local" && ft({
       target: e.target,
       widgetRoot: g ?? null,
-      interactiveSelector: B,
-      panSurfaceSelector: V
+      interactiveSelector: s().interactiveSelector,
+      panSurfaceSelector: s().panSurfaceSelector
     }) && Z((r) => ({
       seq: (r?.seq ?? 0) + 1,
       source: "local_pointer",
       pointerType: e.pointerType || void 0
     }));
-  }, m = f(() => {
-    const e = _();
+  }, $ = u(() => {
+    const e = m();
     return e ? {
       x: e.worldX,
       y: e.worldY
@@ -53,8 +68,8 @@ function Ct(t) {
       x: t.x,
       y: t.y
     };
-  }), v = f(() => {
-    const e = b();
+  }), S = u(() => {
+    const e = v();
     return e ? {
       width: e.width,
       height: e.height
@@ -62,34 +77,34 @@ function Ct(t) {
       width: t.width,
       height: t.height
     };
-  }), E = f(() => {
+  }), Y = u(() => {
     if (!(t.layoutMode !== "projected_surface" || !t.projectedViewport))
-      return ft({
+      return _t({
         widgetId: t.widgetId,
-        worldX: m().x,
-        worldY: m().y,
-        worldWidth: v().width,
-        worldHeight: v().height,
+        worldX: $().x,
+        worldY: $().y,
+        worldWidth: S().width,
+        worldHeight: S().height,
         viewport: t.projectedViewport,
         ready: t.surfaceReady ?? !0
       });
-  }), U = f(() => {
+  }), Q = u(() => {
     const e = t.itemSnapshot().z_index, i = Number.isFinite(e) ? Math.max(1, Math.min(99, Math.round(e))) : 1;
     return String(i).padStart(2, "0");
-  }), T = (e) => {
+  }), D = (e) => {
     e.preventDefault(), e.stopPropagation(), t.onRequestOverview(t.itemSnapshot());
-  }, z = (e) => {
+  }, P = (e) => {
     e.preventDefault(), e.stopPropagation(), t.onRequestFit(t.itemSnapshot());
-  }, D = (e) => {
+  }, A = (e) => {
     e.preventDefault(), e.stopPropagation(), t.onRequestDelete(t.widgetId);
-  }, J = f(() => {
+  }, U = u(() => {
     const e = {
-      width: `${v().width}px`,
-      height: `${v().height}px`,
-      "z-index": W() || R() || t.optimisticFront ? `${t.topRenderLayer + 1}` : `${t.renderLayer}`
+      width: `${S().width}px`,
+      height: `${S().height}px`,
+      "z-index": R() || T() || t.optimisticFront ? `${t.topRenderLayer + 1}` : `${t.renderLayer}`
     };
     if (t.layoutMode === "projected_surface") {
-      const i = E()?.rect;
+      const i = Y()?.rect;
       return {
         ...e,
         left: `${i?.screenX ?? 0}px`,
@@ -99,10 +114,10 @@ function Ct(t) {
     }
     return {
       ...e,
-      transform: `translate(${m().x}px, ${m().y}px)`
+      transform: `translate(${$().x}px, ${$().y}px)`
     };
-  }), Q = (e) => {
-    const i = S(_);
+  }), tt = (e) => {
+    const i = f(m);
     if (!i) return;
     const r = {
       x: i.worldX,
@@ -111,20 +126,17 @@ function Ct(t) {
       x: i.startWorldX,
       y: i.startWorldY
     }, a = e && (Math.abs(r.x - d.x) > 1 || Math.abs(r.y - d.y) > 1);
-    t.onCommitFront(t.widgetId), a && t.onCommitMove(t.widgetId, r), i.stopInteraction(), I(null), h = void 0;
-  }, X = (e) => {
+    t.onCommitFront(t.widgetId), a && t.onCommitMove(t.widgetId, r), i.stopInteraction(), y(null), _ = void 0;
+  }, E = (e) => {
     if (e.button !== 0 || t.locked) return;
-    e.preventDefault(), e.stopPropagation(), h?.stop({
+    e.preventDefault(), e.stopPropagation(), _?.stop({
       reason: "manual_stop",
       commit: !1
     }), t.onSelect(t.widgetId), g?.focus({
       preventScroll: !0
     }), t.onStartOptimisticFront(t.widgetId);
-    const i = A({
-      kind: "drag",
-      cursor: "grabbing"
-    }), r = Math.max(t.viewportScale, 1e-3);
-    I({
+    const i = z("drag", "grabbing"), r = Math.max(t.viewportScale, 1e-3);
+    y({
       pointerId: e.pointerId,
       startClientX: e.clientX,
       startClientY: e.clientY,
@@ -137,43 +149,40 @@ function Ct(t) {
       stopInteraction: i
     });
     const d = (a) => {
-      I((o) => {
-        if (!o || o.pointerId !== a.pointerId) return o;
-        const w = o.startWorldX + (a.clientX - o.startClientX) / o.scale, s = o.startWorldY + (a.clientY - o.startClientY) / o.scale;
+      y((n) => {
+        if (!n || n.pointerId !== a.pointerId) return n;
+        const h = n.startWorldX + (a.clientX - n.startClientX) / n.scale, w = n.startWorldY + (a.clientY - n.startClientY) / n.scale;
         return {
-          ...o,
-          worldX: w,
-          worldY: s,
-          moved: o.moved || Math.abs(w - o.startWorldX) > 2 || Math.abs(s - o.startWorldY) > 2
+          ...n,
+          worldX: h,
+          worldY: w,
+          moved: n.moved || Math.abs(h - n.startWorldX) > 2 || Math.abs(w - n.startWorldY) > 2
         };
       });
     };
-    h = j({
+    _ = N({
       pointerEvent: e,
       captureEl: e.currentTarget,
       onMove: d,
       onEnd: ({
         commit: a
-      }) => Q(a)
+      }) => tt(a)
     });
-  }, tt = (e) => {
-    const i = S(b);
+  }, et = (e) => {
+    const i = f(v);
     if (!i) return;
     const r = {
       width: i.width,
       height: i.height
     }, d = Math.abs(i.width - i.startWidth) > 1 || Math.abs(i.height - i.startHeight) > 1;
-    e && d && t.onCommitResize(t.widgetId, r), i.stopInteraction(), x(null), u = void 0;
-  }, et = (e) => {
+    e && d && t.onCommitResize(t.widgetId, r), i.stopInteraction(), x(null), b = void 0;
+  }, it = (e) => {
     if (e.button !== 0 || t.locked) return;
-    e.preventDefault(), e.stopPropagation(), u?.stop({
+    e.preventDefault(), e.stopPropagation(), b?.stop({
       reason: "manual_stop",
       commit: !1
     }), t.onStartOptimisticFront(t.widgetId);
-    const i = A({
-      kind: "drag",
-      cursor: "nwse-resize"
-    }), r = Math.max(t.viewportScale, 1e-3);
+    const i = z("resize", "nwse-resize"), r = Math.max(t.viewportScale, 1e-3);
     x({
       pointerId: e.pointerId,
       startClientX: e.clientX,
@@ -186,41 +195,49 @@ function Ct(t) {
       stopInteraction: i
     });
     const d = (a) => {
-      x((o) => {
-        if (!o || o.pointerId !== a.pointerId) return o;
-        const w = Math.max(mt, o.startWidth + (a.clientX - o.startClientX) / o.scale), s = Math.max(vt, o.startHeight + (a.clientY - o.startClientY) / o.scale);
+      x((n) => {
+        if (!n || n.pointerId !== a.pointerId) return n;
+        const h = Math.max($t, n.startWidth + (a.clientX - n.startClientX) / n.scale), w = Math.max(St, n.startHeight + (a.clientY - n.startClientY) / n.scale);
         return {
-          ...o,
-          width: w,
-          height: s
+          ...n,
+          width: h,
+          height: w
         };
       });
     };
-    u = j({
+    b = N({
       pointerEvent: e,
       captureEl: e.currentTarget,
       onMove: d,
       onEnd: ({
         commit: a
-      }) => tt(a)
+      }) => et(a)
     });
   };
   return (() => {
-    var e = _t(), i = e.firstChild, r = i.firstChild, d = r.firstChild, a = d.nextSibling, o = a.nextSibling, w = r.nextSibling, s = w.nextSibling, y = s.nextSibling, it = y.firstChild, P = it.nextSibling, ot = y.nextSibling, $ = ot.firstChild, k = $.nextSibling, M = k.nextSibling, nt = i.nextSibling, Y = g;
-    return typeof Y == "function" ? dt(Y, e) : g = e, L(e, at({
+    var e = mt(), i = e.firstChild, r = i.firstChild, d = r.firstChild, a = d.nextSibling, n = a.nextSibling, h = r.nextSibling, w = h.nextSibling, M = w.nextSibling, nt = M.firstChild, L = nt.nextSibling, ot = M.nextSibling, k = ot.firstChild, I = k.nextSibling, C = I.nextSibling, at = i.nextSibling, H = g;
+    return typeof H == "function" ? lt(H, e) : g = e, F(e, rt({
       get classList() {
         return {
           "is-selected": t.selected,
-          "is-dragging": W(),
-          "is-resizing": R(),
+          "is-dragging": R(),
+          "is-resizing": T(),
           "is-filtered-out": t.filtered,
           "is-projected-surface": t.layoutMode === "projected_surface",
           "is-locked": t.locked
         };
-      },
+      }
+    }, () => ({
+      [s().dialogSurfaceHostAttr]: "true"
+    }), {
       get "data-floe-workbench-widget-id"() {
         return t.widgetId;
-      },
+      }
+    }, () => ({
+      [s().widgetRootAttr]: "true"
+    }), () => ({
+      [s().widgetIdAttr]: t.widgetId
+    }), {
       get "data-workbench-widget-type"() {
         return t.widgetType;
       },
@@ -228,49 +245,49 @@ function Ct(t) {
         return t.layoutMode ?? "canvas_scaled";
       }
     }, () => ({
-      [wt]: t.selected ? "true" : void 0
+      [ht]: t.selected ? "true" : void 0
     }), {
       tabIndex: 0,
-      onPointerDown: K,
+      onPointerDown: J,
       onFocus: () => {
         t.onSelect(t.widgetId);
       },
-      onContextMenu: (n) => {
-        p(n.target) === "widget_shell" && (n.preventDefault(), n.stopPropagation(), t.onContextMenu(n, t.itemSnapshot()));
+      onContextMenu: (o) => {
+        X(o.target) === "widget_shell" && (o.preventDefault(), o.stopPropagation(), t.onContextMenu(o, t.itemSnapshot()));
       },
       get style() {
-        return J();
+        return U();
       }
-    }), !1, !0), i.$$pointerdown = X, L(i, {
-      [gt]: "true"
-    }, !1, !0), d.$$click = D, d.$$pointerdown = (n) => n.stopPropagation(), l(d, c(O, {
+    }), !1, !0), i.$$pointerdown = E, F(i, {
+      [ut]: "true"
+    }, !1, !0), d.$$click = A, d.$$pointerdown = (o) => o.stopPropagation(), l(d, c(j, {
       class: "workbench-widget__traffic-icon",
       "aria-hidden": "true"
-    })), a.$$click = T, a.$$pointerdown = (n) => n.stopPropagation(), l(a, c(F, {
+    })), a.$$click = D, a.$$pointerdown = (o) => o.stopPropagation(), l(a, c(O, {
       class: "workbench-widget__traffic-icon",
       "aria-hidden": "true"
-    })), o.$$click = z, o.$$pointerdown = (n) => n.stopPropagation(), l(o, c(N, {
+    })), n.$$click = P, n.$$pointerdown = (o) => o.stopPropagation(), l(n, c(q, {
       class: "workbench-widget__traffic-icon",
       "aria-hidden": "true"
-    })), l(w, U), s.$$pointerdown = X, l(s, c(st, {
+    })), l(h, Q), w.$$pointerdown = E, l(w, c(gt, {
       class: "w-3.5 h-3.5"
-    })), l(y, () => {
-      const n = t.definition.icon;
-      return c(n, {
+    })), l(M, () => {
+      const o = t.definition.icon;
+      return c(o, {
         class: "w-3.5 h-3.5"
       });
-    }, P), l(P, () => t.widgetTitle), $.$$click = T, $.$$pointerdown = (n) => n.stopPropagation(), l($, c(F, {
+    }, L), l(L, () => t.widgetTitle), k.$$click = D, k.$$pointerdown = (o) => o.stopPropagation(), l(k, c(O, {
       class: "workbench-widget__window-control-icon",
       "aria-hidden": "true"
-    })), k.$$click = z, k.$$pointerdown = (n) => n.stopPropagation(), l(k, c(N, {
+    })), I.$$click = P, I.$$pointerdown = (o) => o.stopPropagation(), l(I, c(q, {
       class: "workbench-widget__window-control-icon",
       "aria-hidden": "true"
-    })), M.$$click = D, M.$$pointerdown = (n) => n.stopPropagation(), l(M, c(O, {
+    })), C.$$click = A, C.$$pointerdown = (o) => o.stopPropagation(), l(C, c(j, {
       class: "workbench-widget__window-control-icon",
       "aria-hidden": "true"
-    })), l(nt, () => {
-      const n = t.definition.body;
-      return c(n, {
+    })), l(at, () => {
+      const o = t.definition.body;
+      return c(o, {
         get widgetId() {
           return t.widgetId;
         },
@@ -281,22 +298,32 @@ function Ct(t) {
           return t.widgetType;
         },
         get surfaceMetrics() {
-          return E();
+          return Y();
         },
         get activation() {
+          return V();
+        },
+        get lifecycle() {
           return G();
-        }
+        },
+        get selected() {
+          return t.selected;
+        },
+        get filtered() {
+          return t.filtered;
+        },
+        requestActivate: K
       });
     }), l(e, (() => {
-      var n = rt(() => !!t.locked);
-      return () => n() ? null : (() => {
-        var H = bt();
-        return H.$$pointerdown = et, H;
+      var o = dt(() => !!t.locked);
+      return () => o() ? null : (() => {
+        var p = vt();
+        return p.$$pointerdown = it, p;
       })();
     })(), null), e;
   })();
 }
-lt(["pointerdown", "click"]);
+ct(["pointerdown", "click"]);
 export {
-  Ct as WorkbenchWidget
+  Rt as WorkbenchWidget
 };

package/dist/components/workbench/types.d.ts

@@ -1,9 +1,68 @@
 import type { Component } from 'solid-js';
 import type { WorkbenchThemeId } from './workbenchThemes';
+import type { SurfaceInteractionTargetRole, SurfaceWheelLocalReason, WorkbenchWidgetEventOwnership } from '../ui/localInteractionSurface';
 export type BuiltinWorkbenchWidgetType = 'terminal' | 'file-browser' | 'system-monitor' | 'log-viewer' | 'code-editor';
 export type WorkbenchWidgetType = BuiltinWorkbenchWidgetType | (string & {});
 export declare const WORKBENCH_WIDGET_TYPES: readonly WorkbenchWidgetType[];
 export type WorkbenchWidgetRenderMode = 'canvas_scaled' | 'projected_surface';
+export type WorkbenchCanvasOwnerReason = 'initial' | 'background_pointer' | 'background_focus' | (string & {});
+export type WorkbenchWidgetOwnerReason = 'pointer' | 'focus' | 'activation' | (string & {});
+export type WorkbenchInputOwner = {
+    kind: 'canvas';
+    reason: WorkbenchCanvasOwnerReason;
+} | {
+    kind: 'widget';
+    widgetId: string;
+    reason: WorkbenchWidgetOwnerReason;
+};
+export type WorkbenchWheelLocalReason = SurfaceWheelLocalReason | 'selected_widget' | (string & {});
+export type WorkbenchWheelRoutingDecision = {
+    kind: 'canvas_zoom';
+} | {
+    kind: 'local_surface';
+    reason: WorkbenchWheelLocalReason;
+} | {
+    kind: 'ignore';
+    reason: 'pan_zoom_disabled' | (string & {});
+};
+export interface WorkbenchInteractionAdapter {
+    surfaceRootAttr?: string;
+    widgetRootAttr?: string;
+    widgetIdAttr?: string;
+    dialogSurfaceHostAttr?: string;
+    interactiveSelector?: string;
+    panSurfaceSelector?: string;
+    wheelInteractiveSelector?: string;
+    createInitialInputOwner?: () => WorkbenchInputOwner;
+    createCanvasInputOwner?: (reason: WorkbenchCanvasOwnerReason) => WorkbenchInputOwner;
+    createWidgetInputOwner?: (widgetId: string, reason: WorkbenchWidgetOwnerReason) => WorkbenchInputOwner;
+    findWidgetRoot?: (target: EventTarget | null) => HTMLElement | null;
+    readWidgetId?: (element: Element | null) => string | null;
+    focusWidgetElement?: (root: ParentNode | null | undefined, widgetId: string) => boolean;
+    resolveSurfaceTargetRole?: (args: {
+        target: EventTarget | null;
+        interactiveSelector: string;
+        panSurfaceSelector: string;
+    }) => SurfaceInteractionTargetRole;
+    resolveWidgetEventOwnership?: (args: {
+        target: EventTarget | null;
+        widgetRoot: Element | EventTarget | null;
+        interactiveSelector: string;
+        panSurfaceSelector: string;
+    }) => WorkbenchWidgetEventOwnership;
+    resolveWheelRouting?: (args: {
+        target: EventTarget | null;
+        disablePanZoom: boolean;
+        selectedWidgetId: string | null;
+        wheelInteractiveSelector: string;
+    }) => WorkbenchWheelRoutingDecision;
+    shouldBypassGlobalHotkeys?: (args: {
+        root: HTMLElement | null | undefined;
+        target: EventTarget | null;
+        owner: WorkbenchInputOwner;
+        interactiveSelector: string;
+    }) => boolean;
+}
 export interface WorkbenchProjectedRect {
     widgetId: string;
     worldX: number;
@@ -26,12 +85,17 @@ export interface WorkbenchWidgetBodyActivation {
     source: WorkbenchWidgetBodyActivationSource;
     pointerType?: string;
 }
+export type WorkbenchWidgetLifecycle = 'hot' | 'warm' | 'cold';
 export interface WorkbenchWidgetBodyProps<TWidgetType extends string = WorkbenchWidgetType> {
     widgetId: string;
     title: string;
     type: TWidgetType;
     surfaceMetrics?: WorkbenchWidgetSurfaceMetrics;
     activation?: WorkbenchWidgetBodyActivation;
+    lifecycle?: WorkbenchWidgetLifecycle;
+    selected?: boolean;
+    filtered?: boolean;
+    requestActivate?: () => void;
 }
 export interface WorkbenchWidgetDefinition<TWidgetType extends string = WorkbenchWidgetType> {
     type: TWidgetType;

package/dist/components/workbench/workbenchInteractionAdapter.d.ts

@@ -0,0 +1,39 @@
+import type { WorkbenchCanvasOwnerReason, WorkbenchInputOwner, WorkbenchInteractionAdapter, WorkbenchWidgetOwnerReason } from './types';
+export declare const DEFAULT_WORKBENCH_SURFACE_ROOT_ATTR = "data-floe-workbench-surface-root";
+export declare const DEFAULT_WORKBENCH_WIDGET_ROOT_ATTR = "data-floe-workbench-widget-root";
+export declare const DEFAULT_WORKBENCH_WIDGET_ID_ATTR = "data-floe-workbench-widget-id";
+export declare const DEFAULT_WORKBENCH_DIALOG_SURFACE_HOST_ATTR = "data-floe-dialog-surface-host";
+export interface ResolvedWorkbenchInteractionAdapter extends WorkbenchInteractionAdapter {
+    surfaceRootAttr: string;
+    widgetRootAttr: string;
+    widgetIdAttr: string;
+    dialogSurfaceHostAttr: string;
+    interactiveSelector: string;
+    panSurfaceSelector: string;
+    wheelInteractiveSelector: string;
+    createInitialInputOwner: () => WorkbenchInputOwner;
+    createCanvasInputOwner: (reason: WorkbenchCanvasOwnerReason) => WorkbenchInputOwner;
+    createWidgetInputOwner: (widgetId: string, reason: WorkbenchWidgetOwnerReason) => WorkbenchInputOwner;
+    findWidgetRoot: (target: EventTarget | null) => HTMLElement | null;
+    readWidgetId: (element: Element | null) => string | null;
+    focusWidgetElement: (root: ParentNode | null | undefined, widgetId: string) => boolean;
+    resolveSurfaceTargetRole: NonNullable<WorkbenchInteractionAdapter['resolveSurfaceTargetRole']>;
+    resolveWidgetEventOwnership: NonNullable<WorkbenchInteractionAdapter['resolveWidgetEventOwnership']>;
+    resolveWheelRouting: NonNullable<WorkbenchInteractionAdapter['resolveWheelRouting']>;
+    shouldBypassGlobalHotkeys: NonNullable<WorkbenchInteractionAdapter['shouldBypassGlobalHotkeys']>;
+}
+export declare function readWorkbenchWidgetId(element: Element | null, widgetIdAttr?: string): string | null;
+export declare function findWorkbenchWidgetRoot(target: EventTarget | null, widgetRootAttr?: string): HTMLElement | null;
+export declare function findWorkbenchWidgetElement(args: {
+    root: ParentNode | null | undefined;
+    widgetId: string;
+    widgetRootAttr?: string;
+    readWidgetId?: (element: Element | null) => string | null;
+}): HTMLElement | null;
+export declare function focusWorkbenchWidgetElement(args: {
+    root: ParentNode | null | undefined;
+    widgetId: string;
+    widgetRootAttr?: string;
+    readWidgetId?: (element: Element | null) => string | null;
+}): boolean;
+export declare function resolveWorkbenchInteractionAdapter(adapter?: WorkbenchInteractionAdapter): ResolvedWorkbenchInteractionAdapter;