@cplieger/deadset-ts 8.0.0-dev.1 → 8.0.0-dev.11

package/dist/src/convention-rows.js

@@ -10,8 +10,8 @@ const SCRIPT = "{js,jsx,ts,tsx}";
 const MODULE = "{js,mjs,ts,mts}";
 const ANY_MODULE = "{js,mjs,cjs,ts,mts,cts}";
 const VITE_CONFIG = `vite.config.${ANY_MODULE}`;
-/** The legacy configuration files of ESLint that hold JSON or a CommonJS module. */
-const ESLINTRC = [".eslintrc", ".eslintrc.json", ".eslintrc.{js,cjs}"];
+/** The legacy configuration files of ESLint: JSON, YAML or a CommonJS module. */
+const ESLINTRC = [".eslintrc", ".eslintrc.json", ".eslintrc.{yml,yaml}", ".eslintrc.{js,cjs}"];
 const SVELTEKIT_ROUTE_FILES = "+{page,layout,server,page.server,layout.server,error}";
 /** SvelteKit's entries other than its parameter matchers. */
 const SVELTEKIT_ENTRIES = [
@@ -61,6 +61,50 @@ const ANGULAR_PACKAGE_KEYS = [
     "styles",
     "scripts",
 ].map((key) => ({ key, files: ["angular.json"] }));
+/**
+ * The row of a code generator that writes its output below one directory its
+ * configuration's `property` sets, `fallback` where no configuration file sets it, so
+ * every file there is a generated file.
+ */
+function outputDirectoryRow(row) {
+    return {
+        name: row.name,
+        package: row.package,
+        range: row.range,
+        entries: [],
+        generated: ["<output>"],
+        moves: [
+            {
+                id: "output",
+                defaults: [row.fallback],
+                readings: [{ property: row.property, files: row.files }],
+            },
+        ],
+    };
+}
+/**
+ * The test runners and the assertion, mock and runner libraries whose import is test
+ * evidence beside each runner a row reads test files for. Each applies whether or not a
+ * manifest declares it, so none is a row.
+ */
+export const TEST_LIBRARIES = [
+    "@jest/globals",
+    "@playwright/test",
+    "ava",
+    "chai",
+    "expect",
+    "jasmine",
+    "jest",
+    "mocha",
+    "msw",
+    "nock",
+    "node:test",
+    "sinon",
+    "tap",
+    "uvu",
+];
+/** The scopes every package of which is a test library. */
+export const TEST_LIBRARY_SCOPES = ["@testing-library/"];
 /** Every row, ordered by name and then by range. */
 export const CONVENTION_ROWS = [
     {
@@ -81,6 +125,7 @@ export const CONVENTION_ROWS = [
     },
     {
         name: "astro",
+        bundles: true,
         package: "astro",
         range: ">=5.0.0 <8.0.0",
         entries: [
@@ -126,6 +171,7 @@ export const CONVENTION_ROWS = [
         range: ">=4.0.0 <10.0.0",
         entries: [],
         moves: [],
+        packageKeys: [{ key: "parser", files: ESLINTRC }],
         prefixedNames: [
             { property: "plugins", files: ESLINTRC, prefix: "eslint-plugin" },
             { property: "extends", files: ESLINTRC, prefix: "eslint-plugin", marker: "plugin:" },
@@ -149,12 +195,13 @@ export const CONVENTION_ROWS = [
     {
         name: "expo-router",
         package: "expo-router",
-        range: ">=3.0.0 <58.0.0",
+        range: ">=3.0.0 <59.0.0",
         entries: [`{,src/}app/**/*.${SCRIPT}`],
         moves: [],
     },
     {
         name: "next",
+        bundles: true,
         package: "next",
         range: ">=13.4.0 <17.0.0",
         generated: [".next"],
@@ -172,6 +219,7 @@ export const CONVENTION_ROWS = [
     },
     {
         name: "nuxt",
+        bundles: true,
         package: "nuxt",
         range: ">=3.0.0 <5.0.0",
         generated: [".nuxt"],
@@ -241,8 +289,17 @@ export const CONVENTION_ROWS = [
             { key: "oclif.hooks", directory: false },
         ],
     },
+    outputDirectoryRow({
+        name: "panda",
+        package: "@pandacss/dev",
+        range: ">=0.1.0 <2.0.0",
+        files: [`panda.config.${ANY_MODULE}`],
+        property: "outdir",
+        fallback: "styled-system",
+    }),
     {
         name: "parcel",
+        bundles: true,
         package: "parcel",
         range: ">=2.0.0 <3.0.0",
         entries: [],
@@ -308,6 +365,13 @@ export const CONVENTION_ROWS = [
             },
         ],
     },
+    {
+        name: "react-scripts",
+        package: "react-scripts",
+        range: ">=1.0.0 <6.0.0",
+        entries: [`src/index.${SCRIPT}`, "src/setupProxy.js", `src/setupTests.${SCRIPT}`],
+        moves: [],
+    },
     {
         name: "remix",
         package: "@remix-run/dev",
@@ -335,6 +399,7 @@ export const CONVENTION_ROWS = [
     },
     {
         name: "rolldown",
+        bundles: true,
         package: "rolldown",
         range: ">=1.0.0 <2.0.0",
         entries: [],
@@ -380,6 +445,7 @@ export const CONVENTION_ROWS = [
     },
     {
         name: "storybook",
+        bundles: true,
         package: "storybook",
         range: ">=7.0.0 <11.0.0",
         entries: [
@@ -413,6 +479,7 @@ export const CONVENTION_ROWS = [
     },
     {
         name: "sveltekit",
+        bundles: true,
         package: "@sveltejs/kit",
         range: ">=2.0.0 <3.0.0",
         entries: [...SVELTEKIT_ENTRIES, "<params>/*.{js,ts}"],
@@ -478,6 +545,7 @@ export const CONVENTION_ROWS = [
     },
     {
         name: "sveltekit",
+        bundles: true,
         package: "@sveltejs/kit",
         range: ">=3.0.0 <4.0.0",
         entries: [...SVELTEKIT_ENTRIES, "<params>.{js,ts}"],
@@ -570,6 +638,7 @@ export const CONVENTION_ROWS = [
     },
     {
         name: "vite",
+        bundles: true,
         package: "vite",
         range: ">=8.0.0 <9.0.0",
         entries: [],
@@ -585,6 +654,7 @@ export const CONVENTION_ROWS = [
     },
     {
         name: "vitepress",
+        bundles: true,
         package: "vitepress",
         range: ">=1.0.0 <2.0.0-0 || >=2.0.0-alpha.0 <3.0.0",
         entries: [

package/dist/src/conventions.js

@@ -5,34 +5,30 @@
  * directory a configuration property moves read from the property's literal value.
  * No configuration file is run.
  */
-import { isArrayLiteralExpression, isAsExpression, isBinaryExpression, isCallExpression, isClassDeclaration, isComputedPropertyName, isExportAssignment, isExportDeclaration, isExpressionStatement, isFunctionDeclaration, isIdentifier, isImportDeclaration, isNamedExports, isNamespaceImport, isNoSubstitutionTemplateLiteral, isNonNullExpression, isNumericLiteral, isObjectBindingPattern, isObjectLiteralExpression, isParenthesizedExpression, isPropertyAccessExpression, isPropertyAssignment, isSatisfiesExpression, isShorthandPropertyAssignment, isSpreadAssignment, isStringLiteral, isVariableStatement, SyntaxKind, } from "@typescript/native/ast";
+import { isArrayLiteralExpression, isBinaryExpression, isCallExpression, isClassDeclaration, isComputedPropertyName, isExportAssignment, isExportDeclaration, isExpressionStatement, isFunctionDeclaration, isIdentifier, isImportDeclaration, isNamedExports, isNamespaceImport, isNoSubstitutionTemplateLiteral, isNumericLiteral, isObjectBindingPattern, isObjectLiteralExpression, isPropertyAccessExpression, isPropertyAssignment, isShorthandPropertyAssignment, isSpreadAssignment, isStringLiteral, isVariableStatement, SyntaxKind, } from "@typescript/native/ast";
 import { lineOf } from "./component-files.js";
 import { CONVENTION_ROWS, } from "./convention-rows.js";
 import { documentStrings } from "./configuration-files.js";
-import { globExpression } from "./glob.js";
-import { dirnamePath, joinPath, normalizePath, relativePath, resolvePath } from "./paths.js";
+import { ancestors, dirnamePath, joinPath, normalizePath, relativePath, resolvePath, } from "./paths.js";
 import { satisfies } from "./version-range.js";
+import { bytewise } from "./text/compare.js";
+import { isRecord } from "./json-document.js";
+import { unwrapped } from "./unwrap.js";
+import { filesIn } from "./fs/tree.js";
+import { DEPENDENCY_SECTIONS, INSTALLED_PACKAGES, MANIFEST, readJSON } from "./fs/manifest.js";
+import { globExpression } from "./text/glob.js";
+import { yamlDocument } from "./text/yaml.js";
 const JSON_EXTENSION = ".json";
+/**
+ * A configuration file its tool reads as a YAML document, read as the JSON document it
+ * denotes. Its nodes' offsets are that JSON text's, so no move may read one: a failure's
+ * line would name the wrong line.
+ */
+const YAML_NAME = /\.ya?ml$/u;
 /** A configuration file with no extension that its tool reads as a JSON document. */
 const JSON_RC = /^\.[\w-]+rc$/u;
 /** The sections an installed package is required by, so its absence fails the run. */
 const REQUIRED_SECTIONS = ["dependencies", "devDependencies"];
-const DEPENDENCY_SECTIONS = [
-    ...REQUIRED_SECTIONS,
-    "peerDependencies",
-    "optionalDependencies",
-];
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function readJSON(host, path) {
-    try {
-        return JSON.parse(host.readFile(path));
-    }
-    catch {
-        return undefined;
-    }
-}
 function declares(manifest, name, sections = DEPENDENCY_SECTIONS) {
     if (!isRecord(manifest)) {
         return false;
@@ -48,32 +44,15 @@ function declares(manifest, name, sections = DEPENDENCY_SECTIONS) {
  * none, or `undefined` where no `node_modules` holds it.
  */
 function installedVersion(host, dir, name) {
-    for (let at = normalizePath(dir);; at = dirnamePath(at)) {
-        const path = joinPath(at, "node_modules", name, "package.json");
+    for (const at of ancestors(dir)) {
+        const path = joinPath(at, INSTALLED_PACKAGES, name, MANIFEST);
         if (host.kindOf(path) === "file") {
             const manifest = readJSON(host, path);
             const version = isRecord(manifest) ? manifest["version"] : undefined;
             return typeof version === "string" ? version : "";
         }
-        if (dirnamePath(at) === at) {
-            return undefined;
-        }
-    }
-}
-/** Whether one node wraps an expression without changing its value. */
-function isWrapper(node) {
-    return (isParenthesizedExpression(node) ||
-        isAsExpression(node) ||
-        isSatisfiesExpression(node) ||
-        isNonNullExpression(node));
-}
-/** The expression a wrapper that changes no value holds. */
-function unwrapped(node) {
-    let at = node;
-    while (isWrapper(at)) {
-        at = at.expression;
     }
-    return at;
+    return undefined;
 }
 /** The key one property is written with, where it is written as a name or as literal text. */
 function keyOf(property) {
@@ -562,17 +541,7 @@ function expand(template, resolved) {
 /** The configuration files in one directory that one glob names, by name. */
 function configurationFiles(host, dir, glob) {
     const expression = globExpression(glob);
-    let entries;
-    try {
-        entries = host.readDirectory(dir);
-    }
-    catch {
-        return [];
-    }
-    return entries
-        .filter((entry) => !entry.directory && expression.test(entry.name))
-        .map((entry) => entry.name)
-        .sort();
+    return filesIn(host, dir, (name) => expression.test(name));
 }
 function resolveMove(host, parse, dir, row, move, resolved) {
     const set = [];
@@ -614,6 +583,14 @@ function readingFiles(host, parse, dir, files) {
             catch {
                 continue;
             }
+            if (YAML_NAME.test(name)) {
+                const value = yamlDocument(text);
+                if (value !== undefined) {
+                    const json = JSON.stringify(value);
+                    found.push({ name, text: json, file: parse(`${path}${JSON_EXTENSION}`, json) });
+                }
+                continue;
+            }
             found.push({
                 name,
                 text,
@@ -652,7 +629,7 @@ function shortNameUses(host, parse, dir, manifest, readings) {
             }
         }
     }
-    return [...used].filter((name) => declared.has(name)).sort(compare);
+    return [...used].filter((name) => declared.has(name)).sort(bytewise);
 }
 /**
  * The package one value of a prefixed-name reading names, or none: ESLint's own naming,
@@ -703,7 +680,7 @@ function prefixedNameUses(host, parse, dir, manifest, readings) {
             }
         }
     }
-    return [...used].sort(compare);
+    return [...used].sort(bytewise);
 }
 /** The declared dependencies an applied row's helper settings use. */
 function helperUses(host, parse, dir, manifest, readings) {
@@ -760,13 +737,6 @@ function packageKeyUses(host, parse, dir, manifest, keys) {
         text.startsWith(`${name}/`) ||
         (text.startsWith(`${name}:`) && text.length > name.length + 1)));
 }
-/** Two strings ordered bytewise. */
-function compare(a, b) {
-    if (a === b) {
-        return 0;
-    }
-    return a < b ? -1 : 1;
-}
 /**
  * What the rows decide over the manifests the analysis reads. A row `disabled` names
  * is skipped before anything is read for it.
@@ -780,7 +750,7 @@ export function readConventions(host, parse, manifests, disabled, rows = CONVENT
     const selected = new Map();
     const testFiles = new Set();
     for (const manifest of manifests) {
-        const declared = readJSON(host, joinPath(manifest.dir, "package.json"));
+        const declared = readJSON(host, joinPath(manifest.dir, MANIFEST));
         const versions = new Map();
         const missing = new Set();
         for (const row of rows) {
@@ -801,7 +771,7 @@ export function readConventions(host, parse, manifests, disabled, rows = CONVENT
                 failures.push({
                     dir: manifest.dir,
                     failure: {
-                        setupClass: "missing-module",
+                        failureClass: "missing-module",
                         detail: `${manifest.path} declares ${row.package}, which no node_modules at or ` +
                             `above its directory holds: run the package manager's install`,
                     },
@@ -826,7 +796,7 @@ export function readConventions(host, parse, manifests, disabled, rows = CONVENT
                 failures.push({
                     dir: manifest.dir,
                     failure: {
-                        setupClass: "convention-not-literal",
+                        failureClass: "convention-not-literal",
                         detail: where === "." ? failed : `${where}/${failed}`,
                     },
                 });
@@ -878,15 +848,15 @@ export function readConventions(host, parse, manifests, disabled, rows = CONVENT
         }
     }
     const unique = [...new Map(applied.map((one) => [JSON.stringify(one), one])).values()];
-    unique.sort((a, b) => compare(a.name, b.name) ||
-        compare(a.manifest, b.manifest) ||
-        compare(JSON.stringify(a), JSON.stringify(b)));
+    unique.sort((a, b) => bytewise(a.name, b.name) ||
+        bytewise(a.manifest, b.manifest) ||
+        bytewise(JSON.stringify(a), JSON.stringify(b)));
     return {
         applied: unique,
         globs,
         generated,
         failures,
-        uses: [...uses].sort(compare),
+        uses: [...uses].sort(bytewise),
         selected,
         testFiles,
     };

package/dist/src/dependencies.js

@@ -10,14 +10,16 @@ import { isArrayLiteralExpression, isCallExpression, isExportDeclaration, isExpr
 import { automaticTypes } from "./automatic-types.js";
 import { configurationFiles, declaredIn as declaredBeside, dependenciesNamed, moduleStrings, outsideChain, } from "./configuration-files.js";
 import { nodeKey, packageScope } from "./inventory.js";
-import { scriptTokens } from "./manifest.js";
-import { dirnamePath, isAbsolutePath, joinPath, relativePath, resolvePath } from "./paths.js";
+import { ancestors, dirnamePath, isAbsolutePath, joinPath, relativePath, resolvePath, } from "./paths.js";
 import { UNANSWERED } from "./query.js";
 import { sourceFilesOf } from "./source-files.js";
-import { workflowTokens } from "./workflow-steps.js";
-const MANIFEST = "package.json";
-const MODULES_DIR = "node_modules";
-const MODULES_SEGMENT = `/${MODULES_DIR}/`;
+import { manifestCommands } from "./manifest.js";
+import { workflowCommands, workflowTokens } from "./workflow-steps.js";
+import { bytewise } from "./text/compare.js";
+import { isRecord } from "./json-document.js";
+import { inInstalledPackages, INSTALLED_PACKAGES, MANIFEST, readDocument } from "./fs/manifest.js";
+import { commandsOf, scriptTokens } from "./text/shell.js";
+const MODULES_SEGMENT = `/${INSTALLED_PACKAGES}/`;
 const TYPES_SCOPE = "@types/";
 /** A script token naming a JavaScript file by a path no expansion changes. */
 const SCRIPT_FILE = /^[^$`{*?[~]+\.(?:js|mjs|cjs)$/u;
@@ -39,25 +41,6 @@ export function configurationNeeds(packages) {
 }
 /** The key of {@link ProjectNeeds.at} for a use no file of the target governs. */
 const ANYWHERE = "";
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** One JSON document's decoded value, or undefined where it cannot be read or parsed. */
-function readJSON(host, path) {
-    let text;
-    try {
-        text = host.readFile(path);
-    }
-    catch {
-        return undefined;
-    }
-    try {
-        return { text, value: JSON.parse(text) };
-    }
-    catch {
-        return undefined;
-    }
-}
 /**
  * The package a bare module specifier names: its first segment, or its first two
  * where it starts with a scope. A relative, absolute or scheme-prefixed specifier and
@@ -280,7 +263,7 @@ export function projectNeeds(project, held, host, targetRoot, parse) {
     }
     for (const { strings, manifestDirs } of configuration.documents) {
         for (const manifestDir of manifestDirs) {
-            const names = declaredAt(joinPath(manifestDir, "package.json"));
+            const names = declaredAt(joinPath(manifestDir, MANIFEST));
             for (const text of strings) {
                 use([PROJECT_OWNER], dependenciesNamed(text, names), joinPath(manifestDir, MANIFEST));
             }
@@ -289,7 +272,7 @@ export function projectNeeds(project, held, host, targetRoot, parse) {
     const ranFiles = outsideChain(host, targetRoot, files, parse, scriptRunFiles(host, targetRoot, files));
     for (const { file, manifestDirs } of [...configuration.outside, ...ranFiles]) {
         for (const manifestDir of manifestDirs) {
-            const names = declaredAt(joinPath(manifestDir, "package.json"));
+            const names = declaredAt(joinPath(manifestDir, MANIFEST));
             for (const { text } of moduleStrings(file)) {
                 use([PROJECT_OWNER], dependenciesNamed(text, names), joinPath(manifestDir, MANIFEST));
             }
@@ -307,8 +290,8 @@ function scriptRunFiles(host, targetRoot, files) {
     const root = resolvePath(host.workingDirectory(), targetRoot);
     const dirs = new Set([root]);
     for (const name of files.byName.keys()) {
-        for (let dir = dirnamePath(name); !dirs.has(dir); dir = dirnamePath(dir)) {
-            if (relativePath(root, dir) === undefined) {
+        for (const dir of ancestors(dirnamePath(name), root)) {
+            if (dirs.has(dir)) {
                 break;
             }
             dirs.add(dir);
@@ -318,7 +301,7 @@ function scriptRunFiles(host, targetRoot, files) {
         [root, new Set(workflowTokens(host, root))],
     ]);
     for (const dir of dirs) {
-        const read = readJSON(host, joinPath(dir, MANIFEST));
+        const read = readDocument(host, joinPath(dir, MANIFEST));
         if (read !== undefined && isRecord(read.value)) {
             const own = scriptTokensOf(read.value);
             tokens.set(dir, dir === root ? new Set([...own, ...(tokens.get(root) ?? [])]) : own);
@@ -330,7 +313,8 @@ function scriptRunFiles(host, targetRoot, files) {
             const path = SCRIPT_FILE.test(token) ? resolvePath(manifestDir, token) : undefined;
             const below = path === undefined ? undefined : relativePath(root, path);
             if (path !== undefined &&
-                below?.split("/").includes(MODULES_DIR) === false &&
+                below !== undefined &&
+                !inInstalledPackages(below) &&
                 !files.byName.has(path) &&
                 host.kindOf(path) === "file") {
                 found.push({ path, manifestDir });
@@ -600,8 +584,8 @@ function lineAndColumn(text, offset) {
 }
 /** The installed copy of one dependency, read where the package manager puts it for the target. */
 function installedOf(host, root, name) {
-    for (let dir = root;; dir = dirnamePath(dir)) {
-        const read = readJSON(host, joinPath(dir, MODULES_DIR, name, MANIFEST));
+    for (const dir of ancestors(root)) {
+        const read = readDocument(host, joinPath(dir, INSTALLED_PACKAGES, name, MANIFEST));
         if (read !== undefined && isRecord(read.value)) {
             const bin = read.value["bin"];
             const peers = read.value["peerDependencies"];
@@ -617,10 +601,8 @@ function installedOf(host, root, name) {
                         : [],
             };
         }
-        if (dirnamePath(dir) === dir) {
-            return undefined;
-        }
     }
+    return undefined;
 }
 /** Every dependency the manifest text at `path` declares, in the order the text writes them. */
 function declaredIn(text, manifest, path, scope) {
@@ -664,6 +646,82 @@ function scriptTokensOf(manifest) {
     }
     return found;
 }
+/**
+ * The runtime flags whose value is a module loaded before the entry, as `--flag value` or
+ * `--flag=value`: https://nodejs.org/api/cli.html#--importmodule,
+ * https://nodejs.org/api/cli.html#--experimental-loadermodule,
+ * https://nodejs.org/api/cli.html#-r---require-module
+ */
+const PRELOAD_FLAGS = new Set([
+    "--experimental-loader",
+    "--import",
+    "--loader",
+    "--require",
+    "-r",
+]);
+/**
+ * The programs that pass a preload flag to the runtime they start: Node itself, and the
+ * runners that forward Node's flags or read the same `--require`:
+ * https://mochajs.org/#-require-module-r-module, https://tsx.is/node-enhancement,
+ * https://typestrong.org/ts-node/docs/options#require,
+ * https://github.com/remy/nodemon#running-non-node-scripts
+ */
+const PRELOADING_PROGRAMS = new Set([
+    "mocha",
+    "node",
+    "nodemon",
+    "ts-node",
+    "tsx",
+]);
+/** The programs that run the command after them, and an environment assignment before it. */
+const LAUNCHERS = new Set(["cross-env", "env", "npx"]);
+const ASSIGNMENT = /^[A-Za-z_][A-Za-z0-9_]*=/u;
+/**
+ * The packages `scripts` preload by a runtime flag's bare module specifier, a flag
+ * counting only in a command whose program passes it to the runtime, and for Node only
+ * before the script it runs, whose own arguments come after it.
+ */
+function preloadsOf(scripts) {
+    const found = new Set();
+    for (const script of scripts) {
+        for (const command of commandsOf(script)) {
+            const tokens = scriptTokens(command);
+            let at = 0;
+            while (at < tokens.length &&
+                (ASSIGNMENT.test(tokens[at] ?? "") || LAUNCHERS.has(tokens[at] ?? ""))) {
+                at += 1;
+            }
+            const path = tokens[at] ?? "";
+            const program = path.slice(path.lastIndexOf("/") + 1);
+            if (!PRELOADING_PROGRAMS.has(program)) {
+                continue;
+            }
+            for (at += 1; at < tokens.length; at += 1) {
+                const token = tokens[at] ?? "";
+                if (!token.startsWith("-")) {
+                    if (program === "node") {
+                        break;
+                    }
+                    continue;
+                }
+                const equals = token.indexOf("=");
+                const flag = equals < 0 ? token : token.slice(0, equals);
+                if (!PRELOAD_FLAGS.has(flag)) {
+                    continue;
+                }
+                if (equals < 0) {
+                    at += 1;
+                }
+                const value = equals < 0 ? tokens[at] : token.slice(equals + 1);
+                const name = value === undefined ? undefined : packageOfSpecifier(value);
+                if (name !== undefined) {
+                    found.add(name);
+                }
+            }
+        }
+    }
+    return found;
+}
 /** Whether a path below the target root lies in the directory `dir` below it, `""` being the root. */
 function isInside(path, dir) {
     return dir === "" || path.startsWith(`${dir}/`);
@@ -735,22 +793,27 @@ export function dependenciesOf(host, targetRoot, perProject, candidates, members
         }
     }
     const workflow = new Set(workflowTokens(host, targetRoot));
+    const workflowPreloads = preloadsOf(workflowCommands(host, targetRoot));
     const declared = [];
     const ran = new Set();
     const peers = new Map();
     const uninstalledHere = new Set(nested);
     for (const [dir, path] of manifests) {
-        const read = readJSON(host, joinPath(dir, MANIFEST));
+        const read = readDocument(host, joinPath(dir, MANIFEST));
         if (read === undefined || !isRecord(read.value)) {
             continue;
         }
         const tokens = scriptTokensOf(read.value);
+        const preloads = preloadsOf(manifestCommands(host, dir, read.value).map(({ command }) => command));
         for (const dependency of declaredIn(read.text, read.value, path, scopeOf(path))) {
             const found = installedOf(host, dir, dependency.name);
             if (found === undefined && uninstalledHere.has(dir)) {
                 continue;
             }
             declared.push(dependency);
+            if (preloads.has(dependency.name) || workflowPreloads.has(dependency.name)) {
+                ran.add(declarationKey(dependency));
+            }
             if (found === undefined) {
                 continue;
             }
@@ -812,7 +875,7 @@ export function dependenciesOf(host, targetRoot, perProject, candidates, members
     const heldBy = new Map();
     for (const [key, held] of holders) {
         if (!live.has(key) && !ran.has(key)) {
-            heldBy.set(key, [...held].sort((a, b) => (a < b ? -1 : 1)));
+            heldBy.set(key, [...held].sort(bytewise));
         }
     }
     const users = new Map();
@@ -824,7 +887,7 @@ export function dependenciesOf(host, targetRoot, perProject, candidates, members
     for (const id of candidates) {
         const sole = [...(uses.get(id) ?? [])].filter((one) => users.get(one) === 1 && names.has(one));
         if (sole.length > 0) {
-            lastUses.set(id, sole.sort((a, b) => (a < b ? -1 : 1)));
+            lastUses.set(id, sole.sort(bytewise));
         }
     }
     const owners = new Map();
@@ -836,7 +899,7 @@ export function dependenciesOf(host, targetRoot, perProject, candidates, members
         }
     }
     const fileLastUses = new Map();
-    for (const [one, held] of [...owners].sort(([a], [b]) => (a < b ? -1 : 1))) {
+    for (const [one, held] of [...owners].sort(([a], [b]) => bytewise(a, b))) {
         const paths = new Set([...held].map((owner) => owner.replace(/:\d+:\d+$/u, "")));
         const [path] = paths;
         if (paths.size === 1 && path !== undefined && path !== PROJECT_OWNER) {