@shrkcrft/inspector 0.1.0-alpha.1

package/dist/languages/language-runner.d.ts

@@ -0,0 +1,90 @@
+import { LanguageId } from './language-id.js';
+import { type ILanguageCommandReport } from './command-inference.js';
+import type { ILanguageProfileReport } from './language-detection.js';
+export declare const LANGUAGE_RUN_PLAN_SCHEMA = "sharkcraft.language-run-plan/v1";
+export type LanguageRunCategory = 'test' | 'build' | 'lint' | 'format' | 'check' | 'typecheck' | 'package' | 'run' | 'install' | 'restore' | 'all';
+export interface ILanguageRunStep {
+    language: LanguageId;
+    category: LanguageRunCategory;
+    command: string;
+    /** True when the command is install/restore — gated behind --allow-install. */
+    installLike: boolean;
+    /** Skipped reason, e.g. "no test command for python (no pytest)". */
+    skipped?: string;
+}
+export interface ILanguageRunResult {
+    step: ILanguageRunStep;
+    ranAt: string;
+    durationMs: number;
+    exitCode: number;
+    stdoutTail: string;
+    stderrTail: string;
+}
+export interface ILanguageRunPlan {
+    schema: typeof LANGUAGE_RUN_PLAN_SCHEMA;
+    generatedAt: string;
+    projectRoot: string;
+    dryRun: boolean;
+    allowInstall: boolean;
+    selectedCommandId?: string;
+    selectedCategory?: LanguageRunCategory;
+    steps: readonly ILanguageRunStep[];
+    refusedSteps: readonly {
+        command: string;
+        reason: string;
+    }[];
+    results?: readonly ILanguageRunResult[];
+    notes: readonly string[];
+}
+export interface IBuildLanguageRunPlanOptions {
+    projectRoot: string;
+    /** Reuse a cached profile report. */
+    cached?: ILanguageProfileReport;
+    /** Reuse a pre-computed command report (avoids double detection). */
+    commandReport?: ILanguageCommandReport;
+    /** One specific category to run; default `test`. */
+    category?: LanguageRunCategory;
+    /** Run every available category (per language). */
+    allTests?: boolean;
+    /** Restrict to a single language. */
+    language?: LanguageId;
+    /** Specific command id like `java.test` to disambiguate from category. */
+    commandId?: string;
+    /** When true, execute the commands instead of returning a plan only. */
+    execute?: boolean;
+    /** Required to run install/restore commands. */
+    allowInstall?: boolean;
+    /** Override the execution timeout per command, ms. Default 600000. */
+    timeoutMs?: number;
+}
+export interface ILanguageRunnerAllowlistEntry {
+    id?: string;
+    command: string;
+    reason?: string;
+}
+export interface ILanguageRunnerDenylistEntry {
+    pattern: string;
+    reason?: string;
+}
+export interface ILanguageRunnerPolicy {
+    schema: 'sharkcraft.language-runner-policy/v1';
+    source: 'config' | 'builtin';
+    allow: ReadonlyArray<ILanguageRunnerAllowlistEntry>;
+    deny: ReadonlyArray<ILanguageRunnerDenylistEntry>;
+    builtinDeny: ReadonlyArray<string>;
+}
+export declare function getLanguageRunnerPolicy(projectRoot: string): ILanguageRunnerPolicy;
+export interface ILanguageRunnerDecision {
+    allowed: boolean;
+    source: 'builtin-deny' | 'config-deny' | 'config-allow' | 'no-rule';
+    rule: string;
+    reason?: string;
+}
+export declare function explainCommandPolicy(command: string, projectRoot: string): ILanguageRunnerDecision;
+export declare function buildLanguageRunPlan(options: IBuildLanguageRunPlanOptions): ILanguageRunPlan;
+export declare function renderLanguageRunPlanText(plan: ILanguageRunPlan): string;
+export declare function renderLanguageRunPlanMarkdown(plan: ILanguageRunPlan): string;
+export declare function renderLanguageRunPlanJson(plan: ILanguageRunPlan): string;
+/** Quick helper: produce the report path that --report would land at. */
+export declare function defaultLanguageRunReportPath(projectRoot: string, generatedAt: string): string;
+//# sourceMappingURL=language-runner.d.ts.map

package/dist/languages/language-runner.d.ts.map

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

package/dist/languages/language-runner.js

@@ -0,0 +1,346 @@
+/**
+ * Safe language command runner.
+ *
+ * Produces a `ILanguageRunPlan` describing the per-language commands the user
+ * is about to run, then (optionally, with `--execute`) shells them out. The
+ * MCP surface is plan-only — execution is CLI-only and never auto-runs
+ * install/publish/deploy.
+ *
+ * Hard rules:
+ *  - dry-run is the default; execution requires explicit `--execute`.
+ *  - install / restore commands require `--allow-install`.
+ *  - publish / deploy / push / release / clean -A / sudo / curl|bash are
+ *    refused outright, even when the install allowlist is set.
+ *  - the runner never resolves arbitrary user-provided commands; it only
+ *    selects commands from `buildLanguageCommandReport`.
+ */
+import * as nodePath from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { buildLanguageCommandReport } from "./command-inference.js";
+export const LANGUAGE_RUN_PLAN_SCHEMA = 'sharkcraft.language-run-plan/v1';
+const REFUSED_PATTERNS = [
+    /\bpublish\b/i,
+    /\bdeploy\b/i,
+    /\brelease\b/i,
+    /\bpush\b/i,
+    /\brm\s+-rf\s+\//, // `rm -rf /...`
+    /\bsudo\b/i,
+    /\bcurl[^|]*\|\s*bash/i,
+    /\bwget[^|]*\|\s*sh/i,
+    /\bnpm\s+publish\b/i,
+    /\bbun\s+publish\b/i,
+    /\bpnpm\s+publish\b/i,
+    /\byarn\s+publish\b/i,
+    /\bgit\s+push\s+--?\w*\bforce\b/i,
+];
+function loadAllowlistConfig(projectRoot) {
+    const file = nodePath.join(projectRoot, 'sharkcraft', 'runner.allowlist.json');
+    if (!existsSync(file))
+        return { allow: [], deny: [] };
+    try {
+        const raw = JSON.parse(readFileSync(file, 'utf8'));
+        return {
+            allow: Array.isArray(raw.allow) ? raw.allow : [],
+            deny: Array.isArray(raw.deny) ? raw.deny : [],
+        };
+    }
+    catch {
+        return { allow: [], deny: [] };
+    }
+}
+export function getLanguageRunnerPolicy(projectRoot) {
+    const { allow, deny } = loadAllowlistConfig(projectRoot);
+    return {
+        schema: 'sharkcraft.language-runner-policy/v1',
+        source: allow.length + deny.length > 0 ? 'config' : 'builtin',
+        allow,
+        deny,
+        builtinDeny: REFUSED_PATTERNS.map((re) => re.source),
+    };
+}
+export function explainCommandPolicy(command, projectRoot) {
+    // 1) Built-in deny always wins.
+    for (const re of REFUSED_PATTERNS) {
+        if (re.test(command)) {
+            return {
+                allowed: false,
+                source: 'builtin-deny',
+                rule: re.source,
+                reason: 'built-in dangerous pattern',
+            };
+        }
+    }
+    const { allow, deny } = loadAllowlistConfig(projectRoot);
+    // 2) Config deny.
+    for (const d of deny) {
+        try {
+            const re = new RegExp(d.pattern, 'i');
+            if (re.test(command)) {
+                return {
+                    allowed: false,
+                    source: 'config-deny',
+                    rule: d.pattern,
+                    ...(d.reason ? { reason: d.reason } : {}),
+                };
+            }
+        }
+        catch {
+            /* skip invalid regex */
+        }
+    }
+    // 3) Config allow.
+    for (const a of allow) {
+        if (a.command === command) {
+            return {
+                allowed: true,
+                source: 'config-allow',
+                rule: a.id ?? a.command,
+                ...(a.reason ? { reason: a.reason } : {}),
+            };
+        }
+    }
+    return { allowed: true, source: 'no-rule', rule: '(no matching rule)' };
+}
+function isRefused(command, projectRoot) {
+    // Built-in deny first.
+    for (const re of REFUSED_PATTERNS) {
+        if (re.test(command))
+            return `command matches refused pattern ${re.source}`;
+    }
+    // Config deny.
+    if (projectRoot) {
+        const { deny } = loadAllowlistConfig(projectRoot);
+        for (const d of deny) {
+            try {
+                const re = new RegExp(d.pattern, 'i');
+                if (re.test(command))
+                    return `command matches config deny pattern ${d.pattern}${d.reason ? ` (${d.reason})` : ''}`;
+            }
+            catch {
+                /* skip */
+            }
+        }
+    }
+    return null;
+}
+function isInstallLike(command) {
+    return /\b(install|restore|fetch|sync|mod\s+download|cargo\s+fetch|dotnet\s+restore|poetry\s+install|uv\s+sync|bun\s+install|pnpm\s+install|npm\s+ci|npm\s+install|yarn\s+install)\b/i.test(command);
+}
+function commandFromSet(set, category) {
+    switch (category) {
+        case 'install': return set.install;
+        case 'restore': return set.restore ?? set.install;
+        case 'typecheck': return set.typecheck;
+        case 'test': return set.test;
+        case 'lint': return set.lint;
+        case 'format': return set.format;
+        case 'build': return set.build;
+        case 'package': return set.package;
+        case 'run': return set.run;
+        case 'check': return set.typecheck ?? set.lint ?? set.test;
+        case 'all': return undefined;
+        default: return undefined;
+    }
+}
+function allCategoriesFor(set) {
+    const out = [];
+    if (set.typecheck)
+        out.push('typecheck');
+    if (set.lint)
+        out.push('lint');
+    if (set.test)
+        out.push('test');
+    if (set.build)
+        out.push('build');
+    return out;
+}
+export function buildLanguageRunPlan(options) {
+    const projectRoot = options.projectRoot;
+    const commandReport = options.commandReport ?? buildLanguageCommandReport(projectRoot, options.cached);
+    const category = options.category ?? 'test';
+    const wantLanguage = options.language;
+    const commandId = options.commandId;
+    const allTests = !!options.allTests;
+    const steps = [];
+    const refusedSteps = [];
+    for (const set of commandReport.profiles) {
+        if (wantLanguage && set.language !== wantLanguage)
+            continue;
+        if (commandId) {
+            // Convention: <language>.<category>
+            const [lang, cat] = commandId.split('.');
+            if (!lang || !cat)
+                continue;
+            if (lang !== set.language)
+                continue;
+            const cmd = commandFromSet(set, cat);
+            if (cmd) {
+                const refusedReason = isRefused(cmd, projectRoot);
+                if (refusedReason) {
+                    refusedSteps.push({ command: cmd, reason: refusedReason });
+                    continue;
+                }
+                steps.push({ language: set.language, category: cat, command: cmd, installLike: isInstallLike(cmd) });
+            }
+            continue;
+        }
+        const categories = allTests ? ['test'] : (category === 'all' ? allCategoriesFor(set) : [category]);
+        for (const cat of categories) {
+            const cmd = commandFromSet(set, cat);
+            if (!cmd)
+                continue;
+            const refusedReason = isRefused(cmd, projectRoot);
+            if (refusedReason) {
+                refusedSteps.push({ command: cmd, reason: refusedReason });
+                continue;
+            }
+            const installLike = isInstallLike(cmd);
+            const step = { language: set.language, category: cat, command: cmd, installLike };
+            if (installLike && !options.allowInstall) {
+                step.skipped = 'install/restore commands require --allow-install';
+            }
+            steps.push(step);
+        }
+    }
+    const notes = [];
+    if (refusedSteps.length > 0)
+        notes.push(`Refused ${refusedSteps.length} potentially-destructive command(s).`);
+    if (steps.length === 0)
+        notes.push('No matching language commands found.');
+    if (!options.execute)
+        notes.push('Dry-run: no commands were executed. Pass --execute to run.');
+    const dryRun = !options.execute;
+    const allowInstall = !!options.allowInstall;
+    const plan = {
+        schema: LANGUAGE_RUN_PLAN_SCHEMA,
+        generatedAt: new Date().toISOString(),
+        projectRoot,
+        dryRun,
+        allowInstall,
+        ...(commandId ? { selectedCommandId: commandId } : {}),
+        ...(category && !commandId ? { selectedCategory: category } : {}),
+        steps,
+        refusedSteps,
+        notes,
+    };
+    if (!options.execute)
+        return plan;
+    const timeoutMs = options.timeoutMs ?? 600_000;
+    const results = [];
+    for (const step of steps) {
+        if (step.skipped)
+            continue;
+        const ranAt = new Date().toISOString();
+        const start = Date.now();
+        const proc = spawnSync(step.command, [], {
+            cwd: projectRoot,
+            shell: true,
+            timeout: timeoutMs,
+            encoding: 'utf8',
+            env: process.env,
+        });
+        const durationMs = Date.now() - start;
+        const stdoutTail = trimTail(proc.stdout ?? '');
+        const stderrTail = trimTail(proc.stderr ?? '');
+        results.push({
+            step,
+            ranAt,
+            durationMs,
+            exitCode: typeof proc.status === 'number' ? proc.status : (proc.signal ? 128 : -1),
+            stdoutTail,
+            stderrTail,
+        });
+    }
+    return { ...plan, dryRun: false, results };
+}
+function trimTail(s) {
+    if (s.length <= 4096)
+        return s;
+    return '… (truncated) …\n' + s.slice(s.length - 4096);
+}
+export function renderLanguageRunPlanText(plan) {
+    let out = `=== Language run plan ===\n`;
+    out += `  project root  ${plan.projectRoot}\n`;
+    out += `  dry-run       ${plan.dryRun ? 'yes' : 'no'}\n`;
+    out += `  steps         ${plan.steps.length}\n`;
+    if (plan.steps.length === 0) {
+        out += `  (no commands selected)\n`;
+    }
+    else {
+        out += `\nSteps:\n`;
+        for (const s of plan.steps) {
+            const tag = s.skipped ? `[SKIPPED ${s.skipped}]` : '[OK]';
+            out += `  ${tag} ${s.language}.${s.category}  →  ${s.command}\n`;
+        }
+    }
+    if (plan.refusedSteps.length > 0) {
+        out += `\nRefused:\n`;
+        for (const r of plan.refusedSteps)
+            out += `  - ${r.command}  (${r.reason})\n`;
+    }
+    if (plan.results) {
+        out += `\nResults:\n`;
+        for (const r of plan.results) {
+            const status = r.exitCode === 0 ? 'PASS' : 'FAIL';
+            out += `  [${status}] ${r.step.language}.${r.step.category} (${r.durationMs}ms)\n`;
+            if (r.stderrTail)
+                out += `    stderr: ${r.stderrTail.split('\n').slice(-3).join(' / ')}\n`;
+        }
+    }
+    if (plan.notes.length > 0) {
+        out += `\nNotes:\n`;
+        for (const n of plan.notes)
+            out += `  - ${n}\n`;
+    }
+    // Always include the next-command hint (for MCP read-only callers).
+    out += `\nnext-command: shrk languages run --execute  # CLI-only`;
+    return out + '\n';
+}
+export function renderLanguageRunPlanMarkdown(plan) {
+    const lines = [];
+    lines.push('# Language run plan');
+    lines.push('');
+    lines.push(`- Project root: \`${plan.projectRoot}\``);
+    lines.push(`- Dry-run: **${plan.dryRun ? 'yes' : 'no'}**`);
+    lines.push(`- Steps: **${plan.steps.length}**`);
+    if (plan.steps.length > 0) {
+        lines.push('');
+        lines.push('| Language | Category | Command | Status |');
+        lines.push('|---|---|---|---|');
+        for (const s of plan.steps) {
+            lines.push(`| \`${s.language}\` | \`${s.category}\` | \`${s.command}\` | ${s.skipped ? 'skipped: ' + s.skipped : 'planned'} |`);
+        }
+    }
+    if (plan.refusedSteps.length > 0) {
+        lines.push('');
+        lines.push('## Refused');
+        lines.push('');
+        for (const r of plan.refusedSteps)
+            lines.push(`- \`${r.command}\` — ${r.reason}`);
+    }
+    if (plan.results) {
+        lines.push('');
+        lines.push('## Results');
+        lines.push('');
+        for (const r of plan.results) {
+            lines.push(`- ${r.exitCode === 0 ? '✅' : '❌'} \`${r.step.command}\` — exit=${r.exitCode}, ${r.durationMs}ms`);
+        }
+    }
+    if (plan.notes.length > 0) {
+        lines.push('');
+        lines.push('## Notes');
+        lines.push('');
+        for (const n of plan.notes)
+            lines.push(`- ${n}`);
+    }
+    return lines.join('\n');
+}
+export function renderLanguageRunPlanJson(plan) {
+    return JSON.stringify(plan, null, 2);
+}
+/** Quick helper: produce the report path that --report would land at. */
+export function defaultLanguageRunReportPath(projectRoot, generatedAt) {
+    const stamp = generatedAt.replace(/[:.]/g, '-');
+    return nodePath.join(projectRoot, '.sharkcraft', 'reports', `language-run-${stamp}.json`);
+}

package/dist/languages/polyglot-boundary.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Polyglot boundary enforcement.
+ *
+ * Evaluates built-in per-language boundary rules against the polyglot
+ * dependency scan and reports violations + suggested fixes. Pure
+ * file/regex-driven, no compiler integration.
+ *
+ * The existing TypeScript boundary engine is unchanged. This report is a
+ * cross-cutting view used by `shrk boundaries enforce --language ...`,
+ * `shrk check boundaries --polyglot`, and `get_polyglot_boundary_report`.
+ */
+import { LanguageId } from './language-id.js';
+import { type ILanguageProfileReport } from './language-detection.js';
+import { type IPolyglotDependencyGraph, type IPolyglotImportEdge } from './dependency-scan.js';
+export declare const POLYGLOT_BOUNDARY_REPORT_SCHEMA = "sharkcraft.polyglot-boundary-report/v1";
+export type PolyglotBoundarySeverity = 'error' | 'warning';
+export interface IPolyglotBoundaryRule {
+    id: string;
+    title: string;
+    language: LanguageId;
+    severity: PolyglotBoundarySeverity;
+    /** Anchored regex that matches a project-relative `from` file path. */
+    fromPattern: RegExp;
+    /** Regex that matches a forbidden import target (namespace / module / package). */
+    forbiddenTargetPattern: RegExp;
+    /** Optional `to` file-path pattern when both ends live in the repo (internal edges). */
+    toPattern?: RegExp;
+    /** Short rationale used by reports and contract enforcement. */
+    reason: string;
+    /** Suggested fix (one-line). */
+    suggestedFix: string;
+}
+export interface IPolyglotBoundaryViolation {
+    ruleId: string;
+    language: LanguageId;
+    severity: PolyglotBoundarySeverity;
+    fromFile: string;
+    importSpecifier: string;
+    toFile?: string;
+    reason: string;
+    suggestedFix: string;
+    /** confidence based on the underlying dep scan + match strength. */
+    confidence: 'high' | 'medium' | 'low';
+}
+export interface IPolyglotBoundaryReport {
+    schema: typeof POLYGLOT_BOUNDARY_REPORT_SCHEMA;
+    generatedAt: string;
+    projectRoot: string;
+    /** Languages actually evaluated (filtered by --language). */
+    languages: readonly LanguageId[];
+    rules: readonly IPolyglotBoundaryRule[];
+    edges: readonly IPolyglotImportEdge[];
+    violations: readonly IPolyglotBoundaryViolation[];
+    counts: {
+        rules: number;
+        edges: number;
+        violations: number;
+        errors: number;
+        warnings: number;
+    };
+    limitations: readonly string[];
+    suggestedFixes: readonly string[];
+}
+export interface IBuildPolyglotBoundaryReportOptions {
+    projectRoot: string;
+    /** Restrict evaluation to these languages; default: all detected polyglot languages. */
+    languages?: readonly LanguageId[];
+    /** Reuse a cached profile report. */
+    cached?: ILanguageProfileReport;
+    /** Optional pre-computed dependency graph. */
+    graph?: IPolyglotDependencyGraph;
+    /** Cap total violations rendered. Default 200. */
+    limit?: number;
+}
+export declare function listPolyglotBoundaryRules(language?: LanguageId): readonly IPolyglotBoundaryRule[];
+export declare function buildPolyglotBoundaryReport(options: IBuildPolyglotBoundaryReportOptions): IPolyglotBoundaryReport;
+export declare function renderPolyglotBoundaryReportText(r: IPolyglotBoundaryReport): string;
+export declare function renderPolyglotBoundaryReportMarkdown(r: IPolyglotBoundaryReport): string;
+export declare function renderPolyglotBoundaryReportJson(r: IPolyglotBoundaryReport): string;
+//# sourceMappingURL=polyglot-boundary.d.ts.map

package/dist/languages/polyglot-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyglot-boundary.d.ts","sourceRoot":"","sources":["../../src/languages/polyglot-boundary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAA4B,KAAK,wBAAwB,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEzH,eAAO,MAAM,+BAA+B,2CAA2C,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,+BAA+B,CAAC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;IACjC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtC,UAAU,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAClD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mCAAmC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,SAAS,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAClC,qCAAqC;IACrC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyLD,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,qBAAqB,EAAE,CASjG;AAqBD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mCAAmC,GAC3C,uBAAuB,CA4EzB;AAED,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAsBnF;AAED,wBAAgB,oCAAoC,CAAC,CAAC,EAAE,uBAAuB,GAAG,MAAM,CA+BvF;AAED,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAcnF"}