@smoothbricks/nx-plugin 0.5.7 → 0.6.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 (432) hide show
  1. package/README.md +1086 -360
  2. package/dist/.build-inputs.json +138 -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 +13 -5
  48. package/dist/ensure-built-receipt.d.ts.map +1 -1
  49. package/dist/ensure-built-receipt.js +126 -47
  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.d.ts +33 -36
  62. package/dist/executors/bounded-exec/cpu-pool.d.ts.map +1 -1
  63. package/dist/executors/bounded-exec/cpu-pool.js +54 -119
  64. package/dist/executors/bounded-exec/executor.d.ts +19 -12
  65. package/dist/executors/bounded-exec/executor.d.ts.map +1 -1
  66. package/dist/executors/bounded-exec/executor.js +371 -239
  67. package/dist/executors/bounded-exec/gateway-lease.d.ts +22 -19
  68. package/dist/executors/bounded-exec/gateway-lease.d.ts.map +1 -1
  69. package/dist/executors/bounded-exec/gateway-lease.js +81 -28
  70. package/dist/executors/bounded-exec/hang-diagnostics.d.ts +18 -1
  71. package/dist/executors/bounded-exec/hang-diagnostics.d.ts.map +1 -1
  72. package/dist/executors/bounded-exec/hang-diagnostics.js +148 -30
  73. package/dist/executors/bounded-exec/lease-wait.d.ts +43 -0
  74. package/dist/executors/bounded-exec/lease-wait.d.ts.map +1 -0
  75. package/dist/executors/bounded-exec/lease-wait.js +68 -0
  76. package/dist/executors/bounded-exec/lock-wait.d.ts +51 -0
  77. package/dist/executors/bounded-exec/lock-wait.d.ts.map +1 -0
  78. package/dist/executors/bounded-exec/lock-wait.js +108 -0
  79. package/dist/executors/bounded-exec/owned-subtree.d.ts +84 -0
  80. package/dist/executors/bounded-exec/owned-subtree.d.ts.map +1 -0
  81. package/dist/executors/bounded-exec/owned-subtree.js +178 -0
  82. package/dist/executors/bounded-exec/progress.d.ts +4 -1
  83. package/dist/executors/bounded-exec/progress.d.ts.map +1 -1
  84. package/dist/executors/bounded-exec/progress.js +5 -2
  85. package/dist/executors/bounded-exec/ram-attach.d.ts +19 -0
  86. package/dist/executors/bounded-exec/ram-attach.d.ts.map +1 -0
  87. package/dist/executors/bounded-exec/ram-attach.js +207 -0
  88. package/dist/executors/bounded-exec/ram-detach.d.ts +25 -0
  89. package/dist/executors/bounded-exec/ram-detach.d.ts.map +1 -0
  90. package/dist/executors/bounded-exec/ram-detach.js +207 -0
  91. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts +76 -0
  92. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts.map +1 -1
  93. package/dist/executors/bounded-exec/ram-temp-fixtures.js +296 -0
  94. package/dist/executors/bounded-exec/ram-temp.d.ts +388 -88
  95. package/dist/executors/bounded-exec/ram-temp.d.ts.map +1 -1
  96. package/dist/executors/bounded-exec/ram-temp.js +1213 -399
  97. package/dist/executors/bounded-exec/run-cpu-pool.d.ts +4 -4
  98. package/dist/executors/bounded-exec/run-cpu-pool.d.ts.map +1 -1
  99. package/dist/executors/bounded-exec/run-cpu-pool.js +20 -30
  100. package/dist/executors/bounded-exec/runner-hook.js +14 -5
  101. package/dist/executors/bounded-exec/runner-lifecycle.d.ts +14 -1
  102. package/dist/executors/bounded-exec/runner-lifecycle.d.ts.map +1 -1
  103. package/dist/executors/bounded-exec/runner-lifecycle.js +27 -6
  104. package/dist/executors/bounded-exec/{cpu-tokens.d.ts → runner-sizing.d.ts} +14 -42
  105. package/dist/executors/bounded-exec/runner-sizing.d.ts.map +1 -0
  106. package/dist/executors/bounded-exec/{cpu-tokens.js → runner-sizing.js} +5 -35
  107. package/dist/executors/bounded-exec/runtime-pin.d.ts +73 -0
  108. package/dist/executors/bounded-exec/runtime-pin.d.ts.map +1 -0
  109. package/dist/executors/bounded-exec/runtime-pin.js +167 -0
  110. package/dist/executors/bounded-exec/schema.d.ts +18 -1
  111. package/dist/executors/bounded-exec/schema.d.ts.map +1 -1
  112. package/dist/executors/bounded-exec/verdict.d.ts +40 -11
  113. package/dist/executors/bounded-exec/verdict.d.ts.map +1 -1
  114. package/dist/executors/bounded-exec/verdict.js +88 -19
  115. package/dist/executors/cargo-zigbuild/executor.d.ts +21 -0
  116. package/dist/executors/cargo-zigbuild/executor.d.ts.map +1 -1
  117. package/dist/executors/cargo-zigbuild/executor.js +67 -12
  118. package/dist/executors/clean-outputs/executor.js +1 -0
  119. package/dist/executors/scriptc-native/executor.d.ts +79 -0
  120. package/dist/executors/scriptc-native/executor.d.ts.map +1 -0
  121. package/dist/executors/scriptc-native/executor.js +367 -0
  122. package/dist/executors/scriptc-native/ffi-paths.d.ts +9 -0
  123. package/dist/executors/scriptc-native/ffi-paths.d.ts.map +1 -0
  124. package/dist/executors/scriptc-native/ffi-paths.js +25 -0
  125. package/dist/executors/scriptc-native/schema.d.ts +34 -0
  126. package/dist/executors/scriptc-native/schema.d.ts.map +1 -0
  127. package/dist/executors/scriptc-native/schema.js +1 -0
  128. package/dist/executors/typescript-emit/executor.d.ts +3 -1
  129. package/dist/executors/typescript-emit/executor.d.ts.map +1 -1
  130. package/dist/executors/typescript-emit/executor.js +164 -33
  131. package/dist/forbidden-spelling-policy.d.ts +56 -0
  132. package/dist/forbidden-spelling-policy.d.ts.map +1 -0
  133. package/dist/forbidden-spelling-policy.js +176 -0
  134. package/dist/generators/create-package/generator.d.ts.map +1 -1
  135. package/dist/generators/create-package/generator.js +3 -4
  136. package/dist/graph-input-contract.d.ts +14 -0
  137. package/dist/graph-input-contract.d.ts.map +1 -1
  138. package/dist/graph-input-contract.js +67 -2
  139. package/dist/index.d.ts +23 -6
  140. package/dist/index.d.ts.map +1 -1
  141. package/dist/index.js +672 -214
  142. package/dist/managed-assets.d.ts +2 -0
  143. package/dist/managed-assets.d.ts.map +1 -1
  144. package/dist/managed-files/files.d.ts +3 -3
  145. package/dist/managed-files/files.d.ts.map +1 -1
  146. package/dist/managed-files/files.js +28 -3
  147. package/dist/managed-files/managed-format.d.ts.map +1 -1
  148. package/dist/managed-files/managed-format.js +1 -0
  149. package/dist/nextest-code-bound.js +1 -0
  150. package/dist/nextest-timings.d.ts +35 -0
  151. package/dist/nextest-timings.d.ts.map +1 -0
  152. package/dist/nextest-timings.js +168 -0
  153. package/dist/owned-installation.d.ts +6 -5
  154. package/dist/owned-installation.d.ts.map +1 -1
  155. package/dist/owned-installation.js +150 -26
  156. package/dist/package-target-policy.d.ts.map +1 -1
  157. package/dist/package-target-policy.js +2 -3
  158. package/dist/process-children.d.ts +7 -0
  159. package/dist/process-children.d.ts.map +1 -0
  160. package/dist/process-children.darwin.d.ts +7 -0
  161. package/dist/process-children.darwin.d.ts.map +1 -0
  162. package/dist/process-children.darwin.js +13 -0
  163. package/dist/process-children.js +14 -0
  164. package/dist/process-children.linux.d.ts +8 -0
  165. package/dist/process-children.linux.d.ts.map +1 -0
  166. package/dist/process-children.linux.js +25 -0
  167. package/dist/process-group.d.ts +108 -0
  168. package/dist/process-group.d.ts.map +1 -0
  169. package/dist/process-group.js +171 -0
  170. package/dist/process-listing.d.ts +7 -0
  171. package/dist/process-listing.d.ts.map +1 -0
  172. package/dist/process-listing.js +51 -0
  173. package/dist/producer-receipts.d.ts +8 -2
  174. package/dist/producer-receipts.d.ts.map +1 -1
  175. package/dist/producer-receipts.js +75 -48
  176. package/dist/task-graph-policy.d.ts +21 -0
  177. package/dist/task-graph-policy.d.ts.map +1 -0
  178. package/dist/task-graph-policy.js +91 -0
  179. package/dist/test-timings.js +4 -4
  180. package/dist/test-walk-policy.d.ts +14 -5
  181. package/dist/test-walk-policy.d.ts.map +1 -1
  182. package/dist/test-walk-policy.js +8 -2
  183. package/dist/testing.d.ts +73 -28
  184. package/dist/testing.d.ts.map +1 -1
  185. package/dist/testing.js +217 -223
  186. package/dist/tool-bins.d.ts +33 -0
  187. package/dist/tool-bins.d.ts.map +1 -0
  188. package/dist/tool-bins.js +72 -0
  189. package/dist/typecheck-test-policy.d.ts.map +1 -1
  190. package/dist/typecheck-test-policy.js +3 -4
  191. package/dist/wait-why-policy.d.ts +28 -0
  192. package/dist/wait-why-policy.d.ts.map +1 -0
  193. package/dist/wait-why-policy.js +223 -0
  194. package/dist/workspace-config-policy.d.ts +14 -8
  195. package/dist/workspace-config-policy.d.ts.map +1 -1
  196. package/dist/workspace-config-policy.js +60 -16
  197. package/dist/workspace-manifest.d.ts +41 -6
  198. package/dist/workspace-manifest.d.ts.map +1 -1
  199. package/dist/workspace-manifest.js +57 -0
  200. package/executors.json +16 -1
  201. package/loader.js +2 -0
  202. package/managed/raw/envrc +11 -0
  203. package/managed/raw/patches/nx@23.2.1.patch +2840 -199
  204. package/managed/raw/patches/ttsc@0.34.1.patch +119 -0
  205. package/managed/raw/tooling/direnv/cargo-fetch-bound.ts +245 -0
  206. package/managed/raw/tooling/direnv/cargo-fetch-run.ts +299 -0
  207. package/managed/raw/tooling/direnv/compiler-variables.sh +42 -0
  208. package/managed/raw/tooling/direnv/developer-links.ts +464 -25
  209. package/managed/raw/tooling/direnv/devenv.smoo.nix +78 -38
  210. package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +14 -12
  211. package/managed/raw/tooling/direnv/installed-bun-links.ts +308 -0
  212. package/managed/raw/tooling/direnv/linked-snapshots.ts +62 -3
  213. package/managed/raw/tooling/direnv/nx-socket-dir.sh +56 -17
  214. package/managed/raw/tooling/direnv/repo-path +68 -6
  215. package/managed/raw/tooling/direnv/secret-references.ts +13 -4
  216. package/managed/raw/tooling/direnv/setup-environment.ts +128 -537
  217. package/managed/raw/tooling/direnv/toolchain-stamp.ts +4 -2
  218. package/managed/raw/tooling/direnv/ttsc-env.sh +9 -0
  219. package/managed/raw/tooling/direnv/uv-relocation.ts +227 -0
  220. package/managed/raw/tooling/git-hooks/commit-msg.sh +2 -1
  221. package/managed/raw/tooling/git-hooks/pre-commit.sh +2 -1
  222. package/managed/raw/tooling/git-hooks/pre-push.sh +2 -1
  223. package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +85 -7
  224. package/managed/templates/github/actions/save-nix-devenv/action.yml +12 -2
  225. package/managed/templates/github/actions/setup-devenv/action.yml +2 -0
  226. package/package.json +77 -13
  227. package/src/bin/smoo-nx-cargo-toolchain.ts +11 -0
  228. package/src/bin/smoo-nx-forbidden-spellings.ts +33 -0
  229. package/src/bin/smoo-nx-nextest-timings.ts +31 -0
  230. package/src/bounded-test-policy.ts +12 -14
  231. package/src/build-state-output-policy.ts +458 -34
  232. package/src/bun-lock-scope.ts +108 -0
  233. package/src/cargo-build-script-env.ts +265 -0
  234. package/src/cargo-closure-input.ts +74 -7
  235. package/src/cargo-retention-hook.ts +94 -0
  236. package/src/cargo-source-hash.ts +138 -41
  237. package/src/cargo-toolchain-paths.ts +95 -0
  238. package/src/cargo-toolchain-policy.ts +49 -5
  239. package/src/cargo-workspace.ts +72 -123
  240. package/src/cross-check-policy.ts +12 -10
  241. package/src/disk-command-policy.ts +1 -0
  242. package/src/ensure-built-receipt.ts +132 -39
  243. package/src/ensure-built-witness.ts +62 -10
  244. package/src/ensure-built.ts +11 -1
  245. package/src/eslint-config-closure.ts +357 -0
  246. package/src/executors/bounded-exec/bounds.ts +76 -0
  247. package/src/executors/bounded-exec/cpu-pool.ts +51 -117
  248. package/src/executors/bounded-exec/executor.ts +423 -259
  249. package/src/executors/bounded-exec/gateway-lease.ts +82 -33
  250. package/src/executors/bounded-exec/hang-diagnostics.ts +173 -31
  251. package/src/executors/bounded-exec/lease-wait.ts +89 -0
  252. package/src/executors/bounded-exec/lock-wait.ts +141 -0
  253. package/src/executors/bounded-exec/owned-subtree.ts +235 -0
  254. package/src/executors/bounded-exec/progress.ts +9 -3
  255. package/src/executors/bounded-exec/ram-attach.ts +238 -0
  256. package/src/executors/bounded-exec/ram-detach.ts +226 -0
  257. package/src/executors/bounded-exec/ram-temp-fixtures.ts +358 -0
  258. package/src/executors/bounded-exec/ram-temp-registry.txt +440 -0
  259. package/src/executors/bounded-exec/ram-temp.ts +1497 -460
  260. package/src/executors/bounded-exec/run-cpu-pool.ts +22 -30
  261. package/src/executors/bounded-exec/runner-hook.ts +14 -6
  262. package/src/executors/bounded-exec/runner-lifecycle.ts +31 -8
  263. package/src/executors/bounded-exec/{cpu-tokens.ts → runner-sizing.ts} +13 -59
  264. package/src/executors/bounded-exec/runtime-pin.ts +232 -0
  265. package/src/executors/bounded-exec/schema.json +11 -2
  266. package/src/executors/bounded-exec/schema.ts +19 -1
  267. package/src/executors/bounded-exec/verdict.ts +137 -34
  268. package/src/executors/cargo-zigbuild/executor.ts +82 -8
  269. package/src/executors/clean-outputs/executor.ts +1 -0
  270. package/src/executors/scriptc-native/executor.ts +394 -0
  271. package/src/executors/scriptc-native/ffi-paths.ts +29 -0
  272. package/src/executors/scriptc-native/schema.json +60 -0
  273. package/src/executors/scriptc-native/schema.ts +34 -0
  274. package/src/executors/typescript-emit/executor.ts +205 -38
  275. package/src/forbidden-spelling-policy.ts +226 -0
  276. package/src/generators/create-package/generator.ts +7 -7
  277. package/src/graph-input-contract.ts +61 -2
  278. package/src/index.ts +788 -224
  279. package/src/managed-assets.ts +3 -0
  280. package/src/managed-files/files.ts +28 -3
  281. package/src/managed-files/managed-format.ts +1 -0
  282. package/src/nextest-code-bound.ts +1 -0
  283. package/src/nextest-timings.ts +106 -0
  284. package/src/owned-installation.ts +150 -23
  285. package/src/package-target-policy.ts +2 -3
  286. package/src/process-children.darwin.ts +14 -0
  287. package/src/process-children.linux.ts +33 -0
  288. package/src/process-children.ts +22 -0
  289. package/src/process-group.ts +209 -0
  290. package/src/process-listing.ts +54 -0
  291. package/src/producer-receipts.ts +68 -45
  292. package/src/task-graph-policy.ts +98 -0
  293. package/src/test-walk-policy.ts +23 -8
  294. package/src/testing.ts +240 -232
  295. package/src/tool-bins.ts +108 -0
  296. package/src/typecheck-test-policy.ts +2 -3
  297. package/src/wait-why-policy.ts +226 -0
  298. package/src/workspace-config-policy.ts +63 -15
  299. package/src/workspace-manifest.ts +89 -6
  300. package/test-timings.json +122 -98
  301. package/dist/bin/smoo-nx-failures.d.ts +0 -3
  302. package/dist/bin/smoo-nx-failures.d.ts.map +0 -1
  303. package/dist/bin/smoo-nx-failures.js +0 -3
  304. package/dist/bin/smoo-nx-nextest-extract.d.ts +0 -3
  305. package/dist/bin/smoo-nx-nextest-extract.d.ts.map +0 -1
  306. package/dist/bin/smoo-nx-nextest-extract.js +0 -42
  307. package/dist/executors/bounded-exec/cpu-tokens.d.ts.map +0 -1
  308. package/dist/failure-summary.d.ts +0 -5
  309. package/dist/failure-summary.d.ts.map +0 -1
  310. package/dist/failure-summary.js +0 -118
  311. package/dist/nextest-extraction.d.ts +0 -117
  312. package/dist/nextest-extraction.d.ts.map +0 -1
  313. package/dist/nextest-extraction.js +0 -303
  314. package/managed/raw/patches/ttsc@0.30.4.patch +0 -2255
  315. package/src/__tests__/cargo-closure-filesets.ts +0 -94
  316. package/src/__tests__/cargo-closure-fixture.ts +0 -113
  317. package/src/__tests__/counted-cargo-process.ts +0 -286
  318. package/src/__tests__/counted-cargo.ts +0 -713
  319. package/src/__tests__/directory-change.ts +0 -27
  320. package/src/__tests__/fixture-cargo-home.ts +0 -36
  321. package/src/__tests__/fixture-nx-env.ts +0 -193
  322. package/src/__tests__/owned-installation.ts +0 -13
  323. package/src/__tests__/past-tick.ts +0 -12
  324. package/src/__tests__/progress-clock.ts +0 -43
  325. package/src/__tests__/runtime-input.ts +0 -23
  326. package/src/bin/smoo-nx-bound-failures.test.ts +0 -127
  327. package/src/bin/smoo-nx-failures.ts +0 -4
  328. package/src/bin/smoo-nx-nextest-extract.ts +0 -44
  329. package/src/bounded-test-policy.test.ts +0 -1029
  330. package/src/build-state-output-policy.test.ts +0 -115
  331. package/src/bun-bootstrap.test.ts +0 -102
  332. package/src/bun-file-packages.test.ts +0 -47
  333. package/src/cargo-closure-filesets.test.ts +0 -63
  334. package/src/cargo-closure-input.property.test.ts +0 -50
  335. package/src/cargo-closure-input.test.ts +0 -506
  336. package/src/cargo-closure-key.test.ts +0 -240
  337. package/src/cargo-resolve-cache.test.ts +0 -1181
  338. package/src/cargo-source-hash.test.ts +0 -707
  339. package/src/cargo-workspace.test.ts +0 -615
  340. package/src/cross-check-policy.test.ts +0 -316
  341. package/src/disk-command-policy.test.ts +0 -61
  342. package/src/ensure-built-receipt.test.ts +0 -279
  343. package/src/ensure-built-witness.test.ts +0 -688
  344. package/src/ensure-built.test.ts +0 -1462
  345. package/src/executors/all-verdicts/executor.test.ts +0 -135
  346. package/src/executors/bounded-exec/cargo-progress-host.test.ts +0 -332
  347. package/src/executors/bounded-exec/cpu-pool.test.ts +0 -684
  348. package/src/executors/bounded-exec/cpu-tokens.test.ts +0 -519
  349. package/src/executors/bounded-exec/disk-lease.test.ts +0 -219
  350. package/src/executors/bounded-exec/executor-host.test.ts +0 -800
  351. package/src/executors/bounded-exec/executor.test.ts +0 -1819
  352. package/src/executors/bounded-exec/go-progress-host.test.ts +0 -171
  353. package/src/executors/bounded-exec/hang-diagnostics.test.ts +0 -291
  354. package/src/executors/bounded-exec/progress.test.ts +0 -139
  355. package/src/executors/bounded-exec/ram-temp-held.test.ts +0 -264
  356. package/src/executors/bounded-exec/ram-temp-host.test.ts +0 -635
  357. package/src/executors/bounded-exec/ram-temp.test.ts +0 -750
  358. package/src/executors/bounded-exec/run-cpu-pool.test.ts +0 -79
  359. package/src/executors/bounded-exec/runner-hook.test.ts +0 -193
  360. package/src/executors/bounded-exec/runner-lifecycle.test.ts +0 -82
  361. package/src/executors/bounded-exec/verdict.test.ts +0 -545
  362. package/src/executors/cargo-zigbuild/executor.test.ts +0 -129
  363. package/src/executors/clean-outputs/executor.test.ts +0 -20
  364. package/src/executors/typescript-emit/executor.test.ts +0 -83
  365. package/src/failure-summary.ts +0 -119
  366. package/src/generators/bounded-test-targets/generator.test.ts +0 -138
  367. package/src/generators/bun-test-tracing/generator.test.ts +0 -250
  368. package/src/generators/create-package/generator.test.ts +0 -190
  369. package/src/generators/make-public/generator.test.ts +0 -137
  370. package/src/graph-input-contract.test.ts +0 -379
  371. package/src/host-controller-wiring.test.ts +0 -31
  372. package/src/index.test.ts +0 -3321
  373. package/src/linked-snapshots.nx.test.ts +0 -254
  374. package/src/managed-files/forgejo-artifact.test.ts +0 -395
  375. package/src/managed-files/generator.test.ts +0 -243
  376. package/src/managed-files/github-host-cache-isolation.test.ts +0 -86
  377. package/src/managed-files/json-edit.test.ts +0 -216
  378. package/src/managed-files/managed-content.test.ts +0 -166
  379. package/src/managed-files/managed-format-json.test.ts +0 -308
  380. package/src/managed-files/repo-path.test.ts +0 -172
  381. package/src/managed-files/setup-devenv-free-disk.test.ts +0 -95
  382. package/src/managed-files/trace-db-artifact.test.ts +0 -7
  383. package/src/managed-files/tree-permissions.test.ts +0 -109
  384. package/src/managed-files/tree.test.ts +0 -123
  385. package/src/manifest-hash.test.ts +0 -219
  386. package/src/nextest-code-bound.test.ts +0 -161
  387. package/src/nextest-extraction.test.ts +0 -216
  388. package/src/nextest-extraction.ts +0 -371
  389. package/src/nextest-partitions.test.ts +0 -501
  390. package/src/nx-cache-bound.test.ts +0 -109
  391. package/src/nx-cache-restore-mtime.test.ts +0 -170
  392. package/src/nx-daemon-claim.test.ts +0 -279
  393. package/src/nx-daemon-idle-cpu.test.ts +0 -80
  394. package/src/nx-daemon-idle-policy.test.ts +0 -111
  395. package/src/nx-daemon-ignore-files.test.ts +0 -210
  396. package/src/nx-daemon-root-normalization.test.ts +0 -105
  397. package/src/nx-daemon-start-never.test.ts +0 -292
  398. package/src/nx-daemon-validity.test.ts +0 -1055
  399. package/src/nx-dot-input-policy.test.ts +0 -353
  400. package/src/nx-failure-life-cycles.test.ts +0 -207
  401. package/src/nx-files-archive-racy.test.ts +0 -97
  402. package/src/nx-foreign-workspace-env.test.ts +0 -329
  403. package/src/nx-incomplete-run-summary.test.ts +0 -70
  404. package/src/nx-plugin-load-errors.test.ts +0 -120
  405. package/src/nx-project-graph-errors.test.ts +0 -70
  406. package/src/nx-project-resolution-cache.test.ts +0 -176
  407. package/src/nx-raw-inputs.test.ts +0 -166
  408. package/src/nx-resident-graph-workers.test.ts +0 -112
  409. package/src/nx-run-information.test.ts +0 -118
  410. package/src/nx-skipped-task-exit.test.ts +0 -180
  411. package/src/nx-state-location.test.ts +0 -63
  412. package/src/nx-store-resolution.test.ts +0 -81
  413. package/src/nx-task-graph-cycles.test.ts +0 -148
  414. package/src/nx-task-output-lease.test.ts +0 -550
  415. package/src/nx-use-local.test.ts +0 -105
  416. package/src/owned-installation.test.ts +0 -105
  417. package/src/package-target-policy.test.ts +0 -1014
  418. package/src/producer-receipts.test.ts +0 -285
  419. package/src/release-config-policy.test.ts +0 -311
  420. package/src/runtime-input.test.ts +0 -393
  421. package/src/serial-group-wiring.test.ts +0 -326
  422. package/src/task-history-namespace.test.ts +0 -181
  423. package/src/task-results.test.ts +0 -228
  424. package/src/test-clock-policy.test.ts +0 -338
  425. package/src/test-program.test.ts +0 -303
  426. package/src/test-timings.test.ts +0 -240
  427. package/src/test-walk-policy.test.ts +0 -620
  428. package/src/testing.test.ts +0 -509
  429. package/src/typecheck-test-policy.test.ts +0 -1468
  430. package/src/typescript-resolution.test.ts +0 -76
  431. package/src/version-actions.test.ts +0 -80
  432. package/src/workspace-config-policy.test.ts +0 -737
@@ -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
+ }