@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,424 @@
1
+ /*
2
+ * Custom theme import: turn an uploaded theme file into a runtime variant.
3
+ *
4
+ * The import is deliberately permissive. A file may carry the published
5
+ * canonical schema (17 surface roles plus an ANSI ramp) or any subset of it;
6
+ * missing roles are filled from the default theme of the same appearance, and
7
+ * text roles that cannot reach a readable contrast against their own
8
+ * background are repaired, with every adjustment reported back to the UI
9
+ * instead of silently altering the palette. Nothing here enforces provenance
10
+ * or distribution terms: an imported theme is the user's own copy for their
11
+ * own machine.
12
+ */
13
+ import {
14
+ colorToHex,
15
+ contrastRatio,
16
+ ensureContrast,
17
+ parseColor as parseHex,
18
+ } from '@adea-ai/ui/lib/accent-roles'
19
+ import {
20
+ defaultThemeRecord,
21
+ editorRolesHex,
22
+ oklchToHex,
23
+ parseOklchColor,
24
+ shadcnDestructiveProjection,
25
+ shadcnVariables,
26
+ syntaxRolesHex,
27
+ toXtermTheme,
28
+ } from '@adea-ai/ui/lib/theme-projection'
29
+ import type { AdeaTheme } from '@adea-ai/ui/lib/theme-records'
30
+ import {
31
+ flatVariantTokens,
32
+ setCustomThemes,
33
+ validateThemeRegistry,
34
+ type AppearanceStorage,
35
+ type CustomThemeStored,
36
+ type StoredThemeColors as ThemeColors,
37
+ type StoredThemeVariant as ThemeVariant,
38
+ } from './custom-theme-library'
39
+
40
+ const CANONICAL_COLOR_KEYS = [
41
+ 'background',
42
+ 'foreground',
43
+ 'surface',
44
+ 'surfaceElevated',
45
+ 'surfaceHover',
46
+ 'surfaceActive',
47
+ 'border',
48
+ 'borderMuted',
49
+ 'text',
50
+ 'textMuted',
51
+ 'textSubtle',
52
+ 'accent',
53
+ 'accentForeground',
54
+ 'success',
55
+ 'warning',
56
+ 'error',
57
+ 'info',
58
+ ] as const
59
+
60
+ const ANSI_KEYS = [
61
+ 'black',
62
+ 'red',
63
+ 'green',
64
+ 'yellow',
65
+ 'blue',
66
+ 'magenta',
67
+ 'cyan',
68
+ 'white',
69
+ 'brightBlack',
70
+ 'brightRed',
71
+ 'brightGreen',
72
+ 'brightYellow',
73
+ 'brightBlue',
74
+ 'brightMagenta',
75
+ 'brightCyan',
76
+ 'brightWhite',
77
+ ] as const
78
+
79
+ /** The published syntax-role mapping, used when a file needs roles derived. */
80
+ const SYNTAX_SOURCES = {
81
+ keyword: 'magenta',
82
+ string: 'green',
83
+ number: 'yellow',
84
+ comment: 'brightBlack',
85
+ function: 'blue',
86
+ variable: 'cyan',
87
+ type: 'cyan',
88
+ tag: 'red',
89
+ attribute: 'yellow',
90
+ operator: 'foreground',
91
+ heading: 'magenta',
92
+ link: 'blue',
93
+ diffAdd: 'green',
94
+ diffDelete: 'red',
95
+ diffHunk: 'brightBlack',
96
+ searchMatch: 'yellow',
97
+ } as const
98
+
99
+ export type CustomThemeImportResult =
100
+ | { ok: true; theme: CustomThemeStored }
101
+ | { ok: false; error: string }
102
+
103
+ function slug(value: string): string {
104
+ return (
105
+ value
106
+ .toLowerCase()
107
+ .replace(/[^a-z0-9]+/g, '-')
108
+ .replace(/^-+|-+$/g, '')
109
+ .slice(0, 32) || 'theme'
110
+ )
111
+ }
112
+
113
+ function normalizeHex(value: string): string {
114
+ const parsed = parseHex(value)
115
+ return parsed
116
+ ? `#${[parsed.r, parsed.g, parsed.b].map((byte) => byte.toString(16).padStart(2, '0')).join('')}`
117
+ : value
118
+ }
119
+
120
+ function isHex(value: unknown): value is string {
121
+ return typeof value === 'string' && parseHex(value) !== undefined
122
+ }
123
+
124
+ /** Repair one foreground/background pair to the readable floor, reporting it. */
125
+ function repairToFloor(
126
+ foreground: string,
127
+ background: string,
128
+ notes: string[],
129
+ role: string
130
+ ): string {
131
+ const front = parseHex(foreground)
132
+ const back = parseHex(background)
133
+ if (!front || !back) return foreground
134
+ if (contrastRatio(front, back) >= 4.5) return foreground
135
+ // The host repair loops contrast margins and falls back to a guaranteed
136
+ // foreground, so an import can never ship unreadable text.
137
+ const repaired = ensureContrast(front, back, 4.5)
138
+ notes.push(`“${role}” was adjusted for readable contrast.`)
139
+ return colorToHex(repaired)
140
+ }
141
+
142
+ function hexOf(value: string): string {
143
+ const parsed = parseOklchColor(value)
144
+ return parsed ? oklchToHex(parsed) : value
145
+ }
146
+
147
+ /**
148
+ * Project a validated canonical theme into the runtime variant shape, the same
149
+ * adapters the generated built-in registry uses.
150
+ */
151
+ function projectCanonical(theme: AdeaTheme): ThemeVariant {
152
+ const action = shadcnDestructiveProjection(theme)
153
+ const shadcn = {
154
+ ...shadcnVariables(theme),
155
+ '--destructive-action': action.fill,
156
+ '--destructive-action-foreground': action.foreground,
157
+ }
158
+ const SHADCN_TO_COLOR = {
159
+ background: 'background',
160
+ foreground: 'foreground',
161
+ card: 'card',
162
+ 'card-foreground': 'cardForeground',
163
+ popover: 'popover',
164
+ 'popover-foreground': 'popoverForeground',
165
+ primary: 'primary',
166
+ 'primary-foreground': 'primaryForeground',
167
+ secondary: 'secondary',
168
+ 'secondary-foreground': 'secondaryForeground',
169
+ muted: 'muted',
170
+ 'muted-foreground': 'mutedForeground',
171
+ accent: 'accent',
172
+ 'accent-foreground': 'accentForeground',
173
+ destructive: 'destructive',
174
+ 'destructive-action': 'destructiveAction',
175
+ 'destructive-action-foreground': 'destructiveActionForeground',
176
+ success: 'success',
177
+ border: 'border',
178
+ input: 'input',
179
+ ring: 'ring',
180
+ } as const
181
+ const colors = Object.fromEntries(
182
+ Object.entries(SHADCN_TO_COLOR).map(([name, property]) => [
183
+ property,
184
+ hexOf((shadcn as Record<string, string>)[`--${name}`]!),
185
+ ])
186
+ ) as unknown as ThemeColors
187
+ const terminalSource = toXtermTheme(theme)
188
+ const ansi = [
189
+ terminalSource.black,
190
+ terminalSource.red,
191
+ terminalSource.green,
192
+ terminalSource.yellow,
193
+ terminalSource.blue,
194
+ terminalSource.magenta,
195
+ terminalSource.cyan,
196
+ terminalSource.white,
197
+ terminalSource.brightBlack,
198
+ terminalSource.brightRed,
199
+ terminalSource.brightGreen,
200
+ terminalSource.brightYellow,
201
+ terminalSource.brightBlue,
202
+ terminalSource.brightMagenta,
203
+ terminalSource.brightCyan,
204
+ terminalSource.brightWhite,
205
+ ].map((value) => hexOf(value))
206
+ let editor: Record<string, string>
207
+ try {
208
+ editor = { ...editorRolesHex(theme) }
209
+ } catch {
210
+ // Some palettes cannot reach the 4.5:1 syntax floor from their own ramp;
211
+ // fall back to the raw roles repaired toward the floor.
212
+ const raw = syntaxRolesHex(theme)
213
+ editor = Object.fromEntries(
214
+ Object.entries(raw)
215
+ .filter(([role]) => role in SYNTAX_SOURCES)
216
+ .map(([role, value]) => [role, hexOf(value)])
217
+ )
218
+ }
219
+ const charts = {
220
+ chart1: ansi[4]!,
221
+ chart2: ansi[5]!,
222
+ chart3: ansi[6]!,
223
+ chart4: ansi[2]!,
224
+ chart5: ansi[3]!,
225
+ chart6: ansi[1]!,
226
+ }
227
+ return {
228
+ id: theme.id,
229
+ familyId: 'imported',
230
+ familyName: 'Imported',
231
+ name: theme.name,
232
+ appearance: theme.appearance,
233
+ colors,
234
+ terminal: {
235
+ background: hexOf(terminalSource.background),
236
+ foreground: hexOf(terminalSource.foreground),
237
+ cursor: hexOf(terminalSource.cursor),
238
+ selection: hexOf(terminalSource.selectionBackground),
239
+ ansi,
240
+ },
241
+ editor: editor as ThemeVariant['editor'],
242
+ charts,
243
+ }
244
+ }
245
+
246
+ /**
247
+ * Parse and store an uploaded theme. The only hard failure is unparseable
248
+ * JSON: everything else normalizes, fills from the same-appearance default,
249
+ * and reports what it had to adjust.
250
+ */
251
+ export function importCustomTheme(
252
+ text: string,
253
+ storage: AppearanceStorage | undefined,
254
+ existing: readonly CustomThemeStored[]
255
+ ): CustomThemeImportResult {
256
+ let source: unknown
257
+ try {
258
+ source = JSON.parse(text)
259
+ } catch {
260
+ return { ok: false, error: 'That file is not valid JSON.' }
261
+ }
262
+ const record = (
263
+ typeof source === 'object' && source !== null && 'theme' in (source as Record<string, unknown>)
264
+ ? (source as { theme: unknown }).theme
265
+ : source
266
+ ) as Record<string, unknown>
267
+ if (typeof record !== 'object' || record === null) {
268
+ return { ok: false, error: 'That file does not describe a theme.' }
269
+ }
270
+
271
+ const notes: string[] = []
272
+ const rawColors = (record.colors ?? {}) as Record<string, unknown>
273
+ const appearance: 'light' | 'dark' =
274
+ record.appearance === 'light' || record.appearance === 'dark'
275
+ ? record.appearance
276
+ : rawColors.background === undefined
277
+ ? 'dark'
278
+ : 'light'
279
+ const base = defaultThemeRecord(appearance)
280
+ const name =
281
+ typeof record.name === 'string' && record.name.trim().length > 0
282
+ ? record.name.trim().slice(0, 64)
283
+ : typeof record.label === 'string' && record.label.trim().length > 0
284
+ ? record.label.trim().slice(0, 64)
285
+ : 'Imported theme'
286
+
287
+ // Fill the canonical surface roles from whatever the file provides, then
288
+ // from the same-appearance default for anything missing.
289
+ const colors: Record<string, string> = {}
290
+ for (const key of CANONICAL_COLOR_KEYS) {
291
+ const value = rawColors[key]
292
+ if (isHex(value)) colors[key] = normalizeHex(value)
293
+ }
294
+ // Users name the main text role 'foreground'; the canonical schema calls it
295
+ // 'text'. Accept both before filling anything from the default theme.
296
+ if (colors.text === undefined && isHex(rawColors.foreground)) {
297
+ colors.text = normalizeHex(rawColors.foreground)
298
+ }
299
+ if (colors.textMuted === undefined && isHex(rawColors.mutedForeground)) {
300
+ colors.textMuted = normalizeHex(rawColors.mutedForeground)
301
+ }
302
+ const filled = CANONICAL_COLOR_KEYS.filter((key) => colors[key] === undefined)
303
+ if (filled.length > 0) {
304
+ for (const key of filled) colors[key] = base.colors[key as keyof typeof base.colors]
305
+ notes.push('Missing roles were filled from the default theme.')
306
+ }
307
+
308
+ // Text roles must stay readable against the background we actually ship.
309
+ colors.text = repairToFloor(colors.text!, colors.background!, notes, 'text')
310
+ colors.textMuted = repairToFloor(colors.textMuted!, colors.background!, notes, 'muted text')
311
+ colors.textSubtle = repairToFloor(colors.textSubtle!, colors.background!, notes, 'subtle text')
312
+
313
+ const ansiRecord = (record.ansi ?? {}) as Record<string, unknown>
314
+ const ansi = ANSI_KEYS.map((key) => {
315
+ const value = ansiRecord[key]
316
+ return isHex(value) ? normalizeHex(value) : base.ansi[key]
317
+ })
318
+ if (Object.keys(ansiRecord).length === 0)
319
+ notes.push('No ANSI ramp in the file; the default ramp was kept.')
320
+
321
+ const canonical: AdeaTheme = {
322
+ id: 'pending',
323
+ name,
324
+ appearance,
325
+ colors: colors as unknown as AdeaTheme['colors'],
326
+ ansi: Object.fromEntries(
327
+ ANSI_KEYS.map((key, index) => [key, ansi[index]!])
328
+ ) as unknown as AdeaTheme['ansi'],
329
+ cursor: isHex(record.cursor) ? normalizeHex(record.cursor) : base.cursor,
330
+ selection: isHex(record.selection) ? normalizeHex(record.selection) : base.selection,
331
+ }
332
+
333
+ let variant: ThemeVariant
334
+ try {
335
+ variant = projectCanonical(canonical)
336
+ } catch {
337
+ // The adapters refuse unencodable roles; fall back to a direct host
338
+ // projection so the import still succeeds with a warning.
339
+ variant = projectHostFallback(name, appearance, canonical.colors, ansi)
340
+ notes.push('Syntax roles were approximated from the ANSI ramp.')
341
+ }
342
+ variant = { ...variant, id: `custom-${slug(name)}-${Date.now().toString(36)}`, name }
343
+
344
+ const issues = validateThemeRegistry([variant]).filter((issue) => issue.severity === 'error')
345
+ for (const issue of issues) notes.push(`${issue.variantId}: ${issue.message}`)
346
+
347
+ const stored: CustomThemeStored = {
348
+ id: variant.id,
349
+ name: variant.name,
350
+ appearance,
351
+ importedAt: new Date().toISOString(),
352
+ variant,
353
+ flatTokens: flatVariantTokens(variant),
354
+ notes,
355
+ }
356
+ if (!setCustomThemes([...existing, stored], storage))
357
+ return { ok: false, error: 'The theme could not be saved. Check your storage and try again.' }
358
+ return { ok: true, theme: stored }
359
+ }
360
+
361
+ /** Direct host projection for inputs the canonical adapters reject. */
362
+ function projectHostFallback(
363
+ name: string,
364
+ appearance: 'light' | 'dark',
365
+ colors: AdeaTheme['colors'],
366
+ ansi: readonly string[]
367
+ ): ThemeVariant {
368
+ const ramp = (index: number): string => ansi[index] ?? colors.foreground
369
+ const editor = Object.fromEntries(
370
+ Object.entries(SYNTAX_SOURCES).map(([role, source]) => {
371
+ const value =
372
+ source === 'foreground'
373
+ ? colors.foreground
374
+ : ramp(ANSI_KEYS.indexOf(source as (typeof ANSI_KEYS)[number]))
375
+ return [role, repairToFloor(value, colors.background, [], role)]
376
+ })
377
+ )
378
+ return {
379
+ id: 'pending',
380
+ familyId: 'imported',
381
+ familyName: 'Imported',
382
+ name,
383
+ appearance,
384
+ colors: {
385
+ background: colors.background,
386
+ foreground: colors.foreground,
387
+ card: colors.surface,
388
+ cardForeground: colors.text,
389
+ popover: colors.surfaceElevated,
390
+ popoverForeground: colors.text,
391
+ primary: colors.accent,
392
+ primaryForeground: colors.accentForeground,
393
+ secondary: colors.surfaceHover,
394
+ secondaryForeground: colors.text,
395
+ muted: colors.surfaceHover,
396
+ mutedForeground: colors.textMuted,
397
+ accent: colors.surfaceActive,
398
+ accentForeground: colors.text,
399
+ destructive: colors.error,
400
+ destructiveAction: colors.error,
401
+ destructiveActionForeground: colors.accentForeground,
402
+ success: colors.success,
403
+ border: colors.border,
404
+ input: colors.border,
405
+ ring: colors.accent,
406
+ },
407
+ terminal: {
408
+ background: colors.background,
409
+ foreground: colors.foreground,
410
+ cursor: ramp(6),
411
+ selection: ramp(0),
412
+ ansi: [...ansi],
413
+ },
414
+ editor: editor as ThemeVariant['editor'],
415
+ charts: {
416
+ chart1: ramp(4),
417
+ chart2: ramp(5),
418
+ chart3: ramp(6),
419
+ chart4: ramp(2),
420
+ chart5: ramp(3),
421
+ chart6: ramp(1),
422
+ },
423
+ }
424
+ }