js-draw 1.21.3 → 1.23.1

package/dist/cjs/tools/SelectionTool/util/makeClipboardErrorHandlers.js

@@ -9,7 +9,7 @@ const makeClipboardErrorHandlers = (editor) => {
     const makeErrorDialog = (error) => {
         const dialog = (0, makeMessageDialog_1.default)(editor, {
             title: editor.localization.copyPasteError__heading,
-            classNames: ['clipboard-error-dialog']
+            classNames: ['clipboard-error-dialog'],
         });
         dialog.appendChild(document.createTextNode(editor.localization.copyPasteError__description));
         const errorDetailsElement = document.createElement('details');
@@ -22,7 +22,26 @@ const makeClipboardErrorHandlers = (editor) => {
     };
     return {
         async onCopyError(error) {
-            makeErrorDialog(error);
+            const dialog = makeErrorDialog(error);
+            const textboxLabel = document.createElement('label');
+            textboxLabel.textContent = editor.localization.copyPasteError__copyRetry;
+            const copyTextbox = document.createElement('textarea');
+            textboxLabel.appendChild(copyTextbox);
+            const retryHandler = new ClipboardHandler_1.default(editor);
+            const handleCopy = (event) => {
+                event.preventDefault();
+                // Use .then to ensure that .copy runs within the event handler.
+                // Copy can fail if certain logic is run async.
+                return retryHandler.copy(event).then(() => {
+                    dialog.close();
+                });
+            };
+            copyTextbox.oncopy = handleCopy;
+            copyTextbox.ondragstart = handleCopy;
+            copyTextbox.value = editor.localization.copyPasteError__copyMe;
+            dialog.appendChild(textboxLabel);
+            copyTextbox.select();
+            document.execCommand('copy');
         },
         onPasteError(error) {
             const dialog = makeErrorDialog(error);
@@ -44,6 +63,8 @@ const makeClipboardErrorHandlers = (editor) => {
             pasteTextbox.onpaste = handlePaste;
             pasteTextbox.ondrop = handlePaste;
             dialog.appendChild(textboxLabel);
+            pasteTextbox.focus();
+            document.execCommand('paste');
         },
     };
 };

package/dist/cjs/tools/SelectionTool/util/showSelectionContextMenu.js

@@ -9,35 +9,44 @@ const makeClipboardErrorHandlers_1 = __importDefault(require("./makeClipboardErr
 const showSelectionContextMenu = async (selectionBox, editor, canvasAnchor, preferSelectionMenu, clearSelection) => {
     const localization = editor.localization;
     const showSelectionMenu = selectionBox?.getSelectedItemCount() && preferSelectionMenu;
-    const noSelectionMenu = [{
+    const noSelectionMenu = [
+        {
             text: localization.selectionMenu__paste,
             icon: () => editor.icons.makePasteIcon(),
             key: () => {
                 const clipboardHandler = new ClipboardHandler_1.default(editor, (0, makeClipboardErrorHandlers_1.default)(editor));
                 void clipboardHandler.paste();
             },
-        }];
-    const onActivated = await (0, createMenuOverlay_1.default)(editor, canvasAnchor, showSelectionMenu ? [{
-            text: localization.selectionMenu__duplicate,
-            icon: () => editor.icons.makeDuplicateSelectionIcon(),
-            key: async () => {
-                await editor.dispatch(await selectionBox.duplicateSelectedObjects());
+        },
+    ];
+    const onActivated = await (0, createMenuOverlay_1.default)(editor, canvasAnchor, showSelectionMenu
+        ? [
+            {
+                text: localization.selectionMenu__duplicate,
+                icon: () => editor.icons.makeDuplicateSelectionIcon(),
+                key: async () => {
+                    await editor.dispatch(await selectionBox.duplicateSelectedObjects());
+                },
             },
-        }, {
-            text: localization.selectionMenu__delete,
-            icon: () => editor.icons.makeDeleteSelectionIcon(),
-            key: async () => {
-                await editor.dispatch(selectionBox.deleteSelectedObjects());
-                clearSelection();
+            {
+                text: localization.selectionMenu__delete,
+                icon: () => editor.icons.makeDeleteSelectionIcon(),
+                key: async () => {
+                    await editor.dispatch(selectionBox.deleteSelectedObjects());
+                    clearSelection();
+                },
             },
-        }, {
-            text: localization.selectionMenu__copyToClipboard,
-            icon: () => editor.icons.makeCopyIcon(),
-            key: () => {
-                const clipboardHandler = new ClipboardHandler_1.default(editor, (0, makeClipboardErrorHandlers_1.default)(editor));
-                void clipboardHandler.copy();
+            {
+                text: localization.selectionMenu__copyToClipboard,
+                icon: () => editor.icons.makeCopyIcon(),
+                key: () => {
+                    const clipboardHandler = new ClipboardHandler_1.default(editor, (0, makeClipboardErrorHandlers_1.default)(editor));
+                    void clipboardHandler.copy();
+                },
             },
-        }, ...noSelectionMenu] : noSelectionMenu);
+            ...noSelectionMenu,
+        ]
+        : noSelectionMenu);
     onActivated?.();
 };
 exports.default = showSelectionContextMenu;

package/dist/cjs/tools/SoundUITool.js

@@ -58,12 +58,12 @@ class SoundFeedback {
     setColor(color) {
         const hsv = color.asHSV();
         // Choose frequencies that roughly correspond to hue, saturation, and value.
-        const hueFrequency = (-Math.cos(hsv.x / 2)) * 220 + 440;
+        const hueFrequency = -Math.cos(hsv.x / 2) * 220 + 440;
         const saturationFrequency = hsv.y * 440 + 220;
         const valueFrequency = (hsv.z + 0.1) * 440;
         // Sigmoid with maximum 0.25 * alpha.
         // Louder for greater value.
-        const gain = 0.25 * Math.min(1, color.a) / (1 + Math.exp(-(hsv.z - 0.5) * 3));
+        const gain = (0.25 * Math.min(1, color.a)) / (1 + Math.exp(-(hsv.z - 0.5) * 3));
         this.colorOscHue.frequency.setValueAtTime(hueFrequency, this.ctx.currentTime);
         this.colorOscSaturation.frequency.setValueAtTime(saturationFrequency, this.ctx.currentTime);
         this.colorOscValue.frequency.setValueAtTime(valueFrequency, this.ctx.currentTime);
@@ -155,7 +155,9 @@ class SoundUITool extends BaseTool_1.default {
     onPointerMove({ current }) {
         this.soundFeedback?.setColor(this.editor.display.getColorAt(current.screenPos) ?? math_1.Color4.black);
         const pointerMotionLine = new math_1.LineSegment2(this.lastPointerPos, current.canvasPos);
-        const collisions = this.editor.image.getElementsIntersectingRegion(pointerMotionLine.bbox).filter(component => component.intersects(pointerMotionLine));
+        const collisions = this.editor.image
+            .getElementsIntersectingRegion(pointerMotionLine.bbox)
+            .filter((component) => component.intersects(pointerMotionLine));
         this.lastPointerPos = current.canvasPos;
         if (collisions.length > 0) {
             this.soundFeedback?.announceBoundaryCross(collisions.length);

package/dist/cjs/tools/TextTool.js

@@ -81,7 +81,7 @@ class TextTool extends BaseTool_1.default {
             return measurement.fontBoundingBoxAscent ?? measurement.actualBoundingBoxAscent;
         }
         // Estimate
-        return style.size * 2 / 3;
+        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
@@ -100,7 +100,10 @@ class TextTool extends BaseTool_1.default {
             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 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) {
@@ -144,8 +147,7 @@ class TextTool extends BaseTool_1.default {
         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.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);
@@ -213,11 +215,11 @@ class TextTool extends BaseTool_1.default {
             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);
+            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));
+            targetTextNodes = targetTextNodes.filter((node) => !node.getBBox().containsRect(visibleRect));
             // End any TextNodes we're currently editing.
             this.flushInput();
             if (targetTextNodes.length > 0) {

package/dist/cjs/tools/ToolController.js

@@ -53,13 +53,19 @@ class ToolController {
         this.activeTool = null;
         this.isEditorReadOnly = editor.isReadOnlyReactiveValue();
         this.inputPipeline = new InputPipeline_1.default();
-        this.inputPipeline.setEmitListener(event => this.onEventInternal(event));
+        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 });
+        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);
@@ -71,7 +77,7 @@ class ToolController {
             new Pen_1.default(editor, localization.penTool(3), {
                 color: math_1.Color4.ofRGBA(1, 1, 0, 0.5),
                 thickness: 40,
-                factory: PressureSensitiveFreehandLineBuilder_1.makePressureSensitiveFreehandLineBuilder
+                factory: PressureSensitiveFreehandLineBuilder_1.makePressureSensitiveFreehandLineBuilder,
             }),
             eraser,
             new SelectionTool_1.default(editor, localization.selectionTool),
@@ -96,15 +102,15 @@ class ToolController {
             new PasteHandler_1.default(editor),
             new SelectAllShortcutHandler_1.default(editor),
         ];
-        primaryTools.forEach(tool => tool.setToolGroup(primaryToolGroup));
+        primaryTools.forEach((tool) => tool.setToolGroup(primaryToolGroup));
         panZoomTool.setEnabled(true);
         primaryPenTool.setEnabled(true);
-        editor.notifier.on(types_1.EditorEventType.ToolEnabled, event => {
+        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 => {
+        editor.notifier.on(types_1.EditorEventType.ToolDisabled, (event) => {
             if (event.kind === types_1.EditorEventType.ToolDisabled) {
                 editor.announceForAccessibility(localization.toolDisabledAnnouncement(event.tool.description));
             }
@@ -138,7 +144,7 @@ class ToolController {
         }
     }
     getPrimaryTools() {
-        return this.tools.filter(tool => {
+        return this.tools.filter((tool) => {
             return tool.getToolGroup() === this.primaryToolGroup;
         });
     }
@@ -180,7 +186,7 @@ class ToolController {
         this.tools = newTools;
     }
     insertTools(insertNear, toolsToInsert, mode) {
-        this.tools = this.tools.filter(tool => !toolsToInsert.includes(tool));
+        this.tools = this.tools.filter((tool) => !toolsToInsert.includes(tool));
         const newTools = [];
         for (const tool of this.tools) {
             if (mode === 'after') {
@@ -292,7 +298,7 @@ class ToolController {
         this.inputPipeline.addToTail(mapper);
     }
     getMatchingTools(type) {
-        return this.tools.filter(tool => tool instanceof type);
+        return this.tools.filter((tool) => tool instanceof type);
     }
     // @internal
     onEditorDestroyed() {

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

@@ -1,3 +1,4 @@
+export { default as InputMapper } from './InputFilter/InputMapper';
 export { default as BaseTool } from './BaseTool';
 export { default as ToolController } from './ToolController';
 export { default as ToolEnabledGroup } from './ToolEnabledGroup';

package/dist/cjs/tools/lib.js

@@ -3,7 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolbarShortcutHandler = exports.SoundUITool = exports.PasteHandler = exports.EraserMode = exports.EraserTool = exports.SelectAllShortcutHandler = exports.SelectionTool = exports.TextTool = exports.PenTool = exports.PanZoomMode = exports.PanZoomTool = exports.ToolSwitcherShortcut = exports.UndoRedoShortcut = exports.ToolEnabledGroup = exports.ToolController = exports.BaseTool = void 0;
+exports.ToolbarShortcutHandler = exports.SoundUITool = exports.PasteHandler = exports.EraserMode = exports.EraserTool = exports.SelectAllShortcutHandler = exports.SelectionTool = exports.TextTool = exports.PenTool = exports.PanZoomMode = exports.PanZoomTool = exports.ToolSwitcherShortcut = exports.UndoRedoShortcut = exports.ToolEnabledGroup = exports.ToolController = exports.BaseTool = exports.InputMapper = void 0;
+var InputMapper_1 = require("./InputFilter/InputMapper");
+Object.defineProperty(exports, "InputMapper", { enumerable: true, get: function () { return __importDefault(InputMapper_1).default; } });
 var BaseTool_1 = require("./BaseTool");
 Object.defineProperty(exports, "BaseTool", { enumerable: true, get: function () { return __importDefault(BaseTool_1).default; } });
 var ToolController_1 = require("./ToolController");

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

@@ -36,6 +36,8 @@ export interface ToolLocalization {
     copyPasteError__heading: string;
     copyPasteError__description: string;
     copyPasteError__pasteRetry: string;
+    copyPasteError__copyRetry: string;
+    copyPasteError__copyMe: string;
     copyPasteError__errorDetails: string;
     toolEnabledAnnouncement: (toolName: string) => string;
     toolDisabledAnnouncement: (toolName: string) => string;

package/dist/cjs/tools/localization.js

@@ -17,10 +17,12 @@ exports.defaultToolLocalization = {
     selectionMenu__duplicate: 'Duplicate',
     selectionMenu__delete: 'Delete',
     selectionMenu__paste: 'Paste',
-    copyPasteError__heading: 'Error!',
+    copyPasteError__heading: 'Copy/paste',
     copyPasteError__description: 'Something went wrong — this tool may not have clipboard access.',
     copyPasteError__errorDetails: 'Show error',
     copyPasteError__pasteRetry: 'To retry, please paste into the input box below:',
+    copyPasteError__copyRetry: 'To retry, please copy the text in the input box below:',
+    copyPasteError__copyMe: 'Copy me!',
     autocorrectedTo: (strokeDescription) => `Autocorrected to ${strokeDescription}`,
     autocorrectionCanceled: 'Autocorrect cancelled',
     textTool: 'Text',

package/dist/cjs/tools/util/StationaryPenDetector.js

@@ -48,9 +48,9 @@ class StationaryPenDetector {
         const movedOutOfRadius = dxFromStationaryStart.length() > this.config.maxRadius;
         this.hasMovedOutOfRadius ||= movedOutOfRadius;
         // If not stationary
-        if (movedOutOfRadius
-            || this.averageVelocity.length() > this.config.maxSpeed
-            || dtFromStart < this.config.minTimeSeconds) {
+        if (movedOutOfRadius ||
+            this.averageVelocity.length() > this.config.maxSpeed ||
+            dtFromStart < this.config.minTimeSeconds) {
             this.stationaryStartPointer = currentPointer;
             this.lastPointer = currentPointer;
             this.setStationaryTimeout(this.config.minTimeSeconds * 1000);

package/dist/cjs/tools/util/createMenuOverlay.js

@@ -32,7 +32,7 @@ const createMenuOverlay = async (editor, canvasAnchor, options) => {
         await (0, waitForTimeout_1.default)(hideMenuTimeout);
         menuModal.close();
     };
-    return new Promise(resolve => {
+    return new Promise((resolve) => {
         let resolved = false;
         let result = null;
         const resolveWithSelectedResult = () => {
@@ -75,7 +75,7 @@ const createMenuOverlay = async (editor, canvasAnchor, options) => {
         // - https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/menu_role and
         // - https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/examples/disclosure-navigation/
         contentElement.addEventListener('keydown', (event) => {
-            const focusedIndex = optionElements.findIndex(item => item === document.activeElement);
+            const focusedIndex = optionElements.findIndex((item) => item === document.activeElement);
             if (focusedIndex === -1)
                 return;
             let newFocusedIndex = focusedIndex;

package/dist/cjs/util/ClipboardHandler.d.ts

@@ -29,7 +29,7 @@ export default class ClipboardHandler {
      * is to be copied. This is done because `ClipboardEvent`s seem to not support attaching
      * images.
      */
-    copy(event?: ClipboardEvent): Promise<void>;
+    copy(event?: ClipboardEvent | DragEvent): Promise<void>;
     private copyInternal;
 }
 export {};

package/dist/cjs/util/ClipboardHandler.js

@@ -63,20 +63,15 @@ class ClipboardHandler {
         const clipboardData = event?.dataTransfer ?? event?.clipboardData ?? null;
         const hasEvent = !!clipboardData;
         const sendPasteEvent = (mime, data) => {
-            return data && editor.toolController.dispatchInputEvent({
-                kind: inputEvents_1.InputEvtType.PasteEvent,
-                mime,
-                data,
-            });
+            return (data &&
+                editor.toolController.dispatchInputEvent({
+                    kind: inputEvents_1.InputEvtType.PasteEvent,
+                    mime,
+                    data,
+                }));
         };
         // Listed in order of precedence
-        const supportedMIMEs = [
-            'image/svg+xml',
-            'text/html',
-            'image/png',
-            'image/jpeg',
-            'text/plain',
-        ];
+        const supportedMIMEs = ['image/svg+xml', 'text/html', 'image/png', 'image/jpeg', 'text/plain'];
         let files = [];
         const textData = new Map();
         if (hasEvent) {
@@ -110,7 +105,7 @@ class ClipboardHandler {
                 }
             }
             for (const file of files) {
-                const fileType = file.type.toLowerCase();
+                const fileType = file?.type?.toLowerCase();
                 if (fileType !== mime) {
                     continue;
                 }
@@ -186,14 +181,19 @@ class ClipboardHandler {
             event?.preventDefault();
         }
         const mimeTypes = [...mimeToData.keys()];
-        const hasNonTextMimeTypes = mimeTypes.some(mime => !isTextMimeType(mime));
+        const hasNonTextMimeTypes = mimeTypes.some((mime) => !isTextMimeType(mime));
         const copyToEvent = (reason) => {
             if (!event) {
                 throw new Error(`Unable to copy -- no event provided${reason ? `. Original error: ${reason}` : ''}`);
             }
             for (const [key, value] of mimeToData.entries()) {
                 if (typeof value === 'string') {
-                    event.clipboardData?.setData(key, value);
+                    if ('clipboardData' in event) {
+                        event.clipboardData?.setData(key, value);
+                    }
+                    else {
+                        event.dataTransfer?.setData(key, value);
+                    }
                 }
             }
         };
@@ -224,7 +224,9 @@ class ClipboardHandler {
                     // Browser support for ClipboardItem.supports is limited as of mid 2024. However, some browsers
                     // that do support `.supports` throw an exception when attempting to copy an unsupported MIME type
                     // (e.g. Firefox).
-                    const unsupported = 'supports' in ClipboardItem && typeof ClipboardItem.supports === 'function' && !ClipboardItem.supports(key);
+                    const unsupported = 'supports' in ClipboardItem &&
+                        typeof ClipboardItem.supports === 'function' &&
+                        !ClipboardItem.supports(key);
                     if (!unsupported) {
                         filteredMimeToData[key] = data;
                     }
@@ -234,8 +236,7 @@ class ClipboardHandler {
             const browserMimeToData = removeUnsupportedMime(mapInternalDataToBrowserData(mimeToData));
             return navigator.clipboard.write([new ClipboardItem(browserMimeToData)]);
         };
-        const supportsClipboardApi = (typeof ClipboardItem !== 'undefined'
-            && typeof navigator?.clipboard?.write !== 'undefined');
+        const supportsClipboardApi = typeof ClipboardItem !== 'undefined' && typeof navigator?.clipboard?.write !== 'undefined';
         if (!__classPrivateFieldGet(this, _ClipboardHandler_preferClipboardEvents, "f") && supportsClipboardApi && (hasNonTextMimeTypes || !event)) {
             let clipboardApiPromise = null;
             const fallBackToCopyEvent = (reason) => {

package/dist/cjs/util/ReactiveValue.js

@@ -14,7 +14,7 @@ var _ReactiveValueImpl_value, _ReactiveValueImpl_onUpdateListeners;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MutableReactiveValue = exports.ReactiveValue = void 0;
 const noOpUpdateListenerResult = {
-    remove() { }
+    remove() { },
 };
 /**
  * An update listener that does nothing. Useful for reactive values
@@ -40,8 +40,8 @@ const noOpSetUpdateListener = () => {
 class ReactiveValue {
     /** Returns a promise that resolves when this value is next changed. */
     waitForNextUpdate() {
-        return new Promise(resolve => {
-            const listener = this.onUpdate(value => {
+        return new Promise((resolve) => {
+            const listener = this.onUpdate((value) => {
                 listener.remove();
                 resolve(value);
             });
@@ -56,7 +56,7 @@ class ReactiveValue {
         return {
             get: () => value,
             onUpdate: noOpSetUpdateListener,
-            onUpdateAndNow: callback => {
+            onUpdateAndNow: (callback) => {
                 callback(value);
                 return noOpUpdateListenerResult;
             },
@@ -72,7 +72,9 @@ class ReactiveValue {
      */
     static fromCallback(callback, sourceValues) {
         const result = new ReactiveValueImpl(callback());
-        const resultRef = window.WeakRef ? new window.WeakRef(result) : { deref: () => result };
+        const resultRef = window.WeakRef
+            ? new window.WeakRef(result)
+            : { deref: () => result };
         for (const value of sourceValues) {
             const listener = value.onUpdate(() => {
                 // Use resultRef to allow `result` to be garbage collected
@@ -91,12 +93,12 @@ class ReactiveValue {
     static map(source, map, inverseMap) {
         const result = ReactiveValue.fromInitialValue(map(source.get()));
         let expectedResultValue = result.get();
-        source.onUpdate(newValue => {
+        source.onUpdate((newValue) => {
             expectedResultValue = map(newValue);
             result.set(expectedResultValue);
         });
         if (inverseMap) {
-            result.onUpdate(newValue => {
+            result.onUpdate((newValue) => {
                 // Prevent infinite loops if inverseMap is not a true
                 // inverse.
                 if (newValue !== expectedResultValue) {
@@ -108,7 +110,7 @@ class ReactiveValue {
     }
     static union(values) {
         return ReactiveValue.fromCallback(() => {
-            return values.map(value => value.get());
+            return values.map((value) => value.get());
         }, values);
     }
 }
@@ -116,9 +118,11 @@ exports.ReactiveValue = ReactiveValue;
 class MutableReactiveValue extends ReactiveValue {
     static fromProperty(sourceValue, propertyName) {
         const child = ReactiveValue.fromInitialValue(sourceValue.get()[propertyName]);
-        const childRef = window.WeakRef ? new window.WeakRef(child) : { deref: () => child };
+        const childRef = window.WeakRef
+            ? new window.WeakRef(child)
+            : { deref: () => child };
         // When the source is updated...
-        const sourceListener = sourceValue.onUpdate(newValue => {
+        const sourceListener = sourceValue.onUpdate((newValue) => {
             const childValue = childRef.deref();
             if (childValue) {
                 childValue.set(newValue[propertyName]);
@@ -131,7 +135,7 @@ class MutableReactiveValue extends ReactiveValue {
         });
         // When the child is updated, also apply the update to the
         // parent.
-        child.onUpdate(newValue => {
+        child.onUpdate((newValue) => {
             sourceValue.set({
                 ...sourceValue.get(),
                 [propertyName]: newValue,
@@ -169,7 +173,7 @@ class ReactiveValueImpl extends MutableReactiveValue {
         __classPrivateFieldGet(this, _ReactiveValueImpl_onUpdateListeners, "f").push(listener);
         return {
             remove: () => {
-                __classPrivateFieldSet(this, _ReactiveValueImpl_onUpdateListeners, __classPrivateFieldGet(this, _ReactiveValueImpl_onUpdateListeners, "f").filter(otherListener => {
+                __classPrivateFieldSet(this, _ReactiveValueImpl_onUpdateListeners, __classPrivateFieldGet(this, _ReactiveValueImpl_onUpdateListeners, "f").filter((otherListener) => {
                     return otherListener !== listener;
                 }), "f");
             },

package/dist/cjs/util/adjustEditorThemeForContrast.js

@@ -75,8 +75,12 @@ const adjustEditorThemeForContrast = (editor, options) => {
     // true if the variable can be updated
     updateVar1, updateVar2) => {
         // Fetch from updatedColors if available -- styles isn't updated dynamically.
-        let color1 = updatedColors[var1] ? updatedColors[var1] : math_1.Color4.fromString(styles.getPropertyValue(var1));
-        let color2 = updatedColors[var2] ? updatedColors[var2] : math_1.Color4.fromString(styles.getPropertyValue(var2));
+        let color1 = updatedColors[var1]
+            ? updatedColors[var1]
+            : math_1.Color4.fromString(styles.getPropertyValue(var1));
+        let color2 = updatedColors[var2]
+            ? updatedColors[var2]
+            : math_1.Color4.fromString(styles.getPropertyValue(var2));
         // Ensure that color1 has the lesser luminance
         if (color1.relativeLuminance() < color2.relativeLuminance()) {
             const tmp = color1;

package/dist/cjs/util/cloneElementWithStyles.js

@@ -12,7 +12,7 @@ const cloneElementWithStyles = (element) => {
         for (let index = 0; index < originalComputedStyle.length; index++) {
             const propertyName = originalComputedStyle.item(index);
             const propertyValue = originalComputedStyle.getPropertyValue(propertyName);
-            clonedElement.style.setProperty(propertyName, propertyValue);
+            clonedElement.style?.setProperty(propertyName, propertyValue);
         }
         for (let i = 0; i < originalElement.children.length; i++) {
             const originalChild = originalElement.children.item(i);

package/dist/cjs/util/createElement.d.ts

@@ -0,0 +1,62 @@
+type ElementTagNames = keyof HTMLElementTagNameMap | keyof SVGElementTagNameMap;
+/**
+ * Maps from known elment tag names to options that can be set with .setAttribute.
+ * New elements/properties should be added as necessary.
+ */
+interface ElementToPropertiesMap {
+    path: {
+        d: string;
+        fill: string;
+        stroke: string;
+        transform: string;
+    };
+    rect: {
+        stroke: string;
+        fill: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        transform: string;
+    };
+    pattern: {
+        viewBox: string;
+        width: string;
+        height: string;
+        patternUnits: 'userSpaceOnUse';
+    };
+    stop: {
+        offset: string;
+        'stop-color': string;
+    };
+    svg: {
+        viewBox: `${number} ${number} ${number} ${number}`;
+    };
+}
+type EmptyObject = Record<never, never>;
+type ElementProperties<Tag extends ElementTagNames> = Tag extends keyof ElementToPropertiesMap ? Partial<ElementToPropertiesMap[Tag]> : EmptyObject;
+/** Contains options for creating an element with tag = `Tag`. */
+type ElementConfig<Tag extends ElementTagNames> = ElementProperties<Tag> & {
+    id?: string;
+    children?: (HTMLElement | SVGElement)[];
+};
+/**
+ * Maps from element tag names (e.g. `Tag='button'`) to the corresponding element type
+ * (e.g. `HTMLButtonElement`).
+ */
+type ElementTagToType<Tag extends ElementTagNames> = Tag extends keyof HTMLElementTagNameMap ? HTMLElementTagNameMap[Tag] : Tag extends keyof SVGElementTagNameMap ? SVGElementTagNameMap[Tag] : never;
+export declare enum ElementNamespace {
+    Html = "html",
+    Svg = "svg"
+}
+/**
+ * Shorthand for creating an element with `document.createElement`, then assigning properties.
+ *
+ * Non-HTML elements (e.g. `svg` elements) should use the `elementType` parameter to select
+ * the element namespace.
+ */
+declare const createElement: <Tag extends ElementTagNames>(tag: Tag, props: ElementConfig<Tag>, elementType?: ElementNamespace) => ElementTagToType<Tag>;
+export declare const createSvgElement: <Tag extends keyof SVGElementTagNameMap>(tag: Tag, props: ElementConfig<Tag>) => ElementTagToType<Tag>;
+export declare const createSvgElements: <Tag extends keyof SVGElementTagNameMap>(tag: Tag, elements: ElementConfig<Tag>[]) => ElementTagToType<Tag>[];
+export declare const createSvgPaths: (...paths: ElementConfig<"path">[]) => SVGPathElement[];
+export default createElement;