js-draw 1.21.2 → 1.21.3

package/dist/cjs/tools/FindTool.js

@@ -0,0 +1,137 @@
+"use strict";
+// Displays a find dialog that allows the user to search for and focus text.
+//
+// @packageDocumentation
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const TextComponent_1 = __importDefault(require("../components/TextComponent"));
+const ImageComponent_1 = __importDefault(require("../components/ImageComponent"));
+const BaseTool_1 = __importDefault(require("./BaseTool"));
+const keybindings_1 = require("./keybindings");
+const cssPrefix = 'find-tool';
+class FindTool extends BaseTool_1.default {
+    constructor(editor) {
+        super(editor.notifier, editor.localization.findLabel);
+        this.editor = editor;
+        this.currentMatchIdx = 0;
+        this.overlay = document.createElement('div');
+        this.fillOverlay();
+        editor.createHTMLOverlay(this.overlay);
+        this.overlay.style.display = 'none';
+        this.overlay.classList.add(`${cssPrefix}-overlay`);
+    }
+    canReceiveInputInReadOnlyEditor() {
+        return true;
+    }
+    getMatches(searchFor) {
+        const lowerSearchFor = searchFor.toLocaleLowerCase();
+        const matchingComponents = this.editor.image.getAllElements().filter(component => {
+            let text = '';
+            if (component instanceof TextComponent_1.default) {
+                text = component.getText();
+            }
+            else if (component instanceof ImageComponent_1.default) {
+                text = component.getAltText() ?? '';
+            }
+            else {
+                return false;
+            }
+            const hasLowercaseMatch = text.toLocaleLowerCase().indexOf(lowerSearchFor) !== -1;
+            const hasSameCaseMatch = text.indexOf(searchFor) !== -1;
+            return hasLowercaseMatch || hasSameCaseMatch;
+        });
+        return matchingComponents.map(match => match.getBBox());
+    }
+    focusCurrentMatch() {
+        const matches = this.getMatches(this.searchInput.value);
+        let matchIdx = this.currentMatchIdx % matches.length;
+        if (matchIdx < 0) {
+            matchIdx = matches.length + matchIdx;
+        }
+        if (matchIdx < matches.length) {
+            const undoable = false;
+            void this.editor.dispatch(this.editor.viewport.zoomTo(matches[matchIdx], true, true), undoable);
+            this.editor.announceForAccessibility(this.editor.localization.focusedFoundText(matchIdx + 1, matches.length));
+        }
+    }
+    toNextMatch() {
+        this.currentMatchIdx++;
+        this.focusCurrentMatch();
+    }
+    toPrevMatch() {
+        this.currentMatchIdx--;
+        this.focusCurrentMatch();
+    }
+    fillOverlay() {
+        const label = document.createElement('label');
+        this.searchInput = document.createElement('input');
+        const nextBtn = document.createElement('button');
+        const closeBtn = document.createElement('button');
+        // Math.random() ensures that the ID is unique (to allow us to refer to it
+        // with an htmlFor).
+        this.searchInput.setAttribute('id', `${cssPrefix}-searchInput-${Math.random()}`);
+        label.htmlFor = this.searchInput.getAttribute('id');
+        label.innerText = this.editor.localization.findLabel;
+        nextBtn.innerText = this.editor.localization.toNextMatch;
+        closeBtn.innerText = this.editor.localization.closeDialog;
+        this.searchInput.onkeydown = (ev) => {
+            if (ev.key === 'Enter') {
+                if (ev.shiftKey) {
+                    this.toPrevMatch();
+                }
+                else {
+                    this.toNextMatch();
+                }
+            }
+            else if (ev.key === 'Escape') {
+                this.setVisible(false);
+            }
+            else if (this.editor.shortcuts.matchesShortcut(keybindings_1.toggleFindVisibleShortcutId, ev)) {
+                ev.preventDefault();
+                this.toggleVisible();
+            }
+        };
+        nextBtn.onclick = () => {
+            this.toNextMatch();
+        };
+        closeBtn.onclick = () => {
+            this.setVisible(false);
+        };
+        this.overlay.replaceChildren(label, this.searchInput, nextBtn, closeBtn);
+    }
+    isVisible() {
+        return this.overlay.style.display !== 'none';
+    }
+    setVisible(visible) {
+        if (visible !== this.isVisible()) {
+            this.overlay.style.display = visible ? 'block' : 'none';
+            if (visible) {
+                this.searchInput.focus();
+                this.editor.announceForAccessibility(this.editor.localization.findDialogShown);
+            }
+            else {
+                this.editor.focus();
+                this.editor.announceForAccessibility(this.editor.localization.findDialogHidden);
+            }
+        }
+    }
+    toggleVisible() {
+        this.setVisible(!this.isVisible());
+    }
+    onKeyPress(event) {
+        if (this.editor.shortcuts.matchesShortcut(keybindings_1.toggleFindVisibleShortcutId, event)) {
+            this.toggleVisible();
+            return true;
+        }
+        return false;
+    }
+    setEnabled(enabled) {
+        super.setEnabled(enabled);
+        if (this.isEnabled()) {
+            this.setVisible(false);
+        }
+    }
+}
+exports.default = FindTool;

package/dist/cjs/tools/FindTool.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.d.ts

@@ -0,0 +1,17 @@
+import { InputEvt } from '../../inputEvents';
+import InputMapper from './InputMapper';
+export default class ContextMenuRecognizer extends InputMapper {
+    private canShowContextMenu;
+    private contextMenuTriggerPointer;
+    private contextMenuStartPoint;
+    private stationaryDetector;
+    private clickTolerance;
+    constructor();
+    /**
+     * In general, only certain events (i.e. touchscreens) are expected to be able to
+     * create long-press menus. This method checks whether `event` was generated by
+     * one such device.
+     */
+    private canMakeLongPressMenuEvent;
+    onEvent(event: InputEvt): boolean;
+}

package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const inputEvents_1 = require("../../inputEvents");
+const InputMapper_1 = __importDefault(require("./InputMapper"));
+const StationaryPenDetector_1 = __importStar(require("../util/StationaryPenDetector"));
+const Pointer_1 = require("../../Pointer");
+class ContextMenuRecognizer extends InputMapper_1.default {
+    constructor() {
+        super();
+        this.canShowContextMenu = false;
+        this.stationaryDetector = null;
+        this.clickTolerance = 12;
+    }
+    /**
+     * In general, only certain events (i.e. touchscreens) are expected to be able to
+     * create long-press menus. This method checks whether `event` was generated by
+     * one such device.
+     */
+    canMakeLongPressMenuEvent(event) {
+        const allowedDevices = [
+            Pointer_1.PointerDevice.Touch,
+        ];
+        return event.allPointers.length === 1 && allowedDevices.includes(event.current.device);
+    }
+    onEvent(event) {
+        const sendContextMenuEvent = () => {
+            if (!(0, inputEvents_1.isPointerEvt)(event))
+                return false;
+            if (this.canShowContextMenu) {
+                const eventHandled = this.emit({
+                    kind: inputEvents_1.InputEvtType.ContextMenu,
+                    screenPos: event.current.screenPos,
+                    canvasPos: event.current.canvasPos,
+                });
+                if (eventHandled) {
+                    this.emit({
+                        kind: inputEvents_1.InputEvtType.GestureCancelEvt,
+                    });
+                    return true;
+                }
+            }
+            return false;
+        };
+        if (event.kind === inputEvents_1.InputEvtType.PointerDownEvt) {
+            if (event.allPointers.length === 1) {
+                this.canShowContextMenu = true;
+                this.contextMenuTriggerPointer = event.current;
+                this.contextMenuStartPoint = event.current.screenPos;
+                if (this.canMakeLongPressMenuEvent(event)) {
+                    this.stationaryDetector = new StationaryPenDetector_1.default(event.current, StationaryPenDetector_1.defaultStationaryDetectionConfig, sendContextMenuEvent);
+                }
+            }
+            else {
+                this.canShowContextMenu = false;
+            }
+        }
+        else if (event.kind === inputEvents_1.InputEvtType.PointerMoveEvt) {
+            if (this.canShowContextMenu) {
+                this.stationaryDetector?.onPointerMove(event.current);
+                // Only clicks/stationary long presses can create context menu events.
+                const deltaPosition = event.current.screenPos.minus(this.contextMenuStartPoint);
+                const threshold = this.clickTolerance;
+                if (deltaPosition.length() > threshold) {
+                    this.canShowContextMenu = false;
+                }
+            }
+        }
+        else if (event.kind === inputEvents_1.InputEvtType.PointerUpEvt) {
+            this.stationaryDetector?.destroy();
+            if (this.contextMenuTriggerPointer?.id === event.current.id &&
+                this.contextMenuTriggerPointer.device === Pointer_1.PointerDevice.RightButtonMouse &&
+                sendContextMenuEvent()) {
+                return true;
+            }
+        }
+        return this.emit(event);
+    }
+}
+exports.default = ContextMenuRecognizer;

package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/tools/InputFilter/FunctionMapper.d.ts

@@ -0,0 +1,12 @@
+import { InputEvt } from '../../inputEvents';
+import InputMapper from './InputMapper';
+/**
+ * An `InputMapper` that applies a function to all events it receives.
+ *
+ * Useful for automated testing.
+ */
+export default class FunctionMapper extends InputMapper {
+    private fn;
+    constructor(fn: (event: InputEvt) => InputEvt);
+    onEvent(event: InputEvt): boolean;
+}

package/dist/cjs/tools/InputFilter/FunctionMapper.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const InputMapper_1 = __importDefault(require("./InputMapper"));
+/**
+ * An `InputMapper` that applies a function to all events it receives.
+ *
+ * Useful for automated testing.
+ */
+class FunctionMapper extends InputMapper_1.default {
+    constructor(fn) {
+        super();
+        this.fn = fn;
+    }
+    onEvent(event) {
+        return this.emit(this.fn(event));
+    }
+}
+exports.default = FunctionMapper;

package/dist/cjs/tools/InputFilter/InputMapper.d.ts

@@ -0,0 +1,23 @@
+import { InputEvt } from '../../inputEvents';
+type OnEventCallback = (event: InputEvt) => boolean;
+export interface InputEventListener {
+    onEvent: OnEventCallback;
+}
+/**
+ * Accepts input events and emits input events.
+ */
+export default abstract class InputMapper implements InputEventListener {
+    #private;
+    constructor();
+    setEmitListener(listener: InputEventListener | OnEventCallback | null): void;
+    protected emit(event: InputEvt): boolean;
+    /**
+     * @returns true if the given `event` should be considered "handled" by the app and thus not
+     * forwarded to other targets. For example, returning "true" for a touchpad pinch event prevents
+     * the pinch event from zooming the webpage.
+     *
+     * Generally, this should return the result of calling `this.emit` with some event.
+     */
+    abstract onEvent(event: InputEvt): boolean;
+}
+export {};

package/dist/cjs/tools/InputFilter/InputMapper.js

@@ -0,0 +1,38 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _InputMapper_listener;
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Accepts input events and emits input events.
+ */
+class InputMapper {
+    constructor() {
+        _InputMapper_listener.set(this, null);
+    }
+    // @internal
+    setEmitListener(listener) {
+        if (listener && typeof (listener) === 'object') {
+            __classPrivateFieldSet(this, _InputMapper_listener, (event) => {
+                return listener.onEvent(event) ?? false;
+            }, "f");
+        }
+        else {
+            __classPrivateFieldSet(this, _InputMapper_listener, listener, "f");
+        }
+    }
+    emit(event) {
+        return __classPrivateFieldGet(this, _InputMapper_listener, "f")?.call(this, event) ?? false;
+    }
+}
+_InputMapper_listener = new WeakMap();
+exports.default = InputMapper;

package/dist/cjs/tools/InputFilter/InputPipeline.d.ts

@@ -0,0 +1,15 @@
+import { InputEvt } from '../../inputEvents';
+import InputMapper from './InputMapper';
+/**
+ * The composition of multiple `InputMapper`s.
+ */
+export default class InputPipeline extends InputMapper {
+    #private;
+    onEvent(event: InputEvt): boolean;
+    /**
+     * Adds a new `InputMapper` to the *tail* of this pipeline.
+     * Note that an instance of an `InputMapper` can only be used in a single
+     * pipeline.
+     */
+    addToTail(mapper: InputMapper): void;
+}

package/dist/cjs/tools/InputFilter/InputPipeline.js

@@ -0,0 +1,54 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _InputPipeline_head, _InputPipeline_tail;
+Object.defineProperty(exports, "__esModule", { value: true });
+const InputMapper_1 = __importDefault(require("./InputMapper"));
+/**
+ * The composition of multiple `InputMapper`s.
+ */
+class InputPipeline extends InputMapper_1.default {
+    constructor() {
+        super(...arguments);
+        _InputPipeline_head.set(this, null);
+        _InputPipeline_tail.set(this, null);
+    }
+    onEvent(event) {
+        if (__classPrivateFieldGet(this, _InputPipeline_head, "f") === null) {
+            return this.emit(event);
+        }
+        else {
+            return __classPrivateFieldGet(this, _InputPipeline_head, "f").onEvent(event);
+        }
+    }
+    /**
+     * Adds a new `InputMapper` to the *tail* of this pipeline.
+     * Note that an instance of an `InputMapper` can only be used in a single
+     * pipeline.
+     */
+    addToTail(mapper) {
+        if (!__classPrivateFieldGet(this, _InputPipeline_tail, "f")) {
+            __classPrivateFieldSet(this, _InputPipeline_head, mapper, "f");
+            __classPrivateFieldSet(this, _InputPipeline_tail, __classPrivateFieldGet(this, _InputPipeline_head, "f"), "f");
+        }
+        else {
+            __classPrivateFieldGet(this, _InputPipeline_tail, "f").setEmitListener(mapper);
+            __classPrivateFieldSet(this, _InputPipeline_tail, mapper, "f");
+        }
+        __classPrivateFieldGet(this, _InputPipeline_tail, "f").setEmitListener(event => this.emit(event));
+    }
+}
+_InputPipeline_head = new WeakMap(), _InputPipeline_tail = new WeakMap();
+exports.default = InputPipeline;

package/dist/cjs/tools/InputFilter/InputPipeline.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/tools/InputFilter/InputStabilizer.d.ts

@@ -0,0 +1,29 @@
+import { InputEvt } from '../../inputEvents';
+import InputMapper from './InputMapper';
+import Viewport from '../../Viewport';
+import Editor from '../../Editor';
+declare enum StabilizerType {
+    IntertialStabilizer = 0
+}
+interface InputStabilizerOptions {
+    kind: StabilizerType.IntertialStabilizer;
+    mass: number;
+    springConstant: number;
+    frictionCoefficient: number;
+    maxPointDist: number;
+    minSimilarityToFinalize: number;
+    inertiaFraction: number;
+    velocityDecayFactor: number;
+}
+export default class InputStabilizer extends InputMapper {
+    private viewport;
+    private readonly options;
+    private stabilizer;
+    private lastPointerEvent;
+    constructor(viewport: Viewport, options?: InputStabilizerOptions);
+    private mapPointerEvent;
+    private emitPointerMove;
+    onEvent(event: InputEvt): boolean;
+    static fromEditor(editor: Editor): InputStabilizer;
+}
+export {};

package/dist/cjs/tools/InputFilter/InputStabilizer.js

@@ -0,0 +1,181 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const inputEvents_1 = require("../../inputEvents");
+const InputMapper_1 = __importDefault(require("./InputMapper"));
+const math_1 = require("@js-draw/math");
+const untilNextAnimationFrame_1 = __importDefault(require("../../util/untilNextAnimationFrame"));
+var StabilizerType;
+(function (StabilizerType) {
+    StabilizerType[StabilizerType["IntertialStabilizer"] = 0] = "IntertialStabilizer";
+})(StabilizerType || (StabilizerType = {}));
+const defaultOptions = {
+    kind: StabilizerType.IntertialStabilizer,
+    mass: 0.4, // kg
+    springConstant: 100.0, // N/m
+    frictionCoefficient: 0.28,
+    maxPointDist: 10, // screen units
+    inertiaFraction: 0.75,
+    minSimilarityToFinalize: 0.0,
+    velocityDecayFactor: 0.1,
+};
+// Stabilizes input for a single cursor
+class StylusInputStabilizer {
+    constructor(
+    // The initial starting point of the pointer.
+    start, 
+    // Emits a pointer motion event, returns true if the event was handled.
+    updatePointer, options) {
+        this.updatePointer = updatePointer;
+        this.options = options;
+        this.runLoop = true;
+        this.lastUpdateTime = 0;
+        this.velocity = math_1.Vec2.zero;
+        this.strokePoint = start;
+        this.targetPoint = start;
+        this.targetInterval = 10; // ms
+        void this.loop();
+    }
+    async loop() {
+        this.lastUpdateTime = performance.now();
+        while (this.runLoop) {
+            this.update(false);
+            await (0, untilNextAnimationFrame_1.default)();
+        }
+    }
+    setTarget(point) {
+        this.targetPoint = point;
+    }
+    getNextVelocity(deltaTimeMs) {
+        const toTarget = this.targetPoint.minus(this.strokePoint);
+        const springForce = toTarget.times(this.options.springConstant);
+        const gravityAccel = 10;
+        const normalForceMagnitude = this.options.mass * gravityAccel;
+        const frictionForce = this.velocity.normalizedOrZero().times(-this.options.frictionCoefficient * normalForceMagnitude);
+        const acceleration = (springForce.plus(frictionForce)).times(1 / this.options.mass);
+        const decayFactor = this.options.velocityDecayFactor;
+        const springVelocity = this.velocity.times(1 - decayFactor).plus(acceleration.times(deltaTimeMs / 1000));
+        // An alternate velocity that goes directly towards the target.
+        const toTargetVelocity = toTarget.normalizedOrZero().times(springVelocity.length());
+        return toTargetVelocity.lerp(springVelocity, this.options.inertiaFraction);
+    }
+    update(force) {
+        const nowTime = performance.now();
+        const deltaTime = nowTime - this.lastUpdateTime;
+        const reachedTarget = this.strokePoint.eq(this.targetPoint);
+        if (deltaTime > this.targetInterval || force) {
+            if (!reachedTarget) {
+                let velocity;
+                let deltaX;
+                let parts = 1;
+                do {
+                    velocity = this.getNextVelocity(deltaTime / parts);
+                    deltaX = velocity.times(deltaTime / 1000);
+                    parts++;
+                } while (deltaX.magnitude() > this.options.maxPointDist && parts < 10);
+                for (let i = 0; i < parts; i++) {
+                    this.velocity = this.getNextVelocity(deltaTime / parts);
+                    deltaX = this.velocity.times(deltaTime / 1000);
+                    this.strokePoint = this.strokePoint.plus(deltaX);
+                    // Allows the last updatePointer to be returned.
+                    if (i < parts - 1) {
+                        this.updatePointer(this.strokePoint, nowTime);
+                    }
+                }
+            }
+            // Even if we have reached the target, ensure that lastUpdateTime is updated
+            // (prevent large deltaTime).
+            this.lastUpdateTime = nowTime;
+            if (force || !reachedTarget) {
+                return this.updatePointer(this.strokePoint, nowTime);
+            }
+        }
+        return false;
+    }
+    /** Finalizes the current stroke. */
+    finish() {
+        this.runLoop = false;
+        const toTarget = this.targetPoint.minus(this.strokePoint);
+        if (this.velocity.dot(toTarget) > this.options.minSimilarityToFinalize) {
+            // Connect the stroke to its end point
+            this.updatePointer(this.targetPoint, performance.now());
+        }
+    }
+    cancel() {
+        this.runLoop = false;
+    }
+}
+class InputStabilizer extends InputMapper_1.default {
+    constructor(viewport, options = defaultOptions) {
+        super();
+        this.viewport = viewport;
+        this.options = options;
+        this.stabilizer = null;
+        this.lastPointerEvent = null;
+    }
+    mapPointerEvent(event) {
+        // Don't store the last pointer event for use with pressure/button data --
+        // this information can be very different for a pointerup event.
+        if ((0, inputEvents_1.isPointerEvt)(event) && event.kind !== inputEvents_1.InputEvtType.PointerUpEvt) {
+            this.lastPointerEvent = event;
+        }
+        // Only apply smoothing if there is a single pointer.
+        if (event.kind === inputEvents_1.InputEvtType.GestureCancelEvt || event.allPointers.length > 1 || this.stabilizer === null) {
+            return this.emit(event);
+        }
+        this.stabilizer.setTarget(event.current.screenPos);
+        if (event.kind === inputEvents_1.InputEvtType.PointerMoveEvt) {
+            return this.stabilizer.update(true);
+        }
+        else if (event.kind === inputEvents_1.InputEvtType.PointerUpEvt) {
+            this.stabilizer.finish();
+            return this.emit(event);
+        }
+        else {
+            return this.emit(event);
+        }
+    }
+    // Assumes that there is exactly one pointer that is currently down.
+    emitPointerMove(screenPoint, timeStamp) {
+        if (!this.lastPointerEvent) {
+            return false;
+        }
+        const pointer = this.lastPointerEvent.current
+            .withScreenPosition(screenPoint, this.viewport)
+            .withTimestamp(timeStamp);
+        const event = {
+            kind: inputEvents_1.InputEvtType.PointerMoveEvt,
+            current: pointer,
+            allPointers: [pointer],
+        };
+        const handled = this.emit(event);
+        return handled;
+    }
+    onEvent(event) {
+        if ((0, inputEvents_1.isPointerEvt)(event) || event.kind === inputEvents_1.InputEvtType.GestureCancelEvt) {
+            if (event.kind === inputEvents_1.InputEvtType.PointerDownEvt) {
+                if (this.stabilizer === null) {
+                    this.stabilizer = new StylusInputStabilizer(event.current.screenPos, (screenPoint, timeStamp) => this.emitPointerMove(screenPoint, timeStamp), this.options);
+                }
+                else if (event.allPointers.length > 1) {
+                    // Do not attempt to stabilize multiple pointers.
+                    this.stabilizer.cancel();
+                    this.stabilizer = null;
+                }
+            }
+            const handled = this.mapPointerEvent(event);
+            if (event.kind === inputEvents_1.InputEvtType.PointerUpEvt || event.kind === inputEvents_1.InputEvtType.GestureCancelEvt) {
+                this.stabilizer?.cancel();
+                this.stabilizer = null;
+            }
+            return handled;
+        }
+        return this.emit(event);
+    }
+    static fromEditor(editor) {
+        return new InputStabilizer(editor.viewport);
+    }
+}
+exports.default = InputStabilizer;

package/dist/cjs/tools/InputFilter/StrokeKeyboardControl.d.ts

@@ -0,0 +1,21 @@
+import { InputEvt } from '../../inputEvents';
+import InputMapper from './InputMapper';
+import KeyboardShortcutManager from '../../shortcuts/KeyboardShortcutManager';
+import Viewport from '../../Viewport';
+import Editor from '../../Editor';
+/**
+ * Provides keyboard shortcuts that provide some amount of control over
+ * drawing (e.g. snap to grid, plane lock).
+ */
+export default class StrokeKeyboardControl extends InputMapper {
+    private shortcuts;
+    private viewport;
+    private snapToGridEnabled;
+    private angleLockEnabled;
+    private startPointCanvas;
+    constructor(shortcuts: KeyboardShortcutManager, viewport: Viewport);
+    private xyAxesSnap;
+    private mapPointerEvent;
+    onEvent(event: InputEvt): boolean;
+    static fromEditor(editor: Editor): StrokeKeyboardControl;
+}