@cplieger/deadset-ts 8.0.0-dev.2 → 8.0.0-dev.21

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 (431) hide show
  1. package/README.md +3 -1
  2. package/THIRD_PARTY_NOTICES.md +27 -0
  3. package/dist/bin/mapper-connection.js +2 -1
  4. package/dist/bin/node-host.js +24 -5
  5. package/dist/src/alias-chain.js +35 -9
  6. package/dist/src/amd.js +81 -0
  7. package/dist/src/analysis.js +274 -496
  8. package/dist/src/augmentations.js +64 -3
  9. package/dist/src/automatic-types.js +10 -29
  10. package/dist/src/bindings.js +382 -0
  11. package/dist/src/commands/held.js +499 -0
  12. package/dist/src/commands/read.js +161 -0
  13. package/dist/src/commands/shell.js +169 -0
  14. package/dist/src/commands/tools.js +1847 -0
  15. package/dist/src/component-files.js +3 -2
  16. package/dist/src/component-layer.js +4 -2
  17. package/dist/src/config.js +6 -82
  18. package/dist/src/conformance-record.js +2 -2
  19. package/dist/src/consumers.js +10 -38
  20. package/dist/src/contextual-uses.js +57 -26
  21. package/dist/src/contract/config.generated.js +561 -0
  22. package/dist/src/contract/contract.generated.js +1370 -0
  23. package/dist/src/contract/report.generated.js +866 -0
  24. package/dist/src/dependencies.js +165 -122
  25. package/dist/src/destructuring.js +1 -19
  26. package/dist/src/edges.js +38 -122
  27. package/dist/src/element-access.js +181 -168
  28. package/dist/src/entries/build-scripts.js +222 -0
  29. package/dist/src/{configuration-files.js → entries/configuration-files.js} +52 -256
  30. package/dist/src/{convention-rows.js → entries/convention-rows.js} +170 -30
  31. package/dist/src/entries/conventions.js +740 -0
  32. package/dist/src/{html-entries.js → entries/html-entries.js} +12 -42
  33. package/dist/src/{mdx-entries.js → entries/mdx-entries.js} +5 -28
  34. package/dist/src/entries/run-directories.js +77 -0
  35. package/dist/src/entries/sources.js +144 -0
  36. package/dist/src/entries/static-module.js +670 -0
  37. package/dist/src/entries/test-runners.js +650 -0
  38. package/dist/src/entries/workflow-steps.js +345 -0
  39. package/dist/src/exemptions/argument-places.js +131 -0
  40. package/dist/src/exemptions/calls.js +338 -0
  41. package/dist/src/exemptions/classes.js +13 -0
  42. package/dist/src/{decorator.js → exemptions/decorator.js} +19 -30
  43. package/dist/src/exemptions/detectors.js +48 -0
  44. package/dist/src/{enum-group.js → exemptions/enum-group.js} +9 -16
  45. package/dist/src/{erased-stores.js → exemptions/erased-stores.js} +7 -11
  46. package/dist/src/{framework-lifecycle.js → exemptions/framework-lifecycle.js} +76 -54
  47. package/dist/src/exemptions/generated-file.js +241 -0
  48. package/dist/src/{injection-container.js → exemptions/injection-container.js} +20 -26
  49. package/dist/src/exemptions/installed-globals.js +173 -0
  50. package/dist/src/{interface-satisfaction.js → exemptions/interface-satisfaction.js} +52 -121
  51. package/dist/src/exemptions/lifecycle.js +150 -0
  52. package/dist/src/{reflective-lookup.js → exemptions/reflective-lookup.js} +3 -3
  53. package/dist/src/exemptions/serialization-contract.js +1276 -0
  54. package/dist/src/exemptions/sites.js +182 -0
  55. package/dist/src/{template-field.js → exemptions/template-field.js} +13 -23
  56. package/dist/src/{value-reach.js → exemptions/value-reach.js} +14 -7
  57. package/dist/src/exposure.js +400 -0
  58. package/dist/src/extensions.js +37 -0
  59. package/dist/src/facts.js +38 -0
  60. package/dist/src/failure.js +36 -0
  61. package/dist/src/file-facts.js +3 -26
  62. package/dist/src/findings/completion.js +109 -56
  63. package/dist/src/findings/dependencies-and-module-machinery.js +4 -5
  64. package/dist/src/findings/emitters.js +27 -41
  65. package/dist/src/{implementations.js → findings/implementations.js} +3 -3
  66. package/dist/src/{in-operands.js → findings/in-operands.js} +3 -2
  67. package/dist/src/findings/interfaces.js +4 -5
  68. package/dist/src/findings/intra-function.js +16 -13
  69. package/dist/src/findings/non-code-artifacts.js +17 -12
  70. package/dist/src/findings/reads-and-writes.js +86 -27
  71. package/dist/src/findings/self-check.js +44 -30
  72. package/dist/src/findings/unused-declarations.js +29 -45
  73. package/dist/src/findings/visibility-narrowing.js +23 -31
  74. package/dist/src/findings-pass.js +13 -21
  75. package/dist/src/fs/document.js +52 -0
  76. package/dist/src/fs/manifest.js +67 -0
  77. package/dist/src/fs/tree.js +88 -0
  78. package/dist/src/git-ignore.js +39 -26
  79. package/dist/src/import-bindings.js +73 -28
  80. package/dist/src/index/sites.js +557 -0
  81. package/dist/src/index/values.js +124 -0
  82. package/dist/src/index.js +2 -2
  83. package/dist/src/indexed-access.js +523 -478
  84. package/dist/src/intra-function-parts.js +63 -43
  85. package/dist/src/inventory/commonjs.js +507 -0
  86. package/dist/src/inventory/enumerate.js +167 -0
  87. package/dist/src/inventory/syntax.js +236 -0
  88. package/dist/src/inventory.js +323 -724
  89. package/dist/src/javascript-file.js +48 -0
  90. package/dist/src/json-document.js +198 -67
  91. package/dist/src/keyof-comparisons.js +126 -107
  92. package/dist/src/kinds.js +3 -366
  93. package/dist/src/{components.js → liveness/components.js} +2 -3
  94. package/dist/src/{graph.js → liveness/graph.js} +52 -28
  95. package/dist/src/liveness/matrix.js +99 -0
  96. package/dist/src/liveness/sweep.js +558 -0
  97. package/dist/src/load/classify.js +289 -0
  98. package/dist/src/load/diagnostics.js +87 -0
  99. package/dist/src/load/discover.js +285 -0
  100. package/dist/src/{emit-map.js → load/emit-map.js} +1 -1
  101. package/dist/src/load/expected-module.js +136 -0
  102. package/dist/src/load/load.js +27 -0
  103. package/dist/src/load/module-lookup.js +37 -0
  104. package/dist/src/load/package-scope.js +56 -0
  105. package/dist/src/load/plan.js +313 -0
  106. package/dist/src/load/specifiers.js +113 -0
  107. package/dist/src/load/synthesize.js +152 -0
  108. package/dist/src/load/test-globals.js +207 -0
  109. package/dist/src/load/test-joins.js +82 -0
  110. package/dist/src/{workspace-manifests.js → load/workspace-manifests.js} +4 -4
  111. package/dist/src/{workspace-programs.js → load/workspace-programs.js} +89 -66
  112. package/dist/src/{workspace-resolution.js → load/workspace-resolution.js} +24 -66
  113. package/dist/src/{workspace-run.js → load/workspace-run.js} +7 -7
  114. package/dist/src/{workspace.js → load/workspace.js} +62 -124
  115. package/dist/src/module-declarations.js +70 -85
  116. package/dist/src/overrides.js +134 -112
  117. package/dist/src/partial.js +2 -1
  118. package/dist/src/paths.js +82 -16
  119. package/dist/src/platform-calls.js +78 -0
  120. package/dist/src/platform-symbols.js +134 -0
  121. package/dist/src/position.js +43 -1
  122. package/dist/src/print.js +11 -79
  123. package/dist/src/product.js +13 -0
  124. package/dist/src/query.js +95 -0
  125. package/dist/src/ref.js +12 -20
  126. package/dist/src/references/read-rule.js +1 -0
  127. package/dist/src/references/read-rules.js +48 -0
  128. package/dist/src/references/sink.js +237 -0
  129. package/dist/src/references/sources.js +450 -0
  130. package/dist/src/references.js +117 -1074
  131. package/dist/src/report-schema.js +51 -0
  132. package/dist/src/report.js +57 -41
  133. package/dist/src/reporters/annotations.js +15 -8
  134. package/dist/src/reporters/sarif.js +16 -10
  135. package/dist/src/reporters/template.js +4 -19
  136. package/dist/src/resolve.js +246 -730
  137. package/dist/src/{configured-declarations.js → roots/configured-declarations.js} +22 -24
  138. package/dist/src/{entry-point-gaps.js → roots/entry-point-gaps.js} +6 -15
  139. package/dist/src/roots/manifest.js +216 -0
  140. package/dist/src/roots/published-reach.js +412 -0
  141. package/dist/src/roots/root-set.js +487 -0
  142. package/dist/src/roots/unseen-loads.js +236 -0
  143. package/dist/src/run.js +66 -77
  144. package/dist/src/schema.js +320 -343
  145. package/dist/src/scope.js +38 -115
  146. package/dist/src/session.js +37 -29
  147. package/dist/src/source-files.js +6 -10
  148. package/dist/src/stores.js +4 -2
  149. package/dist/src/suppress-file.js +25 -28
  150. package/dist/src/suppress-inline.js +36 -83
  151. package/dist/src/suppress.js +50 -71
  152. package/dist/src/symbol-keys.js +92 -88
  153. package/dist/src/tests/file-class.js +76 -0
  154. package/dist/src/{outside-tests.js → tests/outside.js} +7 -7
  155. package/dist/src/{test-support.js → tests/support.js} +5 -12
  156. package/dist/src/text/compare.js +26 -0
  157. package/dist/src/text/glob.js +194 -0
  158. package/dist/src/text/named-files.js +298 -0
  159. package/dist/src/text/yaml.js +684 -0
  160. package/dist/src/type-errors.js +11 -232
  161. package/dist/src/type-parameter-reads.js +178 -139
  162. package/dist/src/unimplemented-callees.js +262 -242
  163. package/dist/src/unwrap.js +23 -0
  164. package/dist/src/usage.js +10 -0
  165. package/dist/src/vendor/unbash/ansi-c.js +132 -0
  166. package/dist/src/vendor/unbash/arithmetic-parts.js +37 -0
  167. package/dist/src/vendor/unbash/arithmetic.js +591 -0
  168. package/dist/src/vendor/unbash/assignment.js +131 -0
  169. package/dist/src/vendor/unbash/chars.js +48 -0
  170. package/dist/src/vendor/unbash/command.js +41 -0
  171. package/dist/src/vendor/unbash/expansion.js +80 -0
  172. package/dist/src/vendor/unbash/glob.js +268 -0
  173. package/dist/src/vendor/unbash/heredoc.js +27 -0
  174. package/dist/src/vendor/unbash/internal-types.js +1 -0
  175. package/dist/src/vendor/unbash/lexer.js +4274 -0
  176. package/dist/src/vendor/unbash/limits.js +3 -0
  177. package/dist/src/vendor/unbash/parser.js +1366 -0
  178. package/dist/src/vendor/unbash/parts.js +57 -0
  179. package/dist/src/vendor/unbash/substitution-context.js +8 -0
  180. package/dist/src/vendor/unbash/traversal.js +212 -0
  181. package/dist/src/vendor/unbash/types.js +1 -0
  182. package/dist/src/vendor/unbash/word-value.js +61 -0
  183. package/dist/src/vendor/unbash/word.js +40 -0
  184. package/dist/src/verbs/analyze.js +194 -127
  185. package/dist/src/verbs/describe.js +13 -18
  186. package/dist/src/verbs/explain.js +85 -139
  187. package/dist/src/verbs/print-config.js +2 -1
  188. package/dist/src/verbs/print-projects.js +6 -4
  189. package/dist/src/verbs/print-retained.js +30 -6
  190. package/dist/src/verbs/print-roots.js +4 -2
  191. package/dist/src/verbs/verb.js +1 -5
  192. package/dist/src/verbs/version.js +14 -3
  193. package/jsr.json +2 -1
  194. package/package.json +14 -8
  195. package/src/alias-chain.ts +40 -11
  196. package/src/amd.ts +130 -0
  197. package/src/analysis.ts +426 -733
  198. package/src/augmentations.ts +93 -4
  199. package/src/automatic-types.ts +12 -30
  200. package/src/bindings.ts +460 -0
  201. package/src/commands/held.ts +632 -0
  202. package/src/commands/read.ts +242 -0
  203. package/src/commands/shell.ts +228 -0
  204. package/src/commands/tools.ts +2382 -0
  205. package/src/component-files.ts +4 -2
  206. package/src/component-layer.ts +4 -2
  207. package/src/config.ts +31 -302
  208. package/src/conformance-record.ts +2 -2
  209. package/src/consumers.ts +16 -66
  210. package/src/contextual-uses.ts +66 -34
  211. package/src/contract/config.generated.ts +821 -0
  212. package/src/contract/contract.generated.ts +1453 -0
  213. package/src/contract/report.generated.ts +1241 -0
  214. package/src/dependencies.ts +223 -128
  215. package/src/destructuring.ts +1 -31
  216. package/src/edges.ts +41 -140
  217. package/src/element-access.ts +190 -187
  218. package/src/entries/build-scripts.ts +292 -0
  219. package/src/{configuration-files.ts → entries/configuration-files.ts} +68 -278
  220. package/src/{convention-rows.ts → entries/convention-rows.ts} +227 -31
  221. package/src/{conventions.ts → entries/conventions.ts} +367 -583
  222. package/src/{html-entries.ts → entries/html-entries.ts} +22 -48
  223. package/src/{mdx-entries.ts → entries/mdx-entries.ts} +7 -30
  224. package/src/entries/run-directories.ts +108 -0
  225. package/src/entries/sources.ts +266 -0
  226. package/src/entries/static-module.ts +858 -0
  227. package/src/entries/test-runners.ts +835 -0
  228. package/src/entries/workflow-steps.ts +432 -0
  229. package/src/exemptions/argument-places.ts +198 -0
  230. package/src/exemptions/calls.ts +483 -0
  231. package/src/exemptions/classes.ts +49 -0
  232. package/src/exemptions/decorator.ts +56 -0
  233. package/src/exemptions/detectors.ts +75 -0
  234. package/src/{enum-group.ts → exemptions/enum-group.ts} +10 -19
  235. package/src/{erased-stores.ts → exemptions/erased-stores.ts} +7 -14
  236. package/src/{framework-lifecycle.ts → exemptions/framework-lifecycle.ts} +85 -66
  237. package/src/exemptions/generated-file.ts +318 -0
  238. package/src/{injection-container.ts → exemptions/injection-container.ts} +29 -34
  239. package/src/exemptions/installed-globals.ts +255 -0
  240. package/src/{interface-satisfaction.ts → exemptions/interface-satisfaction.ts} +69 -160
  241. package/src/exemptions/lifecycle.ts +286 -0
  242. package/src/{reflective-lookup.ts → exemptions/reflective-lookup.ts} +5 -5
  243. package/src/exemptions/serialization-contract.ts +1729 -0
  244. package/src/exemptions/sites.ts +293 -0
  245. package/src/{template-field.ts → exemptions/template-field.ts} +22 -32
  246. package/src/{value-reach.ts → exemptions/value-reach.ts} +16 -8
  247. package/src/exposure.ts +492 -0
  248. package/src/extensions.ts +45 -0
  249. package/src/facts.ts +46 -0
  250. package/src/failure.ts +63 -0
  251. package/src/file-facts.ts +15 -25
  252. package/src/finding.ts +10 -10
  253. package/src/findings/boundary.ts +11 -0
  254. package/src/findings/completion.ts +133 -64
  255. package/src/findings/dependencies-and-module-machinery.ts +4 -7
  256. package/src/findings/emitter.ts +9 -10
  257. package/src/findings/emitters.ts +38 -52
  258. package/src/{implementations.ts → findings/implementations.ts} +4 -4
  259. package/src/{in-operands.ts → findings/in-operands.ts} +4 -3
  260. package/src/findings/interfaces.ts +7 -9
  261. package/src/findings/intra-function.ts +16 -14
  262. package/src/findings/non-code-artifacts.ts +24 -15
  263. package/src/findings/reads-and-writes.ts +118 -41
  264. package/src/findings/self-check.ts +51 -38
  265. package/src/findings/unused-declarations.ts +31 -49
  266. package/src/findings/visibility-narrowing.ts +36 -40
  267. package/src/findings-pass.ts +15 -31
  268. package/src/fs/document.ts +70 -0
  269. package/src/fs/manifest.ts +96 -0
  270. package/src/fs/tree.ts +110 -0
  271. package/src/git-ignore.ts +50 -26
  272. package/src/host.ts +12 -5
  273. package/src/import-bindings.ts +98 -29
  274. package/src/index/sites.ts +781 -0
  275. package/src/index/values.ts +170 -0
  276. package/src/index.ts +2 -2
  277. package/src/indexed-access.ts +570 -527
  278. package/src/intra-function-parts.ts +73 -44
  279. package/src/inventory/commonjs.ts +696 -0
  280. package/src/inventory/enumerate.ts +203 -0
  281. package/src/inventory/syntax.ts +311 -0
  282. package/src/inventory.ts +442 -895
  283. package/src/javascript-file.ts +54 -0
  284. package/src/json-document.ts +241 -76
  285. package/src/keyof-comparisons.ts +133 -122
  286. package/src/kinds.ts +5 -413
  287. package/src/{components.ts → liveness/components.ts} +4 -6
  288. package/src/{graph.ts → liveness/graph.ts} +100 -35
  289. package/src/liveness/matrix.ts +162 -0
  290. package/src/liveness/sweep.ts +855 -0
  291. package/src/load/classify.ts +433 -0
  292. package/src/load/diagnostics.ts +154 -0
  293. package/src/load/discover.ts +471 -0
  294. package/src/{emit-map.ts → load/emit-map.ts} +1 -1
  295. package/src/load/expected-module.ts +194 -0
  296. package/src/load/load.ts +73 -0
  297. package/src/load/module-lookup.ts +50 -0
  298. package/src/load/package-scope.ts +74 -0
  299. package/src/load/plan.ts +513 -0
  300. package/src/load/specifiers.ts +171 -0
  301. package/src/load/synthesize.ts +230 -0
  302. package/src/load/test-globals.ts +251 -0
  303. package/src/load/test-joins.ts +98 -0
  304. package/src/{workspace-manifests.ts → load/workspace-manifests.ts} +5 -5
  305. package/src/{workspace-programs.ts → load/workspace-programs.ts} +128 -85
  306. package/src/{workspace-resolution.ts → load/workspace-resolution.ts} +41 -77
  307. package/src/{workspace-run.ts → load/workspace-run.ts} +18 -16
  308. package/src/{workspace.ts → load/workspace.ts} +90 -134
  309. package/src/module-declarations.ts +74 -98
  310. package/src/overrides.ts +162 -134
  311. package/src/partial.ts +3 -2
  312. package/src/paths.ts +92 -16
  313. package/src/platform-calls.ts +119 -0
  314. package/src/platform-symbols.ts +189 -0
  315. package/src/position.ts +44 -1
  316. package/src/print.ts +12 -92
  317. package/src/product.ts +18 -0
  318. package/src/query.ts +201 -10
  319. package/src/ref.ts +12 -20
  320. package/src/references/read-rule.ts +60 -0
  321. package/src/references/read-rules.ts +55 -0
  322. package/src/references/sink.ts +314 -0
  323. package/src/references/sources.ts +632 -0
  324. package/src/references.ts +187 -1450
  325. package/src/report-schema.ts +68 -0
  326. package/src/report.ts +103 -226
  327. package/src/reporters/annotations.ts +22 -11
  328. package/src/reporters/json.ts +1 -1
  329. package/src/reporters/reporter.ts +2 -4
  330. package/src/reporters/reporters.ts +1 -1
  331. package/src/reporters/sarif.ts +29 -16
  332. package/src/reporters/template.ts +4 -20
  333. package/src/reporters/text.ts +3 -3
  334. package/src/resolve.ts +284 -1115
  335. package/src/{configured-declarations.ts → roots/configured-declarations.ts} +26 -29
  336. package/src/{entry-point-gaps.ts → roots/entry-point-gaps.ts} +7 -16
  337. package/src/roots/manifest.ts +303 -0
  338. package/src/roots/published-reach.ts +486 -0
  339. package/src/{roots.ts → roots/root-set.ts} +286 -469
  340. package/src/roots/unseen-loads.ts +345 -0
  341. package/src/run.ts +75 -91
  342. package/src/schema.ts +391 -388
  343. package/src/scope.ts +46 -138
  344. package/src/session.ts +87 -55
  345. package/src/source-files.ts +6 -11
  346. package/src/stores.ts +15 -3
  347. package/src/suppress-file.ts +24 -33
  348. package/src/suppress-inline.ts +55 -91
  349. package/src/suppress.ts +78 -79
  350. package/src/symbol-keys.ts +104 -107
  351. package/src/tests/file-class.ts +135 -0
  352. package/src/{outside-tests.ts → tests/outside.ts} +16 -10
  353. package/src/{test-support.ts → tests/support.ts} +15 -21
  354. package/src/text/compare.ts +27 -0
  355. package/src/text/glob.ts +210 -0
  356. package/src/text/named-files.ts +388 -0
  357. package/src/text/yaml.ts +747 -0
  358. package/src/type-errors.ts +18 -288
  359. package/src/type-parameter-reads.ts +187 -158
  360. package/src/unimplemented-callees.ts +297 -280
  361. package/src/unwrap.ts +34 -0
  362. package/src/usage.ts +10 -0
  363. package/src/vendor/unbash/LICENSE +15 -0
  364. package/src/vendor/unbash/VENDORED.md +16 -0
  365. package/src/vendor/unbash/ansi-c.ts +132 -0
  366. package/src/vendor/unbash/arithmetic-parts.ts +53 -0
  367. package/src/vendor/unbash/arithmetic.ts +641 -0
  368. package/src/vendor/unbash/assignment.ts +163 -0
  369. package/src/vendor/unbash/chars.ts +48 -0
  370. package/src/vendor/unbash/command.ts +47 -0
  371. package/src/vendor/unbash/expansion.ts +144 -0
  372. package/src/vendor/unbash/glob.ts +284 -0
  373. package/src/vendor/unbash/heredoc.ts +34 -0
  374. package/src/vendor/unbash/internal-types.ts +94 -0
  375. package/src/vendor/unbash/lexer.ts +4352 -0
  376. package/src/vendor/unbash/limits.ts +3 -0
  377. package/src/vendor/unbash/parser.ts +1612 -0
  378. package/src/vendor/unbash/parts.ts +96 -0
  379. package/src/vendor/unbash/substitution-context.ts +20 -0
  380. package/src/vendor/unbash/traversal.ts +182 -0
  381. package/src/vendor/unbash/types.ts +660 -0
  382. package/src/vendor/unbash/word-value.ts +64 -0
  383. package/src/vendor/unbash/word.ts +50 -0
  384. package/src/verbs/analyze.ts +255 -164
  385. package/src/verbs/describe.ts +19 -17
  386. package/src/verbs/explain.ts +93 -169
  387. package/src/verbs/print-config.ts +2 -1
  388. package/src/verbs/print-projects.ts +6 -4
  389. package/src/verbs/print-retained.ts +36 -6
  390. package/src/verbs/print-roots.ts +4 -2
  391. package/src/verbs/verb.ts +2 -8
  392. package/src/verbs/version.ts +15 -3
  393. package/dist/src/base-url.js +0 -18
  394. package/dist/src/calls.js +0 -155
  395. package/dist/src/conventions.js +0 -937
  396. package/dist/src/discover.js +0 -468
  397. package/dist/src/entry-points.js +0 -529
  398. package/dist/src/exempt-classes.js +0 -75
  399. package/dist/src/exempt.js +0 -209
  400. package/dist/src/generated-file.js +0 -95
  401. package/dist/src/glob.js +0 -65
  402. package/dist/src/manifest.js +0 -165
  403. package/dist/src/matrix.js +0 -246
  404. package/dist/src/pnpm-workspace.js +0 -120
  405. package/dist/src/roots.js +0 -672
  406. package/dist/src/serialization-contract.js +0 -611
  407. package/dist/src/setup-failure.js +0 -23
  408. package/dist/src/sweep.js +0 -224
  409. package/dist/src/test-joins.js +0 -101
  410. package/dist/src/value-flow.js +0 -74
  411. package/dist/src/version.js +0 -7
  412. package/dist/src/workflow-steps.js +0 -185
  413. package/src/base-url.ts +0 -24
  414. package/src/calls.ts +0 -225
  415. package/src/decorator.ts +0 -78
  416. package/src/discover.ts +0 -653
  417. package/src/entry-points.ts +0 -687
  418. package/src/exempt-classes.ts +0 -123
  419. package/src/exempt.ts +0 -323
  420. package/src/generated-file.ts +0 -111
  421. package/src/glob.ts +0 -67
  422. package/src/manifest.ts +0 -234
  423. package/src/matrix.ts +0 -423
  424. package/src/pnpm-workspace.ts +0 -135
  425. package/src/serialization-contract.ts +0 -849
  426. package/src/setup-failure.ts +0 -39
  427. package/src/sweep.ts +0 -347
  428. package/src/test-joins.ts +0 -120
  429. package/src/value-flow.ts +0 -104
  430. package/src/version.ts +0 -7
  431. package/src/workflow-steps.ts +0 -216
@@ -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
+ }