js-draw 1.21.2 → 1.22.0

package/dist/cjs/tools/TextTool.js

@@ -0,0 +1,287 @@
+"use strict";
+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 EditorImage_1 = __importDefault(require("../image/EditorImage"));
+const math_1 = require("@js-draw/math");
+const Pointer_1 = require("../Pointer");
+const types_1 = require("../types");
+const BaseTool_1 = __importDefault(require("./BaseTool"));
+const Erase_1 = __importDefault(require("../commands/Erase"));
+const uniteCommands_1 = __importDefault(require("../commands/uniteCommands"));
+const ReactiveValue_1 = require("../util/ReactiveValue");
+const overlayCSSClass = 'textEditorOverlay';
+class TextTool extends BaseTool_1.default {
+    constructor(editor, description, localizationTable) {
+        super(editor.notifier, description);
+        this.editor = editor;
+        this.localizationTable = localizationTable;
+        this.textInputElem = null;
+        this.textTargetPosition = null;
+        this.textMeasuringCtx = null;
+        this.textScale = math_1.Vec2.of(1, 1);
+        this.removeExistingCommand = null;
+        const editorFonts = editor.getCurrentSettings().text?.fonts ?? [];
+        this.textStyleValue = ReactiveValue_1.ReactiveValue.fromInitialValue({
+            size: 32,
+            fontFamily: editorFonts.length > 0 ? editorFonts[0] : 'sans-serif',
+            renderingStyle: {
+                fill: math_1.Color4.purple,
+            },
+        });
+        this.textStyleValue.onUpdateAndNow(() => {
+            this.textStyle = this.textStyleValue.get();
+            this.updateTextInput();
+            this.editor.notifier.dispatch(types_1.EditorEventType.ToolUpdated, {
+                kind: types_1.EditorEventType.ToolUpdated,
+                tool: this,
+            });
+        });
+        this.textEditOverlay = document.createElement('div');
+        this.textEditOverlay.classList.add(overlayCSSClass);
+        this.editor.addStyleSheet(`
+			.${overlayCSSClass} {
+				height: 0;
+				overflow: visible;
+
+				/* Allows absolutely-positioned textareas to scroll with
+				   the containing overlay. */
+				position: relative;
+			}
+
+			.${overlayCSSClass} textarea {
+				background-color: rgba(0, 0, 0, 0);
+
+				white-space: pre;
+				overflow: hidden;
+
+				padding: 0;
+				margin: 0;
+				border: none;
+				padding: 0;
+
+				min-width: 100px;
+				min-height: 1.1em;
+			}
+		`);
+        this.editor.createHTMLOverlay(this.textEditOverlay);
+        this.editor.notifier.on(types_1.EditorEventType.ViewportChanged, () => this.updateTextInput());
+    }
+    initTextMeasuringCanvas() {
+        this.textMeasuringCtx ??= document.createElement('canvas').getContext('2d');
+    }
+    getTextAscent(text, style) {
+        this.initTextMeasuringCanvas();
+        if (this.textMeasuringCtx) {
+            this.textMeasuringCtx.textBaseline = 'alphabetic';
+            TextComponent_1.default.applyTextStyles(this.textMeasuringCtx, style);
+            const measurement = this.textMeasuringCtx.measureText(text);
+            return measurement.fontBoundingBoxAscent ?? measurement.actualBoundingBoxAscent;
+        }
+        // Estimate
+        return (style.size * 2) / 3;
+    }
+    // Take input from this' textInputElem and add it to the EditorImage.
+    // If [removeInput], the HTML input element is removed. Otherwise, its value
+    // is cleared.
+    flushInput(removeInput = true) {
+        if (this.textInputElem && this.textTargetPosition) {
+            const content = this.textInputElem.value.trimEnd();
+            this.textInputElem.value = '';
+            if (removeInput) {
+                // In some browsers, .remove() triggers a .blur event (synchronously).
+                // Clear this.textInputElem before removal
+                const input = this.textInputElem;
+                this.textInputElem = null;
+                input.remove();
+            }
+            if (content === '') {
+                return;
+            }
+            const textTransform = math_1.Mat33.translation(this.textTargetPosition)
+                .rightMul(this.getTextScaleMatrix())
+                .rightMul(math_1.Mat33.scaling2D(this.editor.viewport.getSizeOfPixelOnCanvas()))
+                .rightMul(math_1.Mat33.zRotation(this.textRotation));
+            const textComponent = TextComponent_1.default.fromLines(content.split('\n'), textTransform, this.textStyle);
+            const action = EditorImage_1.default.addElement(textComponent);
+            if (this.removeExistingCommand) {
+                // Unapply so that `removeExistingCommand` can be added to the undo stack.
+                this.removeExistingCommand.unapply(this.editor);
+                this.editor.dispatch((0, uniteCommands_1.default)([this.removeExistingCommand, action]));
+                this.removeExistingCommand = null;
+            }
+            else {
+                this.editor.dispatch(action);
+            }
+        }
+    }
+    getTextScaleMatrix() {
+        return math_1.Mat33.scaling2D(this.textScale.times(1 / this.editor.viewport.getSizeOfPixelOnCanvas()));
+    }
+    updateTextInput() {
+        if (!this.textInputElem || !this.textTargetPosition) {
+            this.textInputElem?.remove();
+            return;
+        }
+        const viewport = this.editor.viewport;
+        const textScreenPos = viewport.canvasToScreen(this.textTargetPosition);
+        this.textInputElem.placeholder = this.localizationTable.enterTextToInsert;
+        this.textInputElem.style.fontFamily = this.textStyle.fontFamily;
+        this.textInputElem.style.fontStyle = this.textStyle.fontStyle ?? '';
+        this.textInputElem.style.fontVariant = this.textStyle.fontVariant ?? '';
+        this.textInputElem.style.fontWeight = this.textStyle.fontWeight ?? '';
+        this.textInputElem.style.fontSize = `${this.textStyle.size}px`;
+        this.textInputElem.style.color = this.textStyle.renderingStyle.fill.toHexString();
+        this.textInputElem.style.position = 'absolute';
+        this.textInputElem.style.left = `${textScreenPos.x}px`;
+        this.textInputElem.style.top = `${textScreenPos.y}px`;
+        this.textInputElem.style.margin = '0';
+        this.textInputElem.style.width = `${this.textInputElem.scrollWidth}px`;
+        this.textInputElem.style.height = `${this.textInputElem.scrollHeight}px`;
+        // Get the ascent based on the font, using a string of characters
+        // that is tall in most fonts.
+        const tallText = 'Testing!';
+        const ascent = this.getTextAscent(tallText, this.textStyle);
+        const vertAdjust = ascent;
+        const rotation = this.textRotation + viewport.getRotationAngle();
+        const scale = this.getTextScaleMatrix();
+        this.textInputElem.style.transform = `${scale.toCSSMatrix()} rotate(${(rotation * 180) / Math.PI}deg) translate(0, ${-vertAdjust}px)`;
+        this.textInputElem.style.transformOrigin = 'top left';
+        // Match the line height of default rendered text.
+        const lineHeight = Math.floor(this.textStyle.size);
+        this.textInputElem.style.lineHeight = `${lineHeight}px`;
+    }
+    startTextInput(textCanvasPos, initialText) {
+        this.flushInput();
+        this.textInputElem = document.createElement('textarea');
+        this.textInputElem.value = initialText;
+        this.textInputElem.style.display = 'inline-block';
+        this.textTargetPosition = this.editor.viewport.roundPoint(textCanvasPos);
+        this.textRotation = -this.editor.viewport.getRotationAngle();
+        this.textScale = math_1.Vec2.of(1, 1).times(this.editor.viewport.getSizeOfPixelOnCanvas());
+        this.updateTextInput();
+        // Update the input size/position/etc. after the placeHolder has had time to appear.
+        setTimeout(() => this.updateTextInput(), 0);
+        this.textInputElem.oninput = () => {
+            if (this.textInputElem) {
+                this.textInputElem.style.width = `${this.textInputElem.scrollWidth}px`;
+                this.textInputElem.style.height = `${this.textInputElem.scrollHeight}px`;
+            }
+        };
+        this.textInputElem.onblur = () => {
+            // Delay removing the input -- flushInput may be called within a blur()
+            // event handler
+            const removeInput = false;
+            const input = this.textInputElem;
+            this.flushInput(removeInput);
+            this.textInputElem = null;
+            setTimeout(() => {
+                input?.remove();
+            }, 0);
+        };
+        this.textInputElem.onkeyup = (evt) => {
+            if (evt.key === 'Enter' && !evt.shiftKey) {
+                this.flushInput();
+                this.editor.focus();
+            }
+            else if (evt.key === 'Escape') {
+                // Cancel input.
+                this.textInputElem?.remove();
+                this.textInputElem = null;
+                this.editor.focus();
+                this.removeExistingCommand?.unapply(this.editor);
+                this.removeExistingCommand = null;
+            }
+        };
+        this.textEditOverlay.replaceChildren(this.textInputElem);
+        setTimeout(() => this.textInputElem?.focus(), 0);
+    }
+    setEnabled(enabled) {
+        super.setEnabled(enabled);
+        if (!this.isEnabled()) {
+            this.flushInput();
+        }
+        this.textEditOverlay.style.display = enabled ? 'block' : 'none';
+    }
+    onPointerDown({ current, allPointers }) {
+        if (current.device === Pointer_1.PointerDevice.Eraser) {
+            return false;
+        }
+        if (allPointers.length === 1) {
+            // Are we clicking on a text node?
+            const canvasPos = current.canvasPos;
+            const halfTestRegionSize = math_1.Vec2.of(2.5, 2.5).times(this.editor.viewport.getSizeOfPixelOnCanvas());
+            const testRegion = math_1.Rect2.fromCorners(canvasPos.minus(halfTestRegionSize), canvasPos.plus(halfTestRegionSize));
+            const targetNodes = this.editor.image.getElementsIntersectingRegion(testRegion);
+            let targetTextNodes = targetNodes.filter((node) => node instanceof TextComponent_1.default);
+            // Don't try to edit text nodes that contain the viewport (this allows us
+            // to zoom in on text nodes and add text on top of them.)
+            const visibleRect = this.editor.viewport.visibleRect;
+            targetTextNodes = targetTextNodes.filter((node) => !node.getBBox().containsRect(visibleRect));
+            // End any TextNodes we're currently editing.
+            this.flushInput();
+            if (targetTextNodes.length > 0) {
+                const targetNode = targetTextNodes[targetTextNodes.length - 1];
+                this.setTextStyle(targetNode.getTextStyle());
+                // Create and temporarily apply removeExistingCommand.
+                this.removeExistingCommand = new Erase_1.default([targetNode]);
+                this.removeExistingCommand.apply(this.editor);
+                this.startTextInput(targetNode.getBaselinePos(), targetNode.getText());
+                const transform = targetNode.getTransform();
+                this.textRotation = transform.transformVec3(math_1.Vec2.unitX).angle();
+                const scaleFactor = transform.transformVec3(math_1.Vec2.unitX).magnitude();
+                this.textScale = math_1.Vec2.of(1, 1).times(scaleFactor);
+                this.updateTextInput();
+            }
+            else {
+                this.removeExistingCommand = null;
+                this.startTextInput(current.canvasPos, '');
+            }
+            return true;
+        }
+        return false;
+    }
+    onGestureCancel() {
+        this.flushInput();
+        this.editor.focus();
+    }
+    setFontFamily(fontFamily) {
+        if (fontFamily !== this.textStyle.fontFamily) {
+            this.textStyleValue.set({
+                ...this.textStyle,
+                fontFamily: fontFamily,
+            });
+        }
+    }
+    setColor(color) {
+        if (!color.eq(this.textStyle.renderingStyle.fill)) {
+            this.textStyleValue.set({
+                ...this.textStyle,
+                renderingStyle: {
+                    ...this.textStyle.renderingStyle,
+                    fill: color,
+                },
+            });
+        }
+    }
+    setFontSize(size) {
+        if (size !== this.textStyle.size) {
+            this.textStyleValue.set({
+                ...this.textStyle,
+                size,
+            });
+        }
+    }
+    getTextStyle() {
+        return this.textStyle;
+    }
+    getStyleValue() {
+        return this.textStyleValue;
+    }
+    setTextStyle(style) {
+        this.textStyleValue.set(style);
+    }
+}
+exports.default = TextTool;

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

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

package/dist/cjs/tools/ToolController.d.ts

@@ -0,0 +1,73 @@
+import Editor from '../Editor';
+import BaseTool from './BaseTool';
+import ToolEnabledGroup from './ToolEnabledGroup';
+import { ToolLocalization } from './localization';
+import InputMapper, { InputEventListener } from './InputFilter/InputMapper';
+import { InputEvt } from '../inputEvents';
+export default class ToolController implements InputEventListener {
+    private tools;
+    private activeTool;
+    private primaryToolGroup;
+    private inputPipeline;
+    private isEditorReadOnly;
+    /** @internal */
+    constructor(editor: Editor, localization: ToolLocalization);
+    /**
+     * Replaces the current set of tools with `tools`. This should only be done before
+     * the creation of the app's toolbar (if using `AbstractToolbar`).
+     *
+     * If no `primaryToolGroup` is given, an empty one will be created.
+     */
+    setTools(tools: BaseTool[], primaryToolGroup?: ToolEnabledGroup): void;
+    /**
+     * Add a tool that acts like one of the primary tools (only one primary tool can be enabled at a time).
+     *
+     * If the tool is already added to this, the tool is converted to a primary tool.
+     *
+     * This should be called before creating the app's toolbar.
+     */
+    addPrimaryTool(tool: BaseTool): void;
+    getPrimaryTools(): BaseTool[];
+    /**
+     * Add a tool to the end of this' tool list (the added tool receives events after tools already added to this).
+     * This should be called before creating the app's toolbar.
+     *
+     * If `options.addToFront`, the tool is added to the beginning of this' tool list.
+     *
+     * Does nothing if the tool is already present.
+     */
+    addTool(tool: BaseTool, options?: {
+        addToFront: boolean;
+    }): void;
+    /**
+     * Removes **and destroys** all tools in `tools` from this.
+     */
+    removeAndDestroyTools(tools: BaseTool[]): void;
+    private insertTools;
+    /**
+     * Removes a tool from this' tool list and replaces it with `replaceWith`.
+     *
+     * If any of `toolsToInsert` have already been added to this, the tools are
+     * moved.
+     *
+     * This should be called before creating the editor's toolbar.
+     */
+    insertToolsAfter(insertAfter: BaseTool, toolsToInsert: BaseTool[]): void;
+    /** @see {@link insertToolsAfter} */
+    insertToolsBefore(insertBefore: BaseTool, toolsToInsert: BaseTool[]): void;
+    private onEventInternal;
+    /** Alias for {@link dispatchInputEvent}. */
+    onEvent(event: InputEvt): boolean;
+    dispatchInputEvent(event: InputEvt): boolean;
+    /**
+     * Adds a new `InputMapper` to this' input pipeline.
+     *
+     * A `mapper` is really a relation that maps each event to no, one,
+     * or many other events.
+     *
+     * @see {@link InputMapper}.
+     */
+    addInputMapper(mapper: InputMapper): void;
+    getMatchingTools<Type extends BaseTool>(type: new (...args: any[]) => Type): Type[];
+    onEditorDestroyed(): void;
+}

package/dist/cjs/tools/ToolController.js

@@ -0,0 +1,310 @@
+"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 types_1 = require("../types");
+const math_1 = require("@js-draw/math");
+const PanZoom_1 = __importStar(require("./PanZoom"));
+const Pen_1 = __importDefault(require("./Pen"));
+const ToolEnabledGroup_1 = __importDefault(require("./ToolEnabledGroup"));
+const Eraser_1 = __importDefault(require("./Eraser"));
+const SelectionTool_1 = __importDefault(require("./SelectionTool/SelectionTool"));
+const UndoRedoShortcut_1 = __importDefault(require("./UndoRedoShortcut"));
+const TextTool_1 = __importDefault(require("./TextTool"));
+const PipetteTool_1 = __importDefault(require("./PipetteTool"));
+const ToolSwitcherShortcut_1 = __importDefault(require("./ToolSwitcherShortcut"));
+const PasteHandler_1 = __importDefault(require("./PasteHandler"));
+const ToolbarShortcutHandler_1 = __importDefault(require("./ToolbarShortcutHandler"));
+const PressureSensitiveFreehandLineBuilder_1 = require("../components/builders/PressureSensitiveFreehandLineBuilder");
+const FindTool_1 = __importDefault(require("./FindTool"));
+const SelectAllShortcutHandler_1 = __importDefault(require("./SelectionTool/SelectAllShortcutHandler"));
+const SoundUITool_1 = __importDefault(require("./SoundUITool"));
+const inputEvents_1 = require("../inputEvents");
+const InputPipeline_1 = __importDefault(require("./InputFilter/InputPipeline"));
+const InputStabilizer_1 = __importDefault(require("./InputFilter/InputStabilizer"));
+const ScrollbarTool_1 = __importDefault(require("./ScrollbarTool"));
+class ToolController {
+    /** @internal */
+    constructor(editor, localization) {
+        this.activeTool = null;
+        this.isEditorReadOnly = editor.isReadOnlyReactiveValue();
+        this.inputPipeline = new InputPipeline_1.default();
+        this.inputPipeline.setEmitListener((event) => this.onEventInternal(event));
+        const primaryToolGroup = new ToolEnabledGroup_1.default();
+        this.primaryToolGroup = primaryToolGroup;
+        const panZoomTool = new PanZoom_1.default(editor, PanZoom_1.PanZoomMode.TwoFingerTouchGestures | PanZoom_1.PanZoomMode.RightClickDrags, localization.touchPanTool);
+        const keyboardPanZoomTool = new PanZoom_1.default(editor, PanZoom_1.PanZoomMode.Keyboard, localization.keyboardPanZoom);
+        const primaryPenTool = new Pen_1.default(editor, localization.penTool(1), {
+            color: math_1.Color4.purple,
+            thickness: 8,
+        });
+        const secondaryPenTool = new Pen_1.default(editor, localization.penTool(2), {
+            color: math_1.Color4.clay,
+            thickness: 4,
+        });
+        // Stabilize the secondary pen tool.
+        secondaryPenTool.setInputMapper(new InputStabilizer_1.default(editor.viewport));
+        const eraser = new Eraser_1.default(editor, localization.eraserTool);
+        const primaryTools = [
+            // Three pens
+            primaryPenTool,
+            secondaryPenTool,
+            // Highlighter-like pen with width=40
+            new Pen_1.default(editor, localization.penTool(3), {
+                color: math_1.Color4.ofRGBA(1, 1, 0, 0.5),
+                thickness: 40,
+                factory: PressureSensitiveFreehandLineBuilder_1.makePressureSensitiveFreehandLineBuilder,
+            }),
+            eraser,
+            new SelectionTool_1.default(editor, localization.selectionTool),
+            new TextTool_1.default(editor, localization.textTool, localization),
+            new PanZoom_1.default(editor, PanZoom_1.PanZoomMode.SinglePointerGestures, localization.anyDevicePanning),
+        ];
+        // Accessibility tools
+        const soundExplorer = new SoundUITool_1.default(editor, localization.soundExplorer);
+        soundExplorer.setEnabled(false);
+        this.tools = [
+            new ScrollbarTool_1.default(editor),
+            new PipetteTool_1.default(editor, localization.pipetteTool),
+            soundExplorer,
+            panZoomTool,
+            ...primaryTools,
+            keyboardPanZoomTool,
+            new UndoRedoShortcut_1.default(editor),
+            new ToolbarShortcutHandler_1.default(editor),
+            new ToolSwitcherShortcut_1.default(editor),
+            eraser.makeEraserSwitcherTool(),
+            new FindTool_1.default(editor),
+            new PasteHandler_1.default(editor),
+            new SelectAllShortcutHandler_1.default(editor),
+        ];
+        primaryTools.forEach((tool) => tool.setToolGroup(primaryToolGroup));
+        panZoomTool.setEnabled(true);
+        primaryPenTool.setEnabled(true);
+        editor.notifier.on(types_1.EditorEventType.ToolEnabled, (event) => {
+            if (event.kind === types_1.EditorEventType.ToolEnabled) {
+                editor.announceForAccessibility(localization.toolEnabledAnnouncement(event.tool.description));
+            }
+        });
+        editor.notifier.on(types_1.EditorEventType.ToolDisabled, (event) => {
+            if (event.kind === types_1.EditorEventType.ToolDisabled) {
+                editor.announceForAccessibility(localization.toolDisabledAnnouncement(event.tool.description));
+            }
+        });
+        this.activeTool = null;
+    }
+    /**
+     * Replaces the current set of tools with `tools`. This should only be done before
+     * the creation of the app's toolbar (if using `AbstractToolbar`).
+     *
+     * If no `primaryToolGroup` is given, an empty one will be created.
+     */
+    setTools(tools, primaryToolGroup) {
+        this.tools = tools;
+        this.primaryToolGroup = primaryToolGroup ?? new ToolEnabledGroup_1.default();
+    }
+    /**
+     * Add a tool that acts like one of the primary tools (only one primary tool can be enabled at a time).
+     *
+     * If the tool is already added to this, the tool is converted to a primary tool.
+     *
+     * This should be called before creating the app's toolbar.
+     */
+    addPrimaryTool(tool) {
+        tool.setToolGroup(this.primaryToolGroup);
+        if (tool.isEnabled()) {
+            this.primaryToolGroup.notifyEnabled(tool);
+        }
+        if (!this.tools.includes(tool)) {
+            this.addTool(tool);
+        }
+    }
+    getPrimaryTools() {
+        return this.tools.filter((tool) => {
+            return tool.getToolGroup() === this.primaryToolGroup;
+        });
+    }
+    /**
+     * Add a tool to the end of this' tool list (the added tool receives events after tools already added to this).
+     * This should be called before creating the app's toolbar.
+     *
+     * If `options.addToFront`, the tool is added to the beginning of this' tool list.
+     *
+     * Does nothing if the tool is already present.
+     */
+    addTool(tool, options) {
+        // Only add if not already present.
+        if (!this.tools.includes(tool)) {
+            if (options?.addToFront) {
+                this.tools.splice(0, 0, tool);
+            }
+            else {
+                this.tools.push(tool);
+            }
+        }
+    }
+    /**
+     * Removes **and destroys** all tools in `tools` from this.
+     */
+    removeAndDestroyTools(tools) {
+        const newTools = [];
+        for (const tool of this.tools) {
+            if (tools.includes(tool)) {
+                if (this.activeTool === tool) {
+                    this.activeTool = null;
+                }
+                tool.onDestroy();
+            }
+            else {
+                newTools.push(tool);
+            }
+        }
+        this.tools = newTools;
+    }
+    insertTools(insertNear, toolsToInsert, mode) {
+        this.tools = this.tools.filter((tool) => !toolsToInsert.includes(tool));
+        const newTools = [];
+        for (const tool of this.tools) {
+            if (mode === 'after') {
+                newTools.push(tool);
+            }
+            if (tool === insertNear) {
+                newTools.push(...toolsToInsert);
+            }
+            if (mode === 'before') {
+                newTools.push(tool);
+            }
+        }
+        this.tools = newTools;
+    }
+    /**
+     * Removes a tool from this' tool list and replaces it with `replaceWith`.
+     *
+     * If any of `toolsToInsert` have already been added to this, the tools are
+     * moved.
+     *
+     * This should be called before creating the editor's toolbar.
+     */
+    insertToolsAfter(insertAfter, toolsToInsert) {
+        this.insertTools(insertAfter, toolsToInsert, 'after');
+    }
+    /** @see {@link insertToolsAfter} */
+    insertToolsBefore(insertBefore, toolsToInsert) {
+        this.insertTools(insertBefore, toolsToInsert, 'before');
+    }
+    // @internal use `dispatchEvent` rather than calling `onEvent` directly.
+    onEventInternal(event) {
+        const isEditorReadOnly = this.isEditorReadOnly.get();
+        const canToolReceiveInput = (tool) => {
+            return tool.isEnabled() && (!isEditorReadOnly || tool.canReceiveInputInReadOnlyEditor());
+        };
+        let handled = false;
+        if (event.kind === inputEvents_1.InputEvtType.PointerDownEvt) {
+            let canOnlySendToActiveTool = false;
+            if (this.activeTool && !this.activeTool.eventCanBeDeliveredToNonActiveTool(event)) {
+                canOnlySendToActiveTool = true;
+            }
+            for (const tool of this.tools) {
+                if (canOnlySendToActiveTool && tool !== this.activeTool) {
+                    continue;
+                }
+                if (canToolReceiveInput(tool) && tool.onEvent(event)) {
+                    if (this.activeTool !== tool) {
+                        this.activeTool?.onEvent({ kind: inputEvents_1.InputEvtType.GestureCancelEvt });
+                    }
+                    this.activeTool = tool;
+                    handled = true;
+                    break;
+                }
+            }
+        }
+        else if (event.kind === inputEvents_1.InputEvtType.PointerUpEvt) {
+            const upResult = this.activeTool?.onEvent(event);
+            const continueHandlingEvents = upResult && event.allPointers.length > 1;
+            // Should the active tool continue handling events (without an additional pointer down?)
+            if (!continueHandlingEvents) {
+                // No -- Remove the current tool
+                this.activeTool = null;
+            }
+            handled = true;
+        }
+        else if (event.kind === inputEvents_1.InputEvtType.PointerMoveEvt) {
+            if (this.activeTool !== null) {
+                this.activeTool.onEvent(event);
+                handled = true;
+            }
+        }
+        else if (event.kind === inputEvents_1.InputEvtType.GestureCancelEvt) {
+            if (this.activeTool !== null) {
+                this.activeTool.onEvent(event);
+                this.activeTool = null;
+            }
+        }
+        else {
+            for (const tool of this.tools) {
+                if (!canToolReceiveInput(tool)) {
+                    continue;
+                }
+                handled = tool.onEvent(event);
+                if (handled) {
+                    break;
+                }
+            }
+        }
+        return handled;
+    }
+    /** Alias for {@link dispatchInputEvent}. */
+    onEvent(event) {
+        return this.dispatchInputEvent(event);
+    }
+    // Returns true if the event was handled.
+    dispatchInputEvent(event) {
+        // Feed the event through the input pipeline
+        return this.inputPipeline.onEvent(event);
+    }
+    /**
+     * Adds a new `InputMapper` to this' input pipeline.
+     *
+     * A `mapper` is really a relation that maps each event to no, one,
+     * or many other events.
+     *
+     * @see {@link InputMapper}.
+     */
+    addInputMapper(mapper) {
+        this.inputPipeline.addToTail(mapper);
+    }
+    getMatchingTools(type) {
+        return this.tools.filter((tool) => tool instanceof type);
+    }
+    // @internal
+    onEditorDestroyed() {
+        for (const tool of this.tools) {
+            tool.onDestroy();
+        }
+    }
+}
+exports.default = ToolController;

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

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

package/dist/cjs/tools/ToolEnabledGroup.d.ts

@@ -0,0 +1,6 @@
+import BaseTool from './BaseTool';
+export default class ToolEnabledGroup {
+    private activeTool;
+    constructor();
+    notifyEnabled(tool: BaseTool): void;
+}