@pixerate/editor 0.140.4 → 0.142.1

package/dist/agent/index.js

@@ -7,12 +7,18 @@ import {
   hasVariantCommands
 } from "../chunk-3TNA7JKI.js";
 import {
+  createNodeLookup,
   ensureLayout,
   getLayoutedNodes,
+  getNodeRect,
   placeBeside
-} from "../chunk-BTZS3KZY.js";
+} from "../chunk-DW4CV5H4.js";
 import "../chunk-7KZ2HKKC.js";
-import "../chunk-K73HMKQP.js";
+import {
+  runToolScript,
+  toolResultError,
+  toolResultValue
+} from "../chunk-Y6SGC6KO.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -38,7 +44,16 @@ import {
   toolsetInstructions,
   toolsetName,
   unknownToolMessage
-} from "../chunk-RB62U6MS.js";
+} from "../chunk-RFBFTLVN.js";
+import {
+  AgentPlayback,
+  createAgentPlayback,
+  derivePlaybackSteps,
+  playbackRefsFromArgs,
+  playbackRefsFromResult,
+  readingTime,
+  unionRects
+} from "../chunk-54GVEVXS.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
@@ -119,15 +134,24 @@ import {
 import {
   isSingleCellRange,
   normalizeRange,
+  planSpreadsheetToolPlayback,
   rangeContainsRange,
   rangesIntersect
-} from "../chunk-E747F3D5.js";
+} from "../chunk-CC6WKVIH.js";
 import {
   colNameToIndex,
   indexToColName,
   isFormulaError
 } from "../chunk-II2WIF5Z.js";
 import "../chunk-WJSD3MAZ.js";
+import {
+  PRESENCE_COLORS,
+  PerformanceQueue,
+  PresenceStore,
+  createInstantPresenceClock,
+  realPresenceClock,
+  tweenPresenceCursor
+} from "../chunk-PEEP2YR7.js";
 import {
   validateJsonSchema
 } from "../chunk-V2ZCJRDM.js";
@@ -459,6 +483,87 @@ function planToolCall(name, args, snapshot, options) {
 import { TextSelection as TextSelection2 } from "@tiptap/pm/state";
 import { closeHistory as closeHistory3 } from "@tiptap/pm/history";
 
+// src/agent/canvasPlayback.ts
+var centre = (r) => ({ x: r.x + r.width / 2, y: r.y + r.height / 2 });
+var labelOf = (data) => {
+  const label = data?.label ?? data?.title ?? data?.text;
+  return typeof label === "string" && label.trim() ? label : null;
+};
+function planCanvasPlaybackSteps(steps, nodes, rectOptions) {
+  const placed = new Map(createNodeLookup(nodes));
+  const rectOf = (id) => {
+    const node = placed.get(id);
+    return node ? getNodeRect(node, placed, rectOptions) : null;
+  };
+  const before = [];
+  const after = [];
+  const click = (rect) => rect ? [{ type: "move", to: centre(rect) }, { type: "focus", rect }, { type: "press" }, { type: "release" }] : [];
+  for (const step of steps) {
+    switch (step.type) {
+      case "step:canvas_add_node": {
+        placed.set(step.node.id, step.node);
+        const rect = rectOf(step.node.id);
+        const label = labelOf(step.node.data);
+        before.push(...click(rect), ...label ? [{ type: "type", text: label }] : []);
+        break;
+      }
+      case "step:canvas_add_edge": {
+        const a = rectOf(step.edge.source);
+        const b = rectOf(step.edge.target);
+        if (!a || !b) break;
+        const label = typeof step.edge.label === "string" ? step.edge.label : labelOf(step.edge.data);
+        before.push(
+          { type: "move", to: { x: a.x + a.width, y: a.y + a.height / 2 } },
+          { type: "press" },
+          { type: "drag", to: { x: b.x, y: b.y + b.height / 2 } },
+          { type: "release" },
+          ...label ? [{ type: "type", text: label }] : []
+        );
+        break;
+      }
+      case "step:canvas_update_node": {
+        const rect = rectOf(step.id);
+        const label = labelOf(step.data);
+        before.push(...click(rect), ...rect && label ? [{ type: "type", text: label }] : []);
+        break;
+      }
+      case "step:canvas_remove_nodes":
+        for (const id of step.nodeIds.slice(0, 8)) before.push(...click(rectOf(id)));
+        break;
+      case "step:canvas_select":
+        for (const id of step.nodeIds.slice(0, 8)) before.push(...click(rectOf(id)));
+        break;
+      case "step:canvas_highlight":
+        for (const id of step.nodeIds.slice(0, 8)) {
+          const rect = rectOf(id);
+          if (rect) before.push({ type: "move", to: centre(rect) }, { type: "focus", rect });
+        }
+        break;
+      case "step:canvas_move_nodes": {
+        const moved = Object.entries(step.positions);
+        for (const [id, position] of moved) {
+          const node = placed.get(id);
+          if (node) placed.set(id, { ...node, position });
+        }
+        const rect = unionRects(moved.map(([id]) => rectOf(id)));
+        if (rect) after.push({ type: "move", to: centre(rect) }, { type: "focus", rect }, { type: "wait", ms: 450 });
+        break;
+      }
+      default:
+        break;
+    }
+  }
+  if (!before.length && !after.length) return [];
+  return [...before, { type: "commit" }, ...after];
+}
+function planCanvasToolPlayback(name, args, snapshot, plannerOptions, rectOptions) {
+  const command = toolCallToAgentCommand(name, args);
+  if (!command || !command.type.startsWith("canvas:") || validateAgentCommand(command, snapshot)) return null;
+  const steps = planAgentCommand(command, snapshot, plannerOptions);
+  const planned = planCanvasPlaybackSteps(steps, snapshot.canvas?.nodes ?? [], rectOptions);
+  return planned.length ? planned : null;
+}
+
 // src/agent/documentChartTools.ts
 import { closeHistory } from "@tiptap/pm/history";
 var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
@@ -1065,6 +1170,13 @@ function findMatches(editor, query, args, replacement) {
 function createRichTextToolProvider(target, options) {
   const editor = () => toEditor(target);
   const charts = createDocumentChartTools(editor);
+  const withCaret = (tool) => tool.name !== "insert_chart" ? tool : {
+    ...tool,
+    handler: (args, context) => {
+      if (typeof args.at === "number") presence.show(args.at);
+      return tool.handler(args, context);
+    }
+  };
   const presence = createTextPresence(editor, options.id, options.presence);
   const formatting = createDocumentFormatTools(editor, (ranges) => presence.changed(ranges.filter((r) => r.from < r.to)));
   const getText = {
@@ -1366,7 +1478,7 @@ function createRichTextToolProvider(target, options) {
       if (!ed || ed.isDestroyed) return [];
       if (!ed.isEditable) return [getText, findText, ...charts.read()];
       const tools = [getText, findText, insertText, replaceText, replaceRange, replaceSelection, setSelection, ...formatting.tools(ed)];
-      return [...tools, ...isTableEnabled(ed) ? [editTable] : [], ...charts.read(), ...charts.write()];
+      return [...tools, ...isTableEnabled(ed) ? [editTable] : [], ...charts.read(), ...charts.write().map(withCaret)];
     },
     subscribe: (notify) => {
       const ed = editor();
@@ -1716,7 +1828,11 @@ function createSpreadsheetToolProvider(controller, options) {
     title: "Spreadsheet",
     description: "A spreadsheet: read and set cells and ranges, insert and delete rows and columns, merge and transpose.",
     skill: "pixerate-spreadsheet",
-    tools: [getRange, setCell, setRange, insertRows, deleteRows, insertColumns, deleteColumns, mergeCells, unmergeCells, transposeRange]
+    // Agent playback: `<SpreadsheetEditor playback>` attaches as `spreadsheet` and finds the cells.
+    playbackSurface: options.playbackSurface ?? "spreadsheet",
+    tools: [getRange, setCell, setRange, insertRows, deleteRows, insertColumns, deleteColumns, mergeCells, unmergeCells, transposeRange].map(
+      (tool) => ({ ...tool, plan: (args) => planSpreadsheetToolPlayback(tool.name, args) })
+    )
   };
 }
 function missingArgumentsMessage(name, args) {
@@ -1769,7 +1885,12 @@ function createEditorMcpToolProvider(options) {
         };
       }
     },
-    ...editTools.map((definition) => ({ ...definition, handler: edit(definition.name) }))
+    ...editTools.map((definition) => ({
+      ...definition,
+      handler: edit(definition.name),
+      // The cursor goes where the planner puts the change (see `planCanvasToolPlayback`).
+      plan: (args) => planCanvasToolPlayback(definition.name, args, options.getSnapshot(), options.plannerOptions, options.rectOptions)
+    }))
   ];
   if (options.captureView) {
     const capture = options.captureView;
@@ -1787,6 +1908,7 @@ function createEditorMcpToolProvider(options) {
     title: "Canvas and prompt editor",
     description: "The node canvas and the prompt: editor state, nodes and edges, layout, prompt text, and a view of the editor.",
     skill: "pixerate-canvas",
+    ...options.playbackSurface ? { playbackSurface: options.playbackSurface } : {},
     tools
   };
 }
@@ -1994,6 +2116,7 @@ function createCanvasComponentToolProvider(controller, options = { id: "canvas-c
   };
 }
 export {
+  AgentPlayback,
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
   EDITOR_CANVAS_TOOLS,
@@ -2018,6 +2141,9 @@ export {
   MCP_TOOL_PROMPT_SELECT,
   MCP_TOOL_PROMPT_SET_VARIABLE,
   MCP_TOOL_VIEW_EDITOR,
+  PRESENCE_COLORS,
+  PerformanceQueue,
+  PresenceStore,
   TOOL_BRIDGE_DEFAULT_PORT,
   TOOL_BRIDGE_PROTOCOL,
   TOOL_DISCOVERY_TOOLS,
@@ -2031,16 +2157,19 @@ export {
   captureOutputSize,
   cloneElementWithStyles,
   connectToolBridge,
+  createAgentPlayback,
   createCanvasComponentToolProvider,
   createCaptureTool,
   createCaptureToolProvider,
   createDocumentChartTools,
   createEditorMcpToolProvider,
   createElementCaptureSurface,
+  createInstantPresenceClock,
   createMcpServer,
   createRichTextToolProvider,
   createSpreadsheetToolProvider,
   createToolRegistry,
+  derivePlaybackSteps,
   elementToSvg,
   errorResult,
   isUnsafeJsonKey,
@@ -2048,10 +2177,17 @@ export {
   normalizeSide,
   parseSkillFrontmatter,
   planAgentCommand,
+  planCanvasPlaybackSteps,
+  planCanvasToolPlayback,
   planToolCall,
+  playbackRefsFromArgs,
+  playbackRefsFromResult,
   rasterizeElement,
   readSkillFile,
+  readingTime,
+  realPresenceClock,
   resolveCaptureRequest,
+  runToolScript,
   searchTokens,
   searchTools,
   stripPrototypeKeys,
@@ -2059,9 +2195,13 @@ export {
   toCapturedImageData,
   toToolResult,
   toolCallToAgentCommand,
+  toolResultError,
+  toolResultValue,
   toolsetInstructions,
   toolsetName,
+  tweenPresenceCursor,
   unionCaptureRects,
+  unionRects,
   unknownToolMessage,
   validateAgentCommand,
   validateJsonSchema

package/dist/agent/providers.d.cts

@@ -1,6 +1,7 @@
 import type { Editor } from '@tiptap/core';
 import type { SpreadsheetController } from '../spreadsheet/controller.cjs';
 import { type planToolCall } from './planner.cjs';
+import type { NodeRectOptions } from '../canvas/arrange.cjs';
 import type { AgentToolProvider } from '../tools/registry.cjs';
 import type { AgentStep, EditorSnapshot } from './types.cjs';
 import type { CanvasEdge, CanvasNode } from '../canvas/types.cjs';
@@ -64,7 +65,10 @@ export declare function createRichTextToolProvider(target: RichTextToolTarget, o
  * `unmerge_cells` / `transpose_range` on an A1 range (not the user's
  * selection), checked against merges and read-only cells first.
  */
-export declare function createSpreadsheetToolProvider(controller: SpreadsheetController, options: ToolProviderOptions): AgentToolProvider;
+export declare function createSpreadsheetToolProvider(controller: SpreadsheetController, options: ToolProviderOptions & {
+    /** The agent playback surface its calls are acted out on (default `spreadsheet`, where `SpreadsheetEditor` attaches). */
+    playbackSurface?: string;
+}): AgentToolProvider;
 export interface EditorMcpToolProviderOptions<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> extends ToolProviderOptions {
     /** Current editor / canvas state. */
     getSnapshot: () => EditorSnapshot<TNode, TEdge>;
@@ -95,6 +99,13 @@ export interface EditorMcpToolProviderOptions<TNode extends CanvasNode = CanvasN
         canvas?: boolean;
         prompt?: boolean;
     };
+    /**
+     * The agent playback surface the canvas edits are acted out on (default: the provider id).
+     * Attach it with `useCanvasPlaybackSurface` / `createCanvasPlaybackSurface`.
+     */
+    playbackSurface?: string;
+    /** Node size resolution for the cursor's targets (match the canvas' own). */
+    rectOptions?: NodeRectOptions;
 }
 /**
  * Exposes the editor MCP tools (`get_editor_state`, the canvas and prompt

package/dist/agent/providers.d.ts

@@ -1,6 +1,7 @@
 import type { Editor } from '@tiptap/core';
 import type { SpreadsheetController } from '../spreadsheet/controller.js';
 import { type planToolCall } from './planner.js';
+import type { NodeRectOptions } from '../canvas/arrange.js';
 import type { AgentToolProvider } from '../tools/registry.js';
 import type { AgentStep, EditorSnapshot } from './types.js';
 import type { CanvasEdge, CanvasNode } from '../canvas/types.js';
@@ -64,7 +65,10 @@ export declare function createRichTextToolProvider(target: RichTextToolTarget, o
  * `unmerge_cells` / `transpose_range` on an A1 range (not the user's
  * selection), checked against merges and read-only cells first.
  */
-export declare function createSpreadsheetToolProvider(controller: SpreadsheetController, options: ToolProviderOptions): AgentToolProvider;
+export declare function createSpreadsheetToolProvider(controller: SpreadsheetController, options: ToolProviderOptions & {
+    /** The agent playback surface its calls are acted out on (default `spreadsheet`, where `SpreadsheetEditor` attaches). */
+    playbackSurface?: string;
+}): AgentToolProvider;
 export interface EditorMcpToolProviderOptions<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> extends ToolProviderOptions {
     /** Current editor / canvas state. */
     getSnapshot: () => EditorSnapshot<TNode, TEdge>;
@@ -95,6 +99,13 @@ export interface EditorMcpToolProviderOptions<TNode extends CanvasNode = CanvasN
         canvas?: boolean;
         prompt?: boolean;
     };
+    /**
+     * The agent playback surface the canvas edits are acted out on (default: the provider id).
+     * Attach it with `useCanvasPlaybackSurface` / `createCanvasPlaybackSurface`.
+     */
+    playbackSurface?: string;
+    /** Node size resolution for the cursor's targets (match the canvas' own). */
+    rectOptions?: NodeRectOptions;
 }
 /**
  * Exposes the editor MCP tools (`get_editor_state`, the canvas and prompt

package/dist/agent/types.d.cts

@@ -1,6 +1,9 @@
 import type { CanvasEdge, CanvasNode, Side, XYPosition } from '../canvas/types.cjs';
 /**
  * Agent presence state for visual multiplayer/agent choreography.
+ *
+ * @deprecated Agent playback (`createAgentPlayback` in `@pixerate/editor/tools`) keeps cursors in a
+ * `PresenceStore` per surface and plays every tool call; draw them with `PresenceLayer`.
  */
 export interface AgentPresence {
     agentId: string;

package/dist/agent/types.d.ts

@@ -1,6 +1,9 @@
 import type { CanvasEdge, CanvasNode, Side, XYPosition } from '../canvas/types.js';
 /**
  * Agent presence state for visual multiplayer/agent choreography.
+ *
+ * @deprecated Agent playback (`createAgentPlayback` in `@pixerate/editor/tools`) keeps cursors in a
+ * `PresenceStore` per surface and plays every tool call; draw them with `PresenceLayer`.
  */
 export interface AgentPresence {
     agentId: string;

package/dist/animation/index.cjs

@@ -5,7 +5,7 @@
 
 
 
-var _chunkGEY73RUWcjs = require('../chunk-GEY73RUW.cjs');
+var _chunkUJGAA6AKcjs = require('../chunk-UJGAA6AK.cjs');
 
 
 
@@ -98,4 +98,4 @@ require('../chunk-A6QWKBJP.cjs');
 
 
 
-exports.ANIMATION_EASING_LABELS = _chunkDWJJI6RTcjs.ANIMATION_EASING_LABELS; exports.ANIMATION_EASING_PRESETS = _chunkDWJJI6RTcjs.ANIMATION_EASING_PRESETS; exports.ANIMATION_TIME_EPSILON = _chunkSVR5FR7Bcjs.ANIMATION_TIME_EPSILON; exports.AnimationPlayer = _chunkSVR5FR7Bcjs.AnimationPlayer; exports.CUBIC_BEZIER_PRESETS = _chunkDWJJI6RTcjs.CUBIC_BEZIER_PRESETS; exports.MOTION_BEHAVIORS = _chunk7B5GTJXBcjs.MOTION_BEHAVIORS; exports.ManualClock = _chunkSVR5FR7Bcjs.ManualClock; exports.PRESENCE_COLORS = _chunkGEY73RUWcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkGEY73RUWcjs.PerformanceQueue; exports.PresenceStore = _chunkGEY73RUWcjs.PresenceStore; exports.SPRING_PRESETS = _chunkDWJJI6RTcjs.SPRING_PRESETS; exports.behaviorProgress = _chunk7B5GTJXBcjs.behaviorProgress; exports.createAnimationPlayer = _chunkSVR5FR7Bcjs.createAnimationPlayer; exports.createInstantPresenceClock = _chunkGEY73RUWcjs.createInstantPresenceClock; exports.cubicBezierAt = _chunkDWJJI6RTcjs.cubicBezierAt; exports.easingFromInfluence = _chunkDWJJI6RTcjs.easingFromInfluence; exports.easingLabel = _chunkDWJJI6RTcjs.easingLabel; exports.easingToCss = _chunkDWJJI6RTcjs.easingToCss; exports.elasticAt = _chunkDWJJI6RTcjs.elasticAt; exports.evaluateEasing = _chunkDWJJI6RTcjs.evaluateEasing; exports.evaluateTrack = _chunkSVR5FR7Bcjs.evaluateTrack; exports.formatOklab = _chunk5FXOR7F2cjs.formatOklab; exports.fractalWiggle = _chunk7B5GTJXBcjs.fractalWiggle; exports.interpolateAnimationValue = _chunkSVR5FR7Bcjs.interpolateAnimationValue; exports.isAnimationEasing = _chunkDWJJI6RTcjs.isAnimationEasing; exports.isAnimationKeyframe = _chunkSVR5FR7Bcjs.isAnimationKeyframe; exports.isMotionBehavior = _chunk7B5GTJXBcjs.isMotionBehavior; exports.mixColorsOklab = _chunk5FXOR7F2cjs.mixColorsOklab; exports.motionSeedFromId = _chunk7B5GTJXBcjs.motionSeedFromId; exports.normalizeKeyframes = _chunkSVR5FR7Bcjs.normalizeKeyframes; exports.oklabToRgb = _chunk5FXOR7F2cjs.oklabToRgb; exports.pageHidden = _chunkSVR5FR7Bcjs.pageHidden; exports.parseCssEasing = _chunkDWJJI6RTcjs.parseCssEasing; exports.parseOklab = _chunk5FXOR7F2cjs.parseOklab; exports.quinticFade = _chunk7B5GTJXBcjs.quinticFade; exports.realClock = _chunkSVR5FR7Bcjs.realClock; exports.realPresenceClock = _chunkGEY73RUWcjs.realPresenceClock; exports.resolveEasing = _chunkDWJJI6RTcjs.resolveEasing; exports.reverseCubicBezier = _chunkDWJJI6RTcjs.reverseCubicBezier; exports.rgbToOklab = _chunk5FXOR7F2cjs.rgbToOklab; exports.springAt = _chunkDWJJI6RTcjs.springAt; exports.springSettleMs = _chunkDWJJI6RTcjs.springSettleMs; exports.tweenPresenceCursor = _chunkGEY73RUWcjs.tweenPresenceCursor; exports.wrapAnimationTime = _chunkSVR5FR7Bcjs.wrapAnimationTime;
+exports.ANIMATION_EASING_LABELS = _chunkDWJJI6RTcjs.ANIMATION_EASING_LABELS; exports.ANIMATION_EASING_PRESETS = _chunkDWJJI6RTcjs.ANIMATION_EASING_PRESETS; exports.ANIMATION_TIME_EPSILON = _chunkSVR5FR7Bcjs.ANIMATION_TIME_EPSILON; exports.AnimationPlayer = _chunkSVR5FR7Bcjs.AnimationPlayer; exports.CUBIC_BEZIER_PRESETS = _chunkDWJJI6RTcjs.CUBIC_BEZIER_PRESETS; exports.MOTION_BEHAVIORS = _chunk7B5GTJXBcjs.MOTION_BEHAVIORS; exports.ManualClock = _chunkSVR5FR7Bcjs.ManualClock; exports.PRESENCE_COLORS = _chunkUJGAA6AKcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkUJGAA6AKcjs.PerformanceQueue; exports.PresenceStore = _chunkUJGAA6AKcjs.PresenceStore; exports.SPRING_PRESETS = _chunkDWJJI6RTcjs.SPRING_PRESETS; exports.behaviorProgress = _chunk7B5GTJXBcjs.behaviorProgress; exports.createAnimationPlayer = _chunkSVR5FR7Bcjs.createAnimationPlayer; exports.createInstantPresenceClock = _chunkUJGAA6AKcjs.createInstantPresenceClock; exports.cubicBezierAt = _chunkDWJJI6RTcjs.cubicBezierAt; exports.easingFromInfluence = _chunkDWJJI6RTcjs.easingFromInfluence; exports.easingLabel = _chunkDWJJI6RTcjs.easingLabel; exports.easingToCss = _chunkDWJJI6RTcjs.easingToCss; exports.elasticAt = _chunkDWJJI6RTcjs.elasticAt; exports.evaluateEasing = _chunkDWJJI6RTcjs.evaluateEasing; exports.evaluateTrack = _chunkSVR5FR7Bcjs.evaluateTrack; exports.formatOklab = _chunk5FXOR7F2cjs.formatOklab; exports.fractalWiggle = _chunk7B5GTJXBcjs.fractalWiggle; exports.interpolateAnimationValue = _chunkSVR5FR7Bcjs.interpolateAnimationValue; exports.isAnimationEasing = _chunkDWJJI6RTcjs.isAnimationEasing; exports.isAnimationKeyframe = _chunkSVR5FR7Bcjs.isAnimationKeyframe; exports.isMotionBehavior = _chunk7B5GTJXBcjs.isMotionBehavior; exports.mixColorsOklab = _chunk5FXOR7F2cjs.mixColorsOklab; exports.motionSeedFromId = _chunk7B5GTJXBcjs.motionSeedFromId; exports.normalizeKeyframes = _chunkSVR5FR7Bcjs.normalizeKeyframes; exports.oklabToRgb = _chunk5FXOR7F2cjs.oklabToRgb; exports.pageHidden = _chunkSVR5FR7Bcjs.pageHidden; exports.parseCssEasing = _chunkDWJJI6RTcjs.parseCssEasing; exports.parseOklab = _chunk5FXOR7F2cjs.parseOklab; exports.quinticFade = _chunk7B5GTJXBcjs.quinticFade; exports.realClock = _chunkSVR5FR7Bcjs.realClock; exports.realPresenceClock = _chunkUJGAA6AKcjs.realPresenceClock; exports.resolveEasing = _chunkDWJJI6RTcjs.resolveEasing; exports.reverseCubicBezier = _chunkDWJJI6RTcjs.reverseCubicBezier; exports.rgbToOklab = _chunk5FXOR7F2cjs.rgbToOklab; exports.springAt = _chunkDWJJI6RTcjs.springAt; exports.springSettleMs = _chunkDWJJI6RTcjs.springSettleMs; exports.tweenPresenceCursor = _chunkUJGAA6AKcjs.tweenPresenceCursor; exports.wrapAnimationTime = _chunkSVR5FR7Bcjs.wrapAnimationTime;

package/dist/animation/index.js

@@ -5,7 +5,7 @@ import {
   createInstantPresenceClock,
   realPresenceClock,
   tweenPresenceCursor
-} from "../chunk-BSGPXPTW.js";
+} from "../chunk-PEEP2YR7.js";
 import {
   MOTION_BEHAVIORS,
   behaviorProgress,

package/dist/animation/presence.d.cts

@@ -1,75 +1 @@
-export interface PresenceActor {
-    id: string;
-    name: string;
-    color: string;
-    /** Cursor position in the surface's own coordinates (scene / canvas). */
-    x: number;
-    y: number;
-    /** The button is down (dragging). */
-    pressed: boolean;
-    /** A short note shown next to the cursor (what the agent is doing). */
-    message?: string;
-}
-export interface PresenceState {
-    actors: readonly PresenceActor[];
-}
-export declare const PRESENCE_COLORS: readonly string[];
-/** Cursor positions and notes of agents acting on a surface, for an overlay. */
-export declare class PresenceStore {
-    private state;
-    private readonly listeners;
-    getState: () => PresenceState;
-    subscribe: (listener: (state: PresenceState) => void) => (() => void);
-    /** The actor with `id`, if it is on the surface. */
-    get(id: string): PresenceActor | undefined;
-    /** Adds or changes an actor. */
-    set(actor: Pick<PresenceActor, 'id'> & Partial<PresenceActor>): void;
-    remove(id: string): void;
-}
-/** Time for performances: real timers, or an instant clock for tests and recordings. */
-export interface PresenceClock {
-    now(): number;
-    wait(ms: number): Promise<void>;
-}
-export declare const realPresenceClock: PresenceClock;
-/** A clock whose waits finish at once while its time still advances (repeatable performances). */
-export declare function createInstantPresenceClock(start?: number): PresenceClock & {
-    elapsed(): number;
-};
-/**
- * Glides an actor's cursor from `from` to `to` over `ms` (ease-out cubic, ~60 frames a second),
- * calling `each` with the eased progress after every frame (e.g. to drag a value along).
- */
-export declare function tweenPresenceCursor(presence: PresenceStore, clock: PresenceClock, id: string, from: {
-    x: number;
-    y: number;
-}, to: {
-    x: number;
-    y: number;
-}, ms: number, each?: (t: number) => void): Promise<void>;
-export interface PresenceActorInfo {
-    id: string;
-    name?: string;
-    color?: string;
-}
-export interface PerformanceQueueOptions {
-    clock: PresenceClock;
-    /** Hide each actor's cursor this long after its last call (ms, default 1500; 0 keeps it). */
-    linger?: number;
-    /** Called around each call so everything it changes is one undo step. */
-    beginGesture?: (key: string) => void;
-    endGesture?: () => void;
-}
-/**
- * Runs performances one after another per actor (different actors run side by side). Each
- * call shows the actor's cursor, wraps the call in one gesture (one undo step), clears the
- * note when it ends, and hides the cursor after `linger` unless another call followed.
- */
-export declare class PerformanceQueue {
-    readonly presence: PresenceStore;
-    private readonly options;
-    private readonly queues;
-    private calls;
-    constructor(presence: PresenceStore, options: PerformanceQueueOptions);
-    run<T>(actor: PresenceActorInfo, perform: () => Promise<T>): Promise<T>;
-}
+export * from '../tools/presence.cjs';

package/dist/animation/presence.d.ts

@@ -1,75 +1 @@
-export interface PresenceActor {
-    id: string;
-    name: string;
-    color: string;
-    /** Cursor position in the surface's own coordinates (scene / canvas). */
-    x: number;
-    y: number;
-    /** The button is down (dragging). */
-    pressed: boolean;
-    /** A short note shown next to the cursor (what the agent is doing). */
-    message?: string;
-}
-export interface PresenceState {
-    actors: readonly PresenceActor[];
-}
-export declare const PRESENCE_COLORS: readonly string[];
-/** Cursor positions and notes of agents acting on a surface, for an overlay. */
-export declare class PresenceStore {
-    private state;
-    private readonly listeners;
-    getState: () => PresenceState;
-    subscribe: (listener: (state: PresenceState) => void) => (() => void);
-    /** The actor with `id`, if it is on the surface. */
-    get(id: string): PresenceActor | undefined;
-    /** Adds or changes an actor. */
-    set(actor: Pick<PresenceActor, 'id'> & Partial<PresenceActor>): void;
-    remove(id: string): void;
-}
-/** Time for performances: real timers, or an instant clock for tests and recordings. */
-export interface PresenceClock {
-    now(): number;
-    wait(ms: number): Promise<void>;
-}
-export declare const realPresenceClock: PresenceClock;
-/** A clock whose waits finish at once while its time still advances (repeatable performances). */
-export declare function createInstantPresenceClock(start?: number): PresenceClock & {
-    elapsed(): number;
-};
-/**
- * Glides an actor's cursor from `from` to `to` over `ms` (ease-out cubic, ~60 frames a second),
- * calling `each` with the eased progress after every frame (e.g. to drag a value along).
- */
-export declare function tweenPresenceCursor(presence: PresenceStore, clock: PresenceClock, id: string, from: {
-    x: number;
-    y: number;
-}, to: {
-    x: number;
-    y: number;
-}, ms: number, each?: (t: number) => void): Promise<void>;
-export interface PresenceActorInfo {
-    id: string;
-    name?: string;
-    color?: string;
-}
-export interface PerformanceQueueOptions {
-    clock: PresenceClock;
-    /** Hide each actor's cursor this long after its last call (ms, default 1500; 0 keeps it). */
-    linger?: number;
-    /** Called around each call so everything it changes is one undo step. */
-    beginGesture?: (key: string) => void;
-    endGesture?: () => void;
-}
-/**
- * Runs performances one after another per actor (different actors run side by side). Each
- * call shows the actor's cursor, wraps the call in one gesture (one undo step), clears the
- * note when it ends, and hides the cursor after `linger` unless another call followed.
- */
-export declare class PerformanceQueue {
-    readonly presence: PresenceStore;
-    private readonly options;
-    private readonly queues;
-    private calls;
-    constructor(presence: PresenceStore, options: PerformanceQueueOptions);
-    run<T>(actor: PresenceActorInfo, perform: () => Promise<T>): Promise<T>;
-}
+export * from '../tools/presence.js';