@geometra/renderer-canvas 1.53.0 → 1.55.0

package/dist/__tests__/gestures.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gestures.test.d.ts.map

package/dist/__tests__/gestures.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestures.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/gestures.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/gestures.test.js

@@ -0,0 +1,134 @@
+import { describe, it, expect } from 'vitest';
+import { attachGestureRecognizers } from '../gestures.js';
+class FakeEventTarget {
+    listeners = new Map();
+    addEventListener(type, listener) {
+        if (!this.listeners.has(type))
+            this.listeners.set(type, new Set());
+        this.listeners.get(type).add(listener);
+    }
+    removeEventListener(type, listener) {
+        this.listeners.get(type)?.delete(listener);
+    }
+    dispatch(type, event) {
+        const list = this.listeners.get(type);
+        if (!list)
+            return;
+        for (const listener of list)
+            listener(event);
+    }
+    listenerCount(type) {
+        return this.listeners.get(type)?.size ?? 0;
+    }
+}
+function makeRecorder() {
+    const events = [];
+    return {
+        events,
+        pointerDown: sample => events.push({ type: 'down', sample }),
+        pointerMove: sample => events.push({ type: 'move', sample }),
+        pointerUp: sample => events.push({ type: 'up', sample }),
+        pointerCancel: pointerId => events.push({ type: 'cancel', pointerId }),
+    };
+}
+function makeCanvas(target, rect = { left: 10, top: 20 }) {
+    return {
+        addEventListener: target.addEventListener.bind(target),
+        removeEventListener: target.removeEventListener.bind(target),
+        getBoundingClientRect: () => rect,
+    };
+}
+describe('attachGestureRecognizers', () => {
+    it('converts pointerdown clientX/Y to canvas-space samples and fans out to all recognizers', () => {
+        const canvasTarget = new FakeEventTarget();
+        const docTarget = new FakeEventTarget();
+        const canvas = makeCanvas(canvasTarget, { left: 10, top: 20 });
+        const a = makeRecorder();
+        const b = makeRecorder();
+        const cleanup = attachGestureRecognizers(canvas, [a, b], {
+            documentTarget: docTarget,
+            now: () => 42,
+        });
+        canvasTarget.dispatch('pointerdown', { pointerId: 1, clientX: 30, clientY: 50 });
+        expect(a.events).toEqual([{ type: 'down', sample: { id: 1, x: 20, y: 30, timestampMs: 42 } }]);
+        expect(b.events).toEqual([{ type: 'down', sample: { id: 1, x: 20, y: 30, timestampMs: 42 } }]);
+        cleanup();
+    });
+    it('routes pointermove/up/cancel through documentTarget when trackOutsideCanvas is true (default)', () => {
+        const canvasTarget = new FakeEventTarget();
+        const docTarget = new FakeEventTarget();
+        const canvas = makeCanvas(canvasTarget);
+        const r = makeRecorder();
+        const cleanup = attachGestureRecognizers(canvas, [r], {
+            documentTarget: docTarget,
+            now: () => 0,
+        });
+        canvasTarget.dispatch('pointerdown', { pointerId: 7, clientX: 10, clientY: 20 });
+        docTarget.dispatch('pointermove', { pointerId: 7, clientX: 60, clientY: 80 });
+        docTarget.dispatch('pointerup', { pointerId: 7, clientX: 60, clientY: 80 });
+        expect(r.events.map(e => e.type)).toEqual(['down', 'move', 'up']);
+        // Moves for unknown pointer ids are filtered out.
+        docTarget.dispatch('pointermove', { pointerId: 99, clientX: 0, clientY: 0 });
+        expect(r.events.map(e => e.type)).toEqual(['down', 'move', 'up']);
+        cleanup();
+        expect(canvasTarget.listenerCount('pointerdown')).toBe(0);
+        expect(docTarget.listenerCount('pointermove')).toBe(0);
+        expect(docTarget.listenerCount('pointerup')).toBe(0);
+        expect(docTarget.listenerCount('pointercancel')).toBe(0);
+    });
+    it('clamps all listeners to the canvas when trackOutsideCanvas is false', () => {
+        const canvasTarget = new FakeEventTarget();
+        const docTarget = new FakeEventTarget();
+        const canvas = makeCanvas(canvasTarget);
+        const r = makeRecorder();
+        const cleanup = attachGestureRecognizers(canvas, [r], {
+            trackOutsideCanvas: false,
+            documentTarget: docTarget,
+            now: () => 0,
+        });
+        canvasTarget.dispatch('pointerdown', { pointerId: 1, clientX: 10, clientY: 20 });
+        docTarget.dispatch('pointermove', { pointerId: 1, clientX: 60, clientY: 80 });
+        // Document move ignored because we only listen on canvas.
+        expect(r.events.map(e => e.type)).toEqual(['down']);
+        canvasTarget.dispatch('pointermove', { pointerId: 1, clientX: 60, clientY: 80 });
+        expect(r.events.map(e => e.type)).toEqual(['down', 'move']);
+        cleanup();
+    });
+    it('pointercancel forwards the pointer id and drops the active pointer', () => {
+        const canvasTarget = new FakeEventTarget();
+        const docTarget = new FakeEventTarget();
+        const canvas = makeCanvas(canvasTarget);
+        const r = makeRecorder();
+        const cleanup = attachGestureRecognizers(canvas, [r], {
+            documentTarget: docTarget,
+            now: () => 0,
+        });
+        canvasTarget.dispatch('pointerdown', { pointerId: 3, clientX: 10, clientY: 20 });
+        docTarget.dispatch('pointercancel', { pointerId: 3 });
+        expect(r.events[r.events.length - 1]).toEqual({ type: 'cancel', pointerId: 3 });
+        // After cancel, further moves for this id are ignored.
+        docTarget.dispatch('pointermove', { pointerId: 3, clientX: 100, clientY: 100 });
+        expect(r.events.map(e => e.type)).toEqual(['down', 'cancel']);
+        cleanup();
+    });
+    it('uses the options.now timestamp source for every sample', () => {
+        const canvasTarget = new FakeEventTarget();
+        const docTarget = new FakeEventTarget();
+        const canvas = makeCanvas(canvasTarget);
+        const r = makeRecorder();
+        let t = 0;
+        const clock = () => {
+            t += 10;
+            return t;
+        };
+        const cleanup = attachGestureRecognizers(canvas, [r], {
+            documentTarget: docTarget,
+            now: clock,
+        });
+        canvasTarget.dispatch('pointerdown', { pointerId: 1, clientX: 10, clientY: 20 });
+        docTarget.dispatch('pointermove', { pointerId: 1, clientX: 12, clientY: 22 });
+        expect(r.events.map(e => e.sample?.timestampMs)).toEqual([10, 20]);
+        cleanup();
+    });
+});
+//# sourceMappingURL=gestures.test.js.map

package/dist/__tests__/gestures.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestures.test.js","sourceRoot":"","sources":["../../src/__tests__/gestures.test.ts"],"names":[],"mappings":"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"}

package/dist/gestures.d.ts

@@ -0,0 +1,63 @@
+import type { PointerSample } from '@geometra/core';
+/**
+ * Host-agnostic surface that every gesture recognizer in `@geometra/core`
+ * implements. We redeclare it here rather than importing each recognizer type
+ * so callers can pass any array of compatible recognizers (including user-built
+ * ones) without having to list every union member.
+ */
+export interface CanvasGestureRecognizerLike {
+    pointerDown(sample: PointerSample): void;
+    pointerMove(sample: PointerSample): void;
+    pointerUp(sample: PointerSample): void;
+    pointerCancel(pointerId: number): void;
+}
+export interface AttachGestureRecognizersOptions {
+    /**
+     * When true (default), `pointermove` / `pointerup` / `pointercancel` are
+     * attached to `document` so drags continue if the pointer leaves the canvas.
+     * Set false to clamp all events to the canvas bounds (useful in test
+     * environments without `document`).
+     */
+    trackOutsideCanvas?: boolean;
+    /**
+     * High-resolution timestamp source. Defaults to `performance.now()` — or a
+     * frozen `0` when `performance` is unavailable (SSR/Node test envs).
+     */
+    now?: () => number;
+    /**
+     * Optional override for the document-like target used for outside-canvas
+     * tracking. Primarily for tests that can't rely on a global `document`.
+     */
+    documentTarget?: {
+        addEventListener: Document['addEventListener'];
+        removeEventListener: Document['removeEventListener'];
+    };
+}
+/**
+ * Convert browser `PointerEvent`s into {@link PointerSample}s and fan them out
+ * to one or more `@geometra/core` gesture recognizers (pan / swipe / pinch or
+ * user-built state machines). Returns a cleanup function.
+ *
+ * Typical integration:
+ *
+ * ```ts
+ * import { createPanRecognizer } from '@geometra/core'
+ * import { attachGestureRecognizers } from '@geometra/renderer-canvas'
+ *
+ * const pan = createPanRecognizer({ onMove: e => setOffset(e.deltaX, e.deltaY) })
+ * const stop = attachGestureRecognizers(canvas, [pan])
+ * // ...later: stop()
+ * ```
+ *
+ * `pointerdown` is always attached to the canvas. `pointermove` /
+ * `pointerup` / `pointercancel` are attached to `document` by default so drags
+ * continue after the pointer leaves the canvas — the sample coordinates stay
+ * relative to the canvas because we subtract `getBoundingClientRect()` on every
+ * event. Set `trackOutsideCanvas: false` to clamp to the canvas.
+ *
+ * We track which pointer IDs have been seen via `pointerdown` on this canvas so
+ * stray moves/ups from unrelated elements can't accidentally drive recognizer
+ * state.
+ */
+export declare function attachGestureRecognizers(canvas: HTMLCanvasElement, recognizers: ReadonlyArray<CanvasGestureRecognizerLike>, options?: AttachGestureRecognizersOptions): () => void;
+//# sourceMappingURL=gestures.d.ts.map

package/dist/gestures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestures.d.ts","sourceRoot":"","sources":["../src/gestures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IACxC,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IACxC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IACtC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACvC;AAED,MAAM,WAAW,+BAA+B;IAC9C;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE;QACf,gBAAgB,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAA;QAC9C,mBAAmB,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAA;KACrD,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,aAAa,CAAC,2BAA2B,CAAC,EACvD,OAAO,GAAE,+BAAoC,GAC5C,MAAM,IAAI,CA2DZ"}

package/dist/gestures.js

@@ -0,0 +1,88 @@
+/**
+ * Convert browser `PointerEvent`s into {@link PointerSample}s and fan them out
+ * to one or more `@geometra/core` gesture recognizers (pan / swipe / pinch or
+ * user-built state machines). Returns a cleanup function.
+ *
+ * Typical integration:
+ *
+ * ```ts
+ * import { createPanRecognizer } from '@geometra/core'
+ * import { attachGestureRecognizers } from '@geometra/renderer-canvas'
+ *
+ * const pan = createPanRecognizer({ onMove: e => setOffset(e.deltaX, e.deltaY) })
+ * const stop = attachGestureRecognizers(canvas, [pan])
+ * // ...later: stop()
+ * ```
+ *
+ * `pointerdown` is always attached to the canvas. `pointermove` /
+ * `pointerup` / `pointercancel` are attached to `document` by default so drags
+ * continue after the pointer leaves the canvas — the sample coordinates stay
+ * relative to the canvas because we subtract `getBoundingClientRect()` on every
+ * event. Set `trackOutsideCanvas: false` to clamp to the canvas.
+ *
+ * We track which pointer IDs have been seen via `pointerdown` on this canvas so
+ * stray moves/ups from unrelated elements can't accidentally drive recognizer
+ * state.
+ */
+export function attachGestureRecognizers(canvas, recognizers, options = {}) {
+    const trackOutsideCanvas = options.trackOutsideCanvas !== false;
+    const now = options.now ?? fallbackNow();
+    const activePointers = new Set();
+    function toSample(e) {
+        const rect = canvas.getBoundingClientRect();
+        return {
+            id: e.pointerId,
+            x: e.clientX - rect.left,
+            y: e.clientY - rect.top,
+            timestampMs: now(),
+        };
+    }
+    function onPointerDown(e) {
+        activePointers.add(e.pointerId);
+        const sample = toSample(e);
+        for (const r of recognizers)
+            r.pointerDown(sample);
+    }
+    function onPointerMove(e) {
+        if (!activePointers.has(e.pointerId))
+            return;
+        const sample = toSample(e);
+        for (const r of recognizers)
+            r.pointerMove(sample);
+    }
+    function onPointerUp(e) {
+        if (!activePointers.has(e.pointerId))
+            return;
+        activePointers.delete(e.pointerId);
+        const sample = toSample(e);
+        for (const r of recognizers)
+            r.pointerUp(sample);
+    }
+    function onPointerCancel(e) {
+        if (!activePointers.has(e.pointerId))
+            return;
+        activePointers.delete(e.pointerId);
+        for (const r of recognizers)
+            r.pointerCancel(e.pointerId);
+    }
+    canvas.addEventListener('pointerdown', onPointerDown);
+    const moveTarget = trackOutsideCanvas
+        ? (options.documentTarget ?? (typeof document !== 'undefined' ? document : canvas))
+        : canvas;
+    moveTarget.addEventListener('pointermove', onPointerMove);
+    moveTarget.addEventListener('pointerup', onPointerUp);
+    moveTarget.addEventListener('pointercancel', onPointerCancel);
+    return () => {
+        canvas.removeEventListener('pointerdown', onPointerDown);
+        moveTarget.removeEventListener('pointermove', onPointerMove);
+        moveTarget.removeEventListener('pointerup', onPointerUp);
+        moveTarget.removeEventListener('pointercancel', onPointerCancel);
+    };
+}
+function fallbackNow() {
+    if (typeof performance !== 'undefined' && typeof performance.now === 'function') {
+        return () => performance.now();
+    }
+    return () => 0;
+}
+//# sourceMappingURL=gestures.js.map

package/dist/gestures.js.map

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

package/dist/index.d.ts

@@ -2,4 +2,6 @@ export { createBrowserCanvasClient } from './browser-client.js';
 export type { BrowserCanvasClientHandle, BrowserCanvasClientOptions } from './browser-client.js';
 export { CanvasRenderer, enableSelection, enableFind, enableAccessibilityMirror, enableInputForwarding } from './renderer.js';
 export type { CanvasRendererOptions, AccessibilityMirrorOptions, CanvasInputForwardingOptions } from './renderer.js';
+export { attachGestureRecognizers } from './gestures.js';
+export type { AttachGestureRecognizersOptions, CanvasGestureRecognizerLike } from './gestures.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,YAAY,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAChG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC7H,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,YAAY,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAChG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC7H,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAA;AACpH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AACxD,YAAY,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { createBrowserCanvasClient } from './browser-client.js';
 export { CanvasRenderer, enableSelection, enableFind, enableAccessibilityMirror, enableInputForwarding } from './renderer.js';
+export { attachGestureRecognizers } from './gestures.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE7H,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geometra/renderer-canvas",
-  "version": "1.53.0",
+  "version": "1.55.0",
   "description": "Canvas2D renderer for Geometra — the geometry protocol for UI",
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,6 @@
   },
   "dependencies": {
     "@geometra/client": "^1.6.0",
-    "@geometra/core": "^1.53.0"
+    "@geometra/core": "^1.55.0"
   }
 }