@descent-vtt/spec-guard 0.2.0 → 0.4.0

package/dist/imports.js

@@ -0,0 +1,492 @@
+/**
+ * Module-reference extraction for JavaScript and TypeScript.
+ *
+ * This is deliberately a tokenizer and not a parser. It walks the source
+ * tracking whether it is in code, a comment, a string, a template literal or a
+ * regular expression, emits a flat token stream, and reads module references
+ * off that stream. It knows nothing about scopes, types or semantics.
+ *
+ * The reason it is a tokenizer rather than a regular expression is that a
+ * regular expression cannot tell these apart:
+ *
+ *   // import { Client } from '../db';        a comment
+ *   const doc = "import { Client } from '..'"; a string
+ *
+ * and the reason it is not a parser is that a parser for two languages is
+ * larger than this whole tool. See ADR-0005.
+ *
+ * The critical property is that it knows when it has failed. If the scan ends
+ * inside a string, template or comment, the token stream is not trustworthy and
+ * the file is reported as unanalysable rather than as having no imports.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { toPosix } from './glob.js';
+/** Extensions this analyser understands. Anything else is reported as skipped. */
+export const ANALYSABLE_EXTENSIONS = new Set([
+    '.js',
+    '.mjs',
+    '.cjs',
+    '.jsx',
+    '.ts',
+    '.mts',
+    '.cts',
+    '.tsx',
+]);
+/**
+ * Words after which a `/` begins a regular expression rather than a division.
+ * The remaining ambiguity is `)` and `}`, where this follows the usual
+ * heuristic; a wrong guess is caught by the end-state check rather than
+ * silently mis-scanning the rest of the file.
+ */
+const REGEX_AFTER_WORD = new Set([
+    'return',
+    'typeof',
+    'instanceof',
+    'in',
+    'of',
+    'new',
+    'delete',
+    'void',
+    'throw',
+    'case',
+    'do',
+    'else',
+    'yield',
+    'await',
+]);
+/**
+ * `<` is deliberately absent: in JSX every closing tag is `</`, and reading that
+ * as the start of a regular expression loses the scan for the rest of the file.
+ * The cost is that `a < /re/.test(b)` is misread instead, which is a shape that
+ * does not occur in practice.
+ */
+const REGEX_AFTER_PUNCT = new Set([
+    '(',
+    ',',
+    '=',
+    ':',
+    '[',
+    '!',
+    '&',
+    '|',
+    '?',
+    '{',
+    '}',
+    ';',
+    '+',
+    '-',
+    '*',
+    '/',
+    '%',
+    '^',
+    '~',
+    '>',
+]);
+function isIdentifierStart(char) {
+    // Deliberately not @ or #: they can start a decorator or a private field but
+    // cannot continue an identifier, so accepting them here would read a
+    // zero-length word and never advance. They are emitted as punctuation.
+    return /[A-Za-z_$]/.test(char);
+}
+function isIdentifierPart(char) {
+    return /[A-Za-z0-9_$]/.test(char);
+}
+/** Splits source into the flat token stream the extractor reads. */
+export function tokenize(source) {
+    const tokens = [];
+    let index = 0;
+    let line = 1;
+    let lineStart = 0;
+    // Brace depth at each open `${`, so the matching `}` returns to the template.
+    const templateStack = [];
+    let braceDepth = 0;
+    let desynced = false;
+    const column = (at) => at - lineStart + 1;
+    const advanceLine = (at) => {
+        line += 1;
+        lineStart = at + 1;
+    };
+    const previous = () => tokens[tokens.length - 1];
+    const regexAllowed = () => {
+        const token = previous();
+        if (!token)
+            return true;
+        if (token.type === 'word')
+            return REGEX_AFTER_WORD.has(token.value);
+        if (token.type === 'punct')
+            return REGEX_AFTER_PUNCT.has(token.value);
+        return false;
+    };
+    /** Reads a quoted string. Returns null when it does not terminate. */
+    const readQuoted = (quote) => {
+        let value = '';
+        index += 1;
+        while (index < source.length) {
+            const char = source[index];
+            if (char === '\\') {
+                value += source[index + 1] ?? '';
+                index += 2;
+                continue;
+            }
+            if (char === quote) {
+                index += 1;
+                return value;
+            }
+            if (char === '\n')
+                return null;
+            value += char;
+            index += 1;
+        }
+        return null;
+    };
+    while (index < source.length) {
+        const char = source[index];
+        const next = source[index + 1];
+        if (char === '\n') {
+            advanceLine(index);
+            index += 1;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            index += 1;
+            continue;
+        }
+        if (char === '/' && next === '/') {
+            while (index < source.length && source[index] !== '\n')
+                index += 1;
+            continue;
+        }
+        if (char === '/' && next === '*') {
+            const end = source.indexOf('*/', index + 2);
+            if (end === -1) {
+                desynced = true;
+                break;
+            }
+            for (let scan = index; scan < end; scan++) {
+                if (source[scan] === '\n')
+                    advanceLine(scan);
+            }
+            index = end + 2;
+            continue;
+        }
+        if (char === '/' && regexAllowed()) {
+            const startLine = line;
+            const startColumn = column(index);
+            let scan = index + 1;
+            let inClass = false;
+            let closed = false;
+            while (scan < source.length) {
+                const inner = source[scan];
+                if (inner === '\\') {
+                    scan += 2;
+                    continue;
+                }
+                if (inner === '\n')
+                    break;
+                if (inner === '[')
+                    inClass = true;
+                else if (inner === ']')
+                    inClass = false;
+                else if (inner === '/' && !inClass) {
+                    closed = true;
+                    scan += 1;
+                    break;
+                }
+                scan += 1;
+            }
+            if (!closed) {
+                desynced = true;
+                break;
+            }
+            while (scan < source.length && isIdentifierPart(source[scan]))
+                scan += 1;
+            tokens.push({ type: 'punct', value: 'regex', line: startLine, column: startColumn });
+            index = scan;
+            continue;
+        }
+        if (char === "'" || char === '"') {
+            const startLine = line;
+            const startColumn = column(index);
+            const value = readQuoted(char);
+            if (value === null) {
+                desynced = true;
+                break;
+            }
+            tokens.push({ type: 'string', value, line: startLine, column: startColumn });
+            continue;
+        }
+        if (char === '`') {
+            const startLine = line;
+            const startColumn = column(index);
+            let value = '';
+            let substituted = false;
+            let scan = index + 1;
+            let closed = false;
+            while (scan < source.length) {
+                const inner = source[scan];
+                if (inner === '\\') {
+                    value += source[scan + 1] ?? '';
+                    scan += 2;
+                    continue;
+                }
+                if (inner === '`') {
+                    closed = true;
+                    scan += 1;
+                    break;
+                }
+                if (inner === '$' && source[scan + 1] === '{') {
+                    // Hand the substitution back to the main loop so its contents are
+                    // tokenized as code; the matching brace returns here.
+                    substituted = true;
+                    break;
+                }
+                if (inner === '\n')
+                    advanceLine(scan);
+                value += inner;
+                scan += 1;
+            }
+            if (substituted) {
+                templateStack.push(braceDepth);
+                braceDepth += 1;
+                tokens.push({ type: 'template', value: '', line: startLine, column: startColumn });
+                index = scan + 2;
+                continue;
+            }
+            if (!closed) {
+                desynced = true;
+                break;
+            }
+            // A template with no substitutions is usable as a specifier.
+            tokens.push({ type: 'string', value, line: startLine, column: startColumn });
+            index = scan;
+            continue;
+        }
+        if (char === '}' && templateStack.length > 0 && braceDepth === templateStack.at(-1) + 1) {
+            // Closing a `${`: resume scanning the template that opened it.
+            templateStack.pop();
+            braceDepth -= 1;
+            let scan = index + 1;
+            let closed = false;
+            while (scan < source.length) {
+                const inner = source[scan];
+                if (inner === '\\') {
+                    scan += 2;
+                    continue;
+                }
+                if (inner === '`') {
+                    closed = true;
+                    scan += 1;
+                    break;
+                }
+                if (inner === '$' && source[scan + 1] === '{') {
+                    templateStack.push(braceDepth);
+                    braceDepth += 1;
+                    scan += 2;
+                    closed = true;
+                    break;
+                }
+                if (inner === '\n')
+                    advanceLine(scan);
+                scan += 1;
+            }
+            if (!closed) {
+                desynced = true;
+                break;
+            }
+            index = scan;
+            continue;
+        }
+        if (isIdentifierStart(char)) {
+            const startColumn = column(index);
+            let scan = index;
+            while (scan < source.length && isIdentifierPart(source[scan]))
+                scan += 1;
+            /* c8 ignore next -- belt and braces: a word must consume at least one character */
+            if (scan === index)
+                scan += 1;
+            tokens.push({ type: 'word', value: source.slice(index, scan), line, column: startColumn });
+            index = scan;
+            continue;
+        }
+        if (char === '{')
+            braceDepth += 1;
+        if (char === '}')
+            braceDepth -= 1;
+        tokens.push({ type: 'punct', value: char, line, column: column(index) });
+        index += 1;
+    }
+    if (templateStack.length > 0)
+        desynced = true;
+    return { tokens, desynced };
+}
+/* ---------------------------------------------------------------- extractor */
+/** How far past `import`/`export` to look for `from`, before giving up. */
+const CLAUSE_LOOKAHEAD = 200;
+/**
+ * Reads module references off a token stream.
+ *
+ * Recognised: `import ... from 'x'`, `import 'x'`, `import('x')`,
+ * `export ... from 'x'`, `export * from 'x'`, `require('x')`. Anything whose
+ * specifier is not a literal becomes a note instead of a reference.
+ */
+export function extractReferences(tokens, file) {
+    const references = [];
+    const notes = [];
+    const note = (kind, token, detail) => {
+        notes.push({ kind, file, line: token.line, column: token.column, detail });
+    };
+    for (let index = 0; index < tokens.length; index++) {
+        const token = tokens[index];
+        if (token.type !== 'word')
+            continue;
+        const isImport = token.value === 'import';
+        const isExport = token.value === 'export';
+        const isRequire = token.value === 'require';
+        if (!isImport && !isExport && !isRequire)
+            continue;
+        // ADR-0005 Q3: a property access is not a module reference. `loader.require`
+        // and `obj.import` are ordinary method calls.
+        const preceding = tokens[index - 1];
+        if (preceding?.type === 'punct' && preceding.value === '.')
+            continue;
+        const after = tokens[index + 1];
+        if (!after)
+            continue;
+        // import.meta / import.something - not a module reference.
+        if (isImport && after.type === 'punct' && after.value === '.')
+            continue;
+        // Call form: import('x') and require('x').
+        if ((isImport || isRequire) && after.type === 'punct' && after.value === '(') {
+            const argument = tokens[index + 2];
+            const closing = tokens[index + 3];
+            if (argument?.type === 'string' &&
+                closing?.type === 'punct' &&
+                (closing.value === ')' || closing.value === ',')) {
+                references.push({
+                    specifier: argument.value,
+                    kind: isImport ? 'dynamic-import' : 'require',
+                    typeOnly: false,
+                    line: token.line,
+                    column: token.column,
+                });
+            }
+            else {
+                const shape = argument?.type === 'word' ? argument.value : 'expression';
+                note('dynamic', token, `${token.value}(${shape})`);
+            }
+            index += 1;
+            continue;
+        }
+        // Bare side-effect import: import 'x'.
+        if (isImport && after.type === 'string') {
+            references.push({
+                specifier: after.value,
+                kind: 'import',
+                typeOnly: false,
+                line: token.line,
+                column: token.column,
+            });
+            index += 1;
+            continue;
+        }
+        if (isRequire)
+            continue;
+        // Statement form: scan the clause for `from` followed by a literal.
+        // `import type { A } from 'x'` is type-only. `import type from 'x'` imports a
+        // default binding that happens to be called type, and is a value import.
+        const following = tokens[index + 2];
+        const typeOnly = after.type === 'word' &&
+            after.value === 'type' &&
+            following?.type !== 'string' &&
+            !(following?.type === 'word' && following.value === 'from');
+        const limit = Math.min(tokens.length, index + CLAUSE_LOOKAHEAD);
+        for (let scan = index + 1; scan < limit; scan++) {
+            const current = tokens[scan];
+            if (current.type === 'punct' && current.value === ';')
+                break;
+            if (current.type !== 'word' || current.value !== 'from')
+                continue;
+            const specifier = tokens[scan + 1];
+            if (specifier?.type === 'string') {
+                references.push({
+                    specifier: specifier.value,
+                    kind: isImport ? 'import' : 'export',
+                    typeOnly,
+                    line: token.line,
+                    column: token.column,
+                });
+                index = scan + 1;
+            }
+            break;
+        }
+    }
+    return { references, notes };
+}
+/** Tokenizes and extracts, reporting a lost scan as an unreadable note. */
+export function analyzeSource(source, file) {
+    const { tokens, desynced } = tokenize(source);
+    const result = extractReferences(tokens, file);
+    if (desynced) {
+        result.notes.push({
+            kind: 'unreadable',
+            file,
+            line: 1,
+            column: 1,
+            detail: 'the scan ended inside a string, template or comment, so its imports are not trustworthy',
+        });
+    }
+    return result;
+}
+/* ------------------------------------------------------------- normalisation */
+/**
+ * Resolves a specifier to something matchable, using path arithmetic only.
+ *
+ * Relative specifiers become root-relative paths; everything else is left
+ * exactly as written. There is deliberately no filesystem access, no extension
+ * guessing and no tsconfig path mapping - see ADR-0005.
+ */
+export function resolveSpecifier(specifier, importingFile) {
+    if (!specifier.startsWith('./') && !specifier.startsWith('../'))
+        return specifier;
+    const directory = path.posix.dirname(toPosix(importingFile));
+    return path.posix.normalize(path.posix.join(directory, specifier));
+}
+/**
+ * Per-run cache: parse once, query many.
+ *
+ * Several assertions in one document routinely point at the same directory, and
+ * tokenizing is the most expensive thing spec-guard does. Without this the cost
+ * would be the tree multiplied by the number of import assertions.
+ */
+export function createImportIndex() {
+    const cache = new Map();
+    return {
+        get size() {
+            return cache.size;
+        },
+        analyze(absolutePath, relativePath) {
+            let pending = cache.get(absolutePath);
+            if (!pending) {
+                pending = fs
+                    .readFile(absolutePath, 'utf8')
+                    .then((source) => analyzeSource(source, relativePath))
+                    .catch((error) => ({
+                    references: [],
+                    notes: [
+                        {
+                            kind: 'unreadable',
+                            file: relativePath,
+                            line: 1,
+                            column: 1,
+                            detail: `could not be read: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                }));
+                cache.set(absolutePath, pending);
+            }
+            return pending;
+        },
+    };
+}
+//# sourceMappingURL=imports.js.map

package/dist/imports.js.map

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

package/dist/index.d.ts

@@ -13,15 +13,19 @@
  */
 export { main, parseArgs, HELP, UsageError, EXIT_OK, EXIT_FAILED, EXIT_ERROR } from './cli.js';
 export type { CliIO, CliOptions } from './cli.js';
-export { buildJsRegExp, buildRipgrepArgs, canBatchLiterals, createCachedEngine, createRipgrepSink, enumerateCandidates, escapeRegExp, findRipgrep, javascriptEngine, resetRipgrepProbe, resolveEngine, runSearches, scanContent, shouldBatchPatterns, MAX_FILE_SIZE, SMALL_TREE_BUDGET, } from './engine.js';
-export type { BatchEngine, CachedEngine, Engine, EnginePreference, Enumeration, EnumerationBudget, RipgrepSink, SearchRequest, } from './engine.js';
-export { compareDirents, createGlobMatcher, defaultDirectoryReader, expandSpecPatterns, globBase, globToRegExp, isGlob, toPosix, walkFiles, DEFAULT_IGNORED_DIRECTORIES, } from './glob.js';
+export { buildJsRegExp, buildRipgrepArgs, createCachedEngine, enumerateCandidates, escapeRegExp, findRipgrep, parseRipgrepErrors, isMissingBinary, javascriptEngine, resetRipgrepProbe, resolveEngine, runSearches, scanContent, sortLocations, MAX_FILE_SIZE, SMALL_TREE_BUDGET, } from './engine.js';
+export type { BatchEngine, CachedEngine, Engine, EnginePreference, Enumeration, EnumerationBudget, SearchRequest, } from './engine.js';
+export { compareDirents, createExcludeMatcher, createGlobMatcher, defaultDirectoryReader, expandSpecPatterns, globBase, globToRegExp, isGlob, toPosix, walkFiles, } from './glob.js';
 export type { DirectoryReader, WalkedFile, WalkOptions } from './glob.js';
+export { createScope, isBinary, mergeLedgers, tallyLedger, LedgerBuilder, DEFAULT_SCOPE, DEFAULT_SKIPPED_DIRECTORIES, MAX_LEDGER_ENTRIES, SCAN_EVERYTHING, UNCERTAIN_REASONS, } from './scope.js';
+export type { ScopeLedger, ScopePolicy, SkippedPath, SkipReason } from './scope.js';
+export { analyzeSource, createImportIndex, extractReferences, resolveSpecifier, tokenize, ANALYSABLE_EXTENSIONS, } from './imports.js';
+export type { AnalysisNote, FileImports, ImportIndex, ModuleReference, ReferenceKind } from './imports.js';
 export { maskCode, parseAttributes, parseDirectives } from './parser.js';
 export type { ParseContext } from './parser.js';
 export { executeAssertion, resolveDirective, runSpecGuard, DEFAULT_CONCURRENCY, DEFAULT_MAX_SNIPPETS, } from './runner.js';
 export type { ResolveContext, RunOptions, RunResult } from './runner.js';
 export { createPainter, formatJson, formatReport, shouldUseAscii, shouldUseColor } from './reporter.js';
 export type { ReporterOptions } from './reporter.js';
-export type { Assertion, AssertionResult, Bounds, Directive, DirectiveError, DirectiveKind, EngineName, MatchLocation, ParseResult, RunReport, RunSummary, SearchOptions, SearchResult, SourceLocation, } from './types.js';
+export type { Assertion, AssertionResult, Bounds, Directive, DirectiveError, DirectiveKind, EngineName, ImportQuery, MatchLocation, ParseResult, RunReport, RunSummary, SearchOptions, SearchResult, SourceLocation, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/F,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,MAAM,EACN,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,OAAO,EACP,SAAS,EACT,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACxG,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,YAAY,EACV,SAAS,EACT,eAAe,EACf,MAAM,EACN,SAAS,EACT,cAAc,EACd,aAAa,EACb,UAAU,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/F,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,MAAM,EACN,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,OAAO,EACP,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EACL,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpF,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3G,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACxG,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,YAAY,EACV,SAAS,EACT,eAAe,EACf,MAAM,EACN,SAAS,EACT,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -12,8 +12,10 @@
  * ```
  */
 export { main, parseArgs, HELP, UsageError, EXIT_OK, EXIT_FAILED, EXIT_ERROR } from './cli.js';
-export { buildJsRegExp, buildRipgrepArgs, canBatchLiterals, createCachedEngine, createRipgrepSink, enumerateCandidates, escapeRegExp, findRipgrep, javascriptEngine, resetRipgrepProbe, resolveEngine, runSearches, scanContent, shouldBatchPatterns, MAX_FILE_SIZE, SMALL_TREE_BUDGET, } from './engine.js';
-export { compareDirents, createGlobMatcher, defaultDirectoryReader, expandSpecPatterns, globBase, globToRegExp, isGlob, toPosix, walkFiles, DEFAULT_IGNORED_DIRECTORIES, } from './glob.js';
+export { buildJsRegExp, buildRipgrepArgs, createCachedEngine, enumerateCandidates, escapeRegExp, findRipgrep, parseRipgrepErrors, isMissingBinary, javascriptEngine, resetRipgrepProbe, resolveEngine, runSearches, scanContent, sortLocations, MAX_FILE_SIZE, SMALL_TREE_BUDGET, } from './engine.js';
+export { compareDirents, createExcludeMatcher, createGlobMatcher, defaultDirectoryReader, expandSpecPatterns, globBase, globToRegExp, isGlob, toPosix, walkFiles, } from './glob.js';
+export { createScope, isBinary, mergeLedgers, tallyLedger, LedgerBuilder, DEFAULT_SCOPE, DEFAULT_SKIPPED_DIRECTORIES, MAX_LEDGER_ENTRIES, SCAN_EVERYTHING, UNCERTAIN_REASONS, } from './scope.js';
+export { analyzeSource, createImportIndex, extractReferences, resolveSpecifier, tokenize, ANALYSABLE_EXTENSIONS, } from './imports.js';
 export { maskCode, parseAttributes, parseDirectives } from './parser.js';
 export { executeAssertion, resolveDirective, runSpecGuard, DEFAULT_CONCURRENCY, DEFAULT_MAX_SNIPPETS, } from './runner.js';
 export { createPainter, formatJson, formatReport, shouldUseAscii, shouldUseColor } from './reporter.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG/F,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAYrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,OAAO,EACP,SAAS,EACT,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG/F,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAWrB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,OAAO,EACP,SAAS,GACV,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAA4C,WAAW,EAAkB,MAAM,YAAY,CAAC;AA0BxG,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwD/C;AA0BD,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUrE;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,CAkDlF"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAA4C,WAAW,EAAkB,MAAM,YAAY,CAAC;AAgDxG,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwD/C;AA0BD,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUrE;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,CAkDlF"}

package/dist/parser.js

@@ -14,10 +14,28 @@
  *     error rather than silently skipped - a typo must never turn into a
  *     silently-passing invariant.
  */
-const KINDS = new Set(['assert-absence', 'assert-count', 'assert-present']);
+const KINDS = new Set([
+    'assert-absence',
+    'assert-count',
+    'assert-present',
+    'assert-import-absence',
+    'assert-import-count',
+]);
 /** Attributes each directive kind accepts. */
 const ALLOWED_ATTRIBUTES = {
-    'assert-absence': new Set(['target', 'symbol', 'expected', 'max', 'glob', 'regex', 'word', 'ignore-case', 'reason']),
+    'assert-absence': new Set([
+        'target',
+        'symbol',
+        'expected',
+        'max',
+        'glob',
+        'exclude',
+        'comments',
+        'regex',
+        'word',
+        'ignore-case',
+        'reason',
+    ]),
     'assert-count': new Set([
         'target',
         'symbol',
@@ -25,12 +43,16 @@ const ALLOWED_ATTRIBUTES = {
         'min',
         'max',
         'glob',
+        'exclude',
+        'comments',
         'regex',
         'word',
         'ignore-case',
         'reason',
     ]),
     'assert-present': new Set(['file', 'reason']),
+    'assert-import-absence': new Set(['target', 'module', 'exclude', 'types', 'expected', 'max', 'reason']),
+    'assert-import-count': new Set(['target', 'module', 'exclude', 'types', 'expected', 'min', 'max', 'reason']),
 };
 const DIRECTIVE_RE = /<!--\s*@([a-zA-Z][\w-]*)([\s\S]*?)-->/g;
 const ATTRIBUTE_RE = /([a-zA-Z][\w-]*)(?:\s*=\s*(?:"((?:\\.|[^"\\])*)"|'((?:\\.|[^'\\])*)'|([^\s"'=<>`]+)))?/g;