@meltemi/diagrams-assets 0.0.0-stage → 1.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Architecture Studio contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# @meltemi/diagrams-assets
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Icons and project assets: the built-in Tabler pack, Iconify and SVG folder packs with their
+licences, a strict SVG sanitiser, image reading and the asset lock with SHA-256 digests.
+
+It is part of [Meltemi Diagrams](https://github.com/askenaz-dev/meltemi-diagrams#readme), diagrams as code with a canvas, motion and
+exports. Every package of the product has the same version.
+
+## Install
+
+```bash
+npm install @meltemi/diagrams-assets
+```
+
+Node 22.12.0 or later. The package is an ES module with type declarations.
+
+## Use
+
+```ts
+import { sanitizeSvg } from "@meltemi/diagrams-assets";
+
+const result = sanitizeSvg(
+  '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 4h16v16H4z"/><script>alert(1)</script></svg>',
+);
+console.log(result.ok); // false: scripts are refused, never stripped silently
+```
+
+## Documentation
+
+- [Icons and assets](https://github.com/askenaz-dev/meltemi-diagrams/blob/main/docs/language/assets.md)
+- [Security](https://github.com/askenaz-dev/meltemi-diagrams/blob/main/docs/security.md)
+- [All documentation](https://github.com/askenaz-dev/meltemi-diagrams/blob/main/docs/README.md)
+
+## Licence
+
+MIT. Third-party components and their licences are listed in [THIRD_PARTY_LICENSES.md](https://github.com/askenaz-dev/meltemi-diagrams/blob/main/THIRD_PARTY_LICENSES.md).

package/dist/icon.d.ts

@@ -0,0 +1,74 @@
+import type { Bounds } from "./path.js";
+/**
+ * A paint: `none`, the icon colour (`currentColor`, black or unset in monochrome icons), a colour
+ * as written, or a gradient of the icon.
+ */
+export type Paint = {
+    readonly kind: "none";
+} | {
+    readonly kind: "current";
+} | {
+    readonly kind: "color";
+    readonly value: string;
+} | {
+    readonly kind: "gradient";
+    readonly id: string;
+};
+/** One drawable path of an icon, in view box units. */
+export interface IconPath {
+    readonly d: string;
+    /** `matrix(a b c d e f)` of the element and its groups, or null. */
+    readonly transform: string | null;
+    readonly fill: Paint;
+    readonly stroke: Paint;
+    readonly strokeWidth: number;
+    readonly lineCap: "butt" | "round" | "square";
+    readonly lineJoin: "miter" | "round" | "bevel";
+    readonly fillRule: "nonzero" | "evenodd";
+    readonly opacity: number;
+    readonly fillOpacity: number;
+    readonly strokeOpacity: number;
+}
+export interface GradientStop {
+    readonly offset: number;
+    readonly color: string;
+    readonly opacity: number;
+}
+/** A gradient defined inside an icon; coordinates are numbers or percentages as written. */
+export interface IconGradient {
+    readonly id: string;
+    readonly kind: "linear" | "radial";
+    readonly units: "objectBoundingBox" | "userSpaceOnUse";
+    readonly transform: string | null;
+    readonly spread: "pad" | "reflect" | "repeat";
+    /** `x1`, `y1`, `x2`, `y2` for linear gradients; `cx`, `cy`, `r`, `fx`, `fy` for radial ones. */
+    readonly coordinates: Readonly<Record<string, string>>;
+    readonly stops: readonly GradientStop[];
+}
+export interface ViewBox {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface IconGeometry {
+    readonly viewBox: ViewBox;
+    readonly paths: readonly IconPath[];
+    readonly gradients: readonly IconGradient[];
+    /** True when every paint is the icon colour or none, so the icon takes the target's colour. */
+    readonly monochrome: boolean;
+    /** Bounding box of the drawn paths, strokes included, in view box units. */
+    readonly bounds: Bounds | undefined;
+}
+/** Larger side of the content box over the larger side of the view box. */
+export declare function opticalRatio(icon: IconGeometry): number | undefined;
+/** The share of its box an icon's content fills in the reference pack (Tabler: 20 of 24 units). */
+export declare const OPTICAL_TARGET: number;
+/**
+ * Size, relative to the icon square, at which a pack's view boxes are drawn so that its content
+ * fills the same share as the reference pack.
+ */
+export declare function drawScale(packRatio: number | undefined): number;
+/** The median of a list of numbers, or undefined for an empty list. */
+export declare function median(values: readonly number[]): number | undefined;
+//# sourceMappingURL=icon.d.ts.map

package/dist/icon.d.ts.map

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

package/dist/icon.js

@@ -0,0 +1,28 @@
+/** Larger side of the content box over the larger side of the view box. */
+export function opticalRatio(icon) {
+    if (!icon.bounds)
+        return undefined;
+    const content = Math.max(icon.bounds.maxX - icon.bounds.minX, icon.bounds.maxY - icon.bounds.minY);
+    const box = Math.max(icon.viewBox.width, icon.viewBox.height);
+    return box > 0 && content > 0 ? content / box : undefined;
+}
+/** The share of its box an icon's content fills in the reference pack (Tabler: 20 of 24 units). */
+export const OPTICAL_TARGET = 20 / 24;
+/**
+ * Size, relative to the icon square, at which a pack's view boxes are drawn so that its content
+ * fills the same share as the reference pack.
+ */
+export function drawScale(packRatio) {
+    if (packRatio === undefined || packRatio <= 0)
+        return 1;
+    return Math.min(1.25, Math.max(0.75, OPTICAL_TARGET / packRatio));
+}
+/** The median of a list of numbers, or undefined for an empty list. */
+export function median(values) {
+    if (values.length === 0)
+        return undefined;
+    const sorted = [...values].sort((a, b) => a - b);
+    const middle = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 1 ? sorted[middle] : (sorted[middle - 1] + sorted[middle]) / 2;
+}
+//# sourceMappingURL=icon.js.map

package/dist/icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.js","sourceRoot":"","sources":["../src/icon.ts"],"names":[],"mappings":"AA+DA,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,IAAkB;IAC7C,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EACnC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CACpC,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,OAAO,GAAG,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,SAA6B;IACrD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,MAAM,CAAC,MAAyB;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,CAAC;AAChG,CAAC"}

package/dist/image.d.ts

@@ -0,0 +1,43 @@
+import type { IconGeometry } from "./icon.js";
+/** Raster and vector formats accepted for `image` objects. */
+export type ImageFormat = "png" | "jpeg" | "gif" | "webp" | "svg";
+/** Largest image file, in bytes. */
+export declare const IMAGE_MAX_BYTES: number;
+/** Size of an SVG image that declares neither `width` and `height` nor a `viewBox`. */
+export declare const UNKNOWN_IMAGE_SIZE: {
+    readonly width: 160;
+    readonly height: 120;
+};
+/** An image ready to embed: its format, pixel size and a `data:` URI. */
+export interface ResolvedImage {
+    readonly format: ImageFormat;
+    readonly width: number;
+    readonly height: number;
+    readonly href: string;
+}
+/** Resolves an image path written in a diagram, relative to its file. */
+export interface ImageResolver {
+    resolve(path: string): ResolvedImage | undefined;
+}
+export type ImageResult = {
+    readonly ok: true;
+    readonly image: ResolvedImage;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/** Reads an image file: its format from the header, its pixel size, and a data URI. */
+export declare function readImage(bytes: Uint8Array): ImageResult;
+/** A standalone SVG made only of the sanitised paths and gradients of an image. */
+export declare function geometrySvg(icon: IconGeometry, width: number, height: number): string;
+/** Standard base64 with padding. */
+export declare function base64(bytes: Uint8Array): string;
+/** The default drawn size of an image: its pixel size, at most 640 wide, keeping the ratio. */
+export declare function defaultImageSize(image: {
+    width: number;
+    height: number;
+} | undefined): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAS,MAAM,WAAW,CAAC;AAIrD,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAElE,oCAAoC;AACpC,eAAO,MAAM,eAAe,QAAkB,CAAC;AAE/C,uFAAuF;AACvF,eAAO,MAAM,kBAAkB;;;CAAuC,CAAC;AAEvE,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAUrD,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAkBxD;AAqJD,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkDrF;AAID,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAkBhD;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAKA"}

package/dist/image.js

@@ -0,0 +1,248 @@
+import { messages } from "./messages/index.js";
+import { sanitizeSvg } from "./sanitize.js";
+/** Largest image file, in bytes. */
+export const IMAGE_MAX_BYTES = 8 * 1024 * 1024;
+/** Size of an SVG image that declares neither `width` and `height` nor a `viewBox`. */
+export const UNKNOWN_IMAGE_SIZE = { width: 160, height: 120 };
+const MIME = {
+    png: "image/png",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+};
+/** Reads an image file: its format from the header, its pixel size, and a data URI. */
+export function readImage(bytes) {
+    // Problems are written in the interface language of the moment the file is read.
+    const t = messages().images;
+    if (bytes.length > IMAGE_MAX_BYTES) {
+        return { ok: false, message: t.fileSize(IMAGE_MAX_BYTES / 1024 / 1024) };
+    }
+    const raster = rasterSize(bytes);
+    if (raster) {
+        if (!raster.ok)
+            return raster;
+        const { format, width, height } = raster;
+        return {
+            ok: true,
+            image: { format, width, height, href: `data:${MIME[format]};base64,${base64(bytes)}` },
+        };
+    }
+    const text = decodeUtf8(bytes);
+    if (text !== undefined && /<svg[\s>]/.test(text.slice(0, 4096)))
+        return svgImage(text);
+    return { ok: false, message: t.format };
+}
+function u16be(b, i) {
+    return (b[i] << 8) | b[i + 1];
+}
+function u16le(b, i) {
+    return b[i] | (b[i + 1] << 8);
+}
+function u24le(b, i) {
+    return b[i] | (b[i + 1] << 8) | (b[i + 2] << 16);
+}
+function u32be(b, i) {
+    return ((b[i] << 24) >>> 0) + ((b[i + 1] << 16) | (b[i + 2] << 8) | b[i + 3]);
+}
+function ascii(b, start, length) {
+    return String.fromCharCode(...b.subarray(start, start + length));
+}
+/** The format and size of a raster image, or undefined when the header is not a raster format. */
+function rasterSize(b) {
+    const broken = (format) => ({
+        ok: false,
+        message: messages().images.brokenHeader(format),
+    });
+    const sized = (format, width, height) => width > 0 && height > 0 ? { ok: true, format, width, height } : broken(format.toUpperCase());
+    if (b.length >= 8 && b[0] === 0x89 && ascii(b, 1, 3) === "PNG") {
+        if (b.length < 24 || ascii(b, 12, 4) !== "IHDR")
+            return broken("PNG");
+        return sized("png", u32be(b, 16), u32be(b, 20));
+    }
+    if (b.length >= 3 && b[0] === 0xff && b[1] === 0xd8 && b[2] === 0xff) {
+        let i = 2;
+        while (i + 9 < b.length) {
+            if (b[i] !== 0xff)
+                return broken("JPEG");
+            const marker = b[i + 1];
+            if (marker === 0xff) {
+                i++;
+                continue;
+            }
+            const length = u16be(b, i + 2);
+            const frame = marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;
+            if (frame)
+                return sized("jpeg", u16be(b, i + 7), u16be(b, i + 5));
+            if (length < 2)
+                return broken("JPEG");
+            i += 2 + length;
+        }
+        return broken("JPEG");
+    }
+    if (b.length >= 6 && (ascii(b, 0, 6) === "GIF87a" || ascii(b, 0, 6) === "GIF89a")) {
+        if (b.length < 10)
+            return broken("GIF");
+        return sized("gif", u16le(b, 6), u16le(b, 8));
+    }
+    if (b.length >= 12 && ascii(b, 0, 4) === "RIFF" && ascii(b, 8, 4) === "WEBP") {
+        if (b.length < 30)
+            return broken("WebP");
+        const chunk = ascii(b, 12, 4);
+        if (chunk === "VP8 ")
+            return sized("webp", u16le(b, 26) & 0x3fff, u16le(b, 28) & 0x3fff);
+        if (chunk === "VP8L") {
+            if (b[20] !== 0x2f)
+                return broken("WebP");
+            const b0 = b[21];
+            const b1 = b[22];
+            const b2 = b[23];
+            const b3 = b[24];
+            const width = 1 + (((b1 & 0x3f) << 8) | b0);
+            const height = 1 + (((b3 & 0x0f) << 10) | (b2 << 2) | ((b1 & 0xc0) >> 6));
+            return sized("webp", width, height);
+        }
+        if (chunk === "VP8X")
+            return sized("webp", 1 + u24le(b, 24), 1 + u24le(b, 27));
+        return broken("WebP");
+    }
+    return undefined;
+}
+function decodeUtf8(bytes) {
+    try {
+        // `ignoreBOM: false` is the default; the Workers typings of `TextDecoder` require it spelled out
+        // (the cloud Worker compiles this package from source).
+        return new TextDecoder("utf-8", { fatal: true, ignoreBOM: false }).decode(bytes);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Sanitises an SVG image with the icon sanitiser and writes it back as plain paths. */
+function svgImage(text) {
+    const result = sanitizeSvg(text, IMAGE_MAX_BYTES);
+    if (!result.ok)
+        return { ok: false, message: messages().images.unsafeSvg(result.problem.message) };
+    const size = svgSize(text) ?? {
+        width: result.icon.viewBox.width,
+        height: result.icon.viewBox.height,
+    };
+    const svg = geometrySvg(result.icon, size.width, size.height);
+    return {
+        ok: true,
+        image: {
+            format: "svg",
+            width: size.width,
+            height: size.height,
+            href: `data:${MIME.svg};base64,${base64(new TextEncoder().encode(svg))}`,
+        },
+    };
+}
+/** The `width` and `height` of the root element when both are plain pixel numbers. */
+function svgSize(text) {
+    const root = /<svg\b[^>]*>/.exec(text)?.[0];
+    if (!root)
+        return undefined;
+    const read = (name) => {
+        const match = new RegExp(`\\s${name}\\s*=\\s*["']\\s*([\\d.]+)(?:px)?\\s*["']`).exec(root);
+        const value = match ? Number(match[1]) : NaN;
+        return Number.isFinite(value) && value > 0 ? value : undefined;
+    };
+    const width = read("width");
+    const height = read("height");
+    return width && height ? { width, height } : undefined;
+}
+const escapeAttribute = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+function paint(value) {
+    switch (value.kind) {
+        case "none":
+            return "none";
+        case "current":
+            return "#000";
+        case "color":
+            return escapeAttribute(value.value);
+        case "gradient":
+            return `url(#${value.id})`;
+    }
+}
+const n = (value) => String(Math.round(value * 1000) / 1000);
+/** A standalone SVG made only of the sanitised paths and gradients of an image. */
+export function geometrySvg(icon, width, height) {
+    const { x, y, width: w, height: h } = icon.viewBox;
+    const parts = [
+        `<svg xmlns="http://www.w3.org/2000/svg" width="${n(width)}" height="${n(height)}" viewBox="${n(x)} ${n(y)} ${n(w)} ${n(h)}">`,
+    ];
+    if (icon.gradients.length > 0) {
+        parts.push("<defs>");
+        for (const gradient of icon.gradients) {
+            const tag = gradient.kind === "linear" ? "linearGradient" : "radialGradient";
+            const attributes = [
+                `id="${escapeAttribute(gradient.id)}"`,
+                `gradientUnits="${gradient.units}"`,
+                `spreadMethod="${gradient.spread}"`,
+                ...Object.entries(gradient.coordinates).map(([k, v]) => `${k}="${escapeAttribute(v)}"`),
+            ];
+            if (gradient.transform) {
+                attributes.push(`gradientTransform="${escapeAttribute(gradient.transform)}"`);
+            }
+            parts.push(`<${tag} ${attributes.join(" ")}>`);
+            for (const stop of gradient.stops) {
+                parts.push(`<stop offset="${n(stop.offset)}" stop-color="${escapeAttribute(stop.color)}" stop-opacity="${n(stop.opacity)}"/>`);
+            }
+            parts.push(`</${tag}>`);
+        }
+        parts.push("</defs>");
+    }
+    for (const path of icon.paths) {
+        const attributes = [
+            `d="${escapeAttribute(path.d)}"`,
+            `fill="${paint(path.fill)}"`,
+            `stroke="${paint(path.stroke)}"`,
+        ];
+        if (path.stroke.kind !== "none") {
+            attributes.push(`stroke-width="${n(path.strokeWidth)}"`, `stroke-linecap="${path.lineCap}"`, `stroke-linejoin="${path.lineJoin}"`);
+        }
+        if (path.fillRule !== "nonzero")
+            attributes.push(`fill-rule="${path.fillRule}"`);
+        if (path.transform)
+            attributes.push(`transform="${escapeAttribute(path.transform)}"`);
+        if (path.opacity !== 1)
+            attributes.push(`opacity="${n(path.opacity)}"`);
+        if (path.fillOpacity !== 1)
+            attributes.push(`fill-opacity="${n(path.fillOpacity)}"`);
+        if (path.strokeOpacity !== 1)
+            attributes.push(`stroke-opacity="${n(path.strokeOpacity)}"`);
+        parts.push(`<path ${attributes.join(" ")}/>`);
+    }
+    parts.push("</svg>");
+    return parts.join("");
+}
+const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+/** Standard base64 with padding. */
+export function base64(bytes) {
+    const out = [];
+    let i = 0;
+    for (; i + 2 < bytes.length; i += 3) {
+        const v = (bytes[i] << 16) | (bytes[i + 1] << 8) | bytes[i + 2];
+        out.push(ALPHABET[v >> 18] + ALPHABET[(v >> 12) & 63] + ALPHABET[(v >> 6) & 63] + ALPHABET[v & 63]);
+    }
+    const rest = bytes.length - i;
+    if (rest === 1) {
+        const v = bytes[i] << 16;
+        out.push(`${ALPHABET[v >> 18]}${ALPHABET[(v >> 12) & 63]}==`);
+    }
+    else if (rest === 2) {
+        const v = (bytes[i] << 16) | (bytes[i + 1] << 8);
+        out.push(`${ALPHABET[v >> 18]}${ALPHABET[(v >> 12) & 63]}${ALPHABET[(v >> 6) & 63]}=`);
+    }
+    return out.join("");
+}
+/** The default drawn size of an image: its pixel size, at most 640 wide, keeping the ratio. */
+export function defaultImageSize(image) {
+    if (!image)
+        return { ...UNKNOWN_IMAGE_SIZE };
+    if (image.width <= 640)
+        return { width: Math.round(image.width), height: Math.round(image.height) };
+    return { width: 640, height: Math.round((image.height * 640) / image.width) };
+}
+//# sourceMappingURL=image.js.map

package/dist/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5C,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C,uFAAuF;AACvF,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAW,CAAC;AAmBvE,MAAM,IAAI,GAA0C;IAClD,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,eAAe;CACrB,CAAC;AAEF,uFAAuF;AACvF,MAAM,UAAU,SAAS,CAAC,KAAiB;IACzC,iFAAiF;IACjF,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC,MAAM,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC;QAC9B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACzC,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;SACvF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1C,CAAC;AAWD,SAAS,KAAK,CAAC,CAAa,EAAE,CAAS;IACrC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;AAClC,CAAC;AAED,SAAS,KAAK,CAAC,CAAa,EAAE,CAAS;IACrC,OAAO,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,KAAK,CAAC,CAAa,EAAE,CAAS;IACrC,OAAO,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,KAAK,CAAC,CAAa,EAAE,CAAS;IACrC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,KAAK,CAAC,CAAa,EAAE,KAAa,EAAE,MAAc;IACzD,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,kGAAkG;AAClG,SAAS,UAAU,CAAC,CAAa;IAC/B,MAAM,MAAM,GAAG,CAAC,MAAc,EAAgB,EAAE,CAAC,CAAC;QAChD,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;KAChD,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,CAAC,MAAmB,EAAE,KAAa,EAAE,MAAc,EAAgB,EAAE,CACjF,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAE/F,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QAC/D,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE,IAAI,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrE,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACzB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,CAAC,EAAE,CAAC;gBACJ,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,MAAM,KAAK,GACT,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC;YAC5F,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAClE,IAAI,MAAM,GAAG,CAAC;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QAClB,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;QAClF,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC7E,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;QACzF,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACrB,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;YAClB,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;YAClB,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;YAClB,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;YAClB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1E,OAAO,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,IAAI,CAAC;QACH,iGAAiG;QACjG,wDAAwD;QACxD,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,EAAE;QACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IACrF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI;QAC5B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK;QAChC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;KACnC,CAAC;IACF,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9D,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE;YACL,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,QAAQ,IAAI,CAAC,GAAG,WAAW,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;SACzE;KACF,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,IAAI,2CAA2C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3F,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,eAAe,GAAG,CAAC,KAAa,EAAE,EAAE,CACxC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAE7E,SAAS,KAAK,CAAC,KAAY;IACzB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,UAAU;YACb,OAAO,QAAQ,KAAK,CAAC,EAAE,GAAG,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAErE,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,IAAkB,EAAE,KAAa,EAAE,MAAc;IAC3E,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;IACnD,MAAM,KAAK,GAAa;QACtB,kDAAkD,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;KAC/H,CAAC;IACF,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC7E,MAAM,UAAU,GAAG;gBACjB,OAAO,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG;gBACtC,kBAAkB,QAAQ,CAAC,KAAK,GAAG;gBACnC,iBAAiB,QAAQ,CAAC,MAAM,GAAG;gBACnC,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC;aACxF,CAAC;YACF,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACvB,UAAU,CAAC,IAAI,CAAC,sBAAsB,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAChF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CACR,iBAAiB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CACnH,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG;YACjB,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;YAChC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC5B,WAAW,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;SACjC,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,UAAU,CAAC,IAAI,CACb,iBAAiB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EACvC,mBAAmB,IAAI,CAAC,OAAO,GAAG,EAClC,oBAAoB,IAAI,CAAC,QAAQ,GAAG,CACrC,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,cAAc,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtF,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACrF,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3F,KAAK,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,QAAQ,GAAG,kEAAkE,CAAC;AAEpF,oCAAoC;AACpC,MAAM,UAAU,MAAM,CAAC,KAAiB;IACtC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACnE,GAAG,CAAC,IAAI,CACN,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAE,CAC9F,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,IAAI,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAE,IAAI,CAAC,CAAC;IAClE,CAAC;SAAM,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAE,GAAG,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,KAAoD;IAInF,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAC7C,IAAI,KAAK,CAAC,KAAK,IAAI,GAAG;QACpB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9E,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAChF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export declare const PACKAGE_NAME = "@meltemi/diagrams-assets";
+export * from "./icon.js";
+export * from "./image.js";
+export * from "./libraries.js";
+export * from "./lock.js";
+export * from "./packs.js";
+export * from "./path.js";
+export * from "./sanitize.js";
+export * from "./sha256.js";
+export { decodeEntities, parseXml, type XmlElement, type XmlLimits, type XmlResult, } from "./xml.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAEvD,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export const PACKAGE_NAME = "@meltemi/diagrams-assets";
+export * from "./icon.js";
+export * from "./image.js";
+export * from "./libraries.js";
+export * from "./lock.js";
+export * from "./packs.js";
+export * from "./path.js";
+export * from "./sanitize.js";
+export * from "./sha256.js";
+export { decodeEntities, parseXml, } from "./xml.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,QAAQ,GAIT,MAAM,UAAU,CAAC"}

package/dist/libraries.d.ts

@@ -0,0 +1,53 @@
+import type { IconPack, IconRegistry } from "./packs.js";
+/** A ready-made element of a library: its icon, its name and, when it matters, its kind. */
+export interface LibraryItem {
+    readonly icon: string;
+    readonly label: string;
+    readonly kind?: string;
+}
+export interface LibraryCategory {
+    readonly id: string;
+    readonly title: string;
+    /** How many elements the category holds, known before `items` is read. */
+    readonly count: number;
+    /** The elements; a pack's category reads its pack the first time. */
+    readonly items: readonly LibraryItem[];
+}
+/** A library of ready-made elements by category, from a file or from a pack's categories. */
+export interface Library {
+    readonly id: string;
+    readonly title: string;
+    readonly categories: readonly LibraryCategory[];
+    /** Where it comes from: `built-in`, a project or plugin file, or the pack it is read from. */
+    readonly source: string;
+}
+export type LibraryParse = {
+    readonly ok: true;
+    readonly library: Library;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/** Reads a library file; the reason when it is not one. */
+export declare function parseLibrary(text: string, source: string): LibraryParse;
+/** The library of a pack that declares categories: one category per pack category, labelled. */
+export declare function packLibrary(pack: IconPack): Library | undefined;
+/**
+ * The libraries of a document: the files first (built-in ones, then the project's and the
+ * plugins'), then one per pack of the registry that declares categories and has no file of its
+ * own, in prefix order.
+ */
+export declare function librariesOf(registry: IconRegistry, files: readonly Library[]): Library[];
+/** An item found by a search, with the library and category it belongs to. */
+export interface LibraryMatch {
+    readonly library: Library;
+    readonly category: LibraryCategory;
+    readonly item: LibraryItem;
+}
+/** Items whose label, icon name or pack keywords hold every word of the query, best first. */
+export declare function searchLibraries(libraries: readonly Library[], registry: IconRegistry, query: string, limit?: number): LibraryMatch[];
+/** The ids of the libraries built into the tool, read as `libraries/<id>.json`. */
+export declare const BUILT_IN_LIBRARIES: readonly ["tech"];
+/** The built-in library files, through a reader of the bundled assets. */
+export declare function builtInLibraries(read: (path: string) => string | undefined): Library[];
+//# sourceMappingURL=libraries.d.ts.map

package/dist/libraries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libraries.d.ts","sourceRoot":"","sources":["../src/libraries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED,6FAA6F;AAC7F,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAKD,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAQpD,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CA8DvE;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CA0B/D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CASxF;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,OAAO,EAAE,EAC7B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,YAAY,EAAE,CAkChB;AAED,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,mBAAoB,CAAC;AAEpD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,CAStF"}