@marinoscar/platform-cli 0.1.0-next.3 → 0.1.0-next.30

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 (943) hide show
  1. package/CHANGELOG.md +358 -0
  2. package/README.md +163 -31
  3. package/dist/android/build.d.ts +30 -0
  4. package/dist/android/build.d.ts.map +1 -0
  5. package/dist/android/build.js +126 -0
  6. package/dist/android/build.js.map +1 -0
  7. package/dist/android/command.d.ts +21 -0
  8. package/dist/android/command.d.ts.map +1 -0
  9. package/dist/android/command.js +355 -0
  10. package/dist/android/command.js.map +1 -0
  11. package/dist/android/deploy-step.d.ts +85 -0
  12. package/dist/android/deploy-step.d.ts.map +1 -0
  13. package/dist/android/deploy-step.js +268 -0
  14. package/dist/android/deploy-step.js.map +1 -0
  15. package/dist/android/doctor.d.ts +47 -0
  16. package/dist/android/doctor.d.ts.map +1 -0
  17. package/dist/android/doctor.js +219 -0
  18. package/dist/android/doctor.js.map +1 -0
  19. package/dist/android/exec.d.ts +42 -0
  20. package/dist/android/exec.d.ts.map +1 -0
  21. package/dist/android/exec.js +103 -0
  22. package/dist/android/exec.js.map +1 -0
  23. package/dist/android/fix-plan.d.ts +44 -0
  24. package/dist/android/fix-plan.d.ts.map +1 -0
  25. package/dist/android/fix-plan.js +86 -0
  26. package/dist/android/fix-plan.js.map +1 -0
  27. package/dist/android/git-freshness.d.ts +34 -0
  28. package/dist/android/git-freshness.d.ts.map +1 -0
  29. package/dist/android/git-freshness.js +120 -0
  30. package/dist/android/git-freshness.js.map +1 -0
  31. package/dist/android/gradle.d.ts +32 -0
  32. package/dist/android/gradle.d.ts.map +1 -0
  33. package/dist/android/gradle.js +55 -0
  34. package/dist/android/gradle.js.map +1 -0
  35. package/dist/android/identity.d.ts +27 -0
  36. package/dist/android/identity.d.ts.map +1 -0
  37. package/dist/android/identity.js +60 -0
  38. package/dist/android/identity.js.map +1 -0
  39. package/dist/android/index.d.ts +7 -0
  40. package/dist/android/index.d.ts.map +1 -0
  41. package/dist/android/index.js +8 -0
  42. package/dist/android/index.js.map +1 -0
  43. package/dist/android/installer.d.ts +28 -0
  44. package/dist/android/installer.d.ts.map +1 -0
  45. package/dist/android/installer.js +96 -0
  46. package/dist/android/installer.js.map +1 -0
  47. package/dist/android/java.d.ts +26 -0
  48. package/dist/android/java.d.ts.map +1 -0
  49. package/dist/android/java.js +65 -0
  50. package/dist/android/java.js.map +1 -0
  51. package/dist/android/keystore.d.ts +54 -0
  52. package/dist/android/keystore.d.ts.map +1 -0
  53. package/dist/android/keystore.js +159 -0
  54. package/dist/android/keystore.js.map +1 -0
  55. package/dist/android/metadata.d.ts +39 -0
  56. package/dist/android/metadata.d.ts.map +1 -0
  57. package/dist/android/metadata.js +61 -0
  58. package/dist/android/metadata.js.map +1 -0
  59. package/dist/android/operations.d.ts +42 -0
  60. package/dist/android/operations.d.ts.map +1 -0
  61. package/dist/android/operations.js +59 -0
  62. package/dist/android/operations.js.map +1 -0
  63. package/dist/android/paths.d.ts +29 -0
  64. package/dist/android/paths.d.ts.map +1 -0
  65. package/dist/android/paths.js +97 -0
  66. package/dist/android/paths.js.map +1 -0
  67. package/dist/android/publish.d.ts +37 -0
  68. package/dist/android/publish.d.ts.map +1 -0
  69. package/dist/android/publish.js +119 -0
  70. package/dist/android/publish.js.map +1 -0
  71. package/dist/android/registrations.d.ts +92 -0
  72. package/dist/android/registrations.d.ts.map +1 -0
  73. package/dist/android/registrations.js +112 -0
  74. package/dist/android/registrations.js.map +1 -0
  75. package/dist/android/release-status.d.ts +73 -0
  76. package/dist/android/release-status.d.ts.map +1 -0
  77. package/dist/android/release-status.js +161 -0
  78. package/dist/android/release-status.js.map +1 -0
  79. package/dist/android/release.d.ts +33 -0
  80. package/dist/android/release.d.ts.map +1 -0
  81. package/dist/android/release.js +59 -0
  82. package/dist/android/release.js.map +1 -0
  83. package/dist/android/screen-layout.d.ts +26 -0
  84. package/dist/android/screen-layout.d.ts.map +1 -0
  85. package/dist/android/screen-layout.js +24 -0
  86. package/dist/android/screen-layout.js.map +1 -0
  87. package/dist/android/screen-model.d.ts +56 -0
  88. package/dist/android/screen-model.d.ts.map +1 -0
  89. package/dist/android/screen-model.js +207 -0
  90. package/dist/android/screen-model.js.map +1 -0
  91. package/dist/android/screen.d.ts +8 -0
  92. package/dist/android/screen.d.ts.map +1 -0
  93. package/dist/android/screen.js +395 -0
  94. package/dist/android/screen.js.map +1 -0
  95. package/dist/android/sdk.d.ts +48 -0
  96. package/dist/android/sdk.d.ts.map +1 -0
  97. package/dist/android/sdk.js +82 -0
  98. package/dist/android/sdk.js.map +1 -0
  99. package/dist/android/server-url.d.ts +19 -0
  100. package/dist/android/server-url.d.ts.map +1 -0
  101. package/dist/android/server-url.js +36 -0
  102. package/dist/android/server-url.js.map +1 -0
  103. package/dist/android/upload-progress.d.ts +3 -0
  104. package/dist/android/upload-progress.d.ts.map +1 -0
  105. package/dist/android/upload-progress.js +47 -0
  106. package/dist/android/upload-progress.js.map +1 -0
  107. package/dist/android/version.d.ts +47 -0
  108. package/dist/android/version.d.ts.map +1 -0
  109. package/dist/android/version.js +136 -0
  110. package/dist/android/version.js.map +1 -0
  111. package/dist/api-client/index.d.ts +3 -0
  112. package/dist/api-client/index.d.ts.map +1 -0
  113. package/dist/api-client/index.js +5 -0
  114. package/dist/api-client/index.js.map +1 -0
  115. package/dist/commands/index.d.ts +52 -0
  116. package/dist/commands/index.d.ts.map +1 -0
  117. package/dist/commands/index.js +63 -0
  118. package/dist/commands/index.js.map +1 -0
  119. package/dist/core/cli-registry.d.ts +41 -0
  120. package/dist/core/cli-registry.d.ts.map +1 -0
  121. package/dist/core/cli-registry.js +49 -0
  122. package/dist/core/cli-registry.js.map +1 -0
  123. package/dist/core/command-registry.d.ts +10 -0
  124. package/dist/core/command-registry.d.ts.map +1 -1
  125. package/dist/core/command-registry.js +17 -0
  126. package/dist/core/command-registry.js.map +1 -1
  127. package/dist/core/env-annotation-registry.d.ts +58 -0
  128. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  129. package/dist/core/env-annotation-registry.js +80 -0
  130. package/dist/core/env-annotation-registry.js.map +1 -0
  131. package/dist/core/env-generator-registry.d.ts +59 -0
  132. package/dist/core/env-generator-registry.d.ts.map +1 -0
  133. package/dist/core/env-generator-registry.js +102 -0
  134. package/dist/core/env-generator-registry.js.map +1 -0
  135. package/dist/core/env-group-registry.d.ts +65 -0
  136. package/dist/core/env-group-registry.d.ts.map +1 -0
  137. package/dist/core/env-group-registry.js +77 -0
  138. package/dist/core/env-group-registry.js.map +1 -0
  139. package/dist/core/env-spec-registry.d.ts +16 -2
  140. package/dist/core/env-spec-registry.d.ts.map +1 -1
  141. package/dist/core/env-spec-registry.js +15 -0
  142. package/dist/core/env-spec-registry.js.map +1 -1
  143. package/dist/core/env-values.d.ts +3 -2
  144. package/dist/core/env-values.d.ts.map +1 -1
  145. package/dist/core/env-values.js +5 -3
  146. package/dist/core/env-values.js.map +1 -1
  147. package/dist/core/index.d.ts +10 -2
  148. package/dist/core/index.d.ts.map +1 -1
  149. package/dist/core/index.js +6 -2
  150. package/dist/core/index.js.map +1 -1
  151. package/dist/deploy/index.d.ts +3 -0
  152. package/dist/deploy/index.d.ts.map +1 -0
  153. package/dist/deploy/index.js +5 -0
  154. package/dist/deploy/index.js.map +1 -0
  155. package/dist/engine/api-client.d.ts +211 -0
  156. package/dist/engine/api-client.d.ts.map +1 -0
  157. package/dist/engine/api-client.js +350 -0
  158. package/dist/engine/api-client.js.map +1 -0
  159. package/dist/engine/browser.d.ts +18 -0
  160. package/dist/engine/browser.d.ts.map +1 -0
  161. package/dist/engine/browser.js +115 -0
  162. package/dist/engine/browser.js.map +1 -0
  163. package/dist/engine/builtin-registrations.d.ts +20 -0
  164. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  165. package/dist/engine/builtin-registrations.js +86 -0
  166. package/dist/engine/builtin-registrations.js.map +1 -0
  167. package/dist/engine/commands/api.d.ts +88 -0
  168. package/dist/engine/commands/api.d.ts.map +1 -0
  169. package/dist/engine/commands/api.js +398 -0
  170. package/dist/engine/commands/api.js.map +1 -0
  171. package/dist/engine/commands/config.d.ts +5 -0
  172. package/dist/engine/commands/config.d.ts.map +1 -0
  173. package/dist/engine/commands/config.js +83 -0
  174. package/dist/engine/commands/config.js.map +1 -0
  175. package/dist/engine/commands/deploy.d.ts +250 -0
  176. package/dist/engine/commands/deploy.d.ts.map +1 -0
  177. package/dist/engine/commands/deploy.js +1186 -0
  178. package/dist/engine/commands/deploy.js.map +1 -0
  179. package/dist/engine/commands/init.d.ts +18 -0
  180. package/dist/engine/commands/init.d.ts.map +1 -0
  181. package/dist/engine/commands/init.js +50 -0
  182. package/dist/engine/commands/init.js.map +1 -0
  183. package/dist/engine/commands/login.d.ts +4 -0
  184. package/dist/engine/commands/login.d.ts.map +1 -0
  185. package/dist/engine/commands/login.js +205 -0
  186. package/dist/engine/commands/login.js.map +1 -0
  187. package/dist/engine/commands/node.d.ts +21 -0
  188. package/dist/engine/commands/node.d.ts.map +1 -0
  189. package/dist/engine/commands/node.js +503 -0
  190. package/dist/engine/commands/node.js.map +1 -0
  191. package/dist/engine/config.d.ts +284 -0
  192. package/dist/engine/config.d.ts.map +1 -0
  193. package/dist/engine/config.js +469 -0
  194. package/dist/engine/config.js.map +1 -0
  195. package/dist/engine/conformance.d.ts +193 -0
  196. package/dist/engine/conformance.d.ts.map +1 -0
  197. package/dist/engine/conformance.js +243 -0
  198. package/dist/engine/conformance.js.map +1 -0
  199. package/dist/engine/create-cli.d.ts +181 -0
  200. package/dist/engine/create-cli.d.ts.map +1 -0
  201. package/dist/engine/create-cli.js +91 -0
  202. package/dist/engine/create-cli.js.map +1 -0
  203. package/dist/engine/deploy/about.d.ts +12 -0
  204. package/dist/engine/deploy/about.d.ts.map +1 -0
  205. package/dist/engine/deploy/about.js +110 -0
  206. package/dist/engine/deploy/about.js.map +1 -0
  207. package/dist/engine/deploy/adopt.d.ts +21 -0
  208. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  209. package/dist/engine/deploy/adopt.js +78 -0
  210. package/dist/engine/deploy/adopt.js.map +1 -0
  211. package/dist/engine/deploy/answers-file.d.ts +7 -0
  212. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  213. package/dist/engine/deploy/answers-file.js +49 -0
  214. package/dist/engine/deploy/answers-file.js.map +1 -0
  215. package/dist/engine/deploy/app-role.d.ts +278 -0
  216. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  217. package/dist/engine/deploy/app-role.js +826 -0
  218. package/dist/engine/deploy/app-role.js.map +1 -0
  219. package/dist/engine/deploy/app-version.d.ts +103 -0
  220. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  221. package/dist/engine/deploy/app-version.js +344 -0
  222. package/dist/engine/deploy/app-version.js.map +1 -0
  223. package/dist/engine/deploy/checks/compose.d.ts +16 -0
  224. package/dist/engine/deploy/checks/compose.d.ts.map +1 -0
  225. package/dist/engine/deploy/checks/compose.js +149 -0
  226. package/dist/engine/deploy/checks/compose.js.map +1 -0
  227. package/dist/engine/deploy/checks/database.d.ts +83 -0
  228. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  229. package/dist/engine/deploy/checks/database.js +455 -0
  230. package/dist/engine/deploy/checks/database.js.map +1 -0
  231. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  232. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  233. package/dist/engine/deploy/checks/dns.js +85 -0
  234. package/dist/engine/deploy/checks/dns.js.map +1 -0
  235. package/dist/engine/deploy/checks/host.d.ts +19 -0
  236. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  237. package/dist/engine/deploy/checks/host.js +543 -0
  238. package/dist/engine/deploy/checks/host.js.map +1 -0
  239. package/dist/engine/deploy/checks/index.d.ts +35 -0
  240. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  241. package/dist/engine/deploy/checks/index.js +75 -0
  242. package/dist/engine/deploy/checks/index.js.map +1 -0
  243. package/dist/engine/deploy/checks/registry.d.ts +110 -0
  244. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  245. package/dist/engine/deploy/checks/registry.js +104 -0
  246. package/dist/engine/deploy/checks/registry.js.map +1 -0
  247. package/dist/engine/deploy/checks/source.d.ts +45 -0
  248. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  249. package/dist/engine/deploy/checks/source.js +175 -0
  250. package/dist/engine/deploy/checks/source.js.map +1 -0
  251. package/dist/engine/deploy/checks/stack-ports.d.ts +4 -0
  252. package/dist/engine/deploy/checks/stack-ports.d.ts.map +1 -0
  253. package/dist/engine/deploy/checks/stack-ports.js +261 -0
  254. package/dist/engine/deploy/checks/stack-ports.js.map +1 -0
  255. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  256. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  257. package/dist/engine/deploy/checks/tls.js +552 -0
  258. package/dist/engine/deploy/checks/tls.js.map +1 -0
  259. package/dist/engine/deploy/checks/types.d.ts +202 -0
  260. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  261. package/dist/engine/deploy/checks/types.js +199 -0
  262. package/dist/engine/deploy/checks/types.js.map +1 -0
  263. package/dist/engine/deploy/compose-command.d.ts +16 -0
  264. package/dist/engine/deploy/compose-command.d.ts.map +1 -0
  265. package/dist/engine/deploy/compose-command.js +40 -0
  266. package/dist/engine/deploy/compose-command.js.map +1 -0
  267. package/dist/engine/deploy/compose-containers.d.ts +101 -0
  268. package/dist/engine/deploy/compose-containers.d.ts.map +1 -0
  269. package/dist/engine/deploy/compose-containers.js +191 -0
  270. package/dist/engine/deploy/compose-containers.js.map +1 -0
  271. package/dist/engine/deploy/compose-files.d.ts +29 -0
  272. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  273. package/dist/engine/deploy/compose-files.js +118 -0
  274. package/dist/engine/deploy/compose-files.js.map +1 -0
  275. package/dist/engine/deploy/compose-hints.d.ts +11 -0
  276. package/dist/engine/deploy/compose-hints.d.ts.map +1 -0
  277. package/dist/engine/deploy/compose-hints.js +70 -0
  278. package/dist/engine/deploy/compose-hints.js.map +1 -0
  279. package/dist/engine/deploy/compose-port-variables.d.ts +58 -0
  280. package/dist/engine/deploy/compose-port-variables.d.ts.map +1 -0
  281. package/dist/engine/deploy/compose-port-variables.js +184 -0
  282. package/dist/engine/deploy/compose-port-variables.js.map +1 -0
  283. package/dist/engine/deploy/compose-ports.d.ts +98 -0
  284. package/dist/engine/deploy/compose-ports.d.ts.map +1 -0
  285. package/dist/engine/deploy/compose-ports.js +204 -0
  286. package/dist/engine/deploy/compose-ports.js.map +1 -0
  287. package/dist/engine/deploy/compose-project.d.ts +113 -0
  288. package/dist/engine/deploy/compose-project.d.ts.map +1 -0
  289. package/dist/engine/deploy/compose-project.js +177 -0
  290. package/dist/engine/deploy/compose-project.js.map +1 -0
  291. package/dist/engine/deploy/consent.d.ts +29 -0
  292. package/dist/engine/deploy/consent.d.ts.map +1 -0
  293. package/dist/engine/deploy/consent.js +35 -0
  294. package/dist/engine/deploy/consent.js.map +1 -0
  295. package/dist/engine/deploy/database-drop.d.ts +22 -0
  296. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  297. package/dist/engine/deploy/database-drop.js +135 -0
  298. package/dist/engine/deploy/database-drop.js.map +1 -0
  299. package/dist/engine/deploy/database.d.ts +116 -0
  300. package/dist/engine/deploy/database.d.ts.map +1 -0
  301. package/dist/engine/deploy/database.js +252 -0
  302. package/dist/engine/deploy/database.js.map +1 -0
  303. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  304. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  305. package/dist/engine/deploy/deploy-info.js +163 -0
  306. package/dist/engine/deploy/deploy-info.js.map +1 -0
  307. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  308. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  309. package/dist/engine/deploy/deployment-evidence.js +92 -0
  310. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  311. package/dist/engine/deploy/edge-config.d.ts +103 -0
  312. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  313. package/dist/engine/deploy/edge-config.js +170 -0
  314. package/dist/engine/deploy/edge-config.js.map +1 -0
  315. package/dist/engine/deploy/env-absence.d.ts +61 -0
  316. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  317. package/dist/engine/deploy/env-absence.js +33 -0
  318. package/dist/engine/deploy/env-absence.js.map +1 -0
  319. package/dist/engine/deploy/env-file.d.ts +14 -0
  320. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  321. package/dist/engine/deploy/env-file.js +58 -0
  322. package/dist/engine/deploy/env-file.js.map +1 -0
  323. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  324. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  325. package/dist/engine/deploy/env-fragments.js +73 -0
  326. package/dist/engine/deploy/env-fragments.js.map +1 -0
  327. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  328. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  329. package/dist/engine/deploy/env-metadata.js +227 -0
  330. package/dist/engine/deploy/env-metadata.js.map +1 -0
  331. package/dist/engine/deploy/env-spec.d.ts +75 -0
  332. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  333. package/dist/engine/deploy/env-spec.js +239 -0
  334. package/dist/engine/deploy/env-spec.js.map +1 -0
  335. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  336. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  337. package/dist/engine/deploy/env-wizard.js +235 -0
  338. package/dist/engine/deploy/env-wizard.js.map +1 -0
  339. package/dist/engine/deploy/executor.d.ts +81 -0
  340. package/dist/engine/deploy/executor.d.ts.map +1 -0
  341. package/dist/engine/deploy/executor.js +247 -0
  342. package/dist/engine/deploy/executor.js.map +1 -0
  343. package/dist/engine/deploy/free-ports.d.ts +145 -0
  344. package/dist/engine/deploy/free-ports.d.ts.map +1 -0
  345. package/dist/engine/deploy/free-ports.js +235 -0
  346. package/dist/engine/deploy/free-ports.js.map +1 -0
  347. package/dist/engine/deploy/health.d.ts +153 -0
  348. package/dist/engine/deploy/health.d.ts.map +1 -0
  349. package/dist/engine/deploy/health.js +335 -0
  350. package/dist/engine/deploy/health.js.map +1 -0
  351. package/dist/engine/deploy/hooks.d.ts +66 -0
  352. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  353. package/dist/engine/deploy/hooks.js +19 -0
  354. package/dist/engine/deploy/hooks.js.map +1 -0
  355. package/dist/engine/deploy/host-facts.d.ts +23 -0
  356. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  357. package/dist/engine/deploy/host-facts.js +67 -0
  358. package/dist/engine/deploy/host-facts.js.map +1 -0
  359. package/dist/engine/deploy/install.d.ts +239 -0
  360. package/dist/engine/deploy/install.d.ts.map +1 -0
  361. package/dist/engine/deploy/install.js +1474 -0
  362. package/dist/engine/deploy/install.js.map +1 -0
  363. package/dist/engine/deploy/inventory.d.ts +30 -0
  364. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  365. package/dist/engine/deploy/inventory.js +122 -0
  366. package/dist/engine/deploy/inventory.js.map +1 -0
  367. package/dist/engine/deploy/journal.d.ts +77 -0
  368. package/dist/engine/deploy/journal.d.ts.map +1 -0
  369. package/dist/engine/deploy/journal.js +221 -0
  370. package/dist/engine/deploy/journal.js.map +1 -0
  371. package/dist/engine/deploy/layout.d.ts +77 -0
  372. package/dist/engine/deploy/layout.d.ts.map +1 -0
  373. package/dist/engine/deploy/layout.js +191 -0
  374. package/dist/engine/deploy/layout.js.map +1 -0
  375. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  376. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  377. package/dist/engine/deploy/oauth-check.js +213 -0
  378. package/dist/engine/deploy/oauth-check.js.map +1 -0
  379. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  380. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  381. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  382. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  383. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  384. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  385. package/dist/engine/deploy/proxy-streams.js +208 -0
  386. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  387. package/dist/engine/deploy/proxy.d.ts +375 -0
  388. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  389. package/dist/engine/deploy/proxy.js +758 -0
  390. package/dist/engine/deploy/proxy.js.map +1 -0
  391. package/dist/engine/deploy/renewal.d.ts +54 -0
  392. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  393. package/dist/engine/deploy/renewal.js +169 -0
  394. package/dist/engine/deploy/renewal.js.map +1 -0
  395. package/dist/engine/deploy/repo.d.ts +119 -0
  396. package/dist/engine/deploy/repo.d.ts.map +1 -0
  397. package/dist/engine/deploy/repo.js +282 -0
  398. package/dist/engine/deploy/repo.js.map +1 -0
  399. package/dist/engine/deploy/run-record.d.ts +28 -0
  400. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  401. package/dist/engine/deploy/run-record.js +44 -0
  402. package/dist/engine/deploy/run-record.js.map +1 -0
  403. package/dist/engine/deploy/stack-ports-gate.d.ts +19 -0
  404. package/dist/engine/deploy/stack-ports-gate.d.ts.map +1 -0
  405. package/dist/engine/deploy/stack-ports-gate.js +54 -0
  406. package/dist/engine/deploy/stack-ports-gate.js.map +1 -0
  407. package/dist/engine/deploy/state.d.ts +289 -0
  408. package/dist/engine/deploy/state.d.ts.map +1 -0
  409. package/dist/engine/deploy/state.js +163 -0
  410. package/dist/engine/deploy/state.js.map +1 -0
  411. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  412. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  413. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  414. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  415. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  416. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  417. package/dist/engine/deploy/steps/pipeline.js +73 -0
  418. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  419. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  420. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  421. package/dist/engine/deploy/steps/plan.js +32 -0
  422. package/dist/engine/deploy/steps/plan.js.map +1 -0
  423. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  424. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  425. package/dist/engine/deploy/steps/registry.js +214 -0
  426. package/dist/engine/deploy/steps/registry.js.map +1 -0
  427. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  428. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  429. package/dist/engine/deploy/steps/step-values.js +33 -0
  430. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  431. package/dist/engine/deploy/testing/fake-containers.d.ts +29 -0
  432. package/dist/engine/deploy/testing/fake-containers.d.ts.map +1 -0
  433. package/dist/engine/deploy/testing/fake-containers.js +32 -0
  434. package/dist/engine/deploy/testing/fake-containers.js.map +1 -0
  435. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  436. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  437. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  438. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  439. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  440. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  441. package/dist/engine/deploy/testing/fake-vps.js +371 -0
  442. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  443. package/dist/engine/deploy/uninstall.d.ts +87 -0
  444. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  445. package/dist/engine/deploy/uninstall.js +321 -0
  446. package/dist/engine/deploy/uninstall.js.map +1 -0
  447. package/dist/engine/deploy/update.d.ts +114 -0
  448. package/dist/engine/deploy/update.d.ts.map +1 -0
  449. package/dist/engine/deploy/update.js +1385 -0
  450. package/dist/engine/deploy/update.js.map +1 -0
  451. package/dist/engine/deploy/version-step.d.ts +74 -0
  452. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  453. package/dist/engine/deploy/version-step.js +177 -0
  454. package/dist/engine/deploy/version-step.js.map +1 -0
  455. package/dist/engine/device-auth.d.ts +240 -0
  456. package/dist/engine/device-auth.d.ts.map +1 -0
  457. package/dist/engine/device-auth.js +442 -0
  458. package/dist/engine/device-auth.js.map +1 -0
  459. package/dist/engine/device-login.d.ts +126 -0
  460. package/dist/engine/device-login.d.ts.map +1 -0
  461. package/dist/engine/device-login.js +164 -0
  462. package/dist/engine/device-login.js.map +1 -0
  463. package/dist/engine/errors.d.ts +314 -0
  464. package/dist/engine/errors.d.ts.map +1 -0
  465. package/dist/engine/errors.js +561 -0
  466. package/dist/engine/errors.js.map +1 -0
  467. package/dist/engine/github-raw-manifest.d.ts +59 -0
  468. package/dist/engine/github-raw-manifest.d.ts.map +1 -0
  469. package/dist/engine/github-raw-manifest.js +197 -0
  470. package/dist/engine/github-raw-manifest.js.map +1 -0
  471. package/dist/engine/identity.d.ts +169 -0
  472. package/dist/engine/identity.d.ts.map +1 -0
  473. package/dist/engine/identity.js +227 -0
  474. package/dist/engine/identity.js.map +1 -0
  475. package/dist/engine/index.d.ts +141 -0
  476. package/dist/engine/index.d.ts.map +1 -0
  477. package/dist/engine/index.js +147 -0
  478. package/dist/engine/index.js.map +1 -0
  479. package/dist/engine/init/local-profile.d.ts +93 -0
  480. package/dist/engine/init/local-profile.d.ts.map +1 -0
  481. package/dist/engine/init/local-profile.js +295 -0
  482. package/dist/engine/init/local-profile.js.map +1 -0
  483. package/dist/engine/init/run-init.d.ts +41 -0
  484. package/dist/engine/init/run-init.d.ts.map +1 -0
  485. package/dist/engine/init/run-init.js +297 -0
  486. package/dist/engine/init/run-init.js.map +1 -0
  487. package/dist/engine/node/capabilities.d.ts +433 -0
  488. package/dist/engine/node/capabilities.d.ts.map +1 -0
  489. package/dist/engine/node/capabilities.js +597 -0
  490. package/dist/engine/node/capabilities.js.map +1 -0
  491. package/dist/engine/node/daemon-channels.d.ts +66 -0
  492. package/dist/engine/node/daemon-channels.d.ts.map +1 -0
  493. package/dist/engine/node/daemon-channels.js +65 -0
  494. package/dist/engine/node/daemon-channels.js.map +1 -0
  495. package/dist/engine/node/daemon.d.ts +63 -0
  496. package/dist/engine/node/daemon.d.ts.map +1 -0
  497. package/dist/engine/node/daemon.js +279 -0
  498. package/dist/engine/node/daemon.js.map +1 -0
  499. package/dist/engine/node/doctor.d.ts +60 -0
  500. package/dist/engine/node/doctor.d.ts.map +1 -0
  501. package/dist/engine/node/doctor.js +447 -0
  502. package/dist/engine/node/doctor.js.map +1 -0
  503. package/dist/engine/node/enrollment.d.ts +98 -0
  504. package/dist/engine/node/enrollment.d.ts.map +1 -0
  505. package/dist/engine/node/enrollment.js +189 -0
  506. package/dist/engine/node/enrollment.js.map +1 -0
  507. package/dist/engine/node/env-flags.d.ts +5 -0
  508. package/dist/engine/node/env-flags.d.ts.map +1 -0
  509. package/dist/engine/node/env-flags.js +22 -0
  510. package/dist/engine/node/env-flags.js.map +1 -0
  511. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  512. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  513. package/dist/engine/node/executors/credential-hygiene.js +210 -0
  514. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  515. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  516. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  517. package/dist/engine/node/executors/db-backup-run.js +362 -0
  518. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  519. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  520. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  521. package/dist/engine/node/executors/example-checksum.js +56 -0
  522. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  523. package/dist/engine/node/executors/index.d.ts +213 -0
  524. package/dist/engine/node/executors/index.d.ts.map +1 -0
  525. package/dist/engine/node/executors/index.js +58 -0
  526. package/dist/engine/node/executors/index.js.map +1 -0
  527. package/dist/engine/node/executors/registry.d.ts +38 -0
  528. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  529. package/dist/engine/node/executors/registry.js +103 -0
  530. package/dist/engine/node/executors/registry.js.map +1 -0
  531. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  532. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  533. package/dist/engine/node/heap-snapshot.js +160 -0
  534. package/dist/engine/node/heap-snapshot.js.map +1 -0
  535. package/dist/engine/node/host-telemetry.d.ts +38 -0
  536. package/dist/engine/node/host-telemetry.d.ts.map +1 -0
  537. package/dist/engine/node/host-telemetry.js +39 -0
  538. package/dist/engine/node/host-telemetry.js.map +1 -0
  539. package/dist/engine/node/host-vitals.d.ts +51 -0
  540. package/dist/engine/node/host-vitals.d.ts.map +1 -0
  541. package/dist/engine/node/host-vitals.js +117 -0
  542. package/dist/engine/node/host-vitals.js.map +1 -0
  543. package/dist/engine/node/install-deps.d.ts +231 -0
  544. package/dist/engine/node/install-deps.d.ts.map +1 -0
  545. package/dist/engine/node/install-deps.js +392 -0
  546. package/dist/engine/node/install-deps.js.map +1 -0
  547. package/dist/engine/node/ipc-protocol.d.ts +114 -0
  548. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  549. package/dist/engine/node/ipc-protocol.js +122 -0
  550. package/dist/engine/node/ipc-protocol.js.map +1 -0
  551. package/dist/engine/node/lifecycle.d.ts +103 -0
  552. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  553. package/dist/engine/node/lifecycle.js +260 -0
  554. package/dist/engine/node/lifecycle.js.map +1 -0
  555. package/dist/engine/node/logger.d.ts +95 -0
  556. package/dist/engine/node/logger.d.ts.map +1 -0
  557. package/dist/engine/node/logger.js +241 -0
  558. package/dist/engine/node/logger.js.map +1 -0
  559. package/dist/engine/node/memory-watchdog.d.ts +89 -0
  560. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  561. package/dist/engine/node/memory-watchdog.js +248 -0
  562. package/dist/engine/node/memory-watchdog.js.map +1 -0
  563. package/dist/engine/node/models.d.ts +195 -0
  564. package/dist/engine/node/models.d.ts.map +1 -0
  565. package/dist/engine/node/models.js +379 -0
  566. package/dist/engine/node/models.js.map +1 -0
  567. package/dist/engine/node/node-api.d.ts +439 -0
  568. package/dist/engine/node/node-api.d.ts.map +1 -0
  569. package/dist/engine/node/node-api.js +125 -0
  570. package/dist/engine/node/node-api.js.map +1 -0
  571. package/dist/engine/node/node-config.d.ts +128 -0
  572. package/dist/engine/node/node-config.d.ts.map +1 -0
  573. package/dist/engine/node/node-config.js +237 -0
  574. package/dist/engine/node/node-config.js.map +1 -0
  575. package/dist/engine/node/node-dashboard-source.d.ts +83 -0
  576. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  577. package/dist/engine/node/node-dashboard-source.js +181 -0
  578. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  579. package/dist/engine/node/node-engine.d.ts +282 -0
  580. package/dist/engine/node/node-engine.d.ts.map +1 -0
  581. package/dist/engine/node/node-engine.js +925 -0
  582. package/dist/engine/node/node-engine.js.map +1 -0
  583. package/dist/engine/node/node-errors.d.ts +54 -0
  584. package/dist/engine/node/node-errors.d.ts.map +1 -0
  585. package/dist/engine/node/node-errors.js +71 -0
  586. package/dist/engine/node/node-errors.js.map +1 -0
  587. package/dist/engine/node/node-events-queue.d.ts +27 -0
  588. package/dist/engine/node/node-events-queue.d.ts.map +1 -0
  589. package/dist/engine/node/node-events-queue.js +46 -0
  590. package/dist/engine/node/node-events-queue.js.map +1 -0
  591. package/dist/engine/node/node-events.d.ts +132 -0
  592. package/dist/engine/node/node-events.d.ts.map +1 -0
  593. package/dist/engine/node/node-events.js +2 -0
  594. package/dist/engine/node/node-events.js.map +1 -0
  595. package/dist/engine/node/node-vitals.d.ts +123 -0
  596. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  597. package/dist/engine/node/node-vitals.js +266 -0
  598. package/dist/engine/node/node-vitals.js.map +1 -0
  599. package/dist/engine/node/paths.d.ts +39 -0
  600. package/dist/engine/node/paths.d.ts.map +1 -0
  601. package/dist/engine/node/paths.js +60 -0
  602. package/dist/engine/node/paths.js.map +1 -0
  603. package/dist/engine/node/pg-dump.d.ts +126 -0
  604. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  605. package/dist/engine/node/pg-dump.js +223 -0
  606. package/dist/engine/node/pg-dump.js.map +1 -0
  607. package/dist/engine/node/pidfile.d.ts +38 -0
  608. package/dist/engine/node/pidfile.d.ts.map +1 -0
  609. package/dist/engine/node/pidfile.js +156 -0
  610. package/dist/engine/node/pidfile.js.map +1 -0
  611. package/dist/engine/node/power-probe.d.ts +59 -0
  612. package/dist/engine/node/power-probe.d.ts.map +1 -0
  613. package/dist/engine/node/power-probe.js +240 -0
  614. package/dist/engine/node/power-probe.js.map +1 -0
  615. package/dist/engine/node/power-watcher.d.ts +30 -0
  616. package/dist/engine/node/power-watcher.d.ts.map +1 -0
  617. package/dist/engine/node/power-watcher.js +116 -0
  618. package/dist/engine/node/power-watcher.js.map +1 -0
  619. package/dist/engine/node/runtime-state.d.ts +24 -0
  620. package/dist/engine/node/runtime-state.d.ts.map +1 -0
  621. package/dist/engine/node/runtime-state.js +19 -0
  622. package/dist/engine/node/runtime-state.js.map +1 -0
  623. package/dist/engine/node/runtime-tuning.d.ts +174 -0
  624. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  625. package/dist/engine/node/runtime-tuning.js +327 -0
  626. package/dist/engine/node/runtime-tuning.js.map +1 -0
  627. package/dist/engine/node/service.d.ts +39 -0
  628. package/dist/engine/node/service.d.ts.map +1 -0
  629. package/dist/engine/node/service.js +215 -0
  630. package/dist/engine/node/service.js.map +1 -0
  631. package/dist/engine/node/start.d.ts +69 -0
  632. package/dist/engine/node/start.d.ts.map +1 -0
  633. package/dist/engine/node/start.js +325 -0
  634. package/dist/engine/node/start.js.map +1 -0
  635. package/dist/engine/node/worker-env-aliases.d.ts +39 -0
  636. package/dist/engine/node/worker-env-aliases.d.ts.map +1 -0
  637. package/dist/engine/node/worker-env-aliases.js +126 -0
  638. package/dist/engine/node/worker-env-aliases.js.map +1 -0
  639. package/dist/engine/node/worker-env-table.d.ts +15 -0
  640. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  641. package/dist/engine/node/worker-env-table.js +100 -0
  642. package/dist/engine/node/worker-env-table.js.map +1 -0
  643. package/dist/engine/node/worker-env.d.ts +67 -0
  644. package/dist/engine/node/worker-env.d.ts.map +1 -0
  645. package/dist/engine/node/worker-env.js +114 -0
  646. package/dist/engine/node/worker-env.js.map +1 -0
  647. package/dist/engine/output.d.ts +97 -0
  648. package/dist/engine/output.d.ts.map +1 -0
  649. package/dist/engine/output.js +274 -0
  650. package/dist/engine/output.js.map +1 -0
  651. package/dist/engine/package-info.d.ts +7 -0
  652. package/dist/engine/package-info.d.ts.map +1 -0
  653. package/dist/engine/package-info.js +38 -0
  654. package/dist/engine/package-info.js.map +1 -0
  655. package/dist/engine/program.d.ts +53 -0
  656. package/dist/engine/program.d.ts.map +1 -0
  657. package/dist/engine/program.js +213 -0
  658. package/dist/engine/program.js.map +1 -0
  659. package/dist/engine/prompt.d.ts +69 -0
  660. package/dist/engine/prompt.d.ts.map +1 -0
  661. package/dist/engine/prompt.js +205 -0
  662. package/dist/engine/prompt.js.map +1 -0
  663. package/dist/engine/registries.d.ts +5 -0
  664. package/dist/engine/registries.d.ts.map +1 -0
  665. package/dist/engine/registries.js +68 -0
  666. package/dist/engine/registries.js.map +1 -0
  667. package/dist/engine/request-body.d.ts +31 -0
  668. package/dist/engine/request-body.d.ts.map +1 -0
  669. package/dist/engine/request-body.js +156 -0
  670. package/dist/engine/request-body.js.map +1 -0
  671. package/dist/engine/semver.d.ts +31 -0
  672. package/dist/engine/semver.d.ts.map +1 -0
  673. package/dist/engine/semver.js +100 -0
  674. package/dist/engine/semver.js.map +1 -0
  675. package/dist/engine/test-support.d.ts +50 -0
  676. package/dist/engine/test-support.d.ts.map +1 -0
  677. package/dist/engine/test-support.js +86 -0
  678. package/dist/engine/test-support.js.map +1 -0
  679. package/dist/engine/tui/app-registry.d.ts +103 -0
  680. package/dist/engine/tui/app-registry.d.ts.map +1 -0
  681. package/dist/engine/tui/app-registry.js +103 -0
  682. package/dist/engine/tui/app-registry.js.map +1 -0
  683. package/dist/engine/tui/app.d.ts +11 -0
  684. package/dist/engine/tui/app.d.ts.map +1 -0
  685. package/dist/engine/tui/app.js +134 -0
  686. package/dist/engine/tui/app.js.map +1 -0
  687. package/dist/engine/tui/builtin-screens.d.ts +11 -0
  688. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  689. package/dist/engine/tui/builtin-screens.js +69 -0
  690. package/dist/engine/tui/builtin-screens.js.map +1 -0
  691. package/dist/engine/tui/conformance.d.ts +149 -0
  692. package/dist/engine/tui/conformance.d.ts.map +1 -0
  693. package/dist/engine/tui/conformance.js +428 -0
  694. package/dist/engine/tui/conformance.js.map +1 -0
  695. package/dist/engine/tui/context.d.ts +220 -0
  696. package/dist/engine/tui/context.d.ts.map +1 -0
  697. package/dist/engine/tui/context.js +258 -0
  698. package/dist/engine/tui/context.js.map +1 -0
  699. package/dist/engine/tui/dashboard/index.d.ts +8 -0
  700. package/dist/engine/tui/dashboard/index.d.ts.map +1 -0
  701. package/dist/engine/tui/dashboard/index.js +5 -0
  702. package/dist/engine/tui/dashboard/index.js.map +1 -0
  703. package/dist/engine/tui/dashboard/jobs-insights.d.ts +145 -0
  704. package/dist/engine/tui/dashboard/jobs-insights.d.ts.map +1 -0
  705. package/dist/engine/tui/dashboard/jobs-insights.js +63 -0
  706. package/dist/engine/tui/dashboard/jobs-insights.js.map +1 -0
  707. package/dist/engine/tui/dashboard/node-embedded.d.ts +33 -0
  708. package/dist/engine/tui/dashboard/node-embedded.d.ts.map +1 -0
  709. package/dist/engine/tui/dashboard/node-embedded.js +81 -0
  710. package/dist/engine/tui/dashboard/node-embedded.js.map +1 -0
  711. package/dist/engine/tui/dashboard/source.d.ts +294 -0
  712. package/dist/engine/tui/dashboard/source.d.ts.map +1 -0
  713. package/dist/engine/tui/dashboard/source.js +397 -0
  714. package/dist/engine/tui/dashboard/source.js.map +1 -0
  715. package/dist/engine/tui/dashboard/use-dashboard.d.ts +23 -0
  716. package/dist/engine/tui/dashboard/use-dashboard.d.ts.map +1 -0
  717. package/dist/engine/tui/dashboard/use-dashboard.js +32 -0
  718. package/dist/engine/tui/dashboard/use-dashboard.js.map +1 -0
  719. package/dist/engine/tui/index.d.ts +25 -0
  720. package/dist/engine/tui/index.d.ts.map +1 -0
  721. package/dist/engine/tui/index.js +89 -0
  722. package/dist/engine/tui/index.js.map +1 -0
  723. package/dist/engine/tui/layout.d.ts +152 -0
  724. package/dist/engine/tui/layout.d.ts.map +1 -0
  725. package/dist/engine/tui/layout.js +214 -0
  726. package/dist/engine/tui/layout.js.map +1 -0
  727. package/dist/engine/tui/menu-registry.d.ts +201 -0
  728. package/dist/engine/tui/menu-registry.d.ts.map +1 -0
  729. package/dist/engine/tui/menu-registry.js +205 -0
  730. package/dist/engine/tui/menu-registry.js.map +1 -0
  731. package/dist/engine/tui/menu-tree.d.ts +198 -0
  732. package/dist/engine/tui/menu-tree.d.ts.map +1 -0
  733. package/dist/engine/tui/menu-tree.js +276 -0
  734. package/dist/engine/tui/menu-tree.js.map +1 -0
  735. package/dist/engine/tui/raw-mode.d.ts +54 -0
  736. package/dist/engine/tui/raw-mode.d.ts.map +1 -0
  737. package/dist/engine/tui/raw-mode.js +106 -0
  738. package/dist/engine/tui/raw-mode.js.map +1 -0
  739. package/dist/engine/tui/routes.d.ts +5 -0
  740. package/dist/engine/tui/routes.d.ts.map +1 -0
  741. package/dist/engine/tui/routes.js +16 -0
  742. package/dist/engine/tui/routes.js.map +1 -0
  743. package/dist/engine/tui/screen-registry.d.ts +170 -0
  744. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  745. package/dist/engine/tui/screen-registry.js +180 -0
  746. package/dist/engine/tui/screen-registry.js.map +1 -0
  747. package/dist/engine/tui/screen-sections.d.ts +9 -0
  748. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  749. package/dist/engine/tui/screen-sections.js +45 -0
  750. package/dist/engine/tui/screen-sections.js.map +1 -0
  751. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  752. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  753. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  754. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  755. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  756. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  757. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  758. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  759. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  760. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  761. package/dist/engine/tui/screens/deploy/doctor.js +163 -0
  762. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  763. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  764. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  765. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  766. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  767. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  768. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  769. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  770. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  771. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  772. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  773. package/dist/engine/tui/screens/deploy/index.js +83 -0
  774. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  775. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  776. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  777. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  778. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  779. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  780. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  781. package/dist/engine/tui/screens/deploy/install.js +365 -0
  782. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  783. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  784. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  785. package/dist/engine/tui/screens/deploy/model.js +59 -0
  786. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  787. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  788. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  789. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  790. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  791. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  792. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  793. package/dist/engine/tui/screens/deploy/run.js +201 -0
  794. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  795. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  796. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  797. package/dist/engine/tui/screens/deploy/status.js +107 -0
  798. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  799. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  800. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  801. package/dist/engine/tui/screens/deploy/update.js +175 -0
  802. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  803. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  804. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  805. package/dist/engine/tui/screens/deploy.js +23 -0
  806. package/dist/engine/tui/screens/deploy.js.map +1 -0
  807. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  808. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  809. package/dist/engine/tui/screens/invoke.js +196 -0
  810. package/dist/engine/tui/screens/invoke.js.map +1 -0
  811. package/dist/engine/tui/screens/jobs.d.ts +12 -0
  812. package/dist/engine/tui/screens/jobs.d.ts.map +1 -0
  813. package/dist/engine/tui/screens/jobs.js +72 -0
  814. package/dist/engine/tui/screens/jobs.js.map +1 -0
  815. package/dist/engine/tui/screens/login.d.ts +6 -0
  816. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  817. package/dist/engine/tui/screens/login.js +263 -0
  818. package/dist/engine/tui/screens/login.js.map +1 -0
  819. package/dist/engine/tui/screens/logout.d.ts +6 -0
  820. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  821. package/dist/engine/tui/screens/logout.js +149 -0
  822. package/dist/engine/tui/screens/logout.js.map +1 -0
  823. package/dist/engine/tui/screens/menu.d.ts +25 -0
  824. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  825. package/dist/engine/tui/screens/menu.js +124 -0
  826. package/dist/engine/tui/screens/menu.js.map +1 -0
  827. package/dist/engine/tui/screens/node.d.ts +6 -0
  828. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  829. package/dist/engine/tui/screens/node.js +277 -0
  830. package/dist/engine/tui/screens/node.js.map +1 -0
  831. package/dist/engine/tui/screens/not-logged-in.d.ts +12 -0
  832. package/dist/engine/tui/screens/not-logged-in.d.ts.map +1 -0
  833. package/dist/engine/tui/screens/not-logged-in.js +14 -0
  834. package/dist/engine/tui/screens/not-logged-in.js.map +1 -0
  835. package/dist/engine/tui/screens/status.d.ts +6 -0
  836. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  837. package/dist/engine/tui/screens/status.js +138 -0
  838. package/dist/engine/tui/screens/status.js.map +1 -0
  839. package/dist/engine/tui/scroll-box.d.ts +42 -0
  840. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  841. package/dist/engine/tui/scroll-box.js +62 -0
  842. package/dist/engine/tui/scroll-box.js.map +1 -0
  843. package/dist/engine/tui/section-registry.d.ts +65 -0
  844. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  845. package/dist/engine/tui/section-registry.js +90 -0
  846. package/dist/engine/tui/section-registry.js.map +1 -0
  847. package/dist/engine/tui/terminal.d.ts +31 -0
  848. package/dist/engine/tui/terminal.d.ts.map +1 -0
  849. package/dist/engine/tui/terminal.js +142 -0
  850. package/dist/engine/tui/terminal.js.map +1 -0
  851. package/dist/engine/tui/testing/feeds.d.ts +58 -0
  852. package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
  853. package/dist/engine/tui/testing/feeds.js +67 -0
  854. package/dist/engine/tui/testing/feeds.js.map +1 -0
  855. package/dist/engine/tui/testing/harness.d.ts +243 -0
  856. package/dist/engine/tui/testing/harness.d.ts.map +1 -0
  857. package/dist/engine/tui/testing/harness.js +332 -0
  858. package/dist/engine/tui/testing/harness.js.map +1 -0
  859. package/dist/engine/tui/theme.d.ts +179 -0
  860. package/dist/engine/tui/theme.d.ts.map +1 -0
  861. package/dist/engine/tui/theme.js +111 -0
  862. package/dist/engine/tui/theme.js.map +1 -0
  863. package/dist/engine/tui/tty.d.ts +56 -0
  864. package/dist/engine/tui/tty.d.ts.map +1 -0
  865. package/dist/engine/tui/tty.js +146 -0
  866. package/dist/engine/tui/tty.js.map +1 -0
  867. package/dist/engine/tui/ui/active-items.d.ts +40 -0
  868. package/dist/engine/tui/ui/active-items.d.ts.map +1 -0
  869. package/dist/engine/tui/ui/active-items.js +38 -0
  870. package/dist/engine/tui/ui/active-items.js.map +1 -0
  871. package/dist/engine/tui/ui/event-log.d.ts +58 -0
  872. package/dist/engine/tui/ui/event-log.d.ts.map +1 -0
  873. package/dist/engine/tui/ui/event-log.js +32 -0
  874. package/dist/engine/tui/ui/event-log.js.map +1 -0
  875. package/dist/engine/tui/ui/index.d.ts +20 -0
  876. package/dist/engine/tui/ui/index.d.ts.map +1 -0
  877. package/dist/engine/tui/ui/index.js +14 -0
  878. package/dist/engine/tui/ui/index.js.map +1 -0
  879. package/dist/engine/tui/ui/meter-legend.d.ts +26 -0
  880. package/dist/engine/tui/ui/meter-legend.d.ts.map +1 -0
  881. package/dist/engine/tui/ui/meter-legend.js +25 -0
  882. package/dist/engine/tui/ui/meter-legend.js.map +1 -0
  883. package/dist/engine/tui/ui/run-summary.d.ts +58 -0
  884. package/dist/engine/tui/ui/run-summary.d.ts.map +1 -0
  885. package/dist/engine/tui/ui/run-summary.js +29 -0
  886. package/dist/engine/tui/ui/run-summary.js.map +1 -0
  887. package/dist/engine/tui/ui/segment-meter.d.ts +72 -0
  888. package/dist/engine/tui/ui/segment-meter.d.ts.map +1 -0
  889. package/dist/engine/tui/ui/segment-meter.js +128 -0
  890. package/dist/engine/tui/ui/segment-meter.js.map +1 -0
  891. package/dist/engine/tui/ui/status-line.d.ts +42 -0
  892. package/dist/engine/tui/ui/status-line.d.ts.map +1 -0
  893. package/dist/engine/tui/ui/status-line.js +35 -0
  894. package/dist/engine/tui/ui/status-line.js.map +1 -0
  895. package/dist/engine/tui/ui/tone.d.ts +46 -0
  896. package/dist/engine/tui/ui/tone.d.ts.map +1 -0
  897. package/dist/engine/tui/ui/tone.js +48 -0
  898. package/dist/engine/tui/ui/tone.js.map +1 -0
  899. package/dist/engine/update-notice-options.d.ts +70 -0
  900. package/dist/engine/update-notice-options.d.ts.map +1 -0
  901. package/dist/engine/update-notice-options.js +79 -0
  902. package/dist/engine/update-notice-options.js.map +1 -0
  903. package/dist/engine/update-notice.d.ts +69 -0
  904. package/dist/engine/update-notice.d.ts.map +1 -0
  905. package/dist/engine/update-notice.js +204 -0
  906. package/dist/engine/update-notice.js.map +1 -0
  907. package/dist/index.d.ts +4 -5
  908. package/dist/index.d.ts.map +1 -1
  909. package/dist/index.js +5 -5
  910. package/dist/index.js.map +1 -1
  911. package/dist/node/index.d.ts +3 -0
  912. package/dist/node/index.d.ts.map +1 -0
  913. package/dist/node/index.js +5 -0
  914. package/dist/node/index.js.map +1 -0
  915. package/dist/telemetry/index.d.ts +2 -1
  916. package/dist/telemetry/index.d.ts.map +1 -1
  917. package/dist/telemetry/index.js +1 -0
  918. package/dist/telemetry/index.js.map +1 -1
  919. package/dist/telemetry/node-span-relay.d.ts +1 -1
  920. package/dist/telemetry/node-span-relay.d.ts.map +1 -1
  921. package/dist/telemetry/node-span-relay.js +39 -6
  922. package/dist/telemetry/node-span-relay.js.map +1 -1
  923. package/dist/telemetry/node-span.d.ts +39 -7
  924. package/dist/telemetry/node-span.d.ts.map +1 -1
  925. package/dist/telemetry/node-span.js +19 -1
  926. package/dist/telemetry/node-span.js.map +1 -1
  927. package/dist/testing/index.d.ts +3 -0
  928. package/dist/testing/index.d.ts.map +1 -0
  929. package/dist/testing/index.js +4 -0
  930. package/dist/testing/index.js.map +1 -0
  931. package/dist/tui/index.d.ts +3 -0
  932. package/dist/tui/index.d.ts.map +1 -0
  933. package/dist/tui/index.js +7 -0
  934. package/dist/tui/index.js.map +1 -0
  935. package/dist/tui/testing/index.d.ts +5 -0
  936. package/dist/tui/testing/index.d.ts.map +1 -0
  937. package/dist/tui/testing/index.js +12 -0
  938. package/dist/tui/testing/index.js.map +1 -0
  939. package/dist/tui/ui/index.d.ts +2 -0
  940. package/dist/tui/ui/index.d.ts.map +1 -0
  941. package/dist/tui/ui/index.js +10 -0
  942. package/dist/tui/ui/index.js.map +1 -0
  943. package/package.json +56 -5
@@ -0,0 +1,152 @@
1
+ import { type ReactNode } from 'react';
2
+ /**
3
+ * Below this many columns the chrome is dropped.
4
+ *
5
+ * FIFTY-SIX because that is roughly what the widest fixed content needs — the
6
+ * device-flow instruction panel, a `GET /api/users → 200 OK (41ms)` status
7
+ * line — plus a two-column border and two of padding on each side. Narrower
8
+ * than that and the border characters start consuming the content they are
9
+ * meant to frame, which is worse than no border: yoga wraps mid-word inside a
10
+ * box it cannot shrink, and the result is a smear of broken box-drawing
11
+ * characters rather than a smaller version of the UI.
12
+ *
13
+ * The number is a THRESHOLD, not a minimum viable width: below it the UI keeps
14
+ * working, it just stops drawing decoration. #145 asks for degrade, not
15
+ * refusal — a user in a tmux split or an 80-column window halved is a normal
16
+ * case, and a TUI that says "your terminal is too small" to someone who can
17
+ * plainly see text on it is a TUI they stop using.
18
+ * @stability experimental
19
+ */
20
+ export declare const NARROW_COLUMNS = 56;
21
+ /**
22
+ * Below this, drop even the header and the padding.
23
+ *
24
+ * Thirty is about the width of a phone-sized SSH session. There is no useful
25
+ * layout left at this size, only content, so that is all that is drawn.
26
+ * @stability experimental
27
+ */
28
+ export declare const TINY_COLUMNS = 30;
29
+ /**
30
+ * The terminal size and the width tier it falls in.
31
+ *
32
+ * @stability experimental
33
+ */
34
+ export interface TerminalSize {
35
+ /** Width in cells (80 when the terminal will not say). */
36
+ columns: number;
37
+ /** Height in rows (24 when the terminal will not say). */
38
+ rows: number;
39
+ /** `columns < NARROW_COLUMNS`. Drop borders and side padding. */
40
+ narrow: boolean;
41
+ /** `columns < TINY_COLUMNS`. Drop the header too; content only. */
42
+ tiny: boolean;
43
+ }
44
+ /**
45
+ * The current terminal size, updated on resize.
46
+ *
47
+ * ink re-renders on its own when the terminal is resized, but it does NOT
48
+ * publish the new size as state — a component that read `stdout.columns` during
49
+ * render would get the fresh value only because a re-render happened to be
50
+ * scheduled, which is a coincidence rather than a subscription. Owning the
51
+ * listener here makes the resize an explicit state change, which is what #145
52
+ * asks for: the layout must actually respond, not merely survive.
53
+ *
54
+ * The listener is removed on unmount. `process.stdout` is a long-lived emitter
55
+ * shared with the whole runtime, so a leaked listener here outlives the UI and
56
+ * fires against unmounted components for the rest of the process's life.
57
+ * @stability experimental
58
+ */
59
+ export declare function useTerminalSize(): TerminalSize;
60
+ /**
61
+ * A guard against writing state after unmount.
62
+ *
63
+ * EVERY SCREEN IN THIS TUI NEEDS IT, because every screen does network work
64
+ * that outlives a keypress. The device-flow login polls for up to fifteen
65
+ * minutes; a user who presses Esc, or Ctrl-C, is unmounted immediately while
66
+ * the in-flight request keeps running and its `.then` still holds a setter for
67
+ * a component that no longer exists. React 18+ no longer warns about this, so
68
+ * the symptom is not a console message but a leak, and — once ink has torn the
69
+ * renderer down — a possible throw from inside a reconciler that has already
70
+ * stopped. `ee2078c fix(web): stop hooks writing state after unmount` is the
71
+ * same bug in apps/web.
72
+ *
73
+ * Returns a getter rather than the ref itself so a caller cannot accidentally
74
+ * capture `ref.current`'s value at closure-creation time, which would always be
75
+ * `true` and defeat the whole thing.
76
+ */
77
+ export declare function useIsMounted(): () => boolean;
78
+ /**
79
+ * Props of {@link Frame}.
80
+ *
81
+ * @stability experimental
82
+ */
83
+ export interface FrameProps {
84
+ /** Screen name, shown in the header. */
85
+ title: string;
86
+ /** Key hints for the bottom line, e.g. `['↑↓ move', 'enter select']`. */
87
+ hints?: string[];
88
+ /** The screen content. */
89
+ children: ReactNode;
90
+ }
91
+ /**
92
+ * The window every screen sits in: a header, the content, and a hint line.
93
+ *
94
+ * THE DEGRADE IS THE INTERESTING PART. Three tiers, chosen by width:
95
+ *
96
+ * full (\>= NARROW_COLUMNS) bordered box, padding, header, hints
97
+ * narrow (\>= TINY_COLUMNS) no border, no side padding, header, hints
98
+ * tiny (\< TINY_COLUMNS) content only
99
+ *
100
+ * A bordered `Box` is NOT given an explicit width at any tier. Setting
101
+ * `width={columns}` looks right and is a bug: ink measures the terminal itself,
102
+ * and a box asked for exactly the full width has nowhere to put its own border,
103
+ * so the right-hand edge wraps onto the next line and every frame ends with a
104
+ * row of orphaned box characters. Letting the box size itself and constraining
105
+ * only the CONTENT is what keeps the frame intact at every width.
106
+ * @stability experimental
107
+ */
108
+ export declare function Frame({ title, hints, children }: FrameProps): ReactNode;
109
+ /**
110
+ * The bottom line of every screen.
111
+ *
112
+ * Always present, and always including the key that gets OUT. A full-screen app
113
+ * that has captured the keyboard and does not say how to leave is the reason
114
+ * people are wary of them; Esc and Ctrl-C are both listed on every screen for
115
+ * exactly that reason, even where it looks redundant.
116
+ *
117
+ * Separators are dropped when narrow: at that width the hints wrap, and a
118
+ * wrapped line beginning with a lone dot reads as corruption.
119
+ * @stability experimental
120
+ */
121
+ export declare function KeyHints({ hints }: {
122
+ hints: string[];
123
+ }): ReactNode;
124
+ /**
125
+ * A labelled row: a fixed-width label and a value.
126
+ *
127
+ * The label column is padded rather than laid out with a `<Box width>` because
128
+ * ink measures a Box in cells and these labels are ASCII — padding is exact,
129
+ * one flex node cheaper per row, and immune to the width-collapse described in
130
+ * `Frame`.
131
+ * @stability experimental
132
+ */
133
+ export declare function Field({ label, value, color, dim, }: {
134
+ label: string;
135
+ value: string;
136
+ color?: string | undefined;
137
+ dim?: boolean | undefined;
138
+ }): ReactNode;
139
+ /**
140
+ * An error, rendered the same way everywhere.
141
+ *
142
+ * `hint` is separate from `message` so the remedy is visually distinct from the
143
+ * diagnosis. The messages this CLI produces already carry their own remedy
144
+ * (see errors.ts), so `hint` is for the extra sentence a SCREEN can add and the
145
+ * error itself cannot — "press r to try again".
146
+ * @stability experimental
147
+ */
148
+ export declare function ErrorNotice({ message, hint, }: {
149
+ message: string;
150
+ hint?: string | undefined;
151
+ }): ReactNode;
152
+ //# sourceMappingURL=layout.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/engine/tui/layout.tsx"],"names":[],"mappings":"AACA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAiBpE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,KAAK,CAAC;AAe/B;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAqC9C;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,IAAI,MAAM,OAAO,CAe5C;AAMD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,UAAU,GAAG,SAAS,CAwCvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAgBlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,KAAK,EACL,KAAK,EACL,GAAG,GACJ,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B,GAAG,SAAS,CAYZ;AAID;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAI,GACL,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,GAAG,SAAS,CAUZ"}
@@ -0,0 +1,214 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { Box, Text, useStdout } from 'ink';
3
+ import { useEffect, useRef, useState } from 'react';
4
+ import { cliDisplayName, cliVersion } from '../identity.js';
5
+ import { useOptionalTuiApp, useTuiTheme } from './context.js';
6
+ import { textColor } from './theme.js';
7
+ // =============================================================================
8
+ // Layout primitives and the narrow-terminal degrade (issue #145, epic #110)
9
+ // =============================================================================
10
+ //
11
+ // Everything shared between screens lives here: the frame, the key hints, the
12
+ // terminal-size hook, and the after-unmount guard. Screens import from this
13
+ // file rather than reaching for `useStdout` themselves, so the degrade rules
14
+ // below are applied uniformly instead of being re-derived (differently) five
15
+ // times.
16
+ // =============================================================================
17
+ /**
18
+ * Below this many columns the chrome is dropped.
19
+ *
20
+ * FIFTY-SIX because that is roughly what the widest fixed content needs — the
21
+ * device-flow instruction panel, a `GET /api/users → 200 OK (41ms)` status
22
+ * line — plus a two-column border and two of padding on each side. Narrower
23
+ * than that and the border characters start consuming the content they are
24
+ * meant to frame, which is worse than no border: yoga wraps mid-word inside a
25
+ * box it cannot shrink, and the result is a smear of broken box-drawing
26
+ * characters rather than a smaller version of the UI.
27
+ *
28
+ * The number is a THRESHOLD, not a minimum viable width: below it the UI keeps
29
+ * working, it just stops drawing decoration. #145 asks for degrade, not
30
+ * refusal — a user in a tmux split or an 80-column window halved is a normal
31
+ * case, and a TUI that says "your terminal is too small" to someone who can
32
+ * plainly see text on it is a TUI they stop using.
33
+ * @stability experimental
34
+ */
35
+ export const NARROW_COLUMNS = 56;
36
+ /**
37
+ * Below this, drop even the header and the padding.
38
+ *
39
+ * Thirty is about the width of a phone-sized SSH session. There is no useful
40
+ * layout left at this size, only content, so that is all that is drawn.
41
+ * @stability experimental
42
+ */
43
+ export const TINY_COLUMNS = 30;
44
+ /**
45
+ * Assumed size when the terminal will not say.
46
+ *
47
+ * `stdout.columns` is `undefined` on a stream that is not a TTY and can be `0`
48
+ * during a resize, while some terminal multiplexers report 0 for a pane that is
49
+ * momentarily hidden. Yoga treats a width of 0 as "collapse everything", so a
50
+ * single unlucky read would flatten the whole UI into a column of single
51
+ * characters — briefly, and often enough to look like a rendering bug. Falling
52
+ * back to the classic 80x24 keeps the layout stable through that.
53
+ */
54
+ const FALLBACK_COLUMNS = 80;
55
+ const FALLBACK_ROWS = 24;
56
+ /**
57
+ * The current terminal size, updated on resize.
58
+ *
59
+ * ink re-renders on its own when the terminal is resized, but it does NOT
60
+ * publish the new size as state — a component that read `stdout.columns` during
61
+ * render would get the fresh value only because a re-render happened to be
62
+ * scheduled, which is a coincidence rather than a subscription. Owning the
63
+ * listener here makes the resize an explicit state change, which is what #145
64
+ * asks for: the layout must actually respond, not merely survive.
65
+ *
66
+ * The listener is removed on unmount. `process.stdout` is a long-lived emitter
67
+ * shared with the whole runtime, so a leaked listener here outlives the UI and
68
+ * fires against unmounted components for the rest of the process's life.
69
+ * @stability experimental
70
+ */
71
+ export function useTerminalSize() {
72
+ const { stdout } = useStdout();
73
+ const read = () => ({
74
+ columns: normaliseDimension(stdout?.columns, FALLBACK_COLUMNS),
75
+ rows: normaliseDimension(stdout?.rows, FALLBACK_ROWS),
76
+ });
77
+ const [size, setSize] = useState(read);
78
+ useEffect(() => {
79
+ if (!stdout)
80
+ return;
81
+ const onResize = () => {
82
+ setSize({
83
+ columns: normaliseDimension(stdout.columns, FALLBACK_COLUMNS),
84
+ rows: normaliseDimension(stdout.rows, FALLBACK_ROWS),
85
+ });
86
+ };
87
+ // Read once on mount as well: between the `useState` initialiser and this
88
+ // effect the terminal may already have changed (it happens when the app is
89
+ // launched from a script that resizes the window), and without this the UI
90
+ // would hold a stale size until the NEXT resize.
91
+ onResize();
92
+ stdout.on('resize', onResize);
93
+ return () => {
94
+ stdout.off('resize', onResize);
95
+ };
96
+ }, [stdout]);
97
+ return {
98
+ columns: size.columns,
99
+ rows: size.rows,
100
+ narrow: size.columns < NARROW_COLUMNS,
101
+ tiny: size.columns < TINY_COLUMNS,
102
+ };
103
+ }
104
+ function normaliseDimension(value, fallback) {
105
+ return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : fallback;
106
+ }
107
+ /**
108
+ * A guard against writing state after unmount.
109
+ *
110
+ * EVERY SCREEN IN THIS TUI NEEDS IT, because every screen does network work
111
+ * that outlives a keypress. The device-flow login polls for up to fifteen
112
+ * minutes; a user who presses Esc, or Ctrl-C, is unmounted immediately while
113
+ * the in-flight request keeps running and its `.then` still holds a setter for
114
+ * a component that no longer exists. React 18+ no longer warns about this, so
115
+ * the symptom is not a console message but a leak, and — once ink has torn the
116
+ * renderer down — a possible throw from inside a reconciler that has already
117
+ * stopped. `ee2078c fix(web): stop hooks writing state after unmount` is the
118
+ * same bug in apps/web.
119
+ *
120
+ * Returns a getter rather than the ref itself so a caller cannot accidentally
121
+ * capture `ref.current`'s value at closure-creation time, which would always be
122
+ * `true` and defeat the whole thing.
123
+ */
124
+ export function useIsMounted() {
125
+ const mounted = useRef(true);
126
+ useEffect(() => {
127
+ // Reset on mount as well as clearing on unmount: React's StrictMode double
128
+ // -invokes effects, and a ref left `false` by the first teardown would make
129
+ // every subsequent update a no-op — a screen that renders once and then
130
+ // never changes again.
131
+ mounted.current = true;
132
+ return () => {
133
+ mounted.current = false;
134
+ };
135
+ }, []);
136
+ return () => mounted.current;
137
+ }
138
+ /**
139
+ * The window every screen sits in: a header, the content, and a hint line.
140
+ *
141
+ * THE DEGRADE IS THE INTERESTING PART. Three tiers, chosen by width:
142
+ *
143
+ * full (\>= NARROW_COLUMNS) bordered box, padding, header, hints
144
+ * narrow (\>= TINY_COLUMNS) no border, no side padding, header, hints
145
+ * tiny (\< TINY_COLUMNS) content only
146
+ *
147
+ * A bordered `Box` is NOT given an explicit width at any tier. Setting
148
+ * `width={columns}` looks right and is a bug: ink measures the terminal itself,
149
+ * and a box asked for exactly the full width has nowhere to put its own border,
150
+ * so the right-hand edge wraps onto the next line and every frame ends with a
151
+ * row of orphaned box characters. Letting the box size itself and constraining
152
+ * only the CONTENT is what keeps the frame intact at every width.
153
+ * @stability experimental
154
+ */
155
+ export function Frame({ title, hints, children }) {
156
+ const { narrow, tiny } = useTerminalSize();
157
+ const theme = useTuiTheme();
158
+ const app = useOptionalTuiApp();
159
+ // The app's selections as chips (`[Project: Alpha]`); none registered, none shown.
160
+ const chips = Object.values(app?.selection ?? {}).filter((entry) => entry.text !== undefined);
161
+ if (tiny) {
162
+ return _jsx(Box, { flexDirection: "column", children: children });
163
+ }
164
+ const body = (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, ...textColor(theme.primary), children: cliDisplayName() }), _jsxs(Text, { dimColor: true, children: [" v", cliVersion()] }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsx(Text, { bold: true, children: title }), chips.map((chip) => (_jsx(Text, { ...textColor(theme.accent), children: ` [${chip.label}: ${chip.text ?? ''}]` }, chip.id)))] }), _jsx(Box, { flexDirection: "column", children: children }), hints !== undefined && hints.length > 0 ? _jsx(KeyHints, { hints: hints }) : null] }));
165
+ if (narrow)
166
+ return body;
167
+ return (_jsx(Box, { borderStyle: "round", ...(theme.dim === undefined ? {} : { borderColor: theme.dim }), paddingX: 2, paddingY: 1, flexDirection: "column", children: body }));
168
+ }
169
+ /**
170
+ * The bottom line of every screen.
171
+ *
172
+ * Always present, and always including the key that gets OUT. A full-screen app
173
+ * that has captured the keyboard and does not say how to leave is the reason
174
+ * people are wary of them; Esc and Ctrl-C are both listed on every screen for
175
+ * exactly that reason, even where it looks redundant.
176
+ *
177
+ * Separators are dropped when narrow: at that width the hints wrap, and a
178
+ * wrapped line beginning with a lone dot reads as corruption.
179
+ * @stability experimental
180
+ */
181
+ export function KeyHints({ hints }) {
182
+ const { narrow } = useTerminalSize();
183
+ if (narrow) {
184
+ return (_jsx(Box, { flexDirection: "column", children: hints.map((hint) => (_jsx(Text, { dimColor: true, children: hint }, hint))) }));
185
+ }
186
+ return _jsx(Text, { dimColor: true, children: hints.join(' · ') });
187
+ }
188
+ /**
189
+ * A labelled row: a fixed-width label and a value.
190
+ *
191
+ * The label column is padded rather than laid out with a `<Box width>` because
192
+ * ink measures a Box in cells and these labels are ASCII — padding is exact,
193
+ * one flex node cheaper per row, and immune to the width-collapse described in
194
+ * `Frame`.
195
+ * @stability experimental
196
+ */
197
+ export function Field({ label, value, color, dim, }) {
198
+ return (_jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: label.padEnd(FIELD_LABEL_WIDTH) }), _jsx(Text, { ...(color === undefined ? {} : { color }), ...(dim === true ? { dimColor: true } : {}), children: value })] }));
199
+ }
200
+ const FIELD_LABEL_WIDTH = 10;
201
+ /**
202
+ * An error, rendered the same way everywhere.
203
+ *
204
+ * `hint` is separate from `message` so the remedy is visually distinct from the
205
+ * diagnosis. The messages this CLI produces already carry their own remedy
206
+ * (see errors.ts), so `hint` is for the extra sentence a SCREEN can add and the
207
+ * error itself cannot — "press r to try again".
208
+ * @stability experimental
209
+ */
210
+ export function ErrorNotice({ message, hint, }) {
211
+ const theme = useTuiTheme();
212
+ return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, ...textColor(theme.error), children: [theme.glyphs.cross, " ", message] }), hint === undefined ? null : _jsx(Text, { dimColor: true, children: hint })] }));
213
+ }
214
+ //# sourceMappingURL=layout.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/engine/tui/layout.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,201 @@
1
+ import { type TuiMenuContext } from './screen-registry.js';
2
+ import type { TuiColor } from './theme.js';
3
+ /**
4
+ * The id of the implicit root section. Reserved.
5
+ *
6
+ * @stability experimental
7
+ */
8
+ export declare const TUI_MENU_ROOT = "root";
9
+ /**
10
+ * The deepest a section may nest (a section directly under the root is level 1).
11
+ *
12
+ * @stability experimental
13
+ */
14
+ export declare const TUI_MENU_MAX_DEPTH = 4;
15
+ /**
16
+ * A menu label: fixed, or a function of the login state.
17
+ *
18
+ * @stability experimental
19
+ */
20
+ export type TuiMenuLabel = string | ((context: TuiMenuContext) => string);
21
+ /**
22
+ * Fields both node kinds share.
23
+ *
24
+ * @stability experimental
25
+ */
26
+ export interface TuiMenuNodeBase {
27
+ /** Unique across sections and entries: lowercase `[a-z][a-z0-9-]*`; `root` is reserved. */
28
+ id: string;
29
+ /** The section it sits in. Default `root`. */
30
+ parent?: string | undefined;
31
+ /** What the menu shows; a function gets `{ loggedIn }`. */
32
+ label: TuiMenuLabel;
33
+ /** Position among its siblings: lower first; ties sort by id. */
34
+ order: number;
35
+ /**
36
+ * Visible when logged out. Omitted means INHERITED from the nearest ancestor
37
+ * that sets it (default false: hidden until login). An explicit `false`
38
+ * opts one child out of an offline section.
39
+ */
40
+ loggedOut?: boolean | undefined;
41
+ /** Hide the node once logged in (a "Login" entry that moves elsewhere). */
42
+ hideWhenLoggedIn?: boolean | undefined;
43
+ /** A theme token name (`error`, `success`, ...) or a plain colour such as `red`. Presentation only. */
44
+ color?: TuiColor;
45
+ }
46
+ /**
47
+ * What a menu slot's content function is given.
48
+ *
49
+ * @stability experimental
50
+ */
51
+ export interface TuiMenuSlotContext {
52
+ /** Whether a token is stored. */
53
+ loggedIn: boolean;
54
+ /** The terminal width, so wide header art can fall back to a short title. */
55
+ columns: number;
56
+ /** The section the menu shows (`root` at the top). */
57
+ sectionId: string;
58
+ /** What the app's state loaders loaded (`useTuiState`), by loader id; empty until they settle. */
59
+ state: Readonly<Record<string, unknown>>;
60
+ }
61
+ /**
62
+ * A slot's text: a line, several lines (a string may also hold `\n`), or a
63
+ * function of {@link TuiMenuSlotContext} returning either (`undefined` or an
64
+ * empty list draws nothing). Plain text only, so registering it never loads
65
+ * ink and it reads the same in monochrome.
66
+ *
67
+ * @stability experimental
68
+ */
69
+ export type TuiMenuSlotContent = string | readonly string[] | ((context: TuiMenuSlotContext) => string | readonly string[] | undefined);
70
+ /**
71
+ * A banner or footnote of a menu (seam #1115). Each line is truncated to the
72
+ * terminal width rather than wrapped, so header art never smears at 40 or 24
73
+ * columns; give a function that checks `columns` to draw something shorter.
74
+ *
75
+ * @stability experimental
76
+ */
77
+ export interface TuiMenuSlot {
78
+ /** The text. */
79
+ content: TuiMenuSlotContent;
80
+ /**
81
+ * A theme token name or a plain colour, resolved like a node's `color` (no
82
+ * colour under `NO_COLOR`). Default `banner` for a banner, `dim` for a footnote.
83
+ */
84
+ color?: TuiColor;
85
+ }
86
+ /**
87
+ * The optional slots of a menu: a banner above the entries and a footnote
88
+ * below them (header art, "update available", a support line).
89
+ *
90
+ * @stability experimental
91
+ */
92
+ export interface TuiMenuSlots {
93
+ /** Drawn at the top of the menu, above the subtitle line. */
94
+ banner?: TuiMenuSlot | undefined;
95
+ /** Drawn under the entries. */
96
+ footnote?: TuiMenuSlot | undefined;
97
+ }
98
+ /**
99
+ * A submenu.
100
+ *
101
+ * @stability experimental
102
+ */
103
+ export interface TuiMenuSection extends TuiMenuNodeBase, TuiMenuSlots {
104
+ /** Discriminant. */
105
+ kind: 'section';
106
+ /** Shown under the breadcrumb instead of the default hint. */
107
+ subtitle?: string | undefined;
108
+ }
109
+ /**
110
+ * A menu line that opens a registered screen.
111
+ *
112
+ * @stability experimental
113
+ */
114
+ export interface TuiMenuEntry extends TuiMenuNodeBase {
115
+ /** Discriminant. */
116
+ kind: 'entry';
117
+ /** A registered screen route (built-in or `registerTuiScreen`). */
118
+ route: string;
119
+ /** The screen asks for a further input step first; rendered with a trailing `…`. */
120
+ ellipsis?: boolean | undefined;
121
+ /**
122
+ * Opening the screen while logged out shows the shared "not logged in"
123
+ * notice instead. Default: true unless the entry is visible when logged out.
124
+ */
125
+ requiresLogin?: boolean | undefined;
126
+ }
127
+ /**
128
+ * A node of the menu tree.
129
+ *
130
+ * @stability experimental
131
+ */
132
+ export type TuiMenuNode = TuiMenuSection | TuiMenuEntry;
133
+ /**
134
+ * Sets the root menu's banner and footnote (seam #1115); a section takes its
135
+ * own through `banner` and `footnote` on the node. A second call replaces the
136
+ * first. Same as `createCli({ tuiMenuRoot })`.
137
+ *
138
+ * @param slots - The banner and the footnote; `{}` or `undefined` removes both.
139
+ * @throws Error when a slot has no valid `content`, or when `createCli` has already built the CLI.
140
+ * @stability experimental
141
+ * @extensionPoint slot
142
+ * @example
143
+ * ```ts
144
+ * setTuiRootMenuSlots({
145
+ * banner: { content: ({ columns }) => (columns >= 40 ? ['╔═╗ Product X', '╚═╝ control panel'] : 'Product X') },
146
+ * footnote: { content: ({ state }) => (state['update'] === undefined ? undefined : 'An update is available.'), color: 'warning' },
147
+ * });
148
+ * ```
149
+ */
150
+ export declare function setTuiRootMenuSlots(slots: TuiMenuSlots | undefined): void;
151
+ /**
152
+ * The root menu's slots set with {@link setTuiRootMenuSlots}.
153
+ *
154
+ * @returns The slots (`{}` when none are set).
155
+ * @stability experimental
156
+ */
157
+ export declare function getTuiRootMenuSlots(): TuiMenuSlots;
158
+ /**
159
+ * Adds a section or an entry to the TUI menu tree.
160
+ *
161
+ * Unknown `parent` and unknown `route` are rejected when `createCli` builds
162
+ * the CLI (so registration order is free), together with cycles and nesting
163
+ * deeper than {@link TUI_MENU_MAX_DEPTH}.
164
+ *
165
+ * @param node - A section (`kind: 'section'`) or an entry (`kind: 'entry'`, with a `route`).
166
+ * @throws Error when the id is malformed, reserved or taken, a field is missing, or `createCli` has already built the CLI.
167
+ * @stability experimental
168
+ * @extensionPoint registry
169
+ * @example
170
+ * ```ts
171
+ * registerTuiMenuNode({ kind: 'section', id: 'node', label: 'Worker node', order: 40 });
172
+ * registerTuiMenuNode({ kind: 'entry', id: 'node-dashboard', parent: 'node', route: 'node-dashboard', label: 'Dashboard', order: 10 });
173
+ * ```
174
+ */
175
+ export declare function registerTuiMenuNode(node: TuiMenuNode): void;
176
+ /**
177
+ * The menu nodes registered so far, in registration order.
178
+ *
179
+ * @returns A frozen copy.
180
+ * @stability experimental
181
+ */
182
+ export declare function listTuiMenuNodes(): readonly TuiMenuNode[];
183
+ /**
184
+ * Checks the references between nodes and screens.
185
+ *
186
+ * @param nodes - The registered nodes.
187
+ * @param routes - Every screen route that exists.
188
+ * @throws Error naming the offending node id for an unknown or non-section parent, an unknown route, a cycle, or nesting deeper than {@link TUI_MENU_MAX_DEPTH}.
189
+ * @stability experimental
190
+ */
191
+ export declare function validateTuiMenuNodes(nodes: readonly TuiMenuNode[], routes: readonly string[]): void;
192
+ /**
193
+ * Validates the registered nodes against the screens, then refuses later
194
+ * registrations; `createCli` calls it.
195
+ *
196
+ * @throws Error from {@link validateTuiMenuNodes}; nothing is frozen then.
197
+ */
198
+ export declare function freezeTuiMenuRegistry(by: string): void;
199
+ /** Empties the registry. Tests only. */
200
+ export declare function resetTuiMenuRegistryForTests(): void;
201
+ //# sourceMappingURL=menu-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"menu-registry.d.ts","sourceRoot":"","sources":["../../../src/engine/tui/menu-registry.ts"],"names":[],"mappings":"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"}