@starci/eslint-canon-be 3.8.20 → 3.9.0
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/CHANGELOG.md +8 -0
- package/package.json +1 -1
- package/runtime/bundle.json +192 -0
- package/runtime/engine/by-code-unit.mjs +6 -6
- package/runtime/engine/model-config.mjs +98 -76
- package/runtime/engine/orca-config.mjs +22 -17
- package/runtime/engine/release-config.mjs +22 -18
- package/runtime/engine/removed-vocabulary.mjs +21 -20
- package/runtime/engine/resources-config.mjs +42 -35
- package/runtime/engine/runtime-root.mjs +11 -13
- package/runtime/engine/secrets.mjs +170 -102
- package/runtime/engine/sonar-config.mjs +16 -13
- package/runtime/engine/temp-root.mjs +3 -9
- package/runtime/knowledge/hfs/canon-pins.yaml +10 -10
- package/runtime/knowledge/hfs/rules.yaml +6 -6
- package/runtime/knowledge/hfs/slots.yaml +2 -2
- package/runtime/knowledge/sonar-gate.yaml +1 -1
- package/runtime/packages/hfs/templates/app/package-scripts/package.json +1 -1
- package/runtime/scripts/api/git/cat-file.mjs +0 -1
- package/runtime/scripts/api/git/config-get.mjs +1 -2
- package/runtime/scripts/api/git/diff.mjs +0 -1
- package/runtime/scripts/api/git/lib.mjs +32 -32
- package/runtime/scripts/api/git/ls-files.mjs +0 -1
- package/runtime/scripts/api/git/ls-tree.mjs +0 -1
- package/runtime/scripts/api/git/merge-base.mjs +2 -3
- package/runtime/scripts/api/git/remote.mjs +0 -1
- package/runtime/scripts/api/git/rev-parse-query.mjs +0 -1
- package/runtime/scripts/api/git/show.mjs +0 -1
- package/runtime/scripts/hfs/allows.mjs +37 -38
- package/runtime/scripts/hfs/architecture/ast-walks.mjs +180 -163
- package/runtime/scripts/hfs/architecture/automatic-gates.mjs +80 -73
- package/runtime/scripts/hfs/architecture/backend-app-files.mjs +88 -77
- package/runtime/scripts/hfs/architecture/backend.mjs +378 -357
- package/runtime/scripts/hfs/architecture/background-unowned.mjs +201 -187
- package/runtime/scripts/hfs/architecture/canon-clones.mjs +260 -209
- package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +149 -116
- package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +72 -68
- package/runtime/scripts/hfs/architecture/clones.mjs +212 -217
- package/runtime/scripts/hfs/architecture/config-unread.mjs +7 -9
- package/runtime/scripts/hfs/architecture/config.mjs +302 -268
- package/runtime/scripts/hfs/architecture/connection-map.mjs +258 -225
- package/runtime/scripts/hfs/architecture/constructor-deps.mjs +80 -71
- package/runtime/scripts/hfs/architecture/context-coupling.mjs +82 -77
- package/runtime/scripts/hfs/architecture/context-map.mjs +267 -234
- package/runtime/scripts/hfs/architecture/context-owner.mjs +73 -61
- package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +47 -43
- package/runtime/scripts/hfs/architecture/context-transaction.mjs +54 -52
- package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +113 -104
- package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +288 -270
- package/runtime/scripts/hfs/architecture/contracts.mjs +408 -393
- package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +50 -51
- package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +143 -119
- package/runtime/scripts/hfs/architecture/dead-exports.mjs +286 -228
- package/runtime/scripts/hfs/architecture/default-deny.mjs +129 -110
- package/runtime/scripts/hfs/architecture/doc-language.mjs +24 -19
- package/runtime/scripts/hfs/architecture/entity-registry.mjs +20 -22
- package/runtime/scripts/hfs/architecture/entrypoint.mjs +47 -45
- package/runtime/scripts/hfs/architecture/error-codes.mjs +37 -35
- package/runtime/scripts/hfs/architecture/error-masked.mjs +55 -59
- package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +24 -23
- package/runtime/scripts/hfs/architecture/feature-shape.mjs +40 -38
- package/runtime/scripts/hfs/architecture/framework-pinned.mjs +21 -21
- package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +106 -98
- package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +153 -150
- package/runtime/scripts/hfs/architecture/frontend-routing.mjs +161 -149
- package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +343 -305
- package/runtime/scripts/hfs/architecture/frontend-world.mjs +340 -294
- package/runtime/scripts/hfs/architecture/frontend.mjs +174 -184
- package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +124 -106
- package/runtime/scripts/hfs/architecture/hfs-graph.mjs +52 -48
- package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +81 -71
- package/runtime/scripts/hfs/architecture/i18n-keys.mjs +155 -141
- package/runtime/scripts/hfs/architecture/identity.mjs +141 -125
- package/runtime/scripts/hfs/architecture/index.mjs +272 -272
- package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +45 -43
- package/runtime/scripts/hfs/architecture/jwt-ast.mjs +195 -176
- package/runtime/scripts/hfs/architecture/machine-ast.mjs +163 -155
- package/runtime/scripts/hfs/architecture/managed-scripts.mjs +19 -20
- package/runtime/scripts/hfs/architecture/module-per-transport.mjs +177 -172
- package/runtime/scripts/hfs/architecture/next-data-contract.mjs +100 -78
- package/runtime/scripts/hfs/architecture/next-data-inference.mjs +170 -154
- package/runtime/scripts/hfs/architecture/next-data-key.mjs +311 -275
- package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +17 -17
- package/runtime/scripts/hfs/architecture/next-data.mjs +351 -334
- package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +39 -37
- package/runtime/scripts/hfs/architecture/owners.mjs +97 -98
- package/runtime/scripts/hfs/architecture/package-shape.mjs +56 -55
- package/runtime/scripts/hfs/architecture/presentation.mjs +138 -130
- package/runtime/scripts/hfs/architecture/reachability.mjs +258 -241
- package/runtime/scripts/hfs/architecture/register-once.mjs +152 -139
- package/runtime/scripts/hfs/architecture/registration.mjs +301 -267
- package/runtime/scripts/hfs/architecture/required-files.mjs +172 -167
- package/runtime/scripts/hfs/architecture/route-files-thin.mjs +85 -77
- package/runtime/scripts/hfs/architecture/schema-owner.mjs +206 -181
- package/runtime/scripts/hfs/architecture/server-action.mjs +48 -48
- package/runtime/scripts/hfs/architecture/side-boundary.mjs +2 -5
- package/runtime/scripts/hfs/architecture/source-names-shape.mjs +261 -259
- package/runtime/scripts/hfs/architecture/source-names.mjs +304 -278
- package/runtime/scripts/hfs/architecture/sql-keys.mjs +277 -194
- package/runtime/scripts/hfs/architecture/sql-owner.mjs +236 -194
- package/runtime/scripts/hfs/architecture/sql-returning.mjs +46 -45
- package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +86 -74
- package/runtime/scripts/hfs/architecture/sql-tokens.mjs +456 -341
- package/runtime/scripts/hfs/architecture/staged-consumers.mjs +35 -30
- package/runtime/scripts/hfs/architecture/surface.mjs +64 -74
- package/runtime/scripts/hfs/architecture/symbols.mjs +209 -216
- package/runtime/scripts/hfs/architecture/test-world-files.mjs +165 -155
- package/runtime/scripts/hfs/architecture/tiers.mjs +161 -154
- package/runtime/scripts/hfs/architecture/transport-owner.mjs +155 -149
- package/runtime/scripts/hfs/architecture/type-context.mjs +255 -250
- package/runtime/scripts/hfs/architecture/typescript.mjs +358 -318
- package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +110 -92
- package/runtime/scripts/hfs/declaration-shape.mjs +140 -103
- package/runtime/scripts/hfs/declaration-slots.mjs +64 -61
- package/runtime/scripts/hfs/edition-slots.mjs +43 -40
- package/runtime/scripts/hfs/linear-text.mjs +20 -20
- package/runtime/scripts/hfs/param-names.mjs +6 -11
- package/runtime/scripts/hfs/path-findings.mjs +120 -100
- package/runtime/scripts/hfs/repo-identity.mjs +55 -42
- package/runtime/scripts/hfs/rule-catalog.mjs +353 -257
- package/runtime/scripts/hfs/rule-params-shape.mjs +60 -47
- package/runtime/scripts/hfs/rules/database-migrations.mjs +428 -388
- package/runtime/scripts/hfs/rules/fe-no-tests.mjs +37 -36
- package/runtime/scripts/hfs/rules/read.mjs +19 -15
- package/runtime/scripts/hfs/rules/secrets.mjs +1 -1
- package/runtime/scripts/hfs/rules/spec-placement.mjs +12 -13
- package/runtime/scripts/hfs/slot-app-view.mjs +69 -74
- package/runtime/scripts/hfs/slot-classify.mjs +42 -38
- package/runtime/scripts/hfs/slot-errors.mjs +8 -7
- package/runtime/scripts/hfs/slot-imports.mjs +70 -63
- package/runtime/scripts/hfs/slot-manifest-shape.mjs +74 -52
- package/runtime/scripts/hfs/slot-match.mjs +122 -111
- package/runtime/scripts/hfs/slot-path.mjs +0 -2
- package/runtime/scripts/hfs/slot-required.mjs +65 -59
- package/runtime/scripts/hfs/slot-semantic-problems.mjs +138 -112
- package/runtime/scripts/hfs/slot-side-problems.mjs +23 -19
- package/runtime/scripts/hfs/slots.mjs +175 -152
- package/runtime/scripts/hfs/test-world-slot.mjs +0 -1
- package/runtime/scripts/hfs/trailing-slashes.mjs +4 -4
- package/runtime/scripts/hfs/typescript-programs.mjs +66 -69
- package/runtime/scripts/hfs/view.mjs +38 -40
- package/runtime/scripts/lib/dockerfile.mjs +131 -114
- package/runtime/scripts/lib/env.mjs +3 -6
- package/runtime/scripts/lib/event-contract.mjs +73 -78
- package/runtime/scripts/lib/git.mjs +15 -16
- package/runtime/scripts/lib/glob.mjs +23 -14
- package/runtime/scripts/lib/grammar-lint.mjs +33 -37
- package/runtime/scripts/lib/i18n.mjs +32 -35
- package/runtime/scripts/lib/in-order.mjs +57 -38
- package/runtime/scripts/lib/json-clone.mjs +45 -36
- package/runtime/scripts/lib/json.mjs +26 -14
- package/runtime/scripts/lib/language.mjs +133 -129
- package/runtime/scripts/lib/list.mjs +9 -14
- package/runtime/scripts/lib/mutation-fence.mjs +10 -5
- package/runtime/scripts/lib/path-key.mjs +53 -38
- package/runtime/scripts/lib/read-text.mjs +30 -17
- package/runtime/scripts/lib/regex.mjs +1 -2
- package/runtime/scripts/lib/same-text.mjs +0 -1
- package/runtime/scripts/lib/sops-envelope.mjs +148 -120
- package/runtime/scripts/lib/stack-services.mjs +128 -129
- package/runtime/scripts/lib/ts-analysis.mjs +28 -26
- package/runtime/scripts/lib/ts-ast.mjs +36 -42
- package/runtime/scripts/lib/walk.mjs +33 -27
- package/runtime/scripts/lib/yaml-cached.mjs +4 -4
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { createHash } from 'node:crypto';
|
|
2
2
|
import path from 'node:path';
|
|
3
|
-
|
|
4
3
|
/**
|
|
5
4
|
* R21 `cross-app-duplicate` (FE_CROSS_APP_DUPLICATE): the slot manifest's `crossApp` law says apps never import each other and
|
|
6
5
|
* shared code is a `packages/<pkg>` slot. `HFS_DUPLICATE_CODE` sees blocks of a size inside the owner graph; this sees whole
|
|
@@ -13,70 +12,70 @@ import path from 'node:path';
|
|
|
13
12
|
* Not source, so not judged: declaration files and everything that is not .ts/.tsx (JSON catalogs, CSS).
|
|
14
13
|
*/
|
|
15
14
|
export const CROSS_APP_DUPLICATE_RULE_IDS = ['FE_CROSS_APP_DUPLICATE'];
|
|
16
|
-
|
|
17
15
|
const RULE = 'FE_CROSS_APP_DUPLICATE';
|
|
18
16
|
const SOURCE = /\.[cm]?tsx?$/u;
|
|
19
|
-
|
|
20
17
|
/** The app a file belongs to: the slot binding when a slot owns it, else the declared app whose directory holds it. */
|
|
21
18
|
const appOf = (resolver, declaredApps, rel) => resolver.classifyPath(rel).bindings?.app ?? declaredApps.find(name => rel.startsWith(`apps/${name}/`)) ?? null;
|
|
22
|
-
|
|
23
19
|
const onlyModuleEdges = (ts, file) => file.sourceFile.statements.every(statement => ts.isImportDeclaration(statement) || ts.isExportDeclaration(statement)
|
|
24
|
-
|
|
25
|
-
|
|
20
|
+
|| (ts.isExportAssignment(statement) && ts.isIdentifier(statement.expression)));
|
|
26
21
|
const leafText = (SyntaxKind, node, sourceFile) => (node.kind === SyntaxKind.JsxText ? node.getText(sourceFile).replace(/\s+/gu, ' ').trim() : node.getText(sourceFile));
|
|
27
|
-
|
|
28
22
|
function collectTokens(SyntaxKind, sourceFile, node, parts) {
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
23
|
+
if (node.kind >= SyntaxKind.FirstJSDocNode && node.kind <= SyntaxKind.LastJSDocNode)
|
|
24
|
+
return;
|
|
25
|
+
if (node.kind === SyntaxKind.JsxText && node.containsOnlyTriviaWhiteSpaces)
|
|
26
|
+
return;
|
|
27
|
+
const children = node.getChildren(sourceFile);
|
|
28
|
+
if (!children.length) {
|
|
29
|
+
if (node.kind !== SyntaxKind.EndOfFileToken)
|
|
30
|
+
parts.push(leafText(SyntaxKind, node, sourceFile));
|
|
31
|
+
return;
|
|
32
|
+
}
|
|
33
|
+
for (const child of children)
|
|
34
|
+
collectTokens(SyntaxKind, sourceFile, child, parts);
|
|
37
35
|
}
|
|
38
|
-
|
|
39
36
|
const tokenText = (SyntaxKind, sourceFile) => {
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
37
|
+
const parts = [];
|
|
38
|
+
collectTokens(SyntaxKind, sourceFile, sourceFile, parts);
|
|
39
|
+
return parts.join('\u0000');
|
|
43
40
|
};
|
|
44
|
-
|
|
45
41
|
/** Groups the comparable files by the hash of their token text; returns the groups and the number of files compared. */
|
|
46
42
|
function groupByContent(graph, ts, declaredApps) {
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
43
|
+
const groups = new Map();
|
|
44
|
+
let files = 0;
|
|
45
|
+
for (const file of graph.files.values()) {
|
|
46
|
+
if (!SOURCE.test(file.rel) || /\.d\.[cm]?tsx?$/u.test(file.rel))
|
|
47
|
+
continue;
|
|
48
|
+
const app = appOf(graph.resolver, declaredApps, file.rel);
|
|
49
|
+
if (!app || onlyModuleEdges(ts, file) || !file.sourceFile.statements.length)
|
|
50
|
+
continue;
|
|
51
|
+
files += 1;
|
|
52
|
+
const key = createHash('sha256').update(tokenText(ts.SyntaxKind, file.sourceFile)).digest('hex');
|
|
53
|
+
if (!groups.has(key))
|
|
54
|
+
groups.set(key, []);
|
|
55
|
+
groups.get(key)?.push({ rel: file.rel, app });
|
|
56
|
+
}
|
|
57
|
+
return { groups, files };
|
|
59
58
|
}
|
|
60
|
-
|
|
61
59
|
const duplicateViolation = (group, item) => {
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
60
|
+
const twins = group.filter(other => other.app !== item.app).map(other => other.rel);
|
|
61
|
+
return {
|
|
62
|
+
ruleId: RULE, path: item.rel, line: 1, column: 1, twins,
|
|
63
|
+
message: `${item.rel} is token-for-token the same file as ${twins.join(', ')} in another app (comments and whitespace ignored); shared code is a packages/<pkg> slot. Move it to a package (packages/<pkg>) and let each app re-export it (${path.posix.basename(item.rel)} keeps only an import or export statement).`,
|
|
64
|
+
};
|
|
67
65
|
};
|
|
68
|
-
|
|
69
66
|
export function checkCrossAppDuplicate({ graph, context }) {
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
67
|
+
const ts = context.ts;
|
|
68
|
+
const declaredApps = graph.resolver.repo.apps.map((app) => app.name);
|
|
69
|
+
const { groups, files } = groupByContent(graph, ts, declaredApps);
|
|
70
|
+
const violations = [];
|
|
71
|
+
let duplicated = 0;
|
|
72
|
+
for (const group of groups.values()) {
|
|
73
|
+
if (new Set(group.map(item => item.app)).size < 2)
|
|
74
|
+
continue;
|
|
75
|
+
duplicated += 1;
|
|
76
|
+
group.sort((a, b) => a.rel.localeCompare(b.rel));
|
|
77
|
+
for (const item of group)
|
|
78
|
+
violations.push(duplicateViolation(group, item));
|
|
79
|
+
}
|
|
80
|
+
return { violations, coverage: { status: 'checked', files, duplicatedGroups: duplicated } };
|
|
82
81
|
}
|
|
@@ -1,149 +1,173 @@
|
|
|
1
1
|
// Import and namespace consumption analysis shared by dead-export edges.
|
|
2
2
|
import path from 'node:path';
|
|
3
|
-
|
|
4
3
|
/** Disk/staged test consumers have no production checker; bind their local names without resolving dependencies. */
|
|
5
4
|
const namespaceChecker = (context, sourceFile, namespace) => {
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
5
|
+
const cached = context.namespaceCheckers.get(sourceFile);
|
|
6
|
+
if (cached)
|
|
7
|
+
return cached;
|
|
8
|
+
const { ts } = context;
|
|
9
|
+
let checker = context.checkerFor?.(sourceFile.fileName);
|
|
10
|
+
if (!checker?.getSymbolAtLocation(namespace.name)) {
|
|
11
|
+
const options = { noResolve: true, noLib: true, types: [], allowJs: true, target: ts.ScriptTarget.Latest };
|
|
12
|
+
const host = ts.createCompilerHost(options);
|
|
13
|
+
const filename = path.resolve(sourceFile.fileName);
|
|
14
|
+
host.getSourceFile = file => path.resolve(file) === filename ? sourceFile : undefined;
|
|
15
|
+
host.fileExists = file => path.resolve(file) === filename;
|
|
16
|
+
host.readFile = file => path.resolve(file) === filename ? sourceFile.text : undefined;
|
|
17
|
+
checker = ts.createProgram([filename], options, host).getTypeChecker();
|
|
18
|
+
}
|
|
19
|
+
context.namespaceCheckers.set(sourceFile, checker);
|
|
20
|
+
return checker;
|
|
20
21
|
};
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
22
|
+
const transparentExpression = (ts, node) => !!node && (ts.isParenthesizedExpression(node) || ts.isAsExpression(node)
|
|
23
|
+
|| ts.isTypeAssertionExpression(node) || ts.isNonNullExpression(node) || ts.isSatisfiesExpression(node));
|
|
24
|
+
const literalMember = (ts, input) => {
|
|
25
|
+
let node = input;
|
|
26
|
+
while (transparentExpression(ts, node))
|
|
27
|
+
node = node.expression;
|
|
28
|
+
return node && (ts.isStringLiteralLike(node) || ts.isNumericLiteral(node)) ? node.text : null;
|
|
28
29
|
};
|
|
29
|
-
|
|
30
30
|
const destructuredMember = (ts, name) => {
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
31
|
+
if (ts.isIdentifier(name))
|
|
32
|
+
return name.text;
|
|
33
|
+
if (ts.isComputedPropertyName(name))
|
|
34
|
+
return literalMember(ts, name.expression);
|
|
35
|
+
return literalMember(ts, name);
|
|
34
36
|
};
|
|
35
|
-
|
|
36
37
|
/** A destructuring alias consumes the property's name, while a rest/computed binding may consume every export. */
|
|
37
38
|
const destructuredBindings = (ts, pattern) => {
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
39
|
+
const names = [];
|
|
40
|
+
const elements = ts.isObjectBindingPattern(pattern) ? pattern.elements : pattern.properties;
|
|
41
|
+
for (const element of elements) {
|
|
42
|
+
if (ts.isSpreadAssignment(element) || (ts.isBindingElement(element) && element.dotDotDotToken))
|
|
43
|
+
return { all: true, pairs: [] };
|
|
44
|
+
const name = destructuredMember(ts, ts.isBindingElement(element) ? element.propertyName ?? element.name : element.name);
|
|
45
|
+
if (name === null)
|
|
46
|
+
return { all: true, pairs: [] };
|
|
47
|
+
names.push(name);
|
|
48
|
+
}
|
|
49
|
+
return { all: false, pairs: names.map(imported => ({ imported, exported: null })) };
|
|
47
50
|
};
|
|
48
|
-
|
|
49
51
|
const namespaceReference = (ts, checker, symbol, node) => {
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
52
|
+
if (checker.getSymbolAtLocation(node) === symbol)
|
|
53
|
+
return true;
|
|
54
|
+
const parent = node.parent;
|
|
55
|
+
if (ts.isShorthandPropertyAssignment(parent) && parent.name === node)
|
|
56
|
+
return checker.getShorthandAssignmentValueSymbol(parent) === symbol;
|
|
57
|
+
return ts.isExportSpecifier(parent) && node === (parent.propertyName ?? parent.name)
|
|
58
|
+
&& checker.getExportSpecifierLocalTargetSymbol(parent) === symbol;
|
|
55
59
|
};
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
+
const unwrappedNamespace = (ts, input) => {
|
|
61
|
+
let node = input;
|
|
62
|
+
while (transparentExpression(ts, node.parent))
|
|
63
|
+
node = node.parent;
|
|
64
|
+
return node;
|
|
60
65
|
};
|
|
61
|
-
|
|
62
66
|
const indexedNamespaceMember = (ts, node) => {
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
67
|
+
if (!ts.isTypeQueryNode(node.parent) || node.parent.exprName !== node)
|
|
68
|
+
return null;
|
|
69
|
+
let query = node.parent;
|
|
70
|
+
while (ts.isParenthesizedTypeNode(query.parent))
|
|
71
|
+
query = query.parent;
|
|
72
|
+
const indexed = query.parent;
|
|
73
|
+
return ts.isIndexedAccessTypeNode(indexed) && indexed.objectType === query && ts.isLiteralTypeNode(indexed.indexType)
|
|
74
|
+
? literalMember(ts, indexed.indexType.literal) : null;
|
|
69
75
|
};
|
|
70
|
-
|
|
71
76
|
/** The first member is the entry export even in a chain such as namespace.Enum.Member or namespace.Type.Inner. */
|
|
72
77
|
const namespaceUse = (ts, reference) => {
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
78
|
+
const node = unwrappedNamespace(ts, reference);
|
|
79
|
+
const parent = node.parent;
|
|
80
|
+
let name = null;
|
|
81
|
+
if (ts.isPropertyAccessExpression(parent) && parent.expression === node)
|
|
82
|
+
name = parent.name.text;
|
|
83
|
+
else if (ts.isQualifiedName(parent) && parent.left === node)
|
|
84
|
+
name = parent.right.text;
|
|
85
|
+
else if (ts.isElementAccessExpression(parent) && parent.expression === node)
|
|
86
|
+
name = literalMember(ts, parent.argumentExpression);
|
|
87
|
+
else if (ts.isVariableDeclaration(parent) && parent.initializer === node && ts.isObjectBindingPattern(parent.name))
|
|
88
|
+
return destructuredBindings(ts, parent.name);
|
|
89
|
+
else if (ts.isBinaryExpression(parent) && parent.right === node && parent.operatorToken.kind === ts.SyntaxKind.EqualsToken
|
|
90
|
+
&& ts.isObjectLiteralExpression(parent.left))
|
|
91
|
+
return destructuredBindings(ts, parent.left);
|
|
92
|
+
else
|
|
93
|
+
name = indexedNamespaceMember(ts, node);
|
|
94
|
+
return name === null ? { all: true, pairs: [] } : { all: false, pairs: [{ imported: name, exported: null }] };
|
|
84
95
|
};
|
|
85
|
-
|
|
86
96
|
const namespaceBindings = (context, declaration, namespace) => {
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
97
|
+
const cached = context.namespaceUses.get(namespace);
|
|
98
|
+
if (cached)
|
|
99
|
+
return cached;
|
|
100
|
+
const { ts } = context;
|
|
101
|
+
const sourceFile = declaration.getSourceFile();
|
|
102
|
+
const checker = namespaceChecker(context, sourceFile, namespace);
|
|
103
|
+
const symbol = checker.getSymbolAtLocation(namespace.name);
|
|
104
|
+
const result = { all: false, pairs: [] };
|
|
105
|
+
const visit = (node) => {
|
|
106
|
+
if (ts.isJSDocSeeTag(node) || ts.isJSDocLink(node) || ts.isJSDocLinkCode(node) || ts.isJSDocLinkPlain(node))
|
|
107
|
+
return;
|
|
108
|
+
if (ts.isIdentifier(node) && node !== namespace.name && namespaceReference(ts, checker, symbol, node)) {
|
|
109
|
+
const used = namespaceUse(ts, node);
|
|
110
|
+
result.all ||= used.all;
|
|
111
|
+
result.pairs.push(...used.pairs);
|
|
112
|
+
}
|
|
113
|
+
if (!result.all) {
|
|
114
|
+
ts.forEachChild(node, visit);
|
|
115
|
+
// `jsDoc` is a compiler-internal field of the nodes that carry documentation comments.
|
|
116
|
+
for (const doc of node.jsDoc ?? [])
|
|
117
|
+
visit(doc);
|
|
118
|
+
}
|
|
119
|
+
};
|
|
120
|
+
// An unavailable binding must never turn an unknown consumer into a false unused-export finding.
|
|
121
|
+
if (symbol)
|
|
122
|
+
visit(sourceFile);
|
|
123
|
+
else
|
|
124
|
+
result.all = true;
|
|
125
|
+
context.namespaceUses.set(namespace, result);
|
|
126
|
+
return result;
|
|
110
127
|
};
|
|
111
|
-
|
|
112
128
|
const importBindings = (context, declaration) => {
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
const
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
129
|
+
const { ts } = context;
|
|
130
|
+
const clause = declaration.importClause;
|
|
131
|
+
if (!clause)
|
|
132
|
+
return { all: false, pairs: [] }; // side-effect import: uses nothing
|
|
133
|
+
const pairs = [];
|
|
134
|
+
if (clause.name)
|
|
135
|
+
pairs.push({ imported: 'default', exported: null });
|
|
136
|
+
const named = clause.namedBindings;
|
|
137
|
+
if (named && named.kind === ts.SyntaxKind.NamespaceImport) {
|
|
138
|
+
const namespace = namespaceBindings(context, declaration, named);
|
|
139
|
+
return { all: namespace.all, pairs: [...pairs, ...namespace.pairs] };
|
|
140
|
+
}
|
|
141
|
+
if (named)
|
|
142
|
+
for (const element of named.elements)
|
|
143
|
+
pairs.push({ imported: (element.propertyName ?? element.name).text, exported: null });
|
|
144
|
+
return { all: false, pairs };
|
|
125
145
|
};
|
|
126
|
-
|
|
127
146
|
const exportBindings = (ts, declaration) => {
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
147
|
+
const clause = declaration.exportClause;
|
|
148
|
+
if (!clause || clause.kind === ts.SyntaxKind.NamespaceExport)
|
|
149
|
+
return { all: true, pairs: [] };
|
|
150
|
+
return { all: false, pairs: clause.elements.map(element => ({ imported: (element.propertyName ?? element.name).text, exported: element.name.text })) };
|
|
131
151
|
};
|
|
132
|
-
|
|
133
152
|
const importTypeBindings = (ts, declaration) => {
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
153
|
+
let qualifier = declaration.qualifier;
|
|
154
|
+
if (!qualifier)
|
|
155
|
+
return { all: true, pairs: [] };
|
|
156
|
+
while (qualifier.kind === ts.SyntaxKind.QualifiedName)
|
|
157
|
+
qualifier = qualifier.left;
|
|
158
|
+
return { all: false, pairs: [{ imported: qualifier.text, exported: null }] };
|
|
138
159
|
};
|
|
139
|
-
|
|
140
160
|
/** Names an import/export declaration takes from its target: {all} or {pairs: [{imported, exported}]}. */
|
|
141
161
|
export function bindingsOf(context, declaration) {
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
162
|
+
const { ts } = context;
|
|
163
|
+
if (!declaration)
|
|
164
|
+
return { all: true, pairs: [] };
|
|
165
|
+
if (ts.isImportDeclaration(declaration))
|
|
166
|
+
return importBindings(context, declaration);
|
|
167
|
+
if (ts.isExportDeclaration(declaration))
|
|
168
|
+
return exportBindings(ts, declaration);
|
|
169
|
+
if (ts.isImportTypeNode(declaration))
|
|
170
|
+
return importTypeBindings(ts, declaration);
|
|
171
|
+
// ImportEqualsDeclaration, dynamic import(), require(): the whole module is taken.
|
|
172
|
+
return { all: true, pairs: [] };
|
|
149
173
|
}
|