@cplieger/deadset-ts 8.0.0-dev.14 → 8.0.0-dev.16

package/dist/src/entry-points.js

@@ -1,513 +0,0 @@
-/**
- * The files a tool or the platform enters without any import naming them: the
- * configuration files a tool loads by their file name and the files their strings
- * name, the test files the runner executes, and a worker a call addresses by a string
- * literal.
- *
- * Each rule is read from the program and nothing else: a file name the tool
- * itself looks for, a literal written in a configuration file, or a literal
- * argument of a call the checker resolves to the platform's own declaration. A
- * value that is not a literal is not evaluated and not guessed, so a file it would
- * have named is entered by nothing here.
- */
-import { isArrayLiteralExpression, isCallExpression, isExportAssignment, isIdentifier, isMetaProperty, isNewExpression, isNoSubstitutionTemplateLiteral, isObjectLiteralExpression, isPropertyAccessExpression, isPropertyAssignment, isStringLiteral, SyntaxKind, } from "@typescript/native/ast";
-import { SymbolFlags } from "@typescript/native/sync";
-import { configurationFiles, filesNamedBy, moduleStrings, } from "./configuration-files.js";
-import { buildScriptEntries } from "./build-scripts.js";
-import { htmlEntries } from "./html-entries.js";
-import { documentEntries } from "./mdx-entries.js";
-import { dirnamePath, relativePath, resolvePath } from "./paths.js";
-import { UNANSWERED } from "./query.js";
-import { computedLoadDirectory, leadingLiteral } from "./unseen-loads.js";
-import { workflowEntries } from "./workflow-steps.js";
-import { unwrapped } from "./unwrap.js";
-import { globExpression } from "./text/glob.js";
-/** The extensions the test runner and the browser-test runner load a configuration from. */
-const MODULE_EXTENSIONS = ["js", "mjs", "cjs", "ts", "mts", "cts"];
-/** The tool file names the configuration form does not cover. */
-const CONVENTIONS = [
-    {
-        rule: "test-runner",
-        stems: ["vitest.workspace", "vitest.projects"],
-        extensions: MODULE_EXTENSIONS,
-        testRunner: true,
-    },
-];
-/** The stem of the browser-test runner's configuration, whose test directory is read. */
-const BROWSER_TEST_CONFIG = "playwright.config";
-/** The browser-test runner's own test-file pattern, which holds where a configuration names none. */
-const BROWSER_TEST_MATCH = "**/*.{spec,test}.{js,ts,jsx,tsx,cjs,cts,cjsx,ctsx,mjs,mts,mjsx,mtsx}";
-/** The members of a test-runner configuration's `test` object that name setup files. */
-const SETUP_MEMBERS = ["setupFiles", "globalSetup"];
-/** A member that moves the directory every path of a test-runner configuration is read from. */
-const ROOT_MEMBER = "root";
-/**
- * A URL reference's scheme. A reference with none that does not start with a solidus is
- * relative, the bare name included: https://url.spec.whatwg.org/#relative-url-string
- */
-const URL_SCHEME = /^[a-z][a-z\d+.-]*:/iu;
-/** The constructors whose first argument addresses a worker script. */
-const WORKER_CONSTRUCTORS = new Set(["Worker", "SharedWorker"]);
-/** The file's name, the last segment of its path. */
-function basename(path) {
-    return path.slice(path.lastIndexOf("/") + 1);
-}
-/** The convention one file name is, with the spelling a root reports it by. */
-function conventionOf(name) {
-    for (const convention of CONVENTIONS) {
-        for (const stem of convention.stems) {
-            if (convention.extensions.some((ext) => name === `${stem}.${ext}`)) {
-                return { convention, spelled: `${stem}.*` };
-            }
-        }
-    }
-    return undefined;
-}
-/** The text a string literal or a template with no substitution denotes. */
-function literalOf(node) {
-    if (node !== undefined && (isStringLiteral(node) || isNoSubstitutionTemplateLiteral(node))) {
-        return node.text;
-    }
-    return undefined;
-}
-/**
- * The object literals one configuration file's default export is written as: the
- * literal itself, or each literal argument of the call it is, at any depth of calls.
- * A default export written as anything else, a name or a computation, yields none,
- * because its value is not in the file's text.
- */
-function configObjects(file) {
-    const found = [];
-    const collect = (node) => {
-        const at = unwrapped(node);
-        if (isObjectLiteralExpression(at)) {
-            found.push(at);
-            return;
-        }
-        if (isCallExpression(at)) {
-            for (const argument of at.arguments) {
-                collect(argument);
-            }
-        }
-    };
-    for (const statement of file.statements) {
-        if (isExportAssignment(statement) && !statement.isExportEquals) {
-            collect(statement.expression);
-        }
-    }
-    return found;
-}
-/**
- * The value one member of an object literal is written with, when it is written as
- * `name: value`, and undefined where the literal writes no such member.
- */
-function memberOf(object, name) {
-    if (!isObjectLiteralExpression(object)) {
-        return undefined;
-    }
-    for (const property of object.properties) {
-        if (isPropertyAssignment(property) &&
-            isIdentifier(property.name) &&
-            property.name.text === name) {
-            return property.initializer;
-        }
-    }
-    return undefined;
-}
-/**
- * The strings one member holds, when it is written as a literal or an array of
- * literals. `undefined` is a value the text does not state.
- */
-function literalsOf(value) {
-    const at = unwrapped(value);
-    const single = literalOf(at);
-    if (single !== undefined) {
-        return [single];
-    }
-    if (!isArrayLiteralExpression(at)) {
-        return undefined;
-    }
-    const found = [];
-    for (const element of at.elements) {
-        const text = literalOf(unwrapped(element));
-        if (text === undefined) {
-            return undefined;
-        }
-        found.push(text);
-    }
-    return found;
-}
-/**
- * Whether a literal is a relative URL reference, which is also how the test runner reads a
- * setup file's path against its root.
- */
-function isRelative(text) {
-    return text !== "" && !text.startsWith("/") && !URL_SCHEME.test(text);
-}
-/** Whether a module specifier is relative, which a bare name is not: it names a package. */
-function isModuleRelative(text) {
-    return text.startsWith("./") || text.startsWith("../");
-}
-/** A URL reference with its query and its fragment removed, which name no part of the file. */
-function pathPart(text) {
-    const cut = text.search(/[?#]/u);
-    return cut < 0 ? text : text.slice(0, cut);
-}
-/** The own files one relative literal names, read against a directory. */
-function filesNamed(files, dir, text) {
-    if (!isRelative(text)) {
-        return [];
-    }
-    return files.named(resolvePath(dir, pathPart(text)));
-}
-/** Whether one file name is the browser-test runner's configuration. */
-function isBrowserTestConfig(name) {
-    return MODULE_EXTENSIONS.some((ext) => name === `${BROWSER_TEST_CONFIG}.${ext}`);
-}
-/**
- * The files the configuration files of one project enter: each configuration module,
- * with what it exports, and each own file a relative string of a configuration module
- * or a JSON configuration file names, read against that file's directory. A string at a
- * selection key of an applied convention row names no file.
- */
-function configurationEntries(host, targetRoot, files, parse, selected) {
-    const { modules, documents, outside } = configurationFiles(host, targetRoot, files, parse);
-    const found = [];
-    const unselected = (file) => {
-        const starts = selected.get(file.fileName)?.starts;
-        return moduleStrings(file)
-            .filter((one) => starts?.has(one.node.getStart()) !== true)
-            .map((one) => one.text);
-    };
-    const unselectedIn = (path, texts) => {
-        const left = [...(selected.get(path)?.texts ?? [])];
-        return texts.filter((text) => {
-            const at = left.indexOf(text);
-            if (at < 0) {
-                return true;
-            }
-            left.splice(at, 1);
-            return false;
-        });
-    };
-    const strings = (dir, texts) => {
-        for (const text of texts) {
-            for (const file of filesNamedBy(files, dir, text)) {
-                found.push({ file, rule: "configuration-string", source: text, exports: true });
-            }
-        }
-    };
-    for (const { file, form } of modules) {
-        found.push({ file, rule: "configuration-file", source: form, exports: true });
-        strings(dirnamePath(file.fileName), unselected(file));
-    }
-    for (const document of documents) {
-        strings(dirnamePath(document.path), unselectedIn(document.path, document.strings));
-    }
-    for (const { file } of outside) {
-        strings(dirnamePath(file.fileName), unselected(file));
-    }
-    return found;
-}
-/**
- * The setup files one test-runner configuration names: every literal under
- * `test.setupFiles` and `test.globalSetup`, read against the configuration's own
- * directory. A configuration that moves its root names them against a directory its
- * text may not state, so none is read from it.
- */
-function setupFilesOf(file, files) {
-    const objects = configObjects(file);
-    const tests = objects
-        .map((object) => memberOf(object, "test"))
-        .filter((value) => value !== undefined)
-        .map(unwrapped);
-    if ([...objects, ...tests].some((object) => memberOf(object, ROOT_MEMBER) !== undefined)) {
-        return [];
-    }
-    const dir = dirnamePath(file.fileName);
-    const found = [];
-    for (const test of tests) {
-        for (const name of SETUP_MEMBERS) {
-            const value = memberOf(test, name);
-            for (const text of value === undefined ? [] : (literalsOf(value) ?? [])) {
-                for (const named of filesNamed(files, dir, text)) {
-                    found.push({ file: named, rule: "test-runner", source: text, exports: false });
-                }
-            }
-        }
-    }
-    return found;
-}
-/**
- * The test files one browser-test configuration names: every own file below its
- * test directory that its test-file pattern matches. The directory is the literal
- * `testDir` reads against the configuration's directory, or that directory where no
- * object of the configuration writes one; the pattern is the literal `testMatch`, or
- * the runner's own where none is written. A member whose value is not a literal
- * leaves the set unknown, and an unknown set enters nothing.
- */
-function browserTestsOf(file, files) {
-    const objects = configObjects(file);
-    if (objects.length === 0) {
-        return [];
-    }
-    let testDir = ".";
-    let patterns = [BROWSER_TEST_MATCH];
-    for (const object of objects) {
-        const dir = memberOf(object, "testDir");
-        if (dir !== undefined) {
-            testDir = literalOf(unwrapped(dir));
-        }
-        const match = memberOf(object, "testMatch");
-        if (match !== undefined) {
-            patterns = literalsOf(match);
-        }
-    }
-    if (testDir === undefined || patterns === undefined) {
-        return [];
-    }
-    const under = resolvePath(dirnamePath(file.fileName), testDir);
-    const found = [];
-    for (const pattern of patterns) {
-        const expression = globExpression(pattern);
-        for (const candidate of files.byName.values()) {
-            const below = relativePath(under, candidate.fileName);
-            if (below !== undefined && expression.test(below)) {
-                found.push({ file: candidate, rule: "browser-tests", source: pattern, exports: false });
-            }
-        }
-    }
-    return found;
-}
-/**
- * The address one worker argument writes: a relative literal, or a `URL` built from
- * a literal against `import.meta.url`. Any other argument is computed and addresses
- * nothing the text states.
- */
-function workerAddress(argument) {
-    if (argument === undefined) {
-        return undefined;
-    }
-    const at = unwrapped(argument);
-    const literal = literalOf(at);
-    if (literal !== undefined) {
-        return { literal, names: [] };
-    }
-    if (!isNewExpression(at) || !isIdentifier(at.expression) || at.expression.text !== "URL") {
-        return undefined;
-    }
-    const [reference, base] = at.arguments ?? [];
-    const text = literalOf(reference === undefined ? undefined : unwrapped(reference));
-    if (text === undefined || base === undefined) {
-        return undefined;
-    }
-    const meta = unwrapped(base);
-    if (!isPropertyAccessExpression(meta) ||
-        !isMetaProperty(meta.expression) ||
-        !isIdentifier(meta.name) ||
-        meta.name.text !== "url") {
-        return undefined;
-    }
-    return { literal: text, names: [at.expression] };
-}
-/**
- * Every call one file writes that addresses a worker: `new Worker(...)`,
- * `new SharedWorker(...)` and `navigator.serviceWorker.register(...)`, each with an
- * address its text states.
- */
-function workerSitesOf(file) {
-    const found = [];
-    const visit = (node) => {
-        if (isNewExpression(node) &&
-            isIdentifier(node.expression) &&
-            WORKER_CONSTRUCTORS.has(node.expression.text)) {
-            const address = workerAddress(node.arguments?.[0]);
-            if (address !== undefined) {
-                found.push({
-                    literal: address.literal,
-                    platformNames: [node.expression, ...address.names],
-                });
-            }
-        }
-        if (isCallExpression(node)) {
-            const callee = node.expression;
-            if (isPropertyAccessExpression(callee) &&
-                isIdentifier(callee.name) &&
-                callee.name.text === "register" &&
-                isPropertyAccessExpression(callee.expression) &&
-                isIdentifier(callee.expression.name) &&
-                callee.expression.name.text === "serviceWorker" &&
-                isIdentifier(callee.expression.expression) &&
-                callee.expression.expression.text === "navigator") {
-                const address = workerAddress(node.arguments[0]);
-                if (address !== undefined) {
-                    found.push({
-                        literal: address.literal,
-                        platformNames: [callee.expression.expression, ...address.names],
-                    });
-                }
-            }
-        }
-        node.forEachChild(visit);
-    };
-    file.forEachChild(visit);
-    return found;
-}
-/**
- * The workers one file addresses. A call's names must resolve to a symbol the platform
- * declares, which a file of the target may augment and no import brings in; a name only
- * the target declares is the target's own constructor or object, which addresses no
- * worker this rule knows. One batch per file that writes such a call.
- */
-function workersOf(project, file, files) {
-    const sites = workerSitesOf(file);
-    if (sites.length === 0) {
-        return [];
-    }
-    const names = sites.flatMap((site) => site.platformNames);
-    const symbols = project.symbolsAt(names.map((name) => project.handle(name)));
-    const platform = new Set();
-    // A name the checker could not resolve is read as the platform's, so a worker it
-    // stands on is rooted rather than reported.
-    names.forEach((name, index) => {
-        const symbol = symbols[index];
-        if (symbol === UNANSWERED) {
-            platform.add(name);
-            return;
-        }
-        if (symbol !== undefined &&
-            (symbol.flags & SymbolFlags.Alias) === 0 &&
-            symbol.declarations.some((handle) => !files.byName.has(handle.path))) {
-            platform.add(name);
-        }
-    });
-    const dir = dirnamePath(file.fileName);
-    const found = [];
-    for (const site of sites) {
-        if (!site.platformNames.every((name) => platform.has(name))) {
-            continue;
-        }
-        for (const named of filesNamed(files, dir, site.literal)) {
-            found.push({ file: named, rule: "worker", source: site.literal, exports: false });
-        }
-    }
-    return found;
-}
-/** Whether one call is `import.meta.glob(...)`. */
-function isMetaGlob(node) {
-    if (!isCallExpression(node) || !isPropertyAccessExpression(node.expression)) {
-        return false;
-    }
-    const { expression, name } = node.expression;
-    return (isIdentifier(name) &&
-        name.text === "glob" &&
-        isMetaProperty(expression) &&
-        expression.keywordToken === SyntaxKind.ImportKeyword);
-}
-/**
- * The files one file loads by a computed path, each with what exports: every own file
- * below the directory a relative literal start of an `import()` or `require()` argument
- * names, other than the calling file's own directory or one holding it, which would name
- * every sibling, and
- * every own file a relative literal glob of `import.meta.glob` matches, both read against
- * the calling file's directory, as a bundler's context module reads them.
- */
-function computedImportsOf(file, files) {
-    const dir = dirnamePath(file.fileName);
-    const found = [];
-    const below = (prefix) => {
-        const target = computedLoadDirectory(dir, prefix);
-        if (target === undefined) {
-            return;
-        }
-        for (const candidate of files.byName.values()) {
-            if (candidate !== file && relativePath(target, candidate.fileName) !== undefined) {
-                found.push({ file: candidate, rule: "computed-import", source: prefix, exports: true });
-            }
-        }
-    };
-    const globbed = (pattern) => {
-        if (!isModuleRelative(pattern)) {
-            return;
-        }
-        const expression = globExpression(resolvePath(dir, pattern));
-        for (const candidate of files.byName.values()) {
-            if (candidate !== file && expression.test(candidate.fileName)) {
-                found.push({ file: candidate, rule: "computed-import", source: pattern, exports: true });
-            }
-        }
-    };
-    const visit = (node) => {
-        if (isCallExpression(node)) {
-            const [first] = node.arguments;
-            const callee = node.expression;
-            const loads = callee.kind === SyntaxKind.ImportKeyword ||
-                (isIdentifier(callee) && callee.text === "require");
-            if (loads && first !== undefined) {
-                const prefix = leadingLiteral(first);
-                if (prefix !== undefined) {
-                    below(prefix);
-                }
-            }
-            else if (isMetaGlob(node) && first !== undefined) {
-                for (const pattern of literalsOf(first) ?? []) {
-                    globbed(pattern);
-                }
-            }
-        }
-        node.forEachChild(visit);
-    };
-    file.forEachChild(visit);
-    return found;
-}
-/**
- * Every file of one project the rules enter, in no particular order and possibly more
- * than once: a file two rules enter appears once per rule.
- *
- * `testFiles` is the configuration's test-file patterns, matched against each
- * file's path below the target root; a file one of them matches is a test file the
- * runner executes.
- */
-export function entryPoints(project, files, testFiles, host, targetRoot, parse, selected = new Map()) {
-    const found = [...configurationEntries(host, targetRoot, files, parse, selected)];
-    const tests = testFiles.map((pattern) => ({ pattern, expression: globExpression(pattern) }));
-    for (const [path, file] of files.byPath) {
-        const name = basename(path);
-        const named = conventionOf(name);
-        if (named !== undefined) {
-            found.push({ file, rule: named.convention.rule, source: named.spelled, exports: true });
-            if (named.convention.testRunner) {
-                found.push(...setupFilesOf(file, files));
-            }
-        }
-        if (isBrowserTestConfig(name)) {
-            found.push(...browserTestsOf(file, files));
-        }
-        for (const { pattern, expression } of tests) {
-            if (expression.test(path)) {
-                found.push({ file, rule: "test-runner", source: pattern, exports: false });
-            }
-        }
-        found.push(...workersOf(project, file, files));
-        found.push(...computedImportsOf(file, files));
-    }
-    for (const { file, source } of htmlEntries(host, targetRoot, files, parse)) {
-        found.push({ file, rule: "html-entry", source, exports: true });
-    }
-    for (const { file, source, names } of documentEntries(host, targetRoot, files)) {
-        found.push({
-            file,
-            rule: "document-import",
-            source,
-            exports: true,
-            ...(names === undefined ? {} : { names }),
-        });
-    }
-    for (const { file, source } of buildScriptEntries(host, targetRoot, files, parse)) {
-        found.push({ file, rule: "bundler-entry", source, exports: true });
-    }
-    for (const { file, source } of workflowEntries(host, targetRoot, files)) {
-        found.push({ file, rule: "workflow-step", source, exports: true });
-    }
-    return found;
-}