react-cheminfo 0.33.0 → 0.35.0

package/lib/download/ui/FigureDownloadPanel.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useChromeT } from "../../i18n/ui/useT.js";
 import { OverlayAction } from "../../overlay/ui/OverlayAction.js";
 import { OverlayPanel } from "../../overlay/ui/OverlayPanel.js";
@@ -6,8 +6,10 @@ import { OverlaySegmented } from "../../overlay/ui/OverlaySegmented.js";
 import { figureLayoutSize } from "../core/figureLayout.js";
 import { figurePixels, figureScaleFits, figureScaleLabel, formatFigurePixels, } from "../core/figureScale.js";
 import { FigureSizeRows } from "./FigureSizeRows.js";
+import { hintOf } from "./figureDownloadHint.js";
 /**
- * The choices behind the save glyph, and the button that writes the file.
+ * The choices behind the save glyph, and the buttons that write the file and
+ * copy the picture.
  *
  * The resolution applies to both formats, and means what the reader needs it
  * to: a PNG is painted with that many more pixels, and an SVG, drawn the same,
@@ -27,14 +29,14 @@ import { FigureSizeRows } from "./FigureSizeRows.js";
 export function FigureDownloadPanel(props) {
     const { title, format, scale, scales, size, failure, saving } = props;
     const { onFormatChange, onScaleChange, onSave, rasterSvg = false } = props;
-    const { sizing } = props;
+    const { sizing, onCopy, notice = null } = props;
     const t = useChromeT();
     // What the file is drawn at: the figure on screen, or the shape picked.
     const drawn = size === null || sizing === undefined
         ? size
         : figureLayoutSize(sizing.layout, size, sizing.custom ?? size);
     const painted = format === 'png' || rasterSvg;
-    return (_jsxs(OverlayPanel, { title: title, hint: hintOf(format, drawn, scale, failure, rasterSvg, t), actions: _jsx(OverlayAction, { text: t('download.save'), icon: "download", intent: "primary", disabled: saving || size === null, onClick: onSave }), children: [_jsx(OverlaySegmented, { label: t('download.format'), help: {
+    return (_jsxs(OverlayPanel, { title: title, width: PANEL_WIDTH, hint: hintOf({ format, size: drawn, scale, failure, notice, rasterSvg }, t), actions: _jsxs(_Fragment, { children: [_jsx(OverlayAction, { text: t('download.save'), icon: "download", intent: "primary", disabled: saving || size === null, onClick: onSave }), onCopy === undefined ? null : (_jsx(OverlayAction, { text: t('clipboard.copy'), icon: "clipboard", disabled: saving || size === null, onClick: onCopy }))] }), children: [_jsx(OverlaySegmented, { label: t('download.format'), help: {
                     title: t('download.format'),
                     body: t('download.formatHelp'),
                 }, value: format, options: FORMAT_CHOICES, onChange: onFormatChange }), sizing === undefined ? null : (_jsx(FigureSizeRows, { sizing: sizing, size: size })), _jsx(OverlaySegmented, { label: t('download.resolution'), help: {
@@ -46,6 +48,11 @@ export function FigureDownloadPanel(props) {
                     },
                 }, value: String(scale), options: scaleChoices(scales, drawn, painted), onChange: (picked) => onScaleChange(Number(picked)) })] }));
 }
+/**
+ * Wide enough for the longest hint on one line in English, so switching
+ * between PNG and SVG — whose hints differ in length — never resizes the panel.
+ */
+const PANEL_WIDTH = '27em';
 /** The two files a figure can leave the page as. */
 const FORMAT_CHOICES = [
     { value: 'png', label: 'PNG' },
@@ -75,30 +82,4 @@ function scaleChoices(scales, size, painted) {
     }
     return choices;
 }
-/**
- * The line at the foot of the panel: what pressing save is about to do.
- * @param format - Which file the reader is about to write.
- * @param size - How big the figure is drawn for the file.
- * @param scale - The multiple it is saved at.
- * @param failure - What went wrong last time, if anything.
- * @param rasterSvg - Whether the SVG embeds a rendered picture.
- * @param t - The chrome's formatter, so the sentence is in the language of
- * the page.
- * @returns The sentence.
- */
-function hintOf(format, size, scale, failure, rasterSvg, t) {
-    if (failure !== null)
-        return failure;
-    if (size === null)
-        return t('download.noFigure');
-    if (format === 'svg' && rasterSvg) {
-        return t('download.hintRasterSvg', {
-            pixels: formatFigurePixels(figurePixels(size, scale)),
-        });
-    }
-    const pixels = formatFigurePixels(figurePixels(size, scale));
-    return format === 'svg'
-        ? t('download.hintSvg', { pixels })
-        : t('download.hintPng', { pixels });
-}
 //# sourceMappingURL=FigureDownloadPanel.js.map

package/lib/download/ui/FigureDownloadPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"FigureDownloadPanel.js","sourceRoot":"","sources":["../../../src/download/ui/FigureDownloadPanel.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"FigureDownloadPanel.js","sourceRoot":"","sources":["../../../src/download/ui/FigureDownloadPanel.tsx"],"names":[],"mappings":"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"}

package/lib/download/ui/figureDownloadHint.d.ts

@@ -0,0 +1,30 @@
+import type { ChromeKey } from '../../i18n/core/chromeCatalog.ts';
+import type { Translate } from '../../i18n/ui/useT.ts';
+import type { FigureFormat } from '../core/downloadFigure.ts';
+import type { FigurePixels } from '../core/figureScale.ts';
+import type { FigureNotice } from './useFigureActions.ts';
+/** What the line at the foot of the panel is written from. */
+export interface HintState {
+    /** Which file the reader is about to write. */
+    format: FigureFormat;
+    /** How big the figure is drawn for the file. */
+    size: FigurePixels | null;
+    /** The multiple it is saved at. */
+    scale: number;
+    /** What went wrong last time, if anything. */
+    failure: string | null;
+    /** What the last copy came to, if anything. */
+    notice: FigureNotice | null;
+    /** Whether the SVG embeds a rendered picture. */
+    rasterSvg: boolean;
+}
+/**
+ * The line at the foot of the panel: what pressing save is about to do, or
+ * what the last copy did.
+ * @param state - See {@link HintState}.
+ * @param t - The chrome's formatter, so the sentence is in the language of
+ * the page.
+ * @returns The sentence.
+ */
+export declare function hintOf(state: HintState, t: Translate<ChromeKey>): string;
+//# sourceMappingURL=figureDownloadHint.d.ts.map

package/lib/download/ui/figureDownloadHint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figureDownloadHint.d.ts","sourceRoot":"","sources":["../../../src/download/ui/figureDownloadHint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,MAAM,EAAE,YAAY,CAAC;IACrB,gDAAgD;IAChD,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+CAA+C;IAC/C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,MAAM,CAmBxE"}

package/lib/download/ui/figureDownloadHint.js

@@ -0,0 +1,33 @@
+import { figurePixels, formatFigurePixels } from "../core/figureScale.js";
+/**
+ * The line at the foot of the panel: what pressing save is about to do, or
+ * what the last copy did.
+ * @param state - See {@link HintState}.
+ * @param t - The chrome's formatter, so the sentence is in the language of
+ * the page.
+ * @returns The sentence.
+ */
+export function hintOf(state, t) {
+    const { format, size, scale, failure, notice, rasterSvg } = state;
+    if (failure !== null)
+        return failure;
+    if (size === null)
+        return t('download.noFigure');
+    if (notice === 'copyUnsupported')
+        return t('download.copyUnsupported');
+    if (notice === 'copied') {
+        return t('download.hintCopied', {
+            pixels: formatFigurePixels(figurePixels(size, scale)),
+        });
+    }
+    if (format === 'svg' && rasterSvg) {
+        return t('download.hintRasterSvg', {
+            pixels: formatFigurePixels(figurePixels(size, scale)),
+        });
+    }
+    const pixels = formatFigurePixels(figurePixels(size, scale));
+    return format === 'svg'
+        ? t('download.hintSvg', { pixels })
+        : t('download.hintPng', { pixels });
+}
+//# sourceMappingURL=figureDownloadHint.js.map

package/lib/download/ui/figureDownloadHint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figureDownloadHint.js","sourceRoot":"","sources":["../../../src/download/ui/figureDownloadHint.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAoB1E;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,KAAgB,EAAE,CAAuB;IAC9D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAClE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC;IACrC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACjD,IAAI,MAAM,KAAK,iBAAiB;QAAE,OAAO,CAAC,CAAC,0BAA0B,CAAC,CAAC;IACvE,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,qBAAqB,EAAE;YAC9B,MAAM,EAAE,kBAAkB,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,KAAK,KAAK,IAAI,SAAS,EAAE,CAAC;QAClC,OAAO,CAAC,CAAC,wBAAwB,EAAE;YACjC,MAAM,EAAE,kBAAkB,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7D,OAAO,MAAM,KAAK,KAAK;QACrB,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/lib/download/ui/index.d.ts

@@ -12,14 +12,7 @@ export type { FigureDownloadPanelProps } from './FigureDownloadPanel.tsx';
 export { FigureDownloadPanel } from './FigureDownloadPanel.tsx';
 export type { FigureSizing } from './FigureSizeRows.tsx';
 export type { FigureRenderer } from './useFigureRedraw.tsx';
-export type { ExportDialogFrameProps } from './ExportDialogFrame.tsx';
-export { ExportDialogFrame } from './ExportDialogFrame.tsx';
-export type { ExportImageDialogProps } from './ExportImageDialog.tsx';
-export { ExportImageDialog } from './ExportImageDialog.tsx';
-export type { ExportNameFieldProps } from './ExportNameField.tsx';
-export { ExportNameField } from './ExportNameField.tsx';
-export type { ExportPictureSectionProps } from './ExportPictureSection.tsx';
-export { ExportPictureSection } from './ExportPictureSection.tsx';
-export type { DrawingBox } from './useDrawingBox.ts';
-export { useDrawingBox } from './useDrawingBox.ts';
+export type { FigureDownloadOptions, FigureDownloadState, } from './useFigureDownload.tsx';
+export { useFigureDownload } from './useFigureDownload.tsx';
+export type { FigureNotice } from './useFigureActions.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/download/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/download/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/download/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,YAAY,EACV,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/download/ui/index.js

@@ -8,9 +8,5 @@
  */
 export { FigureDownload } from "./FigureDownload.js";
 export { FigureDownloadPanel } from "./FigureDownloadPanel.js";
-export { ExportDialogFrame } from "./ExportDialogFrame.js";
-export { ExportImageDialog } from "./ExportImageDialog.js";
-export { ExportNameField } from "./ExportNameField.js";
-export { ExportPictureSection } from "./ExportPictureSection.js";
-export { useDrawingBox } from "./useDrawingBox.js";
+export { useFigureDownload } from "./useFigureDownload.js";
 //# sourceMappingURL=index.js.map

package/lib/download/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/download/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA2B,CAAC;AAKhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA4B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/download/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA2B,CAAC;AAQhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC"}

package/lib/download/ui/useFigureActions.d.ts

@@ -0,0 +1,50 @@
+import type { FigureFormat } from '../core/downloadFigure.ts';
+import type { FigurePixels } from '../core/figureScale.ts';
+import type { FigureRedraw } from './useFigureRedraw.tsx';
+/** What the last copy came to, when it is worth a line of its own. */
+export type FigureNotice = 'copied' | 'copyUnsupported';
+/** What {@link useFigureActions} works from. */
+export interface FigureActionsOptions {
+    /** The `id` of the box the figure is mounted in. */
+    targetId: string;
+    /** Which file save writes. */
+    format: FigureFormat;
+    /** The multiple of the figure on screen it is painted at. */
+    scale: number;
+    /** What the saved file is called, without its extension. */
+    fileName?: string;
+    /** What is painted under the figure. */
+    background?: string;
+    /**
+     * The size the figure is drawn again at, off the page, or `null` to take
+     * the figure as it is on screen.
+     */
+    redrawAt: FigurePixels | null;
+    /** Draws the figure again, from {@link FigureRedraw}. */
+    redraw: FigureRedraw['redraw'];
+}
+/** What {@link useFigureActions} hands back. */
+export interface FigureActions {
+    /** Write the figure to a file, in the format picked. */
+    save: () => void;
+    /** Put the figure on the clipboard, as a PNG at the resolution picked. */
+    copy: () => void;
+    /** Whether a file or a copy is being written right now. */
+    busy: boolean;
+    /** What went wrong the last time, if anything. */
+    failure: string | null;
+    /** What the last copy came to, if it is still what the panel describes. */
+    notice: FigureNotice | null;
+    /** Forget the last outcome, once the choices it answered have changed. */
+    clear: () => void;
+}
+/**
+ * The two things the figure panel does: save the figure, and copy it.
+ *
+ * A copy is always a PNG, whatever format save is set to: a clipboard carries
+ * a picture, and the one every slide, chat window and issue accepts is a PNG.
+ * @param options - See {@link FigureActionsOptions}.
+ * @returns See {@link FigureActions}.
+ */
+export declare function useFigureActions(options: FigureActionsOptions): FigureActions;
+//# sourceMappingURL=useFigureActions.d.ts.map

package/lib/download/ui/useFigureActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFigureActions.d.ts","sourceRoot":"","sources":["../../../src/download/ui/useFigureActions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAExD,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,yDAAyD;IACzD,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CAChC;AAED,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAqD7E"}

package/lib/download/ui/useFigureActions.js

@@ -0,0 +1,58 @@
+import { useCallback, useState } from 'react';
+import { writeImageToClipboard } from "../../clipboard/core/copyPng.js";
+import { downloadFigure } from "../core/downloadFigure.js";
+import { figurePng } from "../core/figurePng.js";
+import { figureSvg } from "../core/figureSvg.js";
+/**
+ * The two things the figure panel does: save the figure, and copy it.
+ *
+ * A copy is always a PNG, whatever format save is set to: a clipboard carries
+ * a picture, and the one every slide, chat window and issue accepts is a PNG.
+ * @param options - See {@link FigureActionsOptions}.
+ * @returns See {@link FigureActions}.
+ */
+export function useFigureActions(options) {
+    const { targetId, format, scale, fileName, background } = options;
+    const { redrawAt, redraw } = options;
+    const [busy, setBusy] = useState(false);
+    const [failure, setFailure] = useState(null);
+    const [notice, setNotice] = useState(null);
+    function withFigure(write) {
+        return redrawAt === null
+            ? write(targetId)
+            : redraw(targetId, redrawAt, write);
+    }
+    function run(task) {
+        setBusy(true);
+        setFailure(null);
+        setNotice(null);
+        void task
+            .then(setNotice, (error) => {
+            setFailure(error instanceof Error ? error.message : String(error));
+        })
+            .finally(() => setBusy(false));
+    }
+    function save() {
+        const options = { format, scale, fileName, background };
+        run(withFigure((box) => downloadFigure(box, options)).then(() => null));
+    }
+    function copy() {
+        // The clipboard is written before anything is awaited, with the picture
+        // still being painted: Safari only allows a write the click itself started.
+        const png = new Promise((resolve, reject) => {
+            withFigure(async (box) => {
+                resolve(await figurePng(figureSvg(box, { background }), scale));
+            }).catch(reject);
+        });
+        // A browser whose clipboard takes text only never reads the picture, so
+        // its failure would otherwise go unhandled.
+        png.catch(() => undefined);
+        run(writeImageToClipboard(png).then((copied) => copied ? 'copied' : 'copyUnsupported'));
+    }
+    const clear = useCallback(() => {
+        setFailure(null);
+        setNotice(null);
+    }, []);
+    return { save, copy, busy, failure, notice, clear };
+}
+//# sourceMappingURL=useFigureActions.js.map

package/lib/download/ui/useFigureActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFigureActions.js","sourceRoot":"","sources":["../../../src/download/ui/useFigureActions.ts"],"names":[],"mappings":"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"}

package/lib/download/ui/useFigureDownload.d.ts

@@ -0,0 +1,85 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { FigureFormat } from '../core/downloadFigure.ts';
+import type { FigureRenderer } from './useFigureRedraw.tsx';
+/** What the "Save figure" panel is set up with. */
+export interface FigureDownloadOptions {
+    /**
+     * The `id` of the box the figure is mounted in. Everything drawn inside it
+     * is saved — sixteen charts of a pair grid as readily as one scatter plot —
+     * and the controls floating over it are left behind.
+     */
+    targetId: string;
+    /**
+     * What the saved file is called, without its extension. Name it after the
+     * data rather than after the tool: a reader with four of these in a
+     * downloads folder cannot tell four `figure.png` apart.
+     * @default 'figure'
+     */
+    fileName?: string;
+    /**
+     * The format it opens on.
+     * @default 'png'
+     */
+    defaultFormat?: FigureFormat;
+    /**
+     * The resolution a PNG opens on, as a multiple of the figure on screen. An
+     * SVG opens at 1×, the size it has on screen, and each format keeps the
+     * multiple the reader last picked for it.
+     * @default 2
+     */
+    defaultScale?: number;
+    /**
+     * The resolutions offered.
+     * @default [1, 2, 3, 4]
+     */
+    scales?: readonly number[];
+    /**
+     * What is painted under the figure. `transparent` leaves it unpainted, for a
+     * figure going onto a coloured slide.
+     * @default the surface the figure is drawn on
+     */
+    background?: string;
+    /**
+     * What the panel is called.
+     * @default the chrome's own line, in the language of the page
+     */
+    title?: string;
+    /**
+     * Draws the figure at a size, for a file. When it is given the panel offers
+     * a size — as shown, 4:3, 16:9, a journal column, or typed — and a figure
+     * saved at a size other than its own is drawn again at that size, off the
+     * page, so its axes and labels are laid out for the new shape rather than
+     * stretched into it. Draw exactly what is on screen, with the same data,
+     * zoom and colours; only the box changes.
+     * @default undefined — the figure is saved at the size it has on screen
+     */
+    renderFigure?: FigureRenderer;
+}
+/** What {@link useFigureDownload} hands back. */
+export interface FigureDownloadState {
+    /** Whether the panel is showing. */
+    isOpen: boolean;
+    /**
+     * Show or hide the panel. Showing it measures the figure, so hand this to
+     * the popover's `onInteraction` rather than a setter of your own.
+     */
+    setOpen: (open: boolean) => void;
+    /** The panel, for the popover's `content`. */
+    panel: ReactElement;
+    /** The format picked, for a trigger that shows it. */
+    format: FigureFormat;
+    /**
+     * The copy drawn off the page while a figure is saved at another size, to
+     * be rendered anywhere in the caller's tree.
+     */
+    portal: ReactNode;
+}
+/**
+ * The "Save figure" panel — save as PNG or SVG, or copy as PNG — for a caller
+ * that brings its own trigger, such as a button in an editor's toolbar.
+ * `FigureDownload` is the same panel behind the family's own glyph.
+ * @param options - See {@link FigureDownloadOptions}.
+ * @returns See {@link FigureDownloadState}.
+ */
+export declare function useFigureDownload(options: FigureDownloadOptions): FigureDownloadState;
+//# sourceMappingURL=useFigureDownload.d.ts.map

package/lib/download/ui/useFigureDownload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFigureDownload.d.ts","sourceRoot":"","sources":["../../../src/download/ui/useFigureDownload.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAa9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,8CAA8C;IAC9C,KAAK,EAAE,YAAY,CAAC;IACpB,sDAAsD;IACtD,MAAM,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,qBAAqB,GAC7B,mBAAmB,CAsFrB"}

package/lib/download/ui/useFigureDownload.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useState } from 'react';
+import { useChromeT } from "../../i18n/ui/useT.js";
+import { figureLayoutRedraws, figureLayoutSize } from "../core/figureLayout.js";
+import { DEFAULT_FIGURE_SCALE, FIGURE_SCALES, defaultFigureScale, } from "../core/figureScale.js";
+import { figureSize } from "../core/figureTarget.js";
+import { FigureDownloadPanel } from "./FigureDownloadPanel.js";
+import { useFigureActions } from "./useFigureActions.js";
+import { useFigureRedraw } from "./useFigureRedraw.js";
+/**
+ * The "Save figure" panel — save as PNG or SVG, or copy as PNG — for a caller
+ * that brings its own trigger, such as a button in an editor's toolbar.
+ * `FigureDownload` is the same panel behind the family's own glyph.
+ * @param options - See {@link FigureDownloadOptions}.
+ * @returns See {@link FigureDownloadState}.
+ */
+export function useFigureDownload(options) {
+    const { targetId, fileName, background, scales = FIGURE_SCALES } = options;
+    const { defaultFormat = 'png', defaultScale = DEFAULT_FIGURE_SCALE } = options;
+    const { title, renderFigure } = options;
+    const t = useChromeT();
+    const [isOpen, setIsOpen] = useState(false);
+    const [format, setFormat] = useState(defaultFormat);
+    const [picked, setPicked] = useState(() => ({
+        png: defaultScale,
+        svg: defaultFigureScale('svg'),
+    }));
+    const scale = picked[format];
+    const [size, setSize] = useState(null);
+    const [layout, setLayout] = useState('screen');
+    const [custom, setCustom] = useState(null);
+    const { redraw, portal } = useFigureRedraw(renderFigure);
+    const redrawAt = renderFigure !== undefined &&
+        size !== null &&
+        figureLayoutRedraws(layout, size, custom ?? size)
+        ? figureLayoutSize(layout, size, custom ?? size)
+        : null;
+    const { save, copy, busy, failure, notice, clear } = useFigureActions({
+        targetId,
+        format,
+        scale,
+        fileName,
+        background,
+        redrawAt,
+        redraw,
+    });
+    // The panel is held open from here rather than left to itself, because the
+    // figure has to be measured at the moment it opens: its size is what the
+    // panel writes out, and reading a bounding box on every render would cost a
+    // layout pass on a bar that is re-rendered on every pointer move.
+    const setOpen = useCallback((next) => {
+        setIsOpen(next);
+        if (!next)
+            return;
+        setSize(figureSize(targetId));
+        clear();
+    }, [targetId, clear]);
+    // What the last copy came to only describes the choices it was made with.
+    function changed(apply) {
+        return (value) => {
+            clear();
+            apply(value);
+        };
+    }
+    const panel = (_jsx(FigureDownloadPanel, { title: title ?? t('download.saveFigure'), format: format, scale: scale, scales: scales, size: size, failure: failure, notice: notice, saving: busy, onFormatChange: changed(setFormat), onScaleChange: changed((next) => setPicked((current) => ({ ...current, [format]: next }))), onSave: save, onCopy: copy, sizing: renderFigure === undefined
+            ? undefined
+            : {
+                layout,
+                custom,
+                onLayoutChange: changed(setLayout),
+                onCustomChange: changed(setCustom),
+            } }));
+    return { isOpen, setOpen, panel, format, portal };
+}
+//# sourceMappingURL=useFigureDownload.js.map

package/lib/download/ui/useFigureDownload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFigureDownload.js","sourceRoot":"","sources":["../../../src/download/ui/useFigureDownload.tsx"],"names":[],"mappings":"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"}

package/lib/ecosystem/core/sites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sites.d.ts","sourceRoot":"","sources":["../../../src/ecosystem/core/sites.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,YAAY,EACV,aAAa,EACb,MAAM,EACN,cAAc,EACd,QAAQ,EACR,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EA+TnD,CAAC;AAEF,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,cAAmB,GAC3B,MAAM,CAER"}
+{"version":3,"file":"sites.d.ts","sourceRoot":"","sources":["../../../src/ecosystem/core/sites.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,YAAY,EACV,aAAa,EACb,MAAM,EACN,cAAc,EACd,QAAQ,EACR,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAuRnD,CAAC;AAEF,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,cAAmB,GAC3B,MAAM,CAER"}