@mcuste/pi-diagram 0.0.0

package/dist/d2/runner.js

@@ -0,0 +1,350 @@
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { cacheKey, FileCache } from "../cache.js";
+import { CommandCancelledError, CommandInvocationError, CommandOutputLimitError, CommandTimeoutError, runCommand, } from "../process.js";
+import { DiagramSourceError, parseD2Diagnostics } from "./diagnostics.js";
+/**
+ * Runs the D2 CLI. The source reaches D2 only as a file in a fresh temporary directory: no
+ * model-written string ever enters the argument list, which is built from the literals below.
+ */
+/**
+ * 0.7.x draws `shape: sql_table` as an empty box, losing every column. The prebuilt GitHub
+ * release binaries stop at 0.7.1, so the pinned path is the module tag, not a release asset.
+ */
+const MINIMUM_D2_VERSION = "0.8.0";
+const D2_TIMEOUT_SECONDS = 10;
+/** Above D2's own timeout, so D2 reports it first and this only catches a hung process. */
+const PROCESS_TIMEOUT_MS = (D2_TIMEOUT_SECONDS + 5) * 1000;
+const MAX_RENDER_BYTES = 1024 * 1024;
+const INPUT_FILE = "input.d2";
+const INSTALL_HINT = "Install the D2 CLI with `brew install d2` or " +
+    "`go install github.com/d2lang/d2@v0.8.1`, or point D2_BIN at an existing one. Version " +
+    `${MINIMUM_D2_VERSION} or newer is required.`;
+/** The user has to fix this by installing D2. Retrying the call will not help. */
+class D2UnavailableError extends Error {
+    constructor(message, options) {
+        super(`${message} ${INSTALL_HINT}`, { ...options });
+        this.name = "D2UnavailableError";
+    }
+}
+/** D2 accepted the source but drew nothing usable. Not the model's mistake to correct. */
+export class TextRenderUnavailableError extends Error {
+    diagnostics;
+    constructor(message, diagnostics = []) {
+        super(message);
+        this.name = "TextRenderUnavailableError";
+        this.diagnostics = diagnostics;
+    }
+}
+function args(...values) {
+    return values;
+}
+/** No theme or spacing: D2 draws text in character cells, which neither one changes. */
+function renderArguments(mode) {
+    return args("--layout", "elk", "--timeout", String(D2_TIMEOUT_SECONDS), "--ascii-mode", mode, "--stdout-format", "ascii", INPUT_FILE, "-");
+}
+function svgArguments(profile) {
+    return args("--layout", profile.layout.engine, ...spacingArguments(profile.layout), ...(profile.sketch ? ["--sketch"] : []), "--theme", String(profile.theme), "--dark-theme", String(profile.darkTheme), "--pad", String(profile.padPx), "--timeout", String(D2_TIMEOUT_SECONDS), "--stdout-format", "svg", INPUT_FILE, "-");
+}
+/** `d2 fmt` rewrites the file it is given, so there is no output format to ask for. */
+const FORMAT_ARGUMENTS = args("fmt", INPUT_FILE);
+function spacingArguments(layout) {
+    if (layout.engine === "dagre") {
+        return [
+            "--dagre-nodesep",
+            String(layout.nodeGapPx),
+            "--dagre-edgesep",
+            String(layout.edgeGapPx),
+        ];
+    }
+    const pad = layout.containerPadPx;
+    return [
+        "--elk-nodeNodeBetweenLayers",
+        String(layout.layerGapPx),
+        "--elk-edgeNodeBetweenLayers",
+        String(layout.edgeGapPx),
+        "--elk-padding",
+        `[top=${pad},left=${pad},bottom=${pad},right=${pad}]`,
+    ];
+}
+/** D2 reports strings such as `v0.8.1-HEAD`, so only the three numbers are compared. */
+export function parseD2Version(result) {
+    const raw = (result.stdout.trim() || result.stderr.trim()).split("\n")[0]?.trim() ?? "";
+    const match = /^v?(\d+)\.(\d+)\.(\d+)/u.exec(raw);
+    if (!match || result.exitCode !== 0) {
+        throw new D2UnavailableError(`Could not read a version from D2 (${raw ? JSON.stringify(raw) : "no output"}).`);
+    }
+    const found = triple(match[1], match[2], match[3]);
+    if (found === undefined) {
+        throw new D2UnavailableError(`Could not read a version from D2 (${JSON.stringify(raw)}).`);
+    }
+    if (isBelow(found, MINIMUM_VERSION)) {
+        throw new D2UnavailableError(`D2 ${raw} is installed, which is too old.`);
+    }
+    return raw;
+}
+const MINIMUM_VERSION = versionOf(MINIMUM_D2_VERSION);
+function versionOf(value) {
+    const parts = value.split(".");
+    const version = triple(parts[0], parts[1], parts[2]);
+    if (version === undefined) {
+        throw new Error(`Not a three-part version: ${JSON.stringify(value)}.`);
+    }
+    return version;
+}
+function triple(major, minor, patch) {
+    const numbers = [major, minor, patch].map((part) => Number(part));
+    const [first, second, third] = numbers;
+    if (first === undefined ||
+        second === undefined ||
+        third === undefined ||
+        !numbers.every((part) => Number.isSafeInteger(part) && part >= 0)) {
+        return undefined;
+    }
+    return [first, second, third];
+}
+function isBelow(found, minimum) {
+    const [foundMajor, foundMinor, foundPatch] = found;
+    const [minMajor, minMinor, minPatch] = minimum;
+    if (foundMajor !== minMajor) {
+        return foundMajor < minMajor;
+    }
+    if (foundMinor !== minMinor) {
+        return foundMinor < minMinor;
+    }
+    return foundPatch < minPatch;
+}
+/**
+ * D2 exiting zero does not mean the output is usable: the beta text renderer returns blank
+ * drawings, and a silently ignored mode flag would otherwise reach the terminal unnoticed.
+ */
+export function parseRenderedText(raw, mode) {
+    const text = raw
+        .replace(/\r\n?/gu, "\n")
+        .replace(/[ \t]+$/gmu, "")
+        .replace(/\n+$/u, "");
+    if (text.trim().length === 0) {
+        throw new TextRenderUnavailableError("D2 produced an empty text diagram.");
+    }
+    for (const char of text) {
+        const code = char.codePointAt(0) ?? 0;
+        if (code < 32 && char !== "\n") {
+            throw new TextRenderUnavailableError(`D2 text output contains a control character (U+${code.toString(16).padStart(4, "0").toUpperCase()}).`);
+        }
+        if (mode === "standard" && code > 126) {
+            throw new TextRenderUnavailableError(`D2 returned a non-ASCII character (${JSON.stringify(char)}) in standard ASCII mode.`);
+        }
+    }
+    const drew = mode === "standard" ? /[+\-|]/u.test(text) : /[\u2500-\u257F\u25A0-\u25FF]/u.test(text);
+    if (!drew) {
+        throw new TextRenderUnavailableError("D2 text output contains no diagram lines or boxes.");
+    }
+    return text;
+}
+/**
+ * D2 documents exported SVG as web content. The safe subset already rules out icons, images, and
+ * Markdown labels, so anything active or externally referenced here means it was bypassed.
+ */
+export function parseRenderedSvg(raw) {
+    const svg = raw.trim();
+    if (svg.length === 0) {
+        throw new TextRenderUnavailableError("D2 produced an empty SVG.");
+    }
+    if (!svg.startsWith("<?xml") && !svg.startsWith("<svg")) {
+        throw new TextRenderUnavailableError("D2 output does not start like an SVG document.");
+    }
+    if (!svg.endsWith("</svg>")) {
+        throw new TextRenderUnavailableError("D2 returned a truncated SVG document.");
+    }
+    const lowered = svg.toLowerCase();
+    for (const forbidden of ["<script", "<foreignobject", "<image", "<iframe", "<use"]) {
+        if (lowered.includes(forbidden)) {
+            throw new TextRenderUnavailableError(`D2 SVG contains ${forbidden}>, which this tool does not write.`);
+        }
+    }
+    if (/(?:xlink:)?href\s*=\s*["']?(?:https?:|\/\/)/u.test(lowered)) {
+        throw new TextRenderUnavailableError("D2 SVG references a remote URL.");
+    }
+    return svg;
+}
+/** Bounds what one session remembers about sources D2 already accepted. */
+const MAX_VALIDATED = 256;
+export class D2Cli {
+    runner;
+    binary;
+    cache;
+    version;
+    /** Cache keys of sources this process has compiled, so one call validates them once. */
+    validated = new Set();
+    constructor(dependencies = {}) {
+        this.runner = dependencies.runner ?? runCommand;
+        this.binary = dependencies.binary ?? parseBinaryName(process.env.D2_BIN);
+        this.cache = dependencies.cache ?? new FileCache();
+    }
+    async renderText(request) {
+        const { output, version } = await this.compile(request.source, request.signal, {
+            argv: renderArguments(request.asciiMode),
+            parse: (stdout) => parseRenderedText(stdout, request.asciiMode),
+            failure: "D2 could not draw this diagram as text.",
+        });
+        return { text: output, version };
+    }
+    async renderSvg(request) {
+        const { output, version } = await this.compile(request.source, request.signal, {
+            argv: svgArguments(request.profile),
+            parse: parseRenderedSvg,
+            failure: "D2 could not draw this diagram as an SVG.",
+        });
+        return { svg: output, version };
+    }
+    /** The formatted source is read back from the temp directory, since `fmt` writes no stdout. */
+    async formatSource(request) {
+        const version = await this.ensureVersion(request.signal);
+        const key = cacheKey({
+            source: request.source,
+            language: "d2",
+            binary: this.binary,
+            version,
+            argv: FORMAT_ARGUMENTS,
+        });
+        const stored = await this.cache.read(key);
+        if (stored !== undefined) {
+            return stored;
+        }
+        const directory = await mkdtemp(join(tmpdir(), "pi-diagram-"));
+        try {
+            const path = join(directory, INPUT_FILE);
+            await writeFile(path, `${request.source}\n`, "utf8");
+            const result = await this.run(FORMAT_ARGUMENTS, directory, request.signal);
+            if (result.exitCode !== 0) {
+                throw new TextRenderUnavailableError("D2 could not format this source.", parseD2Diagnostics(result.stderr, "D2_RENDER", [directory]));
+            }
+            const formatted = await readFile(path, "utf8");
+            await this.cache.write(key, formatted);
+            return formatted;
+        }
+        finally {
+            await rm(directory, { recursive: true, force: true });
+        }
+    }
+    async compile(source, signal, step) {
+        const version = await this.ensureVersion(signal);
+        if (signal?.aborted === true) {
+            // A cached answer would otherwise come back after the call was given up on.
+            throw new CommandCancelledError("Drawing the diagram");
+        }
+        const identity = { source, language: "d2", binary: this.binary, version };
+        const key = cacheKey({ ...identity, argv: step.argv });
+        // No arguments: what D2 accepts depends on the source and the version, not on the flags.
+        const compiles = cacheKey({ ...identity, argv: [] });
+        const stored = await this.cache.read(key);
+        if (stored !== undefined) {
+            try {
+                const output = step.parse(stored);
+                this.remember(compiles);
+                return { output, version };
+            }
+            catch {
+                // An entry this build cannot read is no better than a missing one.
+            }
+        }
+        const directory = await mkdtemp(join(tmpdir(), "pi-diagram-"));
+        try {
+            await writeFile(join(directory, INPUT_FILE), `${source}\n`, "utf8");
+            if (!this.validated.has(compiles)) {
+                await this.validate(directory, signal);
+            }
+            const rendered = await this.run(step.argv, directory, signal);
+            if (rendered.exitCode !== 0) {
+                throw new TextRenderUnavailableError(step.failure, parseD2Diagnostics(rendered.stderr, "D2_RENDER", [directory]));
+            }
+            const output = step.parse(rendered.stdout);
+            this.remember(compiles);
+            await this.cache.write(key, rendered.stdout);
+            return { output, version };
+        }
+        finally {
+            await rm(directory, { recursive: true, force: true });
+        }
+    }
+    remember(key) {
+        if (this.validated.size >= MAX_VALIDATED) {
+            this.validated.clear();
+        }
+        this.validated.add(key);
+    }
+    async validate(directory, signal) {
+        const result = await this.run(args("validate", INPUT_FILE), directory, signal);
+        if (result.exitCode !== 0) {
+            throw new DiagramSourceError("D2 could not compile this source.", parseD2Diagnostics(result.stderr, "D2_SYNTAX", [directory]));
+        }
+    }
+    async ensureVersion(signal) {
+        if (this.version !== undefined) {
+            return this.version;
+        }
+        // Deliberately not cached on failure, so installing D2 mid-session starts working.
+        const result = await this.run(args("--version"), tmpdir(), signal);
+        this.version = parseD2Version(result);
+        return this.version;
+    }
+    async run(argv, cwd, signal) {
+        try {
+            return await this.runner(this.binary, argv, {
+                cwd,
+                signal,
+                // D2 renders correctly with an empty environment. PATH is here only so a bare
+                // command name resolves.
+                env: { PATH: process.env.PATH ?? "" },
+                timeoutMs: PROCESS_TIMEOUT_MS,
+                maxOutputBytes: MAX_RENDER_BYTES,
+            });
+        }
+        catch (error) {
+            throw translate(error, this.binary);
+        }
+    }
+}
+function translate(error, binary) {
+    if (error instanceof CommandCancelledError) {
+        return error;
+    }
+    if (error instanceof CommandInvocationError) {
+        return new D2UnavailableError(`Could not run ${JSON.stringify(binary)}.`, { cause: error });
+    }
+    if (error instanceof CommandTimeoutError) {
+        return new DiagramSourceError("Rendering this diagram took too long.", [
+            {
+                code: "D2_TIMEOUT",
+                message: `D2 did not finish within ${D2_TIMEOUT_SECONDS} seconds.`,
+                hint: "Use fewer nodes, or split the diagram.",
+            },
+        ]);
+    }
+    if (error instanceof CommandOutputLimitError) {
+        return new DiagramSourceError("The rendered diagram is too large.", [
+            {
+                code: "D2_TOO_LARGE",
+                message: `D2 produced more than ${MAX_RENDER_BYTES} bytes.`,
+                hint: "Use fewer nodes, or split the diagram.",
+            },
+        ]);
+    }
+    return error;
+}
+/**
+ * `D2_BIN` is not model input, but it still lands in an exec call, so anything that could read
+ * as an option or split into extra arguments is refused.
+ */
+export function parseBinaryName(value) {
+    if (value === undefined || value.trim().length === 0) {
+        return "d2";
+    }
+    const binary = value.trim();
+    if (binary.startsWith("-") || /[\s"'`$;&|<>]/u.test(binary)) {
+        throw new D2UnavailableError(`D2_BIN is not a usable command: ${JSON.stringify(value)}.`);
+    }
+    return binary;
+}
+//# sourceMappingURL=runner.js.map

package/dist/d2/runner.js.map

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

package/dist/display.d.ts

@@ -0,0 +1,48 @@
+export interface Component {
+    render(width: number): string[];
+}
+export interface DisplayTheme {
+    fg(color: string, text: string): string;
+}
+export interface DisplayContext {
+    readonly showImages: boolean;
+    readonly expanded: boolean;
+    /** Per-row scratch space from the host, used to read each image only once. */
+    readonly state: Record<string, unknown>;
+}
+interface DisplayImage {
+    readonly path: string;
+    readonly widthPx: number;
+    readonly heightPx: number;
+}
+/**
+ * The library keeps image placement state in module scope, so the host and this package have to
+ * use the same copy. A local checkout has its own, which wins by bare name.
+ */
+export declare function tuiSpecifier(entry: string | undefined): string;
+/** Loaded once at registration, since a render cannot wait on an import. */
+export declare function primeDisplay(): Promise<void>;
+/** Whether the terminal speaks an image protocol, or `undefined` until the library has loaded. */
+export declare function imagesSupported(): boolean | undefined;
+/** Whether this package can draw a result row at all, or the host has to print the text. */
+export declare function displayLoaded(): boolean;
+export interface DiagramCallView {
+    /** What is being drawn: the title, or a line count when there is no title. */
+    readonly subject: string;
+    /** The profile, and the directory when the call also saves files. */
+    readonly note: string;
+}
+/** The row while D2 runs. The source would fill the transcript, so it is not shown. */
+export declare function renderDiagramCall(view: DiagramCallView, theme: DisplayTheme): Component;
+export declare function renderDiagramResult(view: DiagramView, theme: DisplayTheme, context: DisplayContext): Component;
+export interface DiagramView {
+    readonly image: DisplayImage | undefined;
+    readonly title: string | undefined;
+    /** Drawn when there is no image, or when the one there is cannot be shown. */
+    readonly text: string;
+    readonly notes: readonly string[];
+    /** Render mode, paths, diagnostics, and source. Shown only in the expanded row. */
+    readonly details: readonly string[];
+}
+export {};
+//# sourceMappingURL=display.d.ts.map

package/dist/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAiBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAS9D;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAY5C;AAED,kGAAkG;AAClG,wBAAgB,eAAe,IAAI,OAAO,GAAG,SAAS,CAErD;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAWD,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,CASvF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,GACtB,SAAS,CAuCX;AAUD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC"}

package/dist/display.js

@@ -0,0 +1,120 @@
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+/**
+ * Turns a diagram result into terminal components. Both the image and the text are drawn here
+ * rather than by the host, so neither has to travel back through the model's context. The image is
+ * read from the temp store at display time.
+ */
+/** Wide enough for an architecture diagram, short enough to leave the transcript readable. */
+const MAX_WIDTH_CELLS = 80;
+/** Without a bound the library reserves a square, about 40 rows, drawn or not. */
+const MAX_HEIGHT_CELLS = 30;
+const MAX_IMAGE_BYTES = 4 * 1024 * 1024;
+let tui;
+/**
+ * The library keeps image placement state in module scope, so the host and this package have to
+ * use the same copy. A local checkout has its own, which wins by bare name.
+ */
+export function tuiSpecifier(entry) {
+    if (entry !== undefined) {
+        try {
+            return pathToFileURL(createRequire(entry).resolve("@earendil-works/pi-tui")).href;
+        }
+        catch {
+            // Not resolvable from the host, so fall back to whatever this package can see.
+        }
+    }
+    return "@earendil-works/pi-tui";
+}
+/** Loaded once at registration, since a render cannot wait on an import. */
+export function primeDisplay() {
+    if (tui !== undefined) {
+        return Promise.resolve();
+    }
+    return import(tuiSpecifier(process.argv[1])).then((module) => {
+        tui = module;
+    }, () => {
+        // Text rendering needs none of this, so a missing library is not worth reporting.
+    });
+}
+/** Whether the terminal speaks an image protocol, or `undefined` until the library has loaded. */
+export function imagesSupported() {
+    return tui === undefined ? undefined : tui.getCapabilities().images !== null;
+}
+/** Whether this package can draw a result row at all, or the host has to print the text. */
+export function displayLoaded() {
+    return tui !== undefined;
+}
+/** Throws when the library is missing, which the host takes as a request to draw the row itself. */
+function loadedModule() {
+    if (tui === undefined) {
+        primeDisplay();
+        throw new Error("The TUI library is not loaded.");
+    }
+    return tui;
+}
+/** The row while D2 runs. The source would fill the transcript, so it is not shown. */
+export function renderDiagramCall(view, theme) {
+    const module = loadedModule();
+    const text = [
+        theme.fg("toolTitle", "diagram "),
+        theme.fg("accent", view.subject),
+        " ",
+        theme.fg("muted", view.note),
+    ].join("");
+    return new module.Text(text, 0, 0);
+}
+export function renderDiagramResult(view, theme, context) {
+    const module = loadedModule();
+    const container = new module.Container();
+    const line = (text) => {
+        container.addChild(new module.Text(theme.fg("toolOutput", text), 0, 0));
+    };
+    if (view.title !== undefined) {
+        line(view.title);
+    }
+    const image = drawable(module, view.image, context) ? view.image : undefined;
+    if (image === undefined) {
+        line(view.text);
+    }
+    else {
+        try {
+            container.addChild(new module.Image(read(image, context), "image/png", { fallbackColor: (text) => theme.fg("toolOutput", text) }, {
+                maxWidthCells: MAX_WIDTH_CELLS,
+                maxHeightCells: MAX_HEIGHT_CELLS,
+                filename: image.path,
+            }, { widthPx: image.widthPx, heightPx: image.heightPx }));
+        }
+        catch {
+            // The picture is gone from the temp store, so show the text instead.
+            line(view.text);
+        }
+    }
+    const footer = [...view.notes, ...(context.expanded ? view.details : [])];
+    if (footer.length > 0) {
+        line(footer.join("\n"));
+    }
+    return container;
+}
+function drawable(module, image, context) {
+    return image !== undefined && context.showImages && module.getCapabilities().images !== null;
+}
+/** Reads the image once per result row: the host calls the renderer again on every redraw. */
+function read(image, context) {
+    const cached = context.state["diagramImage"];
+    if (typeof cached === "object" && cached !== null) {
+        const { path, encoded } = cached;
+        if (path === image.path && typeof encoded === "string") {
+            return encoded;
+        }
+    }
+    const bytes = readFileSync(image.path);
+    if (bytes.length === 0 || bytes.length > MAX_IMAGE_BYTES) {
+        throw new Error(`The image at ${image.path} is ${bytes.length} bytes.`);
+    }
+    const encoded = bytes.toString("base64");
+    context.state["diagramImage"] = { path: image.path, encoded };
+    return encoded;
+}
+//# sourceMappingURL=display.js.map

package/dist/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;GAIG;AAEH,8FAA8F;AAC9F,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,kFAAkF;AAClF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAoCxC,IAAI,GAA0B,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,+EAA+E;QACjF,CAAC;IACH,CAAC;IACD,OAAO,wBAAwB,CAAC;AAClC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY;IAC1B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC/C,CAAC,MAAM,EAAE,EAAE;QACT,GAAG,GAAG,MAA8B,CAAC;IACvC,CAAC,EACD,GAAG,EAAE;QACH,kFAAkF;IACpF,CAAC,CACF,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,eAAe;IAC7B,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC;AAC/E,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,aAAa;IAC3B,OAAO,GAAG,KAAK,SAAS,CAAC;AAC3B,CAAC;AAED,oGAAoG;AACpG,SAAS,YAAY;IACnB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,YAAY,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AASD,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,IAAqB,EAAE,KAAmB;IAC1E,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG;QACX,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;QACjC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC;QAChC,GAAG;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC;KAC7B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAiB,EACjB,KAAmB,EACnB,OAAuB;IAEvB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAQ,EAAE;QAClC,SAAS,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,SAAS,CAAC,QAAQ,CAChB,IAAI,MAAM,CAAC,KAAK,CACd,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EACpB,WAAW,EACX,EAAE,aAAa,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,EACjE;gBACE,aAAa,EAAE,eAAe;gBAC9B,cAAc,EAAE,gBAAgB;gBAChC,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,EACD,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CACrD,CACF,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CACf,MAAiB,EACjB,KAA+B,EAC/B,OAAuB;IAEvB,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC;AAC/F,CAAC;AAYD,8FAA8F;AAC9F,SAAS,IAAI,CAAC,KAAmB,EAAE,OAAuB;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAA+C,CAAC;QAC1E,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAC9D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { type DiagramExtensionApi } from "./tools.js";
+export default function piDiagram(pi: DiagramExtensionApi): void;
+//# 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,OAAO,EAAE,KAAK,mBAAmB,EAAwB,MAAM,YAAY,CAAC;AAE5E,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI,CAE/D"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { registerDiagramTools } from "./tools.js";
+export default function piDiagram(pi) {
+    registerDiagramTools(pi);
+}
+//# 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,OAAO,EAA4B,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAAuB;IACvD,oBAAoB,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,23 @@
+declare const normalizedSourceBrand: unique symbol;
+declare const safeTitleBrand: unique symbol;
+/**
+ * Source in canonical form: no byte-order mark, LF endings, trimmed, no control characters,
+ * within the size cap. Only `normalizeSource` can produce one.
+ */
+export type NormalizedD2Source = string & {
+    readonly [normalizedSourceBrand]: true;
+};
+/** A single-line title of bounded length, safe to show beside the diagram. */
+export type SafeTitle = string & {
+    readonly [safeTitleBrand]: true;
+};
+export interface NormalizedSource {
+    readonly text: NormalizedD2Source;
+    readonly hash: string;
+    readonly lineCount: number;
+}
+/** Runs before anything inspects or renders, so the scanner and D2 see the same bytes. */
+export declare function normalizeSource(raw: unknown): NormalizedSource;
+export declare function parseTitle(raw: unknown): SafeTitle | undefined;
+export {};
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAaA,OAAO,CAAC,MAAM,qBAAqB,EAAE,OAAO,MAAM,CAAC;AACnD,OAAO,CAAC,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAErF,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AA2BD,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAyC9D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAc9D"}