js-draw 1.18.0 → 1.19.1

package/dist/mjs/toolbar/widgets/components/makeSnappedList.mjs

@@ -0,0 +1,98 @@
+import  stopPropagationOfScrollingWheelEvents  from '../../../util/stopPropagationOfScrollingWheelEvents.mjs';
+import  { MutableReactiveValue, ReactiveValue }  from '../../../util/ReactiveValue.mjs';
+/**
+ * Creates a list that snaps to each item and reports the selected item.
+ */
+const makeSnappedList = (itemsValue) => {
+    const container = document.createElement('div');
+    container.classList.add('toolbar-snapped-scroll-list');
+    const visibleIndex = MutableReactiveValue.fromInitialValue(0);
+    let observer = null;
+    const createObserver = () => {
+        observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                if (entry.isIntersecting && entry.intersectionRatio > 0.7) {
+                    const indexString = entry.target.getAttribute('data-item-index');
+                    if (indexString === null)
+                        throw new Error('Could not find attribute data-item-index');
+                    const index = Number(indexString);
+                    visibleIndex.set(index);
+                    break;
+                }
+            }
+        }, {
+            // Element to use as the boudning box with which to intersect.
+            // See https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API
+            root: container,
+            // Fraction of an element that must be visible to trigger the callback:
+            threshold: 0.9,
+        });
+    };
+    const destroyObserver = () => {
+        if (observer) {
+            observer.disconnect();
+            visibleIndex.set(0);
+            observer = null;
+        }
+    };
+    const wrappedItems = ReactiveValue.map(itemsValue, items => {
+        return items.map((item, index) => {
+            const wrapper = document.createElement('div');
+            if (item.element.parentElement)
+                item.element.remove();
+            wrapper.appendChild(item.element);
+            wrapper.classList.add('item');
+            wrapper.setAttribute('data-item-index', `${index}`);
+            return {
+                element: wrapper,
+                data: item.data,
+            };
+        });
+    });
+    const lastItems = [];
+    wrappedItems.onUpdateAndNow(items => {
+        visibleIndex.set(-1);
+        for (const item of lastItems) {
+            observer?.unobserve(item.element);
+        }
+        container.replaceChildren();
+        // An observer is only necessary if there are multiple items to scroll through.
+        if (items.length > 1) {
+            createObserver();
+        }
+        else {
+            destroyObserver();
+        }
+        // Different styling is applied when empty
+        if (items.length === 0) {
+            container.classList.add('-empty');
+        }
+        else {
+            container.classList.remove('-empty');
+        }
+        for (const item of items) {
+            container.appendChild(item.element);
+        }
+        visibleIndex.set(0);
+        if (observer) {
+            for (const item of items) {
+                observer.observe(item.element);
+            }
+        }
+    });
+    const visibleItem = ReactiveValue.map(visibleIndex, index => {
+        const values = itemsValue.get();
+        if (0 <= index && index < values.length) {
+            return values[index].data;
+        }
+        return null;
+    });
+    // makeSnappedList is generally shown within the toolbar. This allows users to
+    // scroll it with a touchpad.
+    stopPropagationOfScrollingWheelEvents(container);
+    return {
+        container,
+        visibleItem,
+    };
+};
+export default makeSnappedList;

package/dist/mjs/tools/Eraser.d.ts

@@ -1,4 +1,4 @@
-import { KeyPressEvent, PointerEvt } from '../inputEvents';
+import { GestureCancelEvt, KeyPressEvent, PointerEvt } from '../inputEvents';
 import BaseTool from './BaseTool';
 import Editor from '../Editor';
 import { MutableReactiveValue } from '../util/ReactiveValue';
@@ -22,6 +22,11 @@ export default class Eraser extends BaseTool {
     private eraseCommands;
     private addCommands;
     constructor(editor: Editor, description: string, options?: InitialEraserOptions);
+    /**
+     * @returns a tool that briefly enables the eraser when a physical eraser is used.
+     * This tool should be added to the tool list after the primary tools.
+     */
+    makeEraserSwitcherTool(): BaseTool;
     private clearPreview;
     private getSizeOnCanvas;
     private drawPreviewAt;
@@ -36,7 +41,7 @@ export default class Eraser extends BaseTool {
     onPointerDown(event: PointerEvt): boolean;
     onPointerMove(event: PointerEvt): void;
     onPointerUp(event: PointerEvt): void;
-    onGestureCancel(): void;
+    onGestureCancel(_event: GestureCancelEvt): void;
     onKeyPress(event: KeyPressEvent): boolean;
     /** Returns the side-length of the tip of this eraser. */
     getThickness(): number;

package/dist/mjs/tools/Eraser.mjs

@@ -13,6 +13,52 @@ export var EraserMode;
     EraserMode["PartialStroke"] = "partial-stroke";
     EraserMode["FullStroke"] = "full-stroke";
 })(EraserMode || (EraserMode = {}));
+/** Handles switching from other primary tools to the eraser and back */
+class EraserSwitcher extends BaseTool {
+    constructor(editor, eraser) {
+        super(editor.notifier, editor.localization.changeTool);
+        this.editor = editor;
+        this.eraser = eraser;
+    }
+    onPointerDown(event) {
+        if (event.allPointers.length === 1 && event.current.device === PointerDevice.Eraser) {
+            const toolController = this.editor.toolController;
+            const enabledPrimaryTools = toolController.getPrimaryTools().filter(tool => tool.isEnabled());
+            if (enabledPrimaryTools.length) {
+                this.previousEnabledTool = enabledPrimaryTools[0];
+            }
+            else {
+                this.previousEnabledTool = null;
+            }
+            this.previousEraserEnabledState = this.eraser.isEnabled();
+            this.eraser.setEnabled(true);
+            if (this.eraser.onPointerDown(event)) {
+                return true;
+            }
+            else {
+                this.restoreOriginalTool();
+            }
+        }
+        return false;
+    }
+    onPointerMove(event) {
+        this.eraser.onPointerMove(event);
+    }
+    restoreOriginalTool() {
+        this.eraser.setEnabled(this.previousEraserEnabledState);
+        if (this.previousEnabledTool) {
+            this.previousEnabledTool.setEnabled(true);
+        }
+    }
+    onPointerUp(event) {
+        this.eraser.onPointerUp(event);
+        this.restoreOriginalTool();
+    }
+    onGestureCancel(event) {
+        this.eraser.onGestureCancel(event);
+        this.restoreOriginalTool();
+    }
+}
 export default class Eraser extends BaseTool {
     constructor(editor, description, options) {
         super(editor.notifier, description);
@@ -39,6 +85,13 @@ export default class Eraser extends BaseTool {
             });
         });
     }
+    /**
+     * @returns a tool that briefly enables the eraser when a physical eraser is used.
+     * This tool should be added to the tool list after the primary tools.
+     */
+    makeEraserSwitcherTool() {
+        return new EraserSwitcher(this.editor, this);
+    }
     clearPreview() {
         this.editor.clearWetInk();
     }
@@ -174,7 +227,7 @@ export default class Eraser extends BaseTool {
         }
         this.clearPreview();
     }
-    onGestureCancel() {
+    onGestureCancel(_event) {
         this.addCommands.forEach(cmd => cmd.unapply(this.editor));
         this.eraseCommands.forEach(cmd => cmd.unapply(this.editor));
         this.eraseCommands = [];

package/dist/mjs/tools/SelectionTool/Selection.d.ts

@@ -10,7 +10,7 @@ import AbstractComponent from '../../components/AbstractComponent';
 import Command from '../../commands/Command';
 export default class Selection {
     private editor;
-    private handles;
+    private childwidgets;
     private originalRegion;
     private selectionTightBoundingBox;
     private transformers;
@@ -52,7 +52,7 @@ export default class Selection {
     private removedFromImage;
     private addRemoveSelectionFromImage;
     private removeDeletedElemsFromSelection;
-    private targetHandle;
+    private activeHandle;
     private backgroundDragging;
     onDragStart(pointer: Pointer): boolean;
     onDragUpdate(pointer: Pointer): void;

package/dist/mjs/tools/SelectionTool/Selection.mjs

@@ -29,7 +29,7 @@ class Selection {
         this.hasParent = true;
         // Maps IDs to whether we removed the component from the image
         this.removedFromImage = {};
-        this.targetHandle = null;
+        this.activeHandle = null;
         this.backgroundDragging = false;
         this.selectionDuplicatedAnimationTimeout = null;
         this.originalRegion = new Rect2(startPoint.x, startPoint.y, 0, 0);
@@ -71,14 +71,14 @@ class Selection {
             side: Vec2.of(0.5, 0),
             icon: this.editor.icons.makeRotateIcon(),
         }, this, this.editor.viewport, (startPoint) => this.transformers.rotate.onDragStart(startPoint), (currentPoint) => this.transformers.rotate.onDragUpdate(currentPoint), () => this.transformers.rotate.onDragEnd());
-        this.handles = [
+        this.childwidgets = [
             resizeBothHandle,
             ...resizeHorizontalHandles,
             resizeVerticalHandle,
             rotationHandle,
         ];
-        for (const handle of this.handles) {
-            handle.addTo(this.backgroundElem);
+        for (const widget of this.childwidgets) {
+            widget.addTo(this.backgroundElem);
         }
         this.updateUI();
     }
@@ -293,8 +293,8 @@ class Selection {
         else {
             this.innerContainer.classList.remove('-empty');
         }
-        for (const handle of this.handles) {
-            handle.updatePosition();
+        for (const widget of this.childwidgets) {
+            widget.updatePosition(this.getScreenRegion());
         }
     }
     // Add/remove the contents of this seleciton from the editor.
@@ -348,16 +348,16 @@ class Selection {
     onDragStart(pointer) {
         // Clear the HTML selection (prevent HTML drag and drop being triggered by this drag)
         document.getSelection()?.removeAllRanges();
-        this.targetHandle = null;
+        this.activeHandle = null;
         let result = false;
         this.backgroundDragging = false;
         if (this.region.containsPoint(pointer.canvasPos)) {
             this.backgroundDragging = true;
             result = true;
         }
-        for (const handle of this.handles) {
-            if (handle.containsPoint(pointer.canvasPos)) {
-                this.targetHandle = handle;
+        for (const widget of this.childwidgets) {
+            if (widget.containsPoint(pointer.canvasPos)) {
+                this.activeHandle = widget;
                 this.backgroundDragging = false;
                 result = true;
             }
@@ -366,8 +366,8 @@ class Selection {
             this.removeDeletedElemsFromSelection();
             this.addRemoveSelectionFromImage(false);
         }
-        if (this.targetHandle) {
-            this.targetHandle.handleDragStart(pointer);
+        if (this.activeHandle) {
+            this.activeHandle.handleDragStart(pointer);
         }
         if (this.backgroundDragging) {
             this.transformers.drag.onDragStart(pointer.canvasPos);
@@ -378,25 +378,25 @@ class Selection {
         if (this.backgroundDragging) {
             this.transformers.drag.onDragUpdate(pointer.canvasPos);
         }
-        if (this.targetHandle) {
-            this.targetHandle.handleDragUpdate(pointer);
+        if (this.activeHandle) {
+            this.activeHandle.handleDragUpdate(pointer);
         }
     }
     onDragEnd() {
         if (this.backgroundDragging) {
             this.transformers.drag.onDragEnd();
         }
-        else if (this.targetHandle) {
-            this.targetHandle.handleDragEnd();
+        else if (this.activeHandle) {
+            this.activeHandle.handleDragEnd();
         }
         this.addRemoveSelectionFromImage(true);
         this.backgroundDragging = false;
-        this.targetHandle = null;
+        this.activeHandle = null;
         this.updateUI();
     }
     onDragCancel() {
         this.backgroundDragging = false;
-        this.targetHandle = null;
+        this.activeHandle = null;
         this.setTransform(Mat33.identity);
         this.addRemoveSelectionFromImage(true);
         this.updateUI();
@@ -424,7 +424,7 @@ class Selection {
         return false;
     }
     deleteSelectedObjects() {
-        if (this.backgroundDragging || this.targetHandle) {
+        if (this.backgroundDragging || this.activeHandle) {
             this.onDragEnd();
         }
         return new Erase(this.selectedElems);
@@ -441,7 +441,7 @@ class Selection {
         }, animationDuration);
     }
     async duplicateSelectedObjects() {
-        const wasTransforming = this.backgroundDragging || this.targetHandle;
+        const wasTransforming = this.backgroundDragging || this.activeHandle;
         let tmpApplyCommand = null;
         if (!wasTransforming) {
             this.runSelectionDuplicatedAnimation();

package/dist/mjs/tools/SelectionTool/SelectionHandle.d.ts

@@ -2,6 +2,7 @@ import { Point2, Vec2 } from '@js-draw/math';
 import Selection from './Selection';
 import Pointer from '../../Pointer';
 import Viewport from '../../Viewport';
+import { SelectionBoxChild } from './types';
 export declare enum HandleAction {
     ResizeXY = "resize-xy",
     Rotate = "rotate",
@@ -17,7 +18,7 @@ export declare const handleSize = 30;
 export type DragStartCallback = (startPoint: Point2) => void;
 export type DragUpdateCallback = (canvasPoint: Point2) => void;
 export type DragEndCallback = () => Promise<void> | void;
-export default class SelectionHandle {
+export default class SelectionHandle implements SelectionBoxChild {
     readonly presentation: HandlePresentation;
     private readonly parent;
     private readonly viewport;
@@ -34,6 +35,11 @@ export default class SelectionHandle {
      * element visible on the screen.
      */
     addTo(container: HTMLElement): void;
+    /**
+     * Removes this element from its container. Should only be called
+     * after {@link addTo}.
+     */
+    remove(): void;
     /**
      * Returns this handle's bounding box relative to the top left of the
      * selection box.
@@ -48,7 +54,7 @@ export default class SelectionHandle {
     /** @returns true iff `point` (in editor **canvas** coordinates) is in this. */
     containsPoint(point: Point2): boolean;
     private dragLastPos;
-    handleDragStart(pointer: Pointer): void;
+    handleDragStart(pointer: Pointer): boolean;
     handleDragUpdate(pointer: Pointer): void;
     handleDragEnd(): void | Promise<void>;
     setSnapToGrid(snap: boolean): void;

package/dist/mjs/tools/SelectionTool/SelectionHandle.mjs

@@ -61,6 +61,11 @@ export default class SelectionHandle {
     addTo(container) {
         container.appendChild(this.element);
     }
+    /**
+     * Removes this element from its container. Should only be called
+     * after {@link addTo}.
+     */
+    remove() { this.element.remove(); }
     /**
      * Returns this handle's bounding box relative to the top left of the
      * selection box.
@@ -109,6 +114,7 @@ export default class SelectionHandle {
     handleDragStart(pointer) {
         this.onDragStart(pointer.canvasPos);
         this.dragLastPos = pointer.canvasPos;
+        return true;
     }
     handleDragUpdate(pointer) {
         if (!this.dragLastPos) {

package/dist/mjs/tools/SelectionTool/SelectionTool.mjs

@@ -398,7 +398,7 @@ class SelectionTool extends BaseTool {
                     resolve(blob);
                 }
                 else {
-                    reject('Failed to convert canvas to blob.');
+                    reject(new Error('Failed to convert canvas to blob.'));
                 }
             }, 'image/png');
         }));

package/dist/mjs/tools/SelectionTool/types.d.ts

@@ -1,3 +1,5 @@
+import type { Rect2, Point2 } from '@js-draw/math';
+import Pointer from '../../Pointer';
 export declare enum ResizeMode {
     Both = 0,
     HorizontalOnly = 1,
@@ -7,3 +9,20 @@ export declare enum TransformMode {
     Snap = 0,
     NoSnap = 1
 }
+/**
+ * Represents a child of the selection that should move with the selection
+ * and handle events.
+ *
+ * Although selection children should be `HTMLElement`s, the selection may be
+ * hidden behind an invisible element. As such, these elements should handle
+ * drag start/update/end events.
+ */
+export interface SelectionBoxChild {
+    updatePosition(selectionScreenBBox: Rect2): void;
+    containsPoint(point: Point2): boolean;
+    addTo(container: HTMLElement): void;
+    remove(): void;
+    handleDragStart(pointer: Pointer): boolean;
+    handleDragUpdate(pointer: Pointer): void;
+    handleDragEnd(): void;
+}

package/dist/mjs/tools/TextTool.mjs

@@ -18,9 +18,10 @@ export default class TextTool extends BaseTool {
         this.textMeasuringCtx = null;
         this.textScale = Vec2.of(1, 1);
         this.removeExistingCommand = null;
+        const editorFonts = editor.getCurrentSettings().text?.fonts ?? [];
         this.textStyleValue = ReactiveValue.fromInitialValue({
             size: 32,
-            fontFamily: 'sans-serif',
+            fontFamily: editorFonts.length > 0 ? editorFonts[0] : 'sans-serif',
             renderingStyle: {
                 fill: Color4.purple,
             },

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

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

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

@@ -55,6 +55,8 @@ export default class ToolController implements InputEventListener {
     insertToolsAfter(insertAfter: BaseTool, toolsToInsert: BaseTool[]): void;
     /** @see {@link insertToolsAfter} */
     insertToolsBefore(insertBefore: BaseTool, toolsToInsert: BaseTool[]): void;
+    /** @internal */
+    changeActiveToolTo(tool: BaseTool): void;
     private onEventInternal;
     /** Alias for {@link dispatchInputEvent}. */
     onEvent(event: InputEvt): boolean;

package/dist/mjs/tools/ToolController.mjs

@@ -34,6 +34,7 @@ export default class ToolController {
         const secondaryPenTool = new Pen(editor, localization.penTool(2), { color: Color4.clay, thickness: 4 });
         // Stabilize the secondary pen tool.
         secondaryPenTool.setInputMapper(new InputStabilizer(editor.viewport));
+        const eraser = new Eraser(editor, localization.eraserTool);
         const primaryTools = [
             // Three pens
             primaryPenTool,
@@ -44,7 +45,7 @@ export default class ToolController {
                 thickness: 40,
                 factory: makePressureSensitiveFreehandLineBuilder
             }),
-            new Eraser(editor, localization.eraserTool),
+            eraser,
             new SelectionTool(editor, localization.selectionTool),
             new TextTool(editor, localization.textTool, localization),
             new PanZoom(editor, PanZoomMode.SinglePointerGestures, localization.anyDevicePanning),
@@ -62,6 +63,7 @@ export default class ToolController {
             new UndoRedoShortcut(editor),
             new ToolbarShortcutHandler(editor),
             new ToolSwitcherShortcut(editor),
+            eraser.makeEraserSwitcherTool(),
             new FindTool(editor),
             new PasteHandler(editor),
             new SelectAllShortcutHandler(editor),
@@ -180,6 +182,13 @@ export default class ToolController {
     insertToolsBefore(insertBefore, toolsToInsert) {
         this.insertTools(insertBefore, toolsToInsert, 'before');
     }
+    /** @internal */
+    changeActiveToolTo(tool) {
+        if (!tool.isEnabled()) {
+            tool.setEnabled(true);
+        }
+        this.activeTool = tool;
+    }
     // @internal use `dispatchEvent` rather than calling `onEvent` directly.
     onEventInternal(event) {
         const isEditorReadOnly = this.isEditorReadOnly.get();

package/dist/mjs/util/ReactiveValue.d.ts

@@ -33,6 +33,8 @@ export declare abstract class ReactiveValue<T> {
      * @see {@link onUpdate}.
      */
     abstract onUpdateAndNow(callback: UpdateCallback<T>): ListenerResult;
+    /** Returns a promise that resolves when this value is next changed. */
+    waitForNextUpdate(): Promise<T>;
     /** Creates a `ReactiveValue` with an initial value, `initialValue`. */
     static fromInitialValue<T>(initialValue: T): MutableReactiveValue<T>;
     /** Returns a `ReactiveValue` that is **known** will never change. */

package/dist/mjs/util/ReactiveValue.mjs

@@ -35,6 +35,15 @@ const noOpSetUpdateListener = () => {
  * Avoid extending this class from an external library, as that may not be stable.
  */
 export class ReactiveValue {
+    /** Returns a promise that resolves when this value is next changed. */
+    waitForNextUpdate() {
+        return new Promise(resolve => {
+            const listener = this.onUpdate(value => {
+                listener.remove();
+                resolve(value);
+            });
+        });
+    }
     /** Creates a `ReactiveValue` with an initial value, `initialValue`. */
     static fromInitialValue(initialValue) {
         return new ReactiveValueImpl(initialValue);
@@ -48,6 +57,8 @@ export class ReactiveValue {
                 callback(value);
                 return noOpUpdateListenerResult;
             },
+            // Never resolves -- immutable.
+            waitForNextUpdate: () => new Promise(() => { }),
         };
     }
     /**

package/dist/mjs/util/bytesToSizeString.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns a size in bytes, KiB, or MiB with units suffix.
+ */
+declare const bytesToSizeString: (sizeBytes: number) => {
+    size: number;
+    units: string;
+};
+export default bytesToSizeString;

package/dist/mjs/util/bytesToSizeString.mjs

@@ -0,0 +1,24 @@
+/**
+ * Returns a size in bytes, KiB, or MiB with units suffix.
+ */
+const bytesToSizeString = (sizeBytes) => {
+    const sizeInKiB = sizeBytes / 1024;
+    const sizeInMiB = sizeInKiB / 1024;
+    const sizeInGiB = sizeInMiB / 1024;
+    let units = 'B';
+    let size = sizeBytes;
+    if (sizeInGiB >= 1) {
+        size = sizeInGiB;
+        units = 'GiB';
+    }
+    else if (sizeInMiB >= 1) {
+        size = sizeInMiB;
+        units = 'MiB';
+    }
+    else if (sizeInKiB >= 1) {
+        size = sizeInKiB;
+        units = 'KiB';
+    }
+    return { size, units };
+};
+export default bytesToSizeString;

package/dist/mjs/util/bytesToSizeString.test.d.ts

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

package/dist/mjs/util/stopPropagationOfScrollingWheelEvents.mjs

@@ -1,13 +1,17 @@
 const stopPropagationOfScrollingWheelEvents = (scrollingContainer) => {
+    const scrollsAxis = (delta, clientSize, scrollOffset, scrollSize) => {
+        const hasScroll = clientSize !== scrollSize && delta !== 0;
+        const eventScrollsPastStart = scrollOffset + delta <= 0;
+        const scrollEnd = scrollOffset + clientSize;
+        const eventScrollsPastEnd = scrollEnd + delta > scrollSize;
+        return hasScroll && !eventScrollsPastStart && !eventScrollsPastEnd;
+    };
     scrollingContainer.onwheel = (event) => {
-        const hasScroll = scrollingContainer.clientWidth !== scrollingContainer.scrollWidth
-            && event.deltaX !== 0;
-        const eventScrollsPastLeft = scrollingContainer.scrollLeft + event.deltaX <= 0;
-        const scrollRight = scrollingContainer.scrollLeft + scrollingContainer.clientWidth;
-        const eventScrollsPastRight = scrollRight + event.deltaX > scrollingContainer.scrollWidth;
+        const scrollsX = scrollsAxis(event.deltaX, scrollingContainer.clientWidth, scrollingContainer.scrollLeft, scrollingContainer.scrollWidth);
+        const scrollsY = scrollsAxis(event.deltaY, scrollingContainer.clientHeight, scrollingContainer.scrollTop, scrollingContainer.scrollHeight);
         // Stop the editor from receiving the event if it will scroll the pen type selector
         // instead.
-        if (hasScroll && !eventScrollsPastLeft && !eventScrollsPastRight) {
+        if (scrollsX || scrollsY) {
             event.stopPropagation();
         }
     };

package/dist/mjs/util/waitForAll.d.ts

@@ -1,6 +1,8 @@
 /**
  * Resolves when all given promises have resolved. If no promises are given,
  * does not return a Promise.
+ *
+ * If all elements of `results` are known to be `Promise`s, use `Promise.all`.
  */
 declare const waitForAll: (results: (Promise<void> | void)[]) => Promise<void> | void;
 export default waitForAll;

package/dist/mjs/util/waitForAll.mjs

@@ -1,6 +1,8 @@
 /**
  * Resolves when all given promises have resolved. If no promises are given,
  * does not return a Promise.
+ *
+ * If all elements of `results` are known to be `Promise`s, use `Promise.all`.
  */
 const waitForAll = (results) => {
     // If any are Promises...

package/dist/mjs/util/waitForImageLoaded.mjs

@@ -2,7 +2,10 @@ const waitForImageLoad = async (image) => {
     if (!image.complete) {
         await new Promise((resolve, reject) => {
             image.onload = event => resolve(event);
+            // TODO(v2): Return a `new Error(event.message)`
+            // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- Forwarding an error-like object.
             image.onerror = event => reject(event);
+            // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- Forwarding an error-like object.
             image.onabort = event => reject(event);
         });
     }

package/dist/mjs/util/waitForTimeout.d.ts

@@ -1,2 +1,3 @@
+/** Returns a promise that resolves after `timeout` milliseconds. */
 declare const waitForTimeout: (timeout: number) => Promise<void>;
 export default waitForTimeout;

package/dist/mjs/util/waitForTimeout.mjs

@@ -1,4 +1,4 @@
-// Returns a promise that resolves after `timeout` milliseconds.
+/** Returns a promise that resolves after `timeout` milliseconds. */
 const waitForTimeout = (timeout) => {
     return new Promise(resolve => {
         setTimeout(() => resolve(), timeout);

package/dist/mjs/version.mjs

@@ -4,5 +4,5 @@
  * @internal
  */
 export default {
-    number: '1.18.0',
+    number: '1.19.1',
 };