js-draw 1.3.1 → 1.4.1

package/dist/mjs/localizations/es.mjs

@@ -1,68 +1,88 @@
 import  { defaultEditorLocalization }  from '../localization.mjs';
-// A partial Spanish localization.
+// A partial Spanish localization, created with /scripts/markdownTranslationFormToTs.ts
 const localization = {
     ...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`,
 };
 export default localization;

package/dist/mjs/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/mjs/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/mjs/rendering/caching/RenderingCacheNode.mjs

@@ -1,5 +1,5 @@
 // A cache record with sub-nodes.
-import  { sortLeavesByZIndex }  from '../../EditorImage.mjs';
+import  { sortLeavesByZIndex }  from '../../image/EditorImage.mjs';
 import { Rect2, Color4 } from '@js-draw/math';
 // 3x3 divisions for each node.
 const cacheDivisionSize = 3;
@@ -42,11 +42,12 @@ export default 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/mjs/rendering/renderers/AbstractRenderer.d.ts

@@ -73,4 +73,5 @@ export default abstract class AbstractRenderer {
     getCanvasToScreenTransform(): Mat33;
     canvasToScreen(vec: Vec2): Vec2;
     getSizeOfCanvasPixelOnScreen(): number;
+    getVisibleRect(): Rect2;
 }

package/dist/mjs/rendering/renderers/AbstractRenderer.mjs

@@ -158,4 +158,12 @@ export default class AbstractRenderer {
     getSizeOfCanvasPixelOnScreen() {
         return this.getCanvasToScreenTransform().transformVec3(Vec2.unitX).length();
     }
+    // Returns the region in canvas space that is visible within the viewport this
+    // canvas is rendering to.
+    //
+    // Note that in some cases this might not be the same as the `visibleRect` given
+    // to components in their `render` method.
+    getVisibleRect() {
+        return this.viewport.visibleRect;
+    }
 }

package/dist/mjs/rendering/renderers/SVGRenderer.d.ts

@@ -6,6 +6,15 @@ import TextRenderingStyle from '../TextRenderingStyle';
 import AbstractRenderer, { RenderableImage } from './AbstractRenderer';
 import RenderablePathSpec from '../RenderablePathSpec';
 export declare const renderedStylesheetId = "js-draw-style-sheet";
+type FromViewportOptions = {
+    sanitize?: boolean;
+    /**
+     * Rather than having the top left of the `viewBox` set to (0, 0),
+     * if `useViewBoxForPositioning` is `true`, the `viewBox`'s top left
+     * is based on the top left of the rendering viewport's `visibleRect`.
+     */
+    useViewBoxForPositioning?: boolean;
+};
 /**
  * Renders onto an `SVGElement`.
  *
@@ -50,8 +59,26 @@ export default class SVGRenderer extends AbstractRenderer {
     drawPoints(...points: Point2[]): void;
     drawSVGElem(elem: SVGElement): void;
     isTooSmallToRender(_rect: Rect2): boolean;
-    static fromViewport(viewport: Viewport, sanitize?: boolean): {
+    private visibleRectOverride;
+    /**
+     * Overrides the visible region returned by `getVisibleRect`.
+     *
+     * This is useful when the `viewport`'s transform has been modified,
+     * for example, to compensate for storing part of the image's
+     * transformation in an SVG property.
+     */
+    private overrideVisibleRect;
+    getVisibleRect(): Rect2;
+    /**
+     * Creates a new SVG element and `SVGRenerer` with `width`, `height`, `viewBox`,
+     * and other metadata attributes set for the given `Viewport`.
+     *
+     * If `options` is a `boolean`, it is interpreted as whether to sanitize (not add unknown
+     * SVG entities to) the output.
+     */
+    static fromViewport(viewport: Viewport, options?: FromViewportOptions | boolean): {
         element: SVGSVGElement;
         renderer: SVGRenderer;
     };
 }
+export {};

package/dist/mjs/rendering/renderers/SVGRenderer.mjs

@@ -36,6 +36,7 @@ export default class SVGRenderer extends AbstractRenderer {
         this.textContainer = null;
         this.textContainerTransform = null;
         this.textParentStyle = defaultTextStyle;
+        this.visibleRectOverride = null;
         this.clear();
         this.addStyleSheet();
     }
@@ -338,20 +339,70 @@ export default class SVGRenderer extends AbstractRenderer {
     isTooSmallToRender(_rect) {
         return false;
     }
-    // Creates a new SVG element and SVGRenerer with attributes set for the given Viewport.
-    static fromViewport(viewport, sanitize = true) {
+    /**
+     * Overrides the visible region returned by `getVisibleRect`.
+     *
+     * This is useful when the `viewport`'s transform has been modified,
+     * for example, to compensate for storing part of the image's
+     * transformation in an SVG property.
+     */
+    overrideVisibleRect(newRect) {
+        this.visibleRectOverride = newRect;
+    }
+    getVisibleRect() {
+        return this.visibleRectOverride ?? super.getVisibleRect();
+    }
+    /**
+     * Creates a new SVG element and `SVGRenerer` with `width`, `height`, `viewBox`,
+     * and other metadata attributes set for the given `Viewport`.
+     *
+     * If `options` is a `boolean`, it is interpreted as whether to sanitize (not add unknown
+     * SVG entities to) the output.
+     */
+    static fromViewport(viewport, options = true) {
+        let sanitize;
+        let useViewBoxForPositioning;
+        if (typeof options === 'boolean') {
+            sanitize = options;
+            useViewBoxForPositioning = false;
+        }
+        else {
+            sanitize = options.sanitize ?? true;
+            useViewBoxForPositioning = options.useViewBoxForPositioning ?? false;
+        }
         const svgNameSpace = 'http://www.w3.org/2000/svg';
         const result = document.createElementNS(svgNameSpace, 'svg');
-        const rect = viewport.getScreenRectSize();
+        const screenRectSize = viewport.getScreenRectSize();
+        const visibleRect = viewport.visibleRect;
+        let viewBoxComponents;
+        if (useViewBoxForPositioning) {
+            const exportRect = viewport.visibleRect;
+            viewBoxComponents = [
+                exportRect.x, exportRect.y, exportRect.w, exportRect.h,
+            ];
+            // Replace the viewport with a copy that has a modified transform.
+            // (Avoids modifying the original viewport).
+            viewport = viewport.getTemporaryClone();
+            // TODO: This currently discards any rotation information.
+            // Render with (0,0) at (0,0) -- the translation is handled by the viewBox.
+            viewport.resetTransform(Mat33.identity);
+        }
+        else {
+            viewBoxComponents = [0, 0, screenRectSize.x, screenRectSize.y];
+        }
         // rect.x -> size of rect in x direction, rect.y -> size of rect in y direction.
-        result.setAttribute('viewBox', [0, 0, rect.x, rect.y].map(part => toRoundedString(part)).join(' '));
-        result.setAttribute('width', toRoundedString(rect.x));
-        result.setAttribute('height', toRoundedString(rect.y));
+        result.setAttribute('viewBox', viewBoxComponents.map(part => toRoundedString(part)).join(' '));
+        result.setAttribute('width', toRoundedString(screenRectSize.x));
+        result.setAttribute('height', toRoundedString(screenRectSize.y));
         // Ensure the image can be identified as an SVG if downloaded.
         // See https://jwatt.org/svg/authoring/
         result.setAttribute('version', '1.1');
         result.setAttribute('baseProfile', 'full');
         result.setAttribute('xmlns', svgNameSpace);
-        return { element: result, renderer: new SVGRenderer(result, viewport, sanitize) };
+        const renderer = new SVGRenderer(result, viewport, sanitize);
+        if (!visibleRect.eq(viewport.visibleRect)) {
+            renderer.overrideVisibleRect(visibleRect);
+        }
+        return { element: result, renderer };
     }
 }

package/dist/mjs/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/mjs/toolbar/AbstractToolbar.mjs

@@ -230,7 +230,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 = () => {
@@ -239,16 +247,20 @@ class AbstractToolbar {
             }
             return title.icon;
         };
-        const widget = new ActionButtonWidget(this.editor, widgetId, makeIcon, titleString, command, this.editor.localization, mustBeToplevel);
+        const widget = new ActionButtonWidget(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;
     }
@@ -256,8 +268,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;
@@ -303,6 +315,8 @@ class AbstractToolbar {
             icon: this.editor.icons.makeCloseIcon(),
         }, () => {
             exitCallback();
+        }, {
+            autoDisableInReadOnlyEditors: false,
         });
     }
     /**

package/dist/mjs/toolbar/EdgeToolbar.mjs

@@ -191,7 +191,6 @@ export default class EdgeToolbar extends AbstractToolbar {
         };
         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');
@@ -201,11 +200,11 @@ export default class EdgeToolbar extends AbstractToolbar {
         }
         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/mjs/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/mjs/toolbar/IconProvider.mjs

@@ -164,6 +164,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/mjs/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;

package/dist/mjs/toolbar/widgets/ActionButtonWidget.mjs

@@ -1,11 +1,28 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ActionButtonWidget_autoDisableInReadOnlyEditors;
 import  BaseWidget  from './BaseWidget.mjs';
-export default class ActionButtonWidget extends BaseWidget {
-    constructor(editor, id, makeIcon, title, clickAction, localizationTable, mustBeToplevel = false) {
+class ActionButtonWidget extends BaseWidget {
+    constructor(editor, id, makeIcon, title, clickAction, localizationTable, mustBeToplevel = false, autoDisableInReadOnlyEditors = true) {
         super(editor, id, localizationTable);
         this.makeIcon = makeIcon;
         this.title = title;
         this.clickAction = clickAction;
         this.mustBeToplevel = mustBeToplevel;
+        _ActionButtonWidget_autoDisableInReadOnlyEditors.set(this, void 0);
+        __classPrivateFieldSet(this, _ActionButtonWidget_autoDisableInReadOnlyEditors, autoDisableInReadOnlyEditors, "f");
+    }
+    shouldAutoDisableInReadOnlyEditor() {
+        return __classPrivateFieldGet(this, _ActionButtonWidget_autoDisableInReadOnlyEditors, "f");
     }
     handleClick() {
         this.clickAction();
@@ -23,3 +40,5 @@ export default class ActionButtonWidget extends BaseWidget {
         return this.mustBeToplevel;
     }
 }
+_ActionButtonWidget_autoDisableInReadOnlyEditors = new WeakMap();
+export default ActionButtonWidget;

package/dist/mjs/toolbar/widgets/BaseToolWidget.d.ts

@@ -6,6 +6,7 @@ import BaseWidget from './BaseWidget';
 export default abstract class BaseToolWidget extends BaseWidget {
     protected targetTool: BaseTool;
     constructor(editor: Editor, targetTool: BaseTool, id: string, localizationTable?: ToolbarLocalization);
+    protected shouldAutoDisableInReadOnlyEditor(): boolean;
     protected handleClick(): void;
     protected onKeyPress(event: KeyPressEvent): boolean;
     addTo(parent: HTMLElement): HTMLElement;

package/dist/mjs/toolbar/widgets/BaseToolWidget.mjs

@@ -34,6 +34,9 @@ export default class BaseToolWidget extends BaseWidget {
             }
         });
     }
+    shouldAutoDisableInReadOnlyEditor() {
+        return !this.targetTool.canReceiveInputInReadOnlyEditor();
+    }
     handleClick() {
         if (this.hasDropdown) {
             if (!this.targetTool.isEnabled()) {

package/dist/mjs/toolbar/widgets/BaseWidget.d.ts

@@ -29,6 +29,11 @@ export default abstract class BaseWidget {
     private toplevel;
     protected readonly localizationTable: ToolbarLocalization;
     constructor(editor: Editor, id: string, localizationTable?: ToolbarLocalization);
+    /**
+     * Should return a constant true or false value. If true (the default),
+     * this widget must be automatically disabled when its editor is read-only.
+     */
+    protected shouldAutoDisableInReadOnlyEditor(): boolean;
     getId(): string;
     /**
      * Note: Tags should be set *before* a tool widget is added to a toolbar.