@cplieger/deadset-ts 8.0.0-dev.7 → 8.0.0-dev.8

package/dist/bin/node-host.js

@@ -1,5 +1,5 @@
 import { randomBytes } from "node:crypto";
-import { closeSync, fchmodSync, fsyncSync, mkdtempSync, openSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeSync, } from "node:fs";
+import { closeSync, fchmodSync, fsyncSync, mkdtempSync, openSync, readdirSync, readFileSync, readSync, realpathSync, renameSync, rmSync, statSync, writeSync, } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename, dirname, extname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -77,6 +77,21 @@ function writeAtomically(path, pieces) {
         throw error;
     }
 }
+/** The text of a file's first `limit` bytes, or of all of it where it holds fewer. */
+function readHead(path, limit) {
+    const bytes = Buffer.alloc(limit);
+    const fd = openSync(path, "r");
+    try {
+        let held = 0;
+        for (let got = -1; got !== 0 && held < limit; held += got) {
+            got = readSync(fd, bytes, held, limit - held, null);
+        }
+        return bytes.toString("utf8", 0, held);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
 /** A new directory under the platform's temporary directory. */
 function temporaryDirectory() {
     const path = mkdtempSync(join(tmpdir(), `${PRODUCT}-mapper-`));
@@ -106,7 +121,7 @@ function componentMapperCommand() {
 export function nodeHost() {
     return {
         workingDirectory: () => process.cwd(),
-        readFile: (path) => readFileSync(path, "utf8"),
+        readFile: (path, limit) => limit === undefined ? readFileSync(path, "utf8") : readHead(path, limit),
         readDirectory: (path) => readdirSync(path, { withFileTypes: true }).map((entry) => ({
             name: entry.name,
             directory: entry.isDirectory(),
@@ -116,7 +131,10 @@ export function nodeHost() {
             if (stat === undefined) {
                 return "absent";
             }
-            return stat.isDirectory() ? "directory" : "file";
+            if (stat.isDirectory()) {
+                return "directory";
+            }
+            return stat.isFile() ? "file" : "other";
         },
         realPath: (path) => realpathSync(path),
         analyzerVersion: () => {

package/dist/src/analysis.js

@@ -56,7 +56,6 @@ import { ownErrors, workspaceRun } from "./workspace-run.js";
 import { bytewise } from "./text/compare.js";
 import { holdsManifest, inInstalledPackages, MANIFEST, manifestAt } from "./fs/manifest.js";
 import { globExpression } from "./text/glob.js";
-import { LANGUAGE } from "./product.js";
 /** The setting whose source decides where a finding about a configured root sits. */
 const ROOTS_SETTING = "roots.patterns";
 /**
@@ -141,13 +140,13 @@ function readProjects(engine, host, scope, config, stage) {
     // The nested packages are known only once every program is open, and every visit reads
     // the conventions and options they decide, so both are set in the session's first step.
     let nestedDirs = [];
-    let conventions = readConventions(host, parse, [], config.ts.disabledConventions);
+    let conventions = readConventions(host, parse, [], config.ts.disabled_conventions);
     let options;
     const readManifests = (opened) => {
         nestedDirs = nestedPackageDirs(host, normalizePath(absoluteRoot), opened
             .filter((one) => !consumerOf.has(one.configFile))
             .flatMap((one) => [one.configFile, ...one.fileNames()]), new Set(memberDirs));
-        conventions = readConventions(host, parse, conventionManifests(host, absoluteRoot, memberDirs, nestedDirs), config.ts.disabledConventions);
+        conventions = readConventions(host, parse, conventionManifests(host, absoluteRoot, memberDirs, nestedDirs), config.ts.disabled_conventions);
         options = {
             host,
             manifest: workspace?.manifest ?? readManifest(host, targetRoot),
@@ -155,12 +154,12 @@ function readProjects(engine, host, scope, config, stage) {
                 ...(workspace?.entries ?? []),
                 ...packageEntries(host, normalizePath(absoluteRoot), nestedDirs),
             ],
-            patterns: config.rootPatterns,
-            entryFiles: config.ts.entryFiles,
+            patterns: config.roots.patterns,
+            entryFiles: config.ts.entry_files,
             conventions,
-            testFiles: config.ts.testFiles,
+            testFiles: config.ts.test_files,
             parse,
-            publishedAPI: config.targetKind !== "" && kindOf(config.targetKind, LANGUAGE) === "library",
+            publishedAPI: config.target.kind !== undefined && kindOf(config.target.kind) === "library",
             publishedMembers: new Set((workspace?.entries ?? []).filter((entry) => entry.published).map((entry) => entry.dir)),
             runFiles: new Set(opened.flatMap((one) => one.fileNames().map((name) => resolvePath(host.workingDirectory(), name)))),
         };
@@ -190,7 +189,7 @@ function readProjects(engine, host, scope, config, stage) {
             unbuildable.push(...met);
         }
     };
-    const testPatterns = config.ts.testFiles.map(globExpression);
+    const testPatterns = config.ts.test_files.map(globExpression);
     const joins = discovered.derived
         ? joinedTestFiles(engine, host, absoluteRoot, discovered.configFiles, testPatterns)
         : new Map();
@@ -399,7 +398,7 @@ export function runRoots(engine, host, scope, config, provenance) {
     const ordered = [...merged.values()].sort((a, b) => byPosition(a.position, b.position) ||
         bytewise(a.kind, b.kind) ||
         bytewise(a.source, b.source));
-    const unmatched = unmatchedEverywhere(config.rootPatterns, projects.map((answer) => answer.rooted));
+    const unmatched = unmatchedEverywhere(config.roots.patterns, projects.map((answer) => answer.rooted));
     return {
         configurations,
         roots: ordered,
@@ -468,13 +467,13 @@ function readRun(engine, host, scope, config, mode, detectors, extra) {
     const targetRoot = scope.target.path;
     const disabled = disabledClasses(config);
     const templates = disabled.has("template-field")
-        ? { delimiters: config.analysis.templateDelimiters, files: [] }
+        ? { delimiters: config.analysis.template_delimiters, files: [] }
         : readTemplates(host, targetRoot, config.analysis);
     const consumers = scope.consumers.map((consumer) => consumer.path);
     const read = readProjects(engine, host, scope, config, (project, opened) => {
         const projectRead = opened.read();
         const resolved = references(project, projectRead.held, targetRoot, {
-            testFiles: config.ts.testFiles,
+            testFiles: config.ts.test_files,
             testFileNames: projectRead.testFileNames,
         });
         const evidence = evidenceRecords({
@@ -484,7 +483,7 @@ function readRun(engine, host, scope, config, mode, detectors, extra) {
             templates,
             ts: config.ts,
             consumers,
-            ...(config.analysis.generatedFiles === "include"
+            ...(config.analysis.generated_files === "include"
                 ? {}
                 : { generated: projectRead.generated }),
         }, detectors, disabled);
@@ -904,7 +903,7 @@ function readAnalysis(engine, host, scope, config, provenance, mode, detectors)
                 id: one.configured.configuration,
                 configFile: one.configFile,
             })),
-            testFileRules: testFileRulesOf(config.ts.testFiles, read.projects.flatMap((one) => one.configured.testFiles), read.projects.flatMap((one) => one.configured.supportFiles ?? [])),
+            testFileRules: testFileRulesOf(config.ts.test_files, read.projects.flatMap((one) => one.configured.testFiles), read.projects.flatMap((one) => one.configured.supportFiles ?? [])),
             typeErrorSkips: read.projects.flatMap((one) => one.typeErrorSkips),
             componentWarnings: [
                 ...new Map(read.projects
@@ -934,7 +933,7 @@ function inputsOver(host, scope, config, provenance, mode, read, documents) {
     };
     const facts = {
         refusals: suppressions.refusals,
-        unmatchedRoots: unmatchedEverywhere(config.rootPatterns, read.projects.map((one) => one.extra.rooted)),
+        unmatchedRoots: unmatchedEverywhere(config.roots.patterns, read.projects.map((one) => one.extra.rooted)),
         rootsDocument: documentOf(host, provenance, ROOTS_SETTING, targetRoot),
         unmatchedDeclarations: configuredDeclarations(config)
             .filter((_, at) => !read.projects.some((one) => one.extra.declarationsNamed[at] === true))

package/dist/src/config.js

@@ -1,75 +1,18 @@
-import { CONTRACT_VERSION, } from "./contract/contract.generated.js";
-import { LANGUAGE, PRODUCT } from "./product.js";
+import { SEVERITIES } from "./contract/contract.generated.js";
+import { LANGUAGE } from "./product.js";
 /**
  * The name of the repository configuration at the target root, which is also the
  * document a finding about the configuration names where no document of the
  * target supplied the setting it is about.
  */
 export const REPOSITORY_DOCUMENT = "deadset.json";
-/** The kind a target kind setting gives one language's declarations. */
-export function kindOf(setting, language) {
-    return typeof setting === "string" ? setting : setting[language];
+/** The kind a target kind setting gives this analyzer's declarations. */
+export function kindOf(kind) {
+    return typeof kind === "string" ? kind : kind[LANGUAGE];
 }
-/** The severities ranked, the strongest highest. */
-const SEVERITY_RANK = { allow: 0, warn: 1, deny: 2 };
 /** Whether a finding at one severity fails a run under the failing severity. */
 export function fails(severity, failOn) {
-    return SEVERITY_RANK[severity] >= SEVERITY_RANK[failOn];
-}
-/**
- * The configuration every documented default states. `targetKind` is empty: the
- * field has no default and is never inferred.
- */
-export function defaultConfig() {
-    return {
-        contractVersion: CONTRACT_VERSION,
-        targetKind: "",
-        analysis: {
-            languages: [],
-            minConfidence: "probable",
-            generatedFiles: "exclude",
-            consumerTests: "test",
-            configurations: [],
-            matrixComplete: false,
-            templateDirs: [],
-            templateDelimiters: { left: "{{", right: "}}" },
-        },
-        consumersComplete: false,
-        rootPatterns: [],
-        severity: new Map(),
-        exemptionsDisabled: [],
-        reporters: {
-            formats: ["text"],
-            sort: "position",
-            cascade: "roots",
-            maxFindings: 0,
-            failOn: "deny",
-        },
-        providers: {
-            analyzers: [
-                { shape: "installed", name: "deadset-go", languages: ["go"], command: "deadset-go" },
-                { shape: "installed", name: PRODUCT, languages: [LANGUAGE], command: PRODUCT },
-            ],
-        },
-        ts: {
-            testFiles: [
-                "**/*.test.{ts,tsx,mts,cts}",
-                "**/*.test-d.{ts,tsx,mts,cts}",
-                "**/*.spec-d.{ts,tsx,mts,cts}",
-                "**/*.spec.*",
-                "**/__tests__/**",
-                "**/__mocks__/**",
-                "**/test-d/**",
-            ],
-            entryFiles: [],
-            componentExtensions: [".vue", ".svelte", ".astro"],
-            disabledConventions: [],
-            injectionRegistrations: [],
-            lifecycleContracts: [],
-            serializers: [],
-            rootsComplete: false,
-        },
-    };
+    return SEVERITIES.indexOf(severity) >= SEVERITIES.indexOf(failOn);
 }
 /**
  * Renders the origin as the provenance value the Contract declares: `default`,
@@ -78,23 +21,3 @@ export function defaultConfig() {
 export function renderOrigin(origin) {
     return origin.source === "default" ? "default" : `${origin.source}: ${origin.label}`;
 }
-/**
- * Every refusal configuration resolution makes. Each maps to the usage exit
- * code, and each is thrown rather than returned: a refusal ends the run, and the
- * one caller that turns it into an exit code is the command line.
- */
-export class ConfigError extends Error {
-    /** Which refusal this is. */
-    kind;
-    /**
-     * The key or field the message names, spelled as the document spells it. It is
-     * empty when the refusal names none.
-     */
-    key;
-    constructor(kind, key, message) {
-        super(message);
-        this.name = "ConfigError";
-        this.kind = kind;
-        this.key = key;
-    }
-}

package/dist/src/configured-declarations.js

@@ -179,19 +179,19 @@ export function resolveEntries(project, held, entries) {
     for (const symbol of held.symbols) {
         byRef.set(symbol.ref, [...(byRef.get(symbol.ref) ?? []), symbol.id]);
     }
-    const modules = modulesNamed(project, new Set(entries.flatMap((entry) => (entry.shape === "module" ? [entry.module] : []))));
+    const modules = modulesNamed(project, new Set(entries.flatMap((entry) => ("module" in entry ? [entry.module] : []))));
     return entries.map((entry) => {
-        if (entry.shape === "symbol") {
+        if ("symbol" in entry) {
             return { entry, handles: new Set(), ids: new Set(byRef.get(entry.symbol) ?? []) };
         }
-        const { components, static: isStatic } = componentsOf(entry.shape === "module" ? entry.name : entry.global);
+        const { components, static: isStatic } = componentsOf("module" in entry ? entry.name : entry.global);
         const [first = "", ...rest] = components;
         let start;
         if (isStatic && rest.length === 0) {
             // Only a member is static, and a path of one component names no member.
             start = undefined;
         }
-        else if (entry.shape === "module") {
+        else if ("module" in entry) {
             const module = modules.get(entry.module);
             start = module === undefined ? undefined : memberOf(project, module, first, false);
         }
@@ -246,14 +246,10 @@ export function entriesAt(project, chains, nodes, resolved) {
  * program the display name the inventory gives it.
  */
 export function spelledEntry(entry, held) {
-    switch (entry.shape) {
-        case "symbol":
-            return held.symbols.find((symbol) => symbol.ref === entry.symbol)?.name ?? entry.symbol;
-        case "module":
-            return entry.name;
-        case "global":
-            return entry.global;
+    if ("symbol" in entry) {
+        return held.symbols.find((symbol) => symbol.ref === entry.symbol)?.name ?? entry.symbol;
     }
+    return "module" in entry ? entry.name : entry.global;
 }
 /** The key under which a lifecycle contract's declarations are configured. */
 const LIFECYCLE_KEY = "ts.lifecycle_contracts";
@@ -264,11 +260,14 @@ const LIFECYCLE_KEY = "ts.lifecycle_contracts";
  */
 export function configuredDeclarations(config) {
     return [
-        ...config.ts.injectionRegistrations.map((entry) => ({
+        ...config.ts.injection_registrations.map((entry) => ({
             key: "ts.injection_registrations",
             entry,
         })),
-        ...config.ts.lifecycleContracts.flatMap((contract) => [...contract.components, ...contract.bases].map((entry) => ({ key: LIFECYCLE_KEY, entry }))),
+        ...config.ts.lifecycle_contracts.flatMap((contract) => [...(contract.components ?? []), ...(contract.bases ?? [])].map((entry) => ({
+            key: LIFECYCLE_KEY,
+            entry,
+        }))),
         ...config.ts.serializers.map((entry) => ({ key: "ts.serializers", entry })),
     ];
 }
@@ -294,12 +293,8 @@ export function declarationsNamed(project, held, configured) {
  * sign and its name, and a global entry's path after a number sign.
  */
 export function configuredRef(entry) {
-    switch (entry.shape) {
-        case "symbol":
-            return entry.symbol;
-        case "module":
-            return `${entry.module}#${entry.name}`;
-        case "global":
-            return `#${entry.global}`;
+    if ("symbol" in entry) {
+        return entry.symbol;
     }
+    return "module" in entry ? `${entry.module}#${entry.name}` : `#${entry.global}`;
 }

package/dist/src/consumers.js

@@ -39,10 +39,10 @@ export function consumerLoads(engine, host, scope, targetConfigFiles) {
 export function consumerReferences(project, host, targetRoot, consumer, config) {
     const held = inventory(narrowedTo(project, (file) => relativePath(targetRoot, file.fileName) !== undefined), host, targetRoot);
     const found = references(project, held, targetRoot, {
-        testFiles: config.ts.testFiles,
+        testFiles: config.ts.test_files,
         consumer,
     }).references;
-    if (config.analysis.consumerTests !== "production") {
+    if (config.analysis.consumer_tests !== "production") {
         return found;
     }
     return found.map((reference) => (reference.test ? { ...reference, test: false } : reference));