@octaviaflow/core 3.1.0-beta.95 → 3.1.0-beta.96

package/dist/workflow/components/PresenceCursors/PresenceCursors.d.ts

@@ -0,0 +1,33 @@
+import type { Position, Viewport } from "../../editor";
+export interface PresenceCursorMember {
+    /** Stable identity. Used as the React key. */
+    userId: string;
+    /** Shown on the pointer's label. */
+    name: string;
+    /** This person's identity colour — the same one on their avatar. */
+    colour: string;
+    /** Where they are, in FLOW space. Omit and they are simply not drawn. */
+    cursor?: Position;
+}
+export interface PresenceCursorsProps {
+    /** The other people. The local user should already be filtered out. */
+    members: PresenceCursorMember[];
+    /**
+     * Called with the local pointer's position in FLOW space, at most once per
+     * animation frame, and with `null` when the pointer leaves the canvas.
+     *
+     * Coalescing beyond a frame (down to the ~10Hz that actually goes on the
+     * wire) is the host's job — it owns the transport.
+     */
+    onCursorMove?: (position: Position | null) => void;
+    /**
+     * Override the viewport instead of subscribing to the enclosing canvas.
+     * Only needed outside a `<FlowCanvas>` — a story, a static preview.
+     */
+    viewport?: Viewport;
+    /** Hide labels and draw pointers only. */
+    showLabels?: boolean;
+    className?: string;
+}
+export declare function PresenceCursors({ members, onCursorMove, viewport, showLabels, className, }: Readonly<PresenceCursorsProps>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PresenceCursors.d.ts.map

package/dist/workflow/components/PresenceCursors/PresenceCursors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceCursors.d.ts","sourceRoot":"","sources":["../../../../src/workflow/components/PresenceCursors/PresenceCursors.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAIvD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,UAAiB,EACjB,SAAS,GACV,EAAE,QAAQ,CAAC,oBAAoB,CAAC,2CAmKhC"}

package/dist/workflow/index.d.ts

@@ -21,6 +21,7 @@ export { Handle, type HandleProps } from "./components/Handle/Handle";
 export { ActionNode, type BuiltInNodeData, ConditionNode, DEFAULT_NODE_KINDS, ErrorNode, ForEachNode, GroupNode, HttpRequestNode, OutputNode, ParallelNode, StickyNode, TriggerNode, WaitNode, WebhookNode, } from "./components/kinds";
 export { NodeResizer, type NodeResizerProps } from "./components/NodeResizer/NodeResizer";
 export { NodeToolbar, type NodeToolbarProps } from "./components/NodeToolbar/NodeToolbar";
+export { PresenceCursors, type PresenceCursorMember, type PresenceCursorsProps, } from "./components/PresenceCursors/PresenceCursors";
 export type { EdgeRouting } from "./editor";
 export { collapseFor, toggleGroupCollapse } from "./utils/collapse";
 export { bezierPath, DEFAULT_NODE_HEIGHT, DEFAULT_NODE_WIDTH, flowToScreen, handleCentre, screenToFlow, } from "./utils/geometry";

package/dist/workflow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"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"}

package/dist/workflow.cjs

@@ -53,6 +53,7 @@ __export(workflow_exports, {
   NodeToolbar: () => NodeToolbar,
   OutputNode: () => OutputNode,
   ParallelNode: () => ParallelNode,
+  PresenceCursors: () => PresenceCursors,
   StickyNode: () => StickyNode,
   TriggerNode: () => TriggerNode,
   WaitNode: () => WaitNode,
@@ -10835,6 +10836,120 @@ function transformOriginFor(side, align) {
   return align === "start" ? "left top" : align === "end" ? "left bottom" : "left center";
 }
 
+// src/workflow/components/PresenceCursors/PresenceCursors.tsx
+var import_react53 = require("react");
+var import_jsx_runtime33 = require("react/jsx-runtime");
+var IDENTITY_VIEWPORT = { x: 0, y: 0, zoom: 1 };
+function PresenceCursors({
+  members,
+  onCursorMove,
+  viewport,
+  showLabels = true,
+  className
+}) {
+  const layerRef = (0, import_react53.useRef)(null);
+  const liveViewport = useViewportOrNull();
+  const vp = viewport ?? liveViewport ?? IDENTITY_VIEWPORT;
+  const vpRef = (0, import_react53.useRef)(vp);
+  const reportRef = (0, import_react53.useRef)(onCursorMove);
+  (0, import_react53.useEffect)(() => {
+    vpRef.current = vp;
+    reportRef.current = onCursorMove;
+  });
+  const isReporting = Boolean(onCursorMove);
+  (0, import_react53.useEffect)(() => {
+    const layer = layerRef.current;
+    if (!layer || !isReporting) return;
+    let frameId = 0;
+    let scheduled = false;
+    let disposed = false;
+    let pendingClient = null;
+    const flush = () => {
+      scheduled = false;
+      if (disposed) return;
+      if (!pendingClient) {
+        reportRef.current?.(null);
+        return;
+      }
+      const rect = layer.getBoundingClientRect();
+      const inside = pendingClient.x >= rect.left && pendingClient.x <= rect.right && pendingClient.y >= rect.top && pendingClient.y <= rect.bottom;
+      reportRef.current?.(
+        inside ? screenToFlow(
+          { x: pendingClient.x - rect.left, y: pendingClient.y - rect.top },
+          vpRef.current
+        ) : null
+      );
+    };
+    const schedule = () => {
+      if (scheduled || disposed) return;
+      scheduled = true;
+      frameId = requestAnimationFrame(flush);
+    };
+    const onMove = (e) => {
+      pendingClient = { x: e.clientX, y: e.clientY };
+      schedule();
+    };
+    const onLeave = () => {
+      pendingClient = null;
+      schedule();
+    };
+    const onVisibility = () => {
+      if (document.visibilityState === "hidden") onLeave();
+    };
+    window.addEventListener("pointermove", onMove, { passive: true });
+    window.addEventListener("pointerleave", onLeave);
+    window.addEventListener("blur", onLeave);
+    document.addEventListener("visibilitychange", onVisibility);
+    return () => {
+      disposed = true;
+      window.removeEventListener("pointermove", onMove);
+      window.removeEventListener("pointerleave", onLeave);
+      window.removeEventListener("blur", onLeave);
+      document.removeEventListener("visibilitychange", onVisibility);
+      if (frameId) cancelAnimationFrame(frameId);
+    };
+  }, [isReporting]);
+  return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("div", { ref: layerRef, className: cn("ods-presence-cursors", className), "aria-hidden": "true", children: members.map((m) => {
+    if (!m.cursor) return null;
+    const p = flowToScreen(m.cursor, vp);
+    return /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)(
+      "div",
+      {
+        className: "ods-presence-cursors__pointer",
+        style: {
+          transform: `translate3d(${p.x}px, ${p.y}px, 0)`,
+          color: m.colour
+        },
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime33.jsx)(
+            "svg",
+            {
+              className: "ods-presence-cursors__arrow",
+              width: "18",
+              height: "18",
+              viewBox: "0 0 18 18",
+              fill: "none",
+              "aria-hidden": "true",
+              children: /* @__PURE__ */ (0, import_jsx_runtime33.jsx)(
+                "path",
+                {
+                  d: "M2 1.5 L2 14 L5.6 10.7 L8 15.8 L10.6 14.6 L8.2 9.6 L13 9.3 Z",
+                  fill: "currentColor",
+                  stroke: "var(--ods-surface-canvas)",
+                  strokeWidth: "1.2",
+                  strokeLinejoin: "round"
+                }
+              )
+            }
+          ),
+          showLabels && /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("span", { className: "ods-presence-cursors__label", children: m.name })
+        ]
+      },
+      m.userId
+    );
+  }) });
+}
+
 // src/workflow/utils/collapse.ts
 function collapseFor(nodes, edges) {
   const collapsedAncestorOf = /* @__PURE__ */ new Map();
@@ -10935,6 +11050,7 @@ function toggleGroupCollapse(groupId, nodes) {
   NodeToolbar,
   OutputNode,
   ParallelNode,
+  PresenceCursors,
   StickyNode,
   TriggerNode,
   WaitNode,