@shivaedev/quality 0.56.0 → 0.57.1

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 (459) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/README.md +63 -4
  3. package/biome/plugins/effect-test-bodies.grit +1 -1
  4. package/dist/{rules/suppressions → adapters}/biome/configs.d.ts +2 -2
  5. package/dist/adapters/biome/configs.d.ts.map +1 -0
  6. package/dist/{rules/suppressions → adapters}/biome/configs.js +2 -2
  7. package/dist/adapters/biome/configs.js.map +1 -0
  8. package/dist/adapters/biome/presetConfig.d.ts +21 -0
  9. package/dist/adapters/biome/presetConfig.d.ts.map +1 -0
  10. package/dist/adapters/biome/presetConfig.js +32 -0
  11. package/dist/adapters/biome/presetConfig.js.map +1 -0
  12. package/dist/adapters/biome/relocateConfig.d.ts.map +1 -0
  13. package/dist/adapters/biome/relocateConfig.js.map +1 -0
  14. package/dist/adapters/biome/resolvePackage.d.ts.map +1 -0
  15. package/dist/adapters/biome/resolvePackage.js.map +1 -0
  16. package/dist/adapters/biome/rootConfig.d.ts +9 -0
  17. package/dist/adapters/biome/rootConfig.d.ts.map +1 -0
  18. package/dist/adapters/biome/rootConfig.js +11 -0
  19. package/dist/adapters/biome/rootConfig.js.map +1 -0
  20. package/dist/adapters/biome/run.js +1 -1
  21. package/dist/adapters/biome/run.js.map +1 -1
  22. package/dist/adapters/biome/syntaxOf.d.ts +3 -0
  23. package/dist/adapters/biome/syntaxOf.d.ts.map +1 -0
  24. package/dist/adapters/biome/syntaxOf.js +11 -0
  25. package/dist/adapters/biome/syntaxOf.js.map +1 -0
  26. package/dist/adapters/biome/withExceptionConfig.d.ts +8 -0
  27. package/dist/adapters/biome/withExceptionConfig.d.ts.map +1 -0
  28. package/dist/adapters/biome/withExceptionConfig.js +38 -0
  29. package/dist/adapters/biome/withExceptionConfig.js.map +1 -0
  30. package/dist/adapters/changeKeyApi.d.ts +4 -0
  31. package/dist/adapters/changeKeyApi.d.ts.map +1 -0
  32. package/dist/adapters/changeKeyApi.js +58 -0
  33. package/dist/adapters/changeKeyApi.js.map +1 -0
  34. package/dist/adapters/changeKeyFindings.d.ts +4 -0
  35. package/dist/adapters/changeKeyFindings.d.ts.map +1 -0
  36. package/dist/adapters/changeKeyFindings.js +87 -0
  37. package/dist/adapters/changeKeyFindings.js.map +1 -0
  38. package/dist/adapters/changeKeyLiterals.d.ts +3 -0
  39. package/dist/adapters/changeKeyLiterals.d.ts.map +1 -0
  40. package/dist/adapters/changeKeyLiterals.js +56 -0
  41. package/dist/adapters/changeKeyLiterals.js.map +1 -0
  42. package/dist/adapters/executable.d.ts +3 -0
  43. package/dist/adapters/executable.d.ts.map +1 -0
  44. package/dist/adapters/executable.js +14 -0
  45. package/dist/adapters/executable.js.map +1 -0
  46. package/dist/adapters/ignore.d.ts +10 -0
  47. package/dist/adapters/ignore.d.ts.map +1 -0
  48. package/dist/adapters/ignore.js +10 -0
  49. package/dist/adapters/ignore.js.map +1 -0
  50. package/dist/adapters/imports/fakeReferences.d.ts +14 -0
  51. package/dist/adapters/imports/fakeReferences.d.ts.map +1 -0
  52. package/dist/adapters/imports/fakeReferences.js +103 -0
  53. package/dist/adapters/imports/fakeReferences.js.map +1 -0
  54. package/dist/adapters/imports/fakeTargets.d.ts +13 -0
  55. package/dist/adapters/imports/fakeTargets.d.ts.map +1 -0
  56. package/dist/adapters/imports/fakeTargets.js +14 -0
  57. package/dist/adapters/imports/fakeTargets.js.map +1 -0
  58. package/dist/adapters/outsideImportFindings.d.ts +5 -0
  59. package/dist/adapters/outsideImportFindings.d.ts.map +1 -0
  60. package/dist/adapters/outsideImportFindings.js +78 -0
  61. package/dist/adapters/outsideImportFindings.js.map +1 -0
  62. package/dist/adapters/queueReadoutFindings.d.ts +8 -0
  63. package/dist/adapters/queueReadoutFindings.d.ts.map +1 -0
  64. package/dist/adapters/queueReadoutFindings.js +30 -0
  65. package/dist/adapters/queueReadoutFindings.js.map +1 -0
  66. package/dist/adapters/queueTestingOrigin.d.ts +5 -0
  67. package/dist/adapters/queueTestingOrigin.d.ts.map +1 -0
  68. package/dist/adapters/queueTestingOrigin.js +95 -0
  69. package/dist/adapters/queueTestingOrigin.js.map +1 -0
  70. package/dist/adapters/readConfig.d.ts +7 -0
  71. package/dist/adapters/readConfig.d.ts.map +1 -0
  72. package/dist/adapters/readConfig.js +40 -0
  73. package/dist/adapters/readConfig.js.map +1 -0
  74. package/dist/adapters/serviceIdFindings.d.ts +4 -0
  75. package/dist/adapters/serviceIdFindings.d.ts.map +1 -0
  76. package/dist/adapters/serviceIdFindings.js +65 -0
  77. package/dist/adapters/serviceIdFindings.js.map +1 -0
  78. package/dist/adapters/sharedErrorFindings.d.ts +4 -0
  79. package/dist/adapters/sharedErrorFindings.d.ts.map +1 -0
  80. package/dist/adapters/sharedErrorFindings.js +71 -0
  81. package/dist/adapters/sharedErrorFindings.js.map +1 -0
  82. package/dist/adapters/sharedErrorModules.d.ts +7 -0
  83. package/dist/adapters/sharedErrorModules.d.ts.map +1 -0
  84. package/dist/adapters/sharedErrorModules.js +66 -0
  85. package/dist/adapters/sharedErrorModules.js.map +1 -0
  86. package/dist/adapters/testProjects.d.ts.map +1 -1
  87. package/dist/adapters/testProjects.js +18 -2
  88. package/dist/adapters/testProjects.js.map +1 -1
  89. package/dist/appTestConfig.d.ts +1 -1
  90. package/dist/appTestConfig.d.ts.map +1 -1
  91. package/dist/appTestConfig.js.map +1 -1
  92. package/dist/baseline/cleanupMergeFiles.d.ts.map +1 -1
  93. package/dist/baseline/cleanupMergeFiles.js +3 -2
  94. package/dist/baseline/cleanupMergeFiles.js.map +1 -1
  95. package/dist/baseline/shards.d.ts.map +1 -1
  96. package/dist/baseline/shards.js +4 -2
  97. package/dist/baseline/shards.js.map +1 -1
  98. package/dist/biome/exceptionConfig.d.ts +0 -7
  99. package/dist/biome/exceptionConfig.d.ts.map +1 -1
  100. package/dist/biome/exceptionConfig.js +0 -36
  101. package/dist/biome/exceptionConfig.js.map +1 -1
  102. package/dist/biome/recognizeDiagnostics.d.ts.map +1 -1
  103. package/dist/biome/recognizeDiagnostics.js +2 -1
  104. package/dist/biome/recognizeDiagnostics.js.map +1 -1
  105. package/dist/biome/recommendedRules.d.ts.map +1 -1
  106. package/dist/biome/recommendedRules.js +3 -2
  107. package/dist/biome/recommendedRules.js.map +1 -1
  108. package/dist/biome/report.d.ts.map +1 -1
  109. package/dist/biome/report.js +3 -2
  110. package/dist/biome/report.js.map +1 -1
  111. package/dist/biome/syntax.d.ts +0 -1
  112. package/dist/biome/syntax.d.ts.map +1 -1
  113. package/dist/biome/syntax.js +0 -9
  114. package/dist/biome/syntax.js.map +1 -1
  115. package/dist/biome/withoutEntryPointImports.d.ts +32 -2
  116. package/dist/biome/withoutEntryPointImports.d.ts.map +1 -1
  117. package/dist/biome/withoutEntryPointImports.js +12 -10
  118. package/dist/biome/withoutEntryPointImports.js.map +1 -1
  119. package/dist/cli/baseline.d.ts.map +1 -1
  120. package/dist/cli/baseline.js +3 -2
  121. package/dist/cli/baseline.js.map +1 -1
  122. package/dist/cli/fix.d.ts.map +1 -1
  123. package/dist/cli/fix.js +3 -2
  124. package/dist/cli/fix.js.map +1 -1
  125. package/dist/cli/fixRule.d.ts.map +1 -1
  126. package/dist/cli/fixRule.js +4 -3
  127. package/dist/cli/fixRule.js.map +1 -1
  128. package/dist/cli/lint.d.ts.map +1 -1
  129. package/dist/cli/lint.js +2 -2
  130. package/dist/cli/lint.js.map +1 -1
  131. package/dist/cli/migrateBaseline.d.ts.map +1 -1
  132. package/dist/cli/migrateBaseline.js +3 -2
  133. package/dist/cli/migrateBaseline.js.map +1 -1
  134. package/dist/cli/migrateExceptions.d.ts.map +1 -1
  135. package/dist/cli/migrateExceptions.js +3 -2
  136. package/dist/cli/migrateExceptions.js.map +1 -1
  137. package/dist/config/globs.d.ts.map +1 -1
  138. package/dist/config/globs.js +1 -5
  139. package/dist/config/globs.js.map +1 -1
  140. package/dist/config/load.d.ts +2 -2
  141. package/dist/config/load.d.ts.map +1 -1
  142. package/dist/config/load.js +6 -36
  143. package/dist/config/load.js.map +1 -1
  144. package/dist/domEnvironment.config.js +1 -1
  145. package/dist/domEnvironment.config.js.map +1 -1
  146. package/dist/engine/session.d.ts.map +1 -1
  147. package/dist/engine/session.js +3 -2
  148. package/dist/engine/session.js.map +1 -1
  149. package/dist/exceptions/biomeFindings.d.ts +1 -1
  150. package/dist/exceptions/biomeFindings.d.ts.map +1 -1
  151. package/dist/exceptions/biomeFindings.js +10 -6
  152. package/dist/exceptions/biomeFindings.js.map +1 -1
  153. package/dist/hooks/install.d.ts.map +1 -1
  154. package/dist/hooks/install.js +4 -2
  155. package/dist/hooks/install.js.map +1 -1
  156. package/dist/hooks/location.d.ts.map +1 -1
  157. package/dist/hooks/location.js +3 -2
  158. package/dist/hooks/location.js.map +1 -1
  159. package/dist/hooks/preCommit.d.ts.map +1 -1
  160. package/dist/hooks/preCommit.js +3 -2
  161. package/dist/hooks/preCommit.js.map +1 -1
  162. package/dist/hooks/setup.d.ts.map +1 -1
  163. package/dist/hooks/setup.js +3 -2
  164. package/dist/hooks/setup.js.map +1 -1
  165. package/dist/hooks/status.d.ts.map +1 -1
  166. package/dist/hooks/status.js +5 -15
  167. package/dist/hooks/status.js.map +1 -1
  168. package/dist/hooks/uninstall.d.ts.map +1 -1
  169. package/dist/hooks/uninstall.js +3 -2
  170. package/dist/hooks/uninstall.js.map +1 -1
  171. package/dist/inventory/collect.js +2 -2
  172. package/dist/inventory/collect.js.map +1 -1
  173. package/dist/inventory/filesystem.d.ts.map +1 -1
  174. package/dist/inventory/filesystem.js +3 -2
  175. package/dist/inventory/filesystem.js.map +1 -1
  176. package/dist/inventory/ignoreScope.d.ts +2 -2
  177. package/dist/inventory/ignoreScope.d.ts.map +1 -1
  178. package/dist/inventory/ignoreScope.js +2 -2
  179. package/dist/inventory/ignoreScope.js.map +1 -1
  180. package/dist/inventory/shadcnFolders.d.ts.map +1 -1
  181. package/dist/inventory/shadcnFolders.js +4 -2
  182. package/dist/inventory/shadcnFolders.js.map +1 -1
  183. package/dist/inventory/trackedPaths.d.ts.map +1 -1
  184. package/dist/inventory/trackedPaths.js +4 -2
  185. package/dist/inventory/trackedPaths.js.map +1 -1
  186. package/dist/naming/packageLayout.d.ts +2 -1
  187. package/dist/naming/packageLayout.d.ts.map +1 -1
  188. package/dist/naming/packageLayout.js +4 -6
  189. package/dist/naming/packageLayout.js.map +1 -1
  190. package/dist/naming/testName.d.ts +1 -1
  191. package/dist/naming/testName.d.ts.map +1 -1
  192. package/dist/naming/testName.js +1 -1
  193. package/dist/naming/testName.js.map +1 -1
  194. package/dist/rules/biome.d.ts +1 -8
  195. package/dist/rules/biome.d.ts.map +1 -1
  196. package/dist/rules/biome.js +6 -15
  197. package/dist/rules/biome.js.map +1 -1
  198. package/dist/rules/builtIn.d.ts +2 -2
  199. package/dist/rules/builtIn.d.ts.map +1 -1
  200. package/dist/rules/builtIn.js +12 -0
  201. package/dist/rules/builtIn.js.map +1 -1
  202. package/dist/rules/effect/adapterImports.d.ts +2 -0
  203. package/dist/rules/effect/adapterImports.d.ts.map +1 -0
  204. package/dist/rules/effect/adapterImports.js +9 -0
  205. package/dist/rules/effect/adapterImports.js.map +1 -0
  206. package/dist/rules/effect/program.d.ts +1 -1
  207. package/dist/rules/effect/program.d.ts.map +1 -1
  208. package/dist/rules/effect/program.js +2 -2
  209. package/dist/rules/effect/program.js.map +1 -1
  210. package/dist/rules/effect/serviceIds.d.ts +2 -0
  211. package/dist/rules/effect/serviceIds.d.ts.map +1 -0
  212. package/dist/rules/effect/serviceIds.js +9 -0
  213. package/dist/rules/effect/serviceIds.js.map +1 -0
  214. package/dist/rules/effect/sharedErrorClasses.d.ts +2 -0
  215. package/dist/rules/effect/sharedErrorClasses.d.ts.map +1 -0
  216. package/dist/rules/effect/sharedErrorClasses.js +9 -0
  217. package/dist/rules/effect/sharedErrorClasses.js.map +1 -0
  218. package/dist/rules/files/folderNames.d.ts.map +1 -1
  219. package/dist/rules/files/folderNames.js +7 -7
  220. package/dist/rules/files/folderNames.js.map +1 -1
  221. package/dist/rules/files/namedAfterExport.d.ts.map +1 -1
  222. package/dist/rules/files/namedAfterExport.js +6 -6
  223. package/dist/rules/files/namedAfterExport.js.map +1 -1
  224. package/dist/rules/files/otherNames.d.ts.map +1 -1
  225. package/dist/rules/files/otherNames.js +7 -7
  226. package/dist/rules/files/otherNames.js.map +1 -1
  227. package/dist/rules/files/packageImports.d.ts +2 -1
  228. package/dist/rules/files/packageImports.d.ts.map +1 -1
  229. package/dist/rules/files/packageImports.js +4 -3
  230. package/dist/rules/files/packageImports.js.map +1 -1
  231. package/dist/rules/files/stylesheetImporters.d.ts +2 -1
  232. package/dist/rules/files/stylesheetImporters.d.ts.map +1 -1
  233. package/dist/rules/files/stylesheetImporters.js +5 -4
  234. package/dist/rules/files/stylesheetImporters.js.map +1 -1
  235. package/dist/rules/imports/manifest.d.ts.map +1 -1
  236. package/dist/rules/imports/manifest.js +9 -6
  237. package/dist/rules/imports/manifest.js.map +1 -1
  238. package/dist/rules/manifestsApplication.d.ts.map +1 -1
  239. package/dist/rules/manifestsApplication.js +22 -22
  240. package/dist/rules/manifestsApplication.js.map +1 -1
  241. package/dist/rules/manifestsExportsShape.d.ts.map +1 -1
  242. package/dist/rules/manifestsExportsShape.js +32 -8
  243. package/dist/rules/manifestsExportsShape.js.map +1 -1
  244. package/dist/rules/manifestsSorted.d.ts.map +1 -1
  245. package/dist/rules/manifestsSorted.js +6 -5
  246. package/dist/rules/manifestsSorted.js.map +1 -1
  247. package/dist/rules/manifestsSourceFirst.d.ts.map +1 -1
  248. package/dist/rules/manifestsSourceFirst.js +6 -5
  249. package/dist/rules/manifestsSourceFirst.js.map +1 -1
  250. package/dist/rules/stories/adapterOnlyFakes.d.ts +2 -0
  251. package/dist/rules/stories/adapterOnlyFakes.d.ts.map +1 -0
  252. package/dist/rules/stories/adapterOnlyFakes.js +63 -0
  253. package/dist/rules/stories/adapterOnlyFakes.js.map +1 -0
  254. package/dist/rules/stories/fakeImplementation.d.ts +4 -0
  255. package/dist/rules/stories/fakeImplementation.d.ts.map +1 -0
  256. package/dist/rules/stories/fakeImplementation.js +22 -0
  257. package/dist/rules/stories/fakeImplementation.js.map +1 -0
  258. package/dist/rules/stories/fakeReplacements.d.ts +4 -0
  259. package/dist/rules/stories/fakeReplacements.d.ts.map +1 -0
  260. package/dist/rules/stories/fakeReplacements.js +71 -0
  261. package/dist/rules/stories/fakeReplacements.js.map +1 -0
  262. package/dist/rules/stories/importOrigin.js +2 -2
  263. package/dist/rules/stories/importOrigin.js.map +1 -1
  264. package/dist/rules/stories/importedChangeKeys.d.ts +2 -0
  265. package/dist/rules/stories/importedChangeKeys.d.ts.map +1 -0
  266. package/dist/rules/stories/importedChangeKeys.js +9 -0
  267. package/dist/rules/stories/importedChangeKeys.js.map +1 -0
  268. package/dist/rules/stories/pureNetImport.d.ts +4 -0
  269. package/dist/rules/stories/pureNetImport.d.ts.map +1 -0
  270. package/dist/rules/stories/pureNetImport.js +23 -0
  271. package/dist/rules/stories/pureNetImport.js.map +1 -0
  272. package/dist/rules/stories/queueReadouts.d.ts +2 -0
  273. package/dist/rules/stories/queueReadouts.d.ts.map +1 -0
  274. package/dist/rules/stories/queueReadouts.js +9 -0
  275. package/dist/rules/stories/queueReadouts.js.map +1 -0
  276. package/dist/rules/stories/unitTests.d.ts.map +1 -1
  277. package/dist/rules/stories/unitTests.js +4 -3
  278. package/dist/rules/stories/unitTests.js.map +1 -1
  279. package/dist/rules/suppressions/biome/weakenings.d.ts +1 -1
  280. package/dist/rules/suppressions/biome/weakenings.d.ts.map +1 -1
  281. package/dist/rules/suppressions/biomeOverrides.d.ts.map +1 -1
  282. package/dist/rules/suppressions/biomeOverrides.js +5 -5
  283. package/dist/rules/suppressions/biomeOverrides.js.map +1 -1
  284. package/dist/rules/suppressions/biomeRecommended.d.ts +1 -1
  285. package/dist/rules/suppressions/biomeRecommended.d.ts.map +1 -1
  286. package/dist/rules/suppressions/biomeRecommended.js +12 -30
  287. package/dist/rules/suppressions/biomeRecommended.js.map +1 -1
  288. package/dist/rules/suppressions/noIgnoreDeprecations.d.ts.map +1 -1
  289. package/dist/rules/suppressions/noIgnoreDeprecations.js +3 -2
  290. package/dist/rules/suppressions/noIgnoreDeprecations.js.map +1 -1
  291. package/dist/rules/test-names/colocated.js +2 -2
  292. package/dist/rules/test-names/colocated.js.map +1 -1
  293. package/dist/rules/test-names/follow.js +4 -4
  294. package/dist/rules/test-names/follow.js.map +1 -1
  295. package/dist/testing/adapters/assertThat.d.ts +5 -0
  296. package/dist/testing/adapters/assertThat.d.ts.map +1 -0
  297. package/dist/testing/adapters/assertThat.js +9 -0
  298. package/dist/testing/adapters/assertThat.js.map +1 -0
  299. package/dist/testing/adapters/cli.d.ts +21 -0
  300. package/dist/testing/adapters/cli.d.ts.map +1 -0
  301. package/dist/testing/adapters/cli.js +85 -0
  302. package/dist/testing/adapters/cli.js.map +1 -0
  303. package/dist/testing/adapters/git.d.ts +14 -0
  304. package/dist/testing/adapters/git.d.ts.map +1 -0
  305. package/dist/testing/adapters/git.js +52 -0
  306. package/dist/testing/adapters/git.js.map +1 -0
  307. package/dist/testing/adapters/hookPath.d.ts +2 -0
  308. package/dist/testing/adapters/hookPath.d.ts.map +1 -0
  309. package/dist/testing/adapters/hookPath.js +6 -0
  310. package/dist/testing/adapters/hookPath.js.map +1 -0
  311. package/dist/testing/adapters/hookRepository.d.ts +25 -0
  312. package/dist/testing/adapters/hookRepository.d.ts.map +1 -0
  313. package/dist/testing/adapters/hookRepository.js +96 -0
  314. package/dist/testing/adapters/hookRepository.js.map +1 -0
  315. package/dist/testing/adapters/imports.d.ts +5 -0
  316. package/dist/testing/adapters/imports.d.ts.map +1 -0
  317. package/dist/testing/adapters/imports.js +29 -0
  318. package/dist/testing/adapters/imports.js.map +1 -0
  319. package/dist/testing/adapters/packageExports.d.ts +15 -0
  320. package/dist/testing/adapters/packageExports.d.ts.map +1 -0
  321. package/dist/testing/adapters/packageExports.js +29 -0
  322. package/dist/testing/adapters/packageExports.js.map +1 -0
  323. package/dist/testing/adapters/qualityTree.d.ts +4 -0
  324. package/dist/testing/adapters/qualityTree.d.ts.map +1 -0
  325. package/dist/testing/adapters/qualityTree.js +21 -0
  326. package/dist/testing/adapters/qualityTree.js.map +1 -0
  327. package/dist/testing/adapters/run.d.ts +4 -0
  328. package/dist/testing/adapters/run.d.ts.map +1 -0
  329. package/dist/testing/adapters/run.js +6 -0
  330. package/dist/testing/adapters/run.js.map +1 -0
  331. package/dist/testing/adapters/storySpecFiles.d.ts +7 -0
  332. package/dist/testing/adapters/storySpecFiles.d.ts.map +1 -0
  333. package/dist/testing/adapters/storySpecFiles.js +48 -0
  334. package/dist/testing/adapters/storySpecFiles.js.map +1 -0
  335. package/dist/testing/adapters/tree.d.ts +13 -0
  336. package/dist/testing/adapters/tree.d.ts.map +1 -0
  337. package/dist/testing/adapters/tree.js +42 -0
  338. package/dist/testing/adapters/tree.js.map +1 -0
  339. package/dist/testing/adapters/writePackageExports.d.ts +2 -0
  340. package/dist/testing/adapters/writePackageExports.d.ts.map +1 -0
  341. package/dist/testing/adapters/writePackageExports.js +9 -0
  342. package/dist/testing/adapters/writePackageExports.js.map +1 -0
  343. package/dist/testing/ruleStory.d.ts +28 -0
  344. package/dist/testing/ruleStory.d.ts.map +1 -0
  345. package/dist/testing/ruleStory.js +115 -0
  346. package/dist/testing/ruleStory.js.map +1 -0
  347. package/dist/unitIoGuard.config.js +1 -1
  348. package/dist/unitIoGuard.config.js.map +1 -1
  349. package/package.json +8 -2
  350. package/src/{rules/suppressions → adapters}/biome/configs.ts +2 -2
  351. package/src/adapters/biome/presetConfig.ts +34 -0
  352. package/src/adapters/biome/rootConfig.ts +19 -0
  353. package/src/adapters/biome/run.ts +1 -1
  354. package/src/adapters/biome/syntaxOf.ts +12 -0
  355. package/src/adapters/biome/withExceptionConfig.ts +45 -0
  356. package/src/adapters/changeKeyApi.ts +62 -0
  357. package/src/adapters/changeKeyFindings.ts +96 -0
  358. package/src/adapters/changeKeyLiterals.ts +60 -0
  359. package/src/adapters/executable.ts +14 -0
  360. package/src/adapters/ignore.ts +16 -0
  361. package/src/adapters/imports/fakeReferences.ts +115 -0
  362. package/src/adapters/imports/fakeTargets.ts +21 -0
  363. package/src/adapters/outsideImportFindings.ts +98 -0
  364. package/src/adapters/queueReadoutFindings.ts +37 -0
  365. package/src/adapters/queueTestingOrigin.ts +113 -0
  366. package/src/adapters/readConfig.ts +42 -0
  367. package/src/adapters/serviceIdFindings.ts +80 -0
  368. package/src/adapters/sharedErrorFindings.ts +84 -0
  369. package/src/adapters/sharedErrorModules.ts +81 -0
  370. package/src/adapters/testProjects.ts +18 -2
  371. package/src/appTestConfig.ts +1 -1
  372. package/src/baseline/cleanupMergeFiles.ts +4 -2
  373. package/src/baseline/shards.ts +6 -2
  374. package/src/biome/exceptionConfig.ts +0 -43
  375. package/src/biome/recognizeDiagnostics.ts +2 -1
  376. package/src/biome/recommendedRules.ts +4 -2
  377. package/src/biome/report.ts +4 -2
  378. package/src/biome/syntax.ts +0 -10
  379. package/src/biome/withoutEntryPointImports.ts +15 -10
  380. package/src/cli/baseline.ts +4 -2
  381. package/src/cli/fix.ts +4 -2
  382. package/src/cli/fixRule.ts +5 -3
  383. package/src/cli/lint.ts +3 -2
  384. package/src/cli/migrateBaseline.ts +4 -2
  385. package/src/cli/migrateExceptions.ts +4 -2
  386. package/src/config/globs.ts +1 -6
  387. package/src/config/load.ts +8 -38
  388. package/src/domEnvironment.config.ts +1 -1
  389. package/src/engine/session.ts +4 -2
  390. package/src/exceptions/biomeFindings.ts +11 -10
  391. package/src/hooks/install.ts +6 -2
  392. package/src/hooks/location.ts +4 -2
  393. package/src/hooks/preCommit.ts +4 -2
  394. package/src/hooks/setup.ts +4 -2
  395. package/src/hooks/status.ts +7 -15
  396. package/src/hooks/uninstall.ts +4 -2
  397. package/src/inventory/collect.ts +2 -2
  398. package/src/inventory/filesystem.ts +4 -2
  399. package/src/inventory/ignoreScope.ts +3 -3
  400. package/src/inventory/shadcnFolders.ts +6 -2
  401. package/src/inventory/trackedPaths.ts +6 -2
  402. package/src/naming/packageLayout.ts +14 -7
  403. package/src/naming/testName.ts +1 -1
  404. package/src/rules/biome.ts +6 -23
  405. package/src/rules/builtIn.ts +12 -0
  406. package/src/rules/effect/adapterImports.ts +10 -0
  407. package/src/rules/effect/program.ts +2 -2
  408. package/src/rules/effect/serviceIds.ts +10 -0
  409. package/src/rules/effect/sharedErrorClasses.ts +10 -0
  410. package/src/rules/files/folderNames.ts +19 -18
  411. package/src/rules/files/namedAfterExport.ts +10 -9
  412. package/src/rules/files/otherNames.ts +17 -16
  413. package/src/rules/files/packageImports.ts +14 -4
  414. package/src/rules/files/stylesheetImporters.ts +13 -6
  415. package/src/rules/imports/manifest.ts +14 -8
  416. package/src/rules/manifestsApplication.ts +44 -33
  417. package/src/rules/manifestsExportsShape.ts +45 -15
  418. package/src/rules/manifestsSorted.ts +16 -11
  419. package/src/rules/manifestsSourceFirst.ts +22 -17
  420. package/src/rules/stories/adapterOnlyFakes.ts +66 -0
  421. package/src/rules/stories/fakeImplementation.ts +23 -0
  422. package/src/rules/stories/fakeReplacements.ts +74 -0
  423. package/src/rules/stories/importOrigin.ts +2 -2
  424. package/src/rules/stories/importedChangeKeys.ts +10 -0
  425. package/src/rules/stories/pureNetImport.ts +29 -0
  426. package/src/rules/stories/queueReadouts.ts +9 -0
  427. package/src/rules/stories/unitTests.ts +6 -3
  428. package/src/rules/suppressions/biome/weakenings.ts +1 -1
  429. package/src/rules/suppressions/biomeOverrides.ts +17 -16
  430. package/src/rules/suppressions/biomeRecommended.ts +13 -32
  431. package/src/rules/suppressions/noIgnoreDeprecations.ts +4 -2
  432. package/src/rules/test-names/colocated.ts +2 -2
  433. package/src/rules/test-names/follow.ts +4 -4
  434. package/src/testing/adapters/assertThat.ts +12 -0
  435. package/src/testing/adapters/cli.ts +105 -0
  436. package/src/testing/adapters/git.ts +62 -0
  437. package/src/testing/adapters/hookPath.ts +6 -0
  438. package/src/testing/adapters/hookRepository.ts +134 -0
  439. package/src/testing/adapters/imports.ts +35 -0
  440. package/src/testing/adapters/packageExports.ts +37 -0
  441. package/src/testing/adapters/qualityTree.ts +26 -0
  442. package/src/testing/adapters/run.ts +7 -0
  443. package/src/testing/adapters/storySpecFiles.ts +54 -0
  444. package/src/testing/adapters/tree.ts +55 -0
  445. package/src/testing/adapters/writePackageExports.ts +9 -0
  446. package/src/testing/ruleStory.ts +139 -0
  447. package/src/unitIoGuard.config.ts +1 -1
  448. package/dist/biome/relocateConfig.d.ts.map +0 -1
  449. package/dist/biome/relocateConfig.js.map +0 -1
  450. package/dist/rules/suppressions/biome/configs.d.ts.map +0 -1
  451. package/dist/rules/suppressions/biome/configs.js.map +0 -1
  452. package/dist/rules/suppressions/biome/resolvePackage.d.ts.map +0 -1
  453. package/dist/rules/suppressions/biome/resolvePackage.js.map +0 -1
  454. /package/dist/{biome → adapters/biome}/relocateConfig.d.ts +0 -0
  455. /package/dist/{biome → adapters/biome}/relocateConfig.js +0 -0
  456. /package/dist/{rules/suppressions → adapters}/biome/resolvePackage.d.ts +0 -0
  457. /package/dist/{rules/suppressions → adapters}/biome/resolvePackage.js +0 -0
  458. /package/src/{biome → adapters/biome}/relocateConfig.ts +0 -0
  459. /package/src/{rules/suppressions → adapters}/biome/resolvePackage.ts +0 -0
@@ -0,0 +1,23 @@
1
+ import ts from "typescript";
2
+ import type { fakeReferences } from "#adapters/imports/fakeReferences.ts";
3
+ import { memberName, unwrapped } from "./syntax.ts";
4
+
5
+ export function fakeImplementation(expression: ts.Expression, references: ReturnType<typeof fakeReferences>, seen = new Set<ts.Node>()): boolean {
6
+ const node = unwrapped(expression);
7
+ if (seen.has(node) || references.owner(node) !== undefined) {
8
+ return false;
9
+ }
10
+ seen.add(node);
11
+ if (ts.isObjectLiteralExpression(node) || ts.isArrowFunction(node) || ts.isFunctionExpression(node)) {
12
+ return true;
13
+ }
14
+ if (ts.isCallExpression(node)) {
15
+ const name = memberName(node.expression);
16
+ if (name === "of" || name === "succeed" || name === "sync" || name === "map" || name === "gen") {
17
+ return node.arguments.some((argument) => fakeImplementation(argument, references, seen));
18
+ }
19
+ return name === "fail" || name === "die" || name === "fn";
20
+ }
21
+ const value = references.initializer(node);
22
+ return value !== undefined && fakeImplementation(value, references, seen);
23
+ }
@@ -0,0 +1,74 @@
1
+ import ts from "typescript";
2
+ import { fakeApi, type fakeReferences } from "#adapters/imports/fakeReferences.ts";
3
+ import { fakeImplementation } from "./fakeImplementation.ts";
4
+ import { memberName, unwrapped } from "./syntax.ts";
5
+
6
+ const REPLACEMENTS = new Set([
7
+ "mockImplementation",
8
+ "mockImplementationOnce",
9
+ "mockReturnValue",
10
+ "mockReturnValueOnce",
11
+ "mockResolvedValue",
12
+ "mockResolvedValueOnce",
13
+ "mockRejectedValue",
14
+ "mockRejectedValueOnce",
15
+ "mockReturnThis",
16
+ "withImplementation",
17
+ ]);
18
+
19
+ const SERVICES = new Set(["Layer.succeed", "Layer.sync", "Layer.effect", "Layer.mock", "Effect.provideService", "Effect.provideServiceEffect"]);
20
+
21
+ export function fakeReplacements(source: ts.SourceFile, references: ReturnType<typeof fakeReferences>): readonly ts.Expression[] {
22
+ const replaced: ts.Expression[] = [];
23
+ function spy(expression: ts.Expression, seen = new Set<ts.Node>()): ts.CallExpression | undefined {
24
+ const node = unwrapped(expression);
25
+ if (seen.has(node)) {
26
+ return undefined;
27
+ }
28
+ seen.add(node);
29
+ if (ts.isCallExpression(node)) {
30
+ if (fakeApi(references.reference(node.expression)) === "vi.spyOn") {
31
+ return node;
32
+ }
33
+ return ts.isPropertyAccessExpression(node.expression) ? spy(node.expression.expression, seen) : undefined;
34
+ }
35
+ if (ts.isIdentifier(node)) {
36
+ const declaration = references.initializer(node);
37
+ return declaration === undefined ? undefined : spy(declaration, seen);
38
+ }
39
+ return undefined;
40
+ }
41
+ function service(node: ts.CallExpression): ts.Expression | undefined {
42
+ const curried = ts.isCallExpression(node.expression) ? node.expression : undefined;
43
+ const construction = curried ?? node;
44
+ const api = fakeApi(references.reference(construction.expression));
45
+ if (api === undefined || !SERVICES.has(api)) {
46
+ return undefined;
47
+ }
48
+ const index = api.startsWith("Effect.") && construction.arguments.length === 3 ? 1 : 0;
49
+ const argument = construction.arguments[index];
50
+ const value = curried === undefined ? node.arguments[index + 1] : node.arguments[0];
51
+ return argument !== undefined && value !== undefined && references.concreteService(argument) && fakeImplementation(value, references)
52
+ ? argument
53
+ : undefined;
54
+ }
55
+ function replacementSpy(node: ts.CallExpression): ts.Expression | undefined {
56
+ return REPLACEMENTS.has(memberName(node.expression) ?? "")
57
+ && (ts.isPropertyAccessExpression(node.expression) || ts.isElementAccessExpression(node.expression))
58
+ ? spy(node.expression.expression)?.arguments[0]
59
+ : undefined;
60
+ }
61
+ function visit(node: ts.Node): void {
62
+ if (ts.isCallExpression(node)) {
63
+ for (const target of [service(node), replacementSpy(node)]) {
64
+ if (target !== undefined) {
65
+ replaced.push(target);
66
+ }
67
+ }
68
+ }
69
+ ts.forEachChild(node, visit);
70
+ }
71
+
72
+ visit(source);
73
+ return replaced;
74
+ }
@@ -17,10 +17,10 @@ function moduleOrigin(from: string | undefined) {
17
17
  }
18
18
 
19
19
  export function importOrigin(from: string | undefined, name?: string) {
20
- if (from === "@shivaedev/test/makeEffectIt.ts" && name === "makeEffectIt") {
20
+ if (from === "@shivaedev/test/adapters/makeEffectIt.ts" && name === "makeEffectIt") {
21
21
  return "effectFactory";
22
22
  }
23
- if (from === "@shivaedev/test/it.ts" && name === "it") {
23
+ if (from === "@shivaedev/test/adapters/it.ts" && name === "it") {
24
24
  return "plain";
25
25
  }
26
26
  const namespace = moduleOrigin(from);
@@ -0,0 +1,10 @@
1
+ import { changeKeyFindings } from "#adapters/changeKeyFindings.ts";
2
+ import { defineRule } from "#rule.ts";
3
+
4
+ export const importedChangeKeys = defineRule({
5
+ check: changeKeyFindings,
6
+ description:
7
+ "Change collection and bucket names in Reactivity invalidation and mutation, SQL invalidateOnCommit and changes key encoders come from their owner's imported declaration. Replace literal array keys, record keys and typed key collection/field names; IDs and bucket values remain application data.",
8
+ id: "boundaries/imported-change-keys",
9
+ registrable: false,
10
+ });
@@ -0,0 +1,29 @@
1
+ import ts from "typescript";
2
+ import type { ImportEdge } from "#imports/graph.ts";
3
+ import type { SourceFile } from "#rule.ts";
4
+ import { parse } from "#rules/parse.ts";
5
+
6
+ export function pureNetImport(edge: ImportEdge, source: SourceFile | undefined): boolean {
7
+ if (edge.specifier !== "node:net" || source === undefined) {
8
+ return false;
9
+ }
10
+ const syntax = parse(source);
11
+ return (
12
+ syntax?.statements.some((statement) => {
13
+ if (!(ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) || statement.moduleSpecifier.text !== "node:net") {
14
+ return false;
15
+ }
16
+ if (syntax.getLineAndCharacterOfPosition(statement.moduleSpecifier.getStart(syntax)).line + 1 !== edge.line) {
17
+ return false;
18
+ }
19
+ const clause = statement.importClause;
20
+ const bindings = clause?.namedBindings;
21
+ return (
22
+ clause?.name === undefined
23
+ && bindings !== undefined
24
+ && ts.isNamedImports(bindings)
25
+ && bindings.elements.every((binding) => binding.isTypeOnly || ["BlockList", "isIP"].includes((binding.propertyName ?? binding.name).text))
26
+ );
27
+ }) ?? false
28
+ );
29
+ }
@@ -0,0 +1,9 @@
1
+ import { queueReadoutFindings } from "#adapters/queueReadoutFindings.ts";
2
+ import { defineRule } from "#rule.ts";
3
+
4
+ export const queueReadouts = defineRule({
5
+ check: queueReadoutFindings,
6
+ description: "Application tests assert job results, never jobs-testing queue storage; only the jobs package tests its readouts.",
7
+ id: "tests/queue-readouts",
8
+ registrable: false,
9
+ });
@@ -6,17 +6,20 @@ import type { Finding, SourceFile } from "#rule.ts";
6
6
  import { parse } from "#rules/parse.ts";
7
7
  import { usesDom } from "#rules/test-names/usesDom.ts";
8
8
  import { engineOf } from "./engineOf.ts";
9
+ import { pureNetImport } from "./pureNetImport.ts";
9
10
  import { type Stand, standIns } from "./unitSyntax.ts";
10
11
 
11
12
  const RELATIVE = /^[./#]/u;
12
13
 
13
14
  const KIT = "Drive the engine through the package's story kit in a story, or, if the code under test is pure,";
14
15
 
15
- function runtimeEdges(graph: ImportGraph): ReadonlyMap<string, readonly ImportEdge[]> {
16
+ function runtimeEdges(graph: ImportGraph, sources: ReadonlyMap<string, SourceFile>): ReadonlyMap<string, readonly ImportEdge[]> {
16
17
  const packages = graph.unresolved
17
18
  .filter((request) => request.missing === undefined && !RELATIVE.test(request.specifier))
18
19
  .map((request) => ({ ...request, to: { kind: "external" as const, package: packageNameOf(request.specifier), specifier: request.specifier } }));
19
- return outgoing([...graph.edges, ...packages].filter((edge) => edge.kind === "import" && !edge.type));
20
+ return outgoing(
21
+ [...graph.edges, ...packages].filter((edge) => edge.kind === "import" && !edge.type && !pureNetImport(edge, sources.get(edge.from))),
22
+ );
20
23
  }
21
24
 
22
25
  function repair(path: readonly string[]): string {
@@ -73,8 +76,8 @@ function syntaxFindings(file: string, module: string, trail: Trail, source: Sour
73
76
  }
74
77
 
75
78
  export function unitTests(graph: ImportGraph, sources: readonly SourceFile[]): (file: string) => readonly Finding[] {
76
- const edgesFrom = runtimeEdges(graph);
77
79
  const byPath = new Map(sources.map((source) => [source.path, source]));
80
+ const edgesFrom = runtimeEdges(graph, byPath);
78
81
  return (file) => {
79
82
  const walked = walkFrom(file, edgesFrom, engineOf);
80
83
  const checked = [...walked.visited].filter(([module]) => module === file || isTestSupport(module));
@@ -1,4 +1,4 @@
1
- import type { Chain, Layer } from "./configs.ts";
1
+ import type { Chain, Layer } from "#adapters/biome/configs.ts";
2
2
  import { scoped } from "./declarations.ts";
3
3
  import { entriesOf, isFalse, itemsOf, type Json, member, textOf } from "./json.ts";
4
4
 
@@ -1,8 +1,8 @@
1
1
  import { Effect, Schema } from "effect";
2
+ import { biomeConfigs, type Chain } from "#adapters/biome/configs.ts";
2
3
  import { biomeExceptionHint, missingBiomeFiles } from "#exceptions/biomeFindings.ts";
3
4
  import { defineRule, type Finding } from "#rule.ts";
4
5
  import { ConsumerDeclaration } from "#rules/suppressions/biome/ConsumerDeclaration.ts";
5
- import { biomeConfigs, type Chain } from "#rules/suppressions/biome/configs.ts";
6
6
  import { matches, type Scoped, scoped, scopeText } from "#rules/suppressions/biome/declarations.ts";
7
7
  import { type Weakening, weakeningsOf } from "#rules/suppressions/biome/weakenings.ts";
8
8
 
@@ -65,21 +65,22 @@ function staleOrRepeated(file: string, weakenings: readonly Weakening[], shipped
65
65
  }
66
66
 
67
67
  export const biomeOverrides = defineRule({
68
- check: async (inputs) => {
69
- const { chains, problems, root } = await biomeConfigs(inputs);
70
- const { declared } = inputs.options;
71
- const weakenings = chains.flatMap(weakeningsOf);
72
- const shipped = chains.flatMap(shippedBy);
73
- function covered(weakening: Weakening): boolean {
74
- return [...declared, ...shipped].some((declaration) => matches(declaration, weakening));
75
- }
76
- return [
77
- ...problems,
78
- ...(await missingBiomeFiles(inputs)),
79
- ...weakenings.filter((weakening) => !covered(weakening)).map((weakening) => undeclared(weakening, inputs.configFile ?? "quality.config.ts")),
80
- ...declared.flatMap(staleOrRepeated(root, weakenings, shipped)),
81
- ];
82
- },
68
+ check: (inputs) =>
69
+ Effect.gen(function* () {
70
+ const { chains, problems, root } = yield* Effect.promise(() => biomeConfigs(inputs));
71
+ const { declared } = inputs.options;
72
+ const weakenings = chains.flatMap(weakeningsOf);
73
+ const shipped = chains.flatMap(shippedBy);
74
+ function covered(weakening: Weakening): boolean {
75
+ return [...declared, ...shipped].some((declaration) => matches(declaration, weakening));
76
+ }
77
+ return [
78
+ ...problems,
79
+ ...(yield* missingBiomeFiles(inputs)),
80
+ ...weakenings.filter((weakening) => !covered(weakening)).map((weakening) => undeclared(weakening, inputs.configFile ?? "quality.config.ts")),
81
+ ...declared.flatMap(staleOrRepeated(root, weakenings, shipped)),
82
+ ];
83
+ }),
83
84
  description:
84
85
  "A Biome setting that turns a check off or down, or keeps files out of it, hides findings for every file it covers. Repair the code and remove the weakening setting.",
85
86
  id: "suppressions/biome-overrides",
@@ -1,11 +1,8 @@
1
- import { posix } from "node:path";
2
1
  import { Effect } from "effect";
2
+ import { presetConfig } from "#adapters/biome/presetConfig.ts";
3
3
  import { recommendedRules } from "#biome/recommendedRules.ts";
4
4
  import { defineRule, type Finding, type Rule, type RuleInputs, type RuleServices } from "#rule.ts";
5
- import { PRESET, rootConfig } from "#rules/biome.ts";
6
- import { decodeShipped, PRESET_DECLARATIONS } from "#rules/suppressions/biome/declarations.ts";
7
- import { type Json, member, parseJsonc, textOf } from "#rules/suppressions/biome/json.ts";
8
- import { resolvePackage } from "#rules/suppressions/biome/resolvePackage.ts";
5
+ import { type Json, member, textOf } from "#rules/suppressions/biome/json.ts";
9
6
 
10
7
  interface Setting {
11
8
  readonly level: string | undefined;
@@ -30,45 +27,29 @@ function looseRule(file: string, rule: string, { level, line }: Setting): Findin
30
27
  return { file, line, message: `Biome recommends "lint/${rule}", which the preset ${state}. ${FIX}`, subject: `lint/${rule}` };
31
28
  }
32
29
 
33
- function problem(file: string, message: string): readonly Finding[] {
34
- return [{ file, message }];
35
- }
36
-
37
- const check = Effect.fn("BiomeRecommended.check")(function* (readText: RuleInputs["readText"], recommended: Recommended) {
38
- const root = yield* Effect.promise(() => rootConfig(readText));
39
- if (!root.extendsPreset) {
30
+ const check = Effect.fn("BiomeRecommended.check")(function* (inputs: Pick<RuleInputs, "readText">, recommended: Recommended) {
31
+ const preset = yield* presetConfig(inputs.readText);
32
+ if (preset._tag === "Skipped") {
40
33
  return [];
41
34
  }
42
- const path = yield* Effect.promise(() => resolvePackage(readText, PRESET));
43
- if (path === undefined) {
44
- return problem(root.path, `Cannot resolve "${PRESET}" from node_modules. Install @shivaedev/quality at the repository root.`);
45
- }
46
- const text = yield* Effect.promise(() => readText(path));
47
- const parsed = text === undefined ? undefined : parseJsonc(path, text);
48
- if (parsed?._tag !== "Parsed") {
49
- return problem(path, `Cannot read the preset "${PRESET}": ${parsed?.reason ?? "the file does not exist"}.`);
50
- }
51
- const declarationsPath = posix.join(posix.dirname(path), PRESET_DECLARATIONS);
52
- const declarationText = yield* Effect.promise(() => readText(declarationsPath));
53
- const declarations = yield* Effect.promise(() => decodeShipped(declarationText));
54
- if (declarations._tag === "Invalid") {
55
- return problem(declarationsPath, `Cannot read the declarations shipped with "${PRESET}": ${declarations.issues.join("; ")}.`);
35
+ if (preset._tag === "Problem") {
36
+ return preset.findings;
56
37
  }
57
- const declared = new Set(declarations.value.map((declaration) => declaration.rule));
58
- const rules = member(member(parsed.json, "linter"), "rules");
59
- const result = recommended();
60
- return (yield* Effect.isEffect(result) ? result : Effect.promise(() => result))
38
+ const { path } = preset;
39
+ const declared = new Set(preset.declared.map((declaration) => declaration.rule));
40
+ const rules = member(member(preset.json, "linter"), "rules");
41
+ return (yield* recommended())
61
42
  .filter((rule) => !declared.has(`lint/${rule}`))
62
43
  .map((rule) => ({ rule, setting: settingOf(rules, rule) }))
63
44
  .filter(({ setting }) => setting.level !== "error")
64
45
  .map(({ rule, setting }) => looseRule(path, rule, setting));
65
46
  });
66
47
 
67
- type Recommended = () => Promise<readonly string[]> | Effect.Effect<readonly string[], unknown, RuleServices>;
48
+ type Recommended = () => Effect.Effect<readonly string[], unknown, RuleServices>;
68
49
 
69
50
  export function biomeRecommendedFrom(recommended: Recommended): Rule<"suppressions/biome-recommended", undefined> {
70
51
  return defineRule({
71
- check: ({ readText }) => check(readText, recommended),
52
+ check: (inputs) => check(inputs, recommended),
72
53
  description:
73
54
  "Every recommended Biome rule without a shipped internal exception runs at error in the shared preset. Set missing rules to error in the preset and repair the code they report.",
74
55
  id: "suppressions/biome-recommended",
@@ -1,5 +1,5 @@
1
- import { join, relative } from "node:path";
2
- import { Effect } from "effect";
1
+ import * as NodePath from "@effect/platform-node/NodePath";
2
+ import { Effect, Path } from "effect";
3
3
  import { readRequiredText } from "#inventory/filesystem.ts";
4
4
  import { posix } from "#inventory/ignoreScope.ts";
5
5
  import { walk } from "#inventory/walk.ts";
@@ -19,6 +19,8 @@ function settingIn(path: string, text: string): readonly Finding[] {
19
19
  export const noIgnoreDeprecations = defineRule({
20
20
  check: ({ root }) =>
21
21
  Effect.gen(function* () {
22
+ const { join, relative } = yield* Path.Path.pipe(Effect.provide(NodePath.layer));
23
+
22
24
  const paths = yield* walk(root);
23
25
  const configs = paths.map((path) => posix(relative(root, path))).filter((path) => path.endsWith(".json"));
24
26
  const findings = yield* Effect.forEach(configs.toSorted(), (path) =>
@@ -1,6 +1,6 @@
1
1
  import { posix } from "node:path";
2
2
  import { Schema } from "effect";
3
- import ignore from "ignore";
3
+ import { ignorePatterns } from "#adapters/ignore.ts";
4
4
  import { GlobDeclarations, globPatterns, validateGlobs } from "#config/globs.ts";
5
5
  import { isTestCode, testName } from "#naming/testName.ts";
6
6
  import { defineRule, type Finding } from "#rule.ts";
@@ -32,7 +32,7 @@ function findingOf(path: string, sourceFolders: ReadonlySet<string>): readonly F
32
32
 
33
33
  export const testsColocated = defineRule({
34
34
  check: ({ files, options }) => {
35
- const suites = ignore().add([...globPatterns(options.suites)]);
35
+ const suites = ignorePatterns([...globPatterns(options.suites)]);
36
36
  const sourceFolders = new Set(files.filter((path) => !isTestCode(path)).map((path) => posix.dirname(path)));
37
37
  return files.filter((path) => !suites.ignores(path)).flatMap((path) => findingOf(path, sourceFolders));
38
38
  },
@@ -1,6 +1,6 @@
1
1
  import { posix } from "node:path";
2
2
  import { Schema } from "effect";
3
- import ignore from "ignore";
3
+ import { ignorePatterns } from "#adapters/ignore.ts";
4
4
  import { GlobDeclarations, globPatterns, validateGlobs } from "#config/globs.ts";
5
5
  import { ENVIRONMENTS, type TestName, testName } from "#naming/testName.ts";
6
6
  import { CAMEL } from "#naming/words.ts";
@@ -14,7 +14,7 @@ const FIXTURE_SUFFIXES: ReadonlySet<string> = new Set(["integration", "postgres"
14
14
  const CODE = /\.[cm]?[jt]sx?$/u;
15
15
 
16
16
  const GRAMMAR =
17
- "A test file is <file>[.<modifier>].test.ts beside its file or <behaviour>[.<modifier>].spec.ts in the folder it covers, with at most one modifier of dom, slow, typecheck and unit.";
17
+ "A test file is <file>[.<modifier>].test.ts beside its file or <behaviour>[.<modifier>].spec.ts in the folder it covers, with at most one modifier of dom, heavy, slow, typecheck and unit.";
18
18
 
19
19
  const TestsFollowOptions = Schema.Struct({
20
20
  suites: GlobDeclarations,
@@ -79,12 +79,12 @@ function findingsOf(source: SourceFile, siblings: ReadonlySet<string>): readonly
79
79
 
80
80
  export const testsFollow = defineRule({
81
81
  check: ({ files, options, sources }) => {
82
- const suites = ignore().add([...globPatterns(options.suites)]);
82
+ const suites = ignorePatterns([...globPatterns(options.suites)]);
83
83
  const siblings = siblingsIn(files);
84
84
  return sources.filter((source) => !suites.ignores(source.path)).flatMap((source) => findingsOf(source, siblings));
85
85
  },
86
86
  description:
87
- "A .test file follows the file beside it, a .spec names a behaviour of its folder, the only suffix is one modifier of dom, slow, typecheck and unit, and a test that uses the DOM is a .dom test.",
87
+ "A .test file follows the file beside it, a .spec names a behaviour of its folder, the only suffix is one modifier of dom, heavy, slow, typecheck and unit, and a test that uses the DOM is a .dom test.",
88
88
  id: "tests/follow",
89
89
  options: Schema.toStandardSchemaV1(TestsFollowOptions, { parseOptions: { errors: "all", onExcessProperty: "error" } }),
90
90
  validate: validateGlobs,
@@ -0,0 +1,12 @@
1
+ import { Effect } from "effect";
2
+ import { type Assertion, type ExpectStatic, expect } from "vitest";
3
+
4
+ export function assertThat<TValue>(value: TValue, check: (actual: Assertion<void, TValue>, matchers: ExpectStatic) => void): Effect.Effect<void> {
5
+ return Effect.sync(() => check(expect(value), expect));
6
+ }
7
+
8
+ export function withMatchers<TValue, TError, TServices>(
9
+ check: (matchers: ExpectStatic) => Effect.Effect<TValue, TError, TServices>,
10
+ ): Effect.Effect<TValue, TError, TServices> {
11
+ return Effect.suspend(() => check(expect));
12
+ }
@@ -0,0 +1,105 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { realpathSync } from "node:fs";
3
+ import { fileURLToPath } from "node:url";
4
+ import { format } from "node:util";
5
+ import { Config, Console, Effect, Option } from "effect";
6
+ import { program } from "#cli/program.ts";
7
+ import { exitCode, explained, services } from "#cli/runMain.ts";
8
+ import { ISOLATED_ENV } from "#testing/adapters/git.ts";
9
+
10
+ export interface Run {
11
+ readonly status: number | null;
12
+ readonly stderr: string;
13
+ readonly stdout: string;
14
+ }
15
+
16
+ const SOURCE = import.meta.url.endsWith(".ts");
17
+ const CLI = fileURLToPath(new URL(SOURCE ? "../../cli.ts" : "../../cli.js", import.meta.url));
18
+ const OPTIONS = SOURCE ? ["--conditions=source"] : [];
19
+
20
+ export const CLI_TIMEOUT = 60_000;
21
+
22
+ // The source condition resolves a seeded config's import of the package to its source, so tests need no build.
23
+ export function qualityArgs(args: readonly string[]): string[] {
24
+ return [...OPTIONS, CLI, ...args];
25
+ }
26
+
27
+ const ISOLATED: readonly (readonly [string, string | undefined])[] = [
28
+ ...["GIT_COMMON_DIR", "GIT_DIR", "GIT_INDEX_FILE", "GIT_WORK_TREE"].map((name) => [name, undefined] as const),
29
+ ...Object.entries(ISOLATED_ENV),
30
+ ];
31
+
32
+ async function isolateGit(): Promise<() => void> {
33
+ const { vi } = await import("vitest");
34
+ const previous = ISOLATED.map(([name]) => [name, Option.getOrUndefined(Effect.runSync(Config.option(Config.String(name))))] as const);
35
+ for (const [name, value] of ISOLATED) {
36
+ vi.stubEnv(name, value);
37
+ }
38
+ return () => {
39
+ for (const [name, value] of previous) {
40
+ vi.stubEnv(name, value);
41
+ }
42
+ };
43
+ }
44
+
45
+ export interface Output {
46
+ stderr: string;
47
+ stdout: string;
48
+ }
49
+
50
+ function writer(output: Output, stream: keyof Output): (...parts: readonly unknown[]) => void {
51
+ return (...parts) => {
52
+ output[stream] += `${format(...parts)}\n`;
53
+ };
54
+ }
55
+
56
+ function unsupported(): never {
57
+ throw new Error("The captured Console copies only the output methods; capture this one too before quality calls it.");
58
+ }
59
+
60
+ export function capturing(output: Output): Console.Console {
61
+ const stdout = writer(output, "stdout");
62
+ const stderr = writer(output, "stderr");
63
+ return {
64
+ assert: unsupported,
65
+ clear: unsupported,
66
+ count: unsupported,
67
+ countReset: unsupported,
68
+ debug: stdout,
69
+ dir: unsupported,
70
+ dirxml: unsupported,
71
+ error: stderr,
72
+ group: unsupported,
73
+ groupCollapsed: unsupported,
74
+ groupEnd: unsupported,
75
+ info: stdout,
76
+ log: stdout,
77
+ table: unsupported,
78
+ time: unsupported,
79
+ timeEnd: unsupported,
80
+ timeLog: unsupported,
81
+ trace: stderr,
82
+ warn: stderr,
83
+ };
84
+ }
85
+
86
+ // Runs the executable's program in this process, which imports each config path once: after a command rewrites the config, spawn `quality`.
87
+ export async function runQuality(root: string, ...args: readonly string[]): Promise<Run> {
88
+ const output: Output = { stderr: "", stdout: "" };
89
+ const captured = capturing(output);
90
+ const command = program(args, { cwd: realpathSync(root), launch: { options: OPTIONS, script: CLI } });
91
+ const restore = await isolateGit();
92
+ try {
93
+ const exit = await Effect.runPromiseExit(explained(command).pipe(Effect.provideService(Console.Console, captured), Effect.provide(services)));
94
+ return { status: exitCode(exit), ...output };
95
+ } finally {
96
+ restore();
97
+ }
98
+ }
99
+
100
+ export function quality(root: string, ...args: readonly string[]): Run {
101
+ const result = spawnSync("node", qualityArgs(args), { cwd: root, encoding: "utf8", env: ISOLATED_ENV });
102
+ return { status: result.status, stderr: result.stderr, stdout: result.stdout };
103
+ }
104
+
105
+ export const CLI_EXIT = { invalid: 2, passed: 0, rejected: 1 } as const;
@@ -0,0 +1,62 @@
1
+ import { execFileSync, spawnSync } from "node:child_process";
2
+ import { Config, Effect, Option } from "effect";
3
+
4
+ const HEAVY_ENV = Object.fromEntries(
5
+ ["CI", "HOME", "HEAVY_PROCESS_LOCK", "HEAVY_PROCESS_LOCK_ID"].flatMap((name) =>
6
+ Option.toArray(Effect.runSync(Config.option(Config.String(name)))).map((value) => [name, value]),
7
+ ),
8
+ );
9
+
10
+ // Git reads no user or system config, so a machine-wide hooks path neither runs nor hides a hook under test, and no GIT_DIR or
11
+ // GIT_INDEX_FILE from a hook that runs the tests points git at the outer repository.
12
+ export const ISOLATED_ENV = {
13
+ ...HEAVY_ENV,
14
+ "GIT_AUTHOR_EMAIL": "quality@example.invalid",
15
+ "GIT_AUTHOR_NAME": "Quality",
16
+ "GIT_COMMITTER_EMAIL": "quality@example.invalid",
17
+ "GIT_COMMITTER_NAME": "Quality",
18
+ "GIT_CONFIG_GLOBAL": "/dev/null",
19
+ "GIT_CONFIG_NOSYSTEM": "1",
20
+ "PATH": Effect.runSync(Config.String("PATH")),
21
+ };
22
+
23
+ const SETTINGS = [
24
+ "user.name=Quality",
25
+ "user.email=quality@example.invalid",
26
+ "init.defaultBranch=main",
27
+ "commit.gpgsign=false",
28
+ "core.hooksPath=/dev/null",
29
+ ];
30
+
31
+ export function git(root: string, ...args: readonly string[]): string {
32
+ return execFileSync("git", [...SETTINGS.flatMap((setting) => ["-c", setting]), ...args], {
33
+ cwd: root,
34
+ encoding: "utf8",
35
+ env: ISOLATED_ENV,
36
+ stdio: ["ignore", "pipe", "pipe"],
37
+ });
38
+ }
39
+
40
+ export function commitAll(root: string, message: string): void {
41
+ git(root, "add", "--all");
42
+ git(root, "commit", "--quiet", "--message", message);
43
+ }
44
+
45
+ export function mergeBranch(root: string, branch: string): "merged" | "conflicted" {
46
+ const result = spawnSync("git", [...SETTINGS.flatMap((setting) => ["-c", setting]), "merge", "--quiet", "--no-edit", branch], {
47
+ cwd: root,
48
+ encoding: "utf8",
49
+ env: ISOLATED_ENV,
50
+ });
51
+ if (result.status !== 0 && result.status !== 1) {
52
+ throw new Error(`git merge failed: ${result.error ?? result.stderr}`);
53
+ }
54
+ return result.status === 0 ? "merged" : "conflicted";
55
+ }
56
+
57
+ export function branchOff(root: string): string {
58
+ git(root, "init", "--quiet");
59
+ commitAll(root, "Base");
60
+ git(root, "switch", "--quiet", "--create", "work");
61
+ return root;
62
+ }
@@ -0,0 +1,6 @@
1
+ import { realpathSync } from "node:fs";
2
+ import { join } from "node:path";
3
+
4
+ export function hookPath(root: string): string {
5
+ return join(realpathSync(root), ".git", "hooks", "pre-commit");
6
+ }