@cplieger/deadset-ts 8.0.0-dev.14 → 8.0.0-dev.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/src/alias-chain.js +2 -2
- package/dist/src/analysis.js +43 -38
- package/dist/src/commands/read.js +6 -7
- package/dist/src/conformance-record.js +1 -1
- package/dist/src/consumers.js +4 -2
- package/dist/src/contract/config.generated.js +1 -1
- package/dist/src/contract/contract.generated.js +120 -2
- package/dist/src/dependencies.js +81 -49
- package/dist/src/entries/build-scripts.js +222 -0
- package/dist/src/{configuration-files.js → entries/configuration-files.js} +20 -58
- package/dist/src/{convention-rows.js → entries/convention-rows.js} +120 -27
- package/dist/src/entries/conventions.js +739 -0
- package/dist/src/{html-entries.js → entries/html-entries.js} +3 -3
- package/dist/src/{mdx-entries.js → entries/mdx-entries.js} +2 -2
- package/dist/src/entries/run-directories.js +77 -0
- package/dist/src/entries/sources.js +144 -0
- package/dist/src/entries/static-module.js +669 -0
- package/dist/src/entries/test-runners.js +684 -0
- package/dist/src/{workflow-steps.js → entries/workflow-steps.js} +18 -8
- package/dist/src/extensions.js +37 -0
- package/dist/src/facts.js +38 -0
- package/dist/src/file-facts.js +1 -1
- package/dist/src/findings/emitters.js +5 -8
- package/dist/src/findings/self-check.js +36 -20
- package/dist/src/findings-pass.js +5 -6
- package/dist/src/framework-lifecycle.js +1 -1
- package/dist/src/fs/manifest.js +15 -20
- package/dist/src/generated-file.js +172 -29
- package/dist/src/graph.js +2 -5
- package/dist/src/index.js +1 -1
- package/dist/src/injection-container.js +1 -1
- package/dist/src/inventory/commonjs.js +507 -0
- package/dist/src/inventory/enumerate.js +167 -0
- package/dist/src/inventory/syntax.js +236 -0
- package/dist/src/inventory.js +305 -705
- package/dist/src/javascript-file.js +26 -11
- package/dist/src/load/classify.js +28 -9
- package/dist/src/load/diagnostics.js +8 -1
- package/dist/src/load/discover.js +16 -8
- package/dist/src/load/package-scope.js +56 -0
- package/dist/src/load/plan.js +2 -2
- package/dist/src/load/synthesize.js +5 -5
- package/dist/src/load/workspace-manifests.js +1 -1
- package/dist/src/matrix.js +6 -13
- package/dist/src/outside-tests.js +1 -1
- package/dist/src/paths.js +16 -0
- package/dist/src/platform-calls.js +78 -0
- package/dist/src/platform-symbols.js +140 -0
- package/dist/src/position.js +41 -0
- package/dist/src/ref.js +11 -20
- package/dist/src/references.js +281 -50
- package/dist/src/resolve.js +1 -1
- package/dist/src/{configured-declarations.js → roots/configured-declarations.js} +4 -4
- package/dist/src/{entry-point-gaps.js → roots/entry-point-gaps.js} +5 -8
- package/dist/src/{manifest.js → roots/manifest.js} +4 -4
- package/dist/src/roots/published-reach.js +412 -0
- package/dist/src/roots/root-set.js +489 -0
- package/dist/src/roots/unseen-loads.js +208 -0
- package/dist/src/serialization-contract.js +1 -1
- package/dist/src/session.js +3 -0
- package/dist/src/source-files.js +5 -9
- package/dist/src/suppress-inline.js +33 -81
- package/dist/src/suppress.js +30 -32
- package/dist/src/test-support.js +4 -2
- package/dist/src/verbs/analyze.js +13 -1
- package/dist/src/verbs/describe.js +5 -3
- package/jsr.json +1 -1
- package/package.json +3 -3
- package/src/alias-chain.ts +2 -2
- package/src/analysis.ts +77 -53
- package/src/automatic-types.ts +1 -1
- package/src/commands/read.ts +6 -8
- package/src/conformance-record.ts +1 -1
- package/src/consumers.ts +5 -1
- package/src/contract/config.generated.ts +1 -1
- package/src/contract/contract.generated.ts +139 -2
- package/src/dependencies.ts +98 -50
- package/src/entries/build-scripts.ts +292 -0
- package/src/{configuration-files.ts → entries/configuration-files.ts} +23 -75
- package/src/{convention-rows.ts → entries/convention-rows.ts} +167 -28
- package/src/{conventions.ts → entries/conventions.ts} +347 -522
- package/src/{html-entries.ts → entries/html-entries.ts} +5 -5
- package/src/{mdx-entries.ts → entries/mdx-entries.ts} +4 -4
- package/src/entries/run-directories.ts +108 -0
- package/src/entries/sources.ts +266 -0
- package/src/entries/static-module.ts +857 -0
- package/src/entries/test-runners.ts +868 -0
- package/src/{workflow-steps.ts → entries/workflow-steps.ts} +29 -11
- package/src/exempt.ts +3 -2
- package/src/extensions.ts +45 -0
- package/src/facts.ts +44 -0
- package/src/file-facts.ts +2 -2
- package/src/findings/emitters.ts +14 -10
- package/src/findings/self-check.ts +41 -22
- package/src/findings/visibility-narrowing.ts +1 -1
- package/src/findings-pass.ts +5 -12
- package/src/framework-lifecycle.ts +1 -1
- package/src/fs/manifest.ts +25 -21
- package/src/generated-file.ts +240 -36
- package/src/graph.ts +3 -6
- package/src/index.ts +1 -1
- package/src/injection-container.ts +1 -1
- package/src/inventory/commonjs.ts +696 -0
- package/src/inventory/enumerate.ts +203 -0
- package/src/inventory/syntax.ts +311 -0
- package/src/inventory.ts +424 -878
- package/src/javascript-file.ts +29 -12
- package/src/load/classify.ts +49 -13
- package/src/load/diagnostics.ts +11 -1
- package/src/load/discover.ts +28 -12
- package/src/load/package-scope.ts +74 -0
- package/src/load/plan.ts +11 -2
- package/src/load/synthesize.ts +6 -6
- package/src/load/test-globals.ts +1 -1
- package/src/load/workspace-manifests.ts +1 -1
- package/src/load/workspace-run.ts +1 -1
- package/src/matrix.ts +7 -14
- package/src/outside-tests.ts +1 -1
- package/src/paths.ts +18 -0
- package/src/platform-calls.ts +119 -0
- package/src/platform-symbols.ts +205 -0
- package/src/position.ts +42 -0
- package/src/ref.ts +11 -20
- package/src/references.ts +383 -73
- package/src/report.ts +1 -1
- package/src/resolve.ts +1 -1
- package/src/{configured-declarations.ts → roots/configured-declarations.ts} +7 -7
- package/src/{entry-point-gaps.ts → roots/entry-point-gaps.ts} +5 -8
- package/src/{manifest.ts → roots/manifest.ts} +5 -5
- package/src/roots/published-reach.ts +481 -0
- package/src/{roots.ts → roots/root-set.ts} +203 -630
- package/src/roots/unseen-loads.ts +307 -0
- package/src/serialization-contract.ts +1 -1
- package/src/session.ts +17 -1
- package/src/source-files.ts +5 -10
- package/src/suppress-inline.ts +53 -89
- package/src/suppress.ts +48 -33
- package/src/test-support.ts +8 -3
- package/src/verbs/analyze.ts +17 -4
- package/src/verbs/describe.ts +5 -2
- package/src/verbs/explain.ts +1 -1
- package/dist/src/build-scripts.js +0 -418
- package/dist/src/conventions.js +0 -907
- package/dist/src/entry-points.js +0 -513
- package/dist/src/roots.js +0 -865
- package/dist/src/unseen-loads.js +0 -100
- package/src/build-scripts.ts +0 -536
- package/src/entry-points.ts +0 -661
- package/src/unseen-loads.ts +0 -134
|
@@ -0,0 +1,507 @@
|
|
|
1
|
+
import { isArrayBindingPattern, isArrowFunction, isAssignmentOperator, isAwaitExpression, isBinaryExpression, isBindingElement, isCallExpression, isClassDeclaration, isClassExpression, isClassStaticBlockDeclaration, isComputedPropertyName, isDeleteExpression, isElementAccessExpression, isEqualityOperator, isExpressionStatement, isForOfStatement, isFunctionDeclaration, isFunctionExpression, isFunctionLikeDeclaration, isGetAccessorDeclaration, isIdentifier, isIfStatement, isMetaProperty, isMethodDeclaration, isNoSubstitutionTemplateLiteral, isNumericLiteral, isObjectBindingPattern, isObjectLiteralExpression, isPostfixUnaryExpression, isPrefixUnaryExpression, isPropertyAccessExpression, isPropertyAssignment, isSetAccessorDeclaration, isShorthandPropertyAssignment, isSourceFile, isSpreadAssignment, isStringLiteral, isTypeOfExpression, isVariableDeclaration, isVariableDeclarationList, isVariableStatement, ModifierFlags, NodeFlags, SyntaxKind, } from "@typescript/native/ast";
|
|
2
|
+
import { componentOf, modifiersOf, } from "../inventory.js";
|
|
3
|
+
import { callsPlatformBy, lexicalBinding, writtenName } from "../platform-calls.js";
|
|
4
|
+
import { spellsNoBinding } from "../spelled-names.js";
|
|
5
|
+
import { unwrapped } from "../unwrap.js";
|
|
6
|
+
/**
|
|
7
|
+
* The export table of a CommonJS file: the module value `module.exports` is assigned and
|
|
8
|
+
* the properties written on it, read from the top-level unconditional statements in order,
|
|
9
|
+
* as Node runs them (https://nodejs.org/api/modules.html#moduleexports). Each entry is
|
|
10
|
+
* keyed by the node that writes it, the checker's declaration of the export where it binds
|
|
11
|
+
* one. Any other write of the exports opens the table: its entries are kept and the file is
|
|
12
|
+
* listed open. `declarationOf` reads a `require()` call through the file's own scopes.
|
|
13
|
+
*/
|
|
14
|
+
export function commonJS(typeIsModule, resolved, declarationOf) {
|
|
15
|
+
return {
|
|
16
|
+
declare(file, owner, into) {
|
|
17
|
+
if (!isCommonJS(file, owner.position.path, typeIsModule)) {
|
|
18
|
+
return;
|
|
19
|
+
}
|
|
20
|
+
const bound = boundOccurrences(file, resolved);
|
|
21
|
+
const free = (node) => !bound.has(node);
|
|
22
|
+
const table = readTable(file, free, topLevelDeclarations(file), lexicalBinding(declarationOf));
|
|
23
|
+
const open = table.open || opens(file, free, table.modelled);
|
|
24
|
+
for (const entry of table.entries.values()) {
|
|
25
|
+
const record = into.declare(entry.node, owner, entry.kind, entry.name, {
|
|
26
|
+
component: entry.component,
|
|
27
|
+
localName: entry.localName,
|
|
28
|
+
});
|
|
29
|
+
record.exported = true;
|
|
30
|
+
const target = entry.target === undefined ? undefined : into.recordAt(entry.target);
|
|
31
|
+
if (target !== undefined) {
|
|
32
|
+
target.exported = true;
|
|
33
|
+
}
|
|
34
|
+
if (entry.members !== undefined) {
|
|
35
|
+
into.container({
|
|
36
|
+
owner: record,
|
|
37
|
+
declaration: entry.members,
|
|
38
|
+
nameNode: entry.members.name,
|
|
39
|
+
members: entry.members.members,
|
|
40
|
+
memberKind: "class-member",
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
// No reference source reads a `require` of the table yet, so whether an entry is
|
|
44
|
+
// used is unknown, and it is held live and reported by nothing.
|
|
45
|
+
into.unanswered(record);
|
|
46
|
+
}
|
|
47
|
+
if (open) {
|
|
48
|
+
into.openTable(owner);
|
|
49
|
+
}
|
|
50
|
+
},
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
/** The bindings whose free occurrence is the module system's own. */
|
|
54
|
+
const WATCHED = ["module", "exports", "require"];
|
|
55
|
+
/**
|
|
56
|
+
* Whether Node runs one file as CommonJS: a `.cjs` file, or a `.js` or `.jsx` file outside a
|
|
57
|
+
* `type: module` package that holds no ECMAScript module syntax
|
|
58
|
+
* (https://nodejs.org/api/packages.html#determining-module-system).
|
|
59
|
+
*/
|
|
60
|
+
function isCommonJS(file, path, typeIsModule) {
|
|
61
|
+
if (file.fileName.endsWith(".cjs")) {
|
|
62
|
+
return true;
|
|
63
|
+
}
|
|
64
|
+
return /\.jsx?$/u.test(file.fileName) && !typeIsModule(path) && !writesModuleSyntax(file);
|
|
65
|
+
}
|
|
66
|
+
/** Whether one file holds an import or export declaration, `import.meta` or a top-level `await`. */
|
|
67
|
+
function writesModuleSyntax(file) {
|
|
68
|
+
const declares = file.statements.some((statement) => (statement.flags & NodeFlags.Reparsed) === 0 &&
|
|
69
|
+
(statement.kind === SyntaxKind.ImportDeclaration ||
|
|
70
|
+
statement.kind === SyntaxKind.ExportDeclaration ||
|
|
71
|
+
statement.kind === SyntaxKind.ExportAssignment ||
|
|
72
|
+
(modifiersOf(statement) & ModifierFlags.Export) !== 0));
|
|
73
|
+
let found = declares;
|
|
74
|
+
const visit = (node, inFunction) => {
|
|
75
|
+
if (found) {
|
|
76
|
+
return;
|
|
77
|
+
}
|
|
78
|
+
if ((isMetaProperty(node) && node.keywordToken === SyntaxKind.ImportKeyword) ||
|
|
79
|
+
(!inFunction &&
|
|
80
|
+
(isAwaitExpression(node) || (isForOfStatement(node) && node.awaitModifier !== undefined)))) {
|
|
81
|
+
found = true;
|
|
82
|
+
return;
|
|
83
|
+
}
|
|
84
|
+
const inner = inFunction || isFunctionLikeDeclaration(node);
|
|
85
|
+
node.forEachChild((child) => {
|
|
86
|
+
visit(child, inner);
|
|
87
|
+
});
|
|
88
|
+
};
|
|
89
|
+
file.forEachChild((child) => {
|
|
90
|
+
visit(child, false);
|
|
91
|
+
});
|
|
92
|
+
return found;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* The occurrences of a watched name that Node binds to a declaration of the file. The
|
|
96
|
+
* compiler resolves each one, and one it leaves unanswered, or resolves to no such
|
|
97
|
+
* declaration, is the module system's own.
|
|
98
|
+
*/
|
|
99
|
+
function boundOccurrences(file, resolved) {
|
|
100
|
+
const occurrences = [];
|
|
101
|
+
const visit = (node) => {
|
|
102
|
+
if (isIdentifier(node)) {
|
|
103
|
+
if (WATCHED.includes(node.text) && !spellsNoBinding(node)) {
|
|
104
|
+
occurrences.push(node);
|
|
105
|
+
}
|
|
106
|
+
return;
|
|
107
|
+
}
|
|
108
|
+
node.forEachChild(visit);
|
|
109
|
+
};
|
|
110
|
+
file.forEachChild(visit);
|
|
111
|
+
const declarations = resolved(occurrences);
|
|
112
|
+
const bound = new Set();
|
|
113
|
+
occurrences.forEach((occurrence, index) => {
|
|
114
|
+
if (declarations[index]?.some((declaration) => bindsOwn(declaration, file)) === true) {
|
|
115
|
+
bound.add(occurrence);
|
|
116
|
+
}
|
|
117
|
+
});
|
|
118
|
+
return bound;
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* Whether one declaration the compiler resolves a watched name to is a binding Node gives
|
|
122
|
+
* it in the file. Where the file is the var scope, a `var`, destructured or not, re-declares
|
|
123
|
+
* a parameter of Node's wrapper, which keeps the module system's value until assigned, and
|
|
124
|
+
* an `if`-clause function binds only in its clause, as the parameter stops it hoisting; the
|
|
125
|
+
* compiler gives each its own symbol, so both read as free (Annex B.3.2, B.3.3,
|
|
126
|
+
* https://tc39.es/ecma262/#sec-functiondeclarationinstantiation).
|
|
127
|
+
*/
|
|
128
|
+
function bindsOwn(declaration, file) {
|
|
129
|
+
if (isSourceFile(declaration) || declaration.getSourceFile() !== file) {
|
|
130
|
+
return false;
|
|
131
|
+
}
|
|
132
|
+
let named = declaration;
|
|
133
|
+
while (isBindingElement(named)) {
|
|
134
|
+
named = named.parent.parent;
|
|
135
|
+
}
|
|
136
|
+
const redeclares = (isVariableDeclaration(named) &&
|
|
137
|
+
isVariableDeclarationList(named.parent) &&
|
|
138
|
+
(named.parent.flags & NodeFlags.BlockScoped) === 0) ||
|
|
139
|
+
(isFunctionDeclaration(declaration) && isIfStatement(declaration.parent));
|
|
140
|
+
return !redeclares || !inFileVarScope(declaration);
|
|
141
|
+
}
|
|
142
|
+
/** Whether no function or class static block encloses one node below its file. */
|
|
143
|
+
function inFileVarScope(node) {
|
|
144
|
+
for (let at = node.parent; !isSourceFile(at); at = at.parent) {
|
|
145
|
+
if (isFunctionLikeDeclaration(at) || isClassStaticBlockDeclaration(at)) {
|
|
146
|
+
return false;
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
return true;
|
|
150
|
+
}
|
|
151
|
+
/** The node that declares each name a file's top-level function, class or variable binds. */
|
|
152
|
+
function topLevelDeclarations(file) {
|
|
153
|
+
const found = new Map();
|
|
154
|
+
const bind = (name, node) => {
|
|
155
|
+
if (isIdentifier(name)) {
|
|
156
|
+
found.set(name.text, node);
|
|
157
|
+
}
|
|
158
|
+
else if (isObjectBindingPattern(name) || isArrayBindingPattern(name)) {
|
|
159
|
+
for (const element of name.elements) {
|
|
160
|
+
if (isBindingElement(element) && element.name !== undefined) {
|
|
161
|
+
bind(element.name, element);
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
};
|
|
166
|
+
for (const statement of file.statements) {
|
|
167
|
+
if ((isFunctionDeclaration(statement) || isClassDeclaration(statement)) && statement.name) {
|
|
168
|
+
found.set(statement.name.text, statement);
|
|
169
|
+
}
|
|
170
|
+
else if (isVariableStatement(statement)) {
|
|
171
|
+
for (const declaration of statement.declarationList.declarations) {
|
|
172
|
+
bind(declaration.name, declaration);
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
return found;
|
|
177
|
+
}
|
|
178
|
+
const DEFAULT = { text: "default", computed: false };
|
|
179
|
+
/** The table one file's top-level unconditional statements write, in order. */
|
|
180
|
+
function readTable(file, isFree, declarations, bindingOf) {
|
|
181
|
+
const entries = new Map();
|
|
182
|
+
const modelled = new Set();
|
|
183
|
+
// Written inside the closures below, which the compiler's narrowing does not follow.
|
|
184
|
+
let open = false;
|
|
185
|
+
let aliasing = true;
|
|
186
|
+
let whole;
|
|
187
|
+
let wholeOpen = false;
|
|
188
|
+
const free = (node, name) => isIdentifier(node) && node.text === name && isFree(node);
|
|
189
|
+
const isModuleExports = (node) => isPropertyAccessExpression(node) &&
|
|
190
|
+
free(node.expression, "module") &&
|
|
191
|
+
node.name.text === "exports";
|
|
192
|
+
const isRequire = (node) => {
|
|
193
|
+
if (!isCallExpression(node) || node.arguments.length !== 1) {
|
|
194
|
+
return false;
|
|
195
|
+
}
|
|
196
|
+
const [argument] = node.arguments;
|
|
197
|
+
const callee = writtenName(node.expression);
|
|
198
|
+
return (argument !== undefined &&
|
|
199
|
+
isLiteralText(argument) &&
|
|
200
|
+
callee !== undefined &&
|
|
201
|
+
callsPlatformBy("require", callee, bindingOf));
|
|
202
|
+
};
|
|
203
|
+
/** What a value written under one key declares. */
|
|
204
|
+
const entryOf = (component, node, name, value) => {
|
|
205
|
+
const held = value === undefined ? undefined : unwrapped(value);
|
|
206
|
+
const base = { node, name, component, localName: undefined, value };
|
|
207
|
+
if (held === undefined) {
|
|
208
|
+
return { ...base, kind: "variable" };
|
|
209
|
+
}
|
|
210
|
+
if ((isIdentifier(held) && declarations.has(held.text)) || isRequire(held)) {
|
|
211
|
+
return { ...base, kind: "export-alias" };
|
|
212
|
+
}
|
|
213
|
+
if (isFunctionExpression(held) || isArrowFunction(held) || isMethodDeclaration(held)) {
|
|
214
|
+
return { ...base, kind: "function" };
|
|
215
|
+
}
|
|
216
|
+
if (isClassExpression(held)) {
|
|
217
|
+
return { ...base, kind: "class", members: held };
|
|
218
|
+
}
|
|
219
|
+
return { ...base, kind: "variable" };
|
|
220
|
+
};
|
|
221
|
+
const property = (node, name, value) => {
|
|
222
|
+
const component = isComputedPropertyName(name) ? undefined : componentOf(name);
|
|
223
|
+
if (component === undefined) {
|
|
224
|
+
open = true;
|
|
225
|
+
return;
|
|
226
|
+
}
|
|
227
|
+
if (component.text === "__esModule") {
|
|
228
|
+
return;
|
|
229
|
+
}
|
|
230
|
+
if (component.text === "default" && entries.get("default")?.component === DEFAULT) {
|
|
231
|
+
// `#default` would name the module value and this property both.
|
|
232
|
+
open = true;
|
|
233
|
+
return;
|
|
234
|
+
}
|
|
235
|
+
entries.delete(component.text);
|
|
236
|
+
entries.set(component.text, entryOf(component, node, name, value));
|
|
237
|
+
};
|
|
238
|
+
const literalProperty = (element) => {
|
|
239
|
+
if (isShorthandPropertyAssignment(element)) {
|
|
240
|
+
property(element, element.name, element.name);
|
|
241
|
+
}
|
|
242
|
+
else if (isPropertyAssignment(element)) {
|
|
243
|
+
property(element, element.name, element.initializer);
|
|
244
|
+
}
|
|
245
|
+
else if (isMethodDeclaration(element)) {
|
|
246
|
+
property(element, element.name, element);
|
|
247
|
+
}
|
|
248
|
+
else if (isGetAccessorDeclaration(element) || isSetAccessorDeclaration(element)) {
|
|
249
|
+
property(element, element.name, undefined);
|
|
250
|
+
}
|
|
251
|
+
else if (!isSpreadAssignment(element) || !isRequire(unwrapped(element.expression))) {
|
|
252
|
+
open = true;
|
|
253
|
+
}
|
|
254
|
+
};
|
|
255
|
+
/** The module value one assignment writes, placed at the `exports` name it assigns. */
|
|
256
|
+
const moduleValue = (node, name) => {
|
|
257
|
+
entries.clear();
|
|
258
|
+
whole = node.right;
|
|
259
|
+
const value = unwrapped(node.right);
|
|
260
|
+
if (isRequire(value)) {
|
|
261
|
+
return;
|
|
262
|
+
}
|
|
263
|
+
if (isObjectLiteralExpression(value)) {
|
|
264
|
+
value.properties.forEach(literalProperty);
|
|
265
|
+
return;
|
|
266
|
+
}
|
|
267
|
+
const base = { node, name, component: DEFAULT, value: node.right };
|
|
268
|
+
const target = isIdentifier(value) ? declarations.get(value.text) : undefined;
|
|
269
|
+
if (target !== undefined) {
|
|
270
|
+
entries.set("default", { ...base, localName: undefined, kind: "export-alias", target });
|
|
271
|
+
}
|
|
272
|
+
else if (isFunctionExpression(value)) {
|
|
273
|
+
entries.set("default", { ...base, localName: value.name?.text, kind: "function" });
|
|
274
|
+
}
|
|
275
|
+
else if (isArrowFunction(value)) {
|
|
276
|
+
entries.set("default", { ...base, localName: undefined, kind: "function" });
|
|
277
|
+
}
|
|
278
|
+
else if (isClassExpression(value)) {
|
|
279
|
+
entries.set("default", {
|
|
280
|
+
...base,
|
|
281
|
+
localName: value.name?.text,
|
|
282
|
+
kind: "class",
|
|
283
|
+
members: value,
|
|
284
|
+
});
|
|
285
|
+
}
|
|
286
|
+
else {
|
|
287
|
+
wholeOpen = true;
|
|
288
|
+
}
|
|
289
|
+
};
|
|
290
|
+
/** Whether one expression is the exports object a top-level write may name here. */
|
|
291
|
+
const exportsObject = (node) => isModuleExports(node) ? "module" : free(node, "exports") ? "exports" : undefined;
|
|
292
|
+
for (const statement of file.statements) {
|
|
293
|
+
if (!isExpressionStatement(statement)) {
|
|
294
|
+
continue;
|
|
295
|
+
}
|
|
296
|
+
const expression = unwrapped(statement.expression);
|
|
297
|
+
if (isBinaryExpression(expression) &&
|
|
298
|
+
expression.operatorToken.kind === SyntaxKind.EqualsToken) {
|
|
299
|
+
const left = expression.left;
|
|
300
|
+
if (free(left, "exports")) {
|
|
301
|
+
modelled.add(expression);
|
|
302
|
+
const inner = unwrapped(expression.right);
|
|
303
|
+
aliasing = false;
|
|
304
|
+
if (isBinaryExpression(inner) &&
|
|
305
|
+
inner.operatorToken.kind === SyntaxKind.EqualsToken &&
|
|
306
|
+
isModuleExports(inner.left)) {
|
|
307
|
+
aliasing = true;
|
|
308
|
+
modelled.add(inner);
|
|
309
|
+
moduleValue(inner, inner.left.name);
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
else if (isModuleExports(left)) {
|
|
313
|
+
modelled.add(expression);
|
|
314
|
+
const inner = unwrapped(expression.right);
|
|
315
|
+
const chained = isBinaryExpression(inner) &&
|
|
316
|
+
inner.operatorToken.kind === SyntaxKind.EqualsToken &&
|
|
317
|
+
free(inner.left, "exports")
|
|
318
|
+
? inner
|
|
319
|
+
: undefined;
|
|
320
|
+
if (chained !== undefined) {
|
|
321
|
+
modelled.add(chained);
|
|
322
|
+
}
|
|
323
|
+
moduleValue(chained ?? expression, left.name);
|
|
324
|
+
aliasing = chained !== undefined;
|
|
325
|
+
}
|
|
326
|
+
else if (isPropertyAccessExpression(left) || isElementAccessExpression(left)) {
|
|
327
|
+
const object = exportsObject(left.expression);
|
|
328
|
+
const key = isPropertyAccessExpression(left) ? left.name : left.argumentExpression;
|
|
329
|
+
if (object === "exports" && !aliasing) {
|
|
330
|
+
// Node discards a write through an `exports` that no longer aliases the module.
|
|
331
|
+
modelled.add(expression);
|
|
332
|
+
}
|
|
333
|
+
else if (object !== undefined &&
|
|
334
|
+
(isPropertyAccessExpression(left) || isLiteralKey(key))) {
|
|
335
|
+
modelled.add(expression);
|
|
336
|
+
property(expression, key, expression.right);
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
continue;
|
|
340
|
+
}
|
|
341
|
+
if (isCallExpression(expression) && isDefineProperty(expression.expression)) {
|
|
342
|
+
const [object, key, descriptor] = expression.arguments;
|
|
343
|
+
const written = object === undefined ? undefined : exportsObject(object);
|
|
344
|
+
if (written === "exports" && !aliasing) {
|
|
345
|
+
modelled.add(expression);
|
|
346
|
+
continue;
|
|
347
|
+
}
|
|
348
|
+
const value = descriptor === undefined ? undefined : describedValue(descriptor);
|
|
349
|
+
if (written !== undefined && key !== undefined && isLiteralText(key) && value !== undefined) {
|
|
350
|
+
modelled.add(expression);
|
|
351
|
+
property(expression, key, value.value);
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
}
|
|
355
|
+
return { entries, open: open || wholeOpen, modelled, whole, membersOpen: open };
|
|
356
|
+
}
|
|
357
|
+
/**
|
|
358
|
+
* The module value one file leaves where Node runs it as CommonJS, read by the one table
|
|
359
|
+
* the inventory's export table reads, or undefined where the file writes module syntax.
|
|
360
|
+
* `declarationOf` names the declaration each name resolves to, undefined for none, as a
|
|
361
|
+
* lexical reading of a file outside every program answers it.
|
|
362
|
+
*/
|
|
363
|
+
export function commonJSModuleValue(file, declarationOf) {
|
|
364
|
+
if (writesModuleSyntax(file)) {
|
|
365
|
+
return undefined;
|
|
366
|
+
}
|
|
367
|
+
const free = (node) => {
|
|
368
|
+
const declaration = isIdentifier(node) ? declarationOf(node) : undefined;
|
|
369
|
+
return declaration === undefined || !bindsOwn(declaration, file);
|
|
370
|
+
};
|
|
371
|
+
const table = readTable(file, free, topLevelDeclarations(file), lexicalBinding(declarationOf));
|
|
372
|
+
const held = table.whole === undefined ? undefined : unwrapped(table.whole);
|
|
373
|
+
const members = [...table.entries.values()].flatMap((entry) => entry.component === DEFAULT && held !== undefined && !isObjectLiteralExpression(held)
|
|
374
|
+
? []
|
|
375
|
+
: [{ key: entry.component.text, value: entry.value, node: entry.node }]);
|
|
376
|
+
return {
|
|
377
|
+
whole: held === undefined || isObjectLiteralExpression(held) ? undefined : table.whole,
|
|
378
|
+
members,
|
|
379
|
+
open: table.membersOpen || opens(file, free, table.modelled),
|
|
380
|
+
};
|
|
381
|
+
}
|
|
382
|
+
/** Whether one node is `Object.defineProperty`. */
|
|
383
|
+
function isDefineProperty(node) {
|
|
384
|
+
return (isPropertyAccessExpression(node) &&
|
|
385
|
+
isIdentifier(node.expression) &&
|
|
386
|
+
node.expression.text === "Object" &&
|
|
387
|
+
node.name.text === "defineProperty");
|
|
388
|
+
}
|
|
389
|
+
/** The value a property descriptor literal gives, where it writes a `value` or a `get`. */
|
|
390
|
+
function describedValue(descriptor) {
|
|
391
|
+
if (!isObjectLiteralExpression(descriptor)) {
|
|
392
|
+
return undefined;
|
|
393
|
+
}
|
|
394
|
+
let found;
|
|
395
|
+
for (const element of descriptor.properties) {
|
|
396
|
+
const key = isSpreadAssignment(element) ? undefined : componentOf(element.name)?.text;
|
|
397
|
+
if (key === "value") {
|
|
398
|
+
return {
|
|
399
|
+
value: isPropertyAssignment(element)
|
|
400
|
+
? element.initializer
|
|
401
|
+
: isMethodDeclaration(element)
|
|
402
|
+
? element
|
|
403
|
+
: undefined,
|
|
404
|
+
};
|
|
405
|
+
}
|
|
406
|
+
if (key === "get") {
|
|
407
|
+
found = { value: undefined };
|
|
408
|
+
}
|
|
409
|
+
}
|
|
410
|
+
return found;
|
|
411
|
+
}
|
|
412
|
+
/** Whether one node is literal text: a string, or a template with no substitution. */
|
|
413
|
+
function isLiteralText(node) {
|
|
414
|
+
return isStringLiteral(node) || isNoSubstitutionTemplateLiteral(node);
|
|
415
|
+
}
|
|
416
|
+
/** Whether one element access key is literal: text or a number. */
|
|
417
|
+
function isLiteralKey(node) {
|
|
418
|
+
return isLiteralText(node) || isNumericLiteral(node);
|
|
419
|
+
}
|
|
420
|
+
/**
|
|
421
|
+
* Whether one file writes its exports anywhere the table does not model: through `module`,
|
|
422
|
+
* `module.exports` or the free `exports` written, assigned, passed or stored outside the
|
|
423
|
+
* statements the scan read, or through a top-level `this`.
|
|
424
|
+
*/
|
|
425
|
+
function opens(file, isFree, modelled) {
|
|
426
|
+
let open = false;
|
|
427
|
+
const visit = (node, thisIsExports) => {
|
|
428
|
+
if (open) {
|
|
429
|
+
return;
|
|
430
|
+
}
|
|
431
|
+
if (isIdentifier(node)) {
|
|
432
|
+
open = opensAt(node, isFree, modelled);
|
|
433
|
+
return;
|
|
434
|
+
}
|
|
435
|
+
if (node.kind === SyntaxKind.ThisKeyword) {
|
|
436
|
+
open = thisIsExports && writes(node, modelled);
|
|
437
|
+
return;
|
|
438
|
+
}
|
|
439
|
+
const fn = isFunctionLikeDeclaration(node);
|
|
440
|
+
const innerThis = thisIsExports &&
|
|
441
|
+
!(fn && !isArrowFunction(node)) &&
|
|
442
|
+
!isClassDeclaration(node) &&
|
|
443
|
+
!isClassExpression(node);
|
|
444
|
+
node.forEachChild((child) => {
|
|
445
|
+
visit(child, innerThis);
|
|
446
|
+
});
|
|
447
|
+
};
|
|
448
|
+
file.forEachChild((child) => {
|
|
449
|
+
visit(child, true);
|
|
450
|
+
});
|
|
451
|
+
return open;
|
|
452
|
+
}
|
|
453
|
+
/** Whether one free occurrence of `module` or `exports` opens the table. */
|
|
454
|
+
function opensAt(node, isFree, modelled) {
|
|
455
|
+
const name = node.text;
|
|
456
|
+
if ((name !== "module" && name !== "exports") || !isFree(node) || spellsNoBinding(node)) {
|
|
457
|
+
return false;
|
|
458
|
+
}
|
|
459
|
+
if (name === "exports") {
|
|
460
|
+
return writes(node, modelled);
|
|
461
|
+
}
|
|
462
|
+
const parent = node.parent;
|
|
463
|
+
if (isPropertyAccessExpression(parent) && parent.expression === node) {
|
|
464
|
+
return parent.name.text === "exports" && writes(parent, modelled);
|
|
465
|
+
}
|
|
466
|
+
if (isElementAccessExpression(parent) && parent.expression === node) {
|
|
467
|
+
return writes(parent, modelled);
|
|
468
|
+
}
|
|
469
|
+
return !readOnly(node);
|
|
470
|
+
}
|
|
471
|
+
/**
|
|
472
|
+
* Whether the exports object one expression names is written, or escapes where it may be
|
|
473
|
+
* written, other than by a write the scan read: assigned, a property of it assigned,
|
|
474
|
+
* incremented or deleted, or the value handed anywhere but a `typeof` or a comparison.
|
|
475
|
+
*/
|
|
476
|
+
function writes(object, modelled) {
|
|
477
|
+
const parent = object.parent;
|
|
478
|
+
if (assigns(parent, object)) {
|
|
479
|
+
return !modelled.has(parent);
|
|
480
|
+
}
|
|
481
|
+
if ((isPropertyAccessExpression(parent) || isElementAccessExpression(parent)) &&
|
|
482
|
+
parent.expression === object) {
|
|
483
|
+
const holder = parent.parent;
|
|
484
|
+
const written = assigns(holder, parent) ||
|
|
485
|
+
isDeleteExpression(holder) ||
|
|
486
|
+
((isPrefixUnaryExpression(holder) || isPostfixUnaryExpression(holder)) &&
|
|
487
|
+
(holder.operator === SyntaxKind.PlusPlusToken ||
|
|
488
|
+
holder.operator === SyntaxKind.MinusMinusToken));
|
|
489
|
+
return written && !modelled.has(holder);
|
|
490
|
+
}
|
|
491
|
+
if (isCallExpression(parent) && modelled.has(parent)) {
|
|
492
|
+
return false;
|
|
493
|
+
}
|
|
494
|
+
return !readOnly(object);
|
|
495
|
+
}
|
|
496
|
+
/** Whether `holder` assigns to `target`, by any assignment operator. */
|
|
497
|
+
function assigns(holder, target) {
|
|
498
|
+
return (isBinaryExpression(holder) &&
|
|
499
|
+
holder.left === target &&
|
|
500
|
+
isAssignmentOperator(holder.operatorToken.kind));
|
|
501
|
+
}
|
|
502
|
+
/** Whether one value is only read: the operand of a `typeof` or of an equality comparison. */
|
|
503
|
+
function readOnly(node) {
|
|
504
|
+
const parent = node.parent;
|
|
505
|
+
return (isTypeOfExpression(parent) ||
|
|
506
|
+
(isBinaryExpression(parent) && isEqualityOperator(parent.operatorToken.kind)));
|
|
507
|
+
}
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
import { isShorthandPropertyAssignment, ModifierFlags } from "@typescript/native/ast";
|
|
2
|
+
import { Builder, modifiersOf, } from "../inventory.js";
|
|
3
|
+
import { packageScope, packageTypeIsModule } from "../load/package-scope.js";
|
|
4
|
+
import { relativePath } from "../paths.js";
|
|
5
|
+
import { renderPosition } from "../position.js";
|
|
6
|
+
import { isAnswered, UNANSWERED } from "../query.js";
|
|
7
|
+
import { declarationOf } from "../entries/static-module.js";
|
|
8
|
+
import { commonJS } from "./commonjs.js";
|
|
9
|
+
import { SYNTAX } from "./syntax.js";
|
|
10
|
+
/**
|
|
11
|
+
* Every declaration one project's own files hold, in rendered position order.
|
|
12
|
+
*
|
|
13
|
+
* `targetRoot` is the absolute path every position is rendered against; a file the program
|
|
14
|
+
* holds that is not below it ends the enumeration. `host` is the filesystem the manifests
|
|
15
|
+
* that name each file's package are read through, and nothing else is read from it.
|
|
16
|
+
*/
|
|
17
|
+
export function inventory(project, host, targetRoot) {
|
|
18
|
+
const files = project.ownSourceFiles();
|
|
19
|
+
const moduleOf = packageScope(host, targetRoot);
|
|
20
|
+
const sources = [
|
|
21
|
+
SYNTAX,
|
|
22
|
+
commonJS(packageTypeIsModule(host, targetRoot), resolvedIn(project), declarationOf),
|
|
23
|
+
];
|
|
24
|
+
const into = new Builder(targetRoot);
|
|
25
|
+
for (const file of files) {
|
|
26
|
+
const path = relativePath(targetRoot, file.fileName);
|
|
27
|
+
if (path === undefined) {
|
|
28
|
+
// renderPosition states the refusal, with the root it was rendered against.
|
|
29
|
+
renderPosition(file, targetRoot, 0);
|
|
30
|
+
continue;
|
|
31
|
+
}
|
|
32
|
+
const owner = into.file(file, moduleOf(path), path);
|
|
33
|
+
for (const source of sources) {
|
|
34
|
+
source.declare(file, owner, into);
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
return into.build(readTables(project, into, new Set(files.map((file) => file.fileName))));
|
|
38
|
+
}
|
|
39
|
+
/** The declarations of this program each occurrence resolves to, asked in one batch. */
|
|
40
|
+
function resolvedIn(project) {
|
|
41
|
+
return (occurrences) => {
|
|
42
|
+
const symbols = project.symbolsAt(occurrences.map((occurrence) => project.handle(occurrence)));
|
|
43
|
+
return occurrences.map((occurrence, index) => {
|
|
44
|
+
// A shorthand property's name resolves to the property it declares, not the binding.
|
|
45
|
+
const symbol = isShorthandPropertyAssignment(occurrence.parent)
|
|
46
|
+
? project.shorthandValueAt(project.handle(occurrence.parent))
|
|
47
|
+
: symbols[index];
|
|
48
|
+
return typeof symbol === "object"
|
|
49
|
+
? symbol.declarations.flatMap((declaration) => project.declarationAt(declaration)?.node ?? [])
|
|
50
|
+
: [];
|
|
51
|
+
});
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* The binder's half: which declarations each module and namespace exports, and the members
|
|
56
|
+
* each container's symbol tables hold, then the members only its tree holds. One batch
|
|
57
|
+
* resolves every scope and container, because an accessor with an array overload costs one
|
|
58
|
+
* round trip for the batch and one per node without it.
|
|
59
|
+
*/
|
|
60
|
+
function readTables(project, into, ownFiles) {
|
|
61
|
+
const scopes = into.exportScopes;
|
|
62
|
+
const named = into.containers.filter((container) => container.nameNode !== undefined);
|
|
63
|
+
const batched = [
|
|
64
|
+
...scopes.map((scope) => scope.nameNode),
|
|
65
|
+
...named.flatMap((container) => container.nameNode ?? []),
|
|
66
|
+
];
|
|
67
|
+
const handles = batched.map((node) => project.handle(node));
|
|
68
|
+
const resolved = project.symbolsAt(handles);
|
|
69
|
+
const symbolOf = new Map();
|
|
70
|
+
batched.forEach((node, index) => {
|
|
71
|
+
const symbol = resolved[index];
|
|
72
|
+
if (typeof symbol === "object") {
|
|
73
|
+
symbolOf.set(node, symbol);
|
|
74
|
+
}
|
|
75
|
+
});
|
|
76
|
+
// A scope or a container whose symbol or table went unanswered keeps what its syntax
|
|
77
|
+
// declares, and everything under it is recorded unanswered.
|
|
78
|
+
scopes.forEach((scope, index) => {
|
|
79
|
+
if (resolved[index] === UNANSWERED) {
|
|
80
|
+
into.unanswered(scope.owner);
|
|
81
|
+
}
|
|
82
|
+
});
|
|
83
|
+
named.forEach((container, index) => {
|
|
84
|
+
if (resolved[scopes.length + index] === UNANSWERED) {
|
|
85
|
+
into.unanswered(container.owner);
|
|
86
|
+
}
|
|
87
|
+
});
|
|
88
|
+
let exportTables = 0;
|
|
89
|
+
for (const scope of scopes) {
|
|
90
|
+
const symbol = symbolOf.get(scope.nameNode);
|
|
91
|
+
if (symbol === undefined) {
|
|
92
|
+
continue;
|
|
93
|
+
}
|
|
94
|
+
exportTables += 1;
|
|
95
|
+
const table = project.queries.exportsOf(symbol);
|
|
96
|
+
if (!isAnswered(table)) {
|
|
97
|
+
into.unanswered(scope.owner);
|
|
98
|
+
continue;
|
|
99
|
+
}
|
|
100
|
+
for (const [, exported] of table) {
|
|
101
|
+
for (const declaration of exported.declarations) {
|
|
102
|
+
const held = project.declarationAt(declaration);
|
|
103
|
+
const record = held === undefined ? undefined : into.recordAt(held.node);
|
|
104
|
+
if (record !== undefined) {
|
|
105
|
+
record.exported = true;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
let memberTables = 0;
|
|
111
|
+
const readTable = (container, table, seen, areStatic) => {
|
|
112
|
+
for (const [, member] of table) {
|
|
113
|
+
const declarations = member.declarations.flatMap((handle) => project.declarationAt(handle) ?? []);
|
|
114
|
+
// A member with no declaration is the language's own (a class's `prototype`), and a
|
|
115
|
+
// member declared outside the target's own files belongs to another program. A
|
|
116
|
+
// merged symbol's table holds the members every one of its declarations writes, and
|
|
117
|
+
// each member is kept once, by the declaration that writes it.
|
|
118
|
+
for (const held of declarations) {
|
|
119
|
+
const node = held.node;
|
|
120
|
+
if (ownFiles.has(node.getSourceFile().fileName) &&
|
|
121
|
+
writtenInside(container.declaration, node)) {
|
|
122
|
+
into.member(container, node, seen, areStatic);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
};
|
|
127
|
+
for (const container of into.containers) {
|
|
128
|
+
const symbol = container.nameNode === undefined ? undefined : symbolOf.get(container.nameNode);
|
|
129
|
+
const seen = new Map();
|
|
130
|
+
const isClass = container.memberKind === "class-member";
|
|
131
|
+
const isEnum = container.memberKind === "enum-member";
|
|
132
|
+
if (symbol !== undefined) {
|
|
133
|
+
if (!isEnum) {
|
|
134
|
+
memberTables += 1;
|
|
135
|
+
const table = project.queries.membersOf(symbol);
|
|
136
|
+
if (isAnswered(table)) {
|
|
137
|
+
readTable(container, table, seen, false);
|
|
138
|
+
}
|
|
139
|
+
else {
|
|
140
|
+
into.unanswered(container.owner);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
if (isEnum || isClass) {
|
|
144
|
+
memberTables += 1;
|
|
145
|
+
const table = project.queries.exportsOf(symbol);
|
|
146
|
+
if (isAnswered(table)) {
|
|
147
|
+
readTable(container, table, seen, isClass);
|
|
148
|
+
}
|
|
149
|
+
else {
|
|
150
|
+
into.unanswered(container.owner);
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
// A member whose key is computed is bound to the container's type later than the
|
|
155
|
+
// table is built, so only the container's own declaration names it.
|
|
156
|
+
for (const member of container.members) {
|
|
157
|
+
into.member(container, member, seen, (modifiersOf(member) & ModifierFlags.Static) !== 0);
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
return { batches: 1, exportTables, memberTables };
|
|
161
|
+
}
|
|
162
|
+
/** Whether `node` is written inside `declaration`, compared by file and range. */
|
|
163
|
+
function writtenInside(declaration, node) {
|
|
164
|
+
return (node.getSourceFile().fileName === declaration.getSourceFile().fileName &&
|
|
165
|
+
declaration.pos <= node.pos &&
|
|
166
|
+
node.end <= declaration.end);
|
|
167
|
+
}
|