@adea-ai/app-framework 0.0.0-stage → 0.24.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 (474) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +30 -0
  3. package/README.md +967 -2
  4. package/dist/app/application.d.ts +47 -0
  5. package/dist/app/application.js +115 -0
  6. package/dist/app/create-application.d.ts +13 -0
  7. package/dist/app/create-application.js +178 -0
  8. package/dist/app/service-registry.d.ts +44 -0
  9. package/dist/app/service-registry.js +116 -0
  10. package/dist/appearance/appearance-host.d.ts +62 -0
  11. package/dist/appearance/appearance-host.js +115 -0
  12. package/dist/appearance/appearance-preferences.d.ts +106 -0
  13. package/dist/appearance/appearance-preferences.js +175 -0
  14. package/dist/appearance/composition.d.ts +11 -0
  15. package/dist/appearance/composition.js +16 -0
  16. package/dist/appearance/custom-theme-import.d.ts +14 -0
  17. package/dist/appearance/custom-theme-import.js +315 -0
  18. package/dist/appearance/custom-theme-library.d.ts +146 -0
  19. package/dist/appearance/custom-theme-library.js +378 -0
  20. package/dist/appearance/editor.d.ts +20 -0
  21. package/dist/appearance/editor.js +47 -0
  22. package/dist/appearance/theme-file-importer.d.ts +23 -0
  23. package/dist/appearance/theme-file-importer.js +66 -0
  24. package/dist/appearance/theme-record-adapter.d.ts +26 -0
  25. package/dist/appearance/theme-record-adapter.js +64 -0
  26. package/dist/appearance/theme-registry.d.ts +10 -0
  27. package/dist/appearance/theme-registry.js +16 -0
  28. package/dist/appearance/window-surface.d.ts +5 -0
  29. package/dist/appearance/window-surface.js +9 -0
  30. package/dist/ci/toolchain-identity.d.ts +39 -0
  31. package/dist/ci/toolchain-identity.js +196 -0
  32. package/dist/cli/cef-helper-cli.d.ts +2 -0
  33. package/dist/cli/cef-helper-cli.js +18 -0
  34. package/dist/cli/cli-runner.d.ts +8 -0
  35. package/dist/cli/cli-runner.js +23 -0
  36. package/dist/cli/create-application-cli.d.ts +2 -0
  37. package/dist/cli/create-application-cli.js +40 -0
  38. package/dist/cli/electrobun-shortcut-patch-cli.d.ts +2 -0
  39. package/dist/cli/electrobun-shortcut-patch-cli.js +17 -0
  40. package/dist/cli/framework-update-cli.d.ts +2 -0
  41. package/dist/cli/framework-update-cli.js +40 -0
  42. package/dist/cli/release-assets-plan-cli.d.ts +2 -0
  43. package/dist/cli/release-assets-plan-cli.js +14 -0
  44. package/dist/cli/release-cut-cli.d.ts +2 -0
  45. package/dist/cli/release-cut-cli.js +27 -0
  46. package/dist/cli/release-descriptor-staging-cli.d.ts +2 -0
  47. package/dist/cli/release-descriptor-staging-cli.js +45 -0
  48. package/dist/cli/release-finalize-cli.d.ts +1 -0
  49. package/dist/cli/release-finalize-cli.js +30 -0
  50. package/dist/cli/release-promote-cli.d.ts +2 -0
  51. package/dist/cli/release-promote-cli.js +32 -0
  52. package/dist/cli/release-publish-cli.d.ts +2 -0
  53. package/dist/cli/release-publish-cli.js +48 -0
  54. package/dist/cli/release-sign-cli.d.ts +2 -0
  55. package/dist/cli/release-sign-cli.js +13 -0
  56. package/dist/cli/release-step-cli.d.ts +2 -0
  57. package/dist/cli/release-step-cli.js +44 -0
  58. package/dist/cli/toolchain-identity-cli.d.ts +2 -0
  59. package/dist/cli/toolchain-identity-cli.js +10 -0
  60. package/dist/cli/update-helper-cli.d.ts +1 -0
  61. package/dist/cli/update-helper-cli.js +10 -0
  62. package/dist/cli/windows-runtime-patch-cli.d.ts +2 -0
  63. package/dist/cli/windows-runtime-patch-cli.js +17 -0
  64. package/dist/desktop/application-command-client.d.ts +15 -0
  65. package/dist/desktop/application-command-client.js +21 -0
  66. package/dist/desktop/channel-handshake.d.ts +32 -0
  67. package/dist/desktop/channel-handshake.js +111 -0
  68. package/dist/desktop/channel-proof.d.ts +43 -0
  69. package/dist/desktop/channel-proof.js +85 -0
  70. package/dist/desktop/client-assets.d.ts +7 -0
  71. package/dist/desktop/client-assets.js +59 -0
  72. package/dist/desktop/desktop-client.d.ts +23 -0
  73. package/dist/desktop/desktop-client.js +231 -0
  74. package/dist/desktop/desktop-gateway.d.ts +18 -0
  75. package/dist/desktop/desktop-gateway.js +146 -0
  76. package/dist/desktop/desktop-host.d.ts +48 -0
  77. package/dist/desktop/desktop-host.js +208 -0
  78. package/dist/desktop/desktop-stream.d.ts +36 -0
  79. package/dist/desktop/desktop-stream.js +231 -0
  80. package/dist/desktop/loopback-policy.d.ts +19 -0
  81. package/dist/desktop/loopback-policy.js +23 -0
  82. package/dist/desktop/open-url-channel.d.ts +15 -0
  83. package/dist/desktop/open-url-channel.js +55 -0
  84. package/dist/desktop/string-policy.d.ts +2 -0
  85. package/dist/desktop/string-policy.js +11 -0
  86. package/dist/framework-source.json +1 -0
  87. package/dist/installer/archive-entry.d.ts +6 -0
  88. package/dist/installer/archive-entry.js +14 -0
  89. package/dist/installer/command-artifact.d.ts +47 -0
  90. package/dist/installer/command-artifact.js +261 -0
  91. package/dist/installer/command-qualification-command.d.ts +12 -0
  92. package/dist/installer/command-qualification-command.js +71 -0
  93. package/dist/installer/hosted-runner.d.ts +4 -0
  94. package/dist/installer/hosted-runner.js +10 -0
  95. package/dist/installer/installed-payload.d.ts +29 -0
  96. package/dist/installer/installed-payload.js +312 -0
  97. package/dist/installer/installer-ci-bootstrap.d.ts +26 -0
  98. package/dist/installer/installer-ci-bootstrap.js +160 -0
  99. package/dist/installer/installer-ci-preflight.d.ts +1 -0
  100. package/dist/installer/installer-ci-preflight.js +49 -0
  101. package/dist/installer/installer-ci-worker.d.ts +1 -0
  102. package/dist/installer/installer-ci-worker.js +105 -0
  103. package/dist/installer/installer-extraction.d.ts +14 -0
  104. package/dist/installer/installer-extraction.js +289 -0
  105. package/dist/installer/installer-fetch-guard.d.ts +15 -0
  106. package/dist/installer/installer-fetch-guard.js +50 -0
  107. package/dist/installer/installer-identity.d.ts +23 -0
  108. package/dist/installer/installer-identity.js +286 -0
  109. package/dist/installer/installer-layout.d.ts +21 -0
  110. package/dist/installer/installer-layout.js +89 -0
  111. package/dist/installer/installer-observation.d.ts +64 -0
  112. package/dist/installer/installer-observation.js +473 -0
  113. package/dist/installer/installer-process-cleanup.d.ts +18 -0
  114. package/dist/installer/installer-process-cleanup.js +158 -0
  115. package/dist/installer/installer-qualification-command.d.ts +11 -0
  116. package/dist/installer/installer-qualification-command.js +71 -0
  117. package/dist/installer/installer-renderer-evidence.d.ts +43 -0
  118. package/dist/installer/installer-renderer-evidence.js +136 -0
  119. package/dist/installer/installer-upgrade-command.d.ts +37 -0
  120. package/dist/installer/installer-upgrade-command.js +172 -0
  121. package/dist/installer/installer-worker-guard.d.ts +21 -0
  122. package/dist/installer/installer-worker-guard.js +72 -0
  123. package/dist/installer/native-executable.d.ts +5 -0
  124. package/dist/installer/native-executable.js +21 -0
  125. package/dist/installer/upgrade-asset-download.d.ts +13 -0
  126. package/dist/installer/upgrade-asset-download.js +41 -0
  127. package/dist/installer/write-all.d.ts +6 -0
  128. package/dist/installer/write-all.js +11 -0
  129. package/dist/native/app-bundle.d.ts +28 -0
  130. package/dist/native/app-bundle.js +60 -0
  131. package/dist/native/cef-helper.d.ts +28 -0
  132. package/dist/native/cef-helper.js +402 -0
  133. package/dist/native/desktop-build-hook.d.ts +7 -0
  134. package/dist/native/desktop-build-hook.js +20 -0
  135. package/dist/native/electrobun-source-patch.d.ts +25 -0
  136. package/dist/native/electrobun-source-patch.js +93 -0
  137. package/dist/native/linux-cef-links.d.ts +2 -0
  138. package/dist/native/linux-cef-links.js +15 -0
  139. package/dist/native/native-secret-store.d.ts +27 -0
  140. package/dist/native/native-secret-store.js +70 -0
  141. package/dist/native/native-utilities.d.ts +24 -0
  142. package/dist/native/native-utilities.js +85 -0
  143. package/dist/native/partitioned-window.d.ts +34 -0
  144. package/dist/native/partitioned-window.js +44 -0
  145. package/dist/native/renderer-profile.d.ts +53 -0
  146. package/dist/native/renderer-profile.js +30 -0
  147. package/dist/native/secure-window.d.ts +38 -0
  148. package/dist/native/secure-window.js +77 -0
  149. package/dist/native/sidecar-services.d.ts +23 -0
  150. package/dist/native/sidecar-services.js +46 -0
  151. package/dist/native/sidecar.d.ts +81 -0
  152. package/dist/native/sidecar.js +250 -0
  153. package/dist/native/window-bootstrap.d.ts +24 -0
  154. package/dist/native/window-bootstrap.js +63 -0
  155. package/dist/native/window-options.d.ts +32 -0
  156. package/dist/native/window-options.js +23 -0
  157. package/dist/native/windows-build-hook-internal.d.ts +2 -0
  158. package/dist/native/windows-build-hook-internal.js +32 -0
  159. package/dist/native/windows-build-hook.d.ts +2 -0
  160. package/dist/native/windows-build-hook.js +12 -0
  161. package/dist/native/windows-runtime-patch-internal.d.ts +3 -0
  162. package/dist/native/windows-runtime-patch-internal.js +20 -0
  163. package/dist/native/windows-runtime-patch.d.ts +4 -0
  164. package/dist/native/windows-runtime-patch.js +12 -0
  165. package/dist/release/feed-release-cut.d.ts +23 -0
  166. package/dist/release/feed-release-cut.js +93 -0
  167. package/dist/release/feed-state.d.ts +25 -0
  168. package/dist/release/feed-state.js +81 -0
  169. package/dist/release/framework-package-publish.d.ts +21 -0
  170. package/dist/release/framework-package-publish.js +125 -0
  171. package/dist/release/framework-update.d.ts +30 -0
  172. package/dist/release/framework-update.js +139 -0
  173. package/dist/release/github-cli.d.ts +6 -0
  174. package/dist/release/github-cli.js +16 -0
  175. package/dist/release/github-release-assets.d.ts +3 -0
  176. package/dist/release/github-release-assets.js +24 -0
  177. package/dist/release/github-release-cut.d.ts +14 -0
  178. package/dist/release/github-release-cut.js +174 -0
  179. package/dist/release/github-release-lookup.d.ts +7 -0
  180. package/dist/release/github-release-lookup.js +29 -0
  181. package/dist/release/github-release-promotion.d.ts +10 -0
  182. package/dist/release/github-release-promotion.js +78 -0
  183. package/dist/release/github-release-provenance.d.ts +9 -0
  184. package/dist/release/github-release-provenance.js +27 -0
  185. package/dist/release/github-release-publisher.d.ts +9 -0
  186. package/dist/release/github-release-publisher.js +63 -0
  187. package/dist/release/github-release-qualification.d.ts +12 -0
  188. package/dist/release/github-release-qualification.js +80 -0
  189. package/dist/release/local-provenance.d.ts +24 -0
  190. package/dist/release/local-provenance.js +72 -0
  191. package/dist/release/local-release.d.ts +133 -0
  192. package/dist/release/local-release.js +387 -0
  193. package/dist/release/macos-dmg.d.ts +22 -0
  194. package/dist/release/macos-dmg.js +91 -0
  195. package/dist/release/release-artifact.d.ts +6 -0
  196. package/dist/release/release-artifact.js +38 -0
  197. package/dist/release/release-assets-plan.d.ts +14 -0
  198. package/dist/release/release-assets-plan.js +65 -0
  199. package/dist/release/release-config.d.ts +76 -0
  200. package/dist/release/release-config.js +180 -0
  201. package/dist/release/release-cut-command.d.ts +13 -0
  202. package/dist/release/release-cut-command.js +39 -0
  203. package/dist/release/release-cut.d.ts +54 -0
  204. package/dist/release/release-cut.js +76 -0
  205. package/dist/release/release-descriptor-staging.d.ts +34 -0
  206. package/dist/release/release-descriptor-staging.js +147 -0
  207. package/dist/release/release-finalize.d.ts +16 -0
  208. package/dist/release/release-finalize.js +104 -0
  209. package/dist/release/release-promotion-command.d.ts +12 -0
  210. package/dist/release/release-promotion-command.js +28 -0
  211. package/dist/release/release-promotion.d.ts +29 -0
  212. package/dist/release/release-promotion.js +57 -0
  213. package/dist/release/release-publication.d.ts +33 -0
  214. package/dist/release/release-publication.js +138 -0
  215. package/dist/release/release-publish-command.d.ts +7 -0
  216. package/dist/release/release-publish-command.js +91 -0
  217. package/dist/release/release-qualification.d.ts +106 -0
  218. package/dist/release/release-qualification.js +135 -0
  219. package/dist/release/release-staging.d.ts +9 -0
  220. package/dist/release/release-staging.js +61 -0
  221. package/dist/release/release-steps.d.ts +38 -0
  222. package/dist/release/release-steps.js +147 -0
  223. package/dist/release/retained-release-build.d.ts +19 -0
  224. package/dist/release/retained-release-build.js +122 -0
  225. package/dist/shell/app-shell.d.ts +61 -0
  226. package/dist/shell/app-shell.js +318 -0
  227. package/dist/shell/app-utilities.d.ts +122 -0
  228. package/dist/shell/app-utilities.js +334 -0
  229. package/dist/shell/application-menu-commands.d.ts +5 -0
  230. package/dist/shell/application-menu-commands.js +11 -0
  231. package/dist/shell/application-menu.d.ts +61 -0
  232. package/dist/shell/application-menu.js +208 -0
  233. package/dist/shell/help-shortcuts.d.ts +12 -0
  234. package/dist/shell/help-shortcuts.js +22 -0
  235. package/dist/shell/settings-sections.d.ts +31 -0
  236. package/dist/shell/settings-sections.js +50 -0
  237. package/dist/shell/shortcut-platform.d.ts +17 -0
  238. package/dist/shell/shortcut-platform.js +25 -0
  239. package/dist/update-helper.bundle.js +260 -0
  240. package/dist/updates/channel-update-manager.d.ts +46 -0
  241. package/dist/updates/channel-update-manager.js +114 -0
  242. package/dist/updates/desktop-updater.d.ts +104 -0
  243. package/dist/updates/desktop-updater.js +345 -0
  244. package/dist/updates/release-feed.d.ts +61 -0
  245. package/dist/updates/release-feed.js +111 -0
  246. package/dist/updates/release-location.d.ts +9 -0
  247. package/dist/updates/release-location.js +80 -0
  248. package/dist/updates/release-version.d.ts +12 -0
  249. package/dist/updates/release-version.js +43 -0
  250. package/dist/updates/signed-release.d.ts +63 -0
  251. package/dist/updates/signed-release.js +162 -0
  252. package/dist/updates/stable-file.d.ts +10 -0
  253. package/dist/updates/stable-file.js +22 -0
  254. package/dist/updates/update-adapter.d.ts +57 -0
  255. package/dist/updates/update-adapter.js +72 -0
  256. package/dist/updates/update-arm.d.ts +24 -0
  257. package/dist/updates/update-arm.js +95 -0
  258. package/dist/updates/update-channel-store.d.ts +8 -0
  259. package/dist/updates/update-channel-store.js +72 -0
  260. package/dist/updates/update-discovery.d.ts +13 -0
  261. package/dist/updates/update-discovery.js +56 -0
  262. package/dist/updates/update-download.d.ts +14 -0
  263. package/dist/updates/update-download.js +67 -0
  264. package/dist/updates/update-exclusive-rename.d.ts +2 -0
  265. package/dist/updates/update-exclusive-rename.js +52 -0
  266. package/dist/updates/update-extraction.d.ts +18 -0
  267. package/dist/updates/update-extraction.js +183 -0
  268. package/dist/updates/update-handoff-plan.d.ts +22 -0
  269. package/dist/updates/update-handoff-plan.js +28 -0
  270. package/dist/updates/update-helper.d.ts +24 -0
  271. package/dist/updates/update-helper.js +56 -0
  272. package/dist/updates/update-launch.d.ts +5 -0
  273. package/dist/updates/update-launch.js +27 -0
  274. package/dist/updates/update-manager.d.ts +40 -0
  275. package/dist/updates/update-manager.js +83 -0
  276. package/dist/updates/update-process-fence.d.ts +10 -0
  277. package/dist/updates/update-process-fence.js +114 -0
  278. package/dist/updates/update-resume.d.ts +13 -0
  279. package/dist/updates/update-resume.js +34 -0
  280. package/dist/updates/update-shutdown.d.ts +15 -0
  281. package/dist/updates/update-shutdown.js +29 -0
  282. package/dist/updates/update-state.d.ts +30 -0
  283. package/dist/updates/update-state.js +18 -0
  284. package/dist/updates/update-swap-stage.d.ts +27 -0
  285. package/dist/updates/update-swap-stage.js +58 -0
  286. package/dist/updates/update-swap.d.ts +10 -0
  287. package/dist/updates/update-swap.js +30 -0
  288. package/dist/views/app-about.d.ts +22 -0
  289. package/dist/views/app-about.js +43 -0
  290. package/dist/views/app-appearance.d.ts +11 -0
  291. package/dist/views/app-appearance.js +42 -0
  292. package/dist/views/app-help.d.ts +17 -0
  293. package/dist/views/app-help.js +42 -0
  294. package/dist/views/app-settings.d.ts +26 -0
  295. package/dist/views/app-settings.js +97 -0
  296. package/dist/views/appearance-surface.d.ts +9 -0
  297. package/dist/views/appearance-surface.js +334 -0
  298. package/dist/views/update-surface.d.ts +34 -0
  299. package/dist/views/update-surface.js +64 -0
  300. package/package.json +363 -4
  301. package/src/app/application.tsx +138 -0
  302. package/src/app/create-application.ts +245 -0
  303. package/src/app/service-registry.ts +124 -0
  304. package/src/appearance/appearance-host.tsx +205 -0
  305. package/src/appearance/appearance-preferences.ts +287 -0
  306. package/src/appearance/composition.ts +29 -0
  307. package/src/appearance/custom-theme-import.ts +424 -0
  308. package/src/appearance/custom-theme-library.ts +600 -0
  309. package/src/appearance/editor.ts +94 -0
  310. package/src/appearance/theme-file-importer.ts +103 -0
  311. package/src/appearance/theme-record-adapter.ts +106 -0
  312. package/src/appearance/theme-registry.ts +20 -0
  313. package/src/appearance/window-surface.ts +18 -0
  314. package/src/ci/toolchain-identity.ts +244 -0
  315. package/src/cli/cef-helper-cli.ts +21 -0
  316. package/src/cli/cli-runner.ts +29 -0
  317. package/src/cli/create-application-cli.ts +62 -0
  318. package/src/cli/electrobun-shortcut-patch-cli.ts +24 -0
  319. package/src/cli/framework-update-cli.ts +41 -0
  320. package/src/cli/release-assets-plan-cli.ts +14 -0
  321. package/src/cli/release-cut-cli.ts +41 -0
  322. package/src/cli/release-descriptor-staging-cli.ts +57 -0
  323. package/src/cli/release-finalize-cli.ts +34 -0
  324. package/src/cli/release-promote-cli.ts +31 -0
  325. package/src/cli/release-publish-cli.ts +46 -0
  326. package/src/cli/release-sign-cli.ts +24 -0
  327. package/src/cli/release-step-cli.ts +71 -0
  328. package/src/cli/toolchain-identity-cli.ts +12 -0
  329. package/src/cli/update-helper-cli.ts +12 -0
  330. package/src/cli/windows-runtime-patch-cli.ts +17 -0
  331. package/src/desktop/application-command-client.ts +43 -0
  332. package/src/desktop/channel-handshake.ts +136 -0
  333. package/src/desktop/channel-proof.ts +122 -0
  334. package/src/desktop/client-assets.ts +75 -0
  335. package/src/desktop/desktop-client.ts +303 -0
  336. package/src/desktop/desktop-gateway.ts +189 -0
  337. package/src/desktop/desktop-host.ts +335 -0
  338. package/src/desktop/desktop-stream.ts +324 -0
  339. package/src/desktop/loopback-policy.ts +41 -0
  340. package/src/desktop/open-url-channel.ts +79 -0
  341. package/src/desktop/string-policy.ts +9 -0
  342. package/src/installer/archive-entry.ts +32 -0
  343. package/src/installer/command-artifact.ts +307 -0
  344. package/src/installer/command-qualification-command.ts +75 -0
  345. package/src/installer/hosted-runner.ts +11 -0
  346. package/src/installer/installed-payload.ts +408 -0
  347. package/src/installer/installer-ci-bootstrap.ts +199 -0
  348. package/src/installer/installer-ci-preflight.ts +61 -0
  349. package/src/installer/installer-ci-worker.ts +105 -0
  350. package/src/installer/installer-extraction.ts +367 -0
  351. package/src/installer/installer-fetch-guard.ts +75 -0
  352. package/src/installer/installer-identity.ts +331 -0
  353. package/src/installer/installer-layout.ts +167 -0
  354. package/src/installer/installer-observation.ts +671 -0
  355. package/src/installer/installer-process-cleanup.ts +167 -0
  356. package/src/installer/installer-qualification-command.ts +81 -0
  357. package/src/installer/installer-renderer-evidence.ts +268 -0
  358. package/src/installer/installer-upgrade-command.ts +226 -0
  359. package/src/installer/installer-worker-guard.ts +112 -0
  360. package/src/installer/native-executable.ts +37 -0
  361. package/src/installer/upgrade-asset-download.ts +72 -0
  362. package/src/installer/write-all.ts +19 -0
  363. package/src/native/app-bundle.ts +86 -0
  364. package/src/native/cef-helper.ts +471 -0
  365. package/src/native/desktop-build-hook.ts +21 -0
  366. package/src/native/electrobun-cef-main-frame-bridges.patch +63 -0
  367. package/src/native/electrobun-source-patch.ts +107 -0
  368. package/src/native/electrobun-windows-shortcut-com.patch +923 -0
  369. package/src/native/linux-cef-links.ts +14 -0
  370. package/src/native/native-secret-store.ts +99 -0
  371. package/src/native/native-utilities.ts +166 -0
  372. package/src/native/partitioned-window.ts +62 -0
  373. package/src/native/renderer-profile.ts +27 -0
  374. package/src/native/secure-window.ts +115 -0
  375. package/src/native/sidecar-services.ts +71 -0
  376. package/src/native/sidecar.ts +387 -0
  377. package/src/native/window-bootstrap.ts +77 -0
  378. package/src/native/window-options.ts +24 -0
  379. package/src/native/windows-build-hook-internal.ts +49 -0
  380. package/src/native/windows-build-hook.ts +12 -0
  381. package/src/native/windows-runtime-patch-internal.ts +48 -0
  382. package/src/native/windows-runtime-patch.ts +15 -0
  383. package/src/release/feed-release-cut.ts +110 -0
  384. package/src/release/feed-state.ts +135 -0
  385. package/src/release/framework-package-publish.ts +163 -0
  386. package/src/release/framework-update.ts +196 -0
  387. package/src/release/github-cli.ts +27 -0
  388. package/src/release/github-release-assets.ts +36 -0
  389. package/src/release/github-release-cut.ts +237 -0
  390. package/src/release/github-release-lookup.ts +39 -0
  391. package/src/release/github-release-promotion.ts +112 -0
  392. package/src/release/github-release-provenance.ts +65 -0
  393. package/src/release/github-release-publisher.ts +90 -0
  394. package/src/release/github-release-qualification.ts +144 -0
  395. package/src/release/local-provenance.ts +92 -0
  396. package/src/release/local-release.ts +525 -0
  397. package/src/release/macos-dmg.ts +113 -0
  398. package/src/release/release-artifact.ts +53 -0
  399. package/src/release/release-assets-plan.ts +118 -0
  400. package/src/release/release-config.ts +420 -0
  401. package/src/release/release-cut-command.ts +80 -0
  402. package/src/release/release-cut.ts +133 -0
  403. package/src/release/release-descriptor-staging.ts +242 -0
  404. package/src/release/release-finalize.ts +191 -0
  405. package/src/release/release-promotion-command.ts +36 -0
  406. package/src/release/release-promotion.ts +132 -0
  407. package/src/release/release-publication.ts +213 -0
  408. package/src/release/release-publish-command.ts +163 -0
  409. package/src/release/release-qualification.ts +397 -0
  410. package/src/release/release-staging.ts +87 -0
  411. package/src/release/release-steps.ts +173 -0
  412. package/src/release/retained-release-build.ts +217 -0
  413. package/src/shell/app-shell.tsx +285 -0
  414. package/src/shell/app-utilities.tsx +437 -0
  415. package/src/shell/application-menu-commands.ts +6 -0
  416. package/src/shell/application-menu.ts +250 -0
  417. package/src/shell/help-shortcuts.ts +24 -0
  418. package/src/shell/settings-sections.ts +74 -0
  419. package/src/shell/shortcut-platform.ts +35 -0
  420. package/src/updates/channel-update-manager.ts +127 -0
  421. package/src/updates/desktop-updater.ts +440 -0
  422. package/src/updates/release-feed.ts +187 -0
  423. package/src/updates/release-location.ts +101 -0
  424. package/src/updates/release-version.ts +57 -0
  425. package/src/updates/signed-release.ts +311 -0
  426. package/src/updates/stable-file.ts +32 -0
  427. package/src/updates/update-adapter.ts +129 -0
  428. package/src/updates/update-arm.ts +107 -0
  429. package/src/updates/update-channel-store.ts +86 -0
  430. package/src/updates/update-discovery.ts +113 -0
  431. package/src/updates/update-download.ts +82 -0
  432. package/src/updates/update-exclusive-rename.ts +58 -0
  433. package/src/updates/update-extraction.ts +261 -0
  434. package/src/updates/update-handoff-plan.ts +75 -0
  435. package/src/updates/update-helper.ts +87 -0
  436. package/src/updates/update-launch.ts +33 -0
  437. package/src/updates/update-manager.ts +130 -0
  438. package/src/updates/update-process-fence.ts +125 -0
  439. package/src/updates/update-resume.ts +34 -0
  440. package/src/updates/update-shutdown.ts +37 -0
  441. package/src/updates/update-state.ts +34 -0
  442. package/src/updates/update-swap-stage.ts +75 -0
  443. package/src/updates/update-swap.ts +30 -0
  444. package/src/views/app-about.tsx +44 -0
  445. package/src/views/app-appearance.tsx +32 -0
  446. package/src/views/app-help.tsx +43 -0
  447. package/src/views/app-settings.tsx +88 -0
  448. package/src/views/appearance-surface.tsx +427 -0
  449. package/src/views/update-surface.tsx +85 -0
  450. package/templates/application/.gitattributes +1 -0
  451. package/templates/application/.github/workflows/release-assets.yml +29 -0
  452. package/templates/application/.github/workflows/release-finalize.yml +29 -0
  453. package/templates/application/.github/workflows/release-please.yml +19 -0
  454. package/templates/application/.github/workflows/release.yml +29 -0
  455. package/templates/application/.github/workflows/validation.yml +28 -0
  456. package/templates/application/.oxfmtrc.json +6 -0
  457. package/templates/application/.oxlintrc.json +48 -0
  458. package/templates/application/.release-please-manifest.json +3 -0
  459. package/templates/application/README.md +47 -0
  460. package/templates/application/electrobun.config.ts +22 -0
  461. package/templates/application/release-please-config.json +12 -0
  462. package/templates/application/scripts/app-version.ts +9 -0
  463. package/templates/application/scripts/build-desktop.ts +34 -0
  464. package/templates/application/scripts/secure-build.ts +1 -0
  465. package/templates/application/scripts/stage-release.ts +21 -0
  466. package/templates/application/src/bun/index.ts +80 -0
  467. package/templates/application/src/electrobun.d.ts +27 -0
  468. package/templates/application/src/web/index.html +12 -0
  469. package/templates/application/src/web/main.tsx +97 -0
  470. package/templates/application/src/web/public/icon.svg +1 -0
  471. package/templates/application/src/web/style.css +3 -0
  472. package/templates/application/tests/app-config.test.ts +9 -0
  473. package/templates/application/tsconfig.json +15 -0
  474. package/templates/application/vite.config.ts +10 -0
@@ -0,0 +1,125 @@
1
+ import { execFile } from 'node:child_process'
2
+ import { dlopen, FFIType, ptr } from 'bun:ffi'
3
+ import { realpath } from 'node:fs/promises'
4
+ import { isAbsolute } from 'node:path'
5
+ import { promisify } from 'node:util'
6
+ const execute = promisify(execFile)
7
+
8
+ function isProcessRunning(pid: number): boolean {
9
+ try {
10
+ process.kill(pid, 0)
11
+ return true
12
+ } catch (error) {
13
+ if ((error as NodeJS.ErrnoException).code === 'ESRCH') return false
14
+ throw new Error('Cannot inspect update process', { cause: error })
15
+ }
16
+ }
17
+
18
+ /** Wait without signalling only processes whose executables were verified. This is not complete app-process discovery. */
19
+ export async function waitForUpdateProcesses(options: {
20
+ processes: readonly { pid: number; executable: string }[]
21
+ timeoutMs: number
22
+ env?: Record<string, string | undefined>
23
+ onVerified?: () => void
24
+ }): Promise<void> {
25
+ if (
26
+ !Array.isArray(options.processes) ||
27
+ options.processes.length < 1 ||
28
+ options.processes.length > 16 ||
29
+ !Number.isSafeInteger(options.timeoutMs) ||
30
+ options.timeoutMs < 1 ||
31
+ options.timeoutMs > 120000
32
+ )
33
+ throw new Error('Invalid update process fence')
34
+ const seen = new Set<number>(),
35
+ env: Record<string, string> = {}
36
+ const deadline = Date.now() + options.timeoutMs
37
+ for (const key of ['PATH', 'SystemRoot', 'WINDIR', 'TMP', 'TEMP', 'TMPDIR', 'LANG', 'LC_ALL'])
38
+ if ((options.env ?? process.env)[key]) env[key] = (options.env ?? process.env)[key]!
39
+ async function executable(pid: number): Promise<string> {
40
+ if (process.platform === 'linux') return realpath(`/proc/${pid}/exe`)
41
+ if (process.platform === 'darwin')
42
+ return realpath(
43
+ (
44
+ await execute('/bin/ps', ['-p', String(pid), '-o', 'comm='], {
45
+ env,
46
+ timeout: Math.max(1, Math.min(5000, deadline - Date.now())),
47
+ maxBuffer: 16384,
48
+ })
49
+ ).stdout.trim()
50
+ )
51
+ if (process.platform === 'win32') {
52
+ const library = dlopen('kernel32.dll', {
53
+ OpenProcess: { args: [FFIType.u32, FFIType.i32, FFIType.u32], returns: FFIType.ptr },
54
+ QueryFullProcessImageNameW: {
55
+ args: [FFIType.ptr, FFIType.u32, FFIType.ptr, FFIType.ptr],
56
+ returns: FFIType.i32,
57
+ },
58
+ CloseHandle: { args: [FFIType.ptr], returns: FFIType.i32 },
59
+ })
60
+ try {
61
+ const handle = library.symbols.OpenProcess(0x1000, 0, pid)
62
+ if (!handle) throw new Error('Cannot open update process')
63
+ try {
64
+ const buffer = Buffer.alloc(32768 * 2),
65
+ length = Buffer.alloc(4)
66
+ length.writeUInt32LE(32768)
67
+ if (!library.symbols.QueryFullProcessImageNameW(handle, 0, ptr(buffer), ptr(length)))
68
+ throw new Error('Cannot inspect update process')
69
+ const count = length.readUInt32LE()
70
+ if (!count || count >= 32768) throw new Error('Invalid update process path')
71
+ return await realpath(buffer.subarray(0, count * 2).toString('utf16le'))
72
+ } finally {
73
+ library.symbols.CloseHandle(handle)
74
+ }
75
+ } finally {
76
+ library.close()
77
+ }
78
+ }
79
+ throw new Error('Unsupported update process platform')
80
+ }
81
+ const waiting = new Set<number>()
82
+ for (const processInfo of options.processes) {
83
+ if (
84
+ !processInfo ||
85
+ !Number.isSafeInteger(processInfo.pid) ||
86
+ processInfo.pid < 2 ||
87
+ processInfo.pid > 0xffffffff ||
88
+ processInfo.pid === process.pid ||
89
+ seen.has(processInfo.pid) ||
90
+ typeof processInfo.executable !== 'string' ||
91
+ !isAbsolute(processInfo.executable)
92
+ )
93
+ throw new Error('Invalid update process identity')
94
+ if (Date.now() >= deadline) throw new Error('Update process fence timed out')
95
+ seen.add(processInfo.pid)
96
+ if (!isProcessRunning(processInfo.pid))
97
+ throw new Error('Update process exited before verification')
98
+ let actual: string
99
+ try {
100
+ actual = await executable(processInfo.pid)
101
+ } catch {
102
+ throw new Error('Cannot verify update process')
103
+ }
104
+ const expected = await realpath(processInfo.executable)
105
+ if (
106
+ process.platform === 'win32'
107
+ ? actual.toLowerCase() !== expected.toLowerCase()
108
+ : actual !== expected
109
+ )
110
+ throw new Error('Update process executable mismatch')
111
+ waiting.add(processInfo.pid)
112
+ }
113
+ if (Date.now() >= deadline) throw new Error('Update process fence timed out')
114
+ for (const pid of waiting)
115
+ if (!isProcessRunning(pid)) throw new Error('Update process exited before verification')
116
+ const notified: unknown = options.onVerified?.()
117
+ if (typeof notified === 'object' && notified !== null && 'then' in notified)
118
+ throw new Error('Update process acknowledgement must be synchronous')
119
+ while (waiting.size) {
120
+ for (const pid of waiting) if (!isProcessRunning(pid)) waiting.delete(pid)
121
+ if (!waiting.size) return
122
+ if (Date.now() >= deadline) throw new Error('Update processes did not exit')
123
+ await Bun.sleep(Math.min(100, Math.max(1, deadline - Date.now())))
124
+ }
125
+ }
@@ -0,0 +1,34 @@
1
+ import { lstat, readFile, rm } from 'node:fs/promises'
2
+ import { join } from 'node:path'
3
+ import { updateStagingFor } from './update-swap'
4
+
5
+ export type UpdateResumeResult = Readonly<
6
+ { status: 'none' | 'in-progress' | 'not-applied' } | { status: 'updated'; version: string }
7
+ >
8
+
9
+ function alive(pid: number): boolean {
10
+ try {
11
+ process.kill(pid, 0)
12
+ return true
13
+ } catch (error) {
14
+ return (error as NodeJS.ErrnoException).code === 'EPERM'
15
+ }
16
+ }
17
+
18
+ /**
19
+ * Call on app start. Reports whether an earlier helper installed an update and
20
+ * removes the staging directory, unless a helper is still running from it.
21
+ */
22
+ export async function resumeUpdate(options: { target: string }): Promise<UpdateResumeResult> {
23
+ const staging = updateStagingFor(options.target)
24
+ const info = await lstat(staging).catch(() => undefined)
25
+ if (!info) return { status: 'none' }
26
+ if (!info.isDirectory() || info.isSymbolicLink())
27
+ throw new Error('Unexpected update staging entry')
28
+ const helper = Number(await readFile(join(staging, 'helper-armed'), 'utf8').catch(() => 0))
29
+ if (Number.isSafeInteger(helper) && helper > 1 && helper !== process.pid && alive(helper))
30
+ return { status: 'in-progress' }
31
+ const version = await readFile(join(staging, 'updated'), 'utf8').catch(() => undefined)
32
+ await rm(staging, { recursive: true, force: true })
33
+ return version ? { status: 'updated', version } : { status: 'not-applied' }
34
+ }
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Reserve an app's existing quit approval before arming a post-exit helper.
3
+ * The native adapter must guarantee its token cannot be reused or vetoed again.
4
+ * `arm` must clean up partial startup before rejecting, and `quit` must only
5
+ * resolve after shutdown is accepted. The helper still needs a bounded process
6
+ * fence; this ordering alone does not establish that the app has exited.
7
+ */
8
+ export async function scheduleUpdateShutdown<Token>(options: {
9
+ reserve(): Token | null | Promise<Token | null>
10
+ cancelReservation(token: Token): void | Promise<void>
11
+ arm(): Promise<{ cancel(): void | Promise<void> }>
12
+ quit(token: Token): boolean | Promise<boolean>
13
+ }): Promise<'cancelled' | 'scheduled'> {
14
+ const token = await options.reserve()
15
+ if (token === null) return 'cancelled'
16
+ if (token === undefined) throw new Error('Invalid update quit approval')
17
+ let helper: { cancel(): void | Promise<void> } | undefined
18
+ try {
19
+ helper = await options.arm()
20
+ if (!helper || typeof helper.cancel !== 'function')
21
+ throw new Error('Update helper was not armed')
22
+ if ((await options.quit(token)) !== true) throw new Error('Update shutdown rejected')
23
+ return 'scheduled'
24
+ } catch {
25
+ try {
26
+ await helper?.cancel()
27
+ } catch {
28
+ /* Do not mask the handoff failure. */
29
+ }
30
+ try {
31
+ await options.cancelReservation(token)
32
+ } catch {
33
+ /* Do not mask the handoff failure. */
34
+ }
35
+ throw new Error('Update shutdown could not be scheduled')
36
+ }
37
+ }
@@ -0,0 +1,34 @@
1
+ /** The shared fields returned by the desktop update services. */
2
+ export type NativeUpdateState<Phase extends string = string> = Readonly<{
3
+ phase: Phase
4
+ current_version: string
5
+ available_version: string | null
6
+ changelog: string
7
+ release_notes: string | null
8
+ release_date: string | null
9
+ downloaded_bytes: number
10
+ total_bytes: number | null
11
+ error: string | null
12
+ github_url: string
13
+ restart_required: boolean
14
+ }>
15
+
16
+ /** Project a native snapshot into the shared UI update dialog contract. */
17
+ export function toUpdateState<Phase extends string>(
18
+ update: NativeUpdateState<Phase>,
19
+ options: { includeReleaseNotes?: boolean } = {}
20
+ ) {
21
+ return {
22
+ phase: update.phase,
23
+ currentVersion: update.current_version,
24
+ availableVersion: update.available_version,
25
+ changelog: update.changelog,
26
+ releaseNotes: options.includeReleaseNotes === false ? null : update.release_notes,
27
+ releaseDate: update.release_date,
28
+ downloadedBytes: update.downloaded_bytes,
29
+ totalBytes: update.total_bytes,
30
+ error: update.error,
31
+ releaseUrl: update.github_url,
32
+ restartRequired: update.restart_required,
33
+ }
34
+ }
@@ -0,0 +1,75 @@
1
+ import { lstat, mkdtemp, readFile, realpath, rm } from 'node:fs/promises'
2
+ import { join } from 'node:path'
3
+ import { planUpdateHandoff } from './update-handoff-plan'
4
+ import { extractVerifiedUpdate } from './update-extraction'
5
+ import { renameUpdateExclusive } from './update-exclusive-rename'
6
+ import { updateStagingFor } from './update-swap'
7
+ import type { InstallerPlatform, InstallerRenderer } from '../installer/installer-layout'
8
+ import type { ReleaseTrust, VerifiedRelease } from './signed-release'
9
+
10
+ /**
11
+ * Extract an approved, signature-verified update into `candidate` inside a new
12
+ * private staging directory beside the install. Does not stop, replace or
13
+ * relaunch the app.
14
+ */
15
+ export async function stageUpdateSwap(options: {
16
+ descriptor: VerifiedRelease
17
+ trust: ReleaseTrust
18
+ currentVersion: string
19
+ approved: boolean
20
+ approvedVersion: string
21
+ target: string
22
+ appName: string
23
+ platform: InstallerPlatform
24
+ renderer: InstallerRenderer
25
+ archive: string
26
+ maxCompressedBytes: number
27
+ maxExpandedBytes: number
28
+ /** Sidecar executables the app bundles; the update must contain each. */
29
+ sidecars?: readonly string[]
30
+ }): Promise<{ staging: string; candidate: string; version: string }> {
31
+ const plan = planUpdateHandoff(options)
32
+ const expectedHost = {
33
+ 'macos-arm64': 'darwin/arm64',
34
+ 'windows-x64': 'win32/x64',
35
+ 'linux-x64': 'linux/x64',
36
+ }[plan.platform]
37
+ if (`${process.platform}/${process.arch}` !== expectedHost)
38
+ throw new Error('Update requires the matching native platform')
39
+ const info = await lstat(plan.target)
40
+ if (!info.isDirectory() || info.isSymbolicLink() || (await realpath(plan.target)) !== plan.target)
41
+ throw new Error('Invalid update install target')
42
+ const versionFile = join(
43
+ plan.target,
44
+ ...(plan.platform === 'macos-arm64' ? ['Contents', 'Resources'] : ['Resources']),
45
+ 'version.json'
46
+ )
47
+ const versionInfo = await lstat(versionFile)
48
+ if (!versionInfo.isFile() || versionInfo.size > 1024 * 1024)
49
+ throw new Error('Installed update version mismatch')
50
+ if (JSON.parse(await readFile(versionFile, 'utf8')).version !== plan.currentVersion)
51
+ throw new Error('Installed update version mismatch')
52
+ const staging = updateStagingFor(plan.target)
53
+ const preparing = await mkdtemp(`${staging}.preparing-`)
54
+ const candidate = join(staging, 'candidate')
55
+ let published = false
56
+ try {
57
+ const extracted = await extractVerifiedUpdate({
58
+ descriptor: options.descriptor,
59
+ archive: options.archive,
60
+ directory: preparing,
61
+ platform: plan.platform,
62
+ renderer: plan.renderer,
63
+ appName: plan.appName,
64
+ maxCompressedBytes: options.maxCompressedBytes,
65
+ maxExpandedBytes: options.maxExpandedBytes,
66
+ ...(options.sidecars === undefined ? {} : { sidecars: options.sidecars }),
67
+ })
68
+ renameUpdateExclusive(extracted.payload, join(preparing, 'candidate'))
69
+ renameUpdateExclusive(preparing, staging)
70
+ published = true
71
+ return { staging, candidate, version: plan.version }
72
+ } finally {
73
+ if (!published) await rm(preparing, { recursive: true, force: true })
74
+ }
75
+ }
@@ -0,0 +1,30 @@
1
+ import { rm } from 'node:fs/promises'
2
+ import { basename, dirname, isAbsolute, join, resolve } from 'node:path'
3
+ import { renameUpdateExclusive } from './update-exclusive-rename'
4
+
5
+ /** The private staging directory the framework keeps beside an install. */
6
+ export function updateStagingFor(target: string): string {
7
+ if (typeof target !== 'string' || !isAbsolute(target) || resolve(target) !== target)
8
+ throw new Error('Invalid update target')
9
+ return join(dirname(target), `.${basename(target)}.framework-update`)
10
+ }
11
+
12
+ /**
13
+ * Move the staged `candidate` into the install location once the app has
14
+ * exited. The old tree is moved aside into staging and deleted.
15
+ */
16
+ export async function swapUpdateTree(options: { target: string; staging: string }): Promise<void> {
17
+ const { target, staging } = options
18
+ if (dirname(staging) !== dirname(target) || staging === target)
19
+ throw new Error('Invalid update swap context')
20
+ const old = join(staging, 'old')
21
+ renameUpdateExclusive(target, old)
22
+ try {
23
+ renameUpdateExclusive(join(staging, 'candidate'), target)
24
+ } catch (error) {
25
+ // Put the app back so it can still be launched.
26
+ renameUpdateExclusive(old, target)
27
+ throw error
28
+ }
29
+ await rm(old, { recursive: true, force: true })
30
+ }
@@ -0,0 +1,44 @@
1
+ import { AboutDialog } from '@adea-ai/ui/components/composites/about-dialog'
2
+ import type { Accessor } from 'solid-js'
3
+
4
+ export type ApplicationAboutProps = {
5
+ /** The application's identity; `platform` is the label About shows. */
6
+ identity: Readonly<{
7
+ name: string
8
+ icon: string
9
+ version?: string
10
+ platform: string
11
+ copyright: string
12
+ sourceUrl: string
13
+ }>
14
+ open: boolean
15
+ /** Called when the dialog asks to close. */
16
+ onClose?(): void
17
+ /** Called with every open-state change the dialog requests. */
18
+ onOpenChange?(open: boolean): void
19
+ copyVersionInfo?(text: string): Promise<void>
20
+ openExternal?(url: string): Promise<void>
21
+ restoreFocusRef?: Accessor<HTMLElement | undefined>
22
+ }
23
+
24
+ /** The shared About dialog, usable without `ApplicationUtilities`. Load it lazily. */
25
+ export function ApplicationAbout(props: ApplicationAboutProps) {
26
+ return (
27
+ <AboutDialog
28
+ appName={props.identity.name}
29
+ appIcon={props.identity.icon}
30
+ version={props.identity.version}
31
+ platform={props.identity.platform}
32
+ copyright={props.identity.copyright}
33
+ sourceUrl={props.identity.sourceUrl}
34
+ copyVersionInfo={props.copyVersionInfo}
35
+ openExternal={props.openExternal}
36
+ open={props.open}
37
+ onOpenChange={(open) => {
38
+ props.onOpenChange?.(open)
39
+ if (!open) props.onClose?.()
40
+ }}
41
+ restoreFocusRef={props.restoreFocusRef}
42
+ />
43
+ )
44
+ }
@@ -0,0 +1,32 @@
1
+ import { ModalDialog } from '@adea-ai/ui/components/ui/modal-dialog'
2
+ import { lazy, Show, Suspense, type Accessor, type JSX } from 'solid-js'
3
+
4
+ const AppearancePanel = lazy(() =>
5
+ import('@adea-ai/ui/components/theme').then((module) => ({ default: module.AppearancePanel }))
6
+ )
7
+
8
+ export type ApplicationAppearanceProps = {
9
+ open: boolean
10
+ onClose(): void
11
+ /** The app's appearance surface; defaults to the shared provider's panel. */
12
+ panel?: JSX.Element
13
+ title?: string
14
+ restoreFocusRef?: Accessor<HTMLElement | undefined>
15
+ }
16
+
17
+ /** The shared Appearance dialog, usable without `ApplicationUtilities`. Load it lazily. */
18
+ export function ApplicationAppearance(props: ApplicationAppearanceProps) {
19
+ return (
20
+ <ModalDialog
21
+ open={props.open}
22
+ onClose={props.onClose}
23
+ title={props.title ?? 'Appearance'}
24
+ size="settings"
25
+ restoreFocusRef={props.restoreFocusRef}
26
+ >
27
+ <Suspense fallback={<span role="status">Loading appearance…</span>}>
28
+ <Show when={props.open}>{props.panel ?? <AppearancePanel />}</Show>
29
+ </Suspense>
30
+ </ModalDialog>
31
+ )
32
+ }
@@ -0,0 +1,43 @@
1
+ import { HelpCenter } from '@adea-ai/ui/components/composites/help-center'
2
+ import { ModalDialog } from '@adea-ai/ui/components/ui/modal-dialog'
3
+ import type { Accessor } from 'solid-js'
4
+ import { standardShortcuts, type HelpLink, type HelpShortcut } from '../shell/help-shortcuts'
5
+
6
+ export * from '../shell/help-shortcuts'
7
+
8
+ export type ApplicationHelpProps = {
9
+ open: boolean
10
+ onClose(): void
11
+ appName: string
12
+ /** App-specific shortcuts, listed before the framework's own. */
13
+ shortcuts: readonly HelpShortcut[]
14
+ /** Appends the chords the framework binds; omit to list only the app's shortcuts. */
15
+ standard?: Parameters<typeof standardShortcuts>[0]
16
+ links: readonly HelpLink[]
17
+ openExternal?(url: string): Promise<void>
18
+ restoreFocusRef?: Accessor<HTMLElement | undefined>
19
+ }
20
+
21
+ /** The shared Help Center dialog: the app's real shortcuts and project resources. */
22
+ export function ApplicationHelp(props: ApplicationHelpProps) {
23
+ return (
24
+ <ModalDialog
25
+ open={props.open}
26
+ onClose={props.onClose}
27
+ title="Help Center"
28
+ description={`Keyboard shortcuts and resources for ${props.appName}.`}
29
+ restoreFocusRef={props.restoreFocusRef}
30
+ >
31
+ <HelpCenter
32
+ appName={props.appName}
33
+ shortcuts={[
34
+ ...props.shortcuts,
35
+ ...(props.standard ? standardShortcuts(props.standard) : []),
36
+ ]}
37
+ links={props.links}
38
+ showHeader={false}
39
+ openExternal={props.openExternal}
40
+ />
41
+ </ModalDialog>
42
+ )
43
+ }
@@ -0,0 +1,88 @@
1
+ import { SettingsLayout } from '@adea-ai/ui/components/composites/settings'
2
+ import { ModalDialog } from '@adea-ai/ui/components/ui/modal-dialog'
3
+ import { TabsContent } from '@adea-ai/ui/components/ui/tabs'
4
+ import { Text } from '@adea-ai/ui/components/ui/typography'
5
+ import { For, Show, untrack, type Accessor, type JSX } from 'solid-js'
6
+
7
+ import { settingsGroups, type ApplicationSettingsSection } from '../shell/settings-sections'
8
+
9
+ export * from '../shell/settings-sections'
10
+
11
+ export type ApplicationSettingsProps = {
12
+ open: boolean
13
+ onClose(): void
14
+ sections: readonly ApplicationSettingsSection[]
15
+ section: string
16
+ onSectionChange(id: string): void
17
+ title?: string
18
+ restoreFocusRef?: Accessor<HTMLElement | undefined>
19
+ }
20
+
21
+ export type ApplicationSettingsPanelProps = {
22
+ sections: readonly ApplicationSettingsSection[]
23
+ section: string
24
+ onSectionChange(id: string): void
25
+ /** Wraps the panels, such as in one form that saves every section together. */
26
+ wrap?(panels: JSX.Element): JSX.Element
27
+ }
28
+
29
+ /**
30
+ * Grouped settings navigation beside the selected app-owned panel, for an app that shows
31
+ * settings as a page. `ApplicationSettings` shows the same panel in a dialog.
32
+ */
33
+ export function ApplicationSettingsPanel(props: ApplicationSettingsPanelProps) {
34
+ const active = () =>
35
+ props.sections.find((section) => section.id === props.section) ?? props.sections[0]
36
+ // Panels are keyed by section id, not by section object, so a caller that rebuilds its
37
+ // section list (an inline config read again) keeps the open panel mounted with its state;
38
+ // only the description follows the list. Panels are built inside the layout, whose tabs
39
+ // context they read.
40
+ const panels = () => (
41
+ <For each={props.sections.map((section) => section.id)}>
42
+ {(id) => {
43
+ const section = () => props.sections.find((candidate) => candidate.id === id)
44
+ return (
45
+ <TabsContent value={id}>
46
+ <Show when={active()?.id === id}>
47
+ <div class="flex min-w-0 flex-col gap-4">
48
+ <Show when={section()?.description}>
49
+ {(description) => <Text tone="muted">{description()}</Text>}
50
+ </Show>
51
+ {untrack(() => section()?.render())}
52
+ </div>
53
+ </Show>
54
+ </TabsContent>
55
+ )
56
+ }}
57
+ </For>
58
+ )
59
+ return (
60
+ <SettingsLayout
61
+ aria-label="Settings sections"
62
+ groups={settingsGroups(props.sections)}
63
+ value={active()?.id ?? ''}
64
+ onChange={props.onSectionChange}
65
+ >
66
+ {props.wrap ? props.wrap(panels()) : panels()}
67
+ </SettingsLayout>
68
+ )
69
+ }
70
+
71
+ /** The shared settings dialog: grouped navigation beside the selected app-owned panel. */
72
+ export function ApplicationSettings(props: ApplicationSettingsProps) {
73
+ return (
74
+ <ModalDialog
75
+ open={props.open}
76
+ onClose={props.onClose}
77
+ title={props.title ?? 'Settings'}
78
+ size="settings"
79
+ restoreFocusRef={props.restoreFocusRef}
80
+ >
81
+ <ApplicationSettingsPanel
82
+ sections={props.sections}
83
+ section={props.section}
84
+ onSectionChange={props.onSectionChange}
85
+ />
86
+ </ModalDialog>
87
+ )
88
+ }