react-cheminfo 0.27.0 → 0.29.0

package/lib/download/core/imageResolution.d.ts

@@ -0,0 +1,88 @@
+/** How big a picture is written out, as a multiple of the size it is drawn at. */
+export interface ImageResolution {
+    /** Identifies the resolution in a picker. */
+    id: string;
+    /** What the option reads. */
+    label: string;
+    /** How many pixels each drawing unit becomes. */
+    scale: number;
+}
+/**
+ * The sizes a picture leaves the editor at.
+ *
+ * A drawing unit is about a screen pixel, so the multipliers read as what the
+ * picture is for rather than as numbers: what is on screen, the same again on a
+ * retina display, and the two steps up a figure needs to survive being printed
+ * or thrown on a wall.
+ */
+export declare const IMAGE_RESOLUTIONS: readonly [{
+    readonly id: "screen";
+    readonly label: "Screen (1×)";
+    readonly scale: 1;
+}, {
+    readonly id: "retina";
+    readonly label: "Retina (2×)";
+    readonly scale: 2;
+}, {
+    readonly id: "print";
+    readonly label: "Print (4×)";
+    readonly scale: 4;
+}, {
+    readonly id: "poster";
+    readonly label: "Poster (8×)";
+    readonly scale: 8;
+}];
+/** One of the resolutions offered. */
+export type ImageResolutionId = (typeof IMAGE_RESOLUTIONS)[number]['id'];
+/**
+ * The resolution a picture is written out at unless another is picked: what is
+ * on screen, doubled, which is what a picture pasted into a document wants.
+ */
+export declare const DEFAULT_IMAGE_RESOLUTION: {
+    readonly id: "retina";
+    readonly label: "Retina (2×)";
+    readonly scale: 2;
+};
+/** How big a picture comes out, in pixels. */
+export interface ImageSize {
+    /** Width of the picture, in pixels. */
+    width: number;
+    /** Height of the picture, in pixels. */
+    height: number;
+    /**
+     * What each drawing unit was actually worth. Below the resolution that was
+     * asked for when it would have made a picture too big to rasterize.
+     */
+    scale: number;
+}
+/**
+ * How big a rectangle of the drawing comes out at a given resolution.
+ *
+ * The resolution is a wish rather than an instruction: a wide glycan asked for
+ * at 8× would run past what a browser can rasterize and come back blank, so the
+ * scale is brought down until the picture fits instead. The scale it settled on
+ * comes back with the size, so what will actually be written can be shown
+ * before it is.
+ * @param box - The rectangle being written out.
+ * @param box.width - How wide it is, in drawing units.
+ * @param box.height - How tall it is, in drawing units.
+ * @param scale - How many pixels each drawing unit should become.
+ * @returns The size, and the scale it was reached at.
+ */
+export declare function imageSize(box: {
+    width: number;
+    height: number;
+}, scale: number): ImageSize;
+/**
+ * The resolution an identifier stands for.
+ * @param id - What was picked.
+ * @returns The resolution, falling back to the default one.
+ */
+export declare function imageResolution(id: string): ImageResolution;
+/**
+ * A size, written the way it is shown next to the resolution it comes from.
+ * @param size - The size to write, `null` when nothing is drawn.
+ * @returns The text, e.g. `1440 × 620 px`.
+ */
+export declare function formatImageSize(size: ImageSize | null): string;
+//# sourceMappingURL=imageResolution.d.ts.map

package/lib/download/core/imageResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageResolution.d.ts","sourceRoot":"","sources":["../../../src/download/core/imageResolution.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;EAKiB,CAAC;AAEhD,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;CAAuB,CAAC;AAa7D,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACtC,KAAK,EAAE,MAAM,GACZ,SAAS,CAoBX;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAG9D"}

package/lib/download/core/imageResolution.js

@@ -0,0 +1,77 @@
+/**
+ * The sizes a picture leaves the editor at.
+ *
+ * A drawing unit is about a screen pixel, so the multipliers read as what the
+ * picture is for rather than as numbers: what is on screen, the same again on a
+ * retina display, and the two steps up a figure needs to survive being printed
+ * or thrown on a wall.
+ */
+export const IMAGE_RESOLUTIONS = [
+    { id: 'screen', label: 'Screen (1×)', scale: 1 },
+    { id: 'retina', label: 'Retina (2×)', scale: 2 },
+    { id: 'print', label: 'Print (4×)', scale: 4 },
+    { id: 'poster', label: 'Poster (8×)', scale: 8 },
+];
+/**
+ * The resolution a picture is written out at unless another is picked: what is
+ * on screen, doubled, which is what a picture pasted into a document wants.
+ */
+export const DEFAULT_IMAGE_RESOLUTION = IMAGE_RESOLUTIONS[1];
+/**
+ * Longest side a browser rasterizes reliably.
+ *
+ * Above roughly this, Safari and Chrome quietly hand back an empty canvas
+ * instead of refusing, so the picture would be saved blank.
+ */
+const MAXIMUM_SIDE = 8192;
+/** Most pixels a rasterized picture is allowed to hold. */
+const MAXIMUM_PIXELS = 32 * 1024 * 1024;
+/**
+ * How big a rectangle of the drawing comes out at a given resolution.
+ *
+ * The resolution is a wish rather than an instruction: a wide glycan asked for
+ * at 8× would run past what a browser can rasterize and come back blank, so the
+ * scale is brought down until the picture fits instead. The scale it settled on
+ * comes back with the size, so what will actually be written can be shown
+ * before it is.
+ * @param box - The rectangle being written out.
+ * @param box.width - How wide it is, in drawing units.
+ * @param box.height - How tall it is, in drawing units.
+ * @param scale - How many pixels each drawing unit should become.
+ * @returns The size, and the scale it was reached at.
+ */
+export function imageSize(box, scale) {
+    const wanted = Number.isFinite(scale) && scale > 0 ? scale : 1;
+    const width = Math.max(box.width, 1);
+    const height = Math.max(box.height, 1);
+    const limit = Math.min(MAXIMUM_SIDE / width, MAXIMUM_SIDE / height, Math.sqrt(MAXIMUM_PIXELS / (width * height)));
+    const used = Math.min(wanted, limit);
+    // A picture held back by the limit is rounded down rather than to the nearest
+    // pixel, so rounding cannot put it back over what it was held to.
+    const toPixels = used < wanted ? Math.floor : Math.round;
+    return {
+        width: Math.max(1, toPixels(width * used)),
+        height: Math.max(1, toPixels(height * used)),
+        scale: used,
+    };
+}
+/**
+ * The resolution an identifier stands for.
+ * @param id - What was picked.
+ * @returns The resolution, falling back to the default one.
+ */
+export function imageResolution(id) {
+    return (IMAGE_RESOLUTIONS.find((resolution) => resolution.id === id) ??
+        DEFAULT_IMAGE_RESOLUTION);
+}
+/**
+ * A size, written the way it is shown next to the resolution it comes from.
+ * @param size - The size to write, `null` when nothing is drawn.
+ * @returns The text, e.g. `1440 × 620 px`.
+ */
+export function formatImageSize(size) {
+    if (!size)
+        return 'nothing to export';
+    return `${size.width} × ${size.height} px`;
+}
+//# sourceMappingURL=imageResolution.js.map

package/lib/download/core/imageResolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageResolution.js","sourceRoot":"","sources":["../../../src/download/core/imageResolution.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE;IAChD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE;IAChD,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE;IAC9C,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE;CACH,CAAC;AAKhD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,2DAA2D;AAC3D,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAexC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CACvB,GAAsC,EACtC,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,YAAY,GAAG,KAAK,EACpB,YAAY,GAAG,MAAM,EACrB,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAC7C,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,8EAA8E;IAC9E,kEAAkE;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAEzD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAC5C,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,CACL,iBAAiB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC;QAC5D,wBAAwB,CACzB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAsB;IACpD,IAAI,CAAC,IAAI;QAAE,OAAO,mBAAmB,CAAC;IACtC,OAAO,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM,KAAK,CAAC;AAC7C,CAAC"}

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

@@ -15,4 +15,17 @@ export { figureLegendMarkup } from './figureLegend.ts';
 export type { FigureBounds } from './figureTarget.ts';
 export { figureBounds, figureDrawings, figureElement, figureLegends, figureSize, } from './figureTarget.ts';
 export { sanitizeFileName } from './sanitizeFileName.ts';
+export { exportButtonsStyle, exportNoteStyle, exportSectionStyle, } from './exportStyles.ts';
+export type { ImageResolution, ImageResolutionId, ImageSize, } from './imageResolution.ts';
+export { DEFAULT_IMAGE_RESOLUTION, IMAGE_RESOLUTIONS, formatImageSize, imageResolution, imageSize, } from './imageResolution.ts';
+export type { PictureFrame, PictureOptions } from './pictureExport.ts';
+export { PICTURE_PADDING, copyPicture, pictureSize, savePngPicture, saveSvgPicture, } from './pictureExport.ts';
+export { drawingIn, stackDrawings } from './stackedDrawing.ts';
+export type { SvgBox } from './svgBounds.ts';
+export { CONTENT_ATTRIBUTE, contentBox, elementBox } from './svgBounds.ts';
+export { SVG_NAMESPACE } from './svgNamespace.ts';
+export type { PngOptions } from './svgToPng.ts';
+export { svgToPng } from './svgToPng.ts';
+export type { SvgDocumentOptions } from './svgToString.ts';
+export { svgToString } from './svgToString.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/download/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EACV,WAAW,EACX,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/download/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EACV,WAAW,EACX,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EACL,eAAe,EACf,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/download/core/index.js

@@ -9,4 +9,12 @@ export { figureSvgDocument } from "./figureSvgDocument.js";
 export { figureLegendMarkup } from "./figureLegend.js";
 export { figureBounds, figureDrawings, figureElement, figureLegends, figureSize, } from "./figureTarget.js";
 export { sanitizeFileName } from "./sanitizeFileName.js";
+export { exportButtonsStyle, exportNoteStyle, exportSectionStyle, } from "./exportStyles.js";
+export { DEFAULT_IMAGE_RESOLUTION, IMAGE_RESOLUTIONS, formatImageSize, imageResolution, imageSize, } from "./imageResolution.js";
+export { PICTURE_PADDING, copyPicture, pictureSize, savePngPicture, saveSvgPicture, } from "./pictureExport.js";
+export { drawingIn, stackDrawings } from "./stackedDrawing.js";
+export { CONTENT_ATTRIBUTE, contentBox, elementBox } from "./svgBounds.js";
+export { SVG_NAMESPACE } from "./svgNamespace.js";
+export { svgToPng } from "./svgToPng.js";
+export { svgToString } from "./svgToString.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/download/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/download/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/download/core/pictureExport.d.ts

@@ -0,0 +1,93 @@
+import type { ImageSize } from './imageResolution.ts';
+/**
+ * Room left around a drawing in a written-out picture, in drawing units.
+ *
+ * Enough that a name written under the bottom of the drawing, and the stroke
+ * around its outermost mark, are inside the picture rather than against its
+ * edge.
+ */
+export declare const PICTURE_PADDING = 12;
+/**
+ * What the picture is of: the drawing, or the element it is drawn in.
+ *
+ * `content` measures the drawing and ignores the canvas around it, which is
+ * what a drawing surface wants — it is mostly empty space, panned and zoomed to
+ * wherever it was last left, and none of that belongs in a file. `element`
+ * takes the element as it is laid out, which is what a chart wants: its axes
+ * are drawn to the box it was given, so the box *is* the picture and measuring
+ * the marks inside it would crop the frame to wherever the data happens to
+ * reach.
+ */
+export type PictureFrame = 'content' | 'element';
+export interface PictureOptions {
+    /**
+     * How many pixels each drawing unit becomes.
+     * @default 2
+     */
+    scale?: number;
+    /**
+     * The name saved files take, without their extension.
+     * @default 'picture'
+     */
+    filename?: string;
+    /**
+     * What the picture is read out as, in place of the instructions the element
+     * carries for whoever is working it.
+     * @default 'Drawing'
+     */
+    label?: string;
+    /**
+     * What the picture is of.
+     * @default 'content'
+     */
+    frame?: PictureFrame;
+    /**
+     * Room left around the drawing, in drawing units. Ignored when the picture is
+     * the element, which is already the size it wants to be.
+     * @default PICTURE_PADDING
+     */
+    padding?: number;
+}
+/**
+ * How big the drawing comes out at a resolution, before it is written out.
+ *
+ * What is measured is what the picture will be of rather than whatever is on
+ * screen, so the answer does not change when the window is resized or the
+ * drawing panned — the size shown next to the resolution is the size of the
+ * file that is about to be written.
+ * @param svg - The element, as it is rendered.
+ * @param scale - How many pixels each drawing unit becomes.
+ * @param options - What the picture is of.
+ * @returns The size, or `null` when nothing is drawn.
+ */
+export declare function pictureSize(svg: SVGSVGElement | null, scale: number, options?: Pick<PictureOptions, 'frame' | 'padding'>): ImageSize | null;
+/**
+ * Put the drawing on the clipboard as a PNG.
+ *
+ * The rasterization is handed to the clipboard as a promise rather than awaited
+ * first: Safari only allows a clipboard write the click itself started.
+ * @param svg - The element, as it is rendered.
+ * @param options - How big to make it.
+ * @returns Whether it was copied. `false` when nothing is drawn, and in a
+ *   browser whose clipboard takes text only.
+ */
+export declare function copyPicture(svg: SVGSVGElement | null, options?: PictureOptions): Promise<boolean>;
+/**
+ * Save the drawing as a PNG.
+ * @param svg - The element, as it is rendered.
+ * @param options - How big to make it, and what to call it.
+ * @returns Whether it was saved. `false` when nothing is drawn.
+ */
+export declare function savePngPicture(svg: SVGSVGElement | null, options?: PictureOptions): Promise<boolean>;
+/**
+ * Save the drawing as an SVG.
+ *
+ * The resolution is carried into the file as the size it opens at, but the
+ * shapes stay shapes: an SVG printed at any size is drawn again rather than
+ * enlarged, which is the reason to prefer it wherever it can go.
+ * @param svg - The element, as it is rendered.
+ * @param options - How big to make it, and what to call it.
+ * @returns Whether it was saved. `false` when nothing is drawn.
+ */
+export declare function saveSvgPicture(svg: SVGSVGElement | null, options?: PictureOptions): boolean;
+//# sourceMappingURL=pictureExport.d.ts.map

package/lib/download/core/pictureExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pictureExport.d.ts","sourceRoot":"","sources":["../../../src/download/core/pictureExport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAOtD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,SAAS,CAAM,GACtD,SAAS,GAAG,IAAI,CAGlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAST"}

package/lib/download/core/pictureExport.js

@@ -0,0 +1,116 @@
+import { writeImageToClipboard } from "../../clipboard/core/copyPng.js";
+import { downloadBlob } from "./downloadBlob.js";
+import { downloadText } from "./downloadText.js";
+import { imageSize } from "./imageResolution.js";
+import { contentBox, elementBox } from "./svgBounds.js";
+import { svgToPng } from "./svgToPng.js";
+import { svgToString } from "./svgToString.js";
+/**
+ * Room left around a drawing in a written-out picture, in drawing units.
+ *
+ * Enough that a name written under the bottom of the drawing, and the stroke
+ * around its outermost mark, are inside the picture rather than against its
+ * edge.
+ */
+export const PICTURE_PADDING = 12;
+/**
+ * How big the drawing comes out at a resolution, before it is written out.
+ *
+ * What is measured is what the picture will be of rather than whatever is on
+ * screen, so the answer does not change when the window is resized or the
+ * drawing panned — the size shown next to the resolution is the size of the
+ * file that is about to be written.
+ * @param svg - The element, as it is rendered.
+ * @param scale - How many pixels each drawing unit becomes.
+ * @param options - What the picture is of.
+ * @returns The size, or `null` when nothing is drawn.
+ */
+export function pictureSize(svg, scale, options = {}) {
+    const box = svg && pictureBox(svg, options);
+    return box && imageSize(box, scale);
+}
+/**
+ * Put the drawing on the clipboard as a PNG.
+ *
+ * The rasterization is handed to the clipboard as a promise rather than awaited
+ * first: Safari only allows a clipboard write the click itself started.
+ * @param svg - The element, as it is rendered.
+ * @param options - How big to make it.
+ * @returns Whether it was copied. `false` when nothing is drawn, and in a
+ *   browser whose clipboard takes text only.
+ */
+export async function copyPicture(svg, options = {}) {
+    const written = describe(svg, options);
+    if (!written)
+        return false;
+    return await writeImageToClipboard(svgToPng(written.svg, written.png));
+}
+/**
+ * Save the drawing as a PNG.
+ * @param svg - The element, as it is rendered.
+ * @param options - How big to make it, and what to call it.
+ * @returns Whether it was saved. `false` when nothing is drawn.
+ */
+export async function savePngPicture(svg, options = {}) {
+    const written = describe(svg, options);
+    if (!written)
+        return false;
+    downloadBlob(await svgToPng(written.svg, written.png), `${written.name}.png`);
+    return true;
+}
+/**
+ * Save the drawing as an SVG.
+ *
+ * The resolution is carried into the file as the size it opens at, but the
+ * shapes stay shapes: an SVG printed at any size is drawn again rather than
+ * enlarged, which is the reason to prefer it wherever it can go.
+ * @param svg - The element, as it is rendered.
+ * @param options - How big to make it, and what to call it.
+ * @returns Whether it was saved. `false` when nothing is drawn.
+ */
+export function saveSvgPicture(svg, options = {}) {
+    const written = describe(svg, options);
+    if (!written)
+        return false;
+    downloadText(svgToString(written.svg, written.png), `${written.name}.svg`, 'image/svg+xml');
+    return true;
+}
+/**
+ * The rectangle a picture of the element would cover, in drawing units.
+ * @param svg - The element, as it is rendered.
+ * @param options - What the picture is of.
+ * @returns The rectangle, or `null` when nothing is drawn.
+ */
+function pictureBox(svg, options) {
+    const { frame = 'content', padding = PICTURE_PADDING } = options;
+    return frame === 'content' ? contentBox(svg, padding) : elementBox(svg);
+}
+/**
+ * Work out what a picture of the element would be.
+ * @param svg - The element, as it is rendered.
+ * @param options - How big to make it, and what to call it.
+ * @returns The element and the rectangle to write out, or `null` when nothing
+ *   is drawn.
+ */
+function describe(svg, options) {
+    const { scale = 2, filename = 'picture', label = 'Drawing', frame = 'content', } = options;
+    if (!svg)
+        return null;
+    const box = pictureBox(svg, options);
+    if (!box)
+        return null;
+    const size = imageSize(box, scale);
+    return {
+        svg,
+        // A picture of the element keeps the `viewBox` the element was drawn with,
+        // which is the one thing that makes its own scaling come out right.
+        png: {
+            box: frame === 'content' ? box : null,
+            width: size.width,
+            height: size.height,
+            label,
+        },
+        name: filename,
+    };
+}
+//# sourceMappingURL=pictureExport.js.map

package/lib/download/core/pictureExport.js.map

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

package/lib/download/core/stackedDrawing.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The drawing a picture of an editor is taken of, found in the box it sits in.
+ *
+ * A drawing is laid out again on every resize, so nothing is held onto but the
+ * box, and what is in it is read at the moment a button is pressed. The box is
+ * asked for rather than the whole editor because an editor is full of SVG —
+ * every icon in every toolbar is one — and the first found in it would be a
+ * picture of a magnifying glass.
+ *
+ * A box holding a stack of charts holds a drawing per pane, and the picture is
+ * all of them: with a run open, a chromatogram stands over the spectrum taken
+ * where its cursor is, and that pairing *is* the figure — a picture of the
+ * chromatogram alone, saved under the spectrum's name, is the wrong answer to
+ * every question it was asked. They are composed into one SVG here rather than
+ * rasterized separately, so the same writers save it, at any resolution, as
+ * either a PNG or a vector.
+ * @param box - The box the drawing sits in, `null` before it is mounted.
+ * @returns The drawing, the panes composed into one, or `null` when the box
+ * holds nothing that has been laid out.
+ */
+export declare function drawingIn(box: HTMLElement | null): SVGSVGElement | null;
+/**
+ * Compose several drawings into one, stacked in the order they were given.
+ *
+ * Each becomes a nested `<svg>` placed at the height the ones above it reached
+ * and sized as it is on screen, which is what keeps its own `viewBox` scaling
+ * right — a chart is drawn to the box it was given, so a pane copied at any
+ * other size would have its axes stretched away from its trace. The composite
+ * is never on the page, so it states its size in attributes: that is where
+ * `elementBox` reads it back from.
+ * @param drawings - What to stack, top to bottom.
+ * @returns The composite, the single drawing it was handed unchanged, or `null`
+ * when nothing among them has been laid out.
+ */
+export declare function stackDrawings(drawings: readonly SVGSVGElement[]): SVGSVGElement | null;
+//# sourceMappingURL=stackedDrawing.d.ts.map

package/lib/download/core/stackedDrawing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stackedDrawing.d.ts","sourceRoot":"","sources":["../../../src/download/core/stackedDrawing.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI,CASvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,aAAa,EAAE,GACjC,aAAa,GAAG,IAAI,CAkCtB"}

package/lib/download/core/stackedDrawing.js

@@ -0,0 +1,98 @@
+import { CHART_PANE_ATTRIBUTE } from "../../chart/core/chartPane.js";
+import { SVG_NAMESPACE } from "./svgNamespace.js";
+/**
+ * The drawing a picture of an editor is taken of, found in the box it sits in.
+ *
+ * A drawing is laid out again on every resize, so nothing is held onto but the
+ * box, and what is in it is read at the moment a button is pressed. The box is
+ * asked for rather than the whole editor because an editor is full of SVG —
+ * every icon in every toolbar is one — and the first found in it would be a
+ * picture of a magnifying glass.
+ *
+ * A box holding a stack of charts holds a drawing per pane, and the picture is
+ * all of them: with a run open, a chromatogram stands over the spectrum taken
+ * where its cursor is, and that pairing *is* the figure — a picture of the
+ * chromatogram alone, saved under the spectrum's name, is the wrong answer to
+ * every question it was asked. They are composed into one SVG here rather than
+ * rasterized separately, so the same writers save it, at any resolution, as
+ * either a PNG or a vector.
+ * @param box - The box the drawing sits in, `null` before it is mounted.
+ * @returns The drawing, the panes composed into one, or `null` when the box
+ * holds nothing that has been laid out.
+ */
+export function drawingIn(box) {
+    if (box === null)
+        return null;
+    const panes = box.querySelectorAll(`[${CSS.escape(CHART_PANE_ATTRIBUTE)}]`);
+    if (panes.length === 0)
+        return box.querySelector('svg');
+    return stackDrawings(paneDrawings(panes));
+}
+/**
+ * Compose several drawings into one, stacked in the order they were given.
+ *
+ * Each becomes a nested `<svg>` placed at the height the ones above it reached
+ * and sized as it is on screen, which is what keeps its own `viewBox` scaling
+ * right — a chart is drawn to the box it was given, so a pane copied at any
+ * other size would have its axes stretched away from its trace. The composite
+ * is never on the page, so it states its size in attributes: that is where
+ * `elementBox` reads it back from.
+ * @param drawings - What to stack, top to bottom.
+ * @returns The composite, the single drawing it was handed unchanged, or `null`
+ * when nothing among them has been laid out.
+ */
+export function stackDrawings(drawings) {
+    const first = drawings[0];
+    if (first === undefined)
+        return null;
+    if (drawings.length === 1)
+        return first;
+    const stacked = document.createElementNS(SVG_NAMESPACE, 'svg');
+    let width = 0;
+    let top = 0;
+    for (const drawing of drawings) {
+        const rect = drawing.getBoundingClientRect();
+        if (rect.width <= 0 || rect.height <= 0)
+            continue;
+        const copy = drawing.cloneNode(true);
+        if (!copy.hasAttribute('viewBox')) {
+            copy.setAttribute('viewBox', `0 0 ${round(rect.width)} ${round(rect.height)}`);
+        }
+        copy.setAttribute('x', '0');
+        copy.setAttribute('y', String(round(top)));
+        copy.setAttribute('width', String(round(rect.width)));
+        copy.setAttribute('height', String(round(rect.height)));
+        stacked.append(copy);
+        width = Math.max(width, rect.width);
+        top += rect.height;
+    }
+    if (top <= 0)
+        return null;
+    stacked.setAttribute('width', String(round(width)));
+    stacked.setAttribute('height', String(round(top)));
+    stacked.setAttribute('viewBox', `0 0 ${round(width)} ${round(top)}`);
+    return stacked;
+}
+/**
+ * The drawing each pane of a stack holds.
+ * @param panes - The pane boxes, top to bottom.
+ * @returns One drawing per pane that holds one, in the order they are stacked.
+ */
+function paneDrawings(panes) {
+    const found = [];
+    for (const pane of panes) {
+        const drawing = pane.querySelector('svg');
+        if (drawing !== null)
+            found.push(drawing);
+    }
+    return found;
+}
+/**
+ * A coordinate of the composite, short enough to read.
+ * @param value - The coordinate.
+ * @returns It, to two decimals.
+ */
+function round(value) {
+    return Math.round(value * 100) / 100;
+}
+//# sourceMappingURL=stackedDrawing.js.map

package/lib/download/core/stackedDrawing.js.map

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

package/lib/download/core/svgBounds.d.ts

@@ -0,0 +1,44 @@
+/** A rectangle of an SVG, in the units the drawing is laid out in. */
+export interface SvgBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Marks the group holding what a drawing is of, as opposed to its canvas. */
+export declare const CONTENT_ATTRIBUTE = "data-export-content";
+/**
+ * The rectangle the drawing itself occupies, rather than the one on screen.
+ *
+ * A canvas is mostly empty space to draw into: what is on screen is a window
+ * over it, wherever it was last panned to and however far it was zoomed. None
+ * of that belongs in a file, so a picture is written out from the drawing
+ * outwards — the group it is drawn in is measured, and the window is ignored.
+ * Whatever is written on it is measured with it, so a name hanging under the
+ * bottom of the drawing is not cut off.
+ *
+ * An SVG that marks no such group — a molecule depiction, which is drawn to the
+ * size of its box and nothing else — is measured whole. What is left out there
+ * is only the room the drawing already left around itself.
+ * @param svg - The element to measure, as it is rendered.
+ * @param padding - Room left around the symbols, in drawing units. Defaults to
+ *   `0`.
+ * @returns The rectangle, or `null` when nothing is drawn or the element is not
+ *   rendered — a measurement is only ever taken of something on screen.
+ */
+export declare function contentBox(svg: SVGSVGElement, padding?: number): SvgBox | null;
+/**
+ * The rectangle the element itself covers, rather than the marks inside it.
+ *
+ * A chart is drawn to the box it was given — its axes reach the edges of it and
+ * its trace reaches wherever the data does — so the box is the picture, and
+ * measuring the marks would crop the frame off it. It is measured where it is
+ * on the page, and read off its own attributes where it is not: a picture of a
+ * stacked editor is composed out of the panes rather than being any one element
+ * on screen, so it never has a place on the page to be measured at and carries
+ * the size it was composed at instead.
+ * @param svg - The element to measure.
+ * @returns The rectangle, or `null` when it is neither laid out nor sized.
+ */
+export declare function elementBox(svg: SVGSVGElement): SvgBox | null;
+//# sourceMappingURL=svgBounds.d.ts.map

package/lib/download/core/svgBounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgBounds.d.ts","sourceRoot":"","sources":["../../../src/download/core/svgBounds.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,SAAI,GAAG,MAAM,GAAG,IAAI,CAazE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAU5D"}