@mcuste/pi-diagram 0.0.0

package/dist/d2/preflight.js

@@ -0,0 +1,217 @@
+import { DiagramSourceError } from "./diagnostics.js";
+/** D2's documented shapes, less `image`, which loads a file or a URL. */
+const ALLOWED_SHAPES = new Set([
+    "rectangle",
+    "square",
+    "page",
+    "parallelogram",
+    "document",
+    "cylinder",
+    "queue",
+    "package",
+    "step",
+    "callout",
+    "stored_data",
+    "person",
+    "diamond",
+    "oval",
+    "circle",
+    "hexagon",
+    "cloud",
+    "text",
+    "code",
+    "class",
+    "sql_table",
+    "sequence_diagram",
+    "c4-person",
+]);
+/** D2 treats `user@example.com` as label text, so only a token-initial `@` is an import. */
+const IMPORT = /(?:^|[\s:{};,])@|\.\.\.[ \t]*@/gu;
+const ASSET_KEY = /(?:^|[\s{};,.])(icon|link)[ \t]*:/gu;
+const SHAPE_KEY = /(?:^|[\s{};,.])shape[ \t]*:[ \t]*(\S*)/gu;
+const CONFIG_KEY = /(?:^|[\s{};,.])(d2-config|layout-engine)[ \t]*:/gu;
+/** Throws with one diagnostic per problem found, rather than at the first. */
+export function parseSafeSource(source) {
+    const diagnostics = inspect(source);
+    if (diagnostics.length > 0) {
+        throw new DiagramSourceError("Diagram source uses D2 features this tool does not allow.", diagnostics);
+    }
+    return source;
+}
+/** Exported so tests can read the diagnostics without catching the error. */
+export function inspect(source) {
+    const lineStarts = buildLineStarts(source);
+    const locate = (offset) => locateOffset(lineStarts, offset);
+    const { masked, diagnostics } = mask(source, locate);
+    if (diagnostics.length > 0) {
+        // Masking stopped early, so the rest of the source cannot be read reliably.
+        return diagnostics;
+    }
+    return scan(masked, locate);
+}
+/**
+ * Blanks the inside of comments and quoted strings, keeping delimiters and every offset so
+ * diagnostics can carry a real line and column. Stops at a block string, where code and content
+ * can no longer be told apart, and at an unterminated string, which D2 also rejects.
+ */
+function mask(source, locate) {
+    const out = [];
+    let index = 0;
+    while (index < source.length) {
+        const char = source[index];
+        if (char === "#") {
+            out.push("#");
+            index += 1;
+            while (index < source.length && source[index] !== "\n") {
+                out.push(" ");
+                index += 1;
+            }
+            continue;
+        }
+        if (char === "|") {
+            return {
+                masked: out.join(""),
+                diagnostics: [
+                    {
+                        code: "D2_BLOCK_STRING",
+                        message: "Block strings and Markdown, LaTeX, or code labels are not allowed.",
+                        hint: "Use a plain quoted label. They also render as an empty box in text output.",
+                        ...locate(index),
+                    },
+                ],
+            };
+        }
+        if (char === '"' || char === "'") {
+            const closed = maskString(source, index, char, out);
+            if (closed === undefined) {
+                return {
+                    masked: out.join(""),
+                    diagnostics: [
+                        {
+                            code: "D2_UNTERMINATED",
+                            message: `Unterminated ${char === '"' ? "double" : "single"}-quoted string.`,
+                            hint: "Close the quote. D2 rejects strings that span lines.",
+                            ...locate(index),
+                        },
+                    ],
+                };
+            }
+            index = closed;
+            continue;
+        }
+        out.push(char);
+        index += 1;
+    }
+    return { masked: out.join(""), diagnostics: [] };
+}
+/**
+ * Returns the offset past the closing quote, or `undefined` if it never closes on its line.
+ * Double quotes honour backslash escapes; single quotes are raw.
+ */
+function maskString(source, start, quote, out) {
+    out.push(quote);
+    let index = start + 1;
+    while (index < source.length) {
+        const char = source[index];
+        if (char === "\n") {
+            return undefined;
+        }
+        if (quote === '"' && char === "\\" && index + 1 < source.length) {
+            out.push(" ", " ");
+            index += 2;
+            continue;
+        }
+        if (char === quote) {
+            out.push(quote);
+            return index + 1;
+        }
+        out.push(" ");
+        index += 1;
+    }
+    return undefined;
+}
+function scan(masked, locate) {
+    const diagnostics = [];
+    for (const match of masked.matchAll(IMPORT)) {
+        const offset = match.index + match[0].indexOf("@");
+        diagnostics.push({
+            code: "D2_IMPORT",
+            message: "Imports are not allowed. They can read any file on this machine.",
+            hint: "Write the whole diagram in this call, and quote the label if you meant text.",
+            ...locate(offset),
+        });
+    }
+    for (const match of masked.matchAll(ASSET_KEY)) {
+        const key = match[1];
+        diagnostics.push(key === "icon"
+            ? {
+                code: "D2_ICON",
+                message: "Icons are not allowed. They load local files or remote URLs.",
+                hint: "Use a built-in shape and a label instead.",
+                ...locate(match.index + match[0].indexOf(key)),
+            }
+            : {
+                code: "D2_LINK",
+                message: "Links are not allowed.",
+                hint: "Put the destination in the label text if it matters.",
+                ...locate(match.index + match[0].indexOf(key)),
+            });
+    }
+    for (const match of masked.matchAll(SHAPE_KEY)) {
+        const value = (match[1] ?? "").replace(/[{};,]+$/u, "");
+        if (ALLOWED_SHAPES.has(value)) {
+            continue;
+        }
+        const offset = match.index + match[0].indexOf("shape");
+        diagnostics.push(value === "image"
+            ? {
+                code: "D2_IMAGE_SHAPE",
+                message: "`shape: image` is not allowed. It loads a local file or a remote URL.",
+                hint: "Use a built-in shape such as `rectangle` or `cylinder`.",
+                ...locate(offset),
+            }
+            : {
+                code: "D2_UNKNOWN_SHAPE",
+                message: `Unsupported shape ${JSON.stringify(value)}.`,
+                hint: `Allowed shapes: ${[...ALLOWED_SHAPES].join(", ")}.`,
+                ...locate(offset),
+            });
+    }
+    for (const match of masked.matchAll(CONFIG_KEY)) {
+        const key = match[1];
+        diagnostics.push({
+            code: "D2_CONFIG",
+            message: `Renderer configuration (${key}) cannot be set from diagram source.`,
+            hint: "Layout and theme are chosen by this tool.",
+            ...locate(match.index + match[0].indexOf(key)),
+        });
+    }
+    return diagnostics.sort(byPosition);
+}
+function byPosition(left, right) {
+    return (left.line ?? 0) - (right.line ?? 0) || (left.column ?? 0) - (right.column ?? 0);
+}
+function buildLineStarts(source) {
+    const starts = [0];
+    for (let index = 0; index < source.length; index += 1) {
+        if (source[index] === "\n") {
+            starts.push(index + 1);
+        }
+    }
+    return starts;
+}
+function locateOffset(lineStarts, offset) {
+    let low = 0;
+    let high = lineStarts.length - 1;
+    while (low < high) {
+        const middle = Math.ceil((low + high) / 2);
+        if (lineStarts[middle] <= offset) {
+            low = middle;
+        }
+        else {
+            high = middle - 1;
+        }
+    }
+    return { line: low + 1, column: offset - lineStarts[low] + 1 };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/d2/preflight.js.map

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

package/dist/d2/profiles.d.ts

@@ -0,0 +1,34 @@
+export declare const PROFILE_NAMES: readonly ["explain", "architecture", "data", "docs", "tree", "c4", "dependency"];
+export type ProfileName = (typeof PROFILE_NAMES)[number];
+/** The engines expose different spacing options, so a profile states only its own engine's. */
+export type LayoutPolicy = {
+    readonly engine: "elk";
+    /** Pixels between one row of nodes and the next. */
+    readonly layerGapPx: number;
+    /** Pixels between a node and an edge routed past it. */
+    readonly edgeGapPx: number;
+    /** Pixels between a container's border and what it holds. */
+    readonly containerPadPx: number;
+} | {
+    readonly engine: "dagre";
+    /** Pixels between one node and the next across a row. */
+    readonly nodeGapPx: number;
+    /** Pixels between two edges running side by side. */
+    readonly edgeGapPx: number;
+};
+export interface RenderProfile {
+    readonly name: ProfileName;
+    /** D2 theme id used in light mode. */
+    readonly theme: number;
+    /** D2 theme id a viewer in dark mode gets instead. */
+    readonly darkTheme: number;
+    /** Pixels around the whole drawing. */
+    readonly padPx: number;
+    /** Hand-drawn strokes and a handwriting font. */
+    readonly sketch: boolean;
+    readonly layout: LayoutPolicy;
+}
+/** Diagrams that explain something in passing, which is most of them. */
+export declare const DEFAULT_PROFILE: RenderProfile;
+export declare function parseProfile(raw: unknown): RenderProfile;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/d2/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/d2/profiles.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,aAAa,YACxB,SAAS,EACT,cAAc,EACd,MAAM,EACN,MAAM,EACN,MAAM,EACN,IAAI,EACJ,YAAY,CACJ,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,+FAA+F;AAC/F,MAAM,MAAM,YAAY,GACpB;IACE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEN,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AA6ED,yEAAyE;AACzE,eAAO,MAAM,eAAe,EAAE,aAAgC,CAAC;AAE/D,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAgBxD"}

package/dist/d2/profiles.js

@@ -0,0 +1,118 @@
+import { DiagramSourceError } from "./diagnostics.js";
+/**
+ * What a diagram is for decides how it looks. The model names the purpose, this table sets the
+ * engine, the theme, and the spacing, so diagrams stay consistent between calls.
+ *
+ * The policy reaches D2 as CLI flags, which take precedence over anything the source sets.
+ */
+/** Neutral Default: light containers under near-white nodes, which keeps the nesting readable. */
+const NEUTRAL_THEME = 0;
+/** Neutral Grey: no colour to lose, so it still reads when a document is printed. */
+const GREY_THEME = 1;
+/** C4, so a diagram drawn in that convention is coloured the way its readers expect. */
+const C4_THEME = 303;
+/** Dark Mauve, D2's neutral dark theme, so a saved SVG follows the reader into dark mode. */
+const DARK_THEME = 200;
+export const PROFILE_NAMES = [
+    "explain",
+    "architecture",
+    "data",
+    "docs",
+    "tree",
+    "c4",
+    "dependency",
+];
+const PROFILES = {
+    /**
+     * The default. Drawn by hand because an answer in a conversation is a rough model, and a crisp
+     * diagram claims more precision than the explanation has.
+     */
+    explain: {
+        name: "explain",
+        theme: NEUTRAL_THEME,
+        darkTheme: DARK_THEME,
+        padPx: 30,
+        sketch: true,
+        layout: { engine: "elk", layerGapPx: 60, edgeGapPx: 40, containerPadPx: 40 },
+    },
+    // Room between the ranks, so the edges crossing between containers stay separable.
+    architecture: {
+        name: "architecture",
+        theme: NEUTRAL_THEME,
+        darkTheme: DARK_THEME,
+        padPx: 60,
+        sketch: false,
+        layout: { engine: "elk", layerGapPx: 90, edgeGapPx: 50, containerPadPx: 60 },
+    },
+    // Tables and classes are tall already, so the space around them is kept tight.
+    data: {
+        name: "data",
+        theme: NEUTRAL_THEME,
+        darkTheme: DARK_THEME,
+        padPx: 30,
+        sketch: false,
+        layout: { engine: "elk", layerGapPx: 50, edgeGapPx: 30, containerPadPx: 30 },
+    },
+    // Sized for a page rather than a transcript row, with a theme that survives greyscale.
+    docs: {
+        name: "docs",
+        theme: GREY_THEME,
+        darkTheme: DARK_THEME,
+        padPx: 100,
+        sketch: false,
+        layout: { engine: "elk", layerGapPx: 80, edgeGapPx: 40, containerPadPx: 50 },
+    },
+    /**
+     * The one profile that changes engine: dagre fans children out under their parent, which is how
+     * a hierarchy is normally drawn.
+     */
+    tree: {
+        name: "tree",
+        theme: NEUTRAL_THEME,
+        darkTheme: DARK_THEME,
+        padPx: 40,
+        sketch: false,
+        layout: { engine: "dagre", nodeGapPx: 40, edgeGapPx: 20 },
+    },
+    // Architecture spacing. The palette is the whole difference.
+    c4: {
+        name: "c4",
+        theme: C4_THEME,
+        darkTheme: DARK_THEME,
+        padPx: 60,
+        sketch: false,
+        layout: { engine: "elk", layerGapPx: 90, edgeGapPx: 50, containerPadPx: 60 },
+    },
+    /**
+     * For a graph with more nodes than usual. Edges routed past nodes fill most of a large graph, so
+     * that gap is cut first.
+     */
+    dependency: {
+        name: "dependency",
+        theme: NEUTRAL_THEME,
+        darkTheme: DARK_THEME,
+        padPx: 20,
+        sketch: false,
+        layout: { engine: "elk", layerGapPx: 40, edgeGapPx: 20, containerPadPx: 20 },
+    },
+};
+/** Diagrams that explain something in passing, which is most of them. */
+export const DEFAULT_PROFILE = PROFILES.explain;
+export function parseProfile(raw) {
+    if (raw === undefined) {
+        return DEFAULT_PROFILE;
+    }
+    // Matched against the names, not looked up on the table, so `toString` cannot become a profile.
+    const name = PROFILE_NAMES.find((candidate) => candidate === raw);
+    if (name === undefined) {
+        throw new DiagramSourceError("Unsupported diagram profile.", [
+            {
+                code: "D2_SOURCE",
+                message: `${JSON.stringify(raw)} is not a profile.`,
+                hint: `Use ${PROFILE_NAMES.join(", ")}.`,
+            },
+        ]);
+    }
+    return PROFILES[name];
+}
+//# sourceMappingURL=profiles.js.map

package/dist/d2/profiles.js.map

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

package/dist/d2/runner.d.ts

@@ -0,0 +1,95 @@
+import { type RenderCache } from "../cache.js";
+import { type CommandResult, type CommandRunner } from "../process.js";
+import { type Diagnostic } from "./diagnostics.js";
+import type { SafeD2Source } from "./preflight.js";
+import type { RenderProfile } from "./profiles.js";
+export type AsciiMode = "extended" | "standard";
+declare const supportedVersionBrand: unique symbol;
+declare const renderedTextBrand: unique symbol;
+declare const renderedSvgBrand: unique symbol;
+/** Confirmed at or above `MINIMUM_D2_VERSION`. */
+export type SupportedD2Version = string & {
+    readonly [supportedVersionBrand]: true;
+};
+/** Output that passed `parseRenderedText`, so it is safe to print. */
+export type RenderedDiagramText = string & {
+    readonly [renderedTextBrand]: true;
+};
+/** Output that passed `parseRenderedSvg`, so it is safe to write into the workspace. */
+export type RenderedSvg = string & {
+    readonly [renderedSvgBrand]: true;
+};
+export interface D2TextRequest {
+    readonly source: SafeD2Source;
+    readonly asciiMode: AsciiMode;
+    readonly signal: AbortSignal | undefined;
+}
+export interface D2Text {
+    readonly text: RenderedDiagramText;
+    readonly version: SupportedD2Version;
+}
+export interface D2SvgRequest {
+    readonly source: SafeD2Source;
+    readonly profile: RenderProfile;
+    readonly signal: AbortSignal | undefined;
+}
+export interface D2Svg {
+    readonly svg: RenderedSvg;
+    readonly version: SupportedD2Version;
+}
+export interface D2FormatRequest {
+    readonly source: SafeD2Source;
+    readonly signal: AbortSignal | undefined;
+}
+export interface D2Renderer {
+    renderText(request: D2TextRequest): Promise<D2Text>;
+    renderSvg(request: D2SvgRequest): Promise<D2Svg>;
+    /** The same source as `d2 fmt` writes it. Throws when D2 will not format it. */
+    formatSource(request: D2FormatRequest): Promise<string>;
+}
+/** D2 accepted the source but drew nothing usable. Not the model's mistake to correct. */
+export declare class TextRenderUnavailableError extends Error {
+    readonly diagnostics: readonly Diagnostic[];
+    constructor(message: string, diagnostics?: readonly Diagnostic[]);
+}
+/** D2 reports strings such as `v0.8.1-HEAD`, so only the three numbers are compared. */
+export declare function parseD2Version(result: CommandResult): SupportedD2Version;
+/**
+ * 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 declare function parseRenderedText(raw: string, mode: AsciiMode): RenderedDiagramText;
+/**
+ * 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 declare function parseRenderedSvg(raw: string): RenderedSvg;
+export declare class D2Cli implements D2Renderer {
+    private readonly runner;
+    private readonly binary;
+    private readonly cache;
+    private version;
+    /** Cache keys of sources this process has compiled, so one call validates them once. */
+    private readonly validated;
+    constructor(dependencies?: {
+        runner?: CommandRunner;
+        binary?: string;
+        cache?: RenderCache;
+    });
+    renderText(request: D2TextRequest): Promise<D2Text>;
+    renderSvg(request: D2SvgRequest): Promise<D2Svg>;
+    /** The formatted source is read back from the temp directory, since `fmt` writes no stdout. */
+    formatSource(request: D2FormatRequest): Promise<string>;
+    private compile;
+    private remember;
+    private validate;
+    private ensureVersion;
+    private run;
+}
+/**
+ * `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 declare function parseBinaryName(value: string | undefined): string;
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/d2/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/d2/runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,aAAa,EAGnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,UAAU,EAA0C,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,eAAe,CAAC;AAuBjE,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAGhD,OAAO,CAAC,MAAM,qBAAqB,EAAE,OAAO,MAAM,CAAC;AACnD,OAAO,CAAC,MAAM,iBAAiB,EAAE,OAAO,MAAM,CAAC;AAC/C,OAAO,CAAC,MAAM,gBAAgB,EAAE,OAAO,MAAM,CAAC;AAK9C,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAErF,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAElF,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,gFAAgF;IAChF,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzD;AAUD,0FAA0F;AAC1F,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAE5C,YAAY,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,SAAS,UAAU,EAAO,EAInE;CACF;AAkED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAiBxE;AA6CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,mBAAmB,CA6BnF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAwBzD;AAKD,qBAAa,KAAM,YAAW,UAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,OAAO,CAAiC;IAChD,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,YAAY,YAAY,GAAE;QAAE,MAAM,CAAC,EAAE,aAAa,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,WAAW,CAAA;KAAO,EAI9F;IAEK,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxD;IAEK,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAOrD;IAED,+FAA+F;IACzF,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B5D;YAEa,OAAO;IAoDrB,OAAO,CAAC,QAAQ;YAOF,QAAQ;YAUR,aAAa;YAUb,GAAG;CAmBlB;AA8BD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASjE"}