houseplan-card/test/touch-gesture-click-guard.test.mjs

import assert from 'node:assert/strict';
import test from 'node:test';
import { TouchGestureClickGuard } from '../test-build/touch-gesture-click-guard.js';

test('#563 multi-touch keeps every unowned click blocked after both releases', () => {
  const guard = new TouchGestureClickGuard();
  guard.pointerDown(1, 'touch');
  guard.pointerDown(2, 'touch');
  assert.equal(guard.sequenceMultitouch, true);
  assert.equal(guard.clickBlocked, true);

  assert.equal(guard.pointerTerminal(1, 'touch'), true);
  assert.equal(guard.sequenceMultitouch, true);
  assert.equal(guard.clickBlocked, true);
  assert.equal(guard.pointerTerminal(2, 'touch'), true);
  assert.equal(guard.sequenceMultitouch, false);
  assert.equal(guard.clickBlocked, true);
});

test('#563 a new single-pointer sequence re-arms its click immediately', () => {
  const guard = new TouchGestureClickGuard();
  guard.pointerDown(1, 'touch');
  guard.pointerDown(2, 'touch');
  guard.pointerTerminal(2, 'touch');
  guard.pointerTerminal(1, 'touch');
  assert.equal(guard.clickBlocked, true);

  guard.pointerDown(3, 'touch');
  assert.equal(guard.clickBlocked, false);
  assert.equal(guard.pointerTerminal(3, 'touch'), false);
  assert.equal(guard.clickBlocked, false);
});

test('#563 reverse release, cancel and lost capture never turn a pinch into a tap', () => {
  for (const terminals of [
    ['pointerup', 'pointercancel'],
    ['lostpointercapture', 'pointerup'],
  ]) {
    const guard = new TouchGestureClickGuard();
    guard.pointerDown(10, 'touch');
    guard.pointerDown(11, 'touch');
    // Event names are deliberately irrelevant to the state transition: every
    // terminal removes its exact pointer but preserves multi-touch ownership.
    assert.equal(guard.pointerTerminal(11, 'touch'), true, terminals[0]);
    assert.equal(guard.pointerTerminal(10, 'touch'), true, terminals[1]);
    assert.equal(guard.clickBlocked, true);
  }
});

test('#563 a new mouse sequence on a hybrid device is not held by an old pinch', () => {
  const guard = new TouchGestureClickGuard();
  guard.pointerDown(1, 'touch');
  guard.pointerDown(2, 'touch');
  guard.pointerTerminal(1, 'touch');
  guard.pointerTerminal(2, 'touch');
  assert.equal(guard.clickBlocked, true);

  guard.pointerDown(20, 'mouse');
  assert.equal(guard.clickBlocked, false);
  guard.reset();
  assert.equal(guard.sequenceMultitouch, false);
  assert.equal(guard.clickBlocked, false);
});

test('#578 active and completed pinch own click and context-menu activation', () => {
  const guard = new TouchGestureClickGuard();
  guard.pointerDown(1, 'touch');
  guard.pointerDown(2, 'touch');
  assert.equal(guard.clickBlocked, true, 'activation is blocked while both contacts are active');

  guard.pointerTerminal(1, 'touch');
  assert.equal(guard.clickBlocked, true, 'the remaining old contact cannot become a new gesture');
  guard.pointerTerminal(2, 'touch');
  assert.equal(guard.clickBlocked, true, 'compatibility activation stays owned after release');
});

test('#578 keyboard intent re-arms context menu only after every old touch ended', () => {
  const guard = new TouchGestureClickGuard();
  const activation = (type, init = {}) => {
    const event = {
      type, defaultPrevented: false, immediateStopped: false, ...init,
      preventDefault() { this.defaultPrevented = true; },
      stopImmediatePropagation() { this.immediateStopped = true; },
    };
    assert.equal(guard.handleActivation(event, false), true);
    return event;
  };
  guard.pointerDown(1, 'touch');
  guard.pointerDown(2, 'touch');

  activation('keydown', { key: 'F10', shiftKey: true });
  assert.equal(guard.clickBlocked, true, 'a key cannot re-arm actions during an active pinch');
  guard.pointerTerminal(1, 'touch');
  activation('keydown', { key: 'ContextMenu', shiftKey: false });
  assert.equal(guard.clickBlocked, true, 'the last old touch still owns the sequence');
  guard.pointerTerminal(2, 'touch');

  activation('keydown', { key: 'Tab', shiftKey: false });
  assert.equal(guard.clickBlocked, true, 'an unrelated key is not new pointer intent');
  const staleContextMenu = activation('contextmenu');
  assert.equal(staleContextMenu.defaultPrevented, true);
  assert.equal(staleContextMenu.immediateStopped, true);

  activation('keydown', { key: 'F10', shiftKey: true });
  assert.equal(guard.clickBlocked, false, 'Shift+F10 is fresh intent after all contacts ended');
  const freshContextMenu = activation('contextmenu');
  assert.equal(freshContextMenu.defaultPrevented, false);
});