@lzehrung/codegraph 2.1.0

package/dist/util/comments.js

@@ -0,0 +1,398 @@
+export function stripHashInlineComment(line, trimMode) {
+    let quote = null;
+    for (let i = 0; i < line.length; i += 1) {
+        const ch = line[i];
+        if (quote) {
+            if (ch === quote)
+                quote = null;
+            continue;
+        }
+        if (ch === "'" || ch === '"') {
+            quote = ch;
+            continue;
+        }
+        if (ch === "#") {
+            const stripped = line.slice(0, i);
+            return trimMode === "trim" ? stripped.trim() : stripped;
+        }
+    }
+    return trimMode === "trim" ? line.trim() : line;
+}
+function transformJsLikeTrivia(src, options) {
+    let out = "";
+    let i = 0;
+    let inSingle = false;
+    let inDouble = false;
+    let inTemplate = false;
+    let escapeNext = false;
+    const maskStrings = options?.maskStrings ?? false;
+    const preserveLength = options?.preserveLength ?? false;
+    const maskedChar = (ch) => (ch === "\n" || ch === "\r" ? ch : " ");
+    while (i < src.length) {
+        const ch = src[i];
+        const next = src[i + 1] ?? "";
+        if (inSingle || inDouble || inTemplate) {
+            const isClosingQuote = !escapeNext && ((inSingle && ch === "'") || (inDouble && ch === '"') || (inTemplate && ch === "`"));
+            if (maskStrings) {
+                out += isClosingQuote ? ch : maskedChar(ch);
+            }
+            else {
+                out += ch;
+            }
+            if (escapeNext) {
+                escapeNext = false;
+            }
+            else if (ch === "\\") {
+                escapeNext = true;
+            }
+            else if (inSingle && ch === "'") {
+                inSingle = false;
+            }
+            else if (inDouble && ch === '"') {
+                inDouble = false;
+            }
+            else if (inTemplate && ch === "`") {
+                inTemplate = false;
+            }
+            i += 1;
+            continue;
+        }
+        if (ch === "'") {
+            inSingle = true;
+            out += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === '"') {
+            inDouble = true;
+            out += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === "`") {
+            inTemplate = true;
+            out += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === "/" && next === "*") {
+            if (preserveLength)
+                out += "  ";
+            i += 2;
+            while (i < src.length) {
+                if (src[i] === "*" && src[i + 1] === "/") {
+                    if (preserveLength)
+                        out += "  ";
+                    i += 2;
+                    break;
+                }
+                if (preserveLength)
+                    out += maskedChar(src[i]);
+                else if (src[i] === "\n")
+                    out += "\n";
+                i += 1;
+            }
+            continue;
+        }
+        if (ch === "/" && next === "/") {
+            if (preserveLength)
+                out += "  ";
+            i += 2;
+            while (i < src.length && src[i] !== "\n") {
+                if (preserveLength)
+                    out += " ";
+                i += 1;
+            }
+            continue;
+        }
+        out += ch;
+        i += 1;
+    }
+    return out;
+}
+export function stripJsLikeComments(src) {
+    return transformJsLikeTrivia(src);
+}
+export function maskJsLikeCommentsAndStrings(src) {
+    return transformJsLikeTrivia(src, {
+        maskStrings: true,
+        preserveLength: true,
+    });
+}
+function hasJsLikeLiteralDelimiter(source) {
+    return source.includes("'") || source.includes('"') || source.includes("`") || source.includes("/");
+}
+function maskQuotedString(source, mask, start, quote) {
+    for (let i = start; i < source.length; i += 1) {
+        const ch = source[i];
+        mask[i] = 1;
+        if (ch === "\\") {
+            const nextIndex = i + 1;
+            if (nextIndex < source.length) {
+                mask[nextIndex] = 1;
+                i = nextIndex;
+            }
+            continue;
+        }
+        if (i > start && ch === quote)
+            return i + 1;
+    }
+    return source.length;
+}
+function maskTemplateLiteral(source, mask, start) {
+    mask[start] = 1;
+    for (let i = start + 1; i < source.length; i += 1) {
+        const ch = source[i];
+        mask[i] = 1;
+        if (ch === "\\") {
+            const nextIndex = i + 1;
+            if (nextIndex < source.length) {
+                mask[nextIndex] = 1;
+                i = nextIndex;
+            }
+            continue;
+        }
+        if (ch === "`")
+            return i + 1;
+        if (ch === "$" && source[i + 1] === "{") {
+            mask[i + 1] = 1;
+            i = scanTemplateExpression(source, mask, i + 2) - 1;
+        }
+    }
+    return source.length;
+}
+function scanTemplateExpression(source, mask, start) {
+    let depth = 1;
+    for (let i = start; i < source.length; i += 1) {
+        const ch = source[i];
+        if (ch === "'" || ch === '"') {
+            i = maskQuotedString(source, mask, i, ch) - 1;
+            continue;
+        }
+        if (ch === "`") {
+            i = maskTemplateLiteral(source, mask, i) - 1;
+            continue;
+        }
+        if (ch === "{") {
+            depth += 1;
+            continue;
+        }
+        if (ch === "}") {
+            depth -= 1;
+            if (!depth) {
+                mask[i] = 1;
+                return i + 1;
+            }
+        }
+    }
+    return source.length;
+}
+function previousVisibleIndex(source, mask, start) {
+    for (let i = start; i >= 0; i -= 1) {
+        if (mask[i])
+            continue;
+        if (/\s/.test(source[i] ?? ""))
+            continue;
+        return i;
+    }
+    return -1;
+}
+function precedingKeywordAllowsRegex(source, mask, prevIndex) {
+    let end = prevIndex + 1;
+    while (end > 0 && (mask[end - 1] || /\s/.test(source[end - 1] ?? ""))) {
+        end -= 1;
+    }
+    let start = end;
+    while (start > 0 && !mask[start - 1] && /[A-Za-z]/.test(source[start - 1] ?? "")) {
+        start -= 1;
+    }
+    const keyword = source.slice(start, end);
+    return keyword === "return" || keyword === "case" || keyword === "throw" || keyword === "yield";
+}
+function keywordBeforeParenAllowsRegex(source, mask, closeParenIndex) {
+    let depth = 1;
+    for (let i = closeParenIndex - 1; i >= 0; i -= 1) {
+        if (mask[i])
+            continue;
+        const ch = source[i] ?? "";
+        if (ch === ")") {
+            depth += 1;
+            continue;
+        }
+        if (ch === "(") {
+            depth -= 1;
+            if (!depth) {
+                const keywordIndex = previousVisibleIndex(source, mask, i - 1);
+                if (keywordIndex < 0)
+                    return false;
+                const end = keywordIndex + 1;
+                let start = end;
+                while (start > 0 && !mask[start - 1] && /[A-Za-z]/.test(source[start - 1] ?? "")) {
+                    start -= 1;
+                }
+                const keyword = source.slice(start, end);
+                return (keyword === "if" ||
+                    keyword === "while" ||
+                    keyword === "for" ||
+                    keyword === "switch" ||
+                    keyword === "catch" ||
+                    keyword === "with");
+            }
+        }
+    }
+    return false;
+}
+function canStartRegex(source, mask, slashIndex) {
+    if (mask[slashIndex])
+        return false;
+    const prevIndex = previousVisibleIndex(source, mask, slashIndex - 1);
+    if (prevIndex < 0)
+        return true;
+    const prev = source[prevIndex] ?? "";
+    if ("([{,:;=!?&|^~<>+-*%".includes(prev))
+        return true;
+    if (prev === ")" && keywordBeforeParenAllowsRegex(source, mask, prevIndex))
+        return true;
+    return precedingKeywordAllowsRegex(source, mask, prevIndex);
+}
+function maskRegexLiteral(source, mask, start) {
+    let inClass = false;
+    mask[start] = 1;
+    for (let i = start + 1; i < source.length; i += 1) {
+        const ch = source[i];
+        mask[i] = 1;
+        if (ch === "\n" || ch === "\r")
+            return start + 1;
+        if (ch === "\\") {
+            const nextIndex = i + 1;
+            if (nextIndex < source.length) {
+                mask[nextIndex] = 1;
+                i = nextIndex;
+            }
+            continue;
+        }
+        if (ch === "[") {
+            inClass = true;
+            continue;
+        }
+        if (ch === "]" && inClass) {
+            inClass = false;
+            continue;
+        }
+        if (ch === "/" && !inClass) {
+            let end = i + 1;
+            while (/[A-Za-z]/.test(source[end] ?? "")) {
+                mask[end] = 1;
+                end += 1;
+            }
+            return end;
+        }
+    }
+    return source.length;
+}
+export function buildJsLikeLiteralMask(source) {
+    if (!hasJsLikeLiteralDelimiter(source))
+        return undefined;
+    const mask = new Uint8Array(source.length);
+    for (let i = 0; i < source.length; i += 1) {
+        const ch = source[i];
+        if (ch === "'" || ch === '"') {
+            i = maskQuotedString(source, mask, i, ch) - 1;
+            continue;
+        }
+        if (ch === "`") {
+            i = maskTemplateLiteral(source, mask, i) - 1;
+            continue;
+        }
+        if (ch === "/" && canStartRegex(source, mask, i)) {
+            i = maskRegexLiteral(source, mask, i) - 1;
+        }
+    }
+    return mask;
+}
+function applyMask(source, mask) {
+    if (!mask)
+        return source;
+    const parts = [];
+    let segmentStart = 0;
+    for (let i = 0; i < source.length; i += 1) {
+        const ch = source[i];
+        if (!mask[i] || ch === "\n" || ch === "\r")
+            continue;
+        if (segmentStart < i)
+            parts.push(source.slice(segmentStart, i));
+        const maskStart = i;
+        while (i < source.length && mask[i] && source[i] !== "\n" && source[i] !== "\r") {
+            i += 1;
+        }
+        parts.push(" ".repeat(i - maskStart));
+        segmentStart = i;
+        i -= 1;
+    }
+    if (!parts.length)
+        return source;
+    if (segmentStart < source.length)
+        parts.push(source.slice(segmentStart));
+    return parts.join("");
+}
+export function maskJsLikeCommentsStringsAndRegex(src) {
+    const maskedTrivia = maskJsLikeCommentsAndStrings(src);
+    return applyMask(maskedTrivia, buildJsLikeLiteralMask(maskedTrivia));
+}
+export function stripJsonTrailingCommas(src) {
+    let out = "";
+    let inSingle = false;
+    let inDouble = false;
+    let escapeNext = false;
+    for (let i = 0; i < src.length; i += 1) {
+        const ch = src[i];
+        if (inSingle || inDouble) {
+            out += ch;
+            if (escapeNext) {
+                escapeNext = false;
+            }
+            else if (ch === "\\") {
+                escapeNext = true;
+            }
+            else if (inSingle && ch === "'") {
+                inSingle = false;
+            }
+            else if (inDouble && ch === '"') {
+                inDouble = false;
+            }
+            continue;
+        }
+        if (ch === "'") {
+            inSingle = true;
+            out += ch;
+            continue;
+        }
+        if (ch === '"') {
+            inDouble = true;
+            out += ch;
+            continue;
+        }
+        if (ch === ",") {
+            let j = i + 1;
+            while (j < src.length && /\s/.test(src[j]))
+                j += 1;
+            const next = src[j];
+            if (next === "}" || next === "]") {
+                continue;
+            }
+        }
+        out += ch;
+    }
+    return out;
+}
+export function parseJsonc(raw) {
+    return JSON.parse(stripJsonTrailingCommas(stripJsLikeComments(raw)));
+}
+export function stripPythonCommentsAndStrings(src) {
+    let out = src;
+    out = out.replace(/([rRuU]?[fF]?)("""|''')[\s\S]*?\2/g, "");
+    out = out.replace(/([rRuU]?[fF]?)("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/g, "");
+    out = out.replace(/#.*$/gm, "");
+    return out;
+}
+//# sourceMappingURL=comments.js.map

package/dist/util/comments.js.map

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

package/dist/util/concurrency.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A simple semaphore implementation for bounding concurrent operations.
+ */
+export declare class Semaphore {
+    private permits;
+    private waitQueue;
+    constructor(permits: number);
+    acquire(): Promise<void>;
+    release(): void;
+    withPermit<T>(fn: () => Promise<T>): Promise<T>;
+    available(): number;
+    waiting(): number;
+}
+/**
+ * Map over items with bounded concurrency, preserving input order.
+ * Invalid limits are treated as 1. The returned promise rejects on the first
+ * worker rejection and stops starting new work.
+ */
+export declare function mapLimit<T, R>(items: T[], limit: number, fn: (item: T) => Promise<R>): Promise<R[]>;
+/**
+ * Map over items with bounded concurrency using a semaphore.
+ */
+export declare function mapLimitSemaphore<T, R>(items: T[], limit: number, fn: (item: T, semaphore: Semaphore) => Promise<R>): Promise<R[]>;
+export declare function getIOSemaphore(limit?: number): Semaphore;
+export declare function resetIOSemaphore(): void;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/util/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/util/concurrency.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAyB;gBAE9B,OAAO,EAAE,MAAM;IAOrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,OAAO,IAAI,IAAI;IAST,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASrD,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,MAAM;CAGlB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAgDzG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAC1C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAChD,OAAO,CAAC,CAAC,EAAE,CAAC,CAGd;AAID,wBAAgB,cAAc,CAAC,KAAK,SAAM,GAAG,SAAS,CAKrD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/util/concurrency.js

@@ -0,0 +1,121 @@
+/**
+ * A simple semaphore implementation for bounding concurrent operations.
+ */
+export class Semaphore {
+    permits;
+    waitQueue = [];
+    constructor(permits) {
+        if (!Number.isFinite(permits) || permits < 1) {
+            throw new Error(`Semaphore permits must be a positive number, got: ${permits}`);
+        }
+        this.permits = Math.floor(permits);
+    }
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.waitQueue.push(resolve);
+        });
+    }
+    release() {
+        const next = this.waitQueue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.permits++;
+        }
+    }
+    async withPermit(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    available() {
+        return this.permits;
+    }
+    waiting() {
+        return this.waitQueue.length;
+    }
+}
+/**
+ * Map over items with bounded concurrency, preserving input order.
+ * Invalid limits are treated as 1. The returned promise rejects on the first
+ * worker rejection and stops starting new work.
+ */
+export async function mapLimit(items, limit, fn) {
+    if (!items.length)
+        return [];
+    const safeLimit = Number.isFinite(limit) ? Math.max(1, Math.floor(limit)) : 1;
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    let activeCount = 0;
+    let resolveAll = null;
+    let rejectAll = null;
+    let aborted = false;
+    const startNext = () => {
+        if (aborted)
+            return;
+        while (activeCount < safeLimit && nextIndex < items.length) {
+            if (aborted)
+                return;
+            const index = nextIndex++;
+            const item = items[index];
+            activeCount++;
+            Promise.resolve()
+                .then(() => fn(item))
+                .then((result) => {
+                activeCount--;
+                if (aborted)
+                    return;
+                results[index] = result;
+                if (nextIndex < items.length) {
+                    startNext();
+                }
+                else if (activeCount === 0 && resolveAll) {
+                    resolveAll();
+                }
+            })
+                .catch((err) => {
+                activeCount--;
+                if (aborted)
+                    return;
+                aborted = true;
+                if (rejectAll)
+                    rejectAll(err);
+            });
+        }
+    };
+    return new Promise((resolve, reject) => {
+        resolveAll = () => resolve(results);
+        rejectAll = reject;
+        startNext();
+        if (!aborted && nextIndex >= items.length && activeCount === 0) {
+            resolve(results);
+        }
+    });
+}
+/**
+ * Map over items with bounded concurrency using a semaphore.
+ */
+export async function mapLimitSemaphore(items, limit, fn) {
+    const semaphore = new Semaphore(limit);
+    return await Promise.all(items.map((item) => semaphore.withPermit(() => fn(item, semaphore))));
+}
+let globalIOSemaphore = null;
+export function getIOSemaphore(limit = 100) {
+    if (!globalIOSemaphore) {
+        globalIOSemaphore = new Semaphore(limit);
+    }
+    return globalIOSemaphore;
+}
+export function resetIOSemaphore() {
+    globalIOSemaphore = null;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/util/concurrency.js.map

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

package/dist/util/confinedFile.d.ts

@@ -0,0 +1,8 @@
+export declare function resolveReadableFile(realRoot: string, root: string, filePath: string): Promise<{
+    realPath: string;
+    displayPath: string;
+}>;
+export declare function resolveProjectFile(realRoot: string, root: string, filePath: string): Promise<string>;
+export declare function assertRealPathCandidateWithinRoot(realRoot: string, filePath: string, label: string): Promise<string>;
+export declare function findNearestExistingPath(filePath: string): Promise<string>;
+//# sourceMappingURL=confinedFile.d.ts.map

package/dist/util/confinedFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confinedFile.d.ts","sourceRoot":"","sources":["../../src/util/confinedFile.ts"],"names":[],"mappings":"AAKA,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAMpD;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ1G;AAED,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY/E"}

package/dist/util/confinedFile.js

@@ -0,0 +1,53 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { isFilePathWithinRoot, normalizePath, toProjectRelativePath } from "./paths.js";
+export async function resolveReadableFile(realRoot, root, filePath) {
+    const candidatePath = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(root, filePath);
+    const realPath = await assertRealPathCandidateWithinRoot(realRoot, candidatePath, "File");
+    const displayPath = toProjectRelativePath(root, candidatePath) ?? toProjectRelativePath(realRoot, realPath) ?? normalizePath(realPath);
+    return { realPath, displayPath };
+}
+export async function resolveProjectFile(realRoot, root, filePath) {
+    const candidatePath = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(root, filePath);
+    const realPath = await assertRealPathCandidateWithinRoot(realRoot, candidatePath, "File");
+    const lexicalRelativePath = toProjectRelativePath(root, candidatePath);
+    if (lexicalRelativePath)
+        return normalizePath(candidatePath);
+    const realRelativePath = toProjectRelativePath(realRoot, realPath);
+    if (realRelativePath)
+        return normalizePath(path.resolve(root, realRelativePath));
+    throw new Error(`File is outside project root: ${normalizePath(realPath)} (root: ${normalizePath(realRoot)})`);
+}
+export async function assertRealPathCandidateWithinRoot(realRoot, filePath, label) {
+    const existingPath = await findNearestExistingPath(filePath);
+    const realExistingPath = await fs.realpath(existingPath);
+    const relativeSuffix = path.relative(existingPath, filePath);
+    const realTargetPath = path.resolve(realExistingPath, relativeSuffix);
+    if (!isFilePathWithinRoot(realRoot, realTargetPath)) {
+        throw new Error(`${label} is outside project root: ${normalizePath(realTargetPath)} (root: ${normalizePath(realRoot)})`);
+    }
+    const finalRealPath = await fs.realpath(filePath);
+    if (!isFilePathWithinRoot(realRoot, finalRealPath)) {
+        throw new Error(`${label} is outside project root: ${normalizePath(finalRealPath)} (root: ${normalizePath(realRoot)})`);
+    }
+    return finalRealPath;
+}
+export async function findNearestExistingPath(filePath) {
+    let current = filePath;
+    while (current !== path.dirname(current)) {
+        try {
+            await fs.stat(current);
+            return current;
+        }
+        catch (error) {
+            if (!isMissingPathError(error))
+                throw error;
+            current = path.dirname(current);
+        }
+    }
+    return current;
+}
+function isMissingPathError(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=confinedFile.js.map

package/dist/util/confinedFile.js.map

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

package/dist/util/discoveryPath.d.ts

@@ -0,0 +1,3 @@
+export declare function isRelativePathInside(relativePath: string): boolean;
+export declare function matchesDiscoveryGlob(absolutePath: string, projectRoot: string, matcher: (relativePath: string) => boolean): boolean;
+//# sourceMappingURL=discoveryPath.d.ts.map

package/dist/util/discoveryPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoveryPath.d.ts","sourceRoot":"","sources":["../../src/util/discoveryPath.ts"],"names":[],"mappings":"AAGA,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAUlE;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,GACzC,OAAO,CAMT"}