@shivaedev/quality 0.76.0 → 0.77.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.
Files changed (613) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/README.md +65 -59
  3. package/dist/adapters/biome/pluginContract.d.ts +1 -1
  4. package/dist/adapters/biome/pluginContract.d.ts.map +1 -1
  5. package/dist/adapters/biome/pluginContract.js +2 -5
  6. package/dist/adapters/biome/pluginContract.js.map +1 -1
  7. package/dist/adapters/biome/run.d.ts.map +1 -1
  8. package/dist/adapters/biome/run.js +2 -0
  9. package/dist/adapters/biome/run.js.map +1 -1
  10. package/dist/adapters/biome/withExceptionConfig.d.ts.map +1 -1
  11. package/dist/adapters/biome/withExceptionConfig.js +21 -4
  12. package/dist/adapters/biome/withExceptionConfig.js.map +1 -1
  13. package/dist/adapters/changeKeyCheck.d.ts +10 -0
  14. package/dist/adapters/changeKeyCheck.d.ts.map +1 -0
  15. package/dist/adapters/{changeKeyFindings.js → changeKeyCheck.js} +8 -22
  16. package/dist/adapters/changeKeyCheck.js.map +1 -0
  17. package/dist/adapters/commandLine.d.ts +2 -0
  18. package/dist/adapters/commandLine.d.ts.map +1 -1
  19. package/dist/adapters/contextCaptureCheck.d.ts +9 -0
  20. package/dist/adapters/contextCaptureCheck.d.ts.map +1 -0
  21. package/dist/adapters/contextCaptureCheck.js +91 -0
  22. package/dist/adapters/contextCaptureCheck.js.map +1 -0
  23. package/dist/adapters/databaseUrlFindings.d.ts +1 -1
  24. package/dist/adapters/databaseUrlFindings.d.ts.map +1 -1
  25. package/dist/adapters/declaration-files/initialize.d.ts +6 -0
  26. package/dist/adapters/declaration-files/initialize.d.ts.map +1 -0
  27. package/dist/adapters/declaration-files/initialize.js +4 -0
  28. package/dist/adapters/declaration-files/initialize.js.map +1 -0
  29. package/dist/adapters/declaration-files/parse.d.ts +5 -0
  30. package/dist/adapters/declaration-files/parse.d.ts.map +1 -0
  31. package/dist/adapters/declaration-files/parse.js +6 -0
  32. package/dist/adapters/declaration-files/parse.js.map +1 -0
  33. package/dist/adapters/declaration-files/reader.d.ts +5 -0
  34. package/dist/adapters/declaration-files/reader.d.ts.map +1 -0
  35. package/dist/adapters/declaration-files/reader.js +23 -0
  36. package/dist/adapters/declaration-files/reader.js.map +1 -0
  37. package/dist/adapters/declaration-files/service.d.ts +9 -0
  38. package/dist/adapters/declaration-files/service.d.ts.map +1 -0
  39. package/dist/adapters/declaration-files/service.js +14 -0
  40. package/dist/adapters/declaration-files/service.js.map +1 -0
  41. package/dist/adapters/foreignResources.d.ts.map +1 -1
  42. package/dist/adapters/foreignResources.js +0 -4
  43. package/dist/adapters/foreignResources.js.map +1 -1
  44. package/dist/adapters/import-compiler/graph.d.ts +8 -2
  45. package/dist/adapters/import-compiler/graph.d.ts.map +1 -1
  46. package/dist/adapters/import-compiler/graph.js +4 -1
  47. package/dist/adapters/import-compiler/graph.js.map +1 -1
  48. package/dist/adapters/import-compiler/service.d.ts +7 -1
  49. package/dist/adapters/import-compiler/service.d.ts.map +1 -1
  50. package/dist/adapters/imports/graph.d.ts +6 -3
  51. package/dist/adapters/imports/graph.d.ts.map +1 -1
  52. package/dist/adapters/imports/graph.js +31 -18
  53. package/dist/adapters/imports/graph.js.map +1 -1
  54. package/dist/adapters/knip/configuration.d.ts +1 -1
  55. package/dist/adapters/knip/configuration.d.ts.map +1 -1
  56. package/dist/adapters/knip/configuration.js +6 -4
  57. package/dist/adapters/knip/configuration.js.map +1 -1
  58. package/dist/adapters/knip/entryPointFindings.d.ts +1 -1
  59. package/dist/adapters/knip/entryPointFindings.d.ts.map +1 -1
  60. package/dist/adapters/knip/run.d.ts.map +1 -1
  61. package/dist/adapters/knip/run.js +4 -1
  62. package/dist/adapters/knip/run.js.map +1 -1
  63. package/dist/adapters/outsideImportFindings.d.ts +4 -2
  64. package/dist/adapters/outsideImportFindings.d.ts.map +1 -1
  65. package/dist/adapters/outsideImportFindings.js +12 -52
  66. package/dist/adapters/outsideImportFindings.js.map +1 -1
  67. package/dist/adapters/queueReadoutFindings.d.ts +1 -1
  68. package/dist/adapters/queueReadoutFindings.d.ts.map +1 -1
  69. package/dist/adapters/rule.d.ts +9 -1
  70. package/dist/adapters/rule.d.ts.map +1 -1
  71. package/dist/adapters/rule.js +21 -6
  72. package/dist/adapters/rule.js.map +1 -1
  73. package/dist/adapters/runMain.d.ts +3 -4
  74. package/dist/adapters/runMain.d.ts.map +1 -1
  75. package/dist/adapters/runMain.js +2 -1
  76. package/dist/adapters/runMain.js.map +1 -1
  77. package/dist/adapters/serviceModelCheck.d.ts +9 -0
  78. package/dist/adapters/serviceModelCheck.d.ts.map +1 -0
  79. package/dist/adapters/{serviceModelFindings.js → serviceModelCheck.js} +9 -23
  80. package/dist/adapters/serviceModelCheck.js.map +1 -0
  81. package/dist/adapters/sharedErrorCatalog.d.ts +13 -0
  82. package/dist/adapters/sharedErrorCatalog.d.ts.map +1 -0
  83. package/dist/adapters/sharedErrorCatalog.js +28 -0
  84. package/dist/adapters/sharedErrorCatalog.js.map +1 -0
  85. package/dist/adapters/sharedErrorModules.d.ts +1 -1
  86. package/dist/adapters/sharedErrorModules.d.ts.map +1 -1
  87. package/dist/adapters/sharedErrorModules.js.map +1 -1
  88. package/dist/adapters/specReaderSources.d.ts +3 -2
  89. package/dist/adapters/specReaderSources.d.ts.map +1 -1
  90. package/dist/adapters/specReaderSources.js +6 -3
  91. package/dist/adapters/specReaderSources.js.map +1 -1
  92. package/dist/adapters/storyProgram.d.ts +2 -0
  93. package/dist/adapters/storyProgram.d.ts.map +1 -1
  94. package/dist/adapters/storyProgram.js +13 -3
  95. package/dist/adapters/storyProgram.js.map +1 -1
  96. package/dist/adapters/typeScriptProgram.d.ts +5 -0
  97. package/dist/adapters/typeScriptProgram.d.ts.map +1 -0
  98. package/dist/adapters/typeScriptProgram.js +43 -0
  99. package/dist/adapters/typeScriptProgram.js.map +1 -0
  100. package/dist/baseline/compare.d.ts +2 -0
  101. package/dist/baseline/compare.d.ts.map +1 -1
  102. package/dist/baseline/compare.js +43 -17
  103. package/dist/baseline/compare.js.map +1 -1
  104. package/dist/baseline/format.d.ts +1 -0
  105. package/dist/baseline/format.d.ts.map +1 -1
  106. package/dist/baseline/format.js +6 -2
  107. package/dist/baseline/format.js.map +1 -1
  108. package/dist/baseline/merge.d.ts.map +1 -1
  109. package/dist/baseline/merge.js +14 -1
  110. package/dist/baseline/merge.js.map +1 -1
  111. package/dist/baseline/rewrite.d.ts.map +1 -1
  112. package/dist/baseline/rewrite.js +3 -1
  113. package/dist/baseline/rewrite.js.map +1 -1
  114. package/dist/baseline/update.d.ts +7 -0
  115. package/dist/baseline/update.d.ts.map +1 -1
  116. package/dist/baseline/update.js +29 -8
  117. package/dist/baseline/update.js.map +1 -1
  118. package/dist/biome/exceptionConfig.d.ts +3 -0
  119. package/dist/biome/exceptionConfig.d.ts.map +1 -1
  120. package/dist/biome/exceptionConfig.js +15 -1
  121. package/dist/biome/exceptionConfig.js.map +1 -1
  122. package/dist/biome/scannerRules.d.ts +3 -0
  123. package/dist/biome/scannerRules.d.ts.map +1 -0
  124. package/dist/biome/scannerRules.js +42 -0
  125. package/dist/biome/scannerRules.js.map +1 -0
  126. package/dist/cli/args.d.ts +2 -0
  127. package/dist/cli/args.d.ts.map +1 -1
  128. package/dist/cli/args.js +10 -1
  129. package/dist/cli/args.js.map +1 -1
  130. package/dist/cli/baseline.d.ts.map +1 -1
  131. package/dist/cli/baseline.js +5 -1
  132. package/dist/cli/baseline.js.map +1 -1
  133. package/dist/cli/lint.d.ts +3 -2
  134. package/dist/cli/lint.d.ts.map +1 -1
  135. package/dist/cli/lint.js +13 -5
  136. package/dist/cli/lint.js.map +1 -1
  137. package/dist/cli/misplaced.d.ts +6 -0
  138. package/dist/cli/misplaced.d.ts.map +1 -1
  139. package/dist/cli/misplaced.js +4 -2
  140. package/dist/cli/misplaced.js.map +1 -1
  141. package/dist/cli/program.js +1 -1
  142. package/dist/cli/program.js.map +1 -1
  143. package/dist/cli/runSet.d.ts +5 -0
  144. package/dist/cli/runSet.d.ts.map +1 -0
  145. package/dist/cli/runSet.js +15 -0
  146. package/dist/cli/runSet.js.map +1 -0
  147. package/dist/cli/shrink.d.ts +4 -4
  148. package/dist/cli/shrink.d.ts.map +1 -1
  149. package/dist/cli/shrink.js.map +1 -1
  150. package/dist/cli/usage.d.ts +1 -1
  151. package/dist/cli/usage.d.ts.map +1 -1
  152. package/dist/cli/usage.js +7 -2
  153. package/dist/cli/usage.js.map +1 -1
  154. package/dist/config/decode.d.ts +1 -0
  155. package/dist/config/decode.d.ts.map +1 -1
  156. package/dist/config/decode.js +1 -0
  157. package/dist/config/decode.js.map +1 -1
  158. package/dist/config/load.d.ts +2 -0
  159. package/dist/config/load.d.ts.map +1 -1
  160. package/dist/config/load.js +1 -0
  161. package/dist/config/load.js.map +1 -1
  162. package/dist/config/resolve.d.ts +2 -1
  163. package/dist/config/resolve.d.ts.map +1 -1
  164. package/dist/config/resolve.js +9 -4
  165. package/dist/config/resolve.js.map +1 -1
  166. package/dist/config.d.ts +2 -0
  167. package/dist/config.d.ts.map +1 -1
  168. package/dist/config.js.map +1 -1
  169. package/dist/engine/childStarted.d.ts +4 -0
  170. package/dist/engine/childStarted.d.ts.map +1 -0
  171. package/dist/engine/childStarted.js +7 -0
  172. package/dist/engine/childStarted.js.map +1 -0
  173. package/dist/engine/evaluate.d.ts +1 -0
  174. package/dist/engine/evaluate.d.ts.map +1 -1
  175. package/dist/engine/evaluate.js +2 -1
  176. package/dist/engine/evaluate.js.map +1 -1
  177. package/dist/engine/runRule.d.ts +21 -0
  178. package/dist/engine/runRule.d.ts.map +1 -0
  179. package/dist/engine/runRule.js +70 -0
  180. package/dist/engine/runRule.js.map +1 -0
  181. package/dist/engine/runRules.d.ts +5 -12
  182. package/dist/engine/runRules.d.ts.map +1 -1
  183. package/dist/engine/runRules.js +49 -65
  184. package/dist/engine/runRules.js.map +1 -1
  185. package/dist/engine/session.d.ts +2 -1
  186. package/dist/engine/session.d.ts.map +1 -1
  187. package/dist/engine/session.js +20 -6
  188. package/dist/engine/session.js.map +1 -1
  189. package/dist/engine/violation.d.ts +7 -0
  190. package/dist/engine/violation.d.ts.map +1 -1
  191. package/dist/engine/violation.js +9 -0
  192. package/dist/engine/violation.js.map +1 -1
  193. package/dist/exceptions/biomeFindings.d.ts +5 -1
  194. package/dist/exceptions/biomeFindings.d.ts.map +1 -1
  195. package/dist/exceptions/biomeFindings.js +17 -18
  196. package/dist/exceptions/biomeFindings.js.map +1 -1
  197. package/dist/exceptions/registry.d.ts.map +1 -1
  198. package/dist/exceptions/registry.js +2 -2
  199. package/dist/exceptions/registry.js.map +1 -1
  200. package/dist/hooks/preCommit.d.ts +1 -2
  201. package/dist/hooks/preCommit.d.ts.map +1 -1
  202. package/dist/hooks/preCommit.js +11 -1
  203. package/dist/hooks/preCommit.js.map +1 -1
  204. package/dist/hooks/stagedCheck.d.ts +5 -0
  205. package/dist/hooks/stagedCheck.d.ts.map +1 -0
  206. package/dist/hooks/stagedCheck.js +43 -0
  207. package/dist/hooks/stagedCheck.js.map +1 -0
  208. package/dist/hooks/withStagedContent.d.ts +5 -0
  209. package/dist/hooks/withStagedContent.d.ts.map +1 -0
  210. package/dist/hooks/withStagedContent.js +84 -0
  211. package/dist/hooks/withStagedContent.js.map +1 -0
  212. package/dist/imports/browserGlobals.d.ts +1 -1
  213. package/dist/imports/browserGlobals.d.ts.map +1 -1
  214. package/dist/imports/browserNames.d.ts +1 -1
  215. package/dist/imports/browserNames.d.ts.map +1 -1
  216. package/dist/imports/browserNames.js +5 -3
  217. package/dist/imports/browserNames.js.map +1 -1
  218. package/dist/imports/fences/check.d.ts +1 -1
  219. package/dist/imports/fences/check.d.ts.map +1 -1
  220. package/dist/imports/fences/compilePolicy.js +1 -1
  221. package/dist/imports/fences/compilePolicy.js.map +1 -1
  222. package/dist/imports/fences/evaluate.d.ts +1 -1
  223. package/dist/imports/fences/evaluate.d.ts.map +1 -1
  224. package/dist/imports/fences/evaluate.js +1 -1
  225. package/dist/imports/fences/evaluate.js.map +1 -1
  226. package/dist/imports/graph.d.ts +6 -1
  227. package/dist/imports/graph.d.ts.map +1 -1
  228. package/dist/imports/graph.js +30 -2
  229. package/dist/imports/graph.js.map +1 -1
  230. package/dist/imports/withoutGenerated.js +1 -1
  231. package/dist/imports/withoutGenerated.js.map +1 -1
  232. package/dist/inventory/programmaticBuilds.d.ts +1 -1
  233. package/dist/inventory/programmaticBuilds.d.ts.map +1 -1
  234. package/dist/inventory/trackedPaths.d.ts +1 -0
  235. package/dist/inventory/trackedPaths.d.ts.map +1 -1
  236. package/dist/inventory/trackedPaths.js +9 -3
  237. package/dist/inventory/trackedPaths.js.map +1 -1
  238. package/dist/naming/testCode.d.ts +1 -1
  239. package/dist/naming/testCode.d.ts.map +1 -1
  240. package/dist/report/render.d.ts +1 -0
  241. package/dist/report/render.d.ts.map +1 -1
  242. package/dist/report/render.js +10 -3
  243. package/dist/report/render.js.map +1 -1
  244. package/dist/report/runSetLine.d.ts +3 -0
  245. package/dist/report/runSetLine.d.ts.map +1 -0
  246. package/dist/report/runSetLine.js +13 -0
  247. package/dist/report/runSetLine.js.map +1 -0
  248. package/dist/report/staleSections.d.ts.map +1 -1
  249. package/dist/report/staleSections.js +13 -0
  250. package/dist/report/staleSections.js.map +1 -1
  251. package/dist/rule.d.ts +30 -4
  252. package/dist/rule.d.ts.map +1 -1
  253. package/dist/rule.js +4 -2
  254. package/dist/rule.js.map +1 -1
  255. package/dist/rules/biome.d.ts +18 -1
  256. package/dist/rules/biome.d.ts.map +1 -1
  257. package/dist/rules/biome.js +32 -7
  258. package/dist/rules/biome.js.map +1 -1
  259. package/dist/rules/builtIn.d.ts +8 -8
  260. package/dist/rules/builtIn.d.ts.map +1 -1
  261. package/dist/rules/builtIn.js +0 -2
  262. package/dist/rules/builtIn.js.map +1 -1
  263. package/dist/rules/effect/adapterImports.d.ts +1 -1
  264. package/dist/rules/effect/adapterImports.d.ts.map +1 -1
  265. package/dist/rules/effect/adapterImports.js +1 -1
  266. package/dist/rules/effect/adapterImports.js.map +1 -1
  267. package/dist/rules/effect/boundary.d.ts +1 -1
  268. package/dist/rules/effect/boundary.d.ts.map +1 -1
  269. package/dist/rules/effect/boundary.js +60 -75
  270. package/dist/rules/effect/boundary.js.map +1 -1
  271. package/dist/rules/effect/boundaryFindings.d.ts +4 -0
  272. package/dist/rules/effect/boundaryFindings.d.ts.map +1 -0
  273. package/dist/rules/effect/boundaryFindings.js +63 -0
  274. package/dist/rules/effect/boundaryFindings.js.map +1 -0
  275. package/dist/rules/effect/boundaryReference.d.ts +4 -0
  276. package/dist/rules/effect/boundaryReference.d.ts.map +1 -1
  277. package/dist/rules/effect/boundaryReference.js +6 -3
  278. package/dist/rules/effect/boundaryReference.js.map +1 -1
  279. package/dist/rules/effect/contextCapture.d.ts.map +1 -1
  280. package/dist/rules/effect/contextCapture.js +3 -2
  281. package/dist/rules/effect/contextCapture.js.map +1 -1
  282. package/dist/rules/effect/errorTags.d.ts +10 -0
  283. package/dist/rules/effect/errorTags.d.ts.map +1 -0
  284. package/dist/rules/effect/errorTags.js +57 -0
  285. package/dist/rules/effect/errorTags.js.map +1 -0
  286. package/dist/rules/effect/failureHonesty.d.ts +1 -1
  287. package/dist/rules/effect/failureHonesty.d.ts.map +1 -1
  288. package/dist/rules/effect/failureHonesty.js +6 -5
  289. package/dist/rules/effect/failureHonesty.js.map +1 -1
  290. package/dist/rules/effect/policy.d.ts +1 -1
  291. package/dist/rules/effect/policy.d.ts.map +1 -1
  292. package/dist/rules/effect/policy.js +0 -2
  293. package/dist/rules/effect/policy.js.map +1 -1
  294. package/dist/rules/effect/promiseBridge.d.ts +3 -0
  295. package/dist/rules/effect/promiseBridge.d.ts.map +1 -0
  296. package/dist/rules/effect/promiseBridge.js +60 -0
  297. package/dist/rules/effect/promiseBridge.js.map +1 -0
  298. package/dist/rules/effect/rpcBoundary.d.ts.map +1 -1
  299. package/dist/rules/effect/rpcBoundary.js +92 -3
  300. package/dist/rules/effect/rpcBoundary.js.map +1 -1
  301. package/dist/rules/effect/serviceModel.d.ts.map +1 -1
  302. package/dist/rules/effect/serviceModel.js +3 -2
  303. package/dist/rules/effect/serviceModel.js.map +1 -1
  304. package/dist/rules/effect/serviceParameterCheck.d.ts +7 -0
  305. package/dist/rules/effect/serviceParameterCheck.d.ts.map +1 -0
  306. package/dist/rules/effect/serviceParameterCheck.js +15 -0
  307. package/dist/rules/effect/serviceParameterCheck.js.map +1 -0
  308. package/dist/rules/effect/serviceParameters.d.ts.map +1 -1
  309. package/dist/rules/effect/serviceParameters.js +4 -36
  310. package/dist/rules/effect/serviceParameters.js.map +1 -1
  311. package/dist/rules/effect/sharedErrorClasses.d.ts.map +1 -1
  312. package/dist/rules/effect/sharedErrorClasses.js +31 -2
  313. package/dist/rules/effect/sharedErrorClasses.js.map +1 -1
  314. package/dist/rules/effect/workspaceProgram.d.ts +5 -0
  315. package/dist/rules/effect/workspaceProgram.d.ts.map +1 -0
  316. package/dist/rules/effect/workspaceProgram.js +32 -0
  317. package/dist/rules/effect/workspaceProgram.js.map +1 -0
  318. package/dist/rules/imports/adminPaths.d.ts +1 -1
  319. package/dist/rules/imports/adminPaths.d.ts.map +1 -1
  320. package/dist/rules/imports/cycles.d.ts +1 -1
  321. package/dist/rules/imports/cycles.d.ts.map +1 -1
  322. package/dist/rules/imports/fences.d.ts +1 -1
  323. package/dist/rules/imports/fences.d.ts.map +1 -1
  324. package/dist/rules/imports/manifest.d.ts +1 -1
  325. package/dist/rules/imports/manifest.d.ts.map +1 -1
  326. package/dist/rules/imports/noTestCode.d.ts +1 -1
  327. package/dist/rules/imports/noTestCode.d.ts.map +1 -1
  328. package/dist/rules/imports/runtime.d.ts +1 -1
  329. package/dist/rules/imports/runtime.d.ts.map +1 -1
  330. package/dist/rules/imports/runtime.js +32 -5
  331. package/dist/rules/imports/runtime.js.map +1 -1
  332. package/dist/rules/manifestsNoTestKits.js +1 -1
  333. package/dist/rules/manifestsNoTestKits.js.map +1 -1
  334. package/dist/rules/maxLines.d.ts +1 -1
  335. package/dist/rules/maxLines.d.ts.map +1 -1
  336. package/dist/rules/packageFindings.d.ts +31 -0
  337. package/dist/rules/packageFindings.d.ts.map +1 -0
  338. package/dist/rules/packageFindings.js +65 -0
  339. package/dist/rules/packageFindings.js.map +1 -0
  340. package/dist/rules/parse.d.ts +4 -1
  341. package/dist/rules/parse.d.ts.map +1 -1
  342. package/dist/rules/parse.js +35 -2
  343. package/dist/rules/parse.js.map +1 -1
  344. package/dist/rules/rootedFindings.d.ts +5 -0
  345. package/dist/rules/rootedFindings.d.ts.map +1 -0
  346. package/dist/rules/rootedFindings.js +16 -0
  347. package/dist/rules/rootedFindings.js.map +1 -0
  348. package/dist/rules/stories/adapterOnlyFakes.d.ts +1 -1
  349. package/dist/rules/stories/adapterOnlyFakes.d.ts.map +1 -1
  350. package/dist/rules/stories/adapterOnlyFakes.js +1 -0
  351. package/dist/rules/stories/adapterOnlyFakes.js.map +1 -1
  352. package/dist/rules/stories/databaseUrl.d.ts +1 -1
  353. package/dist/rules/stories/databaseUrl.d.ts.map +1 -1
  354. package/dist/rules/stories/databaseUrl.js +1 -0
  355. package/dist/rules/stories/databaseUrl.js.map +1 -1
  356. package/dist/rules/stories/domainOutcomes.d.ts +1 -1
  357. package/dist/rules/stories/domainOutcomes.d.ts.map +1 -1
  358. package/dist/rules/stories/domainOutcomes.js +1 -0
  359. package/dist/rules/stories/domainOutcomes.js.map +1 -1
  360. package/dist/rules/stories/engine.d.ts +1 -1
  361. package/dist/rules/stories/engine.d.ts.map +1 -1
  362. package/dist/rules/stories/engine.js +1 -0
  363. package/dist/rules/stories/engine.js.map +1 -1
  364. package/dist/rules/stories/globalRetries.d.ts +1 -1
  365. package/dist/rules/stories/globalRetries.d.ts.map +1 -1
  366. package/dist/rules/stories/globalRetries.js +1 -0
  367. package/dist/rules/stories/globalRetries.js.map +1 -1
  368. package/dist/rules/stories/groupedOutcomes.d.ts +1 -1
  369. package/dist/rules/stories/groupedOutcomes.d.ts.map +1 -1
  370. package/dist/rules/stories/groupedOutcomes.js +1 -0
  371. package/dist/rules/stories/groupedOutcomes.js.map +1 -1
  372. package/dist/rules/stories/importedChangeKeys.js +2 -2
  373. package/dist/rules/stories/importedChangeKeys.js.map +1 -1
  374. package/dist/rules/stories/namedValues.d.ts +1 -1
  375. package/dist/rules/stories/namedValues.d.ts.map +1 -1
  376. package/dist/rules/stories/namedValues.js +1 -0
  377. package/dist/rules/stories/namedValues.js.map +1 -1
  378. package/dist/rules/stories/noExpect.d.ts +1 -1
  379. package/dist/rules/stories/noExpect.d.ts.map +1 -1
  380. package/dist/rules/stories/noLimitImports.d.ts +1 -1
  381. package/dist/rules/stories/noLimitImports.d.ts.map +1 -1
  382. package/dist/rules/stories/noLimitImports.js +1 -0
  383. package/dist/rules/stories/noLimitImports.js.map +1 -1
  384. package/dist/rules/stories/positiveRefusals.d.ts +1 -1
  385. package/dist/rules/stories/positiveRefusals.d.ts.map +1 -1
  386. package/dist/rules/stories/positiveRefusals.js +1 -0
  387. package/dist/rules/stories/positiveRefusals.js.map +1 -1
  388. package/dist/rules/stories/queueReadouts.d.ts +1 -1
  389. package/dist/rules/stories/queueReadouts.d.ts.map +1 -1
  390. package/dist/rules/stories/queueReadouts.js +1 -0
  391. package/dist/rules/stories/queueReadouts.js.map +1 -1
  392. package/dist/rules/stories/sources.d.ts +2 -2
  393. package/dist/rules/stories/sources.d.ts.map +1 -1
  394. package/dist/rules/stories/specHelpers.d.ts +1 -1
  395. package/dist/rules/stories/specHelpers.d.ts.map +1 -1
  396. package/dist/rules/stories/specHelpers.js +3 -2
  397. package/dist/rules/stories/specHelpers.js.map +1 -1
  398. package/dist/rules/stories/specs.d.ts +1 -1
  399. package/dist/rules/stories/specs.d.ts.map +1 -1
  400. package/dist/rules/stories/specs.js +1 -0
  401. package/dist/rules/stories/specs.js.map +1 -1
  402. package/dist/rules/stories/waitOnEvents.d.ts +1 -1
  403. package/dist/rules/stories/waitOnEvents.d.ts.map +1 -1
  404. package/dist/rules/stories/waitOnEvents.js +3 -3
  405. package/dist/rules/stories/waitOnEvents.js.map +1 -1
  406. package/dist/rules/suppressions/noDoubleCast.d.ts.map +1 -1
  407. package/dist/rules/suppressions/noDoubleCast.js +4 -49
  408. package/dist/rules/suppressions/noDoubleCast.js.map +1 -1
  409. package/dist/rules/suppressions/typedCastCheck.d.ts +10 -0
  410. package/dist/rules/suppressions/typedCastCheck.d.ts.map +1 -0
  411. package/dist/rules/suppressions/typedCastCheck.js +48 -0
  412. package/dist/rules/suppressions/typedCastCheck.js.map +1 -0
  413. package/dist/rules/unusedCode.d.ts.map +1 -1
  414. package/dist/rules/unusedCode.js +1 -0
  415. package/dist/rules/unusedCode.js.map +1 -1
  416. package/dist/testing/adapters/cli.d.ts +1 -0
  417. package/dist/testing/adapters/cli.d.ts.map +1 -1
  418. package/dist/testing/adapters/cli.js +10 -8
  419. package/dist/testing/adapters/cli.js.map +1 -1
  420. package/dist/testing/adapters/git.d.ts +1 -16
  421. package/dist/testing/adapters/git.d.ts.map +1 -1
  422. package/dist/testing/adapters/git.js +5 -10
  423. package/dist/testing/adapters/git.js.map +1 -1
  424. package/dist/testing/adapters/hookRepository.d.ts +3 -2
  425. package/dist/testing/adapters/hookRepository.d.ts.map +1 -1
  426. package/dist/testing/adapters/hookRepository.js +11 -8
  427. package/dist/testing/adapters/hookRepository.js.map +1 -1
  428. package/dist/testing/adapters/imports.d.ts.map +1 -1
  429. package/dist/testing/adapters/imports.js +4 -1
  430. package/dist/testing/adapters/imports.js.map +1 -1
  431. package/dist/testing/ruleStory.d.ts +1 -1
  432. package/dist/testing/ruleStory.js +2 -2
  433. package/dist/testing/ruleStory.js.map +1 -1
  434. package/docs/debt-and-hooks.md +5 -3
  435. package/package.json +19 -19
  436. package/src/adapters/biome/pluginContract.ts +2 -5
  437. package/src/adapters/biome/run.ts +2 -0
  438. package/src/adapters/biome/withExceptionConfig.ts +26 -5
  439. package/src/adapters/{changeKeyFindings.ts → changeKeyCheck.ts} +8 -24
  440. package/src/adapters/contextCaptureCheck.ts +106 -0
  441. package/src/adapters/declaration-files/initialize.ts +4 -0
  442. package/src/adapters/declaration-files/parse.ts +9 -0
  443. package/src/adapters/declaration-files/reader.ts +28 -0
  444. package/src/adapters/declaration-files/service.ts +16 -0
  445. package/src/adapters/foreignResources.ts +0 -4
  446. package/src/adapters/import-compiler/graph.ts +7 -2
  447. package/src/adapters/imports/graph.ts +43 -18
  448. package/src/adapters/knip/configuration.ts +6 -4
  449. package/src/adapters/knip/run.ts +4 -1
  450. package/src/adapters/outsideImportFindings.ts +21 -65
  451. package/src/adapters/rule.ts +29 -6
  452. package/src/adapters/runMain.ts +7 -6
  453. package/src/adapters/{serviceModelFindings.ts → serviceModelCheck.ts} +10 -25
  454. package/src/adapters/sharedErrorCatalog.ts +43 -0
  455. package/src/adapters/sharedErrorModules.ts +1 -1
  456. package/src/adapters/specReaderSources.ts +6 -3
  457. package/src/adapters/storyProgram.ts +20 -3
  458. package/src/adapters/typeScriptProgram.ts +57 -0
  459. package/src/baseline/compare.ts +59 -19
  460. package/src/baseline/format.ts +7 -2
  461. package/src/baseline/merge.ts +15 -1
  462. package/src/baseline/rewrite.ts +3 -1
  463. package/src/baseline/update.ts +38 -8
  464. package/src/biome/exceptionConfig.ts +24 -3
  465. package/src/biome/scannerRules.ts +42 -0
  466. package/src/cli/args.ts +13 -2
  467. package/src/cli/baseline.ts +7 -1
  468. package/src/cli/lint.ts +14 -6
  469. package/src/cli/misplaced.ts +4 -2
  470. package/src/cli/program.ts +1 -1
  471. package/src/cli/runSet.ts +17 -0
  472. package/src/cli/shrink.ts +4 -11
  473. package/src/cli/usage.ts +7 -2
  474. package/src/config/decode.ts +1 -0
  475. package/src/config/load.ts +3 -0
  476. package/src/config/resolve.ts +11 -6
  477. package/src/config.ts +3 -0
  478. package/src/engine/childStarted.ts +8 -0
  479. package/src/engine/evaluate.ts +3 -1
  480. package/src/engine/runRule.ts +103 -0
  481. package/src/engine/runRules.ts +64 -86
  482. package/src/engine/session.ts +23 -5
  483. package/src/engine/violation.ts +16 -0
  484. package/src/exceptions/biomeFindings.ts +24 -21
  485. package/src/exceptions/registry.ts +2 -2
  486. package/src/hooks/preCommit.ts +15 -1
  487. package/src/hooks/stagedCheck.ts +54 -0
  488. package/src/hooks/withStagedContent.ts +111 -0
  489. package/src/imports/browserNames.ts +7 -5
  490. package/src/imports/fences/compilePolicy.ts +1 -1
  491. package/src/imports/fences/evaluate.ts +2 -2
  492. package/src/imports/graph.ts +47 -3
  493. package/src/imports/withoutGenerated.ts +1 -1
  494. package/src/inventory/trackedPaths.ts +10 -3
  495. package/src/report/render.ts +12 -3
  496. package/src/report/runSetLine.ts +14 -0
  497. package/src/report/staleSections.ts +14 -0
  498. package/src/rule.ts +38 -7
  499. package/src/rules/biome.ts +53 -7
  500. package/src/rules/builtIn.ts +0 -2
  501. package/src/rules/effect/adapterImports.ts +1 -1
  502. package/src/rules/effect/boundary.ts +82 -83
  503. package/src/rules/effect/boundaryFindings.ts +71 -0
  504. package/src/rules/effect/boundaryReference.ts +7 -3
  505. package/src/rules/effect/contextCapture.ts +3 -2
  506. package/src/rules/effect/errorTags.ts +72 -0
  507. package/src/rules/effect/failureHonesty.ts +9 -5
  508. package/src/rules/effect/policy.ts +0 -2
  509. package/src/rules/effect/promiseBridge.ts +65 -0
  510. package/src/rules/effect/rpcBoundary.ts +111 -4
  511. package/src/rules/effect/serviceModel.ts +3 -2
  512. package/src/rules/effect/serviceParameterCheck.ts +22 -0
  513. package/src/rules/effect/serviceParameters.ts +5 -37
  514. package/src/rules/effect/sharedErrorClasses.ts +41 -3
  515. package/src/rules/effect/workspaceProgram.ts +34 -0
  516. package/src/rules/imports/runtime.ts +43 -6
  517. package/src/rules/manifestsNoTestKits.ts +1 -1
  518. package/src/rules/packageFindings.ts +103 -0
  519. package/src/rules/parse.ts +54 -3
  520. package/src/rules/rootedFindings.ts +19 -0
  521. package/src/rules/stories/adapterOnlyFakes.ts +1 -0
  522. package/src/rules/stories/databaseUrl.ts +1 -0
  523. package/src/rules/stories/domainOutcomes.ts +1 -0
  524. package/src/rules/stories/engine.ts +1 -0
  525. package/src/rules/stories/globalRetries.ts +1 -0
  526. package/src/rules/stories/groupedOutcomes.ts +1 -0
  527. package/src/rules/stories/importedChangeKeys.ts +2 -2
  528. package/src/rules/stories/namedValues.ts +1 -0
  529. package/src/rules/stories/noLimitImports.ts +1 -0
  530. package/src/rules/stories/positiveRefusals.ts +1 -0
  531. package/src/rules/stories/queueReadouts.ts +1 -0
  532. package/src/rules/stories/specHelpers.ts +8 -5
  533. package/src/rules/stories/specs.ts +1 -0
  534. package/src/rules/stories/waitOnEvents.ts +6 -3
  535. package/src/rules/suppressions/noDoubleCast.ts +5 -55
  536. package/src/rules/suppressions/typedCastCheck.ts +55 -0
  537. package/src/rules/unusedCode.ts +1 -0
  538. package/src/testing/adapters/cli.ts +13 -9
  539. package/src/testing/adapters/git.ts +6 -11
  540. package/src/testing/adapters/hookRepository.ts +12 -7
  541. package/src/testing/adapters/imports.ts +4 -1
  542. package/src/testing/ruleStory.ts +2 -2
  543. package/dist/adapters/biome/presetConfig.d.ts +0 -21
  544. package/dist/adapters/biome/presetConfig.d.ts.map +0 -1
  545. package/dist/adapters/biome/presetConfig.js +0 -32
  546. package/dist/adapters/biome/presetConfig.js.map +0 -1
  547. package/dist/adapters/changeKeyFindings.d.ts +0 -4
  548. package/dist/adapters/changeKeyFindings.d.ts.map +0 -1
  549. package/dist/adapters/changeKeyFindings.js.map +0 -1
  550. package/dist/adapters/contextCaptureFindings.d.ts +0 -4
  551. package/dist/adapters/contextCaptureFindings.d.ts.map +0 -1
  552. package/dist/adapters/contextCaptureFindings.js +0 -51
  553. package/dist/adapters/contextCaptureFindings.js.map +0 -1
  554. package/dist/adapters/nativeTransactionFindings.d.ts +0 -4
  555. package/dist/adapters/nativeTransactionFindings.d.ts.map +0 -1
  556. package/dist/adapters/nativeTransactionFindings.js +0 -98
  557. package/dist/adapters/nativeTransactionFindings.js.map +0 -1
  558. package/dist/adapters/rpcBoundaryFindings.d.ts +0 -4
  559. package/dist/adapters/rpcBoundaryFindings.d.ts.map +0 -1
  560. package/dist/adapters/rpcBoundaryFindings.js +0 -90
  561. package/dist/adapters/rpcBoundaryFindings.js.map +0 -1
  562. package/dist/adapters/serviceModelFindings.d.ts +0 -4
  563. package/dist/adapters/serviceModelFindings.d.ts.map +0 -1
  564. package/dist/adapters/serviceModelFindings.js.map +0 -1
  565. package/dist/adapters/sharedErrorFindings.d.ts +0 -4
  566. package/dist/adapters/sharedErrorFindings.d.ts.map +0 -1
  567. package/dist/adapters/sharedErrorFindings.js +0 -71
  568. package/dist/adapters/sharedErrorFindings.js.map +0 -1
  569. package/dist/adapters/transactionChanges.d.ts +0 -3
  570. package/dist/adapters/transactionChanges.d.ts.map +0 -1
  571. package/dist/adapters/transactionChanges.js +0 -81
  572. package/dist/adapters/transactionChanges.js.map +0 -1
  573. package/dist/adapters/vitePort.d.ts +0 -2
  574. package/dist/adapters/vitePort.d.ts.map +0 -1
  575. package/dist/adapters/vitePort.js +0 -5
  576. package/dist/adapters/vitePort.js.map +0 -1
  577. package/dist/appTestConfig.d.ts +0 -4
  578. package/dist/appTestConfig.d.ts.map +0 -1
  579. package/dist/appTestConfig.js +0 -9
  580. package/dist/appTestConfig.js.map +0 -1
  581. package/dist/appViteConfig.d.ts +0 -23
  582. package/dist/appViteConfig.d.ts.map +0 -1
  583. package/dist/appViteConfig.js +0 -17
  584. package/dist/appViteConfig.js.map +0 -1
  585. package/dist/biome/recommendedRules.d.ts +0 -3
  586. package/dist/biome/recommendedRules.d.ts.map +0 -1
  587. package/dist/biome/recommendedRules.js +0 -20
  588. package/dist/biome/recommendedRules.js.map +0 -1
  589. package/dist/rules/effect/program.d.ts +0 -8
  590. package/dist/rules/effect/program.d.ts.map +0 -1
  591. package/dist/rules/effect/program.js +0 -53
  592. package/dist/rules/effect/program.js.map +0 -1
  593. package/dist/rules/effect/sqlTransact.d.ts +0 -2
  594. package/dist/rules/effect/sqlTransact.d.ts.map +0 -1
  595. package/dist/rules/effect/sqlTransact.js +0 -9
  596. package/dist/rules/effect/sqlTransact.js.map +0 -1
  597. package/dist/rules/suppressions/biomeRecommended.d.ts +0 -7
  598. package/dist/rules/suppressions/biomeRecommended.d.ts.map +0 -1
  599. package/dist/rules/suppressions/biomeRecommended.js +0 -47
  600. package/dist/rules/suppressions/biomeRecommended.js.map +0 -1
  601. package/src/adapters/biome/presetConfig.ts +0 -34
  602. package/src/adapters/contextCaptureFindings.ts +0 -60
  603. package/src/adapters/nativeTransactionFindings.ts +0 -108
  604. package/src/adapters/rpcBoundaryFindings.ts +0 -98
  605. package/src/adapters/sharedErrorFindings.ts +0 -84
  606. package/src/adapters/transactionChanges.ts +0 -85
  607. package/src/adapters/vitePort.ts +0 -5
  608. package/src/appTestConfig.ts +0 -10
  609. package/src/appViteConfig.ts +0 -24
  610. package/src/biome/recommendedRules.ts +0 -27
  611. package/src/rules/effect/program.ts +0 -57
  612. package/src/rules/effect/sqlTransact.ts +0 -10
  613. package/src/rules/suppressions/biomeRecommended.ts +0 -60
@@ -2,22 +2,42 @@ import { join, relative } from "node:path";
2
2
  import { Effect, Schema } from "effect";
3
3
  import { browserOverrides } from "#adapters/biome/browserTargets.ts";
4
4
  import { parseConfig, relocateConfig } from "#adapters/biome/relocateConfig.ts";
5
- import { exceptionConfig } from "#biome/exceptionConfig.ts";
5
+ import { exceptionConfig, type RulesOff } from "#biome/exceptionConfig.ts";
6
6
  import type { ExceptionDeclaration } from "#exceptions/declaration.ts";
7
7
  import { readOptionalText } from "#inventory/filesystem.ts";
8
8
  import { ignoredPaths } from "#inventory/trackedPaths.ts";
9
9
 
10
+ const isObject = Schema.is(Schema.Record(Schema.String, Schema.Unknown));
11
+
12
+ // A group the config sets by one severity keeps it; the rules it would turn off then still run, and their findings are left to the scanner half.
13
+ function linterWithRulesOff(linter: unknown, off: RulesOff): unknown {
14
+ const own = isObject(linter) ? linter : {};
15
+ const ownRules = isObject(own.rules) ? own.rules : {};
16
+ const groups = Object.entries(off).map(([group, names]) => {
17
+ const ownGroup = ownRules[group];
18
+ return [group, typeof ownGroup === "string" ? ownGroup : { ...(isObject(ownGroup) ? ownGroup : {}), ...names }];
19
+ });
20
+ return groups.length === 0 ? linter : { ...own, rules: { ...ownRules, ...Object.fromEntries(groups) } };
21
+ }
22
+
10
23
  export const withExceptionConfig = Effect.fn("Biome.withExceptionConfig")(function* <TValue, TError, TRequirements>(
11
24
  root: string,
12
25
  declarations: readonly ExceptionDeclaration[],
13
26
  run: (args: readonly string[]) => Effect.Effect<TValue, TError, TRequirements>,
14
27
  nonEffectFolders: readonly string[] = [],
15
28
  ) {
16
- const { includes, overrides } = exceptionConfig(declarations);
29
+ const { includes, overrides, rules } = exceptionConfig(declarations);
17
30
  const targets = yield* browserOverrides(root);
18
31
  const gitIgnored = (yield* ignoredPaths(root)) ?? [];
19
32
  const gitIgnores = gitIgnored.map((file) => `!${relative(root, file).replaceAll("\\", "/")}`);
20
- if (includes.length === 0 && overrides.length === 0 && nonEffectFolders.length === 0 && targets.length === 0 && gitIgnores.length === 0) {
33
+ if (
34
+ includes.length === 0
35
+ && overrides.length === 0
36
+ && Object.keys(rules).length === 0
37
+ && nonEffectFolders.length === 0
38
+ && targets.length === 0
39
+ && gitIgnores.length === 0
40
+ ) {
21
41
  return yield* run([]);
22
42
  }
23
43
  const { config, text } = yield* Effect.gen(function* () {
@@ -30,9 +50,9 @@ export const withExceptionConfig = Effect.fn("Biome.withExceptionConfig")(functi
30
50
  return { config: "biome.json", text: "{}" };
31
51
  });
32
52
  const own = yield* parseConfig(config, text);
33
- const files = Schema.is(Schema.Record(Schema.String, Schema.Unknown))(own.files) ? own.files : {};
53
+ const files = isObject(own.files) ? own.files : {};
34
54
  if (
35
- (own.files !== undefined && !Schema.is(Schema.Record(Schema.String, Schema.Unknown))(own.files))
55
+ (own.files !== undefined && !isObject(own.files))
36
56
  || (files.includes !== undefined && !Array.isArray(files.includes))
37
57
  || (own.overrides !== undefined && !Array.isArray(own.overrides))
38
58
  ) {
@@ -47,6 +67,7 @@ export const withExceptionConfig = Effect.fn("Biome.withExceptionConfig")(functi
47
67
  ...files,
48
68
  includes: [...previousIncludes, ...includes.filter((pattern) => pattern !== "**"), ...gitIgnores, "!.worktrees"],
49
69
  },
70
+ linter: linterWithRulesOff(own.linter, rules),
50
71
  overrides: [...previousOverrides, ...overrides, ...targets],
51
72
  };
52
73
  const path = yield* relocateConfig(root, join(root, config), generated, nonEffectFolders);
@@ -1,10 +1,8 @@
1
- import { join } from "node:path";
2
1
  import { Effect } from "effect";
3
2
  import ts from "typescript";
4
3
  import { changeKeyApi } from "#adapters/changeKeyApi.ts";
5
4
  import { changeKeyLiterals } from "#adapters/changeKeyLiterals.ts";
6
- import type { Finding, RuleInputs, SourceFile } from "#rule.ts";
7
- import { effectProgram } from "#rules/effect/program.ts";
5
+ import type { Finding, SourceFile, TypeScriptProgram } from "#rule.ts";
8
6
  import { parse } from "#rules/parse.ts";
9
7
  import { importBindings } from "#rules/stories/importBindings.ts";
10
8
  import { memberName, nodesWhere, unwrapped } from "#rules/stories/syntax.ts";
@@ -44,7 +42,7 @@ function candidate(node: ts.Node, aliases: ReadonlySet<string>): node is ts.Call
44
42
  }
45
43
 
46
44
  function hasCandidates(file: SourceFile): boolean {
47
- const source = parse(file);
45
+ const source = [...APIS].some((name) => file.text.includes(name)) ? parse(file) : undefined;
48
46
  if (source === undefined) {
49
47
  return false;
50
48
  }
@@ -52,11 +50,9 @@ function hasCandidates(file: SourceFile): boolean {
52
50
  return nodesWhere(source, (node) => candidate(node, aliases)).length > 0;
53
51
  }
54
52
 
55
- function findingsIn(inputs: RuleInputs): readonly Finding[] {
56
- const program = effectProgram(inputs);
57
- const checker = program.getTypeChecker();
58
- return inputs.sources.flatMap((file) => {
59
- const source = program.getSourceFile(join(inputs.root, file.path));
53
+ function findingsIn(sources: readonly SourceFile[], { checker, sourceFile }: TypeScriptProgram): readonly Finding[] {
54
+ return sources.flatMap((file) => {
55
+ const source = sourceFile(file.path);
60
56
  if (source === undefined) {
61
57
  return [];
62
58
  }
@@ -79,18 +75,6 @@ function findingsIn(inputs: RuleInputs): readonly Finding[] {
79
75
  });
80
76
  }
81
77
 
82
- export const changeKeyFindings = Effect.fn("ChangeKeys.changeKeyFindings")((inputs: RuleInputs) =>
83
- Effect.sync(() => {
84
- const groups = new Map<string, RuleInputs["sources"][number][]>();
85
- for (const source of inputs.sources) {
86
- if (!hasCandidates(source)) {
87
- continue;
88
- }
89
- const group = /^(?:packages|examples)\/[^/]+/u.exec(source.path)?.[0] ?? ".";
90
- const sources = groups.get(group) ?? [];
91
- sources.push(source);
92
- groups.set(group, sources);
93
- }
94
- return [...groups.values()].flatMap((sources) => findingsIn({ ...inputs, sources }));
95
- }),
96
- );
78
+ export function changeKeyCheck() {
79
+ return Effect.succeed({ checks: hasCandidates, findings: findingsIn });
80
+ }
@@ -0,0 +1,106 @@
1
+ import ts from "typescript";
2
+ import { composedContext } from "#adapters/composedContext.ts";
3
+ import { effectApi } from "#adapters/serviceModelSyntax.ts";
4
+ import type { Finding, SourceFile, TypeScriptProgram } from "#rule.ts";
5
+ import { parse } from "#rules/parse.ts";
6
+ import { importBindings } from "#rules/stories/importBindings.ts";
7
+ import { memberName, nodesWhere, unwrapped } from "#rules/stories/syntax.ts";
8
+
9
+ const RUNNERS = ["provideContext", "runPromiseWith", "runForkWith"];
10
+ const PROVIDERS = [...RUNNERS, "provide"];
11
+
12
+ function context(type: ts.Type): boolean {
13
+ return type.isUnionOrIntersection() ? type.types.some(context) : type.getProperty("~effect/Context") !== undefined;
14
+ }
15
+
16
+ function reprovides(checker: ts.TypeChecker, call: ts.CallExpression): boolean {
17
+ if (RUNNERS.some((name) => effectApi(checker, call.expression, name))) {
18
+ return true;
19
+ }
20
+ if (!effectApi(checker, call.expression, "provide")) {
21
+ return false;
22
+ }
23
+ const environment = call.arguments.at(-1);
24
+ return environment !== undefined && context(checker.getTypeAtLocation(environment));
25
+ }
26
+
27
+ const LAYER_NAME = /(?:Layer|Live)$|^layer$/u;
28
+
29
+ function aliasesIn(source: ts.SourceFile): ReadonlyMap<string, string> {
30
+ const aliases = new Map(
31
+ [...importBindings(source)].flatMap(([local, { imported }]) => (PROVIDERS.includes(imported) ? [[local, imported] as const] : [])),
32
+ );
33
+ for (const node of nodesWhere(source, (child) => ts.isBindingElement(child) || ts.isVariableDeclaration(child))) {
34
+ if (ts.isBindingElement(node) && ts.isIdentifier(node.name)) {
35
+ const property = node.propertyName ?? node.name;
36
+ if (ts.isIdentifier(property) && PROVIDERS.includes(property.text)) {
37
+ aliases.set(node.name.text, property.text);
38
+ }
39
+ } else if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.initializer !== undefined) {
40
+ const api = apiOf(node.initializer, aliases);
41
+ if (api !== undefined) {
42
+ aliases.set(node.name.text, api);
43
+ }
44
+ }
45
+ }
46
+ return aliases;
47
+ }
48
+
49
+ function apiOf(callee: ts.Expression, aliases: ReadonlyMap<string, string>): string | undefined {
50
+ const value = unwrapped(callee);
51
+ const name = ts.isIdentifier(value) ? (aliases.get(value.text) ?? value.text) : memberName(value);
52
+ return name !== undefined && PROVIDERS.includes(name) ? name : undefined;
53
+ }
54
+
55
+ function layerShaped(argument: ts.Expression): boolean {
56
+ let root = unwrapped(argument);
57
+ const name = ts.isIdentifier(root) ? root.text : memberName(root);
58
+ while (ts.isCallExpression(root) || ts.isPropertyAccessExpression(root)) {
59
+ root = unwrapped(root.expression);
60
+ }
61
+ return LAYER_NAME.test(name ?? "") || (ts.isIdentifier(root) && root.text === "Layer");
62
+ }
63
+
64
+ // Only these call shapes can re-provide a context, so a file without one never enters the type-checked program.
65
+ function candidate(file: SourceFile): boolean {
66
+ const source =
67
+ /(?:^|\/)(?:adapters|test-support)\//u.test(file.path) || !PROVIDERS.some((name) => file.text.includes(name)) ? undefined : parse(file);
68
+ if (source === undefined) {
69
+ return false;
70
+ }
71
+ const aliases = aliasesIn(source);
72
+ return (
73
+ nodesWhere(source, (node) => {
74
+ const api = ts.isCallExpression(node) ? apiOf(node.expression, aliases) : undefined;
75
+ const environment = ts.isCallExpression(node) ? node.arguments.at(-1) : undefined;
76
+ return api !== undefined && (api !== "provide" || (environment !== undefined && !layerShaped(environment)));
77
+ }).length > 0
78
+ );
79
+ }
80
+
81
+ function findingsIn(sources: readonly SourceFile[], { checker, sourceFile }: TypeScriptProgram): readonly Finding[] {
82
+ return sources.flatMap((file): readonly Finding[] => {
83
+ const source = sourceFile(file.path);
84
+ if (source === undefined) {
85
+ return [];
86
+ }
87
+ const syntax = source;
88
+ const findings: Finding[] = [];
89
+ function visit(node: ts.Node): void {
90
+ const environment = ts.isCallExpression(node) ? node.arguments.at(-1) : undefined;
91
+ if (ts.isCallExpression(node) && reprovides(checker, node) && !(environment !== undefined && composedContext(checker, environment))) {
92
+ findings.push({
93
+ file: file.path,
94
+ line: syntax.getLineAndCharacterOfPosition(node.getStart(syntax)).line + 1,
95
+ message:
96
+ "Do not re-provide a captured Effect context in core code. Declare service requirements once and yield dependencies and the caller from the environment. Register the Layer at the host; put runtime bridges in adapters/ or test-support/.",
97
+ });
98
+ }
99
+ ts.forEachChild(node, visit);
100
+ }
101
+ visit(source);
102
+ return findings;
103
+ });
104
+ }
105
+
106
+ export const contextCaptureCheck = { checks: candidate, findings: findingsIn };
@@ -0,0 +1,4 @@
1
+ import { Effect } from "effect";
2
+ import ts from "typescript";
3
+
4
+ export const initializeDeclarationFiles = Effect.sync(() => ({ registry: ts.createDocumentRegistry(ts.sys.useCaseSensitiveFileNames) }));
@@ -0,0 +1,9 @@
1
+ import { Effect } from "effect";
2
+ import ts from "typescript";
3
+ import type { initializeDeclarationFiles } from "#adapters/declaration-files/initialize.ts";
4
+
5
+ export function parse(state: Effect.Success<typeof initializeDeclarationFiles>) {
6
+ return Effect.fn("DeclarationFiles.parse")((fileName: string, text: string, options: ts.CompilerOptions) =>
7
+ Effect.sync(() => state.registry.acquireDocument(fileName, options, ts.ScriptSnapshot.fromString(text), text)),
8
+ );
9
+ }
@@ -0,0 +1,28 @@
1
+ import { dirname } from "node:path";
2
+ import { Effect } from "effect";
3
+ import ts from "typescript";
4
+ import type { initializeDeclarationFiles } from "#adapters/declaration-files/initialize.ts";
5
+
6
+ const LIBRARY = `${dirname(ts.getDefaultLibFilePath({}))}/`;
7
+ const DECLARATION = /\.d\.[cm]?ts$/u;
8
+
9
+ // Workspace and fixture files can differ between programs through a rule's own sources, so only installed and library declarations are shared.
10
+ function shareable(fileName: string): boolean {
11
+ return DECLARATION.test(fileName) && (fileName.startsWith(LIBRARY) || fileName.includes("/node_modules/"));
12
+ }
13
+
14
+ export function reader(state: Effect.Success<typeof initializeDeclarationFiles>) {
15
+ return Effect.fn("DeclarationFiles.reader")((host: ts.CompilerHost, options: ts.CompilerOptions) =>
16
+ Effect.sync((): ts.CompilerHost["getSourceFile"] => {
17
+ const read = host.getSourceFile.bind(host);
18
+ return (fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile) => {
19
+ const text = shouldCreateNewSourceFile || !shareable(fileName) ? undefined : host.readFile(fileName);
20
+ // The registry binds a file once for every program in its bucket, so it keys buckets by the options that change parsing and
21
+ // binding; the text is the version, so a file whose text changed is parsed again.
22
+ return text === undefined
23
+ ? read(fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile)
24
+ : state.registry.acquireDocument(fileName, options, ts.ScriptSnapshot.fromString(text), text, undefined, languageVersionOrOptions);
25
+ };
26
+ }),
27
+ );
28
+ }
@@ -0,0 +1,16 @@
1
+ import type { Effect } from "effect";
2
+ import type ts from "typescript";
3
+ import { defineService } from "@shivaedev/service/defineService.ts";
4
+ import { initializeDeclarationFiles } from "#adapters/declaration-files/initialize.ts";
5
+ import { parse } from "#adapters/declaration-files/parse.ts";
6
+ import { reader } from "#adapters/declaration-files/reader.ts";
7
+
8
+ export const DeclarationFiles = defineService({
9
+ id: "@shivaedev/quality/DeclarationFiles",
10
+ initialize: initializeDeclarationFiles,
11
+ methods: (state) => ({
12
+ parse: parse(state) satisfies (fileName: string, text: string, options: ts.CompilerOptions) => Effect.Effect<ts.SourceFile>,
13
+ reader: reader(state) satisfies (host: ts.CompilerHost, options: ts.CompilerOptions) => Effect.Effect<ts.CompilerHost["getSourceFile"]>,
14
+ }),
15
+ requires: [],
16
+ });
@@ -47,10 +47,6 @@ function acquisition(checker: ts.TypeChecker, node: ts.CallExpression | ts.NewEx
47
47
  export function foreignResources(checker: ts.TypeChecker, sources: readonly ts.SourceFile[]) {
48
48
  const originates = parameterOrigins(checker, sources);
49
49
  return (parameter: ts.ParameterDeclaration): boolean => {
50
- const source = parameter.getSourceFile();
51
- if (!/(?:^|\/)adapters\//u.test(source.fileName)) {
52
- return false;
53
- }
54
50
  const type = checker.getTypeAtLocation(parameter);
55
51
  if (!(type.getSymbol()?.declarations ?? []).some(foreignDeclaration) || type.getProperty("~effect/Context/Service") !== undefined) {
56
52
  return false;
@@ -2,8 +2,13 @@ import { realpathSync } from "node:fs";
2
2
  import { Effect } from "effect";
3
3
  import { analysisFailure } from "#adapters/imports/analysisFailure.ts";
4
4
  import { graph as buildGraph } from "#adapters/imports/graph.ts";
5
- import type { RuleInputs } from "#rule.ts";
5
+ import type { RuleInputs, SourceFile } from "#rule.ts";
6
6
 
7
7
  export const graph = Effect.fn("ImportCompiler.graph")((inputs: RuleInputs) =>
8
- Effect.try({ catch: (cause) => analysisFailure(inputs.root, cause), try: () => buildGraph(inputs, realpathSync(inputs.root)) }),
8
+ Effect.try({ catch: (cause) => analysisFailure(inputs.root, cause), try: () => buildGraph(inputs, realpathSync(inputs.root)) }).pipe(
9
+ Effect.map(({ follow, ...walked }) => ({
10
+ ...walked,
11
+ follow: (files: readonly SourceFile[]) => Effect.try({ catch: (cause) => analysisFailure(inputs.root, cause), try: () => follow(files) }),
12
+ })),
13
+ ),
9
14
  );
@@ -5,7 +5,7 @@ import { isDeclarationFile, presumedTarget, resolveImport } from "#adapters/impo
5
5
  import { ambientModules } from "#imports/ambient.ts";
6
6
  import { type ImportRequest, importsOf } from "#imports/extract.ts";
7
7
  import type { ImportEdge, ImportGraph, UnresolvedImport } from "#imports/graph.ts";
8
- import type { RuleInputs } from "#rule.ts";
8
+ import type { RuleInputs, SourceFile } from "#rule.ts";
9
9
  import { parse } from "#rules/parse.ts";
10
10
 
11
11
  const QUERY = /\?.*$/u;
@@ -21,28 +21,53 @@ function missingTarget(root: string, from: string, request: ImportRequest, proje
21
21
  return target === undefined || target.startsWith("../") ? undefined : target;
22
22
  }
23
23
 
24
- export function graph(inputs: RuleInputs, root: string): Pick<ImportGraph, "configFindings" | "edges" | "modules" | "unresolved"> {
25
- const projectOf = projectsFor(root);
26
- const parsed = inputs.sources.flatMap((file) => {
24
+ interface Parsed {
25
+ readonly file: SourceFile;
26
+ readonly path: string;
27
+ readonly syntax: ts.SourceFile;
28
+ }
29
+
30
+ function parsedIn(root: string, files: readonly SourceFile[]): readonly Parsed[] {
31
+ return files.flatMap((file) => {
27
32
  const syntax = parse(file);
28
33
  return syntax === undefined ? [] : [{ file, path: join(root, file.path), syntax }];
29
34
  });
35
+ }
36
+
37
+ export type SourceGraph = Pick<ImportGraph, "configFindings" | "edges" | "modules" | "unresolved"> & {
38
+ // Files the sources reach outside the inventory resolve with the sources' projects and ambient modules.
39
+ readonly follow: (files: readonly SourceFile[]) => readonly ImportEdge[];
40
+ };
41
+
42
+ export function graph(inputs: RuleInputs, root: string): SourceGraph {
43
+ const projectOf = projectsFor(root);
44
+ const parsed = parsedIn(root, inputs.sources);
30
45
  const ambient = ambientModules(parsed);
31
- const edges: ImportEdge[] = [];
32
- const unresolved: UnresolvedImport[] = [];
33
- for (const { file, path, syntax } of parsed) {
34
- const project = projectOf(path);
35
- syntax.impliedNodeFormat = ts.getImpliedNodeFormatForFile(path, undefined, ts.sys, project.options);
36
- for (const request of importsOf(syntax, isDeclarationFile(file.path), project.options)) {
37
- const to = resolveImport(root, ambient, request, path, project);
38
- if (to === undefined) {
39
- const missing = missingTarget(root, file.path, request, project);
40
- unresolved.push({ ...request, from: file.path, missing });
41
- edges.push(...(missing === undefined ? [] : [{ ...request, from: file.path, to: { kind: "file" as const, path: missing } }]));
42
- } else {
43
- edges.push({ ...request, from: file.path, to });
46
+ function walk(files: readonly Parsed[]): Pick<ImportGraph, "edges" | "unresolved"> {
47
+ const edges: ImportEdge[] = [];
48
+ const unresolved: UnresolvedImport[] = [];
49
+ for (const { file, path, syntax } of files) {
50
+ const project = projectOf(path);
51
+ syntax.impliedNodeFormat = ts.getImpliedNodeFormatForFile(path, undefined, ts.sys, project.options);
52
+ for (const request of importsOf(syntax, isDeclarationFile(file.path), project.options)) {
53
+ const to = resolveImport(root, ambient, request, path, project);
54
+ if (to === undefined) {
55
+ const missing = missingTarget(root, file.path, request, project);
56
+ unresolved.push({ ...request, from: file.path, missing });
57
+ edges.push(...(missing === undefined ? [] : [{ ...request, from: file.path, to: { kind: "file" as const, path: missing } }]));
58
+ } else {
59
+ edges.push({ ...request, from: file.path, to });
60
+ }
44
61
  }
45
62
  }
63
+ return { edges, unresolved };
46
64
  }
47
- return { configFindings: projectOf.findings, edges, modules: parsed.map(({ file }) => file.path), unresolved };
65
+ const { edges, unresolved } = walk(parsed);
66
+ return {
67
+ configFindings: projectOf.findings,
68
+ edges,
69
+ follow: (files) => walk(parsedIn(root, files)).edges,
70
+ modules: parsed.map(({ file }) => file.path),
71
+ unresolved,
72
+ };
48
73
  }
@@ -51,7 +51,7 @@ function externalDependencies(manifest: PackageManifest, externals: ReadonlySet<
51
51
 
52
52
  export const knipConfiguration = Effect.fn("Knip.knipConfiguration")(function* (
53
53
  inputs: RuleInputs,
54
- toolOwned: readonly string[] = [],
54
+ unchecked: readonly string[] = [],
55
55
  builds: ReachableBuilds = { entries: new Set(), externals: new Map() },
56
56
  declared: readonly string[] = declaredEntries(inputs),
57
57
  ) {
@@ -81,7 +81,9 @@ export const knipConfiguration = Effect.fn("Knip.knipConfiguration")(function* (
81
81
  const configs = sources.filter(isToolConfig);
82
82
  // Migration runners load these files from their directory, so no import reaches them.
83
83
  const migrations = sources.filter((path) => /(?:^|\/)server\/migrations\//u.test(path));
84
- const ui = toolOwned.filter((file) => (packageOf(packages, file)?.directory ?? ".") === directory).map((file) => posix.relative(directory, file));
84
+ const followed = unchecked
85
+ .filter((file) => (packageOf(packages, file)?.directory ?? ".") === directory)
86
+ .map((file) => posix.relative(directory, file));
85
87
  const workspaceEntries = declared
86
88
  .filter((file) => (packageOf(packages, file)?.directory ?? ".") === directory)
87
89
  .map((file) => posix.relative(directory, file));
@@ -100,7 +102,7 @@ export const knipConfiguration = Effect.fn("Knip.knipConfiguration")(function* (
100
102
  ...binaries,
101
103
  ...scriptEntries,
102
104
  ...bundled,
103
- ...ui,
105
+ ...followed,
104
106
  ...styles,
105
107
  ...workspaceEntries,
106
108
  ],
@@ -110,7 +112,7 @@ export const knipConfiguration = Effect.fn("Knip.knipConfiguration")(function* (
110
112
  ...deliveredDependencies(manifest, sources),
111
113
  ],
112
114
  paths: importPaths(manifest.imports ?? {}),
113
- project: [...sources, ...ui, ...styles, ...workspaceEntries],
115
+ project: [...sources, ...followed, ...styles, ...workspaceEntries],
114
116
  vitest: { config: ["vitest*.config.{ts,mts,cts,js,mjs,cjs}", "vitest.{workspace,projects}.{ts,mts,cts,js,mjs,cjs,json}"] },
115
117
  },
116
118
  ] as const;
@@ -10,6 +10,8 @@ import { KNIP_ISSUES } from "#adapters/knip/findings.ts";
10
10
  import { knipReport } from "#adapters/knip/report.ts";
11
11
  import { sourceConfig } from "#adapters/knip/sourceConfig.ts";
12
12
  import { readPackageManifest } from "#adapters/manifestInventory.ts";
13
+ import { childStarted } from "#engine/childStarted.ts";
14
+ import { ignoredModules } from "#imports/graph.ts";
13
15
  import { programmaticBuilds } from "#inventory/programmaticBuilds.ts";
14
16
  import { toolOwnedFiles } from "#inventory/toolOwnedFiles.ts";
15
17
  import type { RuleInputs } from "#rule.ts";
@@ -26,7 +28,7 @@ export const runKnip = Effect.fn("Knip.runKnip")(function* (inputs: RuleInputs)
26
28
  if ((yield* readPackageManifest(inputs.readText, "package.json")) === undefined) {
27
29
  return [];
28
30
  }
29
- const files = yield* toolOwnedFiles(inputs.root);
31
+ const files = [...(yield* toolOwnedFiles(inputs.root)), ...(yield* ignoredModules(inputs))];
30
32
  const builds = yield* programmaticBuilds(inputs);
31
33
  const declared = declaredEntries(inputs);
32
34
  const configuration = yield* knipConfiguration(inputs, files, builds, declared);
@@ -69,6 +71,7 @@ export const runKnip = Effect.fn("Knip.runKnip")(function* (inputs: RuleInputs)
69
71
  { cwd, env: { "JITI_TRY_NATIVE": "true" }, extendEnv: true, stdin: "ignore" },
70
72
  ),
71
73
  );
74
+ yield* childStarted();
72
75
  const [stdout, stderr, code] = yield* Effect.all(
73
76
  [Stream.mkString(Stream.decodeText(child.stdout)), Stream.mkString(Stream.decodeText(child.stderr)), child.exitCode],
74
77
  { concurrency: "unbounded" },
@@ -1,89 +1,45 @@
1
1
  import { Effect } from "effect";
2
+ import type { ChildProcessSpawner } from "effect/process";
2
3
  import type { ImportAnalysisFailure } from "#adapters/ImportAnalysisFailure.ts";
3
- import { type ManifestReadFailure, readPackageManifest } from "#adapters/manifestInventory.ts";
4
+ import type { ManifestReadFailure } from "#adapters/manifestInventory.ts";
5
+ import type { SetupFailure } from "#failure.ts";
4
6
  import type { GlobFailure } from "#imports/globMatcher.ts";
5
7
  import { importGraph } from "#imports/graph.ts";
6
8
  import { isPackageRootConfig } from "#imports/isTooling.ts";
7
- import { packageNameOf } from "#imports/packageName.ts";
8
9
  import type { PnpmWorkspaceFailure } from "#imports/pnpmWorkspacePatterns.ts";
9
10
  import { packageOf } from "#imports/workspace.ts";
10
- import { testName } from "#naming/testName.ts";
11
11
  import type { Finding, RuleInputs } from "#rule.ts";
12
12
  import { entryModules } from "#rules/effect/boundaryReference.ts";
13
13
 
14
- const CLIENT_RENDERING_LIBRARIES = new Set([
15
- "react",
16
- "react-dom",
17
- "recharts",
18
- "lucide-react",
19
- "@base-ui/react",
20
- "@tanstack/react-router",
21
- "@tanstack/react-table",
22
- "class-variance-authority",
23
- "cn",
24
- "clsx",
25
- "tailwind-merge",
26
- ]);
27
-
28
14
  // Path functions compute strings and touch no file system or process state, so they need no adapter.
29
15
  const PURE_BUILTINS = new Set(["node:path", "node:path/posix", "node:path/win32"]);
30
16
 
31
- function exempt(directory: string, path: string, name: string): boolean {
32
- return (
33
- /(?:^|\/)(?:adapters|test-support)\//u.test(path)
34
- || PURE_BUILTINS.has(name)
35
- || isPackageRootConfig(directory, path)
36
- || (name === "vitest" && testName(path) !== undefined)
37
- || name === "effect"
38
- || name.startsWith("@effect/")
39
- || name.startsWith("@shivaedev/")
40
- || (CLIENT_RENDERING_LIBRARIES.has(name) && /(?:^|\/)client\//u.test(path))
41
- );
42
- }
43
-
44
17
  export const outsideImportFindings = Effect.fn("Imports.outsideImportFindings")(function* (
45
18
  inputs: RuleInputs,
46
- ): Effect.fn.Return<readonly Finding[], GlobFailure | ImportAnalysisFailure | ManifestReadFailure | PnpmWorkspaceFailure> {
19
+ ): Effect.fn.Return<
20
+ readonly Finding[],
21
+ GlobFailure | ImportAnalysisFailure | ManifestReadFailure | PnpmWorkspaceFailure | SetupFailure,
22
+ ChildProcessSpawner.ChildProcessSpawner
23
+ > {
47
24
  const graph = yield* importGraph(inputs);
48
- const owners = [...graph.packages.map((owner) => owner.directory), "."];
49
- const runtime = new Map(
50
- yield* Effect.forEach(
51
- owners,
52
- (directory) =>
53
- Effect.gen(function* () {
54
- const manifest = yield* readPackageManifest(inputs.readText, `${directory}/package.json`);
55
- return [
56
- directory,
57
- new Set(Object.keys({ ...manifest?.dependencies, ...manifest?.peerDependencies, ...manifest?.optionalDependencies })),
58
- ] as const;
59
- }),
60
- { concurrency: "unbounded" },
61
- ),
25
+ const builtins = graph.edges.flatMap((edge) =>
26
+ edge.to.kind === "external"
27
+ && edge.to.package.startsWith("node:")
28
+ && !PURE_BUILTINS.has(edge.to.package)
29
+ && edge.kind === "import"
30
+ && !edge.type
31
+ && !/(?:^|\/)(?:adapters|test-support)\//u.test(edge.from)
32
+ && !isPackageRootConfig(packageOf(graph.packages, edge.from)?.directory ?? ".", edge.from)
33
+ ? [{ ...edge, name: edge.to.package }]
34
+ : [],
62
35
  );
63
- const workspace = new Set(graph.packages.map((owner) => owner.name));
64
- const sites = [
65
- ...graph.edges.flatMap((edge) => (edge.to.kind === "external" ? [{ ...edge, name: edge.to.package }] : [])),
66
- ...graph.unresolved
67
- .filter((edge) => edge.missing === undefined && !/^[.#/]/u.test(edge.specifier))
68
- .map((edge) => ({ ...edge, name: packageNameOf(edge.specifier) })),
69
- ];
70
- const outside = sites.filter((site) => {
71
- const directory = packageOf(graph.packages, site.from)?.directory ?? ".";
72
- return !(
73
- workspace.has(site.name)
74
- || site.type
75
- || site.kind !== "import"
76
- || exempt(directory, site.from, site.name)
77
- || !(site.name.startsWith("node:") || runtime.get(directory)?.has(site.name))
78
- );
79
- });
80
- const processImporters = new Set(outside.flatMap((site) => (site.name === "node:process" ? [site.from] : [])));
36
+ const processImporters = new Set(builtins.flatMap((site) => (site.name === "node:process" ? [site.from] : [])));
81
37
  const entries = entryModules(inputs.sources.filter((file) => processImporters.has(file.path)));
82
- return outside
38
+ return builtins
83
39
  .filter((site) => !(site.name === "node:process" && entries.has(site.from)))
84
40
  .map((site) => ({
85
41
  file: site.from,
86
42
  line: site.line,
87
- message: `Imports outside library "${site.specifier}" as a value. Move the integration into an adapters/ module with explicit imports that exposes Effect values; use import type for types. Read environment variables with Config instead of process.env, including in adapters/.`,
43
+ message: `Imports Node builtin "${site.specifier}" as a value. Use Effect's FileSystem, ChildProcessSpawner, Config and other platform services, or bridge it in an adapters/ module with explicit imports that exposes Effect values; use import type for types. Read environment variables with Config instead of process.env, including in adapters/.`,
88
44
  }));
89
45
  });
@@ -1,7 +1,9 @@
1
1
  import { Effect } from "effect";
2
+ import { DeclarationFiles } from "#adapters/declaration-files/service.ts";
2
3
  import { describeIssue, type StandardSchemaV1 } from "#adapters/standardSchema.ts";
4
+ import { typeScriptProgram } from "#adapters/typeScriptProgram.ts";
3
5
  import { validOrFail } from "#decoded.ts";
4
- import type { Configured, Findings, RegisteredRule, RuleContext } from "#rule.ts";
6
+ import type { Configured, Findings, RegisteredRule, RuleCheck, RuleContext } from "#rule.ts";
5
7
 
6
8
  export type RuleCheckResult<TServices> = Findings | Effect.Effect<Findings, unknown, TServices>;
7
9
 
@@ -19,9 +21,14 @@ export function configureRegistered<TServices>(rule: RegisteredRule<TServices>,
19
21
  return rule[ruleConfiguration](options);
20
22
  }
21
23
 
24
+ type ContextCheck<TOptions, TServices> = (context: RuleContext<TOptions>) => RuleCheckResult<TServices>;
25
+
22
26
  export function configureWith<TInput, TOptions, TServices>(
23
27
  schema: StandardSchemaV1<TInput, TOptions>,
24
- check: (context: RuleContext<TOptions>) => RuleCheckResult<TServices>,
28
+ checks: {
29
+ readonly check: ContextCheck<TOptions, TServices>;
30
+ readonly deepHalf?: { readonly check: ContextCheck<TOptions, TServices>; readonly name: string } | undefined;
31
+ },
25
32
  id: string,
26
33
  absent: unknown,
27
34
  validate?: (context: RuleContext<TOptions>) => readonly string[],
@@ -32,12 +39,15 @@ export function configureWith<TInput, TOptions, TServices>(
32
39
  return { _tag: "Invalid", issues: result.issues.map(describeIssue) };
33
40
  }
34
41
  const value = result.value;
35
- return {
36
- _tag: "Ready",
37
- check: (inputs) =>
42
+ function ready(check: ContextCheck<TOptions, TServices>): RuleCheck<TServices> {
43
+ return (inputs) =>
38
44
  Effect.scoped(
39
45
  Effect.gen(function* () {
40
- const context = { ...inputs, options: value };
46
+ const context = {
47
+ ...inputs,
48
+ options: value,
49
+ typeScript: inputs.typeScript ?? (yield* typeScriptProgram(inputs.root, inputs.sources).pipe(Effect.provide(DeclarationFiles.layer))),
50
+ };
41
51
  const issues = validate?.(context).map((issue) => `rules.${id}.options: ${issue}`) ?? [];
42
52
  yield* validOrFail(
43
53
  inputs.configFile ?? "quality.config.ts",
@@ -46,7 +56,20 @@ export function configureWith<TInput, TOptions, TServices>(
46
56
  const checked = check(context);
47
57
  return Effect.isEffect(checked) ? yield* checked : checked;
48
58
  }),
59
+ );
60
+ }
61
+ const fast = ready(checks.check);
62
+ if (checks.deepHalf === undefined) {
63
+ return { _tag: "Ready", check: fast };
64
+ }
65
+ const deep = ready(checks.deepHalf.check);
66
+ return {
67
+ _tag: "Ready",
68
+ check: (inputs) =>
69
+ Effect.map(Effect.all([fast(inputs), deep(inputs)]), ([found, typed]) =>
70
+ [...found, ...typed].sort((left, right) => left.file.localeCompare(right.file) || (left.line ?? 0) - (right.line ?? 0)),
49
71
  ),
72
+ halves: { deep, fast, name: checks.deepHalf.name },
50
73
  };
51
74
  };
52
75
  }