@miller-tech/uap 1.221.0 → 2.0.0

package/dist/quality/report.d.ts

@@ -0,0 +1,38 @@
+import { QualityConfig } from './config.js';
+import { Violation, MetricId } from './scanner.js';
+import { ToolStatus } from './tools.js';
+export interface QualityReport {
+    root: string;
+    filesScanned: number;
+    violations: Violation[];
+    blocking: Violation[];
+    grandfathered: Violation[];
+    improved: Array<{
+        violation: Violation;
+        baselineValue: number;
+    }>;
+    /** Metrics skipped because their tool/data source is unavailable. */
+    skipped: Array<{
+        metric: string;
+        reason: string;
+    }>;
+    tools: ToolStatus[];
+    pass: boolean;
+    baselinePresent: boolean;
+}
+/** Recursively collect scannable source files under root/src (or root). */
+export declare function collectSourceFiles(root: string, config: QualityConfig): string[];
+/** Files changed vs the upstream base PLUS staged/unstaged/untracked work —
+ * a per-commit gate that only sees committed diffs would miss the commit's
+ * actual content. */
+export declare function changedFiles(root: string, config: QualityConfig): string[];
+export interface ReportOptions {
+    /** Explicit relative file list; default: full scan of collectSourceFiles. */
+    files?: string[];
+    /** Skip external tools even when installed (fast path / tests). */
+    builtinOnly?: boolean;
+}
+/** Build the full quality report for a set of files. */
+export declare function buildReport(root: string, config: QualityConfig, options?: ReportOptions): QualityReport;
+export type { MetricId };
+//# sourceMappingURL=report.d.ts.map

package/dist/quality/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/quality/report.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAkC,QAAQ,EAAE,MAAM,cAAc,CAAC;AAInF,OAAO,EACL,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA6BhF;AAED;;qBAEqB;AACrB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA6B1E;AAED,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAkJD,wDAAwD;AACxD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CA4Bf;AAED,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/quality/report.js

@@ -0,0 +1,251 @@
+/**
+ * Quality report orchestration: collect files, run every available metric,
+ * merge external-tool numbers over built-in heuristics, compute CRAP from
+ * coverage, and split violations into blocking vs grandfathered via the
+ * ratchet baseline.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
+import { join, relative } from 'path';
+import { execSync } from 'child_process';
+import { isScannableSource, scanContent } from './scanner.js';
+import { analyzeComplexity } from './complexity.js';
+import { languageForFile } from './languages.js';
+import { crapScore, coverageFor, loadCoverageSummary } from './crap.js';
+import { jscpdViolations, lizardViolations, probeTools, rcaViolations, } from './tools.js';
+import { loadBaseline, ratchet } from './baseline.js';
+/** Recursively collect scannable source files under root/src (or root). */
+export function collectSourceFiles(root, config) {
+    const seeds = ['src', 'tools', 'scripts', 'web'].filter((d) => existsSync(join(root, d)));
+    const dirs = seeds.length > 0 ? seeds : ['.'];
+    const out = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            const p = join(dir, name);
+            let st;
+            try {
+                st = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (!config.excludeDirs.includes(name))
+                    walk(p);
+                continue;
+            }
+            const rel = relative(root, p).replace(/\\/g, '/');
+            if (isScannableSource(rel, config))
+                out.push(rel);
+        }
+    };
+    for (const d of dirs)
+        walk(join(root, d));
+    return out.sort();
+}
+/** Files changed vs the upstream base PLUS staged/unstaged/untracked work —
+ * a per-commit gate that only sees committed diffs would miss the commit's
+ * actual content. */
+export function changedFiles(root, config) {
+    const found = new Set();
+    const tryGit = (args) => {
+        try {
+            const out = execSync(`git ${args}`, { cwd: root, encoding: 'utf-8', timeout: 10_000 });
+            for (const l of out.split('\n')) {
+                const f = l.trim();
+                if (f)
+                    found.add(f);
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    let baseResolved = false;
+    for (const base of ['origin/master', 'origin/main', 'master', 'main']) {
+        if (tryGit(`diff --name-only ${base}...HEAD`)) {
+            baseResolved = true;
+            break;
+        }
+    }
+    // Uncommitted work: staged, unstaged, and untracked source files.
+    tryGit('diff --name-only --cached');
+    tryGit('diff --name-only');
+    tryGit('ls-files --others --exclude-standard');
+    if (!baseResolved && found.size === 0) {
+        console.error('quality: no upstream base resolvable and no working-tree changes — scanning nothing');
+    }
+    return [...found].filter((f) => isScannableSource(f, config)).sort();
+}
+/** Stage 1: the always-available built-in scan. */
+function builtinScan(root, files, config) {
+    const out = [];
+    for (const f of files) {
+        let content = '';
+        try {
+            content = readFileSync(join(root, f), 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        out.push(...scanContent(f, content, config));
+    }
+    return out;
+}
+function hasTool(tools, name) {
+    return tools.some((t) => t.name === name && t.available);
+}
+/** Stage 2a: lizard's authoritative cyclomatic/NLOC numbers replace the
+ * built-in ones when lizard is installed. */
+function applyLizard(violations, files, root, config, options, skipped) {
+    if (options.builtinOnly)
+        return violations;
+    if (!hasTool(probeCached(options), 'lizard')) {
+        skipped.push({ metric: 'cyclomatic(authoritative)', reason: 'lizard not installed — built-in heuristic used' });
+        return violations;
+    }
+    const lv = lizardViolations(files.map((f) => join(root, f)), root, config);
+    if (!lv)
+        return violations;
+    return [...violations.filter((v) => v.metric !== 'cyclomatic' && v.metric !== 'locPerFile'), ...lv];
+}
+/** Stage 2b: rust-code-analysis cognitive/Halstead replaces built-in
+ * cognitive when installed. */
+function applyRca(violations, files, root, config, options, skipped) {
+    if (options.builtinOnly)
+        return violations;
+    if (!hasTool(probeCached(options), 'rust-code-analysis')) {
+        skipped.push({ metric: 'halsteadDifficulty', reason: 'rust-code-analysis not installed' });
+        return violations;
+    }
+    const rv = rcaViolations(files.map((f) => join(root, f)), root, config);
+    if (!rv)
+        return violations;
+    return [...violations.filter((v) => v.metric !== 'cognitive'), ...rv];
+}
+/** Stage 3: coverage deficit + per-function CRAP, from vitest's
+ * coverage/coverage-summary.json. */
+function coverageStage(root, files, config, skipped) {
+    const coverage = loadCoverageSummary(root);
+    if (!coverage) {
+        skipped.push({ metric: 'coverage', reason: 'no coverage/coverage-summary.json (run npm run test:coverage)' });
+        skipped.push({ metric: 'crap', reason: 'needs coverage data' });
+        return [];
+    }
+    const t = config.thresholds;
+    const out = [];
+    for (const f of files) {
+        const cov = coverageFor(coverage, root, f);
+        if (cov === null)
+            continue;
+        if (cov * 100 < t.minCoveragePct) {
+            // The ratchet treats HIGHER value as worse, but coverage is better
+            // when higher — store the DEFICIT (threshold − pct) so a coverage
+            // regression ratchets up and an improvement ratchets down, like
+            // every other metric.
+            const deficit = Math.round((t.minCoveragePct - cov * 100) * 10) / 10;
+            out.push({
+                file: f,
+                metric: 'coverage',
+                value: deficit,
+                threshold: t.minCoveragePct,
+                signature: `${f}::coverage::<file>`,
+                message: `${f}: ${(cov * 100).toFixed(1)}% line coverage below min ${t.minCoveragePct}% (deficit ${deficit})`,
+            });
+        }
+        out.push(...crapViolations(root, f, cov, t.maxCrap));
+    }
+    return out;
+}
+/** CRAP per function: file coverage × function complexity. */
+function crapViolations(root, f, cov, maxCrap) {
+    const lang = languageForFile(f);
+    if (!lang)
+        return [];
+    let content = '';
+    try {
+        content = readFileSync(join(root, f), 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const fn of analyzeComplexity(content, lang).functions) {
+        const score = crapScore(fn.cyclomatic, cov);
+        if (score > maxCrap) {
+            out.push({
+                file: f,
+                metric: 'crap',
+                value: Math.round(score * 10) / 10,
+                threshold: maxCrap,
+                signature: `${f}::crap::${fn.name}@${fn.line}`,
+                message: `${f}:${fn.line} ${fn.name}() CRAP ${score.toFixed(1)} (cc=${fn.cyclomatic}, cov=${(cov * 100).toFixed(0)}%) exceeds max ${maxCrap}`,
+            });
+        }
+    }
+    return out;
+}
+/** Stage 4: jscpd duplication. */
+function duplicationStage(root, config, options, skipped) {
+    if (options.builtinOnly)
+        return [];
+    if (!hasTool(probeCached(options), 'jscpd')) {
+        skipped.push({ metric: 'duplicateBlocks', reason: 'jscpd not installed' });
+        return [];
+    }
+    return jscpdViolations(root, config) ?? [];
+}
+/** Stage 5: note metrics that are report-only or have no available tool. */
+function noteUnavailable(options, skipped) {
+    if (options.builtinOnly)
+        return;
+    if (!hasTool(probeCached(options), 'knip') && !hasTool(probeCached(options), 'vulture')) {
+        skipped.push({ metric: 'deadCode', reason: 'knip/vulture not installed' });
+    }
+    skipped.push({ metric: 'survivingMutants', reason: 'run `uap quality mutate` (changed-files incremental)' });
+}
+/** Probe tools once per report; stage helpers read the cached list. */
+const probeCache = new WeakMap();
+function probeCached(options) {
+    let t = probeCache.get(options);
+    if (!t) {
+        t = options.builtinOnly ? [] : probeTools();
+        probeCache.set(options, t);
+    }
+    return t;
+}
+/** Build the full quality report for a set of files. */
+export function buildReport(root, config, options = {}) {
+    const files = options.files ?? collectSourceFiles(root, config);
+    const skipped = [];
+    const tools = probeCached(options);
+    let violations = builtinScan(root, files, config);
+    violations = applyLizard(violations, files, root, config, options, skipped);
+    violations = applyRca(violations, files, root, config, options, skipped);
+    violations.push(...coverageStage(root, files, config, skipped));
+    violations.push(...duplicationStage(root, config, options, skipped));
+    noteUnavailable(options, skipped);
+    // Ratchet against the baseline.
+    const baseline = loadBaseline(root);
+    const r = ratchet(violations, baseline);
+    return {
+        root,
+        filesScanned: files.length,
+        violations,
+        blocking: r.blocking,
+        grandfathered: r.grandfathered,
+        improved: r.improved,
+        skipped,
+        tools,
+        pass: r.blocking.length === 0,
+        baselinePresent: baseline !== null,
+    };
+}
+//# sourceMappingURL=report.js.map

package/dist/quality/report.js.map

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

package/dist/quality/scanner.d.ts

@@ -0,0 +1,32 @@
+import { QualityConfig } from './config.js';
+export type MetricId = 'cyclomatic' | 'cognitive' | 'halsteadDifficulty' | 'locPerFile' | 'coverage' | 'crap' | 'survivingMutants' | 'duplicateBlocks' | 'deadCode' | 'anyTypes';
+export interface Violation {
+    file: string;
+    metric: MetricId;
+    /** Measured value (count, complexity, or percent depending on metric). */
+    value: number;
+    /** Configured threshold that was crossed. */
+    threshold: number;
+    /**
+     * Stable identity for baseline ratcheting: file + metric + the function or
+     * site the violation belongs to. Function renames intentionally re-identify
+     * a violation (a renamed complex function is reviewed as if new).
+     */
+    signature: string;
+    message: string;
+}
+/** Count explicit any/unknown usages in one file's content. */
+export declare function countAnyTypes(content: string, file: string): {
+    count: number;
+    lines: number[];
+};
+/**
+ * Scan one file's content for the always-available metrics:
+ * LOC/file, per-function cyclomatic + cognitive complexity, any-types.
+ * Halstead/CRAP/coverage/mutation/duplication/dead-code need external data
+ * and are merged later by report.ts.
+ */
+export declare function scanContent(file: string, content: string, config: QualityConfig): Violation[];
+/** True when `file` is a scannable source path under the config's rules. */
+export declare function isScannableSource(file: string, config: QualityConfig): boolean;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/quality/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/quality/scanner.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,MAAM,QAAQ,GAChB,YAAY,GACZ,WAAW,GACX,oBAAoB,GACpB,YAAY,GACZ,UAAU,GACV,MAAM,GACN,kBAAkB,GAClB,iBAAiB,GACjB,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAkB/F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,EAAE,CAuD7F;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAQ9E"}

package/dist/quality/scanner.js

@@ -0,0 +1,127 @@
+/**
+ * File scanner: turns source content into metric violations.
+ *
+ * Pure (no I/O beyond what callers hand it) so the CLI, the proxy enforcer's
+ * TS-side parity tests, and future callers all share one code path. External
+ * tool overrides (lizard numbers, jscpd clones, coverage) are merged in by
+ * report.ts — this module is the always-available built-in layer.
+ */
+import { extname } from 'path';
+import { languageForFile, stripNoise } from './languages.js';
+import { analyzeComplexity } from './complexity.js';
+/** Explicit any/unknown usage patterns, per language family. Built from
+ * strings (not regex literals) on purpose: string contents are stripped
+ * before scanning, so this file does not trip the gate over its own
+ * patterns. */
+const ANY_PATTERNS = [
+    // `: any`, `as any`, `<any>`, `Array<any>`, `Record<string, unknown>`, …
+    {
+        langs: ['typescript'],
+        re: new RegExp(':\\s*any\\b|:\\s*unknown\\b|\\bas\\s+any\\b|<any>|<unknown>|Array<\\s*any\\s*>', 'g'),
+        label: 'explicit any/unknown',
+    },
+    {
+        langs: ['javascript'],
+        re: new RegExp('/\\*\\s*@type\\s*\\{[^}]*\\b(?:any|unknown)\\b[^}]*\\}\\s*\\*/', 'g'),
+        label: 'JSDoc any/unknown',
+    },
+    {
+        langs: ['python'],
+        re: new RegExp(':\\s*Any\\b|->\\s*Any\\b|cast\\(\\s*Any\\b', 'g'),
+        label: 'typing.Any',
+    },
+];
+/** Count explicit any/unknown usages in one file's content. */
+export function countAnyTypes(content, file) {
+    const lang = languageForFile(file);
+    if (!lang)
+        return { count: 0, lines: [] };
+    const stripped = stripNoise(content, lang.commentStyle);
+    const lines = stripped.split('\n');
+    const hits = [];
+    for (const pat of ANY_PATTERNS) {
+        if (!pat.langs.includes(lang.name))
+            continue;
+        for (let i = 0; i < lines.length; i++) {
+            pat.re.lastIndex = 0;
+            let m;
+            while ((m = pat.re.exec(lines[i])) !== null) {
+                hits.push(i + 1);
+                if (m[0].length === 0)
+                    pat.re.lastIndex++; // safety for zero-width
+            }
+        }
+    }
+    return { count: hits.length, lines: [...new Set(hits)].sort((a, b) => a - b) };
+}
+/**
+ * Scan one file's content for the always-available metrics:
+ * LOC/file, per-function cyclomatic + cognitive complexity, any-types.
+ * Halstead/CRAP/coverage/mutation/duplication/dead-code need external data
+ * and are merged later by report.ts.
+ */
+export function scanContent(file, content, config) {
+    const lang = languageForFile(file);
+    if (!lang)
+        return [];
+    const t = config.thresholds;
+    const out = [];
+    const { functions, loc } = analyzeComplexity(content, lang);
+    if (loc > t.maxLocPerFile) {
+        out.push({
+            file,
+            metric: 'locPerFile',
+            value: loc,
+            threshold: t.maxLocPerFile,
+            signature: `${file}::locPerFile::<file>`,
+            message: `${file}: ${loc} LOC exceeds max ${t.maxLocPerFile}`,
+        });
+    }
+    for (const fn of functions) {
+        if (fn.cyclomatic > t.maxCyclomatic) {
+            out.push({
+                file,
+                metric: 'cyclomatic',
+                value: fn.cyclomatic,
+                threshold: t.maxCyclomatic,
+                signature: `${file}::cyclomatic::${fn.name}@${fn.line}`,
+                message: `${file}:${fn.line} ${fn.name}() cyclomatic ${fn.cyclomatic} exceeds max ${t.maxCyclomatic}`,
+            });
+        }
+        if (fn.cognitive > t.maxCognitive) {
+            out.push({
+                file,
+                metric: 'cognitive',
+                value: fn.cognitive,
+                threshold: t.maxCognitive,
+                signature: `${file}::cognitive::${fn.name}@${fn.line}`,
+                message: `${file}:${fn.line} ${fn.name}() cognitive ${fn.cognitive} exceeds max ${t.maxCognitive}`,
+            });
+        }
+    }
+    const anyResult = countAnyTypes(content, file);
+    if (anyResult.count > t.maxAnyTypes) {
+        out.push({
+            file,
+            metric: 'anyTypes',
+            value: anyResult.count,
+            threshold: t.maxAnyTypes,
+            signature: `${file}::anyTypes::<file>`,
+            message: `${file}: ${anyResult.count} explicit any/unknown usage(s) (lines ${anyResult.lines.slice(0, 8).join(',')}) exceed max ${t.maxAnyTypes}`,
+        });
+    }
+    return out;
+}
+/** True when `file` is a scannable source path under the config's rules. */
+export function isScannableSource(file, config) {
+    const norm = file.replace(/\\/g, '/');
+    const ext = extname(norm).toLowerCase();
+    if (!config.sourceExts.includes(ext))
+        return false;
+    for (const dir of config.excludeDirs) {
+        if (norm.includes(`/${dir}/`) || norm.startsWith(`${dir}/`))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/quality/scanner.js.map

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

package/dist/quality/tools.d.ts

@@ -0,0 +1,28 @@
+import { Violation } from './scanner.js';
+import { QualityConfig } from './config.js';
+export declare function toolAvailable(name: string): boolean;
+export interface ToolStatus {
+    name: string;
+    available: boolean;
+    provides: string[];
+}
+/** Probe every optional tool the gate can use. */
+export declare function probeTools(): ToolStatus[];
+/**
+ * Run lizard over the given files; returns cyclomatic violations using
+ * lizard's authoritative CC numbers. Null when lizard is absent.
+ */
+export declare function lizardViolations(files: string[], root: string, config: QualityConfig): Violation[] | null;
+/**
+ * Run rust-code-analysis over the given files; returns cognitive-complexity
+ * and Halstead-difficulty violations. Null when the tool is absent.
+ */
+export declare function rcaViolations(files: string[], root: string, config: QualityConfig): Violation[] | null;
+/**
+ * Run jscpd duplication detection. Returns one violation per clone pair over
+ * the threshold count. Null when jscpd is absent or the run produced no fresh
+ * report (a failed/timed-out run must never re-read a STALE report and block
+ * on clones that no longer exist).
+ */
+export declare function jscpdViolations(root: string, config: QualityConfig): Violation[] | null;
+//# sourceMappingURL=tools.d.ts.map

package/dist/quality/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/quality/tools.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAE/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kDAAkD;AAClD,wBAAgB,UAAU,IAAI,UAAU,EAAE,CASzC;AAuDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,GACpB,SAAS,EAAE,GAAG,IAAI,CAepB;AA8DD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,GACpB,SAAS,EAAE,GAAG,IAAI,CAgBpB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,EAAE,GAAG,IAAI,CAoCvF"}