@mcuste/pi-diagram 0.0.0

package/dist/normalize.js

@@ -0,0 +1,83 @@
+import { createHash } from "node:crypto";
+import { DiagramSourceError } from "./d2/diagnostics.js";
+/** Byte-level enforcement of the schema's character limit in `tools.ts`. */
+const MAX_SOURCE_BYTES = 20 * 1024;
+const MAX_TITLE_LENGTH = 120;
+const TAB = 0x09;
+const LINE_FEED = 0x0a;
+const FIRST_PRINTABLE = 0x20;
+const DELETE = 0x7f;
+const BYTE_ORDER_MARK = 0xfeff;
+/** Characters a terminal would act on rather than print. */
+function isControl(codePoint) {
+    if (codePoint === TAB || codePoint === LINE_FEED) {
+        return false;
+    }
+    return codePoint < FIRST_PRINTABLE || codePoint === DELETE;
+}
+function findControl(text) {
+    let offset = 0;
+    for (const character of text) {
+        const codePoint = character.codePointAt(0) ?? 0;
+        if (isControl(codePoint)) {
+            return { offset, codePoint };
+        }
+        offset += character.length;
+    }
+    return undefined;
+}
+/** Runs before anything inspects or renders, so the scanner and D2 see the same bytes. */
+export function normalizeSource(raw) {
+    if (typeof raw !== "string") {
+        throw new DiagramSourceError("Diagram source must be a string.", [
+            { code: "D2_SOURCE", message: `Received ${raw === null ? "null" : typeof raw}.` },
+        ]);
+    }
+    const text = stripByteOrderMark(raw).replace(/\r\n?/gu, "\n").trim();
+    if (text.length === 0) {
+        throw new DiagramSourceError("Diagram source is empty.", [
+            { code: "D2_SOURCE", message: "Send D2 source such as `client -> gateway: request`." },
+        ]);
+    }
+    const control = findControl(text);
+    if (control) {
+        const label = control.codePoint.toString(16).padStart(4, "0").toUpperCase();
+        throw new DiagramSourceError("Diagram source contains a control character.", [
+            {
+                code: "D2_SOURCE",
+                message: `U+${label} at offset ${control.offset} is not allowed in diagram source.`,
+            },
+        ]);
+    }
+    const bytes = Buffer.byteLength(text, "utf8");
+    if (bytes > MAX_SOURCE_BYTES) {
+        throw new DiagramSourceError("Diagram source is too large.", [
+            {
+                code: "D2_TOO_LARGE",
+                message: `${bytes} bytes is above the ${MAX_SOURCE_BYTES} byte limit.`,
+                hint: "Split it into smaller diagrams.",
+            },
+        ]);
+    }
+    return {
+        text: text,
+        hash: createHash("sha256").update(text, "utf8").digest("hex"),
+        lineCount: text.split("\n").length,
+    };
+}
+export function parseTitle(raw) {
+    if (typeof raw !== "string") {
+        return undefined;
+    }
+    const printable = Array.from(raw, (character) => isControl(character.codePointAt(0) ?? 0) ? " " : character).join("");
+    const title = printable.replace(/\s+/gu, " ").trim();
+    if (title.length === 0) {
+        return undefined;
+    }
+    const capped = title.length > MAX_TITLE_LENGTH ? `${title.slice(0, MAX_TITLE_LENGTH - 3)}...` : title;
+    return capped;
+}
+function stripByteOrderMark(raw) {
+    return raw.codePointAt(0) === BYTE_ORDER_MARK ? raw.slice(1) : raw;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/process.d.ts

@@ -0,0 +1,38 @@
+export interface CommandResult {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+interface RunCommandOptions {
+    readonly cwd: string;
+    readonly signal?: AbortSignal | undefined;
+    readonly env?: NodeJS.ProcessEnv | undefined;
+    readonly timeoutMs?: number | undefined;
+    readonly maxOutputBytes?: number | undefined;
+}
+export type CommandRunner = (command: string, args: readonly string[], options: RunCommandOptions) => Promise<CommandResult>;
+/** The command never started, which is what a missing D2 install looks like. */
+export declare class CommandInvocationError extends Error {
+    readonly command: string;
+    readonly code: string | undefined;
+    constructor(command: string, message: string, code: string | undefined, options?: ErrorOptions);
+}
+export declare class CommandCancelledError extends Error {
+    constructor(command: string);
+}
+export declare class CommandTimeoutError extends Error {
+    readonly command: string;
+    readonly timeoutMs: number;
+    constructor(command: string, timeoutMs: number);
+}
+/** A `maxBuffer` kill is a size limit, not a broken executable, so it is not a spawn failure. */
+export declare class CommandOutputLimitError extends Error {
+    readonly command: string;
+    readonly maxOutputBytes: number;
+    constructor(command: string, maxOutputBytes: number, options?: ErrorOptions);
+}
+export declare const runCommand: CommandRunner;
+export {};
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,iBAAiB,KACvB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,gFAAgF;AAChF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,EAK7F;CACF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK7C;CACF;AAED,iGAAiG;AACjG,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,YAAY,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAO1E;CACF;AAED,eAAO,MAAM,UAAU,EAAE,aA4DxB,CAAC"}

package/dist/process.js

@@ -0,0 +1,87 @@
+import { execFile } from "node:child_process";
+const DEFAULT_MAX_OUTPUT_BYTES = 1024 * 1024;
+/** The command never started, which is what a missing D2 install looks like. */
+export class CommandInvocationError extends Error {
+    command;
+    code;
+    constructor(command, message, code, options) {
+        super(message, options);
+        this.name = "CommandInvocationError";
+        this.command = command;
+        this.code = code;
+    }
+}
+export class CommandCancelledError extends Error {
+    constructor(command) {
+        super(`${command} was cancelled.`);
+        this.name = "CommandCancelledError";
+    }
+}
+export class CommandTimeoutError extends Error {
+    command;
+    timeoutMs;
+    constructor(command, timeoutMs) {
+        super(`${command} did not finish within ${timeoutMs} ms and was stopped.`);
+        this.name = "CommandTimeoutError";
+        this.command = command;
+        this.timeoutMs = timeoutMs;
+    }
+}
+/** A `maxBuffer` kill is a size limit, not a broken executable, so it is not a spawn failure. */
+export class CommandOutputLimitError extends Error {
+    command;
+    maxOutputBytes;
+    constructor(command, maxOutputBytes, options) {
+        super(`${command} produced more than ${maxOutputBytes} bytes of output and was stopped.`, {
+            ...options,
+        });
+        this.name = "CommandOutputLimitError";
+        this.command = command;
+        this.maxOutputBytes = maxOutputBytes;
+    }
+}
+export const runCommand = (command, args, options) => {
+    if (options.signal?.aborted) {
+        return Promise.reject(new CommandCancelledError(command));
+    }
+    const maxOutputBytes = options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+    const timeoutMs = options.timeoutMs ?? 0;
+    const { promise, resolve, reject } = Promise.withResolvers();
+    execFile(command, [...args], {
+        cwd: options.cwd,
+        encoding: "utf8",
+        maxBuffer: maxOutputBytes,
+        signal: options.signal,
+        timeout: timeoutMs,
+        env: options.env,
+        windowsHide: true,
+    }, (error, stdout, stderr) => {
+        if (options.signal?.aborted || error?.name === "AbortError") {
+            reject(new CommandCancelledError(command));
+            return;
+        }
+        if (error?.code === "ERR_CHILD_PROCESS_STDIO_MAXBUFFER") {
+            reject(new CommandOutputLimitError(command, maxOutputBytes, { cause: error }));
+            return;
+        }
+        // `timeout` kills the child with a signal, which arrives without a numeric exit code.
+        if (timeoutMs > 0 && error?.signal && typeof error.code !== "number") {
+            reject(new CommandTimeoutError(command, timeoutMs));
+            return;
+        }
+        if (error && typeof error.code !== "number") {
+            const detail = error.message.trim();
+            reject(new CommandInvocationError(command, `Unable to execute ${command}: ${detail}`, typeof error.code === "string" ? error.code : undefined, { cause: error }));
+            return;
+        }
+        resolve({
+            command,
+            args: [...args],
+            exitCode: typeof error?.code === "number" ? error.code : 0,
+            stdout,
+            stderr,
+        });
+    });
+    return promise;
+};
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAAC;AAwB7C,gFAAgF;AAChF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,OAAO,CAAS;IAChB,IAAI,CAAqB;IAElC,YAAY,OAAe,EAAE,OAAe,EAAE,IAAwB,EAAE,OAAsB;QAC5F,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,GAAG,OAAO,iBAAiB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,OAAO,CAAS;IAChB,SAAS,CAAS;IAE3B,YAAY,OAAe,EAAE,SAAiB;QAC5C,KAAK,CAAC,GAAG,OAAO,0BAA0B,SAAS,sBAAsB,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,iGAAiG;AACjG,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,OAAO,CAAS;IAChB,cAAc,CAAS;IAEhC,YAAY,OAAe,EAAE,cAAsB,EAAE,OAAsB;QACzE,KAAK,CAAC,GAAG,OAAO,uBAAuB,cAAc,mCAAmC,EAAE;YACxF,GAAG,OAAO;SACX,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAClE,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAiB,CAAC;IAC5E,QAAQ,CACN,OAAO,EACP,CAAC,GAAG,IAAI,CAAC,EACT;QACE,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,cAAc;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,WAAW,EAAE,IAAI;KAClB,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QACxB,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,IAAI,KAAK,EAAE,IAAI,KAAK,mCAAmC,EAAE,CAAC;YACxD,MAAM,CAAC,IAAI,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QAED,sFAAsF;QACtF,IAAI,SAAS,GAAG,CAAC,IAAI,KAAK,EAAE,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,CACJ,IAAI,sBAAsB,CACxB,OAAO,EACP,qBAAqB,OAAO,KAAK,MAAM,EAAE,EACzC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EACvD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CACF,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,CAAC;YACN,OAAO;YACP,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACf,QAAQ,EAAE,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1D,MAAM;YACN,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/raster.d.ts

@@ -0,0 +1,40 @@
+import { type RenderCache } from "./cache.js";
+import type { RenderedSvg } from "./d2/runner.js";
+declare const renderedPngBrand: unique symbol;
+/** Bytes that passed `parseRenderedPng`, so they really are a PNG of a known size. */
+type RenderedPng = Uint8Array & {
+    readonly [renderedPngBrand]: true;
+};
+export interface RasterRequest {
+    readonly svg: RenderedSvg;
+    readonly signal: AbortSignal | undefined;
+}
+export interface RasterImage {
+    readonly png: RenderedPng;
+    readonly widthPx: number;
+    readonly heightPx: number;
+    /** True when the diagram's own font could not draw every label, so system fonts were added. */
+    readonly systemFonts: boolean;
+}
+export interface SvgRasterizer {
+    rasterize(request: RasterRequest): Promise<RasterImage>;
+}
+/** The diagram is fine and only the image failed, so the caller shows text rather than failing. */
+export declare class ImageRenderUnavailableError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** resvg reporting success is not proof the bytes are a usable PNG of the size asked for. */
+export declare function parseRenderedPng(bytes: Uint8Array, expectedWidthPx: number): RasterImage;
+/** Enough resolution to scale down cleanly, never a pathological canvas. */
+export declare function parseTargetWidth(naturalWidthPx: number, naturalHeightPx: number): number;
+/** Parsed again on the way out, so a corrupt entry is drawn again rather than displayed. */
+export declare function parseCachedImage(entry: string): RasterImage;
+export declare class ResvgRasterizer implements SvgRasterizer {
+    private readonly cache;
+    constructor(dependencies?: {
+        readonly cache?: RenderCache;
+    });
+    rasterize(request: RasterRequest): Promise<RasterImage>;
+}
+export {};
+//# sourceMappingURL=raster.d.ts.map

package/dist/raster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster.d.ts","sourceRoot":"","sources":["../src/raster.ts"],"names":[],"mappings":"AAIA,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAOrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA4BlD,OAAO,CAAC,MAAM,gBAAgB,EAAE,OAAO,MAAM,CAAC;AAE9C,sFAAsF;AACtF,KAAK,WAAW,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzD;AAED,mGAAmG;AACnG,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,GAAG,WAAW,CA6BxF;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAgBxF;AAQD,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAkB3D;AAqBD,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,YAAY,YAAY,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAA;KAAO,EAE9D;IAEK,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB5D;CACF"}

package/dist/raster.js

@@ -0,0 +1,193 @@
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { cacheKeyOf, FileCache } from "./cache.js";
+import { missingCodePoints, parseEmbeddedFonts, textCodePoints, } from "./d2/fonts.js";
+import { CommandCancelledError } from "./process.js";
+/**
+ * Draws a D2 SVG as a PNG. D2's own PNG export drives a headless browser it downloads on first
+ * use; resvg needs no browser and no network.
+ */
+/** Twice the natural size keeps labels readable once the terminal scales the image to cells. */
+const SCALE = 2;
+const MIN_WIDTH_PX = 480;
+const MAX_WIDTH_PX = 1600;
+const MAX_HEIGHT_PX = 2400;
+const MAX_PNG_BYTES = 4 * 1024 * 1024;
+const DEFAULT_FONT_FAMILY = "Source Sans Pro";
+/** Everything besides the SVG and resvg itself that decides the picture. */
+const IMAGE_POLICY = [
+    "png",
+    String(SCALE),
+    String(MIN_WIDTH_PX),
+    String(MAX_WIDTH_PX),
+    String(MAX_HEIGHT_PX),
+    DEFAULT_FONT_FAMILY,
+];
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+/** The diagram is fine and only the image failed, so the caller shows text rather than failing. */
+export class ImageRenderUnavailableError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ImageRenderUnavailableError";
+    }
+}
+/** resvg reporting success is not proof the bytes are a usable PNG of the size asked for. */
+export function parseRenderedPng(bytes, expectedWidthPx) {
+    if (bytes.length > MAX_PNG_BYTES) {
+        throw new ImageRenderUnavailableError(`The image is ${bytes.length} bytes, past the ${MAX_PNG_BYTES} byte limit.`);
+    }
+    const buffer = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    if (buffer.length < 24 || !buffer.subarray(0, 8).equals(PNG_SIGNATURE)) {
+        throw new ImageRenderUnavailableError("The renderer did not return a PNG.");
+    }
+    if (buffer.toString("ascii", 12, 16) !== "IHDR") {
+        throw new ImageRenderUnavailableError("The PNG does not start with an image header.");
+    }
+    if (buffer.toString("ascii", buffer.length - 8, buffer.length - 4) !== "IEND") {
+        throw new ImageRenderUnavailableError("The PNG is truncated.");
+    }
+    const widthPx = buffer.readUInt32BE(16);
+    const heightPx = buffer.readUInt32BE(20);
+    if (widthPx === 0 || heightPx === 0) {
+        throw new ImageRenderUnavailableError("The PNG has no area.");
+    }
+    // A silently ignored size option would otherwise reach the terminal as an unreadable image.
+    if (Math.abs(widthPx - expectedWidthPx) > 1) {
+        throw new ImageRenderUnavailableError(`The PNG is ${widthPx} pixels wide, not the ${expectedWidthPx} that were asked for.`);
+    }
+    return { png: bytes, widthPx, heightPx, systemFonts: false };
+}
+/** Enough resolution to scale down cleanly, never a pathological canvas. */
+export function parseTargetWidth(naturalWidthPx, naturalHeightPx) {
+    if (!Number.isFinite(naturalWidthPx) ||
+        !Number.isFinite(naturalHeightPx) ||
+        naturalWidthPx < 1 ||
+        naturalHeightPx < 1) {
+        throw new ImageRenderUnavailableError(`The SVG reports a ${naturalWidthPx} by ${naturalHeightPx} canvas.`);
+    }
+    // The limits come last, so a tall diagram is drawn smaller rather than past the canvas bound.
+    const byHeight = (MAX_HEIGHT_PX / naturalHeightPx) * naturalWidthPx;
+    const wanted = Math.max(naturalWidthPx * SCALE, MIN_WIDTH_PX);
+    return Math.max(1, Math.round(Math.min(wanted, MAX_WIDTH_PX, byHeight)));
+}
+/** The store holds text, so an image travels as base64 behind the sizes it was drawn at. */
+function formatCachedImage(image) {
+    const drawn = `${image.widthPx} ${image.heightPx} ${image.systemFonts ? 1 : 0}`;
+    return `${drawn}\n${Buffer.from(image.png).toString("base64")}`;
+}
+/** Parsed again on the way out, so a corrupt entry is drawn again rather than displayed. */
+export function parseCachedImage(entry) {
+    const split = entry.indexOf("\n");
+    const [width, height, fonts] = entry.slice(0, Math.max(split, 0)).split(" ");
+    const widthPx = Number(width);
+    const heightPx = Number(height);
+    const sized = Number.isSafeInteger(widthPx) && widthPx > 0 && Number.isSafeInteger(heightPx) && heightPx > 0;
+    if (split === -1 || !sized || (fonts !== "0" && fonts !== "1")) {
+        throw new ImageRenderUnavailableError("The stored image does not say how it was drawn.");
+    }
+    const image = parseRenderedPng(Buffer.from(entry.slice(split + 1), "base64"), widthPx);
+    if (image.heightPx !== heightPx) {
+        throw new ImageRenderUnavailableError(`The stored image is ${image.heightPx} pixels tall, not the ${heightPx} it was drawn at.`);
+    }
+    return { ...image, systemFonts: fonts === "1" };
+}
+let loaded;
+let installed;
+/** A native binary per platform, loaded lazily so an unsupported one cannot break text diagrams. */
+async function load() {
+    loaded ??= import("@resvg/resvg-js");
+    try {
+        return await loaded;
+    }
+    catch (error) {
+        loaded = undefined;
+        throw new ImageRenderUnavailableError(`The SVG rasterizer could not be loaded: ${error.message}`, { cause: error });
+    }
+}
+export class ResvgRasterizer {
+    cache;
+    constructor(dependencies = {}) {
+        this.cache = dependencies.cache ?? new FileCache();
+    }
+    async rasterize(request) {
+        if (request.signal?.aborted === true) {
+            throw new CommandCancelledError("Drawing the diagram");
+        }
+        const key = await imageKey(request.svg);
+        const stored = key === undefined ? undefined : await this.cache.read(key);
+        if (stored !== undefined) {
+            try {
+                return parseCachedImage(stored);
+            }
+            catch {
+                // An entry this build cannot read is no better than a missing one.
+            }
+        }
+        const image = await draw(request.svg);
+        if (key !== undefined) {
+            await this.cache.write(key, formatCachedImage(image));
+        }
+        return image;
+    }
+}
+/** Undefined when the version is unknown, which keeps that image out of the store. */
+async function imageKey(svg) {
+    const version = await resvgVersion();
+    return version === undefined ? undefined : cacheKeyOf([...IMAGE_POLICY, version, svg]);
+}
+/** resvg draws differently between versions, so a stored image belongs to the one that drew it. */
+async function resvgVersion() {
+    installed ??= (async () => {
+        try {
+            const manifest = createRequire(import.meta.url).resolve("@resvg/resvg-js/package.json");
+            const parsed = JSON.parse(await readFile(manifest, "utf8"));
+            const found = parsed.version;
+            return typeof found === "string" ? found : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    return installed;
+}
+async function draw(svg) {
+    const { Resvg } = await load();
+    const fonts = parseEmbeddedFonts(svg);
+    const missing = missingCodePoints(fonts, textCodePoints(svg));
+    const directory = await mkdtemp(join(tmpdir(), "pi-diagram-fonts-"));
+    try {
+        const fontFiles = await writeFonts(directory, fonts);
+        const font = {
+            fontFiles,
+            // Labels the diagram's own font cannot draw would otherwise be empty boxes.
+            loadSystemFonts: missing.length > 0,
+            defaultFontFamily: DEFAULT_FONT_FAMILY,
+        };
+        const probe = new Resvg(svg, { font });
+        const widthPx = parseTargetWidth(probe.width, probe.height);
+        const drawn = new Resvg(svg, { font, fitTo: { mode: "width", value: widthPx } });
+        const image = parseRenderedPng(drawn.render().asPng(), widthPx);
+        return { ...image, systemFonts: missing.length > 0 };
+    }
+    catch (error) {
+        if (error instanceof ImageRenderUnavailableError || error instanceof CommandCancelledError) {
+            throw error;
+        }
+        throw new ImageRenderUnavailableError(`The SVG could not be drawn as an image: ${error.message}`, { cause: error });
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}
+async function writeFonts(directory, fonts) {
+    const paths = [];
+    for (const [index, font] of fonts.entries()) {
+        const path = join(directory, `face-${index}.ttf`);
+        await writeFile(path, font.bytes, { mode: 0o600 });
+        paths.push(path);
+    }
+    return paths;
+}
+//# sourceMappingURL=raster.js.map

package/dist/raster.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,55 @@
+import { type WrittenArtifact } from "./artifacts.js";
+import { type Diagnostic } from "./d2/diagnostics.js";
+import { type ProfileName } from "./d2/profiles.js";
+import { type D2Renderer, type SupportedD2Version } from "./d2/runner.js";
+import { type SafeTitle } from "./normalize.js";
+import { type SvgRasterizer } from "./raster.js";
+/**
+ * D2's text renderer is beta, so a diagram it cannot draw has to fail in a way the user can
+ * understand rather than turning into broken box art or a different graph.
+ */
+/** How the diagram is drawn as text. */
+export type Representation = "unicode" | "ascii" | "source";
+export interface DiagramRequest {
+    readonly source: unknown;
+    readonly title?: unknown;
+    readonly profile?: unknown;
+    readonly render?: unknown;
+    readonly formats?: unknown;
+    readonly save?: unknown;
+    readonly cwd?: unknown;
+    /** Whether the host can display an image at all. Only `true` enables the raster path. */
+    readonly images?: unknown;
+    readonly signal?: AbortSignal | undefined;
+}
+interface DiagramImage {
+    /** Absolute path in the temp store. */
+    readonly path: string;
+    readonly widthPx: number;
+    readonly heightPx: number;
+}
+export interface DiagramRendering {
+    readonly profile: ProfileName;
+    readonly renderedAs: Representation;
+    readonly text: string;
+    /** The D2 source that was drawn, for the expanded view. */
+    readonly source: string;
+    /** Why the text came out the way it did. Empty when nothing went wrong. */
+    readonly diagnostics: readonly Diagnostic[];
+    readonly image: DiagramImage | undefined;
+    readonly title: SafeTitle | undefined;
+    readonly sourceHash: string;
+    readonly lineCount: number;
+    readonly widthCells: number;
+    readonly d2Version: SupportedD2Version | undefined;
+    readonly saved: readonly WrittenArtifact[];
+    readonly notes: readonly string[];
+}
+/**
+ * `image` and `auto` choose the text that goes with the image. Whether a terminal can show one is
+ * only decided when the result is displayed, so both are always prepared.
+ */
+export declare function parseRepresentation(requested: unknown): Representation;
+export declare function renderDiagram(request: DiagramRequest, renderer: D2Renderer, rasterizer?: SvgRasterizer): Promise<DiagramRendering>;
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,kBAAkB,EAExB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AAEH,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAO5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,yFAAyF;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,UAAU,YAAY;IACpB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,cAAc,CAoBtE;AAUD,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,UAAU,EACpB,UAAU,GAAE,aAAqC,GAChD,OAAO,CAAC,gBAAgB,CAAC,CAiH3B"}