@descent-vtt/spec-guard 0.4.0 → 0.5.0

package/dist/polyglot.js

@@ -0,0 +1,544 @@
+/**
+ * Module-reference extraction for Python, Go, Rust and C#.
+ *
+ * The JavaScript analyser in `imports.ts` is a full tokenizer because it has to
+ * be: a module reference can appear anywhere in an expression, `/` is division
+ * or a regular expression depending on context, and template literals nest
+ * arbitrarily. None of that is true here. In these four languages an import is
+ * a statement, its shape is fixed, and the only thing that can disguise one is
+ * a comment or a string literal.
+ *
+ * spec-guard already has something that finds comments and string literals in
+ * nine language families, and it is the most adversarially tested code in the
+ * project. So this module does not add four more tokenizers. It masks the
+ * source with the existing lexer and then reads statements off what is left:
+ *
+ *   source -> lexRanges (comments.ts) -> masked code -> per-language statement reader
+ *
+ * That is the whole architecture, and it is the reason four languages cost
+ * about as much as one.
+ *
+ * The alternative was Tree-sitter, and the reason it lost is size: its runtime
+ * plus grammars for these four languages measures 94 MB unpacked against this
+ * package's 0.33 MB. What that buys is real - a parser knows about
+ * conditional compilation and macro expansion, and this does not - so the
+ * places where it would be more accurate are listed in ADR-0008 rather than
+ * waved away. None of them is an import that this misreads; they are imports
+ * this cannot see, and every one of them is reported.
+ *
+ * Which is the invariant from ADR-0005, carried over unchanged: **a reference
+ * this module cannot resolve becomes a note, never silence**. A dependency
+ * rule that quietly ignores what it did not understand is a rule that passes
+ * for the wrong reason.
+ */
+import path from 'node:path';
+import { lexRanges, syntaxNamed } from './comments.js';
+import { lineStarts, locate, maskRanges } from './text.js';
+/** Extension to language. The single place a new language is switched on. */
+export const POLYGLOT_EXTENSIONS = new Map([
+    ['.py', 'python'],
+    ['.pyi', 'python'],
+    ['.go', 'go'],
+    ['.rs', 'rust'],
+    ['.cs', 'csharp'],
+    ['.csx', 'csharp'],
+]);
+/** The language for a path, or null when this module does not read it. */
+export function languageFor(filePath) {
+    return POLYGLOT_EXTENSIONS.get(path.extname(filePath).toLowerCase()) ?? null;
+}
+/**
+ * Largest number of module paths one statement may expand to.
+ *
+ * Rust's brace groups nest, and nesting multiplies: `use a::{b::{c,d}, e::{f,g}}`
+ * is four paths from twelve characters, and the growth is exponential in depth.
+ * A file that nests twenty levels deep is not a file anyone wrote, but it is a
+ * file somebody could commit, and the failure mode without a cap is an
+ * out-of-memory kill in CI rather than an error message. Hitting the cap is
+ * reported as a note, so the statement is never silently half-read.
+ */
+export const MAX_EXPANSION = 64;
+/**
+ * Which comment profile each language is read with.
+ *
+ * Keyed by language rather than by extension on purpose: the caller has already
+ * decided what this file is, and looking the answer up a second way is how the
+ * two answers get to disagree. A test asserts these agree with the
+ * extension-based lookup for every extension this module claims.
+ */
+export const SYNTAX_NAMES = {
+    python: 'hash',
+    go: 'go',
+    rust: 'rust',
+    csharp: 'c#',
+};
+function mask(source, language) {
+    const syntax = syntaxNamed(SYNTAX_NAMES[language]);
+    /* c8 ignore next -- SYNTAX_NAMES is asserted complete and correct in the tests */
+    if (!syntax)
+        throw new Error(`no comment syntax for ${language}`);
+    const { comments, strings, unterminated } = lexRanges(source, syntax);
+    // The opening delimiter is left visible so a reader can see that a literal
+    // starts here; everything inside it is blanked so no keyword can hide there.
+    const blanks = [...comments, ...strings.map(([start, end]) => [start + 1, end])];
+    return { code: maskRanges(source, blanks), strings, source, starts: lineStarts(source), unterminated };
+}
+/** The literal that starts exactly at `offset`, or null. */
+function literalAt(masked, offset) {
+    const { strings } = masked;
+    let low = 0;
+    let high = strings.length - 1;
+    while (low <= high) {
+        const mid = (low + high) >> 1;
+        const [start, end] = strings[mid];
+        if (start === offset)
+            return literalValue(masked.source.slice(start, end));
+        if (start < offset)
+            low = mid + 1;
+        else
+            high = mid - 1;
+    }
+    return null;
+}
+/** Every literal whose opening delimiter falls inside [from, to). */
+function literalsBetween(masked, from, to) {
+    const values = [];
+    for (const [start, end] of masked.strings) {
+        if (start >= to)
+            break;
+        if (start >= from)
+            values.push(literalValue(masked.source.slice(start, end)));
+    }
+    return values;
+}
+/** Strips the delimiters off a literal as the lexer captured it. */
+export function literalValue(raw) {
+    let text = raw;
+    if (text.startsWith('@'))
+        text = text.slice(1);
+    if (text.startsWith('r#"'))
+        return text.slice(3, -2);
+    if (text.startsWith('r"'))
+        return text.slice(2, -1);
+    if (text.startsWith('"""') || text.startsWith("'''"))
+        return text.slice(3, -3);
+    const quote = text[0];
+    if (quote === '"' || quote === "'" || quote === '`')
+        return text.slice(1, -1);
+    /* c8 ignore next -- every literal the lexer emits starts with one of the above */
+    return text;
+}
+/* ------------------------------------------------------------------ reading */
+const IDENTIFIER = /[A-Za-z_][A-Za-z0-9_]*/y;
+/**
+ * Whitespace-skipping cursor over masked code.
+ *
+ * Exported so its edges can be pinned directly. Reaching "what does peek() do
+ * at the end of the file" through a C# source string is possible but says
+ * nothing about C#.
+ */
+export class Reader {
+    text;
+    index = 0;
+    constructor(text) {
+        this.text = text;
+    }
+    skipSpace() {
+        // Character codes rather than /\s/: this runs once per whitespace character
+        // in the file, and a regular expression test at that frequency is the
+        // difference between the reader being free and the reader being the cost.
+        while (this.index < this.text.length) {
+            const code = this.text.charCodeAt(this.index);
+            if (code !== 32 && code !== 9 && code !== 10 && code !== 13)
+                return;
+            this.index += 1;
+        }
+    }
+    peek() {
+        return this.text[this.index] ?? '';
+    }
+    eat(token) {
+        if (!this.text.startsWith(token, this.index))
+            return false;
+        this.index += token.length;
+        return true;
+    }
+    /**
+     * Eats a word only when it really is the whole word.
+     *
+     * `eat('static')` also matches the first six characters of a namespace called
+     * `staticfiles`, and would then read the dependency as `files`.
+     */
+    keyword(word) {
+        if (!this.text.startsWith(word, this.index))
+            return false;
+        if (/[A-Za-z0-9_]/.test(this.text[this.index + word.length] ?? ''))
+            return false;
+        this.index += word.length;
+        return true;
+    }
+    identifier() {
+        IDENTIFIER.lastIndex = this.index;
+        const match = IDENTIFIER.exec(this.text);
+        if (!match)
+            return '';
+        this.index += match[0].length;
+        return match[0];
+    }
+    /** Reads `a.b.c`, treating `::` as a separator too (C# alias qualifiers). */
+    dotted() {
+        const parts = [];
+        for (;;) {
+            const part = this.identifier();
+            if (!part)
+                break;
+            parts.push(part);
+            if (!this.eat('.') && !this.eat('::'))
+                break;
+        }
+        return parts.join('.');
+    }
+    /** Skips a balanced `<...>`, so a generic alias target does not end the read. */
+    skipGenerics() {
+        if (this.peek() !== '<')
+            return;
+        let depth = 0;
+        while (this.index < this.text.length) {
+            const char = this.text[this.index];
+            if (char === '<')
+                depth += 1;
+            else if (char === '>') {
+                depth -= 1;
+                this.index += 1;
+                if (depth === 0)
+                    return;
+                continue;
+            }
+            else if (char === ';' || char === '\n')
+                return;
+            this.index += 1;
+        }
+    }
+}
+/** Offset of the matching close, given the depth-tracking characters. */
+export function matchingClose(text, open, opener, closer) {
+    let depth = 0;
+    for (let index = open; index < text.length; index++) {
+        const char = text[index];
+        if (char === opener)
+            depth += 1;
+        else if (char === closer) {
+            depth -= 1;
+            if (depth === 0)
+                return index;
+        }
+    }
+    return text.length;
+}
+function emit(collector, specifier, kind, offset) {
+    const trimmed = specifier.trim();
+    if (!trimmed)
+        return;
+    const { line, column } = locate(collector.masked.starts, offset);
+    collector.references.push({ specifier: trimmed, kind, typeOnly: false, line, column });
+}
+function note(collector, kind, offset, detail) {
+    const { line, column } = locate(collector.masked.starts, offset);
+    collector.notes.push({ kind, file: collector.file, line, column, detail });
+}
+/* ------------------------------------------------------------------- python */
+/**
+ * Groups physical lines into the logical lines Python actually executes.
+ *
+ * A statement continues while a bracket is open or the line ends in a
+ * backslash, and `from x import (\n  a,\n  b,\n)` is the shape that matters
+ * here. Lines are joined with a space so two tokens cannot fuse into one.
+ */
+export function logicalLines(code) {
+    const lines = [];
+    let text = '';
+    let offset = 0;
+    let depth = 0;
+    let start = 0;
+    const flush = () => {
+        if (text.trim())
+            lines.push({ text, offset });
+        text = '';
+    };
+    for (let index = 0; index <= code.length; index++) {
+        if (index < code.length && code[index] !== '\n') {
+            const char = code[index];
+            if (char === '(' || char === '[' || char === '{')
+                depth += 1;
+            else if (char === ')' || char === ']' || char === '}')
+                depth = Math.max(0, depth - 1);
+            continue;
+        }
+        const physical = code.slice(start, index);
+        if (!text)
+            offset = start;
+        text += (text ? ' ' : '') + physical.replace(/\\$/, ' ');
+        if (depth === 0 && !/\\$/.test(physical))
+            flush();
+        start = index + 1;
+    }
+    flush();
+    return lines;
+}
+/** `import` / `from` at a statement position: line start, or after `;` or `:`. */
+const PYTHON_STATEMENT = /(?:^|[;:])[ \t]*(import|from)[ \t]+/g;
+const PYTHON_FROM = /^(\.*)([A-Za-z_][\w.]*)?[ \t]*import[ \t]+(.*)$/;
+const PYTHON_DYNAMIC = /\b(__import__|import_module)[ \t]*\(/g;
+function readPython(collector) {
+    const { code } = collector.masked;
+    for (const line of logicalLines(code)) {
+        PYTHON_STATEMENT.lastIndex = 0;
+        let match;
+        while ((match = PYTHON_STATEMENT.exec(line.text)) !== null) {
+            const rest = line.text.slice(match.index + match[0].length).split(';')[0];
+            if (match[1] === 'import') {
+                // `import a.b as x, c.d` - one statement, two dependencies.
+                for (const clause of rest.split(',')) {
+                    const name = clause.trim().split(/\s+/)[0];
+                    if (name)
+                        emit(collector, name, 'import', line.offset);
+                }
+                continue;
+            }
+            const from = PYTHON_FROM.exec(rest);
+            if (!from)
+                continue;
+            const dots = from[1];
+            const module = from[2] ?? '';
+            if (module || !dots) {
+                emit(collector, `${dots}${module}`, 'import', line.offset);
+                continue;
+            }
+            // `from . import a, b` - here the imported names are themselves modules,
+            // which `from .pkg import name` cannot assume.
+            const names = from[3].replace(/[()]/g, '');
+            for (const clause of names.split(',').slice(0, MAX_EXPANSION)) {
+                const name = clause.trim().split(/\s+/)[0];
+                if (name && name !== '*')
+                    emit(collector, `${dots}${name}`, 'import', line.offset);
+            }
+        }
+    }
+    PYTHON_DYNAMIC.lastIndex = 0;
+    let dynamic;
+    while ((dynamic = PYTHON_DYNAMIC.exec(code)) !== null) {
+        const reader = new Reader(code);
+        reader.index = dynamic.index + dynamic[0].length;
+        reader.skipSpace();
+        const literal = literalAt(collector.masked, reader.index);
+        if (literal !== null)
+            emit(collector, literal, 'dynamic-import', dynamic.index);
+        else
+            note(collector, 'dynamic', dynamic.index, `${dynamic[1]}(...) with a computed name`);
+    }
+}
+/* ----------------------------------------------------------------------- go */
+const GO_IMPORT = /\bimport\b/g;
+function readGo(collector) {
+    const { code } = collector.masked;
+    GO_IMPORT.lastIndex = 0;
+    let match;
+    while ((match = GO_IMPORT.exec(code)) !== null) {
+        const reader = new Reader(code);
+        reader.index = match.index + match[0].length;
+        reader.skipSpace();
+        if (reader.peek() === '(') {
+            const close = matchingClose(code, reader.index, '(', ')');
+            for (const value of literalsBetween(collector.masked, reader.index, close)) {
+                emit(collector, value, 'import', match.index);
+            }
+            GO_IMPORT.lastIndex = close;
+            continue;
+        }
+        // A single import may carry an alias: `import fmt2 "fmt"`, `import _ "x"`.
+        if (reader.peek() === '_' || reader.peek() === '.')
+            reader.index += 1;
+        else
+            reader.identifier();
+        reader.skipSpace();
+        const literal = literalAt(collector.masked, reader.index);
+        if (literal !== null)
+            emit(collector, literal, 'import', match.index);
+    }
+}
+/* --------------------------------------------------------------------- rust */
+const RUST_USE = /\b(?:use|extern[ \t\r\n]+crate)\b/g;
+/**
+ * Expands one `use` path into the module paths it actually names.
+ *
+ * `a::{b, c::{d, e}}` is three dependencies written as one statement, and a
+ * rule about `a::c` has to see them. Returns null when the expansion would
+ * exceed MAX_EXPANSION, which the caller reports rather than truncating.
+ */
+export function expandUsePath(input) {
+    const text = input.trim();
+    const open = text.indexOf('{');
+    if (open === -1) {
+        // `a::b as c` and `a::b;` both name `a::b`.
+        const leaf = text.split(/\s+as\s+/)[0];
+        const trimmed = leaf.replace(/[;\s]+$/, '').replace(/^::/, '');
+        return trimmed ? [trimmed] : [];
+    }
+    const close = matchingClose(text, open, '{', '}');
+    const prefix = text.slice(0, open).replace(/::\s*$/, '').trim();
+    const inner = text.slice(open + 1, close);
+    const parts = [];
+    let depth = 0;
+    let current = '';
+    for (const char of inner) {
+        if (char === '{')
+            depth += 1;
+        if (char === '}')
+            depth -= 1;
+        if (char === ',' && depth === 0) {
+            parts.push(current);
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    parts.push(current);
+    const results = [];
+    for (const part of parts) {
+        const expanded = expandUsePath(part);
+        if (expanded === null)
+            return null;
+        for (const item of expanded) {
+            // `use a::{self, b}` names `a` itself alongside `a::b`.
+            results.push(item === 'self' || !prefix ? prefix || item : `${prefix}::${item}`);
+            if (results.length > MAX_EXPANSION)
+                return null;
+        }
+    }
+    return results;
+}
+function readRust(collector) {
+    const { code } = collector.masked;
+    RUST_USE.lastIndex = 0;
+    let match;
+    while ((match = RUST_USE.exec(code)) !== null) {
+        const start = match.index + match[0].length;
+        let end = start;
+        let depth = 0;
+        while (end < code.length) {
+            const char = code[end];
+            if (char === '{')
+                depth += 1;
+            else if (char === '}') {
+                if (depth === 0)
+                    break;
+                depth -= 1;
+            }
+            else if (char === ';' && depth === 0)
+                break;
+            end += 1;
+        }
+        const expanded = expandUsePath(code.slice(start, end));
+        if (expanded === null) {
+            note(collector, 'truncated', match.index, `a use declaration expands to more than ${MAX_EXPANSION} module paths`);
+        }
+        else {
+            for (const specifier of expanded)
+                emit(collector, specifier, 'use', match.index);
+        }
+        RUST_USE.lastIndex = end;
+    }
+}
+/* -------------------------------------------------------------------- c-sharp */
+const CSHARP_USING = /\busing\b/g;
+function readCsharp(collector) {
+    const { code } = collector.masked;
+    CSHARP_USING.lastIndex = 0;
+    let match;
+    while ((match = CSHARP_USING.exec(code)) !== null) {
+        const reader = new Reader(code);
+        reader.index = match.index + match[0].length;
+        reader.skipSpace();
+        if (reader.keyword('static'))
+            reader.skipSpace();
+        let target = reader.dotted();
+        reader.skipSpace();
+        // `using Alias = System.Text.Json;` - the dependency is the right-hand side.
+        if (reader.eat('=')) {
+            reader.skipSpace();
+            target = reader.dotted();
+            reader.skipSpace();
+            reader.skipGenerics();
+            reader.skipSpace();
+        }
+        // The whole of what separates a directive from a resource statement, and
+        // it is one condition on purpose. `using (var s = ...)` reads no name at
+        // all and stops on `(`; `using var s = ...` reads `var` and then finds `s`
+        // where a terminator has to be. Earlier versions guarded those two shapes
+        // explicitly, and a third time against an empty name - none of the three
+        // changed an outcome, which mutation testing established by leaving the
+        // tests green with each of them defeated. `emit` refuses an empty
+        // specifier, so this line is the only check that has to be right.
+        if (reader.peek() !== ';')
+            continue;
+        emit(collector, target, 'using', match.index);
+    }
+}
+/* ----------------------------------------------------------------- normalise */
+/**
+ * Rewrites a specifier into the `/`-separated form module patterns match.
+ *
+ * Every language names modules with its own separator - `a.b.c`, `a::b::c`,
+ * `a/b/c` - and a rule author should not have to know which one a given file
+ * uses. One notation, and the raw specifier stays matchable too, so a pattern
+ * written either way finds the dependency.
+ *
+ * Python's relative imports resolve against the importing file, the same path
+ * arithmetic (and the same refusal to touch the filesystem) as ADR-0005.
+ * Rust's `self::` and `super::` deliberately do not: resolving them needs the
+ * module tree, the module tree needs to know where inline `mod` blocks are, and
+ * that needs a parser. They are matched literally instead, and ADR-0008 says so
+ * out loud rather than leaving a rule to quietly miss them.
+ */
+export function normalizeModule(specifier, importingFile, language) {
+    if (language === 'go')
+        return specifier;
+    if (language === 'rust')
+        return specifier.replace(/::/g, '/');
+    if (language === 'csharp')
+        return specifier.replace(/\./g, '/');
+    if (!specifier.startsWith('.'))
+        return specifier.replace(/\./g, '/');
+    let level = 0;
+    while (specifier[level] === '.')
+        level += 1;
+    const tail = specifier.slice(level).replace(/\./g, '/');
+    let base = path.posix.dirname(importingFile);
+    for (let up = 1; up < level; up++)
+        base = path.posix.dirname(base);
+    return path.posix.normalize(path.posix.join(base, tail));
+}
+/* -------------------------------------------------------------------- entry */
+const READERS = {
+    python: readPython,
+    go: readGo,
+    rust: readRust,
+    csharp: readCsharp,
+};
+/** Extracts every module reference from a Python, Go, Rust or C# source file. */
+export function analyzePolyglot(source, file, language) {
+    const masked = mask(source, language);
+    const collector = { references: [], notes: [], masked, file };
+    READERS[language](collector);
+    if (masked.unterminated) {
+        collector.notes.push({
+            kind: 'unreadable',
+            file,
+            line: 1,
+            column: 1,
+            detail: 'a string or comment ran to the end of the file, so its imports are not trustworthy',
+        });
+    }
+    return { references: collector.references, notes: collector.notes };
+}
+//# sourceMappingURL=polyglot.js.map

package/dist/polyglot.js.map

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

package/dist/reporter.d.ts

@@ -39,7 +39,48 @@ export declare function shouldUseColor(stream: {
 export declare function shouldUseAscii(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
 /** Renders the full human-readable report. */
 export declare function formatReport(report: RunResult, options: ReporterOptions, maxSnippets?: number): string;
+/**
+ * The `baseline="..."` attribute that would exempt today's violations.
+ *
+ * The one machine-written edit spec-guard offers, and it is offered rather than
+ * applied. `--fix` is refused for architecture rules on purpose (ADR-0009): the
+ * only edits a machine can make to a failing boundary assertion are edits that
+ * record the rule no longer holding, and a tool that ships a button turning red
+ * into green without changing any code has shipped the wrong button - most of
+ * all to an agent in a loop, for which that button is the shortest path to a
+ * passing build.
+ *
+ * Printing is different from applying in the way that matters. The author
+ * pastes it into the spec, and the diff shows every exempted file by name, to a
+ * reviewer, in the commit that grants the exemption. Adopting a strict rule on
+ * a codebase that already violates it is otherwise a hand-transcription job,
+ * and the realistic alternative to that is not a clean codebase - it is no
+ * rule at all.
+ */
+export declare function formatBaselines(report: RunResult): string;
 /** Machine-readable output for CI consumers. */
 export declare function formatJson(report: RunResult): string;
+/**
+ * The static analysis interchange format, which is how a failure becomes a
+ * line-level annotation on a pull request.
+ *
+ * Chosen over an editor language server for the fast-feedback problem, and the
+ * reason is what spec-guard checks rather than how fast it is. Its claims are
+ * about a whole repository - "this symbol appears nowhere in src" - and a
+ * language server is handed one buffer at a time. Answering a repository-wide
+ * question on every keystroke means rescanning the tree on every keystroke; the
+ * alternative is answering a different, smaller question and calling it the
+ * same one. SARIF needs no daemon, no editor extension per editor and no
+ * protocol version matrix, and it puts the failure on the offending line for
+ * every reviewer rather than only for the author who has the plugin installed.
+ *
+ * One result per failing assertion, not per match: the thing that broke is the
+ * rule. The primary location is the first offending line so the annotation
+ * lands on the code; the directive that was violated is always a related
+ * location, because that is where the fix usually goes.
+ */
+export declare function formatSarif(report: RunResult, options?: {
+    version?: string;
+}): string;
 export {};
 //# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD,QAAA,MAAM,IAAI;aACR,KAAK;aACL,IAAI;aACJ,GAAG;aACH,GAAG;aACH,KAAK;aACL,MAAM;aACN,IAAI;aACJ,OAAO;aACP,IAAI;aACJ,IAAI;CACI,CAAC;AAEX,KAAK,KAAK,GAAG,MAAM,OAAO,IAAI,CAAC;AAE/B,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,MAAM,CAI1F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3B,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAKT;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,QAAQ,kBAAmB,GAAG,OAAO,CAGzG;AAkJD,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,SAAI,GAAG,MAAM,CA6EjG;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA+CpD"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD,QAAA,MAAM,IAAI;aACR,KAAK;aACL,IAAI;aACJ,GAAG;aACH,GAAG;aACH,KAAK;aACL,MAAM;aACN,IAAI;aACJ,OAAO;aACP,IAAI;aACJ,IAAI;CACI,CAAC;AAEX,KAAK,KAAK,GAAG,MAAM,OAAO,IAAI,CAAC;AAE/B,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,MAAM,CAI1F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3B,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAKT;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,QAAQ,kBAAmB,GAAG,OAAO,CAGzG;AA0JD,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,SAAI,GAAG,MAAM,CA8EjG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAezD;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAkDpD;AA2CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CA0EzF"}