@kevinrabun/judges 3.38.0 → 3.40.0

package/dist/commands/override.js

@@ -0,0 +1,264 @@
+/**
+ * `judges override` — Structured exception/override workflow for gating.
+ *
+ * When the PR gate blocks a merge, developers can log a justified override
+ * rather than disabling the entire check. Overrides are tracked in an
+ * auditable log (.judges-overrides.json) with required justification.
+ *
+ * Usage:
+ *   judges override add --rule SEC-001 --reason "Mitigated by WAF" --approver "jane@co.com"
+ *   judges override list                       # Show active overrides
+ *   judges override revoke --rule SEC-001      # Revoke an override
+ *   judges override check --file src/app.ts    # Check if findings have applicable overrides
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { resolve, dirname } from "path";
+// ─── Store I/O ──────────────────────────────────────────────────────────────
+const OVERRIDE_FILE = ".judges-overrides.json";
+function createEmptyStore() {
+    const now = new Date().toISOString();
+    return { version: 1, overrides: [], metadata: { createdAt: now, lastUpdated: now } };
+}
+export function loadOverrideStore(dir = ".") {
+    const filePath = resolve(dir, OVERRIDE_FILE);
+    if (!existsSync(filePath))
+        return createEmptyStore();
+    try {
+        const raw = JSON.parse(readFileSync(filePath, "utf-8"));
+        if (raw.version === 1 && Array.isArray(raw.overrides))
+            return raw;
+        return createEmptyStore();
+    }
+    catch {
+        return createEmptyStore();
+    }
+}
+export function saveOverrideStore(store, dir = ".") {
+    const filePath = resolve(dir, OVERRIDE_FILE);
+    const d = dirname(filePath);
+    if (!existsSync(d))
+        mkdirSync(d, { recursive: true });
+    store.metadata.lastUpdated = new Date().toISOString();
+    writeFileSync(filePath, JSON.stringify(store, null, 2) + "\n", "utf-8");
+}
+// ─── Override Logic ─────────────────────────────────────────────────────────
+/**
+ * Check if a finding's rule ID matches an active, non-expired override.
+ */
+export function isOverridden(ruleId, filePath, store) {
+    const now = new Date().toISOString();
+    for (const o of store.overrides) {
+        if (!o.active)
+            continue;
+        if (o.expiresAt && o.expiresAt < now)
+            continue;
+        // Match exact rule ID or wildcard prefix (e.g. "SEC-*")
+        const matches = o.ruleId === ruleId || (o.ruleId.endsWith("-*") && ruleId.startsWith(o.ruleId.slice(0, -1)));
+        if (!matches)
+            continue;
+        // If file scope is specified, check it
+        if (o.filePaths && o.filePaths.length > 0 && filePath) {
+            const fileMatches = o.filePaths.some((pattern) => {
+                if (pattern.includes("*")) {
+                    const re = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+                    return re.test(filePath);
+                }
+                return filePath.includes(pattern);
+            });
+            if (!fileMatches)
+                continue;
+        }
+        return o;
+    }
+    return undefined;
+}
+/**
+ * Apply overrides to a list of findings — returns findings with overridden
+ * ones removed, plus the list of overridden findings for audit.
+ */
+export function applyOverrides(findings, store, filePath) {
+    const active = [];
+    const overridden = [];
+    for (const f of findings) {
+        const match = isOverridden(f.ruleId, filePath, store);
+        if (match) {
+            overridden.push({ finding: f, override: match });
+        }
+        else {
+            active.push(f);
+        }
+    }
+    return { active, overridden };
+}
+// ─── CLI Command ────────────────────────────────────────────────────────────
+export function runOverride(argv) {
+    const subcommand = argv[3] || "list";
+    const store = loadOverrideStore();
+    switch (subcommand) {
+        case "add": {
+            let ruleId = "";
+            let reason = "";
+            let approver = "";
+            let expiresAt = "";
+            const filePaths = [];
+            for (let i = 4; i < argv.length; i++) {
+                switch (argv[i]) {
+                    case "--rule":
+                    case "-r":
+                        ruleId = argv[++i] || "";
+                        break;
+                    case "--reason":
+                        reason = argv[++i] || "";
+                        break;
+                    case "--approver":
+                        approver = argv[++i] || "";
+                        break;
+                    case "--expires":
+                        expiresAt = argv[++i] || "";
+                        break;
+                    case "--file":
+                    case "-f":
+                        filePaths.push(argv[++i] || "");
+                        break;
+                }
+            }
+            if (!ruleId) {
+                console.error('Error: --rule is required. Example: judges override add --rule SEC-001 --reason "Mitigated by WAF"');
+                process.exit(1);
+            }
+            if (!reason) {
+                console.error("Error: --reason is required. Overrides must have a justification.");
+                process.exit(1);
+            }
+            const override = {
+                ruleId,
+                reason,
+                approver: approver || undefined,
+                filePaths: filePaths.length > 0 ? filePaths : undefined,
+                createdAt: new Date().toISOString(),
+                expiresAt: expiresAt || undefined,
+                active: true,
+            };
+            store.overrides.push(override);
+            saveOverrideStore(store);
+            console.log("");
+            console.log("  ✅ Override added:");
+            console.log(`     Rule     : ${ruleId}`);
+            console.log(`     Reason   : ${reason}`);
+            if (approver)
+                console.log(`     Approver : ${approver}`);
+            if (expiresAt)
+                console.log(`     Expires  : ${expiresAt}`);
+            if (filePaths.length > 0)
+                console.log(`     Scope    : ${filePaths.join(", ")}`);
+            console.log("");
+            break;
+        }
+        case "list": {
+            const now = new Date().toISOString();
+            const active = store.overrides.filter((o) => o.active && (!o.expiresAt || o.expiresAt >= now));
+            const expired = store.overrides.filter((o) => o.active && o.expiresAt && o.expiresAt < now);
+            const revoked = store.overrides.filter((o) => !o.active);
+            console.log("");
+            console.log("╔══════════════════════════════════════════════════════════════╗");
+            console.log("║           Judges Panel — Override Registry                  ║");
+            console.log("╚══════════════════════════════════════════════════════════════╝");
+            console.log("");
+            if (active.length === 0 && expired.length === 0 && revoked.length === 0) {
+                console.log("  No overrides registered.\n");
+                break;
+            }
+            if (active.length > 0) {
+                console.log(`  Active Overrides (${active.length}):`);
+                console.log("  " + "─".repeat(58));
+                for (const o of active) {
+                    console.log(`  ${o.ruleId.padEnd(14)} ${o.reason.slice(0, 50)}`);
+                    if (o.approver)
+                        console.log(`${"".padEnd(16)} Approver: ${o.approver}`);
+                    if (o.expiresAt)
+                        console.log(`${"".padEnd(16)} Expires: ${o.expiresAt}`);
+                }
+                console.log("");
+            }
+            if (expired.length > 0) {
+                console.log(`  Expired Overrides (${expired.length}):`);
+                for (const o of expired) {
+                    console.log(`  ${o.ruleId.padEnd(14)} expired ${o.expiresAt}`);
+                }
+                console.log("");
+            }
+            if (revoked.length > 0) {
+                console.log(`  Revoked Overrides (${revoked.length}):`);
+                for (const o of revoked) {
+                    console.log(`  ${o.ruleId.padEnd(14)} revoked ${o.revokedAt || "unknown"}`);
+                }
+                console.log("");
+            }
+            break;
+        }
+        case "revoke": {
+            let ruleId = "";
+            let revokedBy = "";
+            for (let i = 4; i < argv.length; i++) {
+                switch (argv[i]) {
+                    case "--rule":
+                    case "-r":
+                        ruleId = argv[++i] || "";
+                        break;
+                    case "--by":
+                        revokedBy = argv[++i] || "";
+                        break;
+                }
+            }
+            if (!ruleId) {
+                console.error("Error: --rule is required. Example: judges override revoke --rule SEC-001");
+                process.exit(1);
+            }
+            let revoked = 0;
+            for (const o of store.overrides) {
+                if (o.ruleId === ruleId && o.active) {
+                    o.active = false;
+                    o.revokedAt = new Date().toISOString();
+                    o.revokedBy = revokedBy || undefined;
+                    revoked++;
+                }
+            }
+            if (revoked > 0) {
+                saveOverrideStore(store);
+                console.log(`  ✅ Revoked ${revoked} override(s) for ${ruleId}\n`);
+            }
+            else {
+                console.log(`  No active overrides found for ${ruleId}\n`);
+            }
+            break;
+        }
+        case "check": {
+            let filePath = "";
+            for (let i = 4; i < argv.length; i++) {
+                if (argv[i] === "--file" || argv[i] === "-f")
+                    filePath = argv[++i] || "";
+                else if (!argv[i].startsWith("-"))
+                    filePath = argv[i];
+            }
+            const now = new Date().toISOString();
+            const active = store.overrides.filter((o) => o.active && (!o.expiresAt || o.expiresAt >= now));
+            if (active.length === 0) {
+                console.log("  No active overrides.\n");
+                break;
+            }
+            console.log(`\n  Active overrides${filePath ? ` for ${filePath}` : ""}:`);
+            for (const o of active) {
+                const scopeMatch = !o.filePaths || o.filePaths.length === 0 || !filePath || o.filePaths.some((p) => filePath.includes(p));
+                const status = scopeMatch ? "✅ applies" : "⬜ out of scope";
+                console.log(`  ${o.ruleId.padEnd(14)} ${status} — ${o.reason.slice(0, 50)}`);
+            }
+            console.log("");
+            break;
+        }
+        default:
+            console.error(`Unknown override subcommand: ${subcommand}`);
+            console.error("Usage: judges override <add|list|revoke|check>");
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=override.js.map

package/dist/commands/override.js.map

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

package/dist/commands/parity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `judges parity` — Language pattern parity audit.
+ *
+ * Audits the language-pattern library to identify gaps where a pattern
+ * concept exists for some languages but not others, helping maintainers
+ * prioritise pattern-writing effort.
+ *
+ * Usage:
+ *   judges parity                          # text table
+ *   judges parity --json                   # JSON output
+ *   judges parity --lang python            # filter to one language
+ */
+import type { LangFamily } from "../types.js";
+export interface PatternEntry {
+    name: string;
+    languages: LangFamily[];
+    missingLanguages: LangFamily[];
+    coverage: number;
+}
+export interface ParityReport {
+    patterns: PatternEntry[];
+    languageCoverage: Record<string, {
+        covered: number;
+        total: number;
+        pct: number;
+    }>;
+    overallCoverage: number;
+}
+export declare function analyzePatternParity(filterLang?: LangFamily): ParityReport;
+export declare function runParity(argv: string[]): void;
+//# sourceMappingURL=parity.d.ts.map

package/dist/commands/parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity.d.ts","sourceRoot":"","sources":["../../src/commands/parity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,gBAAgB,EAAE,UAAU,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,eAAe,EAAE,MAAM,CAAC;CACzB;AAmGD,wBAAgB,oBAAoB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,YAAY,CAyD1E;AA2CD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAuB9C"}

package/dist/commands/parity.js

@@ -0,0 +1,213 @@
+/**
+ * `judges parity` — Language pattern parity audit.
+ *
+ * Audits the language-pattern library to identify gaps where a pattern
+ * concept exists for some languages but not others, helping maintainers
+ * prioritise pattern-writing effort.
+ *
+ * Usage:
+ *   judges parity                          # text table
+ *   judges parity --json                   # JSON output
+ *   judges parity --lang python            # filter to one language
+ */
+import * as LP from "../language-patterns.js";
+// ─── Core Languages (excluding IaC-only and "unknown") ─────────────────────
+const CORE_LANGUAGES = [
+    "javascript",
+    "typescript",
+    "python",
+    "rust",
+    "csharp",
+    "java",
+    "go",
+    "cpp",
+    "php",
+    "ruby",
+    "kotlin",
+    "swift",
+    "dart",
+    "bash",
+];
+const IAC_LANGUAGES = ["terraform", "bicep", "arm"];
+// ─── Pattern Catalogue ─────────────────────────────────────────────────────
+function getPatternCatalogue() {
+    const catalogue = [];
+    // Core language patterns
+    const corePatterns = [
+        ["ENV_ACCESS", LP.ENV_ACCESS],
+        ["HARDCODED_ENV", LP.HARDCODED_ENV],
+        ["FUNCTION_DEF", LP.FUNCTION_DEF],
+        ["TRY_CATCH", LP.TRY_CATCH],
+        ["EMPTY_CATCH", LP.EMPTY_CATCH],
+        ["GENERIC_CATCH", LP.GENERIC_CATCH],
+        ["PANIC_UNWRAP", LP.PANIC_UNWRAP],
+        ["WEAK_TYPE", LP.WEAK_TYPE],
+        ["ASYNC_FUNCTION", LP.ASYNC_FUNCTION],
+        ["MISSING_AWAIT", LP.MISSING_AWAIT],
+        ["SHARED_MUTABLE", LP.SHARED_MUTABLE],
+        ["WILDCARD_IMPORT", LP.WILDCARD_IMPORT],
+        ["DEPRECATED_IMPORT", LP.DEPRECATED_IMPORT],
+        ["SQL_INJECTION", LP.SQL_INJECTION],
+        ["COMMAND_INJECTION", LP.COMMAND_INJECTION],
+        ["HARDCODED_PASSWORD", LP.HARDCODED_PASSWORD],
+        ["HARDCODED_API_KEY", LP.HARDCODED_API_KEY],
+        ["HARDCODED_SECRET", LP.HARDCODED_SECRET],
+        ["WEAK_HASH", LP.WEAK_HASH],
+        ["EVAL_USAGE", LP.EVAL_USAGE],
+        ["TLS_DISABLED", LP.TLS_DISABLED],
+        ["CORS_WILDCARD", LP.CORS_WILDCARD],
+        ["HTTP_ROUTE", LP.HTTP_ROUTE],
+        ["CONSOLE_LOG", LP.CONSOLE_LOG],
+        ["STRUCTURED_LOG", LP.STRUCTURED_LOG],
+        ["TEST_FUNCTION", LP.TEST_FUNCTION],
+        ["ASSERTION", LP.ASSERTION],
+        ["DOC_COMMENT", LP.DOC_COMMENT],
+        ["FOR_LOOP", LP.FOR_LOOP],
+        ["CLASS_DEF", LP.CLASS_DEF],
+        ["INPUT_VALIDATION", LP.INPUT_VALIDATION],
+        ["MUTEX", LP.MUTEX],
+        ["DB_QUERY", LP.DB_QUERY],
+        ["HTTP_CLIENT", LP.HTTP_CLIENT],
+        ["MAGIC_NUMBER", LP.MAGIC_NUMBER],
+        ["TODO_FIXME", LP.TODO_FIXME],
+        ["LINTER_DISABLE", LP.LINTER_DISABLE],
+        ["UNSAFE_DESERIALIZATION", LP.UNSAFE_DESERIALIZATION],
+        ["RESOURCE_LEAK", LP.RESOURCE_LEAK],
+        ["DEPRECATED_API", LP.DEPRECATED_API],
+    ];
+    for (const [name, obj] of corePatterns) {
+        catalogue.push({ name, obj, isIaC: false });
+    }
+    // IaC patterns
+    const iacPatterns = [
+        ["IAC_RESOURCE_DEF", LP.IAC_RESOURCE_DEF],
+        ["IAC_HARDCODED_SECRET", LP.IAC_HARDCODED_SECRET],
+        ["IAC_MISSING_ENCRYPTION", LP.IAC_MISSING_ENCRYPTION],
+        ["IAC_PUBLIC_ACCESS", LP.IAC_PUBLIC_ACCESS],
+        ["IAC_OPEN_NETWORK", LP.IAC_OPEN_NETWORK],
+        ["IAC_OVERPERMISSIVE_IAM", LP.IAC_OVERPERMISSIVE_IAM],
+        ["IAC_MISSING_HTTPS", LP.IAC_MISSING_HTTPS],
+        ["IAC_MISSING_LOGGING", LP.IAC_MISSING_LOGGING],
+        ["IAC_MISSING_TAGS_CHECK", LP.IAC_MISSING_TAGS_CHECK],
+        ["IAC_HARDCODED_LOCATION", LP.IAC_HARDCODED_LOCATION],
+        ["IAC_INSECURE_DEFAULT", LP.IAC_INSECURE_DEFAULT],
+        ["IAC_MISSING_BACKUP", LP.IAC_MISSING_BACKUP],
+    ];
+    for (const [name, obj] of iacPatterns) {
+        catalogue.push({ name, obj, isIaC: true });
+    }
+    return catalogue;
+}
+// ─── Parity Analysis ───────────────────────────────────────────────────────
+export function analyzePatternParity(filterLang) {
+    const catalogue = getPatternCatalogue();
+    const patterns = [];
+    const langCounters = {};
+    for (const { name, obj, isIaC } of catalogue) {
+        const targetLangs = isIaC ? IAC_LANGUAGES : CORE_LANGUAGES;
+        const keys = Object.keys(obj);
+        // Resolve "jsts" shorthand to javascript + typescript
+        const covered = new Set();
+        for (const key of keys) {
+            if (key === "jsts") {
+                covered.add("javascript");
+                covered.add("typescript");
+            }
+            else {
+                covered.add(key);
+            }
+        }
+        const presentLangs = targetLangs.filter((l) => covered.has(l));
+        const missingLangs = targetLangs.filter((l) => !covered.has(l));
+        const coverage = presentLangs.length / targetLangs.length;
+        patterns.push({
+            name,
+            languages: presentLangs,
+            missingLanguages: missingLangs,
+            coverage,
+        });
+        for (const lang of targetLangs) {
+            if (!langCounters[lang])
+                langCounters[lang] = { covered: 0, total: 0 };
+            langCounters[lang].total++;
+            if (covered.has(lang))
+                langCounters[lang].covered++;
+        }
+    }
+    // Build per-language summaries
+    const languageCoverage = {};
+    for (const [lang, c] of Object.entries(langCounters)) {
+        if (filterLang && lang !== filterLang)
+            continue;
+        languageCoverage[lang] = {
+            covered: c.covered,
+            total: c.total,
+            pct: Math.round((c.covered / c.total) * 100),
+        };
+    }
+    const totalPairs = patterns.reduce((s, p) => s + p.languages.length, 0);
+    const maxPairs = patterns.reduce((s, p) => s + p.languages.length + p.missingLanguages.length, 0);
+    const overallCoverage = maxPairs > 0 ? Math.round((totalPairs / maxPairs) * 100) : 100;
+    // Sort: least coverage first
+    patterns.sort((a, b) => a.coverage - b.coverage);
+    return { patterns, languageCoverage, overallCoverage };
+}
+// ─── Formatters ─────────────────────────────────────────────────────────────
+function formatParityText(report) {
+    const lines = [];
+    lines.push("╔══════════════════════════════════════════════════════════════╗");
+    lines.push("║        Judges Panel — Language Parity Audit                 ║");
+    lines.push("╚══════════════════════════════════════════════════════════════╝");
+    lines.push("");
+    lines.push(`  Overall coverage: ${report.overallCoverage}%`);
+    lines.push("");
+    // Per-language coverage
+    lines.push("  Language Coverage:");
+    lines.push("  " + "─".repeat(50));
+    const langEntries = Object.entries(report.languageCoverage).sort((a, b) => a[1].pct - b[1].pct);
+    for (const [lang, c] of langEntries) {
+        const bar = "█".repeat(Math.round(c.pct / 5)) + "░".repeat(20 - Math.round(c.pct / 5));
+        lines.push(`  ${lang.padEnd(14)} ${bar} ${String(c.pct).padStart(3)}% (${c.covered}/${c.total})`);
+    }
+    // Gaps list (patterns with < 100% coverage)
+    const gaps = report.patterns.filter((p) => p.coverage < 1);
+    if (gaps.length > 0) {
+        lines.push("");
+        lines.push("  Patterns with missing language support:");
+        lines.push("  " + "─".repeat(50));
+        for (const g of gaps) {
+            const pct = Math.round(g.coverage * 100);
+            lines.push(`  ${g.name.padEnd(28)} ${String(pct).padStart(3)}%  missing: ${g.missingLanguages.join(", ")}`);
+        }
+    }
+    else {
+        lines.push("");
+        lines.push("  ✅ All patterns have full language coverage!");
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+// ─── CLI Command ────────────────────────────────────────────────────────────
+export function runParity(argv) {
+    let format = "text";
+    let filterLang;
+    for (let i = 3; i < argv.length; i++) {
+        switch (argv[i]) {
+            case "--json":
+                format = "json";
+                break;
+            case "--lang":
+            case "-l":
+                filterLang = (argv[++i] || "unknown");
+                break;
+        }
+    }
+    const report = analyzePatternParity(filterLang);
+    if (format === "json") {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        console.log(formatParityText(report));
+    }
+}
+//# sourceMappingURL=parity.js.map

package/dist/commands/parity.js.map

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

package/dist/commands/plugin-search.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `judges plugin search` — Plugin discovery from a curated registry.
+ *
+ * Uses a local JSON registry file (bundled with judges) to list available
+ * community and official plugins. No network calls — the registry is
+ * versioned alongside the codebase and updated when judges is updated.
+ *
+ * Usage:
+ *   judges plugin search                    List all plugins
+ *   judges plugin search security           Search by keyword
+ *   judges plugin search --category custom  Filter by category
+ */
+export interface PluginEntry {
+    /** Plugin npm package name or repo URL */
+    name: string;
+    /** Short description */
+    description: string;
+    /** Plugin version */
+    version: string;
+    /** Author or org */
+    author: string;
+    /** Category tags */
+    categories: string[];
+    /** Install command */
+    install: string;
+    /** Link to documentation or source */
+    url?: string;
+    /** Whether this is an official (first-party) plugin */
+    official?: boolean;
+}
+export interface PluginRegistry {
+    /** Registry format version */
+    version: string;
+    /** Last updated timestamp */
+    updatedAt: string;
+    /** Available plugins */
+    plugins: PluginEntry[];
+}
+export declare function runPluginSearch(argv: string[]): void;
+//# sourceMappingURL=plugin-search.d.ts.map

package/dist/commands/plugin-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-search.d.ts","sourceRoot":"","sources":["../../src/commands/plugin-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AA8ID,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAsDpD"}