@untangle-code/cli 0.0.0-stage → 0.1.0

package/dist/commands/graph/feature-map.js

@@ -0,0 +1,217 @@
+import { constants } from "node:fs";
+import { lstat, mkdir, open, realpath, rm, rmdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { analyzeProductAlignment } from "@untangle-code/core";
+import { canonicalJson, sha256Hex } from "@untangle-code/domain";
+import { discoverFiles } from "@untangle-code/scanner";
+import { NodeFileSystem } from "@untangle-code/scanner/node-fs";
+import { enumFlag, integerFlag, stringFlag } from "../../cli/args.js";
+import { UsageError } from "../../cli/exit.js";
+import { line, note } from "../../cli/io.js";
+import { createFeatureMapHtml } from "./feature-html.js";
+import { buildFeatureMapGraph, featureMapLimits, } from "./feature-model.js";
+/** Reuse the safe scanner for a declared-feature-free census; never invent ownership or metrics. */
+async function unassignedCensus(root, signal) {
+    const paths = [];
+    for await (const file of discoverFiles({
+        fs: new NodeFileSystem(),
+        roots: [root],
+        repoRoot: root,
+        ignore: {
+            additionalDefaultExcludes: [
+                "/.untangle",
+                "/untangle.toml",
+                "/untangle.toml.untangle-init-tmp",
+            ],
+        },
+        ...(signal === undefined ? {} : { signal }),
+    })) {
+        signal?.throwIfAborted();
+        if (file.languageId === "unknown" ||
+            file.languageId === "markdown" ||
+            /\.(?:json|toml|ya?ml|lock)$/iu.test(file.relativePath))
+            continue;
+        paths.push(file.relativePath);
+        if (paths.length >= 50_000)
+            break;
+    }
+    return paths;
+}
+async function metadataDirectory(root, created, signal) {
+    let directory = root;
+    for (const component of [".untangle", "feature-map"]) {
+        signal?.throwIfAborted();
+        directory = path.join(directory, component);
+        let made = true;
+        await mkdir(directory, { mode: 0o700 }).catch((error) => {
+            if (error.code !== "EEXIST")
+                throw error;
+            made = false;
+        });
+        const info = await lstat(directory);
+        if (!info.isDirectory() || info.isSymbolicLink() || (await realpath(directory)) !== directory)
+            throw new Error("Feature-map metadata directories must be physical in-project directories, not symlinks.");
+        if (made)
+            created.push({ path: directory, ino: info.ino, dev: info.dev });
+    }
+    return directory;
+}
+async function removeEmptyOwnDirectories(created) {
+    for (const directory of [...created].reverse()) {
+        const current = await lstat(directory.path).catch(() => null);
+        if (current?.ino === directory.ino && current.dev === directory.dev && current.isDirectory())
+            await rmdir(directory.path).catch((error) => {
+                if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error.code ?? ""))
+                    throw error;
+            });
+    }
+}
+async function readRegular(filePath) {
+    const handle = await open(filePath, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        if (!(await handle.stat()).isFile())
+            throw new Error("Feature-map artifact must be a regular file.");
+        return await handle.readFile("utf8");
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Exclusive creation preserves foreign bytes; interrupted own partial files are removed. */
+async function preserve(filePath, content, signal) {
+    signal?.throwIfAborted();
+    const handle = await open(filePath, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600).catch(async (error) => {
+        if (error.code !== "EEXIST")
+            throw error;
+        if ((await readRegular(filePath)) !== content)
+            throw new Error("Existing feature-map artifact differs; refusing to overwrite it.");
+        return null;
+    });
+    if (handle === null)
+        return false;
+    try {
+        signal?.throwIfAborted();
+        await handle.writeFile(content, "utf8");
+        await handle.sync();
+        signal?.throwIfAborted();
+    }
+    catch (error) {
+        const identity = await handle.stat();
+        const observed = await lstat(filePath).catch(() => null);
+        if (observed?.ino === identity.ino && observed.dev === identity.dev)
+            await rm(filePath);
+        throw error;
+    }
+    finally {
+        await handle.close();
+    }
+    return true;
+}
+/** Builds an index-free, source-bound artifact without executing tests or opening a browser. */
+export async function writeFeatureMap(options, deps = {}) {
+    options.signal?.throwIfAborted();
+    const limits = featureMapLimits(options);
+    const root = await realpath(path.resolve(options.root));
+    if (!(await stat(root)).isDirectory())
+        throw new TypeError("Feature-map root must be a directory.");
+    // Own metadata exists before the census, so its excluded-directory event is
+    // stable on the second run; every measurement and source digest remains raw.
+    const createdDirectories = [];
+    try {
+        const directory = await metadataDirectory(root, createdDirectories, options.signal);
+        const report = await (deps.analyze ?? analyzeProductAlignment)({
+            root,
+            ...(options.manifestPath === undefined
+                ? {}
+                : { manifestPath: path.resolve(root, options.manifestPath) }),
+            ...(options.testEvidencePath === undefined
+                ? {}
+                : { testEvidencePath: path.resolve(root, options.testEvidencePath) }),
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        });
+        options.signal?.throwIfAborted();
+        const unassigned = report.status === "needs_manifest" ? await unassignedCensus(root, options.signal) : [];
+        if (unassigned.length > 0) {
+            const current = await (deps.analyze ?? analyzeProductAlignment)({
+                root,
+                ...(options.manifestPath === undefined
+                    ? {}
+                    : { manifestPath: path.resolve(root, options.manifestPath) }),
+                ...(options.signal === undefined ? {} : { signal: options.signal }),
+            });
+            if (current.sourceTreeDigest !== report.sourceTreeDigest)
+                throw new Error("Project sources changed while collecting unassigned file paths; regenerate the feature map.");
+        }
+        const graph = buildFeatureMapGraph(report, limits, unassigned);
+        const json = JSON.stringify({ schemaVersion: 1, kind: "feature_map_snapshot", graph, report }, null, 2) +
+            "\n";
+        const html = createFeatureMapHtml(graph);
+        const digest = sha256Hex(canonicalJson({ json, html }));
+        const prefix = path.join(directory, `feature-map-${digest.slice(0, 16)}`);
+        const jsonPath = `${prefix}.json`, htmlPath = `${prefix}.html`;
+        let createdJson = false;
+        let createdHtml = false;
+        try {
+            createdJson = await preserve(jsonPath, json, options.signal);
+            createdHtml = await preserve(htmlPath, html, options.signal);
+            options.signal?.throwIfAborted();
+        }
+        catch (error) {
+            if (createdHtml && (await readRegular(htmlPath).catch(() => null)) === html)
+                await rm(htmlPath);
+            if (createdJson && (await readRegular(jsonPath).catch(() => null)) === json)
+                await rm(jsonPath);
+            throw error;
+        }
+        return {
+            schemaVersion: 1,
+            kind: "feature_map_artifact",
+            htmlPath,
+            jsonPath,
+            sha256: { html: sha256Hex(html), json: sha256Hex(json) },
+            summary: graph.summary,
+            graph,
+            report,
+        };
+    }
+    catch (error) {
+        await removeEmptyOwnDirectories(createdDirectories);
+        throw error;
+    }
+}
+/** `graph features`: deliberately bypasses stored-graph loading and all service probes. */
+export async function runFeatureMap(ctx, args) {
+    if (args.positionals.length !== 0)
+        throw new UsageError("graph features accepts no additional positional arguments.");
+    const format = enumFlag(args, "format", ["text", "json"], "text");
+    const root = path.resolve(ctx.cwd, stringFlag(args, "root") ?? ".");
+    const manifestPath = stringFlag(args, "feature-map");
+    const testEvidencePath = stringFlag(args, "test-evidence");
+    const maxNodes = integerFlag(args, "max-nodes", 500), maxEdges = integerFlag(args, "max-edges", 2_000);
+    try {
+        featureMapLimits({ maxNodes, maxEdges });
+    }
+    catch (error) {
+        throw new UsageError(error.message);
+    }
+    const result = await writeFeatureMap({
+        root,
+        maxNodes,
+        maxEdges,
+        signal: ctx.signal,
+        ...(manifestPath === undefined ? {} : { manifestPath }),
+        ...(testEvidencePath === undefined ? {} : { testEvidencePath }),
+    });
+    if (format === "json")
+        line(ctx.io, JSON.stringify(result, null, 2));
+    else {
+        line(ctx.io, result.htmlPath);
+        note(ctx.io, `Feature map: ${result.summary.features} declared features, ${result.summary.shownNodes}/${result.summary.totalNodes} nodes, ${result.summary.shownEdges}/${result.summary.totalEdges} edges; ${result.summary.status}.`);
+        note(ctx.io, `Complete report: ${result.jsonPath}`);
+        note(ctx.io, "Open the local HTML file in a browser. No index, service, network request or test execution is required.");
+        if (result.summary.truncated)
+            note(ctx.io, "Bounded diagram; complete feature metrics remain in the JSON report.");
+    }
+    return 0;
+}
+//# sourceMappingURL=feature-map.js.map

package/dist/commands/graph/feature-map.js.map

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

package/dist/commands/graph/feature-model.d.ts

@@ -0,0 +1,55 @@
+import { type ProductAlignmentReportV1 } from "@untangle-code/domain";
+export type FeatureMapNodeKind = "feature" | "code" | "test" | "owner" | "intent" | "unmapped";
+export type FeatureMapEdgeKind = "code" | "test" | "ownership" | "intent" | "dependency";
+export interface FeatureMapNodeV1 {
+    id: string;
+    kind: FeatureMapNodeKind;
+    label: string;
+    path?: string;
+    status: string;
+    cognitive?: number;
+    details: Record<string, unknown>;
+}
+export interface FeatureMapEdgeV1 {
+    id: string;
+    from: string;
+    to: string;
+    kind: FeatureMapEdgeKind;
+}
+export interface FeatureMapSummaryV1 {
+    status: ProductAlignmentReportV1["status"];
+    features: number;
+    shownNodes: number;
+    totalNodes: number;
+    shownEdges: number;
+    totalEdges: number;
+    truncated: boolean;
+    mappedCodeFiles: number;
+    unmappedCodeFiles: number;
+    inventoryFiles: number;
+}
+export interface FeatureMapGraphV1 {
+    schemaVersion: 1;
+    sourceTreeDigest: string;
+    nodes: FeatureMapNodeV1[];
+    edges: FeatureMapEdgeV1[];
+    summary: FeatureMapSummaryV1;
+    limits: {
+        maxNodes: number;
+        maxEdges: number;
+    };
+    limitations: string[];
+    issues: string[];
+    dependencyCycles: string[][];
+}
+export interface FeatureMapLimitsV1 {
+    maxNodes?: number;
+    maxEdges?: number;
+}
+export declare function featureMapLimits(input: FeatureMapLimitsV1): {
+    maxNodes: number;
+    maxEdges: number;
+};
+/** Relations are declarations/evidence, never inferred semantic or runtime calls. */
+export declare function buildFeatureMapGraph(report: ProductAlignmentReportV1, input?: FeatureMapLimitsV1, unassignedPaths?: readonly string[]): FeatureMapGraphV1;
+//# sourceMappingURL=feature-model.d.ts.map

package/dist/commands/graph/feature-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-model.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/feature-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC/F,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AACzF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AACD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AACD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,CAAC,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gBAAgB,EAAE,MAAM,EAAE,EAAE,CAAC;CAC9B;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAQA;AAMD,qFAAqF;AACrF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,wBAAwB,EAChC,KAAK,GAAE,kBAAuB,EAC9B,eAAe,GAAE,SAAS,MAAM,EAAO,GACtC,iBAAiB,CA+JnB"}

package/dist/commands/graph/feature-model.js

@@ -0,0 +1,167 @@
+import { canonicalJson, compareCodepoints, uuidv5, } from "@untangle-code/domain";
+export function featureMapLimits(input) {
+    const maxNodes = input.maxNodes ?? 500;
+    const maxEdges = input.maxEdges ?? 2_000;
+    if (!Number.isInteger(maxNodes) || maxNodes < 1 || maxNodes > 2_000)
+        throw new RangeError("maxNodes must be an integer between 1 and 2000.");
+    if (!Number.isInteger(maxEdges) || maxEdges < 1 || maxEdges > 10_000)
+        throw new RangeError("maxEdges must be an integer between 1 and 10000.");
+    return { maxNodes, maxEdges };
+}
+function identity(kind, key) {
+    return uuidv5(canonicalJson({ surface: "feature-map-v1", kind, key }));
+}
+/** Relations are declarations/evidence, never inferred semantic or runtime calls. */
+export function buildFeatureMapGraph(report, input = {}, unassignedPaths = []) {
+    const limits = featureMapLimits(input);
+    const nodes = new Map();
+    const edges = new Map();
+    const addNode = (kind, key, data) => {
+        const id = identity(kind === "test" ? "code" : kind, key);
+        const existing = nodes.get(id);
+        // A file selected as both code and test keeps one identity and both role facts.
+        if (existing !== undefined && (kind === "code" || kind === "test")) {
+            const roles = new Set([...existing.details["roles"], kind]);
+            existing.details["roles"] = [...roles].sort(compareCodepoints);
+        }
+        else if (existing === undefined)
+            nodes.set(id, { id, kind, ...data });
+        return id;
+    };
+    const addEdge = (from, to, kind) => {
+        const id = identity("edge", canonicalJson({ from, to, kind }));
+        edges.set(id, { id, from, to, kind });
+    };
+    const features = [...report.features].sort((a, b) => compareCodepoints(a.id, b.id));
+    for (const feature of features) {
+        addNode("feature", feature.id, {
+            label: feature.title,
+            status: feature.status,
+            ...(feature.code.metrics === null
+                ? {}
+                : { cognitive: feature.code.metrics.cognitive.execution_unit }),
+            details: {
+                featureId: feature.id,
+                stage: feature.stage,
+                review: feature.review,
+                codeComplete: feature.code.complete,
+                testComplete: feature.tests.complete,
+                metrics: feature.code.metrics,
+                testMetrics: feature.tests.metrics,
+                testEvidence: feature.testEvidence,
+                dimensions: feature.dimensions,
+                criteria: feature.criteria,
+                hotspots: feature.code.hotspots,
+                agentHints: feature.agentHints,
+                issues: feature.issues,
+            },
+        });
+    }
+    for (const feature of features) {
+        const featureId = identity("feature", feature.id);
+        for (const owner of feature.ownership) {
+            const ownerId = addNode("owner", owner.id, {
+                label: owner.label ?? owner.id,
+                status: owner.status,
+                details: {
+                    ownerId: owner.id,
+                    authority: report.ownershipAuthority,
+                    sources: owner.sources,
+                },
+            });
+            addEdge(featureId, ownerId, "ownership");
+        }
+        for (const intent of feature.intent) {
+            const intentId = addNode("intent", canonicalJson({ path: intent.path, heading: intent.heading }), {
+                label: intent.heading || intent.path,
+                path: intent.path,
+                status: intent.status,
+                details: {
+                    role: intent.role,
+                    heading: intent.heading,
+                    contentHash: intent.contentHash,
+                    startLine: intent.startLine,
+                    endLine: intent.endLine,
+                },
+            });
+            addEdge(featureId, intentId, "intent");
+        }
+        for (const role of ["code", "test"]) {
+            const selection = role === "code" ? feature.code : feature.tests;
+            for (const file of selection.files) {
+                const fileId = addNode(role, file.path, {
+                    label: file.path,
+                    path: file.path,
+                    status: file.status,
+                    details: {
+                        roles: [role],
+                        contentHash: file.contentHash,
+                        sharedFeatures: report.coverage.sharedFiles.find((shared) => shared.path === file.path)?.featureIds ??
+                            [],
+                    },
+                });
+                addEdge(featureId, fileId, role);
+            }
+        }
+        for (const dependency of feature.dependsOn) {
+            const target = identity("feature", dependency);
+            if (nodes.has(target))
+                addEdge(featureId, target, "dependency");
+        }
+    }
+    const unmapped = [...new Set([...report.coverage.unmappedCodeFiles, ...unassignedPaths])].sort(compareCodepoints);
+    for (const filePath of unmapped) {
+        // The fallback census is not an AST measurement and does not imply a feature.
+        if (nodes.has(identity("code", filePath)))
+            continue;
+        addNode("unmapped", filePath, {
+            label: filePath,
+            path: filePath,
+            status: "unmapped",
+            details: { featureAssignment: "none", measurement: "not_provided_by_feature_report" },
+        });
+    }
+    const allNodes = [...nodes.values()];
+    const shownNodes = allNodes.slice(0, limits.maxNodes);
+    const visible = new Set(shownNodes.map((node) => node.id));
+    const allEdges = [...edges.values()].sort((a, b) => compareCodepoints(a.id, b.id));
+    const shownEdges = allEdges
+        .filter((edge) => visible.has(edge.from) && visible.has(edge.to))
+        .slice(0, limits.maxEdges);
+    return {
+        schemaVersion: 1,
+        sourceTreeDigest: report.sourceTreeDigest,
+        nodes: shownNodes,
+        edges: shownEdges,
+        summary: {
+            status: report.status,
+            features: report.features.length,
+            shownNodes: shownNodes.length,
+            totalNodes: allNodes.length,
+            shownEdges: shownEdges.length,
+            totalEdges: allEdges.length,
+            truncated: shownNodes.length < allNodes.length ||
+                shownEdges.length < allEdges.length ||
+                report.inventory.truncated,
+            mappedCodeFiles: report.coverage.mappedCodeFiles,
+            unmappedCodeFiles: Math.max(report.coverage.unmappedCodeFileCount, unmapped.length),
+            inventoryFiles: report.inventory.files,
+        },
+        limits,
+        issues: report.issues,
+        dependencyCycles: report.dependencyCycles,
+        limitations: [
+            ...report.limitations,
+            "Only declared feature, code/test, intent and ownership relations are drawn. Feature dependency edges are not code imports or runtime calls.",
+            "Node size represents complete feature cognitive execution_unit complexity only when measured. File sizes do not claim file complexity.",
+            "The diagram is a bounded source snapshot. Filtered or omitted nodes never reduce the complete feature metrics in the report.",
+            "Spatial positions, depth and thread curvature are visualization choices, not semantic similarity, coupling scores or additional relationships.",
+            ...(unassignedPaths.length === 0
+                ? []
+                : [
+                    "Unassigned paths come from an accepted scanner census; they carry no inferred feature, owner or AST metric.",
+                ]),
+        ],
+    };
+}
+//# sourceMappingURL=feature-model.js.map

package/dist/commands/graph/feature-model.js.map

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

package/dist/commands/graph/feature-untangle-motion.d.ts

@@ -0,0 +1,33 @@
+import type { FeaturePoint3D } from "./feature-3d.js";
+export interface FeatureUntangleState {
+    phase: "idle" | "running" | "paused" | "complete";
+    target: "wool" | "clusters";
+    progress: number;
+}
+export interface FeatureUntangleTransition {
+    from: Readonly<Record<string, FeaturePoint3D>>;
+    to: Readonly<Record<string, FeaturePoint3D>>;
+    fromAmount: number;
+    toAmount: number;
+    target: "wool" | "clusters";
+}
+export interface FeatureUntangleMotionOptions {
+    requestFrame?: (callback: (timestamp: number) => void) => number;
+    cancelFrame?: (id: number) => void;
+    reducedMotion: () => boolean;
+    visible: () => boolean;
+    onFrame: (positions: Record<string, FeaturePoint3D>, clusterAmount: number) => void;
+    onState: (state: FeatureUntangleState) => void;
+    durationMs?: number;
+    frameIntervalMs?: number;
+}
+/** Self-contained for the offline viewer's CSP-hashed serialized runtime. */
+export declare function createFeatureUntangleMotion(options: FeatureUntangleMotionOptions): {
+    start: (input: FeatureUntangleTransition) => void;
+    pause: () => void;
+    resume: () => void;
+    finish: () => void;
+    cancel: () => void;
+    getState: () => FeatureUntangleState;
+};
+//# sourceMappingURL=feature-untangle-motion.d.ts.map

package/dist/commands/graph/feature-untangle-motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-untangle-motion.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/feature-untangle-motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAClD,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC/C,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,CAAC;IACjE,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IACpF,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B;mBA+HzD,yBAAyB;;;;;oBAjH1B,oBAAoB;EAqJ1C"}