@smoothbricks/nx-plugin 0.5.7 → 0.6.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 (446) hide show
  1. package/README.md +1097 -360
  2. package/dist/.build-inputs.json +141 -0
  3. package/dist/bin/smoo-nx-cargo-toolchain.d.ts +3 -0
  4. package/dist/bin/smoo-nx-cargo-toolchain.d.ts.map +1 -0
  5. package/dist/bin/smoo-nx-cargo-toolchain.js +8 -0
  6. package/dist/bin/smoo-nx-forbidden-spellings.d.ts +3 -0
  7. package/dist/bin/smoo-nx-forbidden-spellings.d.ts.map +1 -0
  8. package/dist/bin/smoo-nx-forbidden-spellings.js +32 -0
  9. package/dist/bin/smoo-nx-nextest-timings.d.ts +3 -0
  10. package/dist/bin/smoo-nx-nextest-timings.d.ts.map +1 -0
  11. package/dist/bin/smoo-nx-nextest-timings.js +28 -0
  12. package/dist/bounded-test-policy.d.ts +1 -1
  13. package/dist/bounded-test-policy.d.ts.map +1 -1
  14. package/dist/bounded-test-policy.js +14 -15
  15. package/dist/build-state-output-policy.d.ts +95 -1
  16. package/dist/build-state-output-policy.d.ts.map +1 -1
  17. package/dist/build-state-output-policy.js +368 -30
  18. package/dist/bun-lock-scope.d.ts +44 -0
  19. package/dist/bun-lock-scope.d.ts.map +1 -0
  20. package/dist/bun-lock-scope.js +97 -0
  21. package/dist/cargo-build-script-env.d.ts +49 -0
  22. package/dist/cargo-build-script-env.d.ts.map +1 -0
  23. package/dist/cargo-build-script-env.js +324 -0
  24. package/dist/cargo-closure-input.d.ts +31 -4
  25. package/dist/cargo-closure-input.d.ts.map +1 -1
  26. package/dist/cargo-closure-input.js +66 -6
  27. package/dist/cargo-retention-hook.d.ts +17 -0
  28. package/dist/cargo-retention-hook.d.ts.map +1 -0
  29. package/dist/cargo-retention-hook.js +85 -0
  30. package/dist/cargo-source-hash.d.ts +25 -7
  31. package/dist/cargo-source-hash.d.ts.map +1 -1
  32. package/dist/cargo-source-hash.js +108 -43
  33. package/dist/cargo-toolchain-paths.d.ts +40 -0
  34. package/dist/cargo-toolchain-paths.d.ts.map +1 -0
  35. package/dist/cargo-toolchain-paths.js +84 -0
  36. package/dist/cargo-toolchain-policy.d.ts +25 -8
  37. package/dist/cargo-toolchain-policy.d.ts.map +1 -1
  38. package/dist/cargo-toolchain-policy.js +39 -5
  39. package/dist/cargo-workspace.d.ts +10 -4
  40. package/dist/cargo-workspace.d.ts.map +1 -1
  41. package/dist/cargo-workspace.js +65 -95
  42. package/dist/cross-check-policy.d.ts +9 -9
  43. package/dist/cross-check-policy.d.ts.map +1 -1
  44. package/dist/cross-check-policy.js +11 -11
  45. package/dist/disk-command-policy.d.ts.map +1 -1
  46. package/dist/disk-command-policy.js +1 -0
  47. package/dist/ensure-built-receipt.d.ts +22 -5
  48. package/dist/ensure-built-receipt.d.ts.map +1 -1
  49. package/dist/ensure-built-receipt.js +168 -48
  50. package/dist/ensure-built-witness.d.ts +27 -8
  51. package/dist/ensure-built-witness.d.ts.map +1 -1
  52. package/dist/ensure-built-witness.js +45 -15
  53. package/dist/ensure-built.d.ts.map +1 -1
  54. package/dist/ensure-built.js +9 -1
  55. package/dist/eslint-config-closure.d.ts +7 -0
  56. package/dist/eslint-config-closure.d.ts.map +1 -0
  57. package/dist/eslint-config-closure.js +346 -0
  58. package/dist/executors/bounded-exec/bounds.d.ts +56 -0
  59. package/dist/executors/bounded-exec/bounds.d.ts.map +1 -0
  60. package/dist/executors/bounded-exec/bounds.js +43 -0
  61. package/dist/executors/bounded-exec/cpu-pool-thread.d.ts +28 -0
  62. package/dist/executors/bounded-exec/cpu-pool-thread.d.ts.map +1 -0
  63. package/dist/executors/bounded-exec/cpu-pool-thread.js +20 -0
  64. package/dist/executors/bounded-exec/cpu-pool.d.ts +35 -38
  65. package/dist/executors/bounded-exec/cpu-pool.d.ts.map +1 -1
  66. package/dist/executors/bounded-exec/cpu-pool.js +56 -120
  67. package/dist/executors/bounded-exec/executor.d.ts +19 -12
  68. package/dist/executors/bounded-exec/executor.d.ts.map +1 -1
  69. package/dist/executors/bounded-exec/executor.js +389 -239
  70. package/dist/executors/bounded-exec/gateway-lease.d.ts +23 -19
  71. package/dist/executors/bounded-exec/gateway-lease.d.ts.map +1 -1
  72. package/dist/executors/bounded-exec/gateway-lease.js +102 -29
  73. package/dist/executors/bounded-exec/hang-diagnostics.d.ts +18 -1
  74. package/dist/executors/bounded-exec/hang-diagnostics.d.ts.map +1 -1
  75. package/dist/executors/bounded-exec/hang-diagnostics.js +148 -30
  76. package/dist/executors/bounded-exec/lease-wait.d.ts +64 -0
  77. package/dist/executors/bounded-exec/lease-wait.d.ts.map +1 -0
  78. package/dist/executors/bounded-exec/lease-wait.js +72 -0
  79. package/dist/executors/bounded-exec/lock-wait.d.ts +51 -0
  80. package/dist/executors/bounded-exec/lock-wait.d.ts.map +1 -0
  81. package/dist/executors/bounded-exec/lock-wait.js +108 -0
  82. package/dist/executors/bounded-exec/mbx-pool.d.ts +31 -0
  83. package/dist/executors/bounded-exec/mbx-pool.d.ts.map +1 -0
  84. package/dist/executors/bounded-exec/mbx-pool.js +24 -0
  85. package/dist/executors/bounded-exec/owned-subtree.d.ts +84 -0
  86. package/dist/executors/bounded-exec/owned-subtree.d.ts.map +1 -0
  87. package/dist/executors/bounded-exec/owned-subtree.js +178 -0
  88. package/dist/executors/bounded-exec/progress.d.ts +4 -1
  89. package/dist/executors/bounded-exec/progress.d.ts.map +1 -1
  90. package/dist/executors/bounded-exec/progress.js +5 -2
  91. package/dist/executors/bounded-exec/ram-attach.d.ts +19 -0
  92. package/dist/executors/bounded-exec/ram-attach.d.ts.map +1 -0
  93. package/dist/executors/bounded-exec/ram-attach.js +207 -0
  94. package/dist/executors/bounded-exec/ram-detach.d.ts +25 -0
  95. package/dist/executors/bounded-exec/ram-detach.d.ts.map +1 -0
  96. package/dist/executors/bounded-exec/ram-detach.js +207 -0
  97. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts +76 -0
  98. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts.map +1 -1
  99. package/dist/executors/bounded-exec/ram-temp-fixtures.js +296 -0
  100. package/dist/executors/bounded-exec/ram-temp.d.ts +388 -88
  101. package/dist/executors/bounded-exec/ram-temp.d.ts.map +1 -1
  102. package/dist/executors/bounded-exec/ram-temp.js +1213 -399
  103. package/dist/executors/bounded-exec/run-cpu-pool.d.ts +10 -4
  104. package/dist/executors/bounded-exec/run-cpu-pool.d.ts.map +1 -1
  105. package/dist/executors/bounded-exec/run-cpu-pool.js +122 -35
  106. package/dist/executors/bounded-exec/runner-hook.js +14 -5
  107. package/dist/executors/bounded-exec/runner-lifecycle.d.ts +14 -1
  108. package/dist/executors/bounded-exec/runner-lifecycle.d.ts.map +1 -1
  109. package/dist/executors/bounded-exec/runner-lifecycle.js +27 -6
  110. package/dist/executors/bounded-exec/{cpu-tokens.d.ts → runner-sizing.d.ts} +14 -42
  111. package/dist/executors/bounded-exec/runner-sizing.d.ts.map +1 -0
  112. package/dist/executors/bounded-exec/{cpu-tokens.js → runner-sizing.js} +5 -35
  113. package/dist/executors/bounded-exec/runtime-pin.d.ts +73 -0
  114. package/dist/executors/bounded-exec/runtime-pin.d.ts.map +1 -0
  115. package/dist/executors/bounded-exec/runtime-pin.js +167 -0
  116. package/dist/executors/bounded-exec/schema.d.ts +18 -1
  117. package/dist/executors/bounded-exec/schema.d.ts.map +1 -1
  118. package/dist/executors/bounded-exec/verdict.d.ts +48 -11
  119. package/dist/executors/bounded-exec/verdict.d.ts.map +1 -1
  120. package/dist/executors/bounded-exec/verdict.js +89 -20
  121. package/dist/executors/cargo-zigbuild/executor.d.ts +21 -0
  122. package/dist/executors/cargo-zigbuild/executor.d.ts.map +1 -1
  123. package/dist/executors/cargo-zigbuild/executor.js +67 -12
  124. package/dist/executors/clean-outputs/executor.js +1 -0
  125. package/dist/executors/scriptc-native/executor.d.ts +79 -0
  126. package/dist/executors/scriptc-native/executor.d.ts.map +1 -0
  127. package/dist/executors/scriptc-native/executor.js +367 -0
  128. package/dist/executors/scriptc-native/ffi-paths.d.ts +9 -0
  129. package/dist/executors/scriptc-native/ffi-paths.d.ts.map +1 -0
  130. package/dist/executors/scriptc-native/ffi-paths.js +25 -0
  131. package/dist/executors/scriptc-native/schema.d.ts +34 -0
  132. package/dist/executors/scriptc-native/schema.d.ts.map +1 -0
  133. package/dist/executors/scriptc-native/schema.js +1 -0
  134. package/dist/executors/typescript-emit/emit-overrides.d.ts +14 -0
  135. package/dist/executors/typescript-emit/emit-overrides.d.ts.map +1 -0
  136. package/dist/executors/typescript-emit/emit-overrides.js +24 -0
  137. package/dist/executors/typescript-emit/executor.d.ts +3 -1
  138. package/dist/executors/typescript-emit/executor.d.ts.map +1 -1
  139. package/dist/executors/typescript-emit/executor.js +146 -33
  140. package/dist/forbidden-spelling-policy.d.ts +56 -0
  141. package/dist/forbidden-spelling-policy.d.ts.map +1 -0
  142. package/dist/forbidden-spelling-policy.js +176 -0
  143. package/dist/generators/create-package/generator.d.ts.map +1 -1
  144. package/dist/generators/create-package/generator.js +3 -4
  145. package/dist/graph-input-contract.d.ts +14 -0
  146. package/dist/graph-input-contract.d.ts.map +1 -1
  147. package/dist/graph-input-contract.js +67 -2
  148. package/dist/index.d.ts +23 -6
  149. package/dist/index.d.ts.map +1 -1
  150. package/dist/index.js +672 -214
  151. package/dist/managed-assets.d.ts +2 -0
  152. package/dist/managed-assets.d.ts.map +1 -1
  153. package/dist/managed-files/files.d.ts +3 -3
  154. package/dist/managed-files/files.d.ts.map +1 -1
  155. package/dist/managed-files/files.js +28 -3
  156. package/dist/managed-files/managed-format.d.ts.map +1 -1
  157. package/dist/managed-files/managed-format.js +1 -0
  158. package/dist/managed-files/publish-workflow.js +14 -11
  159. package/dist/nextest-code-bound.js +1 -0
  160. package/dist/nextest-timings.d.ts +35 -0
  161. package/dist/nextest-timings.d.ts.map +1 -0
  162. package/dist/nextest-timings.js +168 -0
  163. package/dist/owned-installation.d.ts +6 -5
  164. package/dist/owned-installation.d.ts.map +1 -1
  165. package/dist/owned-installation.js +150 -26
  166. package/dist/package-target-policy.d.ts.map +1 -1
  167. package/dist/package-target-policy.js +2 -3
  168. package/dist/process-children.d.ts +7 -0
  169. package/dist/process-children.d.ts.map +1 -0
  170. package/dist/process-children.darwin.d.ts +7 -0
  171. package/dist/process-children.darwin.d.ts.map +1 -0
  172. package/dist/process-children.darwin.js +13 -0
  173. package/dist/process-children.js +14 -0
  174. package/dist/process-children.linux.d.ts +8 -0
  175. package/dist/process-children.linux.d.ts.map +1 -0
  176. package/dist/process-children.linux.js +25 -0
  177. package/dist/process-group.d.ts +108 -0
  178. package/dist/process-group.d.ts.map +1 -0
  179. package/dist/process-group.js +171 -0
  180. package/dist/process-listing.d.ts +7 -0
  181. package/dist/process-listing.d.ts.map +1 -0
  182. package/dist/process-listing.js +51 -0
  183. package/dist/producer-receipts.d.ts +8 -2
  184. package/dist/producer-receipts.d.ts.map +1 -1
  185. package/dist/producer-receipts.js +514 -47
  186. package/dist/task-graph-policy.d.ts +21 -0
  187. package/dist/task-graph-policy.d.ts.map +1 -0
  188. package/dist/task-graph-policy.js +91 -0
  189. package/dist/test-timings.js +4 -4
  190. package/dist/test-walk-policy.d.ts +14 -5
  191. package/dist/test-walk-policy.d.ts.map +1 -1
  192. package/dist/test-walk-policy.js +8 -2
  193. package/dist/testing.d.ts +73 -28
  194. package/dist/testing.d.ts.map +1 -1
  195. package/dist/testing.js +217 -223
  196. package/dist/tool-bins.d.ts +33 -0
  197. package/dist/tool-bins.d.ts.map +1 -0
  198. package/dist/tool-bins.js +72 -0
  199. package/dist/typecheck-test-policy.d.ts.map +1 -1
  200. package/dist/typecheck-test-policy.js +3 -4
  201. package/dist/wait-why-policy.d.ts +28 -0
  202. package/dist/wait-why-policy.d.ts.map +1 -0
  203. package/dist/wait-why-policy.js +223 -0
  204. package/dist/workspace-config-policy.d.ts +14 -8
  205. package/dist/workspace-config-policy.d.ts.map +1 -1
  206. package/dist/workspace-config-policy.js +60 -16
  207. package/dist/workspace-manifest.d.ts +41 -6
  208. package/dist/workspace-manifest.d.ts.map +1 -1
  209. package/dist/workspace-manifest.js +57 -0
  210. package/executors.json +16 -1
  211. package/loader.js +2 -0
  212. package/managed/raw/envrc +11 -0
  213. package/managed/raw/patches/nx@23.2.1.patch +2840 -199
  214. package/managed/raw/patches/ttsc@0.34.1.patch +119 -0
  215. package/managed/raw/tooling/direnv/cargo-fetch-bound.ts +245 -0
  216. package/managed/raw/tooling/direnv/cargo-fetch-run.ts +299 -0
  217. package/managed/raw/tooling/direnv/compiler-variables.sh +42 -0
  218. package/managed/raw/tooling/direnv/developer-links.ts +464 -25
  219. package/managed/raw/tooling/direnv/devenv.smoo.nix +78 -38
  220. package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +14 -12
  221. package/managed/raw/tooling/direnv/installed-bun-links.ts +308 -0
  222. package/managed/raw/tooling/direnv/linked-snapshots.ts +62 -3
  223. package/managed/raw/tooling/direnv/nx-socket-dir.sh +56 -17
  224. package/managed/raw/tooling/direnv/repo-path +68 -6
  225. package/managed/raw/tooling/direnv/secret-references.ts +13 -4
  226. package/managed/raw/tooling/direnv/setup-environment.ts +128 -537
  227. package/managed/raw/tooling/direnv/toolchain-stamp.ts +4 -2
  228. package/managed/raw/tooling/direnv/ttsc-env.sh +9 -0
  229. package/managed/raw/tooling/direnv/uv-relocation.ts +227 -0
  230. package/managed/raw/tooling/git-hooks/commit-msg.sh +2 -1
  231. package/managed/raw/tooling/git-hooks/pre-commit.sh +2 -1
  232. package/managed/raw/tooling/git-hooks/pre-push.sh +2 -1
  233. package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +85 -7
  234. package/managed/templates/github/actions/save-nix-devenv/action.yml +12 -2
  235. package/managed/templates/github/actions/setup-devenv/action.yml +2 -0
  236. package/package.json +95 -14
  237. package/src/bin/smoo-nx-cargo-toolchain.ts +11 -0
  238. package/src/bin/smoo-nx-forbidden-spellings.ts +33 -0
  239. package/src/bin/smoo-nx-nextest-timings.ts +31 -0
  240. package/src/bounded-test-policy.ts +12 -14
  241. package/src/build-state-output-policy.ts +458 -34
  242. package/src/bun-lock-scope.ts +108 -0
  243. package/src/cargo-build-script-env.ts +265 -0
  244. package/src/cargo-closure-input.ts +74 -7
  245. package/src/cargo-retention-hook.ts +94 -0
  246. package/src/cargo-source-hash.ts +138 -41
  247. package/src/cargo-toolchain-paths.ts +95 -0
  248. package/src/cargo-toolchain-policy.ts +49 -5
  249. package/src/cargo-workspace.ts +72 -123
  250. package/src/cross-check-policy.ts +12 -10
  251. package/src/disk-command-policy.ts +1 -0
  252. package/src/ensure-built-receipt.ts +173 -39
  253. package/src/ensure-built-witness.ts +62 -10
  254. package/src/ensure-built.ts +11 -1
  255. package/src/eslint-config-closure.ts +357 -0
  256. package/src/executors/bounded-exec/bounds.ts +76 -0
  257. package/src/executors/bounded-exec/cpu-pool-thread.ts +43 -0
  258. package/src/executors/bounded-exec/cpu-pool.ts +55 -120
  259. package/src/executors/bounded-exec/executor.ts +442 -260
  260. package/src/executors/bounded-exec/gateway-lease.ts +94 -35
  261. package/src/executors/bounded-exec/hang-diagnostics.ts +173 -31
  262. package/src/executors/bounded-exec/lease-wait.ts +116 -0
  263. package/src/executors/bounded-exec/lock-wait.ts +141 -0
  264. package/src/executors/bounded-exec/mbx-pool.ts +48 -0
  265. package/src/executors/bounded-exec/owned-subtree.ts +235 -0
  266. package/src/executors/bounded-exec/progress.ts +9 -3
  267. package/src/executors/bounded-exec/ram-attach.ts +238 -0
  268. package/src/executors/bounded-exec/ram-detach.ts +226 -0
  269. package/src/executors/bounded-exec/ram-temp-fixtures.ts +358 -0
  270. package/src/executors/bounded-exec/ram-temp-registry.txt +440 -0
  271. package/src/executors/bounded-exec/ram-temp.ts +1497 -460
  272. package/src/executors/bounded-exec/run-cpu-pool.ts +129 -35
  273. package/src/executors/bounded-exec/runner-hook.ts +14 -6
  274. package/src/executors/bounded-exec/runner-lifecycle.ts +31 -8
  275. package/src/executors/bounded-exec/{cpu-tokens.ts → runner-sizing.ts} +13 -59
  276. package/src/executors/bounded-exec/runtime-pin.ts +232 -0
  277. package/src/executors/bounded-exec/schema.json +11 -2
  278. package/src/executors/bounded-exec/schema.ts +19 -1
  279. package/src/executors/bounded-exec/verdict.ts +145 -35
  280. package/src/executors/cargo-zigbuild/executor.ts +82 -8
  281. package/src/executors/clean-outputs/executor.ts +1 -0
  282. package/src/executors/scriptc-native/executor.ts +394 -0
  283. package/src/executors/scriptc-native/ffi-paths.ts +29 -0
  284. package/src/executors/scriptc-native/schema.json +60 -0
  285. package/src/executors/scriptc-native/schema.ts +34 -0
  286. package/src/executors/typescript-emit/emit-overrides.ts +24 -0
  287. package/src/executors/typescript-emit/executor.ts +186 -38
  288. package/src/forbidden-spelling-policy.ts +226 -0
  289. package/src/generators/create-package/generator.ts +7 -7
  290. package/src/graph-input-contract.ts +61 -2
  291. package/src/index.ts +788 -224
  292. package/src/managed-assets.ts +3 -0
  293. package/src/managed-files/files.ts +28 -3
  294. package/src/managed-files/managed-format.ts +1 -0
  295. package/src/managed-files/publish-workflow.ts +20 -15
  296. package/src/nextest-code-bound.ts +1 -0
  297. package/src/nextest-timings.ts +106 -0
  298. package/src/owned-installation.ts +150 -23
  299. package/src/package-target-policy.ts +2 -3
  300. package/src/process-children.darwin.ts +14 -0
  301. package/src/process-children.linux.ts +33 -0
  302. package/src/process-children.ts +22 -0
  303. package/src/process-group.ts +209 -0
  304. package/src/process-listing.ts +54 -0
  305. package/src/producer-receipts.ts +92 -41
  306. package/src/task-graph-policy.ts +98 -0
  307. package/src/test-walk-policy.ts +23 -8
  308. package/src/testing.ts +240 -232
  309. package/src/tool-bins.ts +108 -0
  310. package/src/typecheck-test-policy.ts +2 -3
  311. package/src/wait-why-policy.ts +226 -0
  312. package/src/workspace-config-policy.ts +63 -15
  313. package/src/workspace-manifest.ts +89 -6
  314. package/test-timings.json +124 -99
  315. package/dist/bin/smoo-nx-failures.d.ts +0 -3
  316. package/dist/bin/smoo-nx-failures.d.ts.map +0 -1
  317. package/dist/bin/smoo-nx-failures.js +0 -3
  318. package/dist/bin/smoo-nx-nextest-extract.d.ts +0 -3
  319. package/dist/bin/smoo-nx-nextest-extract.d.ts.map +0 -1
  320. package/dist/bin/smoo-nx-nextest-extract.js +0 -42
  321. package/dist/executors/bounded-exec/cpu-tokens.d.ts.map +0 -1
  322. package/dist/failure-summary.d.ts +0 -5
  323. package/dist/failure-summary.d.ts.map +0 -1
  324. package/dist/failure-summary.js +0 -118
  325. package/dist/nextest-extraction.d.ts +0 -117
  326. package/dist/nextest-extraction.d.ts.map +0 -1
  327. package/dist/nextest-extraction.js +0 -303
  328. package/managed/raw/patches/ttsc@0.30.4.patch +0 -2255
  329. package/src/__tests__/cargo-closure-filesets.ts +0 -94
  330. package/src/__tests__/cargo-closure-fixture.ts +0 -113
  331. package/src/__tests__/counted-cargo-process.ts +0 -286
  332. package/src/__tests__/counted-cargo.ts +0 -713
  333. package/src/__tests__/directory-change.ts +0 -27
  334. package/src/__tests__/fixture-cargo-home.ts +0 -36
  335. package/src/__tests__/fixture-nx-env.ts +0 -193
  336. package/src/__tests__/owned-installation.ts +0 -13
  337. package/src/__tests__/past-tick.ts +0 -12
  338. package/src/__tests__/progress-clock.ts +0 -43
  339. package/src/__tests__/runtime-input.ts +0 -23
  340. package/src/bin/smoo-nx-bound-failures.test.ts +0 -127
  341. package/src/bin/smoo-nx-failures.ts +0 -4
  342. package/src/bin/smoo-nx-nextest-extract.ts +0 -44
  343. package/src/bounded-test-policy.test.ts +0 -1029
  344. package/src/build-state-output-policy.test.ts +0 -115
  345. package/src/bun-bootstrap.test.ts +0 -102
  346. package/src/bun-file-packages.test.ts +0 -47
  347. package/src/cargo-closure-filesets.test.ts +0 -63
  348. package/src/cargo-closure-input.property.test.ts +0 -50
  349. package/src/cargo-closure-input.test.ts +0 -506
  350. package/src/cargo-closure-key.test.ts +0 -240
  351. package/src/cargo-resolve-cache.test.ts +0 -1181
  352. package/src/cargo-source-hash.test.ts +0 -707
  353. package/src/cargo-workspace.test.ts +0 -615
  354. package/src/cross-check-policy.test.ts +0 -316
  355. package/src/disk-command-policy.test.ts +0 -61
  356. package/src/ensure-built-receipt.test.ts +0 -279
  357. package/src/ensure-built-witness.test.ts +0 -688
  358. package/src/ensure-built.test.ts +0 -1462
  359. package/src/executors/all-verdicts/executor.test.ts +0 -135
  360. package/src/executors/bounded-exec/cargo-progress-host.test.ts +0 -332
  361. package/src/executors/bounded-exec/cpu-pool.test.ts +0 -684
  362. package/src/executors/bounded-exec/cpu-tokens.test.ts +0 -519
  363. package/src/executors/bounded-exec/disk-lease.test.ts +0 -219
  364. package/src/executors/bounded-exec/executor-host.test.ts +0 -800
  365. package/src/executors/bounded-exec/executor.test.ts +0 -1819
  366. package/src/executors/bounded-exec/go-progress-host.test.ts +0 -171
  367. package/src/executors/bounded-exec/hang-diagnostics.test.ts +0 -291
  368. package/src/executors/bounded-exec/progress.test.ts +0 -139
  369. package/src/executors/bounded-exec/ram-temp-held.test.ts +0 -264
  370. package/src/executors/bounded-exec/ram-temp-host.test.ts +0 -635
  371. package/src/executors/bounded-exec/ram-temp.test.ts +0 -750
  372. package/src/executors/bounded-exec/run-cpu-pool.test.ts +0 -79
  373. package/src/executors/bounded-exec/runner-hook.test.ts +0 -193
  374. package/src/executors/bounded-exec/runner-lifecycle.test.ts +0 -82
  375. package/src/executors/bounded-exec/verdict.test.ts +0 -545
  376. package/src/executors/cargo-zigbuild/executor.test.ts +0 -129
  377. package/src/executors/clean-outputs/executor.test.ts +0 -20
  378. package/src/executors/typescript-emit/executor.test.ts +0 -83
  379. package/src/failure-summary.ts +0 -119
  380. package/src/generators/bounded-test-targets/generator.test.ts +0 -138
  381. package/src/generators/bun-test-tracing/generator.test.ts +0 -250
  382. package/src/generators/create-package/generator.test.ts +0 -190
  383. package/src/generators/make-public/generator.test.ts +0 -137
  384. package/src/graph-input-contract.test.ts +0 -379
  385. package/src/host-controller-wiring.test.ts +0 -31
  386. package/src/index.test.ts +0 -3321
  387. package/src/linked-snapshots.nx.test.ts +0 -254
  388. package/src/managed-files/forgejo-artifact.test.ts +0 -395
  389. package/src/managed-files/generator.test.ts +0 -243
  390. package/src/managed-files/github-host-cache-isolation.test.ts +0 -86
  391. package/src/managed-files/json-edit.test.ts +0 -216
  392. package/src/managed-files/managed-content.test.ts +0 -166
  393. package/src/managed-files/managed-format-json.test.ts +0 -308
  394. package/src/managed-files/repo-path.test.ts +0 -172
  395. package/src/managed-files/setup-devenv-free-disk.test.ts +0 -95
  396. package/src/managed-files/trace-db-artifact.test.ts +0 -7
  397. package/src/managed-files/tree-permissions.test.ts +0 -109
  398. package/src/managed-files/tree.test.ts +0 -123
  399. package/src/manifest-hash.test.ts +0 -219
  400. package/src/nextest-code-bound.test.ts +0 -161
  401. package/src/nextest-extraction.test.ts +0 -216
  402. package/src/nextest-extraction.ts +0 -371
  403. package/src/nextest-partitions.test.ts +0 -501
  404. package/src/nx-cache-bound.test.ts +0 -109
  405. package/src/nx-cache-restore-mtime.test.ts +0 -170
  406. package/src/nx-daemon-claim.test.ts +0 -279
  407. package/src/nx-daemon-idle-cpu.test.ts +0 -80
  408. package/src/nx-daemon-idle-policy.test.ts +0 -111
  409. package/src/nx-daemon-ignore-files.test.ts +0 -210
  410. package/src/nx-daemon-root-normalization.test.ts +0 -105
  411. package/src/nx-daemon-start-never.test.ts +0 -292
  412. package/src/nx-daemon-validity.test.ts +0 -1055
  413. package/src/nx-dot-input-policy.test.ts +0 -353
  414. package/src/nx-failure-life-cycles.test.ts +0 -207
  415. package/src/nx-files-archive-racy.test.ts +0 -97
  416. package/src/nx-foreign-workspace-env.test.ts +0 -329
  417. package/src/nx-incomplete-run-summary.test.ts +0 -70
  418. package/src/nx-plugin-load-errors.test.ts +0 -120
  419. package/src/nx-project-graph-errors.test.ts +0 -70
  420. package/src/nx-project-resolution-cache.test.ts +0 -176
  421. package/src/nx-raw-inputs.test.ts +0 -166
  422. package/src/nx-resident-graph-workers.test.ts +0 -112
  423. package/src/nx-run-information.test.ts +0 -118
  424. package/src/nx-skipped-task-exit.test.ts +0 -180
  425. package/src/nx-state-location.test.ts +0 -63
  426. package/src/nx-store-resolution.test.ts +0 -81
  427. package/src/nx-task-graph-cycles.test.ts +0 -148
  428. package/src/nx-task-output-lease.test.ts +0 -550
  429. package/src/nx-use-local.test.ts +0 -105
  430. package/src/owned-installation.test.ts +0 -105
  431. package/src/package-target-policy.test.ts +0 -1014
  432. package/src/producer-receipts.test.ts +0 -285
  433. package/src/release-config-policy.test.ts +0 -311
  434. package/src/runtime-input.test.ts +0 -393
  435. package/src/serial-group-wiring.test.ts +0 -326
  436. package/src/task-history-namespace.test.ts +0 -181
  437. package/src/task-results.test.ts +0 -228
  438. package/src/test-clock-policy.test.ts +0 -338
  439. package/src/test-program.test.ts +0 -303
  440. package/src/test-timings.test.ts +0 -240
  441. package/src/test-walk-policy.test.ts +0 -620
  442. package/src/testing.test.ts +0 -509
  443. package/src/typecheck-test-policy.test.ts +0 -1468
  444. package/src/typescript-resolution.test.ts +0 -76
  445. package/src/version-actions.test.ts +0 -80
  446. package/src/workspace-config-policy.test.ts +0 -737
@@ -1,8 +1,17 @@
1
1
  import { spawn } from 'node:child_process';
2
- import { realpathSync } from 'node:fs';
2
+ import { existsSync, readFileSync, realpathSync } from 'node:fs';
3
3
  import { chmod, copyFile, mkdir, rename } from 'node:fs/promises';
4
4
  import path from 'node:path';
5
5
  import { createInterface } from 'node:readline';
6
+ import {
7
+ type BuildInputProducer,
8
+ type BuildInputRecord,
9
+ buildInputProducer,
10
+ cargoBuildInputs,
11
+ gitWorkspaceRoot,
12
+ writeBuildInputs,
13
+ } from '@smoothbricks/build-inputs';
14
+ import { cargoWorkspace, describeRetentionError, type Result } from '@smoothbricks/cargo-retain';
6
15
  import typia from 'typia';
7
16
 
8
17
  import type { CargoZigbuildOptions } from './schema.js';
@@ -113,10 +122,69 @@ export function artifactFile(line: string, manifestPath: string, artifact: Zigbu
113
122
  return data.filenames.find((file) => file.endsWith('.so')) ?? null;
114
123
  }
115
124
 
125
+ /**
126
+ * The dep-info file cargo uplifts beside an artifact, which lists every source rustc read for it: the artifact's file
127
+ * name with any extension replaced by `.d`. The static CLI `cowshed` has none (`cowshed.d`); the addon
128
+ * `libcowshed_napi.so` loses its `.so`.
129
+ */
130
+ export function depInfoPath(built: string): string {
131
+ const { dir, name } = path.parse(built);
132
+ return path.join(dir, `${name}.d`);
133
+ }
134
+
135
+ /**
136
+ * The input record (build-inputs.ts) of the build that wrote `built`, or why none can be made: the record
137
+ * `smoo-nx-build-inputs` writes after a macOS build, from the dep-info beside the artifact, so one link check judges
138
+ * both. `cargoRoot` is the Cargo workspace root, whose manifest and lock the record names as well. `producer` is the
139
+ * Nx task running the build, which the executor reads from its environment.
140
+ */
141
+ export function buildInputsOf(
142
+ built: string,
143
+ manifestPath: string,
144
+ cargoRoot: string,
145
+ producer?: BuildInputProducer,
146
+ ): Result<BuildInputRecord, string> {
147
+ const directory = path.dirname(manifestPath);
148
+ const workspaceRoot = gitWorkspaceRoot(directory);
149
+ if (workspaceRoot === null) {
150
+ return { ok: false, error: `${directory} is not in a Git work tree, so no input can be named` };
151
+ }
152
+ const depInfo = depInfoPath(built);
153
+ if (!existsSync(depInfo)) {
154
+ return { ok: false, error: `${depInfo} does not exist: cargo wrote no dep-info beside ${built}` };
155
+ }
156
+ const record = cargoBuildInputs(workspaceRoot, readFileSync(depInfo, 'utf8'), cargoRoot, producer);
157
+ if (record === null) return { ok: false, error: `${depInfo} names no file of ${workspaceRoot}` };
158
+ return { ok: true, value: record };
159
+ }
160
+
161
+ /**
162
+ * Writes the artifact and its input record into the directory `output` is in, which the target declares as its Nx
163
+ * output (`{options.output}/../`), so a cache hit restores both. The artifact is copied then renamed, so the output
164
+ * path never holds a partial file, and the record follows it.
165
+ */
166
+ export async function publishArtifact(
167
+ built: string,
168
+ output: string,
169
+ artifact: ZigbuildArtifact,
170
+ inputs: BuildInputRecord,
171
+ ): Promise<void> {
172
+ const directory = path.dirname(output);
173
+ await mkdir(directory, { recursive: true });
174
+ const staging = `${output}.partial`;
175
+ await copyFile(built, staging);
176
+ if (artifact.kind === 'bin') {
177
+ await chmod(staging, 0o755);
178
+ }
179
+ await rename(staging, output);
180
+ writeBuildInputs(directory, inputs);
181
+ }
182
+
116
183
  export default async function cargoZigbuildExecutor(
117
184
  options: CargoZigbuildOptions,
118
185
  context: CargoZigbuildContext,
119
186
  ): Promise<{ success: boolean }> {
187
+ const producer = buildInputProducer(process.env);
120
188
  const manifestPath = realpathSync(path.resolve(context.root, options.manifestPath));
121
189
  const output = path.resolve(context.root, options.output);
122
190
  const artifact = zigbuildArtifact(options);
@@ -130,6 +198,7 @@ export default async function cargoZigbuildExecutor(
130
198
  env: zigbuildEnv(process.env, options.target),
131
199
  stdio: ['ignore', 'pipe', 'inherit'],
132
200
  });
201
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: a cargo-zigbuild build lasts as long as its work; the operator's interrupt or the enclosing runner's bound ends a hung one
133
202
  const exited = new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {
134
203
  child.once('error', reject);
135
204
  child.once('close', (code, signal) => resolve({ code, signal }));
@@ -163,14 +232,19 @@ export default async function cargoZigbuildExecutor(
163
232
  return { success: false };
164
233
  }
165
234
 
166
- // Copy then rename, so the output path never holds a partial file.
167
- await mkdir(path.dirname(output), { recursive: true });
168
- const staging = `${output}.partial`;
169
- await copyFile(built, staging);
170
- if (artifact.kind === 'bin') {
171
- await chmod(staging, 0o755);
235
+ // From the dep-info cargo just wrote, before the artifact is copied: a build whose inputs cannot be named leaves the
236
+ // output as it was, and a source edited while the artifact is copied is not recorded with its new bytes.
237
+ const cargo = await cargoWorkspace(path.dirname(manifestPath));
238
+ if (!cargo.ok) {
239
+ console.error(`${command}: ${describeRetentionError(cargo.error)}`);
240
+ return { success: false };
172
241
  }
173
- await rename(staging, output);
242
+ const inputs = buildInputsOf(built, manifestPath, cargo.value.workspaceRoot, producer);
243
+ if (!inputs.ok) {
244
+ console.error(`${command}: ${inputs.error}`);
245
+ return { success: false };
246
+ }
247
+ await publishArtifact(built, output, artifact, inputs.value);
174
248
  console.log(`${path.relative(context.root, built)} -> ${path.relative(context.root, output)}`);
175
249
  return { success: true };
176
250
  }
@@ -107,6 +107,7 @@ function isWithin(candidate: string, parent: string): boolean {
107
107
 
108
108
  function containsTrackedFiles(outputDir: string, workspaceRoot: string): boolean {
109
109
  const relativeOutputDir = path.relative(workspaceRoot, outputDir);
110
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: a local git file listing whose length is its own read of this repository: it asks no remote, and a held index.lock fails it at once rather than waiting, so only the operator's interrupt ends a hung one
110
111
  const result = spawnSync('git', ['ls-files', '--', relativeOutputDir], {
111
112
  cwd: workspaceRoot,
112
113
  encoding: 'utf8',
@@ -0,0 +1,394 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { randomUUID } from 'node:crypto';
3
+ import { once } from 'node:events';
4
+ import { readdirSync, readFileSync } from 'node:fs';
5
+ import { copyFile, mkdir, rm, writeFile } from 'node:fs/promises';
6
+ import { createRequire } from 'node:module';
7
+ import { dirname, isAbsolute, join, relative } from 'node:path';
8
+
9
+ import ts from 'typescript';
10
+ import typia from 'typia';
11
+
12
+ import { isRecord } from '../../type-guards.js';
13
+ import { ffiPathProblem } from './ffi-paths.js';
14
+ import type { ScriptcNativeFfi, ScriptcNativeOptions } from './schema.js';
15
+
16
+ interface ScriptcNativeContext {
17
+ root: string;
18
+ }
19
+
20
+ interface ScriptcNativeResult {
21
+ success: boolean;
22
+ }
23
+
24
+ /** One ttsc emit of the package's `tsconfig` (an overlay of its `tsconfig.lib.json`) into `outDir`. */
25
+ export interface EmitInvocation {
26
+ readonly tsconfig: string;
27
+ readonly outDir: string;
28
+ readonly cwd: string;
29
+ }
30
+
31
+ /** One `scriptc build`: the emitted entry module and the executable it links for `triple`, run from the project root. */
32
+ export interface ScriptcInvocation {
33
+ readonly entry: string;
34
+ readonly output: string;
35
+ readonly cwd: string;
36
+ readonly triple: string;
37
+ /** The staged FFI manifest, when the package calls C. */
38
+ readonly ffi?: string;
39
+ }
40
+
41
+ /** One C compile for `triple`: `sources` into the static archive `archive`, run from the project root. */
42
+ export interface ArchiveInvocation {
43
+ readonly sources: readonly string[];
44
+ readonly archive: string;
45
+ readonly cwd: string;
46
+ readonly triple: string;
47
+ }
48
+ export interface ScriptcRunner {
49
+ emit(invocation: EmitInvocation): Promise<boolean>;
50
+ archive(invocation: ArchiveInvocation): Promise<boolean>;
51
+ build(invocation: ScriptcInvocation): Promise<boolean>;
52
+ }
53
+
54
+ /** A typia call the transform left in emitted JavaScript: it throws at run time instead of validating. */
55
+ export interface UntransformedTypiaCall {
56
+ readonly file: string;
57
+ readonly line: number;
58
+ readonly column: number;
59
+ readonly text: string;
60
+ }
61
+
62
+ /**
63
+ * The compiler options scriptc type-checks emitted JavaScript under. scriptc reads the nearest `tsconfig.json`; the
64
+ * workspace's (`noImplicitReturns`, `noUnusedLocals`) refuses JavaScript that carries no types, and an empty one is
65
+ * refused for lacking `strictNullChecks`.
66
+ */
67
+ export const EMITTED_JAVASCRIPT_TSCONFIG = {
68
+ compilerOptions: {
69
+ strict: true,
70
+ target: 'es2022',
71
+ module: 'nodenext',
72
+ moduleResolution: 'nodenext',
73
+ types: ['bun', 'node'],
74
+ skipLibCheck: true,
75
+ },
76
+ } as const;
77
+
78
+ /** Where a run stages its emit: inside the project, so the emitted JavaScript resolves the project's dependencies. */
79
+ const STAGING_DIRECTORY = '.cache/scriptc';
80
+
81
+ export default function scriptcNativeExecutor(
82
+ options: ScriptcNativeOptions,
83
+ context: ScriptcNativeContext,
84
+ ): Promise<ScriptcNativeResult> {
85
+ return runScriptcNative(options, context, { emit: runTtsc, archive: runZigArchive, build: runScriptc });
86
+ }
87
+
88
+ /**
89
+ * Every platform's run emits on its own: the four targets of a package run side by side on one host and each family is
90
+ * collected from its own publish leg, so none of them reads or writes another's JavaScript, and the emit is no output of
91
+ * any of them. The overlay config and the emit live under the gitignored staging root, so a killed run leaves nothing a
92
+ * project input hashes.
93
+ */
94
+ export async function runScriptcNative(
95
+ options: ScriptcNativeOptions,
96
+ context: ScriptcNativeContext,
97
+ runner: ScriptcRunner,
98
+ ): Promise<ScriptcNativeResult> {
99
+ const problem = options.ffi === undefined ? undefined : ffiPathProblem(options.ffi);
100
+ if (problem !== undefined) throw new Error(`scriptc-native: ffi ${problem}`);
101
+ const cwd = isAbsolute(options.cwd) ? options.cwd : join(context.root, options.cwd);
102
+ const run = `${options.triple}-${process.pid}-${randomUUID()}`;
103
+ const staging = join(cwd, STAGING_DIRECTORY, run);
104
+ const overlay = join(cwd, STAGING_DIRECTORY, `${run}.json`);
105
+ const tsconfig = {
106
+ extends: relative(dirname(overlay), join(cwd, options.tsConfig)),
107
+ compilerOptions: {
108
+ outDir: staging,
109
+ composite: false,
110
+ declaration: false,
111
+ declarationMap: false,
112
+ emitDeclarationOnly: false,
113
+ incremental: false,
114
+ sourceMap: false,
115
+ },
116
+ };
117
+ await mkdir(staging, { recursive: true });
118
+ await writeFile(overlay, `${JSON.stringify(tsconfig, null, 2)}\n`, { flag: 'wx' });
119
+ try {
120
+ if (!(await runner.emit({ tsconfig: overlay, outDir: staging, cwd }))) return { success: false };
121
+ const untransformed = untransformedTypiaCalls(staging);
122
+ for (const call of untransformed) {
123
+ console.error(
124
+ 'scriptc-native: ' +
125
+ relative(context.root, call.file) +
126
+ ':' +
127
+ call.line +
128
+ ':' +
129
+ call.column +
130
+ ': untransformed ' +
131
+ call.text +
132
+ ': ttsc emitted this typia call as written, which it does when the emitting package does not list typia itself',
133
+ );
134
+ }
135
+ if (untransformed.length > 0) return { success: false };
136
+ // The nearest configs of the emitted JavaScript: scriptc's type-check, and the module format the sources were written in.
137
+ await writeFile(join(staging, 'tsconfig.json'), `${JSON.stringify(EMITTED_JAVASCRIPT_TSCONFIG, null, 2)}\n`);
138
+ await writeFile(join(staging, 'package.json'), `${JSON.stringify({ type: 'module' })}\n`);
139
+ let ffi: string | undefined;
140
+ if (options.ffi !== undefined) {
141
+ ffi = await stageFfi(options.ffi, { cwd, staging, triple: options.triple }, runner);
142
+ if (ffi === undefined) return { success: false };
143
+ }
144
+ const binaries = join(cwd, options.outputDirectory);
145
+ await mkdir(binaries, { recursive: true });
146
+ const outputs = Object.keys(options.entries).map((name) => join(binaries, name));
147
+ for (const [name, entry] of Object.entries(options.entries)) {
148
+ const invocation = {
149
+ entry: join(staging, entry),
150
+ output: join(binaries, name),
151
+ cwd,
152
+ triple: options.triple,
153
+ ...(ffi === undefined ? {} : { ffi }),
154
+ };
155
+ if (!(await runner.build(invocation))) {
156
+ // A failed run defines none of its outputs: no executable an earlier bin of this run wrote stays to be packed.
157
+ await Promise.all(outputs.map((output) => rm(output, { force: true })));
158
+ return { success: false };
159
+ }
160
+ }
161
+ return { success: true };
162
+ } finally {
163
+ await rm(overlay, { force: true });
164
+ await rm(staging, { recursive: true, force: true });
165
+ }
166
+ }
167
+
168
+ /**
169
+ * Every call through a binding of a `typia` import in the emitted JavaScript under `root`. The transform
170
+ * replaces each such call with the code it generates; one that survives means ttsc never loaded the typia plugin.
171
+ */
172
+ export function untransformedTypiaCalls(root: string): UntransformedTypiaCall[] {
173
+ const calls: UntransformedTypiaCall[] = [];
174
+ for (const file of javascriptFiles(root)) {
175
+ const source = ts.createSourceFile(
176
+ file,
177
+ readFileSync(file, 'utf8'),
178
+ ts.ScriptTarget.Latest,
179
+ true,
180
+ ts.ScriptKind.JS,
181
+ );
182
+ const bindings = typiaBindings(source);
183
+ if (bindings.size === 0) continue;
184
+ const visit = (node: ts.Node): void => {
185
+ if (ts.isCallExpression(node)) {
186
+ const root = chainRoot(node.expression);
187
+ if (root !== undefined && bindings.has(root.text)) {
188
+ const { line, character } = source.getLineAndCharacterOfPosition(node.expression.getStart(source));
189
+ calls.push({ file, line: line + 1, column: character + 1, text: node.expression.getText(source) });
190
+ }
191
+ }
192
+ ts.forEachChild(node, visit);
193
+ };
194
+ visit(source);
195
+ }
196
+ return calls;
197
+ }
198
+
199
+ /** The identifier a member chain starts at: `typia` for `typia.json.assertParse`, `t` for `t['is']`. */
200
+ function chainRoot(expression: ts.Expression): ts.Identifier | undefined {
201
+ let node = expression;
202
+ while (ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node)) node = node.expression;
203
+ return ts.isIdentifier(node) ? node : undefined;
204
+ }
205
+
206
+ /**
207
+ * Every name a typia call can be made through: the default, namespace and named bindings of the module's `typia`
208
+ * imports, and, in source order, each name destructured from one of those (`const { createIs } = typia`). The helpers
209
+ * under `typia/lib/internal/` are what the transform emits calls to, so they are never such an import.
210
+ */
211
+ function typiaBindings(source: ts.SourceFile): Set<string> {
212
+ const bindings = new Set<string>();
213
+ for (const statement of source.statements) {
214
+ if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) continue;
215
+ const specifier = statement.moduleSpecifier.text;
216
+ if (specifier !== 'typia' && !specifier.startsWith('typia/')) continue;
217
+ if (specifier.startsWith('typia/lib/internal/')) continue;
218
+ const clause = statement.importClause;
219
+ if (clause === undefined || clause.isTypeOnly) continue;
220
+ if (clause.name !== undefined) bindings.add(clause.name.text);
221
+ const named = clause.namedBindings;
222
+ if (named !== undefined && ts.isNamespaceImport(named)) bindings.add(named.name.text);
223
+ if (named !== undefined && ts.isNamedImports(named)) {
224
+ for (const element of named.elements) if (!element.isTypeOnly) bindings.add(element.name.text);
225
+ }
226
+ }
227
+ if (bindings.size === 0) return bindings;
228
+ const destructure = (node: ts.Node): void => {
229
+ if (ts.isVariableDeclaration(node) && ts.isObjectBindingPattern(node.name) && node.initializer !== undefined) {
230
+ const root = chainRoot(node.initializer);
231
+ if (root !== undefined && bindings.has(root.text)) {
232
+ for (const element of node.name.elements) if (ts.isIdentifier(element.name)) bindings.add(element.name.text);
233
+ }
234
+ }
235
+ ts.forEachChild(node, destructure);
236
+ };
237
+ destructure(source);
238
+ return bindings;
239
+ }
240
+
241
+ function javascriptFiles(directory: string): string[] {
242
+ return readdirSync(directory, { withFileTypes: true, recursive: true })
243
+ .filter((entry) => entry.isFile() && /\.[cm]?js$/.test(entry.name))
244
+ .map((entry) => join(entry.parentPath, entry.name))
245
+ .sort();
246
+ }
247
+
248
+ /** The executable of the project's own `scriptc` dependency, the declaration that opts a package into this target. */
249
+ function scriptcCompiler(cwd: string): string {
250
+ const manifestPath = createRequire(join(cwd, 'package.json')).resolve('scriptc/package.json');
251
+ const manifest: unknown = JSON.parse(readFileSync(manifestPath, 'utf8'));
252
+ const bin = isRecord(manifest) && isRecord(manifest.bin) ? manifest.bin.scriptc : undefined;
253
+ if (typeof bin !== 'string') throw new Error(`${manifestPath}: bin.scriptc must name the scriptc executable`);
254
+ return join(dirname(manifestPath), bin);
255
+ }
256
+
257
+ /**
258
+ * What the run needs of a package's FFI manifest: its libraries, which must be none. Every other field passes
259
+ * through.
260
+ */
261
+ interface FfiManifest {
262
+ readonly libraries: readonly string[];
263
+ }
264
+
265
+ const validateFfiManifest = typia.createValidate<FfiManifest>();
266
+
267
+ function readFfiManifest(path: string): FfiManifest {
268
+ let parsed: unknown;
269
+ try {
270
+ parsed = JSON.parse(readFileSync(path, 'utf8'));
271
+ } catch (error) {
272
+ throw new Error(`${path}: ${error instanceof Error ? error.message : String(error)}`);
273
+ }
274
+ const checked = validateFfiManifest(parsed);
275
+ if (!checked.success) {
276
+ const found = checked.errors.map((error) => `${error.path} expected ${error.expected}`).join('; ');
277
+ throw new Error(`${path}: an FFI manifest lists its libraries (${found})`);
278
+ }
279
+ if (checked.data.libraries.length > 0) {
280
+ throw new Error(
281
+ `${path}: lists libraries (${checked.data.libraries.join(', ')}); a prebuilt archive holds one triple's code and ` +
282
+ 'every platform builds this one manifest, so list the C in "sources" and each run links the archive it compiles',
283
+ );
284
+ }
285
+ return checked.data;
286
+ }
287
+
288
+ /**
289
+ * The package's FFI made ready beside the staged JavaScript, and the manifest scriptc is handed: each declaration
290
+ * copied to where its emitted module looks for it, the C sources compiled for the triple into one archive, and a copy
291
+ * of the manifest that links that archive. Every platform builds one manifest, so it names no prebuilt library (an
292
+ * archive holds one triple's code). Undefined when the C does not compile.
293
+ */
294
+ async function stageFfi(
295
+ ffi: ScriptcNativeFfi,
296
+ where: { readonly cwd: string; readonly staging: string; readonly triple: string },
297
+ runner: ScriptcRunner,
298
+ ): Promise<string | undefined> {
299
+ const manifestPath = join(where.cwd, ffi.manifest);
300
+ const manifest = readFfiManifest(manifestPath);
301
+ for (const [declaration, destination] of Object.entries(ffi.declarations)) {
302
+ await mkdir(dirname(join(where.staging, destination)), { recursive: true });
303
+ await copyFile(join(where.cwd, declaration), join(where.staging, destination));
304
+ }
305
+ const libraries: string[] = [];
306
+ if (ffi.sources.length > 0) {
307
+ const archive = join(where.staging, 'native', 'ffi.a');
308
+ await mkdir(dirname(archive), { recursive: true });
309
+ const sources = ffi.sources.map((source) => join(where.cwd, source));
310
+ if (!(await runner.archive({ sources, archive, cwd: where.cwd, triple: where.triple }))) return undefined;
311
+ libraries.push(archive);
312
+ }
313
+ const staged = join(where.staging, 'ffi.json');
314
+ await writeFile(staged, `${JSON.stringify({ ...manifest, libraries }, null, 2)}\n`);
315
+ return staged;
316
+ }
317
+
318
+ async function runTtsc(invocation: EmitInvocation): Promise<boolean> {
319
+ return exited(
320
+ 'ttsc',
321
+ spawn('ttsc', ['-p', invocation.tsconfig, '--emit'], { cwd: invocation.cwd, stdio: 'inherit' }),
322
+ );
323
+ }
324
+
325
+ /** The arguments of one `scriptc build`: the staged FFI manifest, when the package has one, rides as `--ffi`. */
326
+ export function scriptcBuildArguments(invocation: ScriptcInvocation): string[] {
327
+ return [
328
+ 'build',
329
+ invocation.entry,
330
+ '-o',
331
+ invocation.output,
332
+ '--strip',
333
+ '--no-keep-llvm',
334
+ ...(invocation.ffi === undefined ? [] : ['--ffi', invocation.ffi]),
335
+ ];
336
+ }
337
+
338
+ /**
339
+ * The zig commands that archive a package's C: one compile per source for the triple, then one archive of the objects.
340
+ * zig cc without an optimization flag compiles in Debug mode with UBSan, whose handlers only a zig link carries;
341
+ * scriptc links the archive itself, so the C is compiled `-O2` (scriptc's own release posture) with UBSan off.
342
+ */
343
+ export function zigArchiveCommands(invocation: ArchiveInvocation): string[][] {
344
+ const compiled = invocation.sources.map((source, index) => ({ source, object: `${invocation.archive}.${index}.o` }));
345
+ return [
346
+ ...compiled.map(({ source, object }) => [
347
+ 'cc',
348
+ '-target',
349
+ invocation.triple,
350
+ '-O2',
351
+ '-fno-sanitize=undefined',
352
+ '-c',
353
+ source,
354
+ '-o',
355
+ object,
356
+ ]),
357
+ ['ar', 'rcs', invocation.archive, ...compiled.map(({ object }) => object)],
358
+ ];
359
+ }
360
+
361
+ async function runScriptc(invocation: ScriptcInvocation): Promise<boolean> {
362
+ // Every triple, the host's own included, builds the same way: scriptc refuses a SCRIPTC_TARGET build unless zig is
363
+ // its C compiler, since no other driver carries the other platforms' sysroots. zig is found on PATH (devenv.smoo.nix).
364
+ // The LLVM IR scriptc keeps beside an executable by default is no declared output.
365
+ const child = spawn(scriptcCompiler(invocation.cwd), scriptcBuildArguments(invocation), {
366
+ cwd: invocation.cwd,
367
+ env: { ...process.env, SCRIPTC_TARGET: invocation.triple, SCRIPTC_CC: 'zigcc' },
368
+ stdio: 'inherit',
369
+ windowsHide: true,
370
+ });
371
+ return exited('scriptc', child);
372
+ }
373
+
374
+ /**
375
+ * The C sources compiled and archived by the zig that is scriptc's own C compiler (devenv.smoo.nix), so an archive and
376
+ * the executable that links it agree on the target's libc and ABI.
377
+ */
378
+ async function runZigArchive(invocation: ArchiveInvocation): Promise<boolean> {
379
+ for (const args of zigArchiveCommands(invocation)) {
380
+ const child = spawn('zig', args, { cwd: invocation.cwd, stdio: 'inherit', windowsHide: true });
381
+ if (!(await exited(`zig ${args[0]}`, child))) return false;
382
+ }
383
+ return true;
384
+ }
385
+ async function exited(command: string, child: ReturnType<typeof spawn>): Promise<boolean> {
386
+ try {
387
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: a scriptc build or a zig compile lasts as long as its work; the operator's interrupt or the enclosing runner's bound ends a hung one
388
+ await once(child, 'exit');
389
+ return child.exitCode === 0 && child.signalCode === null;
390
+ } catch (error) {
391
+ console.error(`${command}: ${error instanceof Error ? error.message : String(error)}`);
392
+ return false;
393
+ }
394
+ }
@@ -0,0 +1,29 @@
1
+ import { posix } from 'node:path';
2
+
3
+ import type { ScriptcNativeFfi } from './schema.js';
4
+
5
+ /** Whether `path` names something beneath the directory it is relative to: not empty, not absolute, never climbing out. */
6
+ function staysInside(path: string): boolean {
7
+ const normalized = posix.normalize(path.replaceAll('\\', '/'));
8
+ return normalized !== '.' && normalized !== '..' && !normalized.startsWith('../') && !posix.isAbsolute(normalized);
9
+ }
10
+
11
+ /**
12
+ * What is wrong with where a package's FFI points, or undefined. The manifest, the declarations and the C sources are
13
+ * read from the project, and a declaration is written beneath the run's staging directory. Nx hashes only what lies
14
+ * beneath the project and the run removes only its staging, so a path that is absolute or climbs out of its root names a
15
+ * file the cache key does not know, or one the run leaves behind.
16
+ */
17
+ export function ffiPathProblem(ffi: ScriptcNativeFfi): string | undefined {
18
+ const named = [
19
+ ...[ffi.manifest, ...Object.keys(ffi.declarations), ...ffi.sources].map((path) => ({
20
+ path,
21
+ beneath: 'the project',
22
+ })),
23
+ ...Object.values(ffi.declarations).map((path) => ({ path, beneath: "the emitted JavaScript's root" })),
24
+ ];
25
+ const escaping = named.find(({ path }) => !staysInside(path));
26
+ return escaping === undefined
27
+ ? undefined
28
+ : `names ${JSON.stringify(escaping.path)}, which is not a path beneath ${escaping.beneath}`;
29
+ }
@@ -0,0 +1,60 @@
1
+ {
2
+ "$schema": "https://json-schema.org/schema",
3
+ "version": 2,
4
+ "title": "scriptc native executor",
5
+ "description": "Compile each package bin from the package's transformed JavaScript to one platform's executable with scriptc and zig",
6
+ "type": "object",
7
+ "properties": {
8
+ "cwd": {
9
+ "type": "string",
10
+ "description": "Project root, relative to the workspace root"
11
+ },
12
+ "tsConfig": {
13
+ "type": "string",
14
+ "description": "The package's emit config, relative to cwd, which the run emits with ttsc into private staging"
15
+ },
16
+ "triple": {
17
+ "type": "string",
18
+ "description": "The triple SCRIPTC_TARGET names, e.g. aarch64-linux-musl"
19
+ },
20
+ "outputDirectory": {
21
+ "type": "string",
22
+ "description": "Directory receiving the executables, e.g. dist/bin/linux-arm64, relative to cwd"
23
+ },
24
+ "entries": {
25
+ "type": "object",
26
+ "description": "Executable name to its entry module, relative to the emitted JavaScript's root",
27
+ "additionalProperties": {
28
+ "type": "string"
29
+ }
30
+ },
31
+ "ffi": {
32
+ "type": "object",
33
+ "description": "The package's foreign functions: its declarations are staged beside the emitted JavaScript, its C sources compiled for the triple into an archive, and scriptc is handed a staged copy of the manifest that links it",
34
+ "properties": {
35
+ "manifest": {
36
+ "type": "string",
37
+ "description": "The FFI manifest, relative to cwd, listing no libraries"
38
+ },
39
+ "declarations": {
40
+ "type": "object",
41
+ "description": "Each ambient declaration file, relative to cwd, to where it is staged beside the emitted JavaScript",
42
+ "additionalProperties": {
43
+ "type": "string"
44
+ }
45
+ },
46
+ "sources": {
47
+ "type": "array",
48
+ "description": "C sources, relative to cwd, compiled for the triple into the archive the staged manifest links",
49
+ "items": {
50
+ "type": "string"
51
+ }
52
+ }
53
+ },
54
+ "required": ["manifest", "declarations", "sources"],
55
+ "additionalProperties": false
56
+ }
57
+ },
58
+ "required": ["cwd", "tsConfig", "triple", "outputDirectory", "entries"],
59
+ "additionalProperties": false
60
+ }
@@ -0,0 +1,34 @@
1
+ /**
2
+ * A package's foreign functions: C its executables call through scriptc's FFI. A path that is absolute or climbs out of
3
+ * its root is refused: Nx hashes only what lies beneath the project, and the run removes only its own staging.
4
+ */
5
+ export interface ScriptcNativeFfi {
6
+ /**
7
+ * The FFI manifest, relative to cwd. It lists no libraries: every platform builds it, and a prebuilt archive holds one
8
+ * triple's code. The run hands scriptc a staged copy of it that links the archive it builds.
9
+ */
10
+ manifest: string;
11
+ /**
12
+ * Ambient declaration files, each relative to cwd, to where it is staged beside the emitted JavaScript, relative to
13
+ * that JavaScript's root. tsc never emits a declaration file, and scriptc binds a call only through a declaration it
14
+ * can resolve from the JavaScript it compiles.
15
+ */
16
+ declarations: Record<string, string>;
17
+ /** C sources, relative to cwd, compiled for the run's triple into the one archive the staged manifest links. */
18
+ sources: string[];
19
+ }
20
+
21
+ export interface ScriptcNativeOptions {
22
+ /** The project root, relative to the workspace root. */
23
+ cwd: string;
24
+ /** The package's emit config (`tsconfig.lib.json`), relative to cwd: the run emits it, transformed, into staging. */
25
+ tsConfig: string;
26
+ /** The triple `SCRIPTC_TARGET` names (`aarch64-linux-musl`). */
27
+ triple: string;
28
+ /** Where the executables are written (`dist/bin/linux-arm64`), relative to cwd. */
29
+ outputDirectory: string;
30
+ /** Each executable's name and its entry module, relative to the emitted JavaScript's root. */
31
+ entries: Record<string, string>;
32
+ /** Absent for a package that calls no C. */
33
+ ffi?: ScriptcNativeFfi;
34
+ }
@@ -0,0 +1,24 @@
1
+ /**
2
+ * What the emit changes about the project's own options: JavaScript and declarations from one non-incremental program.
3
+ * They ride the command line onto the project's tsconfig. A synthesized config would have to sit beside that tsconfig,
4
+ * because `${configDir}` and `paths` anchor to the directory of the config that consumes them, and a transient file there
5
+ * changes the directory listing a concurrent ttsc transform of another project proves while it compiles; that
6
+ * transform then refuses with `graph/accessible-entries-changed`.
7
+ *
8
+ * The one definition of how a package's TypeScript dist is emitted: the typescript-emit executor passes these, and so
9
+ * does every bootstrap that emits a dist before Nx can run (tooling/ttsc-emit.ts, the shell entry). A bootstrap that
10
+ * emitted incrementally wrote the tsconfig's tsBuildInfoFile into dist, a file no Nx output produces, and a release
11
+ * refused the verified dist at its merge boundary for it.
12
+ */
13
+ export const EMIT_OVERRIDES: readonly string[] = [
14
+ '--composite',
15
+ 'false',
16
+ '--declaration',
17
+ 'true',
18
+ '--declarationMap',
19
+ 'true',
20
+ '--emitDeclarationOnly',
21
+ 'false',
22
+ '--incremental',
23
+ 'false',
24
+ ];