@cplieger/deadset-ts 7.2.0-dev.4 → 8.0.0-dev.10

package/dist/src/dependencies.js

@@ -6,18 +6,23 @@
  * file a tool loads needs each dependency its strings spell. A package one dependency pulls in for
  * itself is that dependency's need, not the target's.
  */
-import { isCallExpression, isExportDeclaration, isExternalModuleReference, isIdentifier, isImportDeclaration, isImportEqualsDeclaration, isMetaProperty, isNamespaceExport, isPropertyAccessExpression, isShorthandPropertyAssignment, isStringLiteral, isNoSubstitutionTemplateLiteral, SyntaxKind, } from "@typescript/native/ast";
-import { configurationFiles, declaredIn as declaredBeside, dependenciesNamed, moduleStrings, } from "./configuration-files.js";
+import { isArrayLiteralExpression, isCallExpression, isExportDeclaration, isExpressionStatement, isExternalModuleReference, isIdentifier, isImportDeclaration, isImportEqualsDeclaration, isMetaProperty, isNamespaceExport, isObjectLiteralExpression, isPropertyAccessExpression, isPropertyAssignment, isShorthandPropertyAssignment, isStringLiteral, isNoSubstitutionTemplateLiteral, SyntaxKind, } from "@typescript/native/ast";
+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;
 /** The manifest sections a dependency is declared in, each by the selector its reference spells. */
 const SECTIONS = [
     ["dependencies", "dependency"],
@@ -30,31 +35,12 @@ const PROJECT_OWNER = "";
 export function configurationNeeds(packages) {
     return {
         uses: new Map([[PROJECT_OWNER, new Set(packages)]]),
-        at: new Map([[ANYWHERE, new Set(packages)]]),
+        at: new Map([[ANYWHERE, new Map(packages.map((one) => [one, new Set([PROJECT_OWNER])]))]]),
         unanswered: [],
     };
 }
 /** 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
@@ -99,12 +85,35 @@ function typePackages(name, programPackages) {
     }
     return [typed, named];
 }
+/**
+ * The strings the `extends` member of one compiler configuration file holds, read as the
+ * compiler reads the file, comments and trailing commas allowed; none where it cannot be read.
+ */
+function extendsOf(host, path, parse) {
+    let text;
+    try {
+        text = host.readFile(path);
+    }
+    catch {
+        return [];
+    }
+    const [statement] = parse(path, text).statements;
+    const document = statement !== undefined && isExpressionStatement(statement) ? statement.expression : undefined;
+    if (document === undefined || !isObjectLiteralExpression(document)) {
+        return [];
+    }
+    const value = document.properties
+        .filter(isPropertyAssignment)
+        .findLast((property) => isLiteralText(property.name) && property.name.text === "extends")?.initializer;
+    const entries = value !== undefined && isArrayLiteralExpression(value) ? value.elements : [value];
+    return entries.flatMap((entry) => entry !== undefined && isLiteralText(entry) ? [entry.text] : []);
+}
 /**
  * The packages the compiler configuration of one project names: its type packages,
  * its JSX import source, the helper library it imports, its plugins, and every
  * package a configuration file it extends through is read from.
  */
-function configurationPackages(host, configFile, options, programPackages) {
+function configurationPackages(host, configFile, options, programPackages, parse) {
     const found = new Set();
     const add = (name) => {
         const named = typeof name === "string" ? packageOfSpecifier(name) : undefined;
@@ -139,12 +148,7 @@ function configurationPackages(host, configFile, options, programPackages) {
             continue;
         }
         seen.add(file);
-        const read = readJSON(host, file);
-        const extended = isRecord(read?.value) ? read.value["extends"] : undefined;
-        for (const entry of Array.isArray(extended) ? extended : [extended]) {
-            if (typeof entry !== "string") {
-                continue;
-            }
+        for (const entry of extendsOf(host, file, parse)) {
             if (entry.startsWith(".") || isAbsolutePath(entry)) {
                 const local = resolvePath(dirnamePath(file), entry);
                 pending.push(local.endsWith(".json") ? local : `${local}.json`);
@@ -207,13 +211,19 @@ export function projectNeeds(project, held, host, targetRoot, parse) {
             programPackages.add(named);
         }
     }
-    const packages = configurationPackages(host, project.configFile, project.program.getCompilerOptions(), programPackages);
+    const options = project.program.getCompilerOptions();
+    const packages = configurationPackages(host, project.configFile, options, programPackages, parse);
+    const automatic = automaticTypes(host, project.configFile, options, parse);
     const uses = new Map();
     const at = new Map();
     const use = (owners, named, path) => {
         for (const one of named) {
-            at.set(path, (at.get(path) ?? new Set()).add(one));
+            const inFile = at.get(path) ?? new Map();
+            at.set(path, inFile);
+            const holders = inFile.get(one) ?? new Set();
+            inFile.set(one, holders);
             for (const owner of owners) {
+                holders.add(owner);
                 let set = uses.get(owner);
                 if (set === undefined) {
                     set = new Set();
@@ -229,7 +239,7 @@ export function projectNeeds(project, held, host, targetRoot, parse) {
         const inFile = (owners, named) => {
             use(owners, named, file.fileName);
         };
-        if (fileNeeds(project, held, file, programPackages, inFile)) {
+        if (fileNeeds(project, held, file, { programPackages, automatic }, inFile)) {
             unanswered.push(file.fileName);
         }
     }
@@ -243,7 +253,8 @@ export function projectNeeds(project, held, host, targetRoot, parse) {
         }
         return names;
     };
-    const configuration = configurationFiles(host, targetRoot, sourceFilesOf(project, targetRoot), parse);
+    const files = sourceFilesOf(project, targetRoot);
+    const configuration = configurationFiles(host, targetRoot, files, parse);
     for (const { file, manifestDir } of configuration.modules) {
         const names = declaredAt(joinPath(manifestDir, MANIFEST));
         for (const { node, text } of moduleStrings(file)) {
@@ -252,15 +263,16 @@ 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));
             }
         }
     }
-    for (const { file, manifestDirs } of configuration.outside) {
+    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));
             }
@@ -268,6 +280,49 @@ export function projectNeeds(project, held, host, targetRoot, parse) {
     }
     return { uses, at, unanswered };
 }
+/**
+ * The JavaScript files no program holds that a script of a manifest at or above one of the
+ * project's files runs, each with the directory of that manifest, and those a workflow
+ * step or git hook runs, with the target root's: a token naming such a file below the
+ * target root and in no `node_modules`, read against the manifest's directory.
+ */
+function scriptRunFiles(host, targetRoot, files) {
+    const root = resolvePath(host.workingDirectory(), targetRoot);
+    const dirs = new Set([root]);
+    for (const name of files.byName.keys()) {
+        for (const dir of ancestors(dirnamePath(name), root)) {
+            if (dirs.has(dir)) {
+                break;
+            }
+            dirs.add(dir);
+        }
+    }
+    const tokens = new Map([
+        [root, new Set(workflowTokens(host, root))],
+    ]);
+    for (const dir of dirs) {
+        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);
+        }
+    }
+    const found = [];
+    for (const [manifestDir, held] of tokens) {
+        for (const token of held) {
+            const path = SCRIPT_FILE.test(token) ? resolvePath(manifestDir, token) : undefined;
+            const below = path === undefined ? undefined : relativePath(root, path);
+            if (path !== undefined &&
+                below !== undefined &&
+                !inInstalledPackages(below) &&
+                !files.byName.has(path) &&
+                host.kindOf(path) === "file") {
+                found.push({ path, manifestDir });
+            }
+        }
+    }
+    return found;
+}
 /** The declarations of the inventory a use written at one node belongs to. */
 function ownersOf(file, held, node) {
     const parent = node.parent;
@@ -291,8 +346,27 @@ function ownersOf(file, held, node) {
     }
     return [PROJECT_OWNER];
 }
-/** Records the needs of one file, and answers whether a specifier of it went unanswered. */
-function fileNeeds(project, held, file, programPackages, use) {
+/**
+ * Whether one identifier stands for a value or type of the scope it is written in, rather
+ * than naming a member, a property or a label.
+ */
+function isScopeName(node) {
+    const parent = node.parent;
+    if (parent === undefined || isShorthandPropertyAssignment(parent)) {
+        return true;
+    }
+    const named = parent;
+    return (named.name !== node &&
+        (parent.kind !== SyntaxKind.QualifiedName || named.right !== node) &&
+        named.propertyName !== node &&
+        named.label !== node);
+}
+/**
+ * Records the needs of one file, and answers whether a specifier of it went unanswered. A
+ * module specifier or a name of the file's scope that resolves to nothing, and that an
+ * automatically included type package declares, uses that package.
+ */
+function fileNeeds(project, held, file, { programPackages, automatic }, use) {
     const specifiers = [...file.imports, ...file.moduleAugmentations].filter(isLiteralText);
     const bindings = [];
     const bound = new Set();
@@ -309,16 +383,22 @@ function fileNeeds(project, held, file, programPackages, use) {
     }
     const names = new Set(bindings.map(({ node }) => node.text));
     const candidates = [];
+    const globals = [];
     const visit = (node) => {
-        if (isIdentifier(node) && names.has(node.text) && !bound.has(node)) {
-            candidates.push(node);
+        if (isIdentifier(node) && !bound.has(node)) {
+            if (names.has(node.text)) {
+                candidates.push(node);
+            }
+            else if (automatic.globals.has(node.text) && isScopeName(node)) {
+                globals.push(node);
+            }
         }
         node.forEachChild(visit);
     };
-    if (names.size > 0) {
+    if (names.size > 0 || automatic.globals.size > 0) {
         visit(file);
     }
-    const asked = [...specifiers, ...bindings.map(({ node }) => node), ...candidates];
+    const asked = [...specifiers, ...bindings.map(({ node }) => node), ...candidates, ...globals];
     const handles = asked.map((node) => project.handle(node));
     const resolved = project.symbolsAt(handles);
     const packagesOf = new Map();
@@ -329,6 +409,9 @@ function fileNeeds(project, held, file, programPackages, use) {
             named.add(byName);
         }
         const symbol = resolved[index];
+        if (symbol === undefined) {
+            automatic.modules.get(specifier.text)?.forEach((one) => named.add(one));
+        }
         for (const declaration of typeof symbol === "object" ? symbol.declarations : []) {
             const byPath = packageOfPath(declaration.path);
             if (byPath !== undefined) {
@@ -364,7 +447,7 @@ function fileNeeds(project, held, file, programPackages, use) {
         let symbol = resolved[offset + index];
         const parent = node.parent;
         if (parent !== undefined && isShorthandPropertyAssignment(parent) && parent.name === node) {
-            symbol = project.shorthandValueAt(project.handle(node));
+            symbol = project.shorthandValueAt(project.handle(parent));
         }
         const named = symbol === UNANSWERED || (unresolvedNames.has(node.text) && symbol === undefined)
             ? byName.get(node.text)
@@ -376,6 +459,13 @@ function fileNeeds(project, held, file, programPackages, use) {
             use(ownersOf(file, held, node), named);
         }
     });
+    const unresolvedAt = offset + candidates.length;
+    globals.forEach((node, index) => {
+        const symbol = resolved[unresolvedAt + index];
+        if (symbol === undefined || symbol === UNANSWERED) {
+            use(ownersOf(file, held, node), automatic.globals.get(node.text) ?? []);
+        }
+    });
     for (const reference of file.typeReferenceDirectives) {
         use(ownersOf(file, held, file), typePackages(reference.fileName, programPackages));
     }
@@ -494,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"];
@@ -511,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) {
@@ -558,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}/`);
@@ -567,6 +731,18 @@ function manifestDir(dependency) {
     const dir = dirnamePath(dependency.position.path);
     return dir === "." ? "" : dir;
 }
+/**
+ * The declarations of one name a use written at `below` needs: those of the nearest
+ * manifest at or above it that declares the name, or every one for a use no file holds.
+ */
+function nearestDeclaring(declarations, below) {
+    if (below === undefined) {
+        return declarations;
+    }
+    const enclosing = declarations.filter((dependency) => isInside(below, manifestDir(dependency)));
+    const nearest = Math.max(-1, ...enclosing.map((dependency) => manifestDir(dependency).length));
+    return enclosing.filter((dependency) => manifestDir(dependency).length === nearest);
+}
 /**
  * Adds to `needed` each declared dependency that the installed manifest of a needed or
  * run declared dependency names as a peer, until no further one joins: the declaration of
@@ -617,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;
             }
@@ -646,6 +827,8 @@ export function dependenciesOf(host, targetRoot, perProject, candidates, members
     // A declaration several projects compile is one user, and a use any project makes is
     // a use, so the uses are merged by declaration before anything is counted.
     const needed = new Set();
+    const live = new Set();
+    const holders = new Map();
     const byName = new Map();
     for (const dependency of declared) {
         byName.set(dependency.name, [...(byName.get(dependency.name) ?? []), dependency]);
@@ -656,7 +839,10 @@ export function dependenciesOf(host, targetRoot, perProject, candidates, members
         // or above its file declares, and what the configuration needs is never deleted.
         const unanswered = project.unanswered.flatMap((file) => relativePath(root, file) ?? []);
         const unknownDeclared = declared.filter((dependency) => unanswered.some((file) => isInside(file, manifestDir(dependency))));
-        unknownDeclared.forEach((dependency) => needed.add(declarationKey(dependency)));
+        for (const dependency of unknownDeclared) {
+            needed.add(declarationKey(dependency));
+            live.add(declarationKey(dependency));
+        }
         const unknown = unknownDeclared.map((dependency) => dependency.name);
         const held = unknown.length === 0 ? [] : [[PROJECT_OWNER, new Set(unknown)]];
         for (const [id, used] of [...project.uses, ...held]) {
@@ -666,16 +852,32 @@ export function dependenciesOf(host, targetRoot, perProject, candidates, members
         }
         for (const [path, named] of project.at) {
             const below = path === ANYWHERE ? undefined : relativePath(root, path);
-            for (const one of named) {
-                for (const dependency of byName.get(one) ?? []) {
-                    if (below === undefined || isInside(below, manifestDir(dependency))) {
-                        needed.add(declarationKey(dependency));
+            for (const [one, owners] of named) {
+                // An import none of whose bindings is used is no evidence about the code using it.
+                const unheld = owners.size === 0;
+                for (const dependency of nearestDeclaring(byName.get(one) ?? [], below)) {
+                    const key = declarationKey(dependency);
+                    needed.add(key);
+                    if (unheld) {
+                        live.add(key);
+                    }
+                    else {
+                        const held = holders.get(key) ?? new Set();
+                        owners.forEach((owner) => held.add(owner));
+                        holders.set(key, held);
                     }
                 }
             }
         }
     }
     addNeededPeers(declared, peers, needed, ran);
+    addNeededPeers(declared, peers, live, ran);
+    const heldBy = new Map();
+    for (const [key, held] of holders) {
+        if (!live.has(key) && !ran.has(key)) {
+            heldBy.set(key, [...held].sort(bytewise));
+        }
+    }
     const users = new Map();
     for (const used of uses.values()) {
         used.forEach((one) => users.set(one, (users.get(one) ?? 0) + 1));
@@ -685,8 +887,24 @@ 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();
+    for (const [owner, used] of uses) {
+        for (const one of used) {
+            if (names.has(one)) {
+                owners.set(one, (owners.get(one) ?? new Set()).add(owner));
+            }
+        }
+    }
+    const fileLastUses = new Map();
+    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) {
+            fileLastUses.set(path, [...(fileLastUses.get(path) ?? []), one]);
         }
     }
-    return { declared, needed, ran, unbuilt, lastUses };
+    return { declared, needed, ran, unbuilt, lastUses, fileLastUses, heldBy };
 }