@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.
Files changed (149) hide show
  1. package/dist/src/alias-chain.js +2 -2
  2. package/dist/src/analysis.js +43 -38
  3. package/dist/src/commands/read.js +6 -7
  4. package/dist/src/conformance-record.js +1 -1
  5. package/dist/src/consumers.js +4 -2
  6. package/dist/src/contract/config.generated.js +1 -1
  7. package/dist/src/contract/contract.generated.js +120 -2
  8. package/dist/src/dependencies.js +81 -49
  9. package/dist/src/entries/build-scripts.js +222 -0
  10. package/dist/src/{configuration-files.js → entries/configuration-files.js} +20 -58
  11. package/dist/src/{convention-rows.js → entries/convention-rows.js} +120 -27
  12. package/dist/src/entries/conventions.js +739 -0
  13. package/dist/src/{html-entries.js → entries/html-entries.js} +3 -3
  14. package/dist/src/{mdx-entries.js → entries/mdx-entries.js} +2 -2
  15. package/dist/src/entries/run-directories.js +77 -0
  16. package/dist/src/entries/sources.js +144 -0
  17. package/dist/src/entries/static-module.js +669 -0
  18. package/dist/src/entries/test-runners.js +684 -0
  19. package/dist/src/{workflow-steps.js → entries/workflow-steps.js} +18 -8
  20. package/dist/src/extensions.js +37 -0
  21. package/dist/src/facts.js +38 -0
  22. package/dist/src/file-facts.js +1 -1
  23. package/dist/src/findings/emitters.js +5 -8
  24. package/dist/src/findings/self-check.js +36 -20
  25. package/dist/src/findings-pass.js +5 -6
  26. package/dist/src/framework-lifecycle.js +1 -1
  27. package/dist/src/fs/manifest.js +15 -20
  28. package/dist/src/generated-file.js +172 -29
  29. package/dist/src/graph.js +2 -5
  30. package/dist/src/index.js +1 -1
  31. package/dist/src/injection-container.js +1 -1
  32. package/dist/src/inventory/commonjs.js +507 -0
  33. package/dist/src/inventory/enumerate.js +167 -0
  34. package/dist/src/inventory/syntax.js +236 -0
  35. package/dist/src/inventory.js +305 -705
  36. package/dist/src/javascript-file.js +26 -11
  37. package/dist/src/load/classify.js +28 -9
  38. package/dist/src/load/diagnostics.js +8 -1
  39. package/dist/src/load/discover.js +16 -8
  40. package/dist/src/load/package-scope.js +56 -0
  41. package/dist/src/load/plan.js +2 -2
  42. package/dist/src/load/synthesize.js +5 -5
  43. package/dist/src/load/workspace-manifests.js +1 -1
  44. package/dist/src/matrix.js +6 -13
  45. package/dist/src/outside-tests.js +1 -1
  46. package/dist/src/paths.js +16 -0
  47. package/dist/src/platform-calls.js +78 -0
  48. package/dist/src/platform-symbols.js +140 -0
  49. package/dist/src/position.js +41 -0
  50. package/dist/src/ref.js +11 -20
  51. package/dist/src/references.js +281 -50
  52. package/dist/src/resolve.js +1 -1
  53. package/dist/src/{configured-declarations.js → roots/configured-declarations.js} +4 -4
  54. package/dist/src/{entry-point-gaps.js → roots/entry-point-gaps.js} +5 -8
  55. package/dist/src/{manifest.js → roots/manifest.js} +4 -4
  56. package/dist/src/roots/published-reach.js +412 -0
  57. package/dist/src/roots/root-set.js +489 -0
  58. package/dist/src/roots/unseen-loads.js +208 -0
  59. package/dist/src/serialization-contract.js +1 -1
  60. package/dist/src/session.js +3 -0
  61. package/dist/src/source-files.js +5 -9
  62. package/dist/src/suppress-inline.js +33 -81
  63. package/dist/src/suppress.js +30 -32
  64. package/dist/src/test-support.js +4 -2
  65. package/dist/src/verbs/analyze.js +13 -1
  66. package/dist/src/verbs/describe.js +5 -3
  67. package/jsr.json +1 -1
  68. package/package.json +3 -3
  69. package/src/alias-chain.ts +2 -2
  70. package/src/analysis.ts +77 -53
  71. package/src/automatic-types.ts +1 -1
  72. package/src/commands/read.ts +6 -8
  73. package/src/conformance-record.ts +1 -1
  74. package/src/consumers.ts +5 -1
  75. package/src/contract/config.generated.ts +1 -1
  76. package/src/contract/contract.generated.ts +139 -2
  77. package/src/dependencies.ts +98 -50
  78. package/src/entries/build-scripts.ts +292 -0
  79. package/src/{configuration-files.ts → entries/configuration-files.ts} +23 -75
  80. package/src/{convention-rows.ts → entries/convention-rows.ts} +167 -28
  81. package/src/{conventions.ts → entries/conventions.ts} +347 -522
  82. package/src/{html-entries.ts → entries/html-entries.ts} +5 -5
  83. package/src/{mdx-entries.ts → entries/mdx-entries.ts} +4 -4
  84. package/src/entries/run-directories.ts +108 -0
  85. package/src/entries/sources.ts +266 -0
  86. package/src/entries/static-module.ts +857 -0
  87. package/src/entries/test-runners.ts +868 -0
  88. package/src/{workflow-steps.ts → entries/workflow-steps.ts} +29 -11
  89. package/src/exempt.ts +3 -2
  90. package/src/extensions.ts +45 -0
  91. package/src/facts.ts +44 -0
  92. package/src/file-facts.ts +2 -2
  93. package/src/findings/emitters.ts +14 -10
  94. package/src/findings/self-check.ts +41 -22
  95. package/src/findings/visibility-narrowing.ts +1 -1
  96. package/src/findings-pass.ts +5 -12
  97. package/src/framework-lifecycle.ts +1 -1
  98. package/src/fs/manifest.ts +25 -21
  99. package/src/generated-file.ts +240 -36
  100. package/src/graph.ts +3 -6
  101. package/src/index.ts +1 -1
  102. package/src/injection-container.ts +1 -1
  103. package/src/inventory/commonjs.ts +696 -0
  104. package/src/inventory/enumerate.ts +203 -0
  105. package/src/inventory/syntax.ts +311 -0
  106. package/src/inventory.ts +424 -878
  107. package/src/javascript-file.ts +29 -12
  108. package/src/load/classify.ts +49 -13
  109. package/src/load/diagnostics.ts +11 -1
  110. package/src/load/discover.ts +28 -12
  111. package/src/load/package-scope.ts +74 -0
  112. package/src/load/plan.ts +11 -2
  113. package/src/load/synthesize.ts +6 -6
  114. package/src/load/test-globals.ts +1 -1
  115. package/src/load/workspace-manifests.ts +1 -1
  116. package/src/load/workspace-run.ts +1 -1
  117. package/src/matrix.ts +7 -14
  118. package/src/outside-tests.ts +1 -1
  119. package/src/paths.ts +18 -0
  120. package/src/platform-calls.ts +119 -0
  121. package/src/platform-symbols.ts +205 -0
  122. package/src/position.ts +42 -0
  123. package/src/ref.ts +11 -20
  124. package/src/references.ts +383 -73
  125. package/src/report.ts +1 -1
  126. package/src/resolve.ts +1 -1
  127. package/src/{configured-declarations.ts → roots/configured-declarations.ts} +7 -7
  128. package/src/{entry-point-gaps.ts → roots/entry-point-gaps.ts} +5 -8
  129. package/src/{manifest.ts → roots/manifest.ts} +5 -5
  130. package/src/roots/published-reach.ts +481 -0
  131. package/src/{roots.ts → roots/root-set.ts} +203 -630
  132. package/src/roots/unseen-loads.ts +307 -0
  133. package/src/serialization-contract.ts +1 -1
  134. package/src/session.ts +17 -1
  135. package/src/source-files.ts +5 -10
  136. package/src/suppress-inline.ts +53 -89
  137. package/src/suppress.ts +48 -33
  138. package/src/test-support.ts +8 -3
  139. package/src/verbs/analyze.ts +17 -4
  140. package/src/verbs/describe.ts +5 -2
  141. package/src/verbs/explain.ts +1 -1
  142. package/dist/src/build-scripts.js +0 -418
  143. package/dist/src/conventions.js +0 -907
  144. package/dist/src/entry-points.js +0 -513
  145. package/dist/src/roots.js +0 -865
  146. package/dist/src/unseen-loads.js +0 -100
  147. package/src/build-scripts.ts +0 -536
  148. package/src/entry-points.ts +0 -661
  149. package/src/unseen-loads.ts +0 -134
@@ -5,9 +5,9 @@
5
5
  */
6
6
  import { isExportDeclaration, isImportDeclaration, isStringLiteral, } from "@typescript/native/ast";
7
7
  import { resolveRelativeSpecifier } from "./configuration-files.js";
8
- import { ancestors, dirnamePath, joinPath, resolvePath } from "./paths.js";
9
- import { filesBelow } from "./fs/tree.js";
10
- import { holdsManifest } from "./fs/manifest.js";
8
+ import { ancestors, dirnamePath, joinPath, resolvePath } from "../paths.js";
9
+ import { filesBelow } from "../fs/tree.js";
10
+ import { holdsManifest } from "../fs/manifest.js";
11
11
  /** A `<script` start tag, its attribute text captured. */
12
12
  const SCRIPT_TAG = /<script(?=[\s>/])([^>]*)>/giu;
13
13
  /** The end tag an inline module script's content runs to. */
@@ -4,8 +4,8 @@
4
4
  * is an import declaration, which an MDX compiler hoists into the module it builds.
5
5
  */
6
6
  import { resolveRelativeSpecifier } from "./configuration-files.js";
7
- import { dirnamePath, joinPath, resolvePath } from "./paths.js";
8
- import { filesBelow } from "./fs/tree.js";
7
+ import { dirnamePath, joinPath, resolvePath } from "../paths.js";
8
+ import { filesBelow } from "../fs/tree.js";
9
9
  /** The extensions of a document whose imports an MDX compiler reads. */
10
10
  const DOCUMENT = /\.mdx?$/u;
11
11
  /** A fence line, its marker run and what follows it captured. */
@@ -0,0 +1,77 @@
1
+ import { membersNamed, staticModule, textsOf } from "./static-module.js";
2
+ import { holdsManifest } from "../fs/manifest.js";
3
+ import { ancestors, dirnamePath, joinPath, resolvePath } from "../paths.js";
4
+ /** The configuration file names the bundler and its test runner read their root from. */
5
+ const BUNDLER_CONFIGS = ["vite.config", "vitest.config"].flatMap((stem) => ["js", "mjs", "cjs", "ts", "mts", "cts"].map((extension) => `${stem}.${extension}`));
6
+ /**
7
+ * The root the configurations of one directory state: the directory where none writes a
8
+ * `root`, the one literal they all write, or undefined where one cannot be read, writes a
9
+ * value that is not a literal, or two disagree.
10
+ */
11
+ function statedRoot(host, parse, dir, configs) {
12
+ const roots = new Set();
13
+ for (const name of configs) {
14
+ const path = joinPath(dir, name);
15
+ let text;
16
+ try {
17
+ text = host.readFile(path);
18
+ }
19
+ catch {
20
+ return undefined;
21
+ }
22
+ const objects = staticModule(parse(path, text)).defaultExport;
23
+ if (objects.length === 0) {
24
+ return undefined;
25
+ }
26
+ for (const object of objects) {
27
+ const values = object.kind === "object" ? membersNamed(object, "root") : undefined;
28
+ if (values === undefined) {
29
+ return undefined;
30
+ }
31
+ for (const value of values) {
32
+ const [root] = textsOf(value, false) ?? [];
33
+ if (root === undefined) {
34
+ return undefined;
35
+ }
36
+ roots.add(resolvePath(dir, root));
37
+ }
38
+ }
39
+ }
40
+ if (roots.size > 1) {
41
+ return undefined;
42
+ }
43
+ return [...roots][0] ?? dir;
44
+ }
45
+ /** The directories of one run below `top`, each read once per directory. */
46
+ export function runDirectories(host, top, parse) {
47
+ const working = new Map();
48
+ const bundler = new Map();
49
+ const workingDirectoryOf = (fileName) => {
50
+ const dir = dirnamePath(fileName);
51
+ let found = working.get(dir);
52
+ if (found === undefined) {
53
+ found = ancestors(dir, top).find((at) => holdsManifest(host, at)) ?? top;
54
+ working.set(dir, found);
55
+ }
56
+ return found;
57
+ };
58
+ return {
59
+ workingDirectoryOf,
60
+ bundlerRootOf: (fileName) => {
61
+ const dir = dirnamePath(fileName);
62
+ if (bundler.has(dir)) {
63
+ return bundler.get(dir);
64
+ }
65
+ let found = workingDirectoryOf(fileName);
66
+ for (const at of ancestors(dir, top)) {
67
+ const configs = BUNDLER_CONFIGS.filter((name) => host.kindOf(joinPath(at, name)) === "file");
68
+ if (configs.length > 0) {
69
+ found = statedRoot(host, parse, at, configs);
70
+ break;
71
+ }
72
+ }
73
+ bundler.set(dir, found);
74
+ return found;
75
+ },
76
+ };
77
+ }
@@ -0,0 +1,144 @@
1
+ /**
2
+ * The sources that enter a project's files with no import naming them, read once per
3
+ * project into one record every stage reads: the roots stage reads the files they enter,
4
+ * the dependency stage the configuration files' strings, and the reference pass the test
5
+ * files. A value a source does not find written out names nothing.
6
+ */
7
+ import { buildScriptEntries } from "./build-scripts.js";
8
+ import { configurationFiles, filesNamedBy, moduleStrings, } from "./configuration-files.js";
9
+ import { conventionEntries, conventionTestFiles, generatedFiles, } from "./conventions.js";
10
+ import { htmlEntries } from "./html-entries.js";
11
+ import { documentEntries } from "./mdx-entries.js";
12
+ import { dirnamePath } from "../paths.js";
13
+ import { globExpression } from "../text/glob.js";
14
+ import { workflowEntries } from "./workflow-steps.js";
15
+ /**
16
+ * Each configuration module, with what it exports, and each own file a relative string of
17
+ * a configuration module or a JSON configuration file names, read against that file's
18
+ * directory. A string at a selection key of an applied convention row, or naming a test
19
+ * file, names no file here.
20
+ */
21
+ const configurationSource = ({ files, configuration, conventions }) => {
22
+ const selected = conventions?.selected ?? new Map();
23
+ const found = [];
24
+ const unselected = (file) => {
25
+ const starts = selected.get(file.fileName)?.starts;
26
+ return moduleStrings(file)
27
+ .filter((one) => starts?.has(one.node.getStart()) !== true)
28
+ .map((one) => one.text);
29
+ };
30
+ const unselectedIn = (path, texts) => {
31
+ const left = [...(selected.get(path)?.texts ?? [])];
32
+ return texts.filter((text) => {
33
+ const at = left.indexOf(text);
34
+ if (at < 0) {
35
+ return true;
36
+ }
37
+ left.splice(at, 1);
38
+ return false;
39
+ });
40
+ };
41
+ const strings = (dir, texts) => {
42
+ for (const text of texts) {
43
+ for (const file of filesNamedBy(files, dir, text)) {
44
+ found.push({ file, rule: "configuration-string", source: text, exports: true });
45
+ }
46
+ }
47
+ };
48
+ for (const { file, form } of configuration.modules) {
49
+ found.push({ file, rule: "configuration-file", source: form, exports: true });
50
+ strings(dirnamePath(file.fileName), unselected(file));
51
+ }
52
+ for (const document of configuration.documents) {
53
+ strings(dirnamePath(document.path), unselectedIn(document.path, document.strings));
54
+ }
55
+ for (const { file } of configuration.outside) {
56
+ strings(dirnamePath(file.fileName), unselected(file));
57
+ }
58
+ return found;
59
+ };
60
+ const testSource = ({ tests }) => tests.map(({ file, source }) => ({ file, rule: "test-runner", source, exports: false }));
61
+ const conventionSource = ({ files, conventions }) => conventions === undefined
62
+ ? []
63
+ : conventionEntries(conventions, files).map(({ file, row }) => ({
64
+ file,
65
+ rule: "convention",
66
+ source: row,
67
+ exports: true,
68
+ }));
69
+ const htmlSource = ({ host, targetRoot, files, parse }) => htmlEntries(host, targetRoot, files, parse).map(({ file, source }) => ({
70
+ file,
71
+ rule: "html-entry",
72
+ source,
73
+ exports: true,
74
+ }));
75
+ const documentSource = ({ host, targetRoot, files }) => documentEntries(host, targetRoot, files).map(({ file, source, names }) => ({
76
+ file,
77
+ rule: "document-import",
78
+ source,
79
+ exports: true,
80
+ ...(names === undefined ? {} : { names }),
81
+ }));
82
+ const buildScriptSource = ({ host, targetRoot, files, parse }) => buildScriptEntries(host, targetRoot, files, parse).map(({ file, source }) => ({
83
+ file,
84
+ rule: "bundler-entry",
85
+ source,
86
+ exports: true,
87
+ }));
88
+ const workflowSource = ({ workflows, files }) => workflowEntries(workflows, files).map(({ file, source }) => ({
89
+ file,
90
+ rule: "workflow-step",
91
+ source,
92
+ exports: true,
93
+ }));
94
+ /** Every source, each read once per project. */
95
+ const ENTRY_SOURCES = [
96
+ configurationSource,
97
+ conventionSource,
98
+ testSource,
99
+ htmlSource,
100
+ documentSource,
101
+ buildScriptSource,
102
+ workflowSource,
103
+ ];
104
+ /**
105
+ * The files a test runner loads in one project: each `ts.test_files` pattern's matches
106
+ * below the target root, then each file an applied row names, once per pattern or row
107
+ * string that names it.
108
+ */
109
+ function testFilesOf(context) {
110
+ const found = [];
111
+ for (const pattern of context.testFiles) {
112
+ const expression = globExpression(pattern);
113
+ for (const [path, file] of context.files.byPath) {
114
+ if (expression.test(path)) {
115
+ found.push({ file, source: pattern });
116
+ }
117
+ }
118
+ }
119
+ const named = context.conventions === undefined
120
+ ? []
121
+ : conventionTestFiles(context.conventions, context.files);
122
+ for (const [name, source] of named) {
123
+ const file = context.files.byName.get(name);
124
+ if (file !== undefined) {
125
+ found.push({ file, source });
126
+ }
127
+ }
128
+ return found;
129
+ }
130
+ /** Reads every source of one project once. */
131
+ export function readSources(context) {
132
+ const configuration = configurationFiles(context.host, context.targetRoot, context.files, context.parse);
133
+ const tests = testFilesOf(context);
134
+ const input = { ...context, configuration, tests };
135
+ return {
136
+ entered: ENTRY_SOURCES.flatMap((source) => source(input)),
137
+ testFiles: new Set(tests.map(({ file }) => file.fileName)),
138
+ generated: context.conventions === undefined
139
+ ? new Map()
140
+ : generatedFiles(context.conventions, context.files),
141
+ configuration,
142
+ workflows: context.workflows,
143
+ };
144
+ }