@maverickcer/env-cap 0.5.3 → 0.7.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 (359) hide show
  1. package/ADOPTION.md +144 -0
  2. package/AGENTS.md +146 -0
  3. package/CHANGELOG.md +438 -0
  4. package/CODE_OF_CONDUCT.md +124 -0
  5. package/CODE_REVIEW.md +200 -0
  6. package/CONTRIBUTING.md +131 -0
  7. package/GUIDE.md +1214 -0
  8. package/PROMPT.md +89 -0
  9. package/README.md +97 -199
  10. package/RELEASING.md +160 -0
  11. package/SECURITY.md +270 -0
  12. package/SUPPORT.md +76 -0
  13. package/VERSIONING.md +118 -0
  14. package/benchmarks/READING-BENCHMARKS.md +197 -0
  15. package/benchmarks/README.md +126 -0
  16. package/benchmarks/WRITING-BENCHMARKS.md +252 -0
  17. package/benchmarks/performance-buildtime/BENCHMARKS.md +889 -0
  18. package/benchmarks/performance-runtime/BENCHMARKS.md +1988 -0
  19. package/dist/.dts/_ipc/build-fs.d.ts +53 -0
  20. package/dist/.dts/_ipc/build-fs.d.ts.map +1 -0
  21. package/dist/.dts/_ipc/compiler-api.d.ts +17 -0
  22. package/dist/.dts/_ipc/compiler-api.d.ts.map +1 -0
  23. package/dist/.dts/_ipc/display-path.d.ts +27 -0
  24. package/dist/.dts/_ipc/display-path.d.ts.map +1 -0
  25. package/dist/.dts/_ipc/generated-banner.d.ts +58 -0
  26. package/dist/.dts/_ipc/generated-banner.d.ts.map +1 -0
  27. package/dist/.dts/_ipc/glob.d.ts +22 -0
  28. package/dist/.dts/_ipc/glob.d.ts.map +1 -0
  29. package/dist/.dts/_ipc/no-node-fs.d.ts +34 -0
  30. package/dist/.dts/_ipc/no-node-fs.d.ts.map +1 -0
  31. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts +134 -0
  32. package/dist/.dts/_ipc/resolve-tsconfig-paths.d.ts.map +1 -0
  33. package/dist/.dts/_ipc/typescript.d.ts +20 -0
  34. package/dist/.dts/_ipc/typescript.d.ts.map +1 -0
  35. package/dist/.dts/build/assemble-project.d.ts +1 -1
  36. package/dist/.dts/build/assemble-project.d.ts.map +1 -1
  37. package/dist/.dts/build/change-model.d.ts.map +1 -1
  38. package/dist/.dts/build/check-artifacts.d.ts.map +1 -1
  39. package/dist/.dts/build/citation-verification.d.ts.map +1 -1
  40. package/dist/.dts/build/compatibility.d.ts.map +1 -1
  41. package/dist/.dts/build/compiler-api.d.ts +12 -0
  42. package/dist/.dts/build/compiler-api.d.ts.map +1 -0
  43. package/dist/.dts/build/dependency-graph.d.ts +3 -1
  44. package/dist/.dts/build/dependency-graph.d.ts.map +1 -1
  45. package/dist/.dts/build/dependency-model.d.ts.map +1 -1
  46. package/dist/.dts/build/discover.d.ts.map +1 -1
  47. package/dist/.dts/build/display-path.d.ts +3 -21
  48. package/dist/.dts/build/display-path.d.ts.map +1 -1
  49. package/dist/.dts/build/docs.d.ts +1 -1
  50. package/dist/.dts/build/docs.d.ts.map +1 -1
  51. package/dist/.dts/build/env-example.d.ts.map +1 -1
  52. package/dist/.dts/build/evidence-cache.d.ts +1 -1
  53. package/dist/.dts/build/evidence-cache.d.ts.map +1 -1
  54. package/dist/.dts/build/evidence-model.d.ts +2 -2
  55. package/dist/.dts/build/evidence-snapshot.d.ts +25 -0
  56. package/dist/.dts/build/evidence-snapshot.d.ts.map +1 -1
  57. package/dist/.dts/build/finding-model.d.ts +1 -1
  58. package/dist/.dts/build/finding-model.d.ts.map +1 -1
  59. package/dist/.dts/build/generate-documentation.d.ts.map +1 -1
  60. package/dist/.dts/build/generate-env-artifacts.d.ts +23 -8
  61. package/dist/.dts/build/generate-env-artifacts.d.ts.map +1 -1
  62. package/dist/.dts/build/generate-evidence.d.ts.map +1 -1
  63. package/dist/.dts/build/generate-manifest.d.ts +1 -1
  64. package/dist/.dts/build/generate-manifest.d.ts.map +1 -1
  65. package/dist/.dts/build/generate-usage.d.ts +3 -3
  66. package/dist/.dts/build/generate-usage.d.ts.map +1 -1
  67. package/dist/.dts/build/generated-banner.d.ts +29 -38
  68. package/dist/.dts/build/generated-banner.d.ts.map +1 -1
  69. package/dist/.dts/build/glob.d.ts +3 -15
  70. package/dist/.dts/build/glob.d.ts.map +1 -1
  71. package/dist/.dts/build/index.d.ts +2 -2
  72. package/dist/.dts/build/lifecycle-model.d.ts.map +1 -1
  73. package/dist/.dts/build/link.d.ts.map +1 -1
  74. package/dist/.dts/build/literal-eval.d.ts +4 -3
  75. package/dist/.dts/build/literal-eval.d.ts.map +1 -1
  76. package/dist/.dts/build/live-expirations.d.ts.map +1 -1
  77. package/dist/.dts/build/manifest.d.ts.map +1 -1
  78. package/dist/.dts/build/merge-documentation.d.ts +35 -0
  79. package/dist/.dts/build/merge-documentation.d.ts.map +1 -0
  80. package/dist/.dts/build/parse.d.ts +12 -12
  81. package/dist/.dts/build/parse.d.ts.map +1 -1
  82. package/dist/.dts/build/reference-projections.d.ts +17 -3
  83. package/dist/.dts/build/reference-projections.d.ts.map +1 -1
  84. package/dist/.dts/build/resolution/resolve-import.d.ts +5 -0
  85. package/dist/.dts/build/resolution/resolve-import.d.ts.map +1 -1
  86. package/dist/.dts/build/resolution/resolve-package-schema.d.ts +1 -1
  87. package/dist/.dts/build/resolution/resolve-package-schema.d.ts.map +1 -1
  88. package/dist/.dts/build/resolution/resolve-tsconfig-paths.d.ts +11 -94
  89. package/dist/.dts/build/resolution/resolve-tsconfig-paths.d.ts.map +1 -1
  90. package/dist/.dts/build/sarif.d.ts.map +1 -1
  91. package/dist/.dts/build/scan-dependencies.d.ts +23 -0
  92. package/dist/.dts/build/scan-dependencies.d.ts.map +1 -1
  93. package/dist/.dts/build/types.d.ts +4 -53
  94. package/dist/.dts/build/types.d.ts.map +1 -1
  95. package/dist/.dts/build/typescript.d.ts +6 -0
  96. package/dist/.dts/build/typescript.d.ts.map +1 -0
  97. package/dist/.dts/build/usage-report.d.ts.map +1 -1
  98. package/dist/.dts/cli/filesystem.d.ts +4 -0
  99. package/dist/.dts/cli/filesystem.d.ts.map +1 -1
  100. package/dist/.dts/eslint-plugin/glob.d.ts +4 -15
  101. package/dist/.dts/eslint-plugin/glob.d.ts.map +1 -1
  102. package/dist/.dts/eslint-plugin/index.d.ts +3 -3
  103. package/dist/.dts/eslint-plugin/no-node-fs.d.ts +8 -18
  104. package/dist/.dts/eslint-plugin/no-node-fs.d.ts.map +1 -1
  105. package/dist/.dts/eslint-plugin/no-raw-process-env.d.ts.map +1 -1
  106. package/dist/.dts/evidence/index.d.ts +2 -2
  107. package/dist/.dts/helpers/index.d.ts +2 -2
  108. package/dist/.dts/helpers/processors.d.ts.map +1 -1
  109. package/dist/.dts/helpers/validators.d.ts.map +1 -1
  110. package/dist/.dts/runtime/cache.d.ts +0 -3
  111. package/dist/.dts/runtime/cache.d.ts.map +1 -1
  112. package/dist/.dts/runtime/create.d.ts.map +1 -1
  113. package/dist/.dts/runtime/document.d.ts.map +1 -1
  114. package/dist/.dts/runtime/index.d.ts +2 -2
  115. package/dist/.dts/runtime/registry.d.ts.map +1 -1
  116. package/dist/.dts/runtime/validate.d.ts.map +1 -1
  117. package/dist/{build-U326PI5A.js → build-WKDIAWF7.js} +685 -645
  118. package/dist/build-WKDIAWF7.js.map +1 -0
  119. package/dist/build.cjs +698 -651
  120. package/dist/build.cjs.map +1 -1
  121. package/dist/build.js +695 -649
  122. package/dist/build.js.map +1 -1
  123. package/dist/{chunk-BSTLSR2R.js → chunk-KEGYUHBU.js} +2 -2
  124. package/dist/chunk-KEGYUHBU.js.map +1 -0
  125. package/dist/cli/index.js +64 -63
  126. package/dist/cli/index.js.map +1 -1
  127. package/dist/eslint-plugin/index.cjs +95 -626
  128. package/dist/eslint-plugin/index.cjs.map +1 -1
  129. package/dist/eslint-plugin/index.js +94 -625
  130. package/dist/eslint-plugin/index.js.map +1 -1
  131. package/dist/evidence.cjs.map +1 -1
  132. package/dist/evidence.js.map +1 -1
  133. package/dist/helpers.cjs +4 -9
  134. package/dist/helpers.cjs.map +1 -1
  135. package/dist/helpers.js +4 -9
  136. package/dist/helpers.js.map +1 -1
  137. package/dist/index.cjs +11 -25
  138. package/dist/index.cjs.map +1 -1
  139. package/dist/index.js +11 -25
  140. package/dist/index.js.map +1 -1
  141. package/dist/node.cjs +10 -8
  142. package/dist/node.cjs.map +1 -1
  143. package/dist/node.js +10 -8
  144. package/dist/node.js.map +1 -1
  145. package/examples/README.md +95 -0
  146. package/node_modules/@typescript/old/LICENSE.txt +55 -0
  147. package/node_modules/@typescript/old/README.md +50 -0
  148. package/node_modules/@typescript/old/SECURITY.md +39 -0
  149. package/node_modules/@typescript/old/ThirdPartyNoticeText.txt +193 -0
  150. package/node_modules/@typescript/old/bin/tsc +2 -0
  151. package/node_modules/@typescript/old/bin/tsserver +2 -0
  152. package/node_modules/@typescript/old/lib/_tsc.js +134465 -0
  153. package/node_modules/@typescript/old/lib/_tsserver.js +659 -0
  154. package/node_modules/@typescript/old/lib/_typingsInstaller.js +222 -0
  155. package/node_modules/@typescript/old/lib/cs/diagnosticMessages.generated.json +2129 -0
  156. package/node_modules/@typescript/old/lib/de/diagnosticMessages.generated.json +2125 -0
  157. package/node_modules/@typescript/old/lib/es/diagnosticMessages.generated.json +2129 -0
  158. package/node_modules/@typescript/old/lib/fr/diagnosticMessages.generated.json +2129 -0
  159. package/node_modules/@typescript/old/lib/it/diagnosticMessages.generated.json +2125 -0
  160. package/node_modules/@typescript/old/lib/ja/diagnosticMessages.generated.json +2129 -0
  161. package/node_modules/@typescript/old/lib/ko/diagnosticMessages.generated.json +2129 -0
  162. package/node_modules/@typescript/old/lib/lib.d.ts +20 -0
  163. package/node_modules/@typescript/old/lib/lib.decorators.d.ts +382 -0
  164. package/node_modules/@typescript/old/lib/lib.decorators.legacy.d.ts +20 -0
  165. package/node_modules/@typescript/old/lib/lib.dom.asynciterable.d.ts +18 -0
  166. package/node_modules/@typescript/old/lib/lib.dom.d.ts +45125 -0
  167. package/node_modules/@typescript/old/lib/lib.dom.iterable.d.ts +18 -0
  168. package/node_modules/@typescript/old/lib/lib.es2015.collection.d.ts +150 -0
  169. package/node_modules/@typescript/old/lib/lib.es2015.core.d.ts +595 -0
  170. package/node_modules/@typescript/old/lib/lib.es2015.d.ts +26 -0
  171. package/node_modules/@typescript/old/lib/lib.es2015.generator.d.ts +75 -0
  172. package/node_modules/@typescript/old/lib/lib.es2015.iterable.d.ts +603 -0
  173. package/node_modules/@typescript/old/lib/lib.es2015.promise.d.ts +79 -0
  174. package/node_modules/@typescript/old/lib/lib.es2015.proxy.d.ts +126 -0
  175. package/node_modules/@typescript/old/lib/lib.es2015.reflect.d.ts +142 -0
  176. package/node_modules/@typescript/old/lib/lib.es2015.symbol.d.ts +44 -0
  177. package/node_modules/@typescript/old/lib/lib.es2015.symbol.wellknown.d.ts +324 -0
  178. package/node_modules/@typescript/old/lib/lib.es2016.array.include.d.ts +114 -0
  179. package/node_modules/@typescript/old/lib/lib.es2016.d.ts +19 -0
  180. package/node_modules/@typescript/old/lib/lib.es2016.full.d.ts +21 -0
  181. package/node_modules/@typescript/old/lib/lib.es2016.intl.d.ts +29 -0
  182. package/node_modules/@typescript/old/lib/lib.es2017.arraybuffer.d.ts +19 -0
  183. package/node_modules/@typescript/old/lib/lib.es2017.d.ts +24 -0
  184. package/node_modules/@typescript/old/lib/lib.es2017.date.d.ts +29 -0
  185. package/node_modules/@typescript/old/lib/lib.es2017.full.d.ts +21 -0
  186. package/node_modules/@typescript/old/lib/lib.es2017.intl.d.ts +42 -0
  187. package/node_modules/@typescript/old/lib/lib.es2017.object.d.ts +47 -0
  188. package/node_modules/@typescript/old/lib/lib.es2017.sharedmemory.d.ts +133 -0
  189. package/node_modules/@typescript/old/lib/lib.es2017.string.d.ts +43 -0
  190. package/node_modules/@typescript/old/lib/lib.es2017.typedarrays.d.ts +51 -0
  191. package/node_modules/@typescript/old/lib/lib.es2018.asyncgenerator.d.ts +75 -0
  192. package/node_modules/@typescript/old/lib/lib.es2018.asynciterable.d.ts +51 -0
  193. package/node_modules/@typescript/old/lib/lib.es2018.d.ts +22 -0
  194. package/node_modules/@typescript/old/lib/lib.es2018.full.d.ts +22 -0
  195. package/node_modules/@typescript/old/lib/lib.es2018.intl.d.ts +81 -0
  196. package/node_modules/@typescript/old/lib/lib.es2018.promise.d.ts +28 -0
  197. package/node_modules/@typescript/old/lib/lib.es2018.regexp.d.ts +35 -0
  198. package/node_modules/@typescript/old/lib/lib.es2019.array.d.ts +77 -0
  199. package/node_modules/@typescript/old/lib/lib.es2019.d.ts +22 -0
  200. package/node_modules/@typescript/old/lib/lib.es2019.full.d.ts +22 -0
  201. package/node_modules/@typescript/old/lib/lib.es2019.intl.d.ts +21 -0
  202. package/node_modules/@typescript/old/lib/lib.es2019.object.d.ts +31 -0
  203. package/node_modules/@typescript/old/lib/lib.es2019.string.d.ts +35 -0
  204. package/node_modules/@typescript/old/lib/lib.es2019.symbol.d.ts +22 -0
  205. package/node_modules/@typescript/old/lib/lib.es2020.bigint.d.ts +763 -0
  206. package/node_modules/@typescript/old/lib/lib.es2020.d.ts +25 -0
  207. package/node_modules/@typescript/old/lib/lib.es2020.date.d.ts +40 -0
  208. package/node_modules/@typescript/old/lib/lib.es2020.full.d.ts +22 -0
  209. package/node_modules/@typescript/old/lib/lib.es2020.intl.d.ts +472 -0
  210. package/node_modules/@typescript/old/lib/lib.es2020.number.d.ts +26 -0
  211. package/node_modules/@typescript/old/lib/lib.es2020.promise.d.ts +45 -0
  212. package/node_modules/@typescript/old/lib/lib.es2020.sharedmemory.d.ts +97 -0
  213. package/node_modules/@typescript/old/lib/lib.es2020.string.d.ts +42 -0
  214. package/node_modules/@typescript/old/lib/lib.es2020.symbol.wellknown.d.ts +39 -0
  215. package/node_modules/@typescript/old/lib/lib.es2021.d.ts +21 -0
  216. package/node_modules/@typescript/old/lib/lib.es2021.full.d.ts +22 -0
  217. package/node_modules/@typescript/old/lib/lib.es2021.intl.d.ts +164 -0
  218. package/node_modules/@typescript/old/lib/lib.es2021.promise.d.ts +46 -0
  219. package/node_modules/@typescript/old/lib/lib.es2021.string.d.ts +31 -0
  220. package/node_modules/@typescript/old/lib/lib.es2021.weakref.d.ts +76 -0
  221. package/node_modules/@typescript/old/lib/lib.es2022.array.d.ts +119 -0
  222. package/node_modules/@typescript/old/lib/lib.es2022.d.ts +23 -0
  223. package/node_modules/@typescript/old/lib/lib.es2022.error.d.ts +73 -0
  224. package/node_modules/@typescript/old/lib/lib.es2022.full.d.ts +22 -0
  225. package/node_modules/@typescript/old/lib/lib.es2022.intl.d.ts +143 -0
  226. package/node_modules/@typescript/old/lib/lib.es2022.object.d.ts +24 -0
  227. package/node_modules/@typescript/old/lib/lib.es2022.regexp.d.ts +37 -0
  228. package/node_modules/@typescript/old/lib/lib.es2022.string.d.ts +23 -0
  229. package/node_modules/@typescript/old/lib/lib.es2023.array.d.ts +922 -0
  230. package/node_modules/@typescript/old/lib/lib.es2023.collection.d.ts +19 -0
  231. package/node_modules/@typescript/old/lib/lib.es2023.d.ts +20 -0
  232. package/node_modules/@typescript/old/lib/lib.es2023.full.d.ts +22 -0
  233. package/node_modules/@typescript/old/lib/lib.es2023.intl.d.ts +62 -0
  234. package/node_modules/@typescript/old/lib/lib.es2024.arraybuffer.d.ts +63 -0
  235. package/node_modules/@typescript/old/lib/lib.es2024.collection.d.ts +27 -0
  236. package/node_modules/@typescript/old/lib/lib.es2024.d.ts +24 -0
  237. package/node_modules/@typescript/old/lib/lib.es2024.full.d.ts +22 -0
  238. package/node_modules/@typescript/old/lib/lib.es2024.object.d.ts +27 -0
  239. package/node_modules/@typescript/old/lib/lib.es2024.promise.d.ts +33 -0
  240. package/node_modules/@typescript/old/lib/lib.es2024.regexp.d.ts +23 -0
  241. package/node_modules/@typescript/old/lib/lib.es2024.sharedmemory.d.ts +66 -0
  242. package/node_modules/@typescript/old/lib/lib.es2024.string.d.ts +27 -0
  243. package/node_modules/@typescript/old/lib/lib.es2025.collection.d.ts +94 -0
  244. package/node_modules/@typescript/old/lib/lib.es2025.d.ts +23 -0
  245. package/node_modules/@typescript/old/lib/lib.es2025.float16.d.ts +443 -0
  246. package/node_modules/@typescript/old/lib/lib.es2025.full.d.ts +22 -0
  247. package/node_modules/@typescript/old/lib/lib.es2025.intl.d.ts +200 -0
  248. package/node_modules/@typescript/old/lib/lib.es2025.iterator.d.ts +146 -0
  249. package/node_modules/@typescript/old/lib/lib.es2025.promise.d.ts +32 -0
  250. package/node_modules/@typescript/old/lib/lib.es2025.regexp.d.ts +30 -0
  251. package/node_modules/@typescript/old/lib/lib.es5.d.ts +4599 -0
  252. package/node_modules/@typescript/old/lib/lib.es6.d.ts +21 -0
  253. package/node_modules/@typescript/old/lib/lib.esnext.array.d.ts +33 -0
  254. package/node_modules/@typescript/old/lib/lib.esnext.collection.d.ts +47 -0
  255. package/node_modules/@typescript/old/lib/lib.esnext.d.ts +27 -0
  256. package/node_modules/@typescript/old/lib/lib.esnext.date.d.ts +21 -0
  257. package/node_modules/@typescript/old/lib/lib.esnext.decorators.d.ts +26 -0
  258. package/node_modules/@typescript/old/lib/lib.esnext.disposable.d.ts +191 -0
  259. package/node_modules/@typescript/old/lib/lib.esnext.error.d.ts +22 -0
  260. package/node_modules/@typescript/old/lib/lib.esnext.full.d.ts +22 -0
  261. package/node_modules/@typescript/old/lib/lib.esnext.intl.d.ts +107 -0
  262. package/node_modules/@typescript/old/lib/lib.esnext.sharedmemory.d.ts +23 -0
  263. package/node_modules/@typescript/old/lib/lib.esnext.temporal.d.ts +485 -0
  264. package/node_modules/@typescript/old/lib/lib.esnext.typedarrays.d.ts +90 -0
  265. package/node_modules/@typescript/old/lib/lib.scripthost.d.ts +320 -0
  266. package/node_modules/@typescript/old/lib/lib.webworker.asynciterable.d.ts +18 -0
  267. package/node_modules/@typescript/old/lib/lib.webworker.d.ts +15606 -0
  268. package/node_modules/@typescript/old/lib/lib.webworker.importscripts.d.ts +21 -0
  269. package/node_modules/@typescript/old/lib/lib.webworker.iterable.d.ts +18 -0
  270. package/node_modules/@typescript/old/lib/pl/diagnosticMessages.generated.json +2129 -0
  271. package/node_modules/@typescript/old/lib/pt-br/diagnosticMessages.generated.json +2129 -0
  272. package/node_modules/@typescript/old/lib/ru/diagnosticMessages.generated.json +2125 -0
  273. package/node_modules/@typescript/old/lib/tr/diagnosticMessages.generated.json +2129 -0
  274. package/node_modules/@typescript/old/lib/tsc.js +8 -0
  275. package/node_modules/@typescript/old/lib/tsserver.js +8 -0
  276. package/node_modules/@typescript/old/lib/tsserverlibrary.d.ts +17 -0
  277. package/node_modules/@typescript/old/lib/tsserverlibrary.js +21 -0
  278. package/node_modules/@typescript/old/lib/typesMap.json +497 -0
  279. package/node_modules/@typescript/old/lib/typescript.d.ts +11448 -0
  280. package/node_modules/@typescript/old/lib/typescript.js +201039 -0
  281. package/node_modules/@typescript/old/lib/typingsInstaller.js +8 -0
  282. package/node_modules/@typescript/old/lib/watchGuard.js +53 -0
  283. package/node_modules/@typescript/old/lib/zh-cn/diagnosticMessages.generated.json +2129 -0
  284. package/node_modules/@typescript/old/lib/zh-tw/diagnosticMessages.generated.json +2125 -0
  285. package/node_modules/@typescript/old/package.json +118 -0
  286. package/node_modules/@typescript/typescript6/LICENSE.txt +55 -0
  287. package/node_modules/@typescript/typescript6/README.md +9 -0
  288. package/node_modules/@typescript/typescript6/bin/tsc6 +2 -0
  289. package/node_modules/@typescript/typescript6/lib/tsc.js +1 -0
  290. package/node_modules/@typescript/typescript6/lib/tsserverlibrary.d.ts +2 -0
  291. package/node_modules/@typescript/typescript6/lib/tsserverlibrary.js +1 -0
  292. package/node_modules/@typescript/typescript6/lib/typescript.d.ts +2 -0
  293. package/node_modules/@typescript/typescript6/lib/typescript.js +1 -0
  294. package/node_modules/@typescript/typescript6/package.json +39 -0
  295. package/package.json +74 -22
  296. package/schemas/env-cap-report.schema.json +1 -1
  297. package/skills/env-cap/SKILL.md +91 -0
  298. package/skills/env-cap/references/api.md +220 -0
  299. package/specs/architecture.md +634 -0
  300. package/specs/decisions/0001-runtime-documentation-separation.md +197 -0
  301. package/specs/decisions/0002-static-analysis-never-execution.md +233 -0
  302. package/specs/decisions/0003-no-global-env-object.md +172 -0
  303. package/specs/decisions/0004-no-client-server-package-split.md +116 -0
  304. package/specs/decisions/0005-warn-not-throw-by-default.md +93 -0
  305. package/specs/decisions/0006-self-redacting-contracts.md +124 -0
  306. package/specs/decisions/0007-processor-not-transformer.md +109 -0
  307. package/specs/decisions/0008-gzip-size-budget.md +173 -0
  308. package/specs/decisions/0009-exclusive-groups-are-always-errors.md +139 -0
  309. package/specs/decisions/0010-dependency-ownership-engine-scope-boundary.md +100 -0
  310. package/specs/decisions/0011-shared-discovery-compute-atomic-write-non-atomic.md +104 -0
  311. package/specs/decisions/0012-live-expiration-overrides-not-ast-functions.md +145 -0
  312. package/specs/decisions/0013-json-output-is-a-versioned-mirror.md +136 -0
  313. package/specs/decisions/0014-cross-package-schema-discovery.md +206 -0
  314. package/specs/decisions/0015-security-backport-window.md +60 -0
  315. package/specs/decisions/0016-check-mode-compute-before-compare-never-partial-write.md +113 -0
  316. package/specs/decisions/0017-eslint-plugin-entry-point.md +113 -0
  317. package/specs/decisions/0018-rotation-alert-issue-on-non-pr-runs.md +104 -0
  318. package/specs/decisions/0019-published-json-schema-generated-from-types.md +100 -0
  319. package/specs/decisions/0020-declaration-maps-via-separate-tsc-pass.md +101 -0
  320. package/specs/decisions/0021-manifest-change-report-persisted-snapshot.md +177 -0
  321. package/specs/decisions/0022-validation-contexts.md +267 -0
  322. package/specs/decisions/0023-tsconfig-path-alias-resolution.md +182 -0
  323. package/specs/decisions/0024-fact-model-architecture.md +144 -0
  324. package/specs/decisions/0025-contract-model-json-projection.md +105 -0
  325. package/specs/decisions/0026-finding-model-unifies-four-families.md +109 -0
  326. package/specs/decisions/0027-dependency-model-fact-shape-not-engine-access.md +98 -0
  327. package/specs/decisions/0028-ownership-model-shared-effective-owner.md +85 -0
  328. package/specs/decisions/0029-lifecycle-model-deprecation-rename-fields.md +98 -0
  329. package/specs/decisions/0030-change-model-wraps-manifest-change-report.md +97 -0
  330. package/specs/decisions/0031-evidence-entry-point.md +85 -0
  331. package/specs/decisions/0032-evidence-projection-provenance-mechanism.md +120 -0
  332. package/specs/decisions/0033-reference-projections-live-in-examples.md +81 -0
  333. package/specs/decisions/0034-three-tier-examples-restructuring.md +85 -0
  334. package/specs/decisions/0035-documentenv-metadata-generalization-and-compliance-fields.md +85 -0
  335. package/specs/decisions/0036-exact-source-position-evidence.md +122 -0
  336. package/specs/decisions/0037-developer-declared-dynamic-access-citations.md +114 -0
  337. package/specs/decisions/0038-always-computed-evidence-model-backs-generate-check-docs.md +244 -0
  338. package/specs/decisions/0039-scanner-local-dataflow-boundary.md +160 -0
  339. package/specs/decisions/0040-library-surfaces-do-not-acquire-node-fs.md +156 -0
  340. package/specs/decisions/0041-dual-package-hazard-checked-documented.md +75 -0
  341. package/specs/decisions/0042-init-cli-subcommand-scaffolds-only.md +95 -0
  342. package/specs/decisions/0043-env-cap-resolver-relocated-and-duplicated.md +71 -0
  343. package/specs/decisions/0044-strict-escalates-every-warning-family.md +88 -0
  344. package/specs/decisions/0045-promote-experimental-surfaces-to-stable.md +103 -0
  345. package/specs/decisions/0046-cli-restricted-to-runtime-and-evidence-output.md +177 -0
  346. package/specs/decisions/0047-supported-toolchain-node-22-and-typescript-5-6.md +30 -0
  347. package/specs/decisions/0048-eslint-plugin-does-not-vendor-typescript-eslint.md +25 -0
  348. package/specs/decisions/0049-typescript-7-scanner-uses-a-bundled-typescript-6.md +87 -0
  349. package/specs/decisions/0050-a-variable-declared-twice-is-documented-once.md +55 -0
  350. package/specs/generated-artifacts.md +104 -0
  351. package/specs/migrations/README.md +30 -0
  352. package/specs/migrations/from-centralized-schema.md +503 -0
  353. package/specs/migrations/from-dotenv.md +352 -0
  354. package/specs/migrations/from-envalid.md +482 -0
  355. package/specs/migrations/from-process-env.md +398 -0
  356. package/specs/migrations/from-t3-env.md +416 -0
  357. package/specs/migrations/from-zod.md +303 -0
  358. package/dist/build-U326PI5A.js.map +0 -1
  359. package/dist/chunk-BSTLSR2R.js.map +0 -1
@@ -0,0 +1,659 @@
1
+ /*! *****************************************************************************
2
+ Copyright (c) Microsoft Corporation. All rights reserved.
3
+ Licensed under the Apache License, Version 2.0 (the "License"); you may not use
4
+ this file except in compliance with the License. You may obtain a copy of the
5
+ License at http://www.apache.org/licenses/LICENSE-2.0
6
+
7
+ THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
8
+ KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
9
+ WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
10
+ MERCHANTABILITY OR NON-INFRINGEMENT.
11
+
12
+ See the Apache Version 2.0 License for specific language governing permissions
13
+ and limitations under the License.
14
+ ***************************************************************************** */
15
+
16
+
17
+ "use strict";
18
+ var __create = Object.create;
19
+ var __defProp = Object.defineProperty;
20
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
21
+ var __getOwnPropNames = Object.getOwnPropertyNames;
22
+ var __getProtoOf = Object.getPrototypeOf;
23
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
24
+ var __copyProps = (to, from, except, desc) => {
25
+ if (from && typeof from === "object" || typeof from === "function") {
26
+ for (let key of __getOwnPropNames(from))
27
+ if (!__hasOwnProp.call(to, key) && key !== except)
28
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
29
+ }
30
+ return to;
31
+ };
32
+ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
33
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
34
+ // If the importer is in node compatibility mode or this is not an ESM
35
+ // file that has been converted to a CommonJS file using a Babel-
36
+ // compatible transform (i.e. "__esModule" has not been set), then set
37
+ // "default" to the CommonJS "module.exports" for node compatibility.
38
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
39
+ mod
40
+ ));
41
+
42
+ // src/tsserver/server.ts
43
+ var import_os2 = __toESM(require("os"));
44
+
45
+ // src/typescript/typescript.ts
46
+ var typescript_exports = {};
47
+ __reExport(typescript_exports, require("./typescript.js"));
48
+
49
+ // src/tsserver/nodeServer.ts
50
+ var import_child_process = __toESM(require("child_process"));
51
+ var import_fs = __toESM(require("fs"));
52
+ var import_net = __toESM(require("net"));
53
+ var import_os = __toESM(require("os"));
54
+ var import_readline = __toESM(require("readline"));
55
+
56
+ // src/tsserver/common.ts
57
+ function getLogLevel(level) {
58
+ if (level) {
59
+ const l = level.toLowerCase();
60
+ for (const name in typescript_exports.server.LogLevel) {
61
+ if (isNaN(+name) && l === name.toLowerCase()) {
62
+ return typescript_exports.server.LogLevel[name];
63
+ }
64
+ }
65
+ }
66
+ return void 0;
67
+ }
68
+
69
+ // src/tsserver/nodeServer.ts
70
+ function parseLoggingEnvironmentString(logEnvStr) {
71
+ if (!logEnvStr) {
72
+ return {};
73
+ }
74
+ const logEnv = { logToFile: true };
75
+ const args = logEnvStr.split(" ");
76
+ const len = args.length - 1;
77
+ for (let i = 0; i < len; i += 2) {
78
+ const option = args[i];
79
+ const { value, extraPartCounter } = getEntireValue(i + 1);
80
+ i += extraPartCounter;
81
+ if (option && value) {
82
+ switch (option) {
83
+ case "-file":
84
+ logEnv.file = value;
85
+ break;
86
+ case "-level":
87
+ const level = getLogLevel(value);
88
+ logEnv.detailLevel = level !== void 0 ? level : typescript_exports.server.LogLevel.normal;
89
+ break;
90
+ case "-traceToConsole":
91
+ logEnv.traceToConsole = value.toLowerCase() === "true";
92
+ break;
93
+ case "-logToFile":
94
+ logEnv.logToFile = value.toLowerCase() === "true";
95
+ break;
96
+ }
97
+ }
98
+ }
99
+ return logEnv;
100
+ function getEntireValue(initialIndex) {
101
+ let pathStart = args[initialIndex];
102
+ let extraPartCounter = 0;
103
+ if (pathStart.charCodeAt(0) === typescript_exports.CharacterCodes.doubleQuote && pathStart.charCodeAt(pathStart.length - 1) !== typescript_exports.CharacterCodes.doubleQuote) {
104
+ for (let i = initialIndex + 1; i < args.length; i++) {
105
+ pathStart += " ";
106
+ pathStart += args[i];
107
+ extraPartCounter++;
108
+ if (pathStart.charCodeAt(pathStart.length - 1) === typescript_exports.CharacterCodes.doubleQuote) break;
109
+ }
110
+ }
111
+ return { value: (0, typescript_exports.stripQuotes)(pathStart), extraPartCounter };
112
+ }
113
+ }
114
+ function parseServerMode() {
115
+ const mode = typescript_exports.server.findArgument("--serverMode");
116
+ if (!mode) return void 0;
117
+ switch (mode.toLowerCase()) {
118
+ case "semantic":
119
+ return typescript_exports.LanguageServiceMode.Semantic;
120
+ case "partialsemantic":
121
+ return typescript_exports.LanguageServiceMode.PartialSemantic;
122
+ case "syntactic":
123
+ return typescript_exports.LanguageServiceMode.Syntactic;
124
+ default:
125
+ return mode;
126
+ }
127
+ }
128
+ function initializeNodeSystem() {
129
+ const sys4 = typescript_exports.Debug.checkDefined(typescript_exports.sys);
130
+ class Logger {
131
+ constructor(logFilename, traceToConsole, level) {
132
+ this.logFilename = logFilename;
133
+ this.traceToConsole = traceToConsole;
134
+ this.level = level;
135
+ this.seq = 0;
136
+ this.inGroup = false;
137
+ this.firstInGroup = true;
138
+ this.fd = -1;
139
+ if (this.logFilename) {
140
+ try {
141
+ this.fd = import_fs.default.openSync(this.logFilename, "w");
142
+ } catch {
143
+ }
144
+ }
145
+ }
146
+ static padStringRight(str, padding) {
147
+ return (str + padding).slice(0, padding.length);
148
+ }
149
+ close() {
150
+ if (this.fd >= 0) {
151
+ import_fs.default.close(this.fd, typescript_exports.noop);
152
+ }
153
+ }
154
+ getLogFileName() {
155
+ return this.logFilename;
156
+ }
157
+ perftrc(s) {
158
+ this.msg(s, typescript_exports.server.Msg.Perf);
159
+ }
160
+ info(s) {
161
+ this.msg(s, typescript_exports.server.Msg.Info);
162
+ }
163
+ err(s) {
164
+ this.msg(s, typescript_exports.server.Msg.Err);
165
+ }
166
+ startGroup() {
167
+ this.inGroup = true;
168
+ this.firstInGroup = true;
169
+ }
170
+ endGroup() {
171
+ this.inGroup = false;
172
+ }
173
+ loggingEnabled() {
174
+ return !!this.logFilename || this.traceToConsole;
175
+ }
176
+ hasLevel(level) {
177
+ return this.loggingEnabled() && this.level >= level;
178
+ }
179
+ msg(s, type = typescript_exports.server.Msg.Err) {
180
+ if (!this.canWrite()) return;
181
+ s = `[${typescript_exports.server.nowString()}] ${s}
182
+ `;
183
+ if (!this.inGroup || this.firstInGroup) {
184
+ const prefix = Logger.padStringRight(type + " " + this.seq.toString(), " ");
185
+ s = prefix + s;
186
+ }
187
+ this.write(s, type);
188
+ if (!this.inGroup) {
189
+ this.seq++;
190
+ }
191
+ }
192
+ canWrite() {
193
+ return this.fd >= 0 || this.traceToConsole;
194
+ }
195
+ write(s, _type) {
196
+ if (this.fd >= 0) {
197
+ const buf = Buffer.from(s);
198
+ import_fs.default.writeSync(
199
+ this.fd,
200
+ buf,
201
+ 0,
202
+ buf.length,
203
+ /*position*/
204
+ null
205
+ );
206
+ }
207
+ if (this.traceToConsole) {
208
+ console.warn(s);
209
+ }
210
+ }
211
+ }
212
+ const libDirectory = (0, typescript_exports.getDirectoryPath)((0, typescript_exports.normalizePath)(sys4.getExecutingFilePath()));
213
+ const useWatchGuard = process.platform === "win32";
214
+ const originalWatchDirectory = sys4.watchDirectory.bind(sys4);
215
+ const logger = createLogger();
216
+ typescript_exports.Debug.loggingHost = {
217
+ log(level, s) {
218
+ switch (level) {
219
+ case typescript_exports.LogLevel.Error:
220
+ case typescript_exports.LogLevel.Warning:
221
+ return logger.msg(s, typescript_exports.server.Msg.Err);
222
+ case typescript_exports.LogLevel.Info:
223
+ case typescript_exports.LogLevel.Verbose:
224
+ return logger.msg(s, typescript_exports.server.Msg.Info);
225
+ }
226
+ }
227
+ };
228
+ const pending = (0, typescript_exports.createQueue)();
229
+ let canWrite = true;
230
+ if (useWatchGuard) {
231
+ const currentDrive = extractWatchDirectoryCacheKey(
232
+ sys4.resolvePath(sys4.getCurrentDirectory()),
233
+ /*currentDriveKey*/
234
+ void 0
235
+ );
236
+ const statusCache = /* @__PURE__ */ new Map();
237
+ sys4.watchDirectory = (path, callback, recursive, options) => {
238
+ const cacheKey = extractWatchDirectoryCacheKey(path, currentDrive);
239
+ let status = cacheKey && statusCache.get(cacheKey);
240
+ if (status === void 0) {
241
+ if (logger.hasLevel(typescript_exports.server.LogLevel.verbose)) {
242
+ logger.info(`${cacheKey} for path ${path} not found in cache...`);
243
+ }
244
+ try {
245
+ const args = [(0, typescript_exports.combinePaths)(libDirectory, "watchGuard.js"), path];
246
+ if (logger.hasLevel(typescript_exports.server.LogLevel.verbose)) {
247
+ logger.info(`Starting ${process.execPath} with args:${typescript_exports.server.stringifyIndented(args)}`);
248
+ }
249
+ import_child_process.default.execFileSync(process.execPath, args, { stdio: "ignore", env: { ELECTRON_RUN_AS_NODE: "1" } });
250
+ status = true;
251
+ if (logger.hasLevel(typescript_exports.server.LogLevel.verbose)) {
252
+ logger.info(`WatchGuard for path ${path} returned: OK`);
253
+ }
254
+ } catch (e) {
255
+ status = false;
256
+ if (logger.hasLevel(typescript_exports.server.LogLevel.verbose)) {
257
+ logger.info(`WatchGuard for path ${path} returned: ${e.message}`);
258
+ }
259
+ }
260
+ if (cacheKey) {
261
+ statusCache.set(cacheKey, status);
262
+ }
263
+ } else if (logger.hasLevel(typescript_exports.server.LogLevel.verbose)) {
264
+ logger.info(`watchDirectory for ${path} uses cached drive information.`);
265
+ }
266
+ if (status) {
267
+ return watchDirectorySwallowingException(path, callback, recursive, options);
268
+ } else {
269
+ return typescript_exports.noopFileWatcher;
270
+ }
271
+ };
272
+ } else {
273
+ sys4.watchDirectory = watchDirectorySwallowingException;
274
+ }
275
+ sys4.write = (s) => writeMessage(Buffer.from(s, "utf8"));
276
+ sys4.setTimeout = setTimeout;
277
+ sys4.clearTimeout = clearTimeout;
278
+ sys4.setImmediate = setImmediate;
279
+ sys4.clearImmediate = clearImmediate;
280
+ if (typeof global !== "undefined" && global.gc) {
281
+ sys4.gc = () => {
282
+ var _a;
283
+ return (_a = global.gc) == null ? void 0 : _a.call(global);
284
+ };
285
+ }
286
+ const cancellationToken = createCancellationToken(sys4.args);
287
+ const localeStr = typescript_exports.server.findArgument("--locale");
288
+ if (localeStr) {
289
+ (0, typescript_exports.validateLocaleAndSetLanguage)(localeStr, sys4);
290
+ }
291
+ const modeOrUnknown = parseServerMode();
292
+ let serverMode;
293
+ let unknownServerMode;
294
+ if (modeOrUnknown !== void 0) {
295
+ if (typeof modeOrUnknown === "number") serverMode = modeOrUnknown;
296
+ else unknownServerMode = modeOrUnknown;
297
+ }
298
+ return {
299
+ args: process.argv,
300
+ logger,
301
+ cancellationToken,
302
+ serverMode,
303
+ unknownServerMode,
304
+ startSession: startNodeSession
305
+ };
306
+ function createLogger() {
307
+ const cmdLineLogFileName = typescript_exports.server.findArgument("--logFile");
308
+ const cmdLineVerbosity = getLogLevel(typescript_exports.server.findArgument("--logVerbosity"));
309
+ const envLogOptions = parseLoggingEnvironmentString(process.env.TSS_LOG);
310
+ const unsubstitutedLogFileName = cmdLineLogFileName ? (0, typescript_exports.stripQuotes)(cmdLineLogFileName) : envLogOptions.logToFile ? envLogOptions.file || libDirectory + "/.log" + process.pid.toString() : void 0;
311
+ const substitutedLogFileName = unsubstitutedLogFileName ? unsubstitutedLogFileName.replace("PID", process.pid.toString()) : void 0;
312
+ const logVerbosity = cmdLineVerbosity || envLogOptions.detailLevel;
313
+ return new Logger(substitutedLogFileName, envLogOptions.traceToConsole, logVerbosity);
314
+ }
315
+ function writeMessage(buf) {
316
+ if (!canWrite) {
317
+ pending.enqueue(buf);
318
+ } else {
319
+ canWrite = false;
320
+ process.stdout.write(buf, setCanWriteFlagAndWriteMessageIfNecessary);
321
+ }
322
+ }
323
+ function setCanWriteFlagAndWriteMessageIfNecessary() {
324
+ canWrite = true;
325
+ if (!pending.isEmpty()) {
326
+ writeMessage(pending.dequeue());
327
+ }
328
+ }
329
+ function extractWatchDirectoryCacheKey(path, currentDriveKey) {
330
+ path = (0, typescript_exports.normalizeSlashes)(path);
331
+ if (isUNCPath(path)) {
332
+ const firstSlash = path.indexOf(typescript_exports.directorySeparator, 2);
333
+ return firstSlash !== -1 ? (0, typescript_exports.toFileNameLowerCase)(path.substring(0, firstSlash)) : path;
334
+ }
335
+ const rootLength = (0, typescript_exports.getRootLength)(path);
336
+ if (rootLength === 0) {
337
+ return currentDriveKey;
338
+ }
339
+ if (path.charCodeAt(1) === typescript_exports.CharacterCodes.colon && path.charCodeAt(2) === typescript_exports.CharacterCodes.slash) {
340
+ return (0, typescript_exports.toFileNameLowerCase)(path.charAt(0));
341
+ }
342
+ if (path.charCodeAt(0) === typescript_exports.CharacterCodes.slash && path.charCodeAt(1) !== typescript_exports.CharacterCodes.slash) {
343
+ return currentDriveKey;
344
+ }
345
+ return void 0;
346
+ }
347
+ function isUNCPath(s) {
348
+ return s.length > 2 && s.charCodeAt(0) === typescript_exports.CharacterCodes.slash && s.charCodeAt(1) === typescript_exports.CharacterCodes.slash;
349
+ }
350
+ function watchDirectorySwallowingException(path, callback, recursive, options) {
351
+ try {
352
+ return originalWatchDirectory(path, callback, recursive, options);
353
+ } catch (e) {
354
+ logger.info(`Exception when creating directory watcher: ${e.message}`);
355
+ return typescript_exports.noopFileWatcher;
356
+ }
357
+ }
358
+ }
359
+ function parseEventPort(eventPortStr) {
360
+ const eventPort = eventPortStr === void 0 ? void 0 : parseInt(eventPortStr);
361
+ return eventPort !== void 0 && !isNaN(eventPort) ? eventPort : void 0;
362
+ }
363
+ function startNodeSession(options, logger, cancellationToken) {
364
+ const rl = import_readline.default.createInterface({
365
+ input: process.stdin,
366
+ output: process.stdout,
367
+ terminal: false
368
+ });
369
+ const _NodeTypingsInstallerAdapter = class _NodeTypingsInstallerAdapter extends typescript_exports.server.TypingsInstallerAdapter {
370
+ constructor(telemetryEnabled2, logger2, host, globalTypingsCacheLocation, typingSafeListLocation2, typesMapLocation2, npmLocation2, validateDefaultNpmLocation2, event) {
371
+ super(
372
+ telemetryEnabled2,
373
+ logger2,
374
+ host,
375
+ globalTypingsCacheLocation,
376
+ event,
377
+ _NodeTypingsInstallerAdapter.maxActiveRequestCount
378
+ );
379
+ this.typingSafeListLocation = typingSafeListLocation2;
380
+ this.typesMapLocation = typesMapLocation2;
381
+ this.npmLocation = npmLocation2;
382
+ this.validateDefaultNpmLocation = validateDefaultNpmLocation2;
383
+ }
384
+ createInstallerProcess() {
385
+ if (this.logger.hasLevel(typescript_exports.server.LogLevel.requestTime)) {
386
+ this.logger.info("Binding...");
387
+ }
388
+ const args = [typescript_exports.server.Arguments.GlobalCacheLocation, this.globalTypingsCacheLocation];
389
+ if (this.telemetryEnabled) {
390
+ args.push(typescript_exports.server.Arguments.EnableTelemetry);
391
+ }
392
+ if (this.logger.loggingEnabled() && this.logger.getLogFileName()) {
393
+ args.push(typescript_exports.server.Arguments.LogFile, (0, typescript_exports.combinePaths)((0, typescript_exports.getDirectoryPath)((0, typescript_exports.normalizeSlashes)(this.logger.getLogFileName())), `ti-${process.pid}.log`));
394
+ }
395
+ if (this.typingSafeListLocation) {
396
+ args.push(typescript_exports.server.Arguments.TypingSafeListLocation, this.typingSafeListLocation);
397
+ }
398
+ if (this.typesMapLocation) {
399
+ args.push(typescript_exports.server.Arguments.TypesMapLocation, this.typesMapLocation);
400
+ }
401
+ if (this.npmLocation) {
402
+ args.push(typescript_exports.server.Arguments.NpmLocation, this.npmLocation);
403
+ }
404
+ if (this.validateDefaultNpmLocation) {
405
+ args.push(typescript_exports.server.Arguments.ValidateDefaultNpmLocation);
406
+ }
407
+ const execArgv = [];
408
+ for (const arg of process.execArgv) {
409
+ const match = /^--((?:debug|inspect)(?:-brk)?)(?:=(\d+))?$/.exec(arg);
410
+ if (match) {
411
+ const currentPort = match[2] !== void 0 ? +match[2] : match[1].charAt(0) === "d" ? 5858 : 9229;
412
+ execArgv.push(`--${match[1]}=${currentPort + 1}`);
413
+ break;
414
+ }
415
+ }
416
+ const typingsInstaller = (0, typescript_exports.combinePaths)((0, typescript_exports.getDirectoryPath)(typescript_exports.sys.getExecutingFilePath()), "typingsInstaller.js");
417
+ this.installer = import_child_process.default.fork(typingsInstaller, args, { execArgv });
418
+ this.installer.on("message", (m) => this.handleMessage(m));
419
+ this.host.setImmediate(() => this.event({ pid: this.installer.pid }, "typingsInstallerPid"));
420
+ process.on("exit", () => {
421
+ this.installer.kill();
422
+ });
423
+ return this.installer;
424
+ }
425
+ };
426
+ // This number is essentially arbitrary. Processing more than one typings request
427
+ // at a time makes sense, but having too many in the pipe results in a hang
428
+ // (see https://github.com/nodejs/node/issues/7657).
429
+ // It would be preferable to base our limit on the amount of space left in the
430
+ // buffer, but we have yet to find a way to retrieve that value.
431
+ _NodeTypingsInstallerAdapter.maxActiveRequestCount = 10;
432
+ let NodeTypingsInstallerAdapter = _NodeTypingsInstallerAdapter;
433
+ class IOSession extends typescript_exports.server.Session {
434
+ constructor() {
435
+ const event = (body, eventName) => {
436
+ this.event(body, eventName);
437
+ };
438
+ const host = typescript_exports.sys;
439
+ const typingsInstaller = disableAutomaticTypingAcquisition ? void 0 : new NodeTypingsInstallerAdapter(telemetryEnabled, logger, host, getGlobalTypingsCacheLocation(), typingSafeListLocation, typesMapLocation, npmLocation, validateDefaultNpmLocation, event);
440
+ super({
441
+ host,
442
+ cancellationToken,
443
+ ...options,
444
+ typingsInstaller,
445
+ byteLength: Buffer.byteLength,
446
+ hrtime: process.hrtime,
447
+ logger,
448
+ canUseEvents: true,
449
+ typesMapLocation
450
+ });
451
+ this.eventPort = eventPort;
452
+ if (this.canUseEvents && this.eventPort) {
453
+ const s = import_net.default.connect({ port: this.eventPort }, () => {
454
+ this.eventSocket = s;
455
+ if (this.socketEventQueue) {
456
+ for (const event2 of this.socketEventQueue) {
457
+ this.writeToEventSocket(event2.body, event2.eventName);
458
+ }
459
+ this.socketEventQueue = void 0;
460
+ }
461
+ });
462
+ }
463
+ this.constructed = true;
464
+ }
465
+ event(body, eventName) {
466
+ typescript_exports.Debug.assert(!!this.constructed, "Should only call `IOSession.prototype.event` on an initialized IOSession");
467
+ if (this.canUseEvents && this.eventPort) {
468
+ if (!this.eventSocket) {
469
+ if (this.logger.hasLevel(typescript_exports.server.LogLevel.verbose)) {
470
+ this.logger.info(`eventPort: event "${eventName}" queued, but socket not yet initialized`);
471
+ }
472
+ (this.socketEventQueue || (this.socketEventQueue = [])).push({ body, eventName });
473
+ return;
474
+ } else {
475
+ typescript_exports.Debug.assert(this.socketEventQueue === void 0);
476
+ this.writeToEventSocket(body, eventName);
477
+ }
478
+ } else {
479
+ super.event(body, eventName);
480
+ }
481
+ }
482
+ writeToEventSocket(body, eventName) {
483
+ this.eventSocket.write(typescript_exports.server.formatMessage(typescript_exports.server.toEvent(eventName, body), this.logger, this.byteLength, this.host.newLine), "utf8");
484
+ }
485
+ exit() {
486
+ var _a;
487
+ this.logger.info("Exiting...");
488
+ this.projectService.closeLog();
489
+ (_a = typescript_exports.tracing) == null ? void 0 : _a.stopTracing();
490
+ process.exit(0);
491
+ }
492
+ listen() {
493
+ rl.on("line", (input) => {
494
+ const message = input.trim();
495
+ this.onMessage(message);
496
+ });
497
+ rl.on("close", () => {
498
+ this.exit();
499
+ });
500
+ }
501
+ }
502
+ class IpcIOSession extends IOSession {
503
+ writeMessage(msg) {
504
+ const verboseLogging = logger.hasLevel(typescript_exports.server.LogLevel.verbose);
505
+ if (verboseLogging) {
506
+ const json = JSON.stringify(msg);
507
+ logger.info(`${msg.type}:${typescript_exports.server.indent(json)}`);
508
+ }
509
+ process.send(msg);
510
+ }
511
+ parseMessage(message) {
512
+ return message;
513
+ }
514
+ toStringMessage(message) {
515
+ return JSON.stringify(message, void 0, 2);
516
+ }
517
+ listen() {
518
+ process.on("message", (e) => {
519
+ this.onMessage(e);
520
+ });
521
+ process.on("disconnect", () => {
522
+ this.exit();
523
+ });
524
+ }
525
+ }
526
+ const eventPort = parseEventPort(typescript_exports.server.findArgument("--eventPort"));
527
+ const typingSafeListLocation = typescript_exports.server.findArgument(typescript_exports.server.Arguments.TypingSafeListLocation);
528
+ const typesMapLocation = typescript_exports.server.findArgument(typescript_exports.server.Arguments.TypesMapLocation) || (0, typescript_exports.combinePaths)((0, typescript_exports.getDirectoryPath)(typescript_exports.sys.getExecutingFilePath()), "typesMap.json");
529
+ const npmLocation = typescript_exports.server.findArgument(typescript_exports.server.Arguments.NpmLocation);
530
+ const validateDefaultNpmLocation = typescript_exports.server.hasArgument(typescript_exports.server.Arguments.ValidateDefaultNpmLocation);
531
+ const disableAutomaticTypingAcquisition = typescript_exports.server.hasArgument("--disableAutomaticTypingAcquisition");
532
+ const useNodeIpc = typescript_exports.server.hasArgument("--useNodeIpc");
533
+ const telemetryEnabled = typescript_exports.server.hasArgument(typescript_exports.server.Arguments.EnableTelemetry);
534
+ const commandLineTraceDir = typescript_exports.server.findArgument("--traceDirectory");
535
+ const traceDir = commandLineTraceDir ? (0, typescript_exports.stripQuotes)(commandLineTraceDir) : process.env.TSS_TRACE;
536
+ if (traceDir) {
537
+ (0, typescript_exports.startTracing)("server", traceDir);
538
+ }
539
+ const ioSession = useNodeIpc ? new IpcIOSession() : new IOSession();
540
+ process.on("uncaughtException", (err) => {
541
+ ioSession.logError(err, "unknown");
542
+ });
543
+ process.noAsar = true;
544
+ ioSession.listen();
545
+ function getGlobalTypingsCacheLocation() {
546
+ switch (process.platform) {
547
+ case "win32": {
548
+ const basePath = process.env.LOCALAPPDATA || process.env.APPDATA || import_os.default.homedir && import_os.default.homedir() || process.env.USERPROFILE || process.env.HOMEDRIVE && process.env.HOMEPATH && (0, typescript_exports.normalizeSlashes)(process.env.HOMEDRIVE + process.env.HOMEPATH) || import_os.default.tmpdir();
549
+ return (0, typescript_exports.combinePaths)((0, typescript_exports.combinePaths)((0, typescript_exports.normalizeSlashes)(basePath), "Microsoft/TypeScript"), typescript_exports.versionMajorMinor);
550
+ }
551
+ case "openbsd":
552
+ case "freebsd":
553
+ case "netbsd":
554
+ case "darwin":
555
+ case "linux":
556
+ case "android": {
557
+ const cacheLocation = getNonWindowsCacheLocation(process.platform === "darwin");
558
+ return (0, typescript_exports.combinePaths)((0, typescript_exports.combinePaths)(cacheLocation, "typescript"), typescript_exports.versionMajorMinor);
559
+ }
560
+ default:
561
+ return typescript_exports.Debug.fail(`unsupported platform '${process.platform}'`);
562
+ }
563
+ }
564
+ function getNonWindowsCacheLocation(platformIsDarwin) {
565
+ if (process.env.XDG_CACHE_HOME) {
566
+ return process.env.XDG_CACHE_HOME;
567
+ }
568
+ const usersDir = platformIsDarwin ? "Users" : "home";
569
+ const homePath = import_os.default.homedir && import_os.default.homedir() || process.env.HOME || (process.env.LOGNAME || process.env.USER) && `/${usersDir}/${process.env.LOGNAME || process.env.USER}` || import_os.default.tmpdir();
570
+ const cacheFolder = platformIsDarwin ? "Library/Caches" : ".cache";
571
+ return (0, typescript_exports.combinePaths)((0, typescript_exports.normalizeSlashes)(homePath), cacheFolder);
572
+ }
573
+ }
574
+ function pipeExists(name) {
575
+ return import_fs.default.existsSync(name);
576
+ }
577
+ function createCancellationToken(args) {
578
+ let cancellationPipeName;
579
+ for (let i = 0; i < args.length - 1; i++) {
580
+ if (args[i] === "--cancellationPipeName") {
581
+ cancellationPipeName = args[i + 1];
582
+ break;
583
+ }
584
+ }
585
+ if (!cancellationPipeName) {
586
+ return typescript_exports.server.nullCancellationToken;
587
+ }
588
+ if (cancellationPipeName.charAt(cancellationPipeName.length - 1) === "*") {
589
+ const namePrefix = cancellationPipeName.slice(0, -1);
590
+ if (namePrefix.length === 0 || namePrefix.includes("*")) {
591
+ throw new Error("Invalid name for template cancellation pipe: it should have length greater than 2 characters and contain only one '*'.");
592
+ }
593
+ let perRequestPipeName;
594
+ let currentRequestId;
595
+ return {
596
+ isCancellationRequested: () => perRequestPipeName !== void 0 && pipeExists(perRequestPipeName),
597
+ setRequest(requestId) {
598
+ currentRequestId = requestId;
599
+ perRequestPipeName = namePrefix + requestId;
600
+ },
601
+ resetRequest(requestId) {
602
+ if (currentRequestId !== requestId) {
603
+ throw new Error(`Mismatched request id, expected ${currentRequestId}, actual ${requestId}`);
604
+ }
605
+ perRequestPipeName = void 0;
606
+ }
607
+ };
608
+ } else {
609
+ return {
610
+ isCancellationRequested: () => pipeExists(cancellationPipeName),
611
+ setRequest: (_requestId) => void 0,
612
+ resetRequest: (_requestId) => void 0
613
+ };
614
+ }
615
+ }
616
+
617
+ // src/tsserver/server.ts
618
+ function findArgumentStringArray(argName) {
619
+ const arg = typescript_exports.server.findArgument(argName);
620
+ if (arg === void 0) {
621
+ return typescript_exports.emptyArray;
622
+ }
623
+ return arg.split(",").filter((name) => name !== "");
624
+ }
625
+ function start({ args, logger, cancellationToken, serverMode, unknownServerMode, startSession: startServer }, platform) {
626
+ logger.info(`Starting TS Server`);
627
+ logger.info(`Version: ${typescript_exports.version}`);
628
+ logger.info(`Arguments: ${args.join(" ")}`);
629
+ logger.info(`Platform: ${platform} NodeVersion: ${process.version} CaseSensitive: ${typescript_exports.sys.useCaseSensitiveFileNames}`);
630
+ logger.info(`ServerMode: ${serverMode} hasUnknownServerMode: ${unknownServerMode}`);
631
+ typescript_exports.setStackTraceLimit();
632
+ if (typescript_exports.Debug.isDebugging) {
633
+ typescript_exports.Debug.enableDebugInfo();
634
+ }
635
+ if (typescript_exports.sys.tryEnableSourceMapsForHost && /^development$/i.test(typescript_exports.sys.getEnvironmentVariable("NODE_ENV"))) {
636
+ typescript_exports.sys.tryEnableSourceMapsForHost();
637
+ }
638
+ console.log = (...args2) => logger.msg(args2.length === 1 ? args2[0] : args2.join(", "), typescript_exports.server.Msg.Info);
639
+ console.warn = (...args2) => logger.msg(args2.length === 1 ? args2[0] : args2.join(", "), typescript_exports.server.Msg.Err);
640
+ console.error = (...args2) => logger.msg(args2.length === 1 ? args2[0] : args2.join(", "), typescript_exports.server.Msg.Err);
641
+ startServer(
642
+ {
643
+ globalPlugins: findArgumentStringArray("--globalPlugins"),
644
+ pluginProbeLocations: findArgumentStringArray("--pluginProbeLocations"),
645
+ allowLocalPluginLoads: typescript_exports.server.hasArgument("--allowLocalPluginLoads"),
646
+ useSingleInferredProject: typescript_exports.server.hasArgument("--useSingleInferredProject"),
647
+ useInferredProjectPerProjectRoot: typescript_exports.server.hasArgument("--useInferredProjectPerProjectRoot"),
648
+ suppressDiagnosticEvents: typescript_exports.server.hasArgument("--suppressDiagnosticEvents"),
649
+ noGetErrOnBackgroundUpdate: typescript_exports.server.hasArgument("--noGetErrOnBackgroundUpdate"),
650
+ canUseWatchEvents: typescript_exports.server.hasArgument("--canUseWatchEvents"),
651
+ serverMode
652
+ },
653
+ logger,
654
+ cancellationToken
655
+ );
656
+ }
657
+ typescript_exports.setStackTraceLimit();
658
+ start(initializeNodeSystem(), import_os2.default.platform());
659
+ //# sourceMappingURL=_tsserver.js.map