@rhost/testkit 0.1.1 → 1.3.2

package/dist/validator/parser.js

@@ -0,0 +1,260 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// RhostMUSH softcode recursive-descent parser
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = parse;
+// ---------------------------------------------------------------------------
+// Parser class
+// ---------------------------------------------------------------------------
+class Parser {
+    constructor(tokens) {
+        this.tokens = tokens;
+        this.pos = 0;
+        this.diagnostics = [];
+    }
+    peek() {
+        return this.pos < this.tokens.length ? this.tokens[this.pos] : null;
+    }
+    consume() {
+        if (this.pos >= this.tokens.length) {
+            throw new Error('Unexpected end of token stream');
+        }
+        return this.tokens[this.pos++];
+    }
+    // -------------------------------------------------------------------------
+    // Top-level entry point
+    // -------------------------------------------------------------------------
+    /**
+     * Parse the entire token stream as a top-level expression.
+     * Stray `)` and `]` at the top level are reported as errors.
+     * Top-level commas are treated as literal text.
+     */
+    parseTopLevel() {
+        const nodes = [];
+        while (this.peek() !== null) {
+            const tok = this.peek();
+            if (tok.type === 'RPAREN') {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E002',
+                    message: `Unexpected ')' — no matching '(' was opened`,
+                    offset: tok.offset,
+                    length: 1,
+                });
+                this.consume();
+                continue;
+            }
+            if (tok.type === 'RBRACKET') {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E004',
+                    message: `Unexpected ']' — no matching '[' was opened`,
+                    offset: tok.offset,
+                    length: 1,
+                });
+                this.consume();
+                continue;
+            }
+            if (tok.type === 'COMMA') {
+                // Top-level comma is literal text (not inside a function call)
+                nodes.push({ type: 'RawText', value: ',', offset: tok.offset });
+                this.consume();
+                continue;
+            }
+            const node = this.parseNode();
+            if (node !== null)
+                nodes.push(node);
+        }
+        return nodes;
+    }
+    // -------------------------------------------------------------------------
+    // Node dispatch
+    // -------------------------------------------------------------------------
+    /**
+     * Parse a single AST node.  Returns null only at EOF.
+     */
+    parseNode() {
+        const tok = this.peek();
+        if (tok === null)
+            return null;
+        if (tok.type === 'FNAME') {
+            return this.parseFunctionCall();
+        }
+        if (tok.type === 'LBRACKET') {
+            return this.parseBracketEval();
+        }
+        if (tok.type === 'SUBST') {
+            this.consume();
+            return { type: 'Substitution', raw: tok.value, offset: tok.offset };
+        }
+        // ESC, TEXT, LPAREN (bare paren not after identifier), anything else → RawText
+        this.consume();
+        return { type: 'RawText', value: tok.value, offset: tok.offset };
+    }
+    // -------------------------------------------------------------------------
+    // Function call: FNAME LPAREN [arglist] RPAREN
+    // -------------------------------------------------------------------------
+    parseFunctionCall() {
+        const nameTok = this.consume(); // FNAME
+        // Tokenizer guarantees LPAREN immediately follows FNAME
+        const lparenTok = this.consume(); // LPAREN
+        const node = {
+            type: 'FunctionCall',
+            name: nameTok.value,
+            nameOffset: nameTok.offset,
+            args: [],
+            offset: lparenTok.offset,
+        };
+        // Immediately closed: name()
+        if (this.peek()?.type === 'RPAREN') {
+            this.consume();
+            return node;
+        }
+        // EOF immediately after opening paren
+        if (this.peek() === null) {
+            this.diagnostics.push(this.unclosedParen(nameTok.value, lparenTok.offset));
+            return node;
+        }
+        // Parse comma-separated argument expressions
+        while (true) {
+            const arg = this.parseArgExpression(nameTok.value);
+            node.args.push(arg);
+            const next = this.peek();
+            if (next === null) {
+                // EOF without closing paren
+                this.diagnostics.push(this.unclosedParen(nameTok.value, lparenTok.offset));
+                break;
+            }
+            if (next.type === 'RPAREN') {
+                this.consume();
+                break;
+            }
+            if (next.type === 'COMMA') {
+                this.consume();
+                // Trailing comma — push one final empty arg and close on next RPAREN
+                if (this.peek()?.type === 'RPAREN') {
+                    node.args.push([]);
+                    this.consume();
+                    break;
+                }
+                if (this.peek() === null) {
+                    node.args.push([]);
+                    this.diagnostics.push(this.unclosedParen(nameTok.value, lparenTok.offset));
+                    break;
+                }
+                continue;
+            }
+            // Unexpected token — shouldn't happen with a well-formed token stream
+            break;
+        }
+        return node;
+    }
+    /**
+     * Parse one argument expression, stopping (without consuming) at a
+     * COMMA or RPAREN that closes the current function call.
+     * LBRACKET/RBRACKET are handled recursively by parseBracketEval, so
+     * they do NOT prematurely end an argument even if they contain commas.
+     */
+    parseArgExpression(funcName) {
+        const nodes = [];
+        while (true) {
+            const tok = this.peek();
+            if (tok === null)
+                break;
+            // These end the current argument
+            if (tok.type === 'COMMA' || tok.type === 'RPAREN')
+                break;
+            // Stray ] inside a function argument
+            if (tok.type === 'RBRACKET') {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E004',
+                    message: `Unexpected ']' inside argument of '${funcName}'`,
+                    offset: tok.offset,
+                    length: 1,
+                });
+                this.consume();
+                continue;
+            }
+            const node = this.parseNode();
+            if (node !== null)
+                nodes.push(node);
+        }
+        return nodes;
+    }
+    // -------------------------------------------------------------------------
+    // Bracket eval: LBRACKET expression RBRACKET
+    // -------------------------------------------------------------------------
+    parseBracketEval() {
+        const lbracketTok = this.consume(); // LBRACKET
+        const innerNodes = [];
+        while (true) {
+            const tok = this.peek();
+            if (tok === null) {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E003',
+                    message: `Unclosed '[' — missing closing ']'`,
+                    offset: lbracketTok.offset,
+                    length: 1,
+                });
+                break;
+            }
+            if (tok.type === 'RBRACKET') {
+                this.consume();
+                break;
+            }
+            // Stray ) inside a bracket eval at the bracket's top level
+            if (tok.type === 'RPAREN') {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E002',
+                    message: `Unexpected ')' inside '[ ]' expression`,
+                    offset: tok.offset,
+                    length: 1,
+                });
+                this.consume();
+                continue;
+            }
+            // Top-level comma inside a bracket eval is literal text
+            if (tok.type === 'COMMA') {
+                innerNodes.push({ type: 'RawText', value: ',', offset: tok.offset });
+                this.consume();
+                continue;
+            }
+            const node = this.parseNode();
+            if (node !== null)
+                innerNodes.push(node);
+        }
+        return { type: 'BracketEval', nodes: innerNodes, offset: lbracketTok.offset };
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    unclosedParen(funcName, offset) {
+        return {
+            severity: 'error',
+            code: 'E001',
+            message: `Unclosed '(' for function '${funcName}' — missing closing ')'`,
+            offset,
+            length: 1,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+/**
+ * Parse a flat token stream into an AST.
+ *
+ * Structural errors (unbalanced parens/brackets) are embedded in `diagnostics`.
+ * The returned `nodes` array always contains the best-effort parse even when
+ * there are errors, enabling downstream semantic checks to still run.
+ */
+function parse(tokens) {
+    const parser = new Parser(tokens);
+    const nodes = parser.parseTopLevel();
+    return { nodes, diagnostics: parser.diagnostics };
+}
+//# sourceMappingURL=parser.js.map

package/dist/validator/parser.js.map

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

package/dist/validator/tokenizer.d.ts

@@ -0,0 +1,28 @@
+export type TokenType = 'FNAME' | 'LPAREN' | 'RPAREN' | 'COMMA' | 'LBRACKET' | 'RBRACKET' | 'SUBST' | 'ESC' | 'TEXT';
+export interface Token {
+    type: TokenType;
+    /** The raw text of this token as it appears in the source */
+    value: string;
+    /** Character offset in the original expression string */
+    offset: number;
+}
+/**
+ * Tokenize a RhostMUSH softcode expression into a flat token stream.
+ *
+ * Rules (in priority order):
+ *   1. `\X`           → ESC(X)                   — escape always wins
+ *   2. `%%`           → TEXT('%')                 — literal percent
+ *   3. `%qX` / `%iX`  → SUBST('%qX')             — 3-char register subst
+ *   4. `%X` (known)   → SUBST('%X')               — 2-char substitution
+ *   5. `%`  (unknown) → TEXT('%')                 — treat as literal
+ *   6. `[`            → LBRACKET
+ *   7. `]`            → RBRACKET
+ *   8. `)`            → RPAREN
+ *   9. `,`            → COMMA
+ *  10. `word(`        → FNAME(word) + LPAREN('(')
+ *  11. `word`         → TEXT(word)                — identifier not before (
+ *  12. `(`            → TEXT('(')                 — ( not after identifier
+ *  13. <run>          → TEXT(run)                 — anything else
+ */
+export declare function tokenize(input: string): Token[];
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/validator/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../src/validator/tokenizer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,GACV,UAAU,GACV,OAAO,GACP,KAAK,GACL,MAAM,CAAC;AAEX,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAsCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAoI/C"}

package/dist/validator/tokenizer.js

@@ -0,0 +1,174 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// RhostMUSH softcode tokenizer
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenize = tokenize;
+// Characters that end a plain-text accumulation run.
+// These must be checked before starting a new TEXT run.
+const STRUCTURAL_RE = /[\\%\[\]()\,,a-zA-Z_]/;
+function isIdentStart(ch) {
+    const c = ch.charCodeAt(0);
+    return (c >= 65 && c <= 90) || (c >= 97 && c <= 122) || c === 95; // A-Z, a-z, _
+}
+function isIdentChar(ch) {
+    const c = ch.charCodeAt(0);
+    return ((c >= 65 && c <= 90) ||
+        (c >= 97 && c <= 122) ||
+        (c >= 48 && c <= 57) ||
+        c === 95); // A-Z, a-z, 0-9, _
+}
+/**
+ * Single-character percent substitutions recognised by RhostMUSH.
+ * Anything else after % is treated as a literal %, not a substitution.
+ */
+const SINGLE_CHAR_SUBST = new Set([
+    '#', 'N', 'n', 'L', 'l', 'P', 'p', 'T', 't', 'B', 'b',
+    'R', 'r', 'A', 'a', 'O', 'o', 'S', 's', 'X', 'x', '+',
+    '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
+    'C', 'c', // ANSI carry
+    'v', 'V', // attribute value
+    'w', 'W', // attribute name
+    'u', 'U', // room name
+    'f', 'F', // from
+    'k', 'K', // money
+    'm', 'M', // last entered command
+]);
+/**
+ * Tokenize a RhostMUSH softcode expression into a flat token stream.
+ *
+ * Rules (in priority order):
+ *   1. `\X`           → ESC(X)                   — escape always wins
+ *   2. `%%`           → TEXT('%')                 — literal percent
+ *   3. `%qX` / `%iX`  → SUBST('%qX')             — 3-char register subst
+ *   4. `%X` (known)   → SUBST('%X')               — 2-char substitution
+ *   5. `%`  (unknown) → TEXT('%')                 — treat as literal
+ *   6. `[`            → LBRACKET
+ *   7. `]`            → RBRACKET
+ *   8. `)`            → RPAREN
+ *   9. `,`            → COMMA
+ *  10. `word(`        → FNAME(word) + LPAREN('(')
+ *  11. `word`         → TEXT(word)                — identifier not before (
+ *  12. `(`            → TEXT('(')                 — ( not after identifier
+ *  13. <run>          → TEXT(run)                 — anything else
+ */
+function tokenize(input) {
+    const tokens = [];
+    let pos = 0;
+    const len = input.length;
+    while (pos < len) {
+        const ch = input[pos];
+        // ---- 1. Backslash escape ----
+        if (ch === '\\') {
+            if (pos + 1 < len) {
+                tokens.push({ type: 'ESC', value: input[pos + 1], offset: pos });
+                pos += 2;
+            }
+            else {
+                // Trailing backslash: literal backslash
+                tokens.push({ type: 'TEXT', value: '\\', offset: pos });
+                pos++;
+            }
+            continue;
+        }
+        // ---- 2–5. Percent substitutions ----
+        if (ch === '%') {
+            if (pos + 1 >= len) {
+                tokens.push({ type: 'TEXT', value: '%', offset: pos });
+                pos++;
+                continue;
+            }
+            const next = input[pos + 1];
+            // %% → literal %
+            if (next === '%') {
+                tokens.push({ type: 'TEXT', value: '%', offset: pos });
+                pos += 2;
+                continue;
+            }
+            // %q0–%q9, %qA–%qZ (q-register), %i0–%i9 (iter var) → 3-char subst
+            if ((next === 'q' || next === 'Q' || next === 'i' || next === 'I') &&
+                pos + 2 < len && /[0-9a-zA-Z]/.test(input[pos + 2])) {
+                tokens.push({ type: 'SUBST', value: input.slice(pos, pos + 3), offset: pos });
+                pos += 3;
+                continue;
+            }
+            // Single-char known substitutions
+            if (SINGLE_CHAR_SUBST.has(next)) {
+                tokens.push({ type: 'SUBST', value: input.slice(pos, pos + 2), offset: pos });
+                pos += 2;
+                continue;
+            }
+            // Unknown %X: literal %
+            tokens.push({ type: 'TEXT', value: '%', offset: pos });
+            pos++;
+            continue;
+        }
+        // ---- 6–9. Single structural characters ----
+        if (ch === '[') {
+            tokens.push({ type: 'LBRACKET', value: '[', offset: pos });
+            pos++;
+            continue;
+        }
+        if (ch === ']') {
+            tokens.push({ type: 'RBRACKET', value: ']', offset: pos });
+            pos++;
+            continue;
+        }
+        if (ch === ')') {
+            tokens.push({ type: 'RPAREN', value: ')', offset: pos });
+            pos++;
+            continue;
+        }
+        if (ch === ',') {
+            tokens.push({ type: 'COMMA', value: ',', offset: pos });
+            pos++;
+            continue;
+        }
+        // ---- 10–11. Identifier: FNAME+LPAREN or plain TEXT ----
+        if (isIdentStart(ch)) {
+            const start = pos;
+            while (pos < len && isIdentChar(input[pos])) {
+                pos++;
+            }
+            const word = input.slice(start, pos);
+            if (pos < len && input[pos] === '(') {
+                // Function call: emit FNAME then LPAREN
+                tokens.push({ type: 'FNAME', value: word, offset: start });
+                tokens.push({ type: 'LPAREN', value: '(', offset: pos });
+                pos++;
+            }
+            else {
+                // Bare identifier — text
+                tokens.push({ type: 'TEXT', value: word, offset: start });
+            }
+            continue;
+        }
+        // ---- 12. '(' not after an identifier: literal ----
+        if (ch === '(') {
+            tokens.push({ type: 'TEXT', value: '(', offset: pos });
+            pos++;
+            continue;
+        }
+        // ---- 13. Plain text accumulation ----
+        {
+            const start = pos;
+            while (pos < len) {
+                const c = input[pos];
+                // Stop at any character that starts a higher-priority rule
+                if (c === '\\' || c === '%' ||
+                    c === '[' || c === ']' ||
+                    c === '(' || c === ')' ||
+                    c === ',' ||
+                    isIdentStart(c)) {
+                    break;
+                }
+                pos++;
+            }
+            if (pos > start) {
+                tokens.push({ type: 'TEXT', value: input.slice(start, pos), offset: start });
+            }
+        }
+    }
+    return tokens;
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/validator/tokenizer.js.map

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

package/dist/validator/types.d.ts

@@ -0,0 +1,55 @@
+export type Severity = 'error' | 'warning';
+/** A single diagnostic produced by the validator. */
+export interface Diagnostic {
+    severity: Severity;
+    /** Error/warning code, e.g. 'E001', 'W002' */
+    code: string;
+    message: string;
+    /** Character offset in the original expression string */
+    offset: number;
+    /** Span length in characters (0 = point diagnostic) */
+    length: number;
+}
+/** Result returned by `validate()` */
+export interface ValidationResult {
+    /** false if any diagnostic has severity 'error' */
+    valid: boolean;
+    diagnostics: Diagnostic[];
+}
+export type ASTNode = FunctionCallNode | BracketEvalNode | SubstitutionNode | RawTextNode;
+/** A function call: `name(arg1, arg2, ...)` */
+export interface FunctionCallNode {
+    type: 'FunctionCall';
+    /** Original casing preserved from source */
+    name: string;
+    /** Offset of the first character of the name */
+    nameOffset: number;
+    /**
+     * Each element is the list of nodes forming one argument.
+     * An empty inner array means an empty/missing argument.
+     */
+    args: ASTNode[][];
+    /** Offset of the opening parenthesis */
+    offset: number;
+}
+/** An inline evaluation: `[expression]` */
+export interface BracketEvalNode {
+    type: 'BracketEval';
+    nodes: ASTNode[];
+    /** Offset of the '[' */
+    offset: number;
+}
+/** A percent-substitution: `%#`, `%N`, `%q0`, `%0`–`%9`, `%%`, etc. */
+export interface SubstitutionNode {
+    type: 'Substitution';
+    /** The raw substitution text as it appears in the source */
+    raw: string;
+    offset: number;
+}
+/** Literal text or an escaped character that requires no further analysis */
+export interface RawTextNode {
+    type: 'RawText';
+    value: string;
+    offset: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/validator/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validator/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAMD,MAAM,MAAM,OAAO,GACf,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC;AAEhB,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IAClB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/validator/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Shared types for the RhostMUSH softcode validator
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/validator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/validator/types.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,oDAAoD;AACpD,8EAA8E"}

package/dist/watcher.d.ts

@@ -0,0 +1,44 @@
+export interface WatchOptions {
+    /** Absolute paths of test files to watch and run */
+    files: string[];
+    /** Debounce delay in ms before re-running after a change. Default: 300 */
+    debounceMs?: number;
+    /** Clear terminal between runs. Default: true */
+    clearScreen?: boolean;
+}
+export declare class RhostWatcher {
+    private readonly options;
+    private readonly debounceMs;
+    private readonly clearScreen;
+    private watcher;
+    private debounceTimer;
+    private pendingFiles;
+    private currentProcess;
+    private stopped;
+    private runCount;
+    constructor(options: WatchOptions);
+    /**
+     * Start watching.  Runs an initial pass immediately, then re-runs on change.
+     * Blocks until `stop()` is called (or SIGINT).
+     */
+    start(): Promise<void>;
+    /** Graceful shutdown: cancel pending timers, close watcher, kill child. */
+    stop(): Promise<void>;
+    private setupWatcher;
+    private runFiles;
+    private spawnFile;
+    private printBanner;
+    private printRunHeader;
+    /**
+     * Find the longest common directory path shared by all given dirs.
+     * Falls back to '/' (or drive root on Windows) if nothing in common.
+     */
+    private commonRoot;
+}
+/**
+ * Recursively walk `rootDir` and return all test files matching
+ * `*.test.ts`, `*.test.js`, `*.spec.ts`, `*.spec.js`.
+ * Skips `node_modules`, `dist`, `.git`, `.next`, `.turbo`.
+ */
+export declare function discoverTestFiles(rootDir: string): string[];
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,qBAAa,YAAY;IAWX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IAEtC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAK;gBAEQ,OAAO,EAAE,YAAY;IAKlD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B5B,2EAA2E;IACrE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B,OAAO,CAAC,YAAY;YA2CN,QAAQ;IAuBtB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,cAAc;IAqBtB;;;OAGG;IACH,OAAO,CAAC,UAAU;CAoBnB;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAI3D"}