js-draw 1.3.0 → 1.4.0

package/dist/cjs/{EditorImage.d.ts → image/EditorImage.d.ts}

@@ -1,11 +1,11 @@
-import AbstractRenderer from './rendering/renderers/AbstractRenderer';
-import Viewport from './Viewport';
-import AbstractComponent from './components/AbstractComponent';
+import AbstractRenderer from '../rendering/renderers/AbstractRenderer';
+import Viewport from '../Viewport';
+import AbstractComponent from '../components/AbstractComponent';
 import { Rect2 } from '@js-draw/math';
-import RenderingCache from './rendering/caching/RenderingCache';
-import SerializableCommand from './commands/SerializableCommand';
-import EventDispatcher from './EventDispatcher';
-import Command from './commands/Command';
+import RenderingCache from '../rendering/caching/RenderingCache';
+import SerializableCommand from '../commands/SerializableCommand';
+import EventDispatcher from '../EventDispatcher';
+import Command from '../commands/Command';
 export declare const sortLeavesByZIndex: (leaves: Array<ImageNode>) => void;
 export declare enum EditorImageEventType {
     ExportViewportChanged = 0,
@@ -14,6 +14,13 @@ export declare enum EditorImageEventType {
 export type EditorImageNotifier = EventDispatcher<EditorImageEventType, {
     image: EditorImage;
 }>;
+/**
+ * A callback used to
+ * 1. pause the render process
+ * 2. observe progress through `componentsProcessed` and `totalComponents`
+ * 3. stop the render process early by returning `false`.
+ */
+export type PreRenderComponentCallback = (component: AbstractComponent, componentsProcessed: number, totalComponents: number) => Promise<boolean>;
 export default class EditorImage {
     private root;
     private background;
@@ -36,7 +43,21 @@ export default class EditorImage {
      * the viewport used by the `renderer` (if any).
      */
     render(renderer: AbstractRenderer, viewport: Viewport | null): void;
-    /** 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
+     */
+    renderAllAsync(renderer: AbstractRenderer, preRenderComponent: PreRenderComponentCallback): Promise<boolean>;
+    /**
+     * Renders all nodes, even ones not within the viewport.
+     *
+     * This can be slow for large images
+     * @internal
+     */
     renderAll(renderer: AbstractRenderer): void;
     /**
      * @returns all elements in the image, sorted by z-index. This can be slow for large images.
@@ -136,6 +157,7 @@ export declare class ImageNode {
     private rebalance;
     protected removeChild(child: ImageNode): void;
     remove(): void;
+    renderAllAsync(renderer: AbstractRenderer, preRenderComponent: PreRenderComponentCallback): Promise<boolean>;
     render(renderer: AbstractRenderer, visibleRect?: Rect2): void;
     renderDebugBoundingBoxes(renderer: AbstractRenderer, visibleRect: Rect2, depth?: number): void;
 }

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/rendering/renderers/SVGRenderer.js

@@ -135,26 +135,18 @@ class SVGRenderer extends AbstractRenderer_1.default {
     }
     // Apply [elemTransform] to [elem]. Uses both a `matrix` and `.x`, `.y` properties if `setXY` is true.
     // Otherwise, just uses a `matrix`.
-    transformFrom(elemTransform, elem, inCanvasSpace = false, setXY = true) {
-        let transform = !inCanvasSpace ? this.getCanvasToScreenTransform().rightMul(elemTransform) : elemTransform;
-        const translation = transform.transformVec2(math_1.Vec2.zero);
-        if (setXY) {
-            transform = transform.rightMul(math_1.Mat33.translation(translation.times(-1)));
-        }
+    transformFrom(elemTransform, elem, inCanvasSpace = false) {
+        const transform = !inCanvasSpace ? this.getCanvasToScreenTransform().rightMul(elemTransform) : elemTransform;
         if (!transform.eq(math_1.Mat33.identity)) {
-            elem.style.transform = `matrix(
-				${transform.a1}, ${transform.b1},
-				${transform.a2}, ${transform.b2},
-				${transform.a3}, ${transform.b3}
-			)`;
+            const matrixString = transform.toCSSMatrix();
+            elem.style.transform = matrixString;
+            // Most browsers round the components of CSS transforms.
+            // Include a higher precision copy of the element's transform.
+            elem.setAttribute('data-highp-transform', matrixString);
         }
         else {
             elem.style.transform = '';
         }
-        if (setXY) {
-            elem.setAttribute('x', `${(0, math_1.toRoundedString)(translation.x)}`);
-            elem.setAttribute('y', `${(0, math_1.toRoundedString)(translation.y)}`);
-        }
     }
     drawText(text, transform, style) {
         const applyTextStyles = (elem, style) => {
@@ -190,10 +182,7 @@ class SVGRenderer extends AbstractRenderer_1.default {
         if (!this.textContainer) {
             const container = document.createElementNS(svgNameSpace, 'text');
             container.appendChild(document.createTextNode(text));
-            // Don't set .x/.y properties (just use .style.transform).
-            // Child nodes aren't translated by .x/.y properties, but are by .style.transform.
-            const setXY = false;
-            this.transformFrom(transform, container, true, setXY);
+            this.transformFrom(transform, container, true);
             applyTextStyles(container, style);
             this.elem.appendChild(container);
             this.objectElems?.push(container);

package/dist/cjs/rendering/renderers/SVGRenderer.test.d.ts

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

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,
         });
     }
     /**