@shivaedev/quality 0.74.2 → 0.75.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 (531) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +17 -6
  3. package/dist/adapters/asciiFindings.d.ts +1 -1
  4. package/dist/adapters/asciiFindings.d.ts.map +1 -1
  5. package/dist/adapters/asciiFindings.js +1 -1
  6. package/dist/adapters/asciiFindings.js.map +1 -1
  7. package/dist/adapters/biome/configs.d.ts +4 -1
  8. package/dist/adapters/biome/configs.d.ts.map +1 -1
  9. package/dist/adapters/biome/configs.js +32 -27
  10. package/dist/adapters/biome/configs.js.map +1 -1
  11. package/dist/adapters/biome/presetConfig.d.ts +2 -2
  12. package/dist/adapters/biome/presetConfig.d.ts.map +1 -1
  13. package/dist/adapters/biome/presetConfig.js +5 -5
  14. package/dist/adapters/biome/presetConfig.js.map +1 -1
  15. package/dist/adapters/biome/resolvePackage.d.ts +2 -2
  16. package/dist/adapters/biome/resolvePackage.d.ts.map +1 -1
  17. package/dist/adapters/biome/resolvePackage.js +5 -4
  18. package/dist/adapters/biome/resolvePackage.js.map +1 -1
  19. package/dist/adapters/biome/rootConfig.d.ts +3 -2
  20. package/dist/adapters/biome/rootConfig.d.ts.map +1 -1
  21. package/dist/adapters/biome/rootConfig.js +4 -3
  22. package/dist/adapters/biome/rootConfig.js.map +1 -1
  23. package/dist/adapters/biome/toolContractDefaults.d.ts +1 -1
  24. package/dist/adapters/biome/toolContractDefaults.d.ts.map +1 -1
  25. package/dist/adapters/biome/toolContractDefaults.js +2 -5
  26. package/dist/adapters/biome/toolContractDefaults.js.map +1 -1
  27. package/dist/adapters/builtinName.d.ts +2 -0
  28. package/dist/adapters/builtinName.d.ts.map +1 -0
  29. package/dist/adapters/builtinName.js +9 -0
  30. package/dist/adapters/builtinName.js.map +1 -0
  31. package/dist/adapters/catalogWorkspace.d.ts +1 -1
  32. package/dist/adapters/catalogWorkspace.d.ts.map +1 -1
  33. package/dist/adapters/catalogWorkspace.js +1 -1
  34. package/dist/adapters/catalogWorkspace.js.map +1 -1
  35. package/dist/adapters/clientHandle.d.ts +3 -0
  36. package/dist/adapters/clientHandle.d.ts.map +1 -0
  37. package/dist/adapters/clientHandle.js +6 -0
  38. package/dist/adapters/clientHandle.js.map +1 -0
  39. package/dist/adapters/commandLine.d.ts +15 -0
  40. package/dist/adapters/commandLine.d.ts.map +1 -0
  41. package/dist/adapters/commandLine.js +10 -0
  42. package/dist/adapters/commandLine.js.map +1 -0
  43. package/dist/adapters/contentHashedModule.d.ts +2 -0
  44. package/dist/adapters/contentHashedModule.d.ts.map +1 -0
  45. package/dist/adapters/contentHashedModule.js +9 -0
  46. package/dist/adapters/contentHashedModule.js.map +1 -0
  47. package/dist/adapters/databaseUrlFindings.d.ts +1 -1
  48. package/dist/adapters/databaseUrlFindings.d.ts.map +1 -1
  49. package/dist/adapters/declarationTagParameter.d.ts +3 -0
  50. package/dist/adapters/declarationTagParameter.d.ts.map +1 -0
  51. package/dist/adapters/declarationTagParameter.js +125 -0
  52. package/dist/adapters/declarationTagParameter.js.map +1 -0
  53. package/dist/adapters/domEnvironment.config.d.ts.map +1 -0
  54. package/dist/adapters/domEnvironment.config.js.map +1 -0
  55. package/dist/adapters/frameworkCallback.d.ts +1 -0
  56. package/dist/adapters/frameworkCallback.d.ts.map +1 -1
  57. package/dist/adapters/frameworkCallback.js +1 -1
  58. package/dist/adapters/frameworkCallback.js.map +1 -1
  59. package/dist/adapters/freshObject.d.ts +3 -0
  60. package/dist/adapters/freshObject.d.ts.map +1 -0
  61. package/dist/adapters/freshObject.js +53 -0
  62. package/dist/adapters/freshObject.js.map +1 -0
  63. package/dist/adapters/imports/resolve.d.ts.map +1 -1
  64. package/dist/adapters/imports/resolve.js +2 -1
  65. package/dist/adapters/imports/resolve.js.map +1 -1
  66. package/dist/adapters/knip/configuration.d.ts +3 -2
  67. package/dist/adapters/knip/configuration.d.ts.map +1 -1
  68. package/dist/adapters/knip/configuration.js +8 -7
  69. package/dist/adapters/knip/configuration.js.map +1 -1
  70. package/dist/adapters/knip/entryPointFindings.d.ts +1 -1
  71. package/dist/adapters/knip/entryPointFindings.d.ts.map +1 -1
  72. package/dist/adapters/knip/entryPointFindings.js +4 -4
  73. package/dist/adapters/knip/entryPointFindings.js.map +1 -1
  74. package/dist/adapters/knip/run.d.ts +1 -1
  75. package/dist/adapters/knip/run.d.ts.map +1 -1
  76. package/dist/adapters/knip/run.js +2 -2
  77. package/dist/adapters/knip/run.js.map +1 -1
  78. package/dist/adapters/knip/sourceConfig.d.ts +1 -1
  79. package/dist/adapters/knip/sourceConfig.d.ts.map +1 -1
  80. package/dist/adapters/knip/sourceConfig.js +1 -1
  81. package/dist/adapters/knip/sourceConfig.js.map +1 -1
  82. package/dist/adapters/manifestInventory.d.ts +45 -4
  83. package/dist/adapters/manifestInventory.d.ts.map +1 -1
  84. package/dist/adapters/manifestInventory.js +26 -32
  85. package/dist/adapters/manifestInventory.js.map +1 -1
  86. package/dist/adapters/manifestReader.d.ts +2 -2
  87. package/dist/adapters/manifestReader.d.ts.map +1 -1
  88. package/dist/adapters/manifestReader.js +3 -4
  89. package/dist/adapters/manifestReader.js.map +1 -1
  90. package/dist/adapters/manifestSorting.d.ts +8 -0
  91. package/dist/adapters/manifestSorting.d.ts.map +1 -0
  92. package/dist/adapters/manifestSorting.js +6 -0
  93. package/dist/adapters/manifestSorting.js.map +1 -0
  94. package/dist/adapters/outsideImportFindings.d.ts +3 -1
  95. package/dist/adapters/outsideImportFindings.d.ts.map +1 -1
  96. package/dist/adapters/outsideImportFindings.js +4 -1
  97. package/dist/adapters/outsideImportFindings.js.map +1 -1
  98. package/dist/adapters/plainFunction.d.ts +3 -0
  99. package/dist/adapters/plainFunction.d.ts.map +1 -0
  100. package/dist/adapters/plainFunction.js +19 -0
  101. package/dist/adapters/plainFunction.js.map +1 -0
  102. package/dist/adapters/queueReadoutFindings.d.ts +1 -1
  103. package/dist/adapters/queueReadoutFindings.d.ts.map +1 -1
  104. package/dist/adapters/queueReadoutFindings.js +1 -1
  105. package/dist/adapters/queueReadoutFindings.js.map +1 -1
  106. package/dist/adapters/repositoryPathFindings.d.ts +1 -1
  107. package/dist/adapters/repositoryPathFindings.d.ts.map +1 -1
  108. package/dist/adapters/repositoryPathFindings.js +1 -1
  109. package/dist/adapters/repositoryPathFindings.js.map +1 -1
  110. package/dist/adapters/rpcBoundaryFindings.d.ts +1 -1
  111. package/dist/adapters/rpcBoundaryFindings.d.ts.map +1 -1
  112. package/dist/adapters/rule.d.ts +1 -1
  113. package/dist/adapters/rule.d.ts.map +1 -1
  114. package/dist/adapters/rule.js +2 -3
  115. package/dist/adapters/rule.js.map +1 -1
  116. package/dist/adapters/runMain.d.ts.map +1 -0
  117. package/dist/adapters/runMain.js.map +1 -0
  118. package/dist/adapters/serviceIdFindings.d.ts +1 -1
  119. package/dist/adapters/serviceIdFindings.d.ts.map +1 -1
  120. package/dist/adapters/serviceIdFindings.js +1 -1
  121. package/dist/adapters/serviceIdFindings.js.map +1 -1
  122. package/dist/adapters/serviceModelSyntax.d.ts +1 -0
  123. package/dist/adapters/serviceModelSyntax.d.ts.map +1 -1
  124. package/dist/adapters/serviceModelSyntax.js +1 -1
  125. package/dist/adapters/serviceModelSyntax.js.map +1 -1
  126. package/dist/adapters/sharedErrorFindings.d.ts +1 -1
  127. package/dist/adapters/sharedErrorFindings.d.ts.map +1 -1
  128. package/dist/adapters/sharedErrorFindings.js +1 -1
  129. package/dist/adapters/sharedErrorFindings.js.map +1 -1
  130. package/dist/adapters/sharedErrorModules.d.ts +2 -1
  131. package/dist/adapters/sharedErrorModules.d.ts.map +1 -1
  132. package/dist/adapters/sharedErrorModules.js +4 -3
  133. package/dist/adapters/sharedErrorModules.js.map +1 -1
  134. package/dist/adapters/testProjects.js +2 -2
  135. package/dist/adapters/testProjects.js.map +1 -1
  136. package/dist/adapters/unitIoGuard.config.d.ts.map +1 -0
  137. package/dist/adapters/unitIoGuard.config.js.map +1 -0
  138. package/dist/adapters/valueType.d.ts +3 -0
  139. package/dist/adapters/valueType.d.ts.map +1 -0
  140. package/dist/adapters/valueType.js +16 -0
  141. package/dist/adapters/valueType.js.map +1 -0
  142. package/dist/appTestConfig.d.ts +2 -1
  143. package/dist/appTestConfig.d.ts.map +1 -1
  144. package/dist/appTestConfig.js +2 -3
  145. package/dist/appTestConfig.js.map +1 -1
  146. package/dist/baseline/format.d.ts +1 -1
  147. package/dist/baseline/format.d.ts.map +1 -1
  148. package/dist/baseline/format.js +2 -2
  149. package/dist/baseline/format.js.map +1 -1
  150. package/dist/baseline/legacy.d.ts +1 -1
  151. package/dist/baseline/legacy.d.ts.map +1 -1
  152. package/dist/baseline/legacy.js +2 -2
  153. package/dist/baseline/legacy.js.map +1 -1
  154. package/dist/baseline/looseStagedEntries.js +2 -2
  155. package/dist/baseline/looseStagedEntries.js.map +1 -1
  156. package/dist/baseline/merge.js +1 -1
  157. package/dist/baseline/merge.js.map +1 -1
  158. package/dist/biome/report.d.ts +1 -1
  159. package/dist/biome/report.d.ts.map +1 -1
  160. package/dist/biome/withoutEntryPointImports.d.ts +1 -1
  161. package/dist/biome/withoutEntryPointImports.d.ts.map +1 -1
  162. package/dist/biome/withoutEntryPointImports.js +2 -2
  163. package/dist/biome/withoutEntryPointImports.js.map +1 -1
  164. package/dist/cli/args.d.ts.map +1 -1
  165. package/dist/cli/args.js +3 -6
  166. package/dist/cli/args.js.map +1 -1
  167. package/dist/cli/migrateBaseline.d.ts.map +1 -1
  168. package/dist/cli/migrateBaseline.js +1 -3
  169. package/dist/cli/migrateBaseline.js.map +1 -1
  170. package/dist/cli/migrateExceptions.js +2 -2
  171. package/dist/cli/migrateExceptions.js.map +1 -1
  172. package/dist/cli.js +1 -1
  173. package/dist/cli.js.map +1 -1
  174. package/dist/config/decode.d.ts +1 -1
  175. package/dist/config/decode.d.ts.map +1 -1
  176. package/dist/config/load.js +1 -1
  177. package/dist/config/load.js.map +1 -1
  178. package/dist/decoded.d.ts +1 -1
  179. package/dist/decoded.d.ts.map +1 -1
  180. package/dist/decoded.js +2 -2
  181. package/dist/decoded.js.map +1 -1
  182. package/dist/docs/importFindings.d.ts +4 -3
  183. package/dist/docs/importFindings.d.ts.map +1 -1
  184. package/dist/docs/importFindings.js.map +1 -1
  185. package/dist/docs/linkFindings.d.ts +3 -2
  186. package/dist/docs/linkFindings.d.ts.map +1 -1
  187. package/dist/docs/linkFindings.js.map +1 -1
  188. package/dist/engine/baselineFile.js +1 -1
  189. package/dist/engine/baselineFile.js.map +1 -1
  190. package/dist/engine/session.d.ts.map +1 -1
  191. package/dist/engine/session.js +1 -1
  192. package/dist/engine/session.js.map +1 -1
  193. package/dist/exceptions/biomeFindings.d.ts +3 -2
  194. package/dist/exceptions/biomeFindings.d.ts.map +1 -1
  195. package/dist/exceptions/biomeFindings.js +2 -2
  196. package/dist/exceptions/biomeFindings.js.map +1 -1
  197. package/dist/exceptions/declaration.d.ts +1 -1
  198. package/dist/exceptions/declaration.d.ts.map +1 -1
  199. package/dist/exceptions/registry.d.ts +1 -1
  200. package/dist/exceptions/registry.d.ts.map +1 -1
  201. package/dist/exceptions/registry.js +1 -1
  202. package/dist/exceptions/registry.js.map +1 -1
  203. package/dist/hooks/preCommit.js +2 -5
  204. package/dist/hooks/preCommit.js.map +1 -1
  205. package/dist/imports/browserGlobals.d.ts +1 -1
  206. package/dist/imports/browserGlobals.d.ts.map +1 -1
  207. package/dist/imports/browserGlobals.js +7 -2
  208. package/dist/imports/browserGlobals.js.map +1 -1
  209. package/dist/imports/browserNames.d.ts +3 -1
  210. package/dist/imports/browserNames.d.ts.map +1 -1
  211. package/dist/imports/browserNames.js +9 -5
  212. package/dist/imports/browserNames.js.map +1 -1
  213. package/dist/imports/departures.d.ts +1 -1
  214. package/dist/imports/departures.d.ts.map +1 -1
  215. package/dist/imports/departures.js +1 -1
  216. package/dist/imports/departures.js.map +1 -1
  217. package/dist/imports/fences/BoundaryFailure.d.ts +10 -0
  218. package/dist/imports/fences/BoundaryFailure.d.ts.map +1 -0
  219. package/dist/imports/fences/BoundaryFailure.js +4 -0
  220. package/dist/imports/fences/BoundaryFailure.js.map +1 -0
  221. package/dist/imports/fences/check.d.ts +1 -1
  222. package/dist/imports/fences/check.d.ts.map +1 -1
  223. package/dist/imports/fences/check.js +1 -1
  224. package/dist/imports/fences/check.js.map +1 -1
  225. package/dist/imports/fences/declarations.d.ts +1 -1
  226. package/dist/imports/fences/declarations.d.ts.map +1 -1
  227. package/dist/imports/fences/discover.d.ts +3 -1
  228. package/dist/imports/fences/discover.d.ts.map +1 -1
  229. package/dist/imports/fences/discover.js +32 -26
  230. package/dist/imports/fences/discover.js.map +1 -1
  231. package/dist/imports/fences/match.d.ts.map +1 -1
  232. package/dist/imports/fences/match.js +2 -1
  233. package/dist/imports/fences/match.js.map +1 -1
  234. package/dist/imports/globMatcher.d.ts +10 -1
  235. package/dist/imports/globMatcher.d.ts.map +1 -1
  236. package/dist/imports/globMatcher.js +12 -17
  237. package/dist/imports/globMatcher.js.map +1 -1
  238. package/dist/imports/graph.d.ts +1 -1
  239. package/dist/imports/graph.d.ts.map +1 -1
  240. package/dist/imports/graph.js +1 -1
  241. package/dist/imports/graph.js.map +1 -1
  242. package/dist/imports/packageName.d.ts +0 -1
  243. package/dist/imports/packageName.d.ts.map +1 -1
  244. package/dist/imports/packageName.js +1 -8
  245. package/dist/imports/packageName.js.map +1 -1
  246. package/dist/imports/runtime.d.ts +2 -2
  247. package/dist/imports/runtime.d.ts.map +1 -1
  248. package/dist/imports/runtime.js +2 -2
  249. package/dist/imports/runtime.js.map +1 -1
  250. package/dist/imports/segmentsMatch.d.ts +5 -0
  251. package/dist/imports/segmentsMatch.d.ts.map +1 -0
  252. package/dist/imports/segmentsMatch.js +16 -0
  253. package/dist/imports/segmentsMatch.js.map +1 -0
  254. package/dist/imports/withoutGenerated.d.ts +1 -1
  255. package/dist/imports/withoutGenerated.d.ts.map +1 -1
  256. package/dist/imports/withoutGenerated.js +1 -1
  257. package/dist/imports/withoutGenerated.js.map +1 -1
  258. package/dist/imports/workspace.d.ts +2 -1
  259. package/dist/imports/workspace.d.ts.map +1 -1
  260. package/dist/imports/workspace.js +17 -15
  261. package/dist/imports/workspace.js.map +1 -1
  262. package/dist/inventory/programmaticBuilds.d.ts +1 -1
  263. package/dist/inventory/programmaticBuilds.d.ts.map +1 -1
  264. package/dist/manifests/entryPoints.d.ts +2 -1
  265. package/dist/manifests/entryPoints.d.ts.map +1 -1
  266. package/dist/manifests/entryPoints.js +9 -8
  267. package/dist/manifests/entryPoints.js.map +1 -1
  268. package/dist/manifests/sorted.d.ts +0 -7
  269. package/dist/manifests/sorted.d.ts.map +1 -1
  270. package/dist/manifests/sorted.js +3 -10
  271. package/dist/manifests/sorted.js.map +1 -1
  272. package/dist/naming/developmentCode.d.ts +1 -1
  273. package/dist/naming/developmentCode.d.ts.map +1 -1
  274. package/dist/naming/developmentCode.js +2 -2
  275. package/dist/naming/developmentCode.js.map +1 -1
  276. package/dist/naming/packageLayout.d.ts +2 -1
  277. package/dist/naming/packageLayout.d.ts.map +1 -1
  278. package/dist/naming/packageLayout.js +4 -1
  279. package/dist/naming/packageLayout.js.map +1 -1
  280. package/dist/naming/packageTests.d.ts +1 -1
  281. package/dist/naming/packageTests.d.ts.map +1 -1
  282. package/dist/naming/packageTests.js +2 -2
  283. package/dist/naming/packageTests.js.map +1 -1
  284. package/dist/naming/testCode.d.ts +1 -1
  285. package/dist/naming/testCode.d.ts.map +1 -1
  286. package/dist/naming/testCode.js +1 -1
  287. package/dist/naming/testCode.js.map +1 -1
  288. package/dist/rule.d.ts +2 -2
  289. package/dist/rule.d.ts.map +1 -1
  290. package/dist/rules/biome.js +1 -1
  291. package/dist/rules/biome.js.map +1 -1
  292. package/dist/rules/docs/references.d.ts.map +1 -1
  293. package/dist/rules/docs/references.js +6 -10
  294. package/dist/rules/docs/references.js.map +1 -1
  295. package/dist/rules/docs/unversionedInstalls.d.ts.map +1 -1
  296. package/dist/rules/docs/unversionedInstalls.js +1 -1
  297. package/dist/rules/docs/unversionedInstalls.js.map +1 -1
  298. package/dist/rules/effect/adapterImports.js +1 -1
  299. package/dist/rules/effect/adapterImports.js.map +1 -1
  300. package/dist/rules/effect/boundary.d.ts.map +1 -1
  301. package/dist/rules/effect/boundary.js +1 -1
  302. package/dist/rules/effect/boundary.js.map +1 -1
  303. package/dist/rules/effect/failureFindings.d.ts +1 -1
  304. package/dist/rules/effect/failureFindings.d.ts.map +1 -1
  305. package/dist/rules/effect/failureFindings.js +9 -3
  306. package/dist/rules/effect/failureFindings.js.map +1 -1
  307. package/dist/rules/effect/failureHonesty.d.ts.map +1 -1
  308. package/dist/rules/effect/failureHonesty.js +3 -2
  309. package/dist/rules/effect/failureHonesty.js.map +1 -1
  310. package/dist/rules/effect/serviceCatalog.d.ts +1 -0
  311. package/dist/rules/effect/serviceCatalog.d.ts.map +1 -1
  312. package/dist/rules/effect/serviceFindings.d.ts.map +1 -1
  313. package/dist/rules/effect/serviceFindings.js +7 -1
  314. package/dist/rules/effect/serviceFindings.js.map +1 -1
  315. package/dist/rules/effect/serviceParameters.js +3 -3
  316. package/dist/rules/effect/serviceParameters.js.map +1 -1
  317. package/dist/rules/effect/serviceTypes.d.ts +1 -0
  318. package/dist/rules/effect/serviceTypes.d.ts.map +1 -1
  319. package/dist/rules/effect/serviceTypes.js +15 -19
  320. package/dist/rules/effect/serviceTypes.js.map +1 -1
  321. package/dist/rules/effect/successRecovery.d.ts +1 -0
  322. package/dist/rules/effect/successRecovery.d.ts.map +1 -1
  323. package/dist/rules/effect/successRecovery.js +23 -0
  324. package/dist/rules/effect/successRecovery.js.map +1 -1
  325. package/dist/rules/files/packageImports.d.ts +2 -1
  326. package/dist/rules/files/packageImports.d.ts.map +1 -1
  327. package/dist/rules/files/packageImports.js +1 -1
  328. package/dist/rules/files/packageImports.js.map +1 -1
  329. package/dist/rules/files/stylesheetImporters.d.ts +2 -1
  330. package/dist/rules/files/stylesheetImporters.d.ts.map +1 -1
  331. package/dist/rules/files/stylesheetImporters.js +1 -1
  332. package/dist/rules/files/stylesheetImporters.js.map +1 -1
  333. package/dist/rules/imports/manifest.js +4 -4
  334. package/dist/rules/imports/manifest.js.map +1 -1
  335. package/dist/rules/imports/runtime.d.ts.map +1 -1
  336. package/dist/rules/imports/runtime.js +2 -3
  337. package/dist/rules/imports/runtime.js.map +1 -1
  338. package/dist/rules/manifestsApplication.d.ts.map +1 -1
  339. package/dist/rules/manifestsApplication.js +4 -4
  340. package/dist/rules/manifestsApplication.js.map +1 -1
  341. package/dist/rules/manifestsDependencyPins.js +1 -1
  342. package/dist/rules/manifestsDependencyPins.js.map +1 -1
  343. package/dist/rules/manifestsExportsShape.js +2 -2
  344. package/dist/rules/manifestsExportsShape.js.map +1 -1
  345. package/dist/rules/manifestsNoTestKits.d.ts.map +1 -1
  346. package/dist/rules/manifestsNoTestKits.js +1 -1
  347. package/dist/rules/manifestsNoTestKits.js.map +1 -1
  348. package/dist/rules/manifestsSorted.js +2 -2
  349. package/dist/rules/manifestsSorted.js.map +1 -1
  350. package/dist/rules/manifestsSourceFirst.js +1 -1
  351. package/dist/rules/manifestsSourceFirst.js.map +1 -1
  352. package/dist/rules/manifestsValid.d.ts.map +1 -1
  353. package/dist/rules/manifestsValid.js +1 -1
  354. package/dist/rules/manifestsValid.js.map +1 -1
  355. package/dist/rules/stories/authSql.js +1 -1
  356. package/dist/rules/stories/authSql.js.map +1 -1
  357. package/dist/rules/stories/engine.js +1 -1
  358. package/dist/rules/stories/engine.js.map +1 -1
  359. package/dist/rules/stories/prerequisites.d.ts +2 -1
  360. package/dist/rules/stories/prerequisites.d.ts.map +1 -1
  361. package/dist/rules/stories/prerequisites.js +4 -3
  362. package/dist/rules/stories/prerequisites.js.map +1 -1
  363. package/dist/rules/stories/queueSql.d.ts.map +1 -1
  364. package/dist/rules/stories/queueSql.js +3 -2
  365. package/dist/rules/stories/queueSql.js.map +1 -1
  366. package/dist/rules/stories/sources.d.ts +2 -2
  367. package/dist/rules/stories/sources.d.ts.map +1 -1
  368. package/dist/rules/stories/sources.js +1 -1
  369. package/dist/rules/stories/sources.js.map +1 -1
  370. package/dist/rules/stories/specs.js +1 -1
  371. package/dist/rules/stories/specs.js.map +1 -1
  372. package/dist/rules/stories/sqlText.d.ts +3 -1
  373. package/dist/rules/stories/sqlText.d.ts.map +1 -1
  374. package/dist/rules/stories/sqlText.js +12 -11
  375. package/dist/rules/stories/sqlText.js.map +1 -1
  376. package/dist/rules/suppressions/biome/declarations.d.ts +1 -1
  377. package/dist/rules/suppressions/biome/declarations.d.ts.map +1 -1
  378. package/dist/rules/suppressions/biome/declarations.js +1 -1
  379. package/dist/rules/suppressions/biome/declarations.js.map +1 -1
  380. package/dist/rules/suppressions/biomeOverrides.js +1 -1
  381. package/dist/rules/suppressions/biomeOverrides.js.map +1 -1
  382. package/dist/rules/suppressions/noDoubleCast.js +1 -1
  383. package/dist/rules/suppressions/noDoubleCast.js.map +1 -1
  384. package/dist/rules/suppressions/noInline.d.ts.map +1 -1
  385. package/dist/rules/suppressions/noInline.js +11 -4
  386. package/dist/rules/suppressions/noInline.js.map +1 -1
  387. package/dist/rules/suppressions/readonlyWrite.d.ts.map +1 -1
  388. package/dist/rules/suppressions/readonlyWrite.js +2 -1
  389. package/dist/rules/suppressions/readonlyWrite.js.map +1 -1
  390. package/dist/testing/adapters/cli.js +1 -1
  391. package/dist/testing/adapters/cli.js.map +1 -1
  392. package/dist/testing/adapters/imports.js +2 -2
  393. package/dist/testing/adapters/imports.js.map +1 -1
  394. package/dist/testing/adapters/run.js +1 -1
  395. package/dist/testing/adapters/run.js.map +1 -1
  396. package/dist/testing/adapters/tree.d.ts +1 -0
  397. package/dist/testing/adapters/tree.d.ts.map +1 -1
  398. package/dist/testing/adapters/tree.js +3 -0
  399. package/dist/testing/adapters/tree.js.map +1 -1
  400. package/dist/testing/ruleStory.js +1 -1
  401. package/dist/testing/ruleStory.js.map +1 -1
  402. package/package.json +5 -5
  403. package/src/adapters/asciiFindings.ts +1 -1
  404. package/src/adapters/biome/configs.ts +50 -28
  405. package/src/adapters/biome/presetConfig.ts +5 -5
  406. package/src/adapters/biome/resolvePackage.ts +5 -4
  407. package/src/adapters/biome/rootConfig.ts +7 -3
  408. package/src/adapters/biome/toolContractDefaults.ts +4 -5
  409. package/src/adapters/builtinName.ts +10 -0
  410. package/src/adapters/catalogWorkspace.ts +1 -1
  411. package/src/adapters/clientHandle.ts +11 -0
  412. package/src/adapters/commandLine.ts +10 -0
  413. package/src/adapters/contentHashedModule.ts +9 -0
  414. package/src/adapters/declarationTagParameter.ts +146 -0
  415. package/src/adapters/frameworkCallback.ts +1 -1
  416. package/src/adapters/freshObject.ts +61 -0
  417. package/src/adapters/imports/resolve.ts +2 -1
  418. package/src/adapters/knip/configuration.ts +12 -8
  419. package/src/adapters/knip/entryPointFindings.ts +7 -7
  420. package/src/adapters/knip/run.ts +2 -2
  421. package/src/adapters/knip/sourceConfig.ts +1 -3
  422. package/src/adapters/manifestInventory.ts +37 -32
  423. package/src/adapters/manifestReader.ts +4 -5
  424. package/src/adapters/manifestSorting.ts +8 -0
  425. package/src/adapters/outsideImportFindings.ts +8 -3
  426. package/src/adapters/plainFunction.ts +22 -0
  427. package/src/adapters/queueReadoutFindings.ts +1 -1
  428. package/src/adapters/repositoryPathFindings.ts +1 -1
  429. package/src/adapters/rule.ts +3 -4
  430. package/src/adapters/serviceIdFindings.ts +1 -1
  431. package/src/adapters/serviceModelSyntax.ts +1 -1
  432. package/src/adapters/sharedErrorFindings.ts +1 -1
  433. package/src/adapters/sharedErrorModules.ts +4 -3
  434. package/src/adapters/testProjects.ts +2 -2
  435. package/src/adapters/valueType.ts +18 -0
  436. package/src/appTestConfig.ts +4 -4
  437. package/src/baseline/format.ts +2 -2
  438. package/src/baseline/legacy.ts +2 -2
  439. package/src/baseline/looseStagedEntries.ts +2 -2
  440. package/src/baseline/merge.ts +1 -1
  441. package/src/biome/withoutEntryPointImports.ts +2 -2
  442. package/src/cli/args.ts +3 -6
  443. package/src/cli/migrateBaseline.ts +1 -3
  444. package/src/cli/migrateExceptions.ts +2 -2
  445. package/src/cli.ts +1 -1
  446. package/src/config/decode.ts +1 -1
  447. package/src/config/load.ts +1 -1
  448. package/src/decoded.ts +4 -6
  449. package/src/docs/importFindings.ts +5 -4
  450. package/src/docs/linkFindings.ts +8 -3
  451. package/src/engine/baselineFile.ts +1 -1
  452. package/src/engine/session.ts +3 -3
  453. package/src/exceptions/biomeFindings.ts +7 -3
  454. package/src/exceptions/declaration.ts +1 -1
  455. package/src/exceptions/registry.ts +2 -2
  456. package/src/hooks/preCommit.ts +5 -5
  457. package/src/imports/browserGlobals.ts +8 -2
  458. package/src/imports/browserNames.ts +13 -5
  459. package/src/imports/departures.ts +1 -1
  460. package/src/imports/fences/BoundaryFailure.ts +6 -0
  461. package/src/imports/fences/check.ts +1 -1
  462. package/src/imports/fences/discover.ts +41 -26
  463. package/src/imports/fences/match.ts +2 -1
  464. package/src/imports/globMatcher.ts +15 -21
  465. package/src/imports/graph.ts +1 -1
  466. package/src/imports/packageName.ts +1 -10
  467. package/src/imports/runtime.ts +3 -4
  468. package/src/imports/segmentsMatch.ts +19 -0
  469. package/src/imports/withoutGenerated.ts +1 -1
  470. package/src/imports/workspace.ts +25 -17
  471. package/src/manifests/entryPoints.ts +25 -13
  472. package/src/manifests/sorted.ts +5 -16
  473. package/src/naming/developmentCode.ts +2 -2
  474. package/src/naming/packageLayout.ts +6 -6
  475. package/src/naming/packageTests.ts +2 -2
  476. package/src/naming/testCode.ts +8 -11
  477. package/src/rule.ts +2 -2
  478. package/src/rules/biome.ts +1 -1
  479. package/src/rules/docs/references.ts +8 -15
  480. package/src/rules/docs/unversionedInstalls.ts +1 -4
  481. package/src/rules/effect/adapterImports.ts +1 -1
  482. package/src/rules/effect/boundary.ts +16 -19
  483. package/src/rules/effect/failureFindings.ts +12 -3
  484. package/src/rules/effect/failureHonesty.ts +3 -2
  485. package/src/rules/effect/serviceFindings.ts +7 -1
  486. package/src/rules/effect/serviceParameters.ts +3 -3
  487. package/src/rules/effect/serviceTypes.ts +15 -21
  488. package/src/rules/effect/successRecovery.ts +26 -0
  489. package/src/rules/files/packageImports.ts +3 -6
  490. package/src/rules/files/stylesheetImporters.ts +3 -6
  491. package/src/rules/imports/manifest.ts +6 -6
  492. package/src/rules/imports/runtime.ts +2 -3
  493. package/src/rules/manifestsApplication.ts +8 -9
  494. package/src/rules/manifestsDependencyPins.ts +1 -1
  495. package/src/rules/manifestsExportsShape.ts +2 -2
  496. package/src/rules/manifestsNoTestKits.ts +1 -4
  497. package/src/rules/manifestsSorted.ts +2 -2
  498. package/src/rules/manifestsSourceFirst.ts +1 -1
  499. package/src/rules/manifestsValid.ts +2 -3
  500. package/src/rules/stories/authSql.ts +1 -1
  501. package/src/rules/stories/engine.ts +1 -1
  502. package/src/rules/stories/prerequisites.ts +4 -3
  503. package/src/rules/stories/queueSql.ts +12 -9
  504. package/src/rules/stories/sources.ts +1 -1
  505. package/src/rules/stories/specs.ts +1 -1
  506. package/src/rules/stories/sqlText.ts +16 -12
  507. package/src/rules/suppressions/biome/declarations.ts +2 -2
  508. package/src/rules/suppressions/biomeOverrides.ts +1 -1
  509. package/src/rules/suppressions/noDoubleCast.ts +1 -1
  510. package/src/rules/suppressions/noInline.ts +15 -7
  511. package/src/rules/suppressions/readonlyWrite.ts +2 -1
  512. package/src/testing/adapters/cli.ts +1 -1
  513. package/src/testing/adapters/imports.ts +2 -2
  514. package/src/testing/adapters/run.ts +1 -1
  515. package/src/testing/adapters/tree.ts +4 -0
  516. package/src/testing/ruleStory.ts +1 -1
  517. package/dist/cli/runMain.d.ts.map +0 -1
  518. package/dist/cli/runMain.js.map +0 -1
  519. package/dist/domEnvironment.config.d.ts.map +0 -1
  520. package/dist/domEnvironment.config.js.map +0 -1
  521. package/dist/unitIoGuard.config.d.ts.map +0 -1
  522. package/dist/unitIoGuard.config.js.map +0 -1
  523. /package/dist/{domEnvironment.config.d.ts → adapters/domEnvironment.config.d.ts} +0 -0
  524. /package/dist/{domEnvironment.config.js → adapters/domEnvironment.config.js} +0 -0
  525. /package/dist/{cli → adapters}/runMain.d.ts +0 -0
  526. /package/dist/{cli → adapters}/runMain.js +0 -0
  527. /package/dist/{unitIoGuard.config.d.ts → adapters/unitIoGuard.config.d.ts} +0 -0
  528. /package/dist/{unitIoGuard.config.js → adapters/unitIoGuard.config.js} +0 -0
  529. /package/src/{domEnvironment.config.ts → adapters/domEnvironment.config.ts} +0 -0
  530. /package/src/{cli → adapters}/runMain.ts +0 -0
  531. /package/src/{unitIoGuard.config.ts → adapters/unitIoGuard.config.ts} +0 -0
@@ -1,5 +1,8 @@
1
1
  import { posix } from "node:path";
2
+ import { Effect } from "effect";
2
3
  import { resolvePackage } from "#adapters/biome/resolvePackage.ts";
4
+ import type { ManifestFailure } from "#adapters/manifestInventory.ts";
5
+ import type { FilesystemFailure } from "#inventory/filesystem.ts";
3
6
  import type { Finding, RuleInputs } from "#rule.ts";
4
7
  import { type Declaration, decodeShipped, PRESET_DECLARATIONS } from "#rules/suppressions/biome/declarations.ts";
5
8
  import { itemsOf, type Json, member, type Parsed, parseJsonc, textOf } from "#rules/suppressions/biome/json.ts";
@@ -39,70 +42,84 @@ function directoryOf(path: string): string {
39
42
  return posix.dirname(path) === "." ? "" : posix.dirname(path);
40
43
  }
41
44
 
42
- async function read(readText: ReadText, path: string): Promise<Parsed> {
43
- const text = await readText(path);
45
+ const read = Effect.fn("Biome.read")(function* (readText: ReadText, path: string): Effect.fn.Return<Parsed, FilesystemFailure> {
46
+ const text = yield* readText(path);
44
47
  return text === undefined ? { _tag: "Unreadable", reason: "the file does not exist" } : parseJsonc(path, text);
45
- }
48
+ });
46
49
 
47
50
  function problem(file: string, message: string, line?: number): Loaded {
48
51
  return { layers: [], problems: [{ file, line, message }] };
49
52
  }
50
53
 
51
- async function local(readText: ReadText, path: string): Promise<Loaded> {
52
- const parsed = await read(readText, path);
54
+ const local = Effect.fn("Biome.local")(function* (readText: ReadText, path: string): Effect.fn.Return<Loaded, FilesystemFailure> {
55
+ const parsed = yield* read(readText, path);
53
56
  return parsed._tag === "Parsed"
54
57
  ? { layers: [{ json: parsed.json, path, preset: undefined }], problems: [] }
55
58
  : problem(path, `Cannot read this Biome config: ${parsed.reason}.`);
56
- }
57
-
58
- async function fromPackage(readText: ReadText, from: string, entry: Json, specifier: string): Promise<Loaded> {
59
- const target = await resolvePackage(readText, specifier);
59
+ });
60
+
61
+ const fromPackage = Effect.fn("Biome.fromPackage")(function* (
62
+ readText: ReadText,
63
+ from: string,
64
+ entry: Json,
65
+ specifier: string,
66
+ ): Effect.fn.Return<Loaded, FilesystemFailure | ManifestFailure> {
67
+ const target = yield* resolvePackage(readText, specifier);
60
68
  if (target === undefined) {
61
69
  return problem(from, `Cannot resolve the Biome config "${specifier}" from node_modules.`, entry.line);
62
70
  }
63
- const parsed = await read(readText, target);
71
+ const parsed = yield* read(readText, target);
64
72
  if (parsed._tag === "Unreadable") {
65
73
  return problem(from, `Cannot read the Biome config "${specifier}" at ${target}: ${parsed.reason}.`, entry.line);
66
74
  }
67
75
  const shipped = posix.join(posix.dirname(target), PRESET_DECLARATIONS);
68
- const declared = await decodeShipped(await readText(shipped));
76
+ const declared = decodeShipped(yield* readText(shipped));
69
77
  if (declared._tag === "Invalid") {
70
78
  return problem(from, `Cannot read the declarations shipped with "${specifier}" at ${shipped}: ${declared.issues.join("; ")}.`, entry.line);
71
79
  }
72
80
  const preset = { declared: declared.value, file: from, line: entry.line, specifier };
73
81
  return { layers: [{ json: parsed.json, path: target, preset }], problems: [] };
74
- }
82
+ });
75
83
 
76
- async function extended(readText: ReadText, from: string, entry: Json): Promise<Loaded> {
84
+ const extended = Effect.fn("Biome.extended")(function* (
85
+ readText: ReadText,
86
+ from: string,
87
+ entry: Json,
88
+ ): Effect.fn.Return<Loaded, FilesystemFailure | ManifestFailure> {
77
89
  const specifier = textOf(entry);
78
90
  if (specifier === undefined || specifier === "//") {
79
91
  return { layers: [], problems: [] };
80
92
  }
81
93
  if (RELATIVE.test(specifier)) {
82
- return local(readText, posix.join(posix.dirname(from), specifier));
94
+ return yield* local(readText, posix.join(posix.dirname(from), specifier));
83
95
  }
84
96
  const relative = posix.normalize(specifier);
85
- return (await readText(relative)) === undefined ? fromPackage(readText, from, entry, specifier) : local(readText, relative);
86
- }
97
+ return yield* (yield* readText(relative)) === undefined ? fromPackage(readText, from, entry, specifier) : local(readText, relative);
98
+ });
87
99
 
88
100
  function extendsOf(json: Json): readonly Json[] {
89
101
  return itemsOf(member(json, "extends"));
90
102
  }
91
103
 
92
- async function chainOf(readText: ReadText, path: string): Promise<Loaded> {
93
- const own = await local(readText, path);
104
+ const chainOf = Effect.fn("Biome.chainOf")(function* (
105
+ readText: ReadText,
106
+ path: string,
107
+ ): Effect.fn.Return<Loaded, FilesystemFailure | ManifestFailure> {
108
+ const own = yield* local(readText, path);
94
109
  const [layer] = own.layers;
95
110
  if (layer === undefined) {
96
111
  return own;
97
112
  }
98
- const parents = await Promise.all(extendsOf(layer.json).map((entry) => extended(readText, path, entry)));
113
+ const parents = yield* Effect.forEach(extendsOf(layer.json), (entry) => extended(readText, path, entry), { concurrency: "unbounded" });
99
114
  return { layers: [...parents.flatMap((parent) => parent.layers), layer], problems: parents.flatMap((parent) => parent.problems) };
100
- }
115
+ });
101
116
 
102
- async function rootConfig(readText: ReadText): Promise<string | undefined> {
103
- const present = await Promise.all(ROOT_CONFIGS.map(async (path) => ((await readText(path)) === undefined ? [] : [path])));
117
+ const rootConfigPath = Effect.fn("Biome.rootConfigPath")(function* (readText: ReadText) {
118
+ const present = yield* Effect.forEach(ROOT_CONFIGS, (path) => Effect.map(readText(path), (text) => (text === undefined ? [] : [path])), {
119
+ concurrency: "unbounded",
120
+ });
104
121
  return present.flat()[0];
105
- }
122
+ });
106
123
 
107
124
  export interface BiomeConfigs {
108
125
  readonly chains: readonly Chain[];
@@ -110,16 +127,21 @@ export interface BiomeConfigs {
110
127
  readonly root: string;
111
128
  }
112
129
 
113
- export async function biomeConfigs({ files, readText }: RuleInputs): Promise<BiomeConfigs> {
114
- const root = await rootConfig(readText);
115
- const rootChain = root === undefined ? { layers: [], problems: [] } : await chainOf(readText, root);
130
+ export const biomeConfigs = Effect.fn("Biome.biomeConfigs")(function* ({
131
+ files,
132
+ readText,
133
+ }: RuleInputs): Effect.fn.Return<BiomeConfigs, FilesystemFailure | ManifestFailure> {
134
+ const root = yield* rootConfigPath(readText);
135
+ const rootChain = root === undefined ? { layers: [], problems: [] } : yield* chainOf(readText, root);
116
136
  const loaded = new Set(rootChain.layers.map((layer) => layer.path));
117
137
  const nested = files.filter((path) => NESTED.test(path) && path !== root && !loaded.has(path));
118
- const below = await Promise.all(nested.map(async (path) => ({ base: directoryOf(path), ...(await chainOf(readText, path)) })));
138
+ const below = yield* Effect.forEach(nested, (path) => Effect.map(chainOf(readText, path), (chain) => ({ base: directoryOf(path), ...chain })), {
139
+ concurrency: "unbounded",
140
+ });
119
141
  const all = [{ base: "", ...rootChain }, ...below];
120
142
  return {
121
143
  chains: all.filter((chain) => chain.layers.length > 0).map(({ base, layers }) => ({ base, layers })),
122
144
  problems: all.flatMap((chain) => chain.problems),
123
145
  root: root ?? "biome.json",
124
146
  };
125
- }
147
+ });
@@ -11,22 +11,22 @@ function problem(file: string, message: string): { readonly _tag: "Problem"; rea
11
11
  }
12
12
 
13
13
  export const presetConfig = Effect.fn("Biome.presetConfig")(function* (readText: RuleInputs["readText"]) {
14
- const root = yield* Effect.promise(() => rootConfig(readText));
14
+ const root = yield* rootConfig(readText);
15
15
  if (!root.extendsPreset) {
16
16
  return { _tag: "Skipped" } as const;
17
17
  }
18
- const path = yield* Effect.promise(() => resolvePackage(readText, PRESET));
18
+ const path = yield* resolvePackage(readText, PRESET);
19
19
  if (path === undefined) {
20
20
  return problem(root.path, `Cannot resolve "${PRESET}" from node_modules. Install @shivaedev/quality at the repository root.`);
21
21
  }
22
- const text = yield* Effect.promise(() => readText(path));
22
+ const text = yield* readText(path);
23
23
  const parsed = text === undefined ? undefined : parseJsonc(path, text);
24
24
  if (parsed?._tag !== "Parsed") {
25
25
  return problem(path, `Cannot read the preset "${PRESET}": ${parsed?.reason ?? "the file does not exist"}.`);
26
26
  }
27
27
  const declarationsPath = posix.join(posix.dirname(path), PRESET_DECLARATIONS);
28
- const declarationText = yield* Effect.promise(() => readText(declarationsPath));
29
- const declarations = yield* Effect.promise(() => decodeShipped(declarationText));
28
+ const declarationText = yield* readText(declarationsPath);
29
+ const declarations = decodeShipped(declarationText);
30
30
  if (declarations._tag === "Invalid") {
31
31
  return problem(declarationsPath, `Cannot read the declarations shipped with "${PRESET}": ${declarations.issues.join("; ")}.`);
32
32
  }
@@ -1,4 +1,5 @@
1
1
  import { posix } from "node:path";
2
+ import { Effect } from "effect";
2
3
  import { readPackageManifest } from "#adapters/manifestInventory.ts";
3
4
  import type { PackageManifest } from "#PackageManifest.ts";
4
5
  import type { RuleInputs } from "#rule.ts";
@@ -60,16 +61,16 @@ function fromDependency(directory: string, manifest: PackageManifest, subpath: s
60
61
  return subpath === "" ? undefined : posix.join(directory, subpath);
61
62
  }
62
63
 
63
- export async function resolvePackage(readText: RuleInputs["readText"], specifier: string): Promise<string | undefined> {
64
+ export const resolvePackage = Effect.fn("Biome.resolvePackage")(function* (readText: RuleInputs["readText"], specifier: string) {
64
65
  const { name, subpath = "" } = SPECIFIER.exec(specifier)?.groups ?? {};
65
66
  if (name === undefined) {
66
67
  return undefined;
67
68
  }
68
- const own = await readPackageManifest(readText, "package.json");
69
+ const own = yield* readPackageManifest(readText, "package.json");
69
70
  if (own?.name === name && own.exports !== undefined && subpath !== "") {
70
71
  return inPackage("", exported(own.exports, subpath));
71
72
  }
72
73
  const directory = posix.join("node_modules", name);
73
- const manifest = await readPackageManifest(readText, posix.join(directory, "package.json"));
74
+ const manifest = yield* readPackageManifest(readText, posix.join(directory, "package.json"));
74
75
  return manifest === undefined ? undefined : fromDependency(directory, manifest, subpath);
75
- }
76
+ });
@@ -1,3 +1,5 @@
1
+ import { Effect } from "effect";
2
+ import type { FilesystemFailure } from "#inventory/filesystem.ts";
1
3
  import type { RuleInputs } from "#rule.ts";
2
4
  import { itemsOf, member, parseJsonc, textOf } from "#rules/suppressions/biome/json.ts";
3
5
 
@@ -10,10 +12,12 @@ interface RootConfig {
10
12
  readonly path: string;
11
13
  }
12
14
 
13
- export async function rootConfig(readText: RuleInputs["readText"]): Promise<RootConfig> {
14
- const texts = await Promise.all(ROOT_CONFIGS.map(async (path) => ({ path, text: await readText(path) })));
15
+ export const rootConfig = Effect.fn("Biome.rootConfig")(function* (
16
+ readText: RuleInputs["readText"],
17
+ ): Effect.fn.Return<RootConfig, FilesystemFailure> {
18
+ const texts = yield* Effect.forEach(ROOT_CONFIGS, (path) => Effect.map(readText(path), (text) => ({ path, text })), { concurrency: "unbounded" });
15
19
  const found = texts.find((candidate) => candidate.text !== undefined);
16
20
  const parsed = found?.text === undefined ? undefined : parseJsonc(found.path, found.text);
17
21
  const extended = parsed?._tag === "Parsed" ? itemsOf(member(parsed.json, "extends")).map(textOf) : [];
18
22
  return { extendsPreset: extended.includes(PRESET), path: found?.path ?? "biome.json" };
19
- }
23
+ });
@@ -22,10 +22,9 @@ export const toolContractDefaults = Effect.fn("Biome.toolContractDefaults")(func
22
22
  }
23
23
  const readText = yield* manifestReader(root);
24
24
  const contracts = yield* Effect.forEach([...directories], (directory) =>
25
- Effect.promise(async () => {
26
- const manifest = await readPackageManifest(readText, join(directory, "package.json"));
27
- return vitestContractPaths(directory, manifest?.scripts ?? {}).map((path) => resolve(root, path));
28
- }),
25
+ Effect.map(readPackageManifest(readText, join(directory, "package.json")), (manifest) =>
26
+ vitestContractPaths(directory, manifest?.scripts ?? {}).map((path) => resolve(root, path)),
27
+ ),
29
28
  );
30
29
  return new Set(contracts.flat());
31
- }, Effect.scoped);
30
+ });
@@ -0,0 +1,10 @@
1
+ import { isBuiltin } from "node:module";
2
+
3
+ const NODE_PREFIX = "node:";
4
+
5
+ export function builtinName(specifier: string): string | undefined {
6
+ if (!isBuiltin(specifier)) {
7
+ return undefined;
8
+ }
9
+ return specifier.startsWith(NODE_PREFIX) ? specifier : `${NODE_PREFIX}${specifier}`;
10
+ }
@@ -6,7 +6,7 @@ export const catalogWorkspace = Effect.fn("Manifests.catalogWorkspace")(function
6
6
  let directory = root;
7
7
  for (;;) {
8
8
  const file = relative(root, join(directory, "pnpm-workspace.yaml")).split(sep).join("/");
9
- const text = yield* Effect.promise(() => readText(file));
9
+ const text = yield* readText(file);
10
10
  if (text !== undefined) {
11
11
  return { file, text };
12
12
  }
@@ -0,0 +1,11 @@
1
+ import type ts from "typescript";
2
+
3
+ // A registry or RPC client is the handle a plain function, which has no Effect environment, works through.
4
+ export function clientHandle(type: ts.Type): boolean {
5
+ return (
6
+ type.getProperty("~effect/reactivity/AtomRegistry") !== undefined
7
+ || (type.getProperty("mutation")?.declarations ?? []).some((declaration) =>
8
+ /\/effect\/(?:src|dist)\/reactivity\/AtomRpc\.(?:d\.)?ts$/u.test(declaration.getSourceFile().fileName.replaceAll("\\", "/")),
9
+ )
10
+ );
11
+ }
@@ -0,0 +1,10 @@
1
+ import { parseArgs } from "node:util";
2
+ import { Result } from "effect";
3
+ import { OPTIONS } from "#cli/misplaced.ts";
4
+
5
+ export function commandLine(args: readonly string[]) {
6
+ return Result.try({
7
+ catch: (error) => (error instanceof Error ? error.message : String(error)),
8
+ try: () => parseArgs({ allowPositionals: true, args: [...args], options: OPTIONS, strict: true }),
9
+ });
10
+ }
@@ -0,0 +1,9 @@
1
+ import { createHash } from "node:crypto";
2
+ import { pathToFileURL } from "node:url";
3
+
4
+ // Node caches a loaded module by URL, so an edited file only reloads under a URL its content changes.
5
+ export function contentHashedModule(path: string, text: string): string {
6
+ const url = pathToFileURL(path);
7
+ url.searchParams.set("content", createHash("sha256").update(text).digest("hex"));
8
+ return url.href;
9
+ }
@@ -0,0 +1,146 @@
1
+ import ts from "typescript";
2
+ import { declarationOf, resolvedValue } from "#adapters/serviceModelSyntax.ts";
3
+
4
+ const RPC_MIDDLEWARE = "~effect/rpc/RpcMiddleware";
5
+
6
+ function implementationParameter(checker: ts.TypeChecker, parameter: ts.ParameterDeclaration): ts.ParameterDeclaration {
7
+ const fn = parameter.parent;
8
+ if (!(ts.isFunctionDeclaration(fn) || ts.isMethodDeclaration(fn)) || fn.body !== undefined || fn.name === undefined) {
9
+ return parameter;
10
+ }
11
+ const implementation = checker
12
+ .getSymbolAtLocation(fn.name)
13
+ ?.declarations?.find(
14
+ (declaration) => (ts.isFunctionDeclaration(declaration) || ts.isMethodDeclaration(declaration)) && declaration.body !== undefined,
15
+ );
16
+ return implementation !== undefined && (ts.isFunctionDeclaration(implementation) || ts.isMethodDeclaration(implementation))
17
+ ? (implementation.parameters[fn.parameters.indexOf(parameter)] ?? parameter)
18
+ : parameter;
19
+ }
20
+
21
+ function functionBody(parameter: ts.ParameterDeclaration): ts.Node | undefined {
22
+ const fn = parameter.parent;
23
+ return ts.isFunctionDeclaration(fn) || ts.isFunctionExpression(fn) || ts.isArrowFunction(fn) || ts.isMethodDeclaration(fn) ? fn.body : undefined;
24
+ }
25
+
26
+ function contextPick(checker: ts.TypeChecker, callee: ts.Expression): boolean {
27
+ const declaration = declarationOf(checker, ts.isPropertyAccessExpression(callee) ? callee.name : callee);
28
+ return (
29
+ declaration !== undefined
30
+ && ts.isVariableDeclaration(declaration)
31
+ && declaration.name.getText() === "pick"
32
+ && /\/effect\/(?:src|dist(?:\/dts)?)\/Context\.(?:d\.)?ts$/u.test(declaration.getSourceFile().fileName.replaceAll("\\", "/"))
33
+ );
34
+ }
35
+
36
+ function middlewareMember(expression: ts.Expression): boolean {
37
+ return ts.isPropertyAccessExpression(expression) && expression.name.text === "middleware";
38
+ }
39
+
40
+ function middlewareCall(checker: ts.TypeChecker, callee: ts.Expression): boolean {
41
+ if (middlewareMember(callee)) {
42
+ return true;
43
+ }
44
+ const value = resolvedValue(checker, callee);
45
+ return (
46
+ ts.isCallExpression(value)
47
+ && ts.isPropertyAccessExpression(value.expression)
48
+ && value.expression.name.text === "bind"
49
+ && middlewareMember(value.expression.expression)
50
+ );
51
+ }
52
+
53
+ function referredSymbol(checker: ts.TypeChecker, node: ts.Identifier): ts.Symbol | undefined {
54
+ return ts.isShorthandPropertyAssignment(node.parent) ? checker.getShorthandAssignmentValueSymbol(node.parent) : checker.getSymbolAtLocation(node);
55
+ }
56
+
57
+ function everyReference(checker: ts.TypeChecker, body: ts.Node, name: ts.Identifier, permitted: (reference: ts.Identifier) => boolean): boolean {
58
+ const symbol = checker.getSymbolAtLocation(name);
59
+ function visit(node: ts.Node): boolean {
60
+ if (ts.isIdentifier(node) && node !== name && referredSymbol(checker, node) === symbol && !permitted(node)) {
61
+ return false;
62
+ }
63
+ return ts.forEachChild(node, (child) => !visit(child)) !== true;
64
+ }
65
+ return visit(body);
66
+ }
67
+
68
+ function calledMethod(checker: ts.TypeChecker, member: ts.Expression): boolean {
69
+ if (!(ts.isCallExpression(member.parent) && member.parent.expression === member)) {
70
+ return false;
71
+ }
72
+ return (
73
+ !ts.isPropertyAccessExpression(member)
74
+ || ((checker.getSymbolAtLocation(member.name)?.flags ?? ts.SymbolFlags.Method) & ts.SymbolFlags.Method) !== 0
75
+ );
76
+ }
77
+
78
+ export function declarationTagParameter(checker: ts.TypeChecker, carries: (type: ts.Type) => boolean) {
79
+ const known = new Map<ts.ParameterDeclaration, boolean>();
80
+ function middlewareTag(node: ts.Node): boolean {
81
+ return checker.getApparentType(checker.getTypeAtLocation(node)).getProperty(RPC_MIDDLEWARE) !== undefined;
82
+ }
83
+ function middlewareSignature(parameter: ts.ParameterDeclaration): boolean {
84
+ const member = ts.isFunctionTypeNode(parameter.parent) ? parameter.parent.parent : parameter.parent;
85
+ return (ts.isPropertySignature(member) || ts.isMethodSignature(member)) && member.name.getText() === "middleware" && middlewareTag(parameter);
86
+ }
87
+ function forwardsDeclaration(call: ts.CallExpression, argument: ts.Expression): boolean {
88
+ const target = checker.getResolvedSignature(call)?.declaration?.parameters[call.arguments.indexOf(argument)];
89
+ return target !== undefined && ts.isParameter(target) && !ts.isSpreadElement(argument) && declarationOnly(target);
90
+ }
91
+ function declares(value: ts.Expression): boolean {
92
+ const argument = ts.isSpreadElement(value.parent) ? value.parent : value;
93
+ const call = argument.parent;
94
+ if (!(ts.isCallExpression(call) && call.arguments.includes(argument))) {
95
+ return false;
96
+ }
97
+ return (
98
+ contextPick(checker, call.expression)
99
+ || (middlewareCall(checker, call.expression) && middlewareTag(value))
100
+ || forwardsDeclaration(call, argument)
101
+ );
102
+ }
103
+ function carrier(value: ts.Expression): ts.Expression {
104
+ const parent = value.parent;
105
+ if (ts.isNonNullExpression(parent) || ts.isParenthesizedExpression(parent)) {
106
+ return carrier(parent);
107
+ }
108
+ if ((ts.isPropertyAccessExpression(parent) || ts.isElementAccessExpression(parent)) && parent.expression === value) {
109
+ return carries(checker.getTypeAtLocation(parent)) ? carrier(parent) : parent;
110
+ }
111
+ return value;
112
+ }
113
+ function onlyDeclared(body: ts.Node, name: ts.BindingName, seen: { declared: boolean }): boolean {
114
+ if (!ts.isIdentifier(name)) {
115
+ return name.elements.every(
116
+ (element) => ts.isOmittedExpression(element) || !carries(checker.getTypeAtLocation(element.name)) || onlyDeclared(body, element.name, seen),
117
+ );
118
+ }
119
+ return everyReference(checker, body, name, (reference) => {
120
+ const value = carrier(reference);
121
+ if (!carries(checker.getTypeAtLocation(value))) {
122
+ return !calledMethod(checker, value);
123
+ }
124
+ if (ts.isVariableDeclaration(value.parent) && value.parent.initializer === value) {
125
+ return onlyDeclared(body, value.parent.name, seen);
126
+ }
127
+ const declaration = declares(value);
128
+ seen.declared ||= declaration;
129
+ return declaration;
130
+ });
131
+ }
132
+ function declarationOnly(declared: ts.ParameterDeclaration): boolean {
133
+ const parameter = implementationParameter(checker, declared);
134
+ const cached = known.get(parameter);
135
+ if (cached !== undefined) {
136
+ return cached;
137
+ }
138
+ known.set(parameter, false);
139
+ const body = functionBody(parameter);
140
+ const seen = { declared: false };
141
+ const result = middlewareSignature(parameter) || (body !== undefined && onlyDeclared(body, parameter.name, seen) && seen.declared);
142
+ known.set(parameter, result);
143
+ return result;
144
+ }
145
+ return declarationOnly;
146
+ }
@@ -8,7 +8,7 @@ function supplied(signature: ts.Signature, local: ReadonlySet<ts.SourceFile>): b
8
8
  return signature.declaration !== undefined && !local.has(signature.declaration.getSourceFile());
9
9
  }
10
10
 
11
- function wrapsEffectFunction(checker: ts.TypeChecker, expression: ts.Expression): boolean {
11
+ export function wrapsEffectFunction(checker: ts.TypeChecker, expression: ts.Expression): boolean {
12
12
  let callee = expression;
13
13
  let value: ts.Node = ts.isIdentifier(callee) ? resolvedValue(checker, callee) : callee;
14
14
  while (ts.isCallExpression(value)) {
@@ -0,0 +1,61 @@
1
+ import ts from "typescript";
2
+
3
+ function unparenthesized(node: ts.Expression): ts.Expression {
4
+ return ts.isParenthesizedExpression(node) ? unparenthesized(node.expression) : node;
5
+ }
6
+
7
+ function enclosingFunction(node: ts.Node): ts.Node | undefined {
8
+ for (let parent = node.parent; parent !== undefined; parent = parent.parent) {
9
+ if (ts.isFunctionLike(parent)) {
10
+ return parent;
11
+ }
12
+ }
13
+ return undefined;
14
+ }
15
+
16
+ function earlierWrite(node: ts.Identifier): boolean {
17
+ const call = node.parent;
18
+ return (
19
+ ts.isCallExpression(call)
20
+ && call.arguments[0] === node
21
+ && ts.isPropertyAccessExpression(call.expression)
22
+ && call.expression.expression.getText() === "Object"
23
+ && ["assign", "defineProperty"].includes(call.expression.name.text)
24
+ );
25
+ }
26
+
27
+ function usedBefore(checker: ts.TypeChecker, declaration: ts.VariableDeclaration, write: ts.Node): boolean {
28
+ const symbol = checker.getSymbolAtLocation(declaration.name);
29
+ function visit(node: ts.Node): boolean {
30
+ if (node.pos >= write.pos) {
31
+ return false;
32
+ }
33
+ if (ts.isIdentifier(node) && node !== declaration.name) {
34
+ const referred = ts.isShorthandPropertyAssignment(node.parent)
35
+ ? checker.getShorthandAssignmentValueSymbol(node.parent)
36
+ : checker.getSymbolAtLocation(node);
37
+ if (referred === symbol && !earlierWrite(node)) {
38
+ return true;
39
+ }
40
+ }
41
+ return ts.forEachChild(node, visit) ?? false;
42
+ }
43
+ return visit(declaration.getSourceFile());
44
+ }
45
+
46
+ export function freshObject(checker: ts.TypeChecker, write: ts.Node, target: ts.Expression): boolean {
47
+ const value = unparenthesized(target);
48
+ if (ts.isNewExpression(value)) {
49
+ return true;
50
+ }
51
+ const declaration = ts.isIdentifier(value) ? checker.getSymbolAtLocation(value)?.valueDeclaration : undefined;
52
+ return (
53
+ declaration !== undefined
54
+ && ts.isVariableDeclaration(declaration)
55
+ && (ts.getCombinedNodeFlags(declaration) & ts.NodeFlags.Const) !== 0
56
+ && declaration.initializer !== undefined
57
+ && ts.isNewExpression(unparenthesized(declaration.initializer))
58
+ && enclosingFunction(declaration) === enclosingFunction(write)
59
+ && !usedBefore(checker, declaration, write)
60
+ );
61
+ }
@@ -2,11 +2,12 @@ import { realpathSync } from "node:fs";
2
2
  import { createRequire } from "node:module";
3
3
  import { dirname, join, relative } from "node:path";
4
4
  import ts from "typescript";
5
+ import { builtinName } from "#adapters/builtinName.ts";
5
6
  import type { Project } from "#adapters/imports/projects.ts";
6
7
  import type { Ambient } from "#imports/ambient.ts";
7
8
  import type { Endpoint } from "#imports/Endpoint.ts";
8
9
  import type { ImportRequest } from "#imports/extract.ts";
9
- import { builtinName, nameAt, packageNameOf } from "#imports/packageName.ts";
10
+ import { nameAt, packageNameOf } from "#imports/packageName.ts";
10
11
  import { posix } from "#inventory/ignoreScope.ts";
11
12
 
12
13
  const NODE_MODULES = "/node_modules/";
@@ -1,5 +1,6 @@
1
1
  import { globSync, statSync } from "node:fs";
2
2
  import { join, posix } from "node:path";
3
+ import { Effect } from "effect";
3
4
  import { isToolConfig } from "#adapters/isToolConfig.ts";
4
5
  import { KNIP_ISSUES } from "#adapters/knip/findings.ts";
5
6
  import { mockEntries } from "#adapters/knip/mockEntries.ts";
@@ -47,18 +48,21 @@ function externalDependencies(manifest: PackageManifest, externals: ReadonlySet<
47
48
  return dependencies.filter((name) => externals.has(name));
48
49
  }
49
50
 
50
- export async function knipConfiguration(
51
+ export const knipConfiguration = Effect.fn("Knip.knipConfiguration")(function* (
51
52
  inputs: RuleInputs,
52
53
  toolOwned: readonly string[] = [],
53
54
  builds: ReachableBuilds = { entries: new Set(), externals: new Map() },
54
55
  declared: readonly string[] = declaredEntries(inputs),
55
56
  ) {
56
- const packages = await workspacePackages(inputs);
57
- const manifests = await Promise.all(
58
- [".", ...packages.map(({ directory }) => directory)].map(async (directory) => {
59
- const manifest = (await readPackageManifest(inputs.readText, posix.join(directory, "package.json"))) ?? {};
60
- return { directory, manifest };
61
- }),
57
+ const packages = yield* workspacePackages(inputs);
58
+ const manifests = yield* Effect.forEach(
59
+ [".", ...packages.map(({ directory }) => directory)],
60
+ (directory) =>
61
+ Effect.map(readPackageManifest(inputs.readText, posix.join(directory, "package.json")), (manifest) => ({
62
+ directory,
63
+ manifest: manifest ?? {},
64
+ })),
65
+ { concurrency: "unbounded" },
62
66
  );
63
67
  const scripted = new Set(manifests.flatMap(({ directory, manifest }) => scriptPaths(directory, manifest.scripts ?? {})));
64
68
  const mocked = new Set(mockEntries(inputs));
@@ -124,4 +128,4 @@ export async function knipConfiguration(
124
128
  tags: [],
125
129
  workspaces: Object.fromEntries(workspaces),
126
130
  };
127
- }
131
+ });
@@ -29,13 +29,13 @@ export const entryPointFindings = Effect.fn("Knip.entryPointFindings")(function*
29
29
  const workspace = new Map(graph.packages.map(({ name, directory }) => [name, directory]));
30
30
  const directories = [".", ...graph.packages.map(({ directory }) => directory)];
31
31
  const policies = new Map(
32
- yield* Effect.promise(() =>
33
- Promise.all(
34
- directories.map(async (directory) => {
35
- const manifest = await readPackageManifest(inputs.readText, posix.join(directory, "package.json"));
36
- return [directory, isApplication(manifest) ? await entryPointsOf(inputs, directory, manifest, workspace) : []] as const;
37
- }),
38
- ),
32
+ yield* Effect.forEach(
33
+ directories,
34
+ Effect.fnUntraced(function* (directory) {
35
+ const manifest = yield* readPackageManifest(inputs.readText, posix.join(directory, "package.json"));
36
+ return [directory, isApplication(manifest) ? yield* entryPointsOf(inputs, directory, manifest, workspace) : []] as const;
37
+ }),
38
+ { concurrency: "unbounded" },
39
39
  ),
40
40
  );
41
41
  function owner(path: string) {
@@ -23,13 +23,13 @@ import(api).then(() => { process.chdir(root); return import(entry); })
23
23
  .catch(error => { console.error(error); process.exitCode = 1; });
24
24
  `;
25
25
  export const runKnip = Effect.fn("Knip.runKnip")(function* (inputs: RuleInputs) {
26
- if ((yield* Effect.promise(() => readPackageManifest(inputs.readText, "package.json"))) === undefined) {
26
+ if ((yield* readPackageManifest(inputs.readText, "package.json")) === undefined) {
27
27
  return [];
28
28
  }
29
29
  const files = yield* toolOwnedFiles(inputs.root);
30
30
  const builds = yield* programmaticBuilds(inputs);
31
31
  const declared = declaredEntries(inputs);
32
- const configuration = yield* Effect.promise(() => knipConfiguration(inputs, files, builds, declared));
32
+ const configuration = yield* knipConfiguration(inputs, files, builds, declared);
33
33
  const checked = new Set([
34
34
  ...inputs.files,
35
35
  ...declared,
@@ -10,9 +10,7 @@ export const sourceConfig = Effect.fn("Knip.sourceConfig")(function* (inputs: Ru
10
10
  yield* fs.makeDirectory(folder, { recursive: true });
11
11
  yield* Effect.addFinalizer(() => fs.remove(folder, { recursive: true }).pipe(Effect.orDie));
12
12
  const parents = yield* Effect.forEach(["tsconfig.json", "tsconfig.build.json"], (file) =>
13
- Effect.promise(() => inputs.readText(posix.join(directory, file))).pipe(
14
- Effect.map((text) => (text === undefined ? [] : [resolve(inputs.root, directory, file)])),
15
- ),
13
+ inputs.readText(posix.join(directory, file)).pipe(Effect.map((text) => (text === undefined ? [] : [resolve(inputs.root, directory, file)]))),
16
14
  );
17
15
  yield* fs.writeFileString(join(folder, "tsconfig.json"), JSON.stringify({ extends: parents.flat(), files: [] }));
18
16
  }