js-draw 1.3.1 → 1.4.0

package/dist/cjs/{EditorImage.js → image/EditorImage.js}

@@ -32,13 +32,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 var _a, _b, _c;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RootImageNode = exports.ImageNode = exports.EditorImageEventType = exports.sortLeavesByZIndex = void 0;
-const Viewport_1 = __importDefault(require("./Viewport"));
-const AbstractComponent_1 = __importStar(require("./components/AbstractComponent"));
+const Viewport_1 = __importDefault(require("../Viewport"));
+const AbstractComponent_1 = __importStar(require("../components/AbstractComponent"));
 const math_1 = require("@js-draw/math");
-const SerializableCommand_1 = __importDefault(require("./commands/SerializableCommand"));
-const EventDispatcher_1 = __importDefault(require("./EventDispatcher"));
-const assertions_1 = require("./util/assertions");
-const Command_1 = __importDefault(require("./commands/Command"));
+const SerializableCommand_1 = __importDefault(require("../commands/SerializableCommand"));
+const EventDispatcher_1 = __importDefault(require("../EventDispatcher"));
+const assertions_1 = require("../util/assertions");
+const Command_1 = __importDefault(require("../commands/Command"));
 // @internal Sort by z-index, low to high
 const sortLeavesByZIndex = (leaves) => {
     leaves.sort((a, b) => a.getContent().getZIndex() - b.getContent().getZIndex());
@@ -117,7 +117,27 @@ class EditorImage {
         this.background.render(renderer, viewport?.visibleRect);
         this.root.render(renderer, viewport?.visibleRect);
     }
-    /** Renders all nodes, even ones not within the viewport. @internal */
+    /**
+     * Like {@link renderAll}, but can be stopped early and paused.
+     *
+     * **Note**: If the image is being edited during an async rendering, there is no
+     * guarantee that all nodes will be rendered correctly (some may be missing).
+     *
+     * @internal
+     */
+    async renderAllAsync(renderer, preRenderComponent) {
+        const stoppedEarly = !(await this.background.renderAllAsync(renderer, preRenderComponent));
+        if (!stoppedEarly) {
+            return await this.root.renderAllAsync(renderer, preRenderComponent);
+        }
+        return false;
+    }
+    /**
+     * Renders all nodes, even ones not within the viewport.
+     *
+     * This can be slow for large images
+     * @internal
+     */
     renderAll(renderer) {
         this.render(renderer, null);
     }
@@ -640,6 +660,30 @@ class ImageNode {
         this.content = null;
         this.children = [];
     }
+    // Creates a (potentially incomplete) async rendering of this image.
+    // Returns false if stopped early
+    async renderAllAsync(renderer, 
+    // Used to pause/stop the renderer process
+    preRenderComponent) {
+        const leaves = this.getLeaves();
+        (0, exports.sortLeavesByZIndex)(leaves);
+        const totalLeaves = leaves.length;
+        for (let leafIndex = 0; leafIndex < totalLeaves; leafIndex++) {
+            const leaf = leaves[leafIndex];
+            const component = leaf.getContent();
+            // Even though leaf was originally a leaf, it might not be any longer --
+            // rendering is async and the tree can change during that time.
+            if (!component) {
+                continue;
+            }
+            const shouldContinue = await preRenderComponent(component, leafIndex, totalLeaves);
+            if (!shouldContinue) {
+                return false;
+            }
+            component.render(renderer, undefined);
+        }
+        return true;
+    }
     render(renderer, visibleRect) {
         let leaves;
         if (visibleRect) {

package/dist/cjs/image/export/editorImageToSVG.d.ts

@@ -0,0 +1,8 @@
+import EditorImage, { PreRenderComponentCallback } from '../EditorImage';
+import { SVGSizingOptions } from './setExportedSVGSize';
+export interface SVGExportOptions extends SVGSizingOptions {
+    sanitize?: boolean;
+    minDimension?: number;
+}
+export declare const editorImageToSVGSync: (image: EditorImage, options: SVGExportOptions) => SVGSVGElement;
+export declare const editorImageToSVGAsync: (image: EditorImage, preRenderComponent: PreRenderComponentCallback, options: SVGExportOptions) => Promise<SVGElement>;

package/dist/cjs/image/export/editorImageToSVG.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.editorImageToSVGAsync = exports.editorImageToSVGSync = void 0;
+const math_1 = require("@js-draw/math");
+const SVGRenderer_1 = __importDefault(require("../../rendering/renderers/SVGRenderer"));
+const SVGLoader_1 = require("../../SVGLoader");
+const setExportedSVGSize_1 = __importDefault(require("./setExportedSVGSize"));
+const toSVGInternal = (image, renderFunction, options) => {
+    const importExportViewport = image.getImportExportViewport().getTemporaryClone();
+    const { element: result, renderer } = SVGRenderer_1.default.fromViewport(importExportViewport, options.sanitize ?? false);
+    const origTransform = importExportViewport.canvasToScreenTransform;
+    // Render with (0,0) at (0,0) — we'll handle translation with
+    // the viewBox property.
+    importExportViewport.resetTransform(math_1.Mat33.identity);
+    // Use a callback rather than async/await to allow this function to create
+    // both sync and async render functions
+    renderFunction(renderer, () => {
+        importExportViewport.resetTransform(origTransform);
+        if (image.getAutoresizeEnabled()) {
+            result.classList.add(SVGLoader_1.svgLoaderAutoresizeClassName);
+        }
+        else {
+            result.classList.remove(SVGLoader_1.svgLoaderAutoresizeClassName);
+        }
+        (0, setExportedSVGSize_1.default)(result, importExportViewport, options);
+        return result;
+    });
+    return result;
+};
+const editorImageToSVGSync = (image, options) => {
+    return toSVGInternal(image, (renderer, onComplete) => {
+        image.renderAll(renderer);
+        onComplete();
+    }, options);
+};
+exports.editorImageToSVGSync = editorImageToSVGSync;
+const editorImageToSVGAsync = (image, preRenderComponent, options) => {
+    return new Promise(resolve => {
+        toSVGInternal(image, async (renderer, onComplete) => {
+            await image.renderAllAsync(renderer, preRenderComponent);
+            const result = onComplete();
+            resolve(result);
+        }, options);
+    });
+};
+exports.editorImageToSVGAsync = editorImageToSVGAsync;

package/dist/cjs/image/export/setExportedSVGSize.d.ts

@@ -0,0 +1,6 @@
+import Viewport from '../../Viewport';
+export type SVGSizingOptions = {
+    minDimension?: number;
+};
+declare const setExportedSVGSize: (svg: SVGElement, viewport: Viewport, options: SVGSizingOptions) => void;
+export default setExportedSVGSize;

package/dist/cjs/image/export/setExportedSVGSize.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const math_1 = require("@js-draw/math");
+// @internal
+const setExportedSVGSize = (svg, viewport, options) => {
+    // Just show the main region
+    const rect = viewport.visibleRect;
+    svg.setAttribute('viewBox', [rect.x, rect.y, rect.w, rect.h].map(part => (0, math_1.toRoundedString)(part)).join(' '));
+    // Adjust the width/height as necessary
+    let width = rect.w;
+    let height = rect.h;
+    if (options?.minDimension && width < options.minDimension) {
+        const newWidth = options.minDimension;
+        height *= newWidth / (width || 1);
+        width = newWidth;
+    }
+    if (options?.minDimension && height < options.minDimension) {
+        const newHeight = options.minDimension;
+        width *= newHeight / (height || 1);
+        height = newHeight;
+    }
+    svg.setAttribute('width', (0, math_1.toRoundedString)(width));
+    svg.setAttribute('height', (0, math_1.toRoundedString)(height));
+};
+exports.default = setExportedSVGSize;

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

@@ -0,0 +1 @@
+export { default as EditorImage } from './EditorImage';

package/dist/cjs/image/lib.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EditorImage = void 0;
+var EditorImage_1 = require("./EditorImage");
+Object.defineProperty(exports, "EditorImage", { enumerable: true, get: function () { return __importDefault(EditorImage_1).default; } });

package/dist/cjs/lib.d.ts

@@ -15,7 +15,7 @@
  * @packageDocumentation
  */
 import Editor, { EditorSettings } from './Editor';
-export { default as EditorImage } from './EditorImage';
+export * from './image/lib';
 export * from './types';
 export * from './inputEvents';
 export { default as getLocalizationTable, matchingLocalizationTable } from './localizations/getLocalizationTable';

package/dist/cjs/lib.js

@@ -33,11 +33,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HTMLToolbar = exports.AbstractToolbar = exports.Editor = exports.__js_draw__version = exports.UndoRedoHistory = exports.PointerDevice = exports.Pointer = exports.EventDispatcher = exports.Viewport = exports.SVGLoader = exports.matchingLocalizationTable = exports.getLocalizationTable = exports.EditorImage = void 0;
+exports.HTMLToolbar = exports.AbstractToolbar = exports.Editor = exports.__js_draw__version = exports.UndoRedoHistory = exports.PointerDevice = exports.Pointer = exports.EventDispatcher = exports.Viewport = exports.SVGLoader = exports.matchingLocalizationTable = exports.getLocalizationTable = void 0;
 const Editor_1 = __importDefault(require("./Editor"));
 exports.Editor = Editor_1.default;
-var EditorImage_1 = require("./EditorImage");
-Object.defineProperty(exports, "EditorImage", { enumerable: true, get: function () { return __importDefault(EditorImage_1).default; } });
+__exportStar(require("./image/lib"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./inputEvents"), exports);
 var getLocalizationTable_1 = require("./localizations/getLocalizationTable");

package/dist/cjs/localizations/comments.d.ts

@@ -0,0 +1,6 @@
+import { EditorLocalization } from '../localization';
+/**
+ * Comments to help translators create translations.
+ */
+declare const comments: Partial<Record<keyof EditorLocalization, string>>;
+export default comments;

package/dist/cjs/localizations/comments.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Comments to help translators create translations.
+ */
+const comments = {
+    dragAndDropHereOrBrowse: 'Uses {{curly braces}} to denote bold text',
+    closeSidebar: 'Currently used as an accessibilty label',
+};
+exports.default = comments;

package/dist/cjs/localizations/es.js

@@ -1,70 +1,90 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const localization_1 = require("../localization");
-// A partial Spanish localization.
+// A partial Spanish localization, created with /scripts/markdownTranslationFormToTs.ts
 const localization = {
     ...localization_1.defaultEditorLocalization,
-    // Strings for the main editor interface
-    // (see src/localization.ts)
-    loading: (percentage) => `Cargando: ${percentage}%...`,
-    imageEditor: 'Editor de dibujos',
-    undoAnnouncement: (commandDescription) => `${commandDescription} fue deshecho`,
-    redoAnnouncement: (commandDescription) => `${commandDescription} fue rehecho`,
-    undo: 'Deshace',
-    redo: 'Rehace',
-    // Strings for the toolbar
-    // (see src/toolbar/localization.ts)
     pen: 'Lapiz',
     eraser: 'Borrador',
     select: 'Selecciona',
-    thicknessLabel: 'Tamaño',
-    colorLabel: 'Color',
-    doneLoading: 'El cargado terminó',
-    fontLabel: 'Fuente: ',
-    anyDevicePanning: 'Mover la pantalla con todo dispotivo',
-    touchPanning: 'Mover la pantalla con un dedo',
-    touchPanTool: 'Instrumento de mover la pantalla con un dedo',
-    outlinedRectanglePen: 'Rectángulo con nada más que un borde',
-    filledRectanglePen: 'Rectángulo sin borde',
-    linePen: 'Línea',
-    arrowPen: 'Flecha',
-    roundedTipPen: 'Lapiz Redondeado',
-    selectPenTip: 'Forma de dibuja',
     handTool: 'Mover',
-    zoom: 'Zoom',
+    image: 'Imagen',
+    chooseFile: 'Seleccionar archivo',
+    cancel: 'Cancelar',
     resetView: 'Reiniciar vista',
+    thicknessLabel: 'Tamaño',
+    fontLabel: 'Fuente:',
+    textSize: 'Tamaño',
     resizeImageToSelection: 'Redimensionar la imagen a lo que está seleccionado',
     deleteSelection: 'Borra la selección',
     duplicateSelection: 'Duplica la selección',
+    exit: 'Salir',
+    save: 'Guardar',
+    undo: 'Deshace',
+    redo: 'Rehace',
+    selectPenTip: 'Punta',
+    selectShape: 'Forma',
     pickColorFromScreen: 'Selecciona un color de la pantalla',
     clickToPickColorAnnouncement: 'Haga un clic en la pantalla para seleccionar un color',
-    dropdownShown(toolName) {
-        return `Menú por ${toolName} es visible`;
-    },
-    dropdownHidden: function (toolName) {
-        return `Menú por ${toolName} fue ocultado`;
-    },
-    colorChangedAnnouncement: function (color) {
-        return `Color fue cambiado a ${color}`;
-    },
-    keyboardPanZoom: 'Mover la pantalla con el teclado',
-    penTool: function (penId) {
-        return `Lapiz ${penId}`;
-    },
+    documentProperties: 'Fondo',
+    backgroundColor: 'Color de fondo',
+    imageWidthOption: 'Ancho',
+    imageHeightOption: 'Alto',
+    toggleOverflow: 'Más',
+    touchPanning: 'Mover la pantalla con un dedo',
+    roundedTipPen: 'Lapiz Redondeado',
+    arrowPen: 'Flecha',
+    linePen: 'Línea',
+    outlinedRectanglePen: 'Rectángulo delineado',
+    filledRectanglePen: 'Rectángulo sin borde',
+    lockRotation: 'Bloquea rotación',
+    paste: 'Pegar',
+    closeSidebar: (toolName) => `Close sidebar for ${toolName}`,
+    dropdownShown: (toolName) => `Menú por ${toolName} es visible`,
+    dropdownHidden: (toolName) => { return `Menú por ${toolName} fue ocultado`; },
+    zoomLevel: (zoomPercent) => `Zoom: ${zoomPercent}%`,
+    colorChangedAnnouncement: (color) => { return `Color fue cambiado a ${color}`; },
+    imageSize: (size, units) => `Tamaño del imagen: ${size} ${units}`,
+    imageLoadError: (message) => `Error cargando imagen: ${message}`,
+    penTool: (penId) => { return `Lapiz ${penId}`; },
     selectionTool: 'Selecciona',
     eraserTool: 'Borrador',
+    touchPanTool: 'Instrumento de mover la pantalla con un dedo',
+    pipetteTool: 'Seleccione un color de la pantalla',
+    keyboardPanZoom: 'Mover la pantalla con el teclado',
     textTool: 'Texto',
     enterTextToInsert: 'Entra texto',
-    textSize: 'Tamaño',
+    findLabel: 'Buscar',
+    toNextMatch: 'Próxima',
+    closeDialog: 'Cerrar',
+    focusedFoundText: (matchIdx, totalMatches) => `Viewing match ${matchIdx} of ${totalMatches}`,
+    anyDevicePanning: 'Mover la pantalla con todo dispotivo',
+    copied: (count, description) => `Copied ${count} ${description}`,
+    pasted: (count, description) => `Pasted ${count} ${description}`,
+    toolEnabledAnnouncement: (toolName) => `${toolName} enabled`,
+    toolDisabledAnnouncement: (toolName) => `${toolName} disabled`,
+    transformedElements: (elemCount) => `Transformed ${elemCount} element${elemCount === 1 ? '' : 's'}`,
+    resizeOutputCommand: (newSize) => `Resized image to ${newSize.w}x${newSize.h}`,
+    addElementAction: (componentDescription) => `Added ${componentDescription}`,
+    eraseAction: (componentDescription, numElems) => `Erased ${numElems} ${componentDescription}`,
+    duplicateAction: (componentDescription, numElems) => `Duplicated ${numElems} ${componentDescription}`,
+    unionOf: (actionDescription, actionCount) => `Union: ${actionCount} ${actionDescription}`,
+    inverseOf: (actionDescription) => `Inverse of ${actionDescription}`,
+    rotatedBy: (degrees) => `Rotated by ${Math.abs(degrees)} degrees ${degrees < 0 ? 'clockwise' : 'counter-clockwise'}`,
+    selectedElements: (count) => `Selected ${count} element${count === 1 ? '' : 's'}`,
+    filledBackgroundWithColor: (color) => `Filled background (${color})`,
+    text: (text) => `Text object: ${text}`,
+    imageNode: (label) => `Image: ${label}`,
+    restyledElement: (elementDescription) => `Restyled ${elementDescription}`,
+    pathNodeCount: (count) => `There are ${count} visible path objects.`,
+    textNodeCount: (count) => `There are ${count} visible text nodes.`,
+    imageNodeCount: (nodeCount) => `There are ${nodeCount} visible image nodes.`,
+    textNode: (content) => `Text: ${content}`,
     rerenderAsText: 'Redibuja la pantalla al texto',
-    lockRotation: 'Bloquea rotación',
-    image: 'Imagen',
-    imageSize: (size, units) => `Tamaño del imagen: ${size} ${units}`,
-    imageLoadError: (message) => `Error cargando imagen: ${message}`,
-    toggleOverflow: 'Más',
-    documentProperties: 'Fondo',
-    imageWidthOption: 'Ancho',
-    imageHeightOption: 'Alto',
-    backgroundColor: 'Color de fondo: '
+    loading: (percentage) => `Cargando: ${percentage}%...`,
+    imageEditor: 'Editor de dibujos',
+    doneLoading: 'El cargado terminó',
+    undoAnnouncement: (commandDescription) => `${commandDescription} fue deshecho`,
+    redoAnnouncement: (commandDescription) => `${commandDescription} fue rehecho`,
 };
 exports.default = localization;

package/dist/cjs/rendering/caching/RenderingCache.d.ts

@@ -1,4 +1,4 @@
-import { ImageNode } from '../../EditorImage';
+import { ImageNode } from '../../image/EditorImage';
 import Viewport from '../../Viewport';
 import AbstractRenderer from '../renderers/AbstractRenderer';
 import { CacheProps } from './types';

package/dist/cjs/rendering/caching/RenderingCacheNode.d.ts

@@ -1,4 +1,4 @@
-import { ImageNode } from '../../EditorImage';
+import { ImageNode } from '../../image/EditorImage';
 import { Rect2 } from '@js-draw/math';
 import Viewport from '../../Viewport';
 import AbstractRenderer from '../renderers/AbstractRenderer';

package/dist/cjs/rendering/caching/RenderingCacheNode.js

@@ -1,7 +1,7 @@
 "use strict";
 // A cache record with sub-nodes.
 Object.defineProperty(exports, "__esModule", { value: true });
-const EditorImage_1 = require("../../EditorImage");
+const EditorImage_1 = require("../../image/EditorImage");
 const math_1 = require("@js-draw/math");
 // 3x3 divisions for each node.
 const cacheDivisionSize = 3;
@@ -44,11 +44,12 @@ class RenderingCacheNode {
     // Generates children, if missing.
     generateChildren() {
         if (this.instantiatedChildren.length === 0) {
-            const childRects = this.region.divideIntoGrid(cacheDivisionSize, cacheDivisionSize);
-            if (this.region.size.x === 0 || this.region.size.y === 0) {
+            if (this.region.size.x / cacheDivisionSize === 0 || this.region.size.y / cacheDivisionSize === 0) {
                 console.warn('Cache element has zero size! Not generating children.');
                 return;
             }
+            const childRects = this.region.divideIntoGrid(cacheDivisionSize, cacheDivisionSize);
+            console.assert(childRects.length === cacheDivisionSize * cacheDivisionSize, 'Warning: divideIntoGrid created the wrong number of subrectangles!');
             for (const rect of childRects) {
                 const child = new RenderingCacheNode(rect, this.cacheState);
                 child.parent = this;

package/dist/cjs/toolbar/AbstractToolbar.d.ts

@@ -8,6 +8,10 @@ export interface SpacerOptions {
     minSize: string;
     maxSize: string;
 }
+export type ToolbarActionButtonOptions = {
+    mustBeToplevel?: boolean;
+    autoDisableInReadOnlyEditors?: boolean;
+};
 export default abstract class AbstractToolbar {
     #private;
     protected editor: Editor;
@@ -91,18 +95,22 @@ export default abstract class AbstractToolbar {
      * @see
      * {@link addActionButton}
      */
-    protected makeActionButton(title: string | ActionButtonIcon, command: () => void, mustBeToplevel?: boolean): BaseWidget;
+    protected makeActionButton(title: string | ActionButtonIcon, command: () => void, options?: ToolbarActionButtonOptions | boolean): BaseWidget;
     /**
      * Adds an action button with `title` to this toolbar (or to the given `parent` element).
      *
+     * `options` can either be an object with properties `mustBeToplevel` and/or
+     * `autoDisableInReadOnlyEditors` or a boolean value. If a boolean, it is interpreted
+     * as being the value of `mustBeToplevel`.
+     *
      * @return The added button.
      */
-    addActionButton(title: string | ActionButtonIcon, command: () => void, mustBeToplevel?: boolean): BaseWidget;
+    addActionButton(title: string | ActionButtonIcon, command: () => void, options?: ToolbarActionButtonOptions | boolean): BaseWidget;
     /**
      * Like {@link addActionButton}, except associates `tags` with the button that allow
      * different toolbar styles to give the button tag-dependent styles.
      */
-    addTaggedActionButton(tags: (ToolbarWidgetTag | string)[], title: string | ActionButtonIcon, command: () => void, mustBeToplevel?: boolean): BaseWidget;
+    addTaggedActionButton(tags: (ToolbarWidgetTag | string)[], title: string | ActionButtonIcon, command: () => void, options?: ToolbarActionButtonOptions | boolean): BaseWidget;
     /**
      * Adds a save button that, when clicked, calls `saveCallback`.
      *

package/dist/cjs/toolbar/AbstractToolbar.js

@@ -235,7 +235,15 @@ class AbstractToolbar {
      * @see
      * {@link addActionButton}
      */
-    makeActionButton(title, command, mustBeToplevel = true) {
+    makeActionButton(title, command, options = true) {
+        // Parse options
+        if (typeof options === 'boolean') {
+            options = {
+                mustBeToplevel: options,
+            };
+        }
+        const mustBeToplevel = options.mustBeToplevel ?? true;
+        const autoDisableInReadOnlyEditors = options.autoDisableInReadOnlyEditors ?? true;
         const titleString = typeof title === 'string' ? title : title.label;
         const widgetId = 'action-button';
         const makeIcon = () => {
@@ -244,16 +252,20 @@ class AbstractToolbar {
             }
             return title.icon;
         };
-        const widget = new ActionButtonWidget_1.default(this.editor, widgetId, makeIcon, titleString, command, this.editor.localization, mustBeToplevel);
+        const widget = new ActionButtonWidget_1.default(this.editor, widgetId, makeIcon, titleString, command, this.editor.localization, mustBeToplevel, autoDisableInReadOnlyEditors);
         return widget;
     }
     /**
      * Adds an action button with `title` to this toolbar (or to the given `parent` element).
      *
+     * `options` can either be an object with properties `mustBeToplevel` and/or
+     * `autoDisableInReadOnlyEditors` or a boolean value. If a boolean, it is interpreted
+     * as being the value of `mustBeToplevel`.
+     *
      * @return The added button.
      */
-    addActionButton(title, command, mustBeToplevel = true) {
-        const widget = this.makeActionButton(title, command, mustBeToplevel);
+    addActionButton(title, command, options = true) {
+        const widget = this.makeActionButton(title, command, options);
         this.addWidget(widget);
         return widget;
     }
@@ -261,8 +273,8 @@ class AbstractToolbar {
      * Like {@link addActionButton}, except associates `tags` with the button that allow
      * different toolbar styles to give the button tag-dependent styles.
      */
-    addTaggedActionButton(tags, title, command, mustBeToplevel = true) {
-        const widget = this.makeActionButton(title, command, mustBeToplevel);
+    addTaggedActionButton(tags, title, command, options = true) {
+        const widget = this.makeActionButton(title, command, options);
         widget.setTags(tags);
         this.addWidget(widget);
         return widget;
@@ -308,6 +320,8 @@ class AbstractToolbar {
             icon: this.editor.icons.makeCloseIcon(),
         }, () => {
             exitCallback();
+        }, {
+            autoDisableInReadOnlyEditors: false,
         });
     }
     /**

package/dist/cjs/toolbar/EdgeToolbar.js

@@ -198,7 +198,6 @@ class EdgeToolbar extends AbstractToolbar_1.default {
         };
         const actionRowBBox = this.toolbarActionRow.getBoundingClientRect();
         const toolbarRowBBox = this.toolbarToolRow.getBoundingClientRect();
-        const inSameRow = actionRowBBox.y === toolbarRowBBox.y;
         const onDifferentRows = actionRowBBox.y + actionRowBBox.height <= toolbarRowBBox.y;
         if (onDifferentRows) {
             this.toolbarContainer.classList.remove('one-row');
@@ -208,11 +207,11 @@ class EdgeToolbar extends AbstractToolbar_1.default {
         }
         if (this.toolbarToolRow.clientWidth < this.toolbarToolRow.scrollWidth) {
             this.toolbarToolRow.classList.add('has-scroll');
-            // If both button areas are in the same row, don't change the padding --
-            // it could lead to an endless loop of reseize events.
-            if (!inSameRow) {
-                setExtraPadding();
-            }
+            // Note: This can potentially change the size of the tool row.
+            // Because this is run inside of a ResizeObserver callback, special
+            // care must be taken to ensure that this change doesn't re-trigger
+            // the resize observer.
+            setExtraPadding();
         }
         else {
             this.toolbarToolRow.classList.remove('has-scroll', 'extra-padding');

package/dist/cjs/toolbar/IconProvider.d.ts

@@ -38,6 +38,7 @@ export default class IconProvider {
     makeDropdownIcon(): IconElemType;
     makeEraserIcon(eraserSize?: number): IconElemType;
     makeSelectionIcon(): IconElemType;
+    makeRotateIcon(): IconElemType;
     makeHandToolIcon(): IconElemType;
     makeTouchPanningIcon(): IconElemType;
     /** Unused by js-draw. @deprecated */

package/dist/cjs/toolbar/IconProvider.js

@@ -169,6 +169,49 @@ class IconProvider {
         icon.setAttribute('viewBox', '0 0 100 100');
         return icon;
     }
+    makeRotateIcon() {
+        const icon = document.createElementNS(svgNamespace, 'svg');
+        icon.innerHTML = `
+			<defs>
+				<marker
+					id="arrow-marker"
+					viewBox="0 0 10 10"
+					refX="3" refY="5"
+					markerWidth="3" markerHeight="3"
+					orient="auto-start-reverse"
+				>
+					<path
+						d="M0,0 L8,5 L0,10z"
+						fill="var(--icon-color)"
+					/>
+				</marker>
+			</defs>
+
+			<path
+				marker-start="url(#arrow-marker)"
+				d="
+					M20,20
+					A30,30 0 1 1 80 80
+				"
+				fill="none"
+				stroke="var(--icon-color)"
+				stroke-width="12"
+			/>
+			<path
+				d="
+					M80,80
+					A30,30 0 1 1 20 20
+				"
+				fill="none"
+				stroke="var(--icon-color)"
+				stroke-width="12"
+				stroke-dasharray="30 10 20 10 20 10 10"
+				style="stroke-linecap: butt;"
+			/>
+		`;
+        icon.setAttribute('viewBox', '-5 -5 110 110');
+        return icon;
+    }
     makeHandToolIcon() {
         const fill = 'none';
         const strokeColor = 'var(--icon-color)';

package/dist/cjs/toolbar/widgets/ActionButtonWidget.d.ts

@@ -2,11 +2,13 @@ import Editor from '../../Editor';
 import { ToolbarLocalization } from '../localization';
 import BaseWidget from './BaseWidget';
 export default class ActionButtonWidget extends BaseWidget {
+    #private;
     protected makeIcon: () => Element | null;
     protected title: string;
     protected clickAction: () => void;
     protected mustBeToplevel: boolean;
-    constructor(editor: Editor, id: string, makeIcon: () => Element | null, title: string, clickAction: () => void, localizationTable?: ToolbarLocalization, mustBeToplevel?: boolean);
+    constructor(editor: Editor, id: string, makeIcon: () => Element | null, title: string, clickAction: () => void, localizationTable?: ToolbarLocalization, mustBeToplevel?: boolean, autoDisableInReadOnlyEditors?: boolean);
+    protected shouldAutoDisableInReadOnlyEditor(): boolean;
     protected handleClick(): void;
     protected getTitle(): string;
     protected createIcon(): Element | null;