@floegence/floe-webapp-core 0.36.17 → 0.36.19

package/dist/components/workbench/WorkbenchWidget.js

@@ -1,35 +1,62 @@
-import { spread as H, mergeProps as et, insert as l, createComponent as c, memo as it, template as B, use as nt, delegateEvents as ot } from "solid-js/web";
-import { createSignal as L, onCleanup as at, untrack as S, createMemo as _ } from "solid-js";
-import { startHotInteraction as O } from "../../utils/hotInteraction.js";
-import { X as F, Minus as N, Maximize as A, GripVertical as rt } from "../icons/index.js";
-import { CANVAS_WHEEL_INTERACTIVE_ATTR as dt, WORKBENCH_WIDGET_SHELL_ATTR as lt, resolveWorkbenchWidgetEventOwnership as ct } from "../ui/localInteractionSurface.js";
-import { startPointerSession as j } from "../ui/pointerSession.js";
-import { createWorkbenchWidgetSurfaceMetrics as st } from "./workbenchHelpers.js";
-var wt = /* @__PURE__ */ B('<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>'), gt = /* @__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 ht = 220, ut = 160, _t = '[data-floe-canvas-interactive="true"]', ft = '[data-floe-canvas-pan-surface="true"]';
-function xt(t) {
-  const [f, I] = L(null), [b, x] = L(null);
-  let g, h, u;
-  at(() => {
-    g?.stop({
+import { spread as F, mergeProps as nt, insert as l, createComponent as c, memo as at, template as B, use as rt, delegateEvents as dt } from "solid-js/web";
+import { createMemo as u, createSignal as W, onCleanup as lt, untrack as f } from "solid-js";
+import { startHotInteraction as ct } from "../../utils/hotInteraction.js";
+import { X as j, Minus as O, 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 } from "../ui/localInteractionSurface.js";
+import { startPointerSession as q } from "../ui/pointerSession.js";
+import { createWorkbenchWidgetSurfaceMetrics as ut } from "./workbenchHelpers.js";
+import { resolveWorkbenchInteractionAdapter as ft } from "./workbenchInteractionAdapter.js";
+var _t = /* @__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>'), bt = /* @__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 mt = 220, vt = 160;
+function Wt(t) {
+  const s = u(() => ft(t.interactionAdapter)), [m, y] = W(null), [v, x] = W(null), [V, Z] = W();
+  let _, b, h;
+  const p = (e, i) => {
+    const r = ct({
+      kind: e,
+      cursor: i
+    });
+    let d = !1;
+    return f(() => t.onLayoutInteractionStart?.()), () => {
+      d || (d = !0, r(), f(() => t.onLayoutInteractionEnd?.()));
+    };
+  };
+  lt(() => {
+    _?.stop({
       reason: "manual_stop",
       commit: !1
-    }), g = void 0, h?.stop({
+    }), _ = void 0, b?.stop({
       reason: "manual_stop",
       commit: !1
-    }), h = void 0, S(f)?.stopInteraction(), S(b)?.stopInteraction();
+    }), b = void 0, f(m)?.stopInteraction(), f(v)?.stopInteraction();
   });
-  const C = () => f() !== null, W = () => b() !== null, E = (e) => ct({
+  const z = () => m() !== null, R = () => v() !== null, T = (e) => s().resolveWidgetEventOwnership({
     target: e,
-    widgetRoot: u ?? null,
-    interactiveSelector: _t,
-    panSurfaceSelector: ft
-  }), V = (e) => {
-    e.button === 0 && (t.onSelect(t.widgetId), t.onCommitFront(t.widgetId), E(e.target) === "widget_shell" && u?.focus({
-      preventScroll: !0
+    widgetRoot: h ?? null,
+    interactiveSelector: s().interactiveSelector,
+    panSurfaceSelector: s().panSurfaceSelector
+  }), G = (e) => {
+    if (e.button !== 0) return;
+    t.onSelect(t.widgetId), t.onCommitFront(t.widgetId);
+    const i = T(e.target);
+    if (i === "widget_shell") {
+      h?.focus({
+        preventScroll: !0
+      });
+      return;
+    }
+    i === "widget_local" && ht({
+      target: e.target,
+      widgetRoot: h ?? null,
+      interactiveSelector: s().interactiveSelector,
+      panSurfaceSelector: s().panSurfaceSelector
+    }) && Z((r) => ({
+      seq: (r?.seq ?? 0) + 1,
+      source: "local_pointer",
+      pointerType: e.pointerType || void 0
     }));
-  }, m = _(() => {
-    const e = f();
+  }, $ = u(() => {
+    const e = m();
     return e ? {
       x: e.worldX,
       y: e.worldY
@@ -37,8 +64,8 @@ function xt(t) {
       x: t.x,
       y: t.y
     };
-  }), v = _(() => {
-    const e = b();
+  }), S = u(() => {
+    const e = v();
     return e ? {
       width: e.width,
       height: e.height
@@ -46,34 +73,34 @@ function xt(t) {
       width: t.width,
       height: t.height
     };
-  }), R = _(() => {
+  }), X = u(() => {
     if (!(t.layoutMode !== "projected_surface" || !t.projectedViewport))
-      return st({
+      return ut({
         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
       });
-  }), G = _(() => {
+  }), K = 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");
-  }), z = (e) => {
+  }), Y = (e) => {
     e.preventDefault(), e.stopPropagation(), t.onRequestOverview(t.itemSnapshot());
-  }, T = (e) => {
-    e.preventDefault(), e.stopPropagation(), t.onRequestFit(t.itemSnapshot());
   }, D = (e) => {
+    e.preventDefault(), e.stopPropagation(), t.onRequestFit(t.itemSnapshot());
+  }, P = (e) => {
     e.preventDefault(), e.stopPropagation(), t.onRequestDelete(t.widgetId);
-  }, Z = _(() => {
+  }, J = u(() => {
     const e = {
-      width: `${v().width}px`,
-      height: `${v().height}px`,
-      "z-index": C() || W() || t.optimisticFront ? `${t.topRenderLayer + 1}` : `${t.renderLayer}`
+      width: `${S().width}px`,
+      height: `${S().height}px`,
+      "z-index": z() || R() || t.optimisticFront ? `${t.topRenderLayer + 1}` : `${t.renderLayer}`
     };
     if (t.layoutMode === "projected_surface") {
-      const i = R()?.rect;
+      const i = X()?.rect;
       return {
         ...e,
         left: `${i?.screenX ?? 0}px`,
@@ -83,32 +110,29 @@ function xt(t) {
     }
     return {
       ...e,
-      transform: `translate(${m().x}px, ${m().y}px)`
+      transform: `translate(${$().x}px, ${$().y}px)`
     };
-  }), q = (e) => {
-    const i = S(f);
+  }), Q = (e) => {
+    const i = f(m);
     if (!i) return;
-    const d = {
+    const r = {
       x: i.worldX,
       y: i.worldY
-    }, r = {
+    }, d = {
       x: i.startWorldX,
       y: i.startWorldY
-    }, a = e && (Math.abs(d.x - r.x) > 1 || Math.abs(d.y - r.y) > 1);
-    t.onCommitFront(t.widgetId), a && t.onCommitMove(t.widgetId, d), i.stopInteraction(), I(null), g = void 0;
-  }, X = (e) => {
+    }, 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(), y(null), _ = void 0;
+  }, E = (e) => {
     if (e.button !== 0 || t.locked) return;
-    e.preventDefault(), e.stopPropagation(), g?.stop({
+    e.preventDefault(), e.stopPropagation(), _?.stop({
       reason: "manual_stop",
       commit: !1
-    }), t.onSelect(t.widgetId), u?.focus({
+    }), t.onSelect(t.widgetId), h?.focus({
       preventScroll: !0
     }), t.onStartOptimisticFront(t.widgetId);
-    const i = O({
-      kind: "drag",
-      cursor: "grabbing"
-    }), d = Math.max(t.viewportScale, 1e-3);
-    I({
+    const i = p("drag", "grabbing"), r = Math.max(t.viewportScale, 1e-3);
+    y({
       pointerId: e.pointerId,
       startClientX: e.clientX,
       startClientY: e.clientY,
@@ -117,47 +141,44 @@ function xt(t) {
       worldX: t.x,
       worldY: t.y,
       moved: !1,
-      scale: d,
+      scale: r,
       stopInteraction: i
     });
-    const r = (a) => {
-      I((n) => {
-        if (!n || n.pointerId !== a.pointerId) return n;
-        const w = n.startWorldX + (a.clientX - n.startClientX) / n.scale, s = n.startWorldY + (a.clientY - n.startClientY) / n.scale;
+    const d = (a) => {
+      y((o) => {
+        if (!o || o.pointerId !== a.pointerId) return o;
+        const g = o.startWorldX + (a.clientX - o.startClientX) / o.scale, w = o.startWorldY + (a.clientY - o.startClientY) / o.scale;
         return {
-          ...n,
-          worldX: w,
-          worldY: s,
-          moved: n.moved || Math.abs(w - n.startWorldX) > 2 || Math.abs(s - n.startWorldY) > 2
+          ...o,
+          worldX: g,
+          worldY: w,
+          moved: o.moved || Math.abs(g - o.startWorldX) > 2 || Math.abs(w - o.startWorldY) > 2
         };
       });
     };
-    g = j({
+    _ = q({
       pointerEvent: e,
       captureEl: e.currentTarget,
-      onMove: r,
+      onMove: d,
       onEnd: ({
         commit: a
-      }) => q(a)
+      }) => Q(a)
     });
-  }, K = (e) => {
-    const i = S(b);
+  }, U = (e) => {
+    const i = f(v);
     if (!i) return;
-    const d = {
+    const r = {
       width: i.width,
       height: i.height
-    }, r = Math.abs(i.width - i.startWidth) > 1 || Math.abs(i.height - i.startHeight) > 1;
-    e && r && t.onCommitResize(t.widgetId, d), i.stopInteraction(), x(null), h = void 0;
-  }, U = (e) => {
+    }, 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), b = void 0;
+  }, tt = (e) => {
     if (e.button !== 0 || t.locked) return;
-    e.preventDefault(), e.stopPropagation(), h?.stop({
+    e.preventDefault(), e.stopPropagation(), b?.stop({
       reason: "manual_stop",
       commit: !1
     }), t.onStartOptimisticFront(t.widgetId);
-    const i = O({
-      kind: "drag",
-      cursor: "nwse-resize"
-    }), d = Math.max(t.viewportScale, 1e-3);
+    const i = p("resize", "nwse-resize"), r = Math.max(t.viewportScale, 1e-3);
     x({
       pointerId: e.pointerId,
       startClientX: e.clientX,
@@ -166,45 +187,53 @@ function xt(t) {
       startHeight: t.height,
       width: t.width,
       height: t.height,
-      scale: d,
+      scale: r,
       stopInteraction: i
     });
-    const r = (a) => {
-      x((n) => {
-        if (!n || n.pointerId !== a.pointerId) return n;
-        const w = Math.max(ht, n.startWidth + (a.clientX - n.startClientX) / n.scale), s = Math.max(ut, n.startHeight + (a.clientY - n.startClientY) / n.scale);
+    const d = (a) => {
+      x((o) => {
+        if (!o || o.pointerId !== a.pointerId) return o;
+        const g = Math.max(mt, o.startWidth + (a.clientX - o.startClientX) / o.scale), w = Math.max(vt, o.startHeight + (a.clientY - o.startClientY) / o.scale);
         return {
-          ...n,
-          width: w,
-          height: s
+          ...o,
+          width: g,
+          height: w
         };
       });
     };
-    h = j({
+    b = q({
       pointerEvent: e,
       captureEl: e.currentTarget,
-      onMove: r,
+      onMove: d,
       onEnd: ({
         commit: a
-      }) => K(a)
+      }) => U(a)
     });
   };
   return (() => {
-    var e = wt(), i = e.firstChild, d = i.firstChild, r = d.firstChild, a = r.nextSibling, n = a.nextSibling, w = d.nextSibling, s = w.nextSibling, M = s.nextSibling, J = M.firstChild, p = J.nextSibling, Q = M.nextSibling, $ = Q.firstChild, k = $.nextSibling, y = k.nextSibling, tt = i.nextSibling, P = u;
-    return typeof P == "function" ? nt(P, e) : u = e, H(e, et({
+    var e = _t(), i = e.firstChild, r = i.firstChild, d = r.firstChild, a = d.nextSibling, o = a.nextSibling, g = r.nextSibling, w = g.nextSibling, M = w.nextSibling, et = M.firstChild, A = et.nextSibling, it = M.nextSibling, k = it.firstChild, I = k.nextSibling, C = I.nextSibling, ot = i.nextSibling, L = h;
+    return typeof L == "function" ? rt(L, e) : h = e, F(e, nt({
       get classList() {
         return {
           "is-selected": t.selected,
-          "is-dragging": C(),
-          "is-resizing": W(),
+          "is-dragging": z(),
+          "is-resizing": R(),
           "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;
       },
@@ -212,49 +241,49 @@ function xt(t) {
         return t.layoutMode ?? "canvas_scaled";
       }
     }, () => ({
-      [dt]: t.selected ? "true" : void 0
+      [wt]: t.selected ? "true" : void 0
     }), {
       tabIndex: 0,
-      onPointerDown: V,
+      onPointerDown: G,
       onFocus: () => {
         t.onSelect(t.widgetId);
       },
-      onContextMenu: (o) => {
-        E(o.target) === "widget_shell" && (o.preventDefault(), o.stopPropagation(), t.onContextMenu(o, t.itemSnapshot()));
+      onContextMenu: (n) => {
+        T(n.target) === "widget_shell" && (n.preventDefault(), n.stopPropagation(), t.onContextMenu(n, t.itemSnapshot()));
       },
       get style() {
-        return Z();
+        return J();
       }
-    }), !1, !0), i.$$pointerdown = X, H(i, {
-      [lt]: "true"
-    }, !1, !0), r.$$click = D, r.$$pointerdown = (o) => o.stopPropagation(), l(r, c(F, {
+    }), !1, !0), i.$$pointerdown = E, F(i, {
+      [gt]: "true"
+    }, !1, !0), d.$$click = P, d.$$pointerdown = (n) => n.stopPropagation(), l(d, c(j, {
       class: "workbench-widget__traffic-icon",
       "aria-hidden": "true"
-    })), a.$$click = z, a.$$pointerdown = (o) => o.stopPropagation(), l(a, c(N, {
+    })), a.$$click = Y, a.$$pointerdown = (n) => n.stopPropagation(), l(a, c(O, {
       class: "workbench-widget__traffic-icon",
       "aria-hidden": "true"
-    })), n.$$click = T, n.$$pointerdown = (o) => o.stopPropagation(), l(n, c(A, {
+    })), o.$$click = D, o.$$pointerdown = (n) => n.stopPropagation(), l(o, c(N, {
       class: "workbench-widget__traffic-icon",
       "aria-hidden": "true"
-    })), l(w, G), s.$$pointerdown = X, l(s, c(rt, {
+    })), l(g, K), w.$$pointerdown = E, l(w, c(st, {
       class: "w-3.5 h-3.5"
     })), l(M, () => {
-      const o = t.definition.icon;
-      return c(o, {
+      const n = t.definition.icon;
+      return c(n, {
         class: "w-3.5 h-3.5"
       });
-    }, p), l(p, () => t.widgetTitle), $.$$click = z, $.$$pointerdown = (o) => o.stopPropagation(), l($, c(N, {
+    }, A), l(A, () => t.widgetTitle), k.$$click = Y, k.$$pointerdown = (n) => n.stopPropagation(), l(k, c(O, {
       class: "workbench-widget__window-control-icon",
       "aria-hidden": "true"
-    })), k.$$click = T, k.$$pointerdown = (o) => o.stopPropagation(), l(k, c(A, {
+    })), I.$$click = D, I.$$pointerdown = (n) => n.stopPropagation(), l(I, c(N, {
       class: "workbench-widget__window-control-icon",
       "aria-hidden": "true"
-    })), y.$$click = D, y.$$pointerdown = (o) => o.stopPropagation(), l(y, c(F, {
+    })), C.$$click = P, C.$$pointerdown = (n) => n.stopPropagation(), l(C, c(j, {
       class: "workbench-widget__window-control-icon",
       "aria-hidden": "true"
-    })), l(tt, () => {
-      const o = t.definition.body;
-      return c(o, {
+    })), l(ot, () => {
+      const n = t.definition.body;
+      return c(n, {
         get widgetId() {
           return t.widgetId;
         },
@@ -265,19 +294,22 @@ function xt(t) {
           return t.widgetType;
         },
         get surfaceMetrics() {
-          return R();
+          return X();
+        },
+        get activation() {
+          return V();
         }
       });
     }), l(e, (() => {
-      var o = it(() => !!t.locked);
-      return () => o() ? null : (() => {
-        var Y = gt();
-        return Y.$$pointerdown = U, Y;
+      var n = at(() => !!t.locked);
+      return () => n() ? null : (() => {
+        var H = bt();
+        return H.$$pointerdown = tt, H;
       })();
     })(), null), e;
   })();
 }
-ot(["pointerdown", "click"]);
+dt(["pointerdown", "click"]);
 export {
-  xt as WorkbenchWidget
+  Wt 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;
@@ -20,11 +79,18 @@ export interface WorkbenchWidgetSurfaceMetrics {
     ready: boolean;
     rect: WorkbenchProjectedRect;
 }
+export type WorkbenchWidgetBodyActivationSource = 'local_pointer';
+export interface WorkbenchWidgetBodyActivation {
+    seq: number;
+    source: WorkbenchWidgetBodyActivationSource;
+    pointerType?: string;
+}
 export interface WorkbenchWidgetBodyProps<TWidgetType extends string = WorkbenchWidgetType> {
     widgetId: string;
     title: string;
     type: TWidgetType;
     surfaceMetrics?: WorkbenchWidgetSurfaceMetrics;
+    activation?: WorkbenchWidgetBodyActivation;
 }
 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;