@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,287 @@
1
+ /*
2
+ * Copyright (c) 2026 Wing
3
+ * Licensed under the MIT License.
4
+ *
5
+ * The V2 appearance document keeps the preference schema, field-wise
6
+ * normalization of Adea's accepted port of Zeron's
7
+ * appearance preferences (https://github.com/zeronsh/zeron). See NOTICE for
8
+ * source and license provenance.
9
+ */
10
+ import { getAccent } from '@adea-ai/ui/lib/accent-presets'
11
+
12
+ import {
13
+ createVersionedPersistence,
14
+ themeScript,
15
+ type ThemePersistence,
16
+ type ThemeSelection,
17
+ type ThemeStorageSchema,
18
+ type VersionedCodec,
19
+ } from '@adea-ai/ui/components/theme/lazy'
20
+ import { colorToHex, parseColor } from '@adea-ai/ui/lib/accent-roles'
21
+ import {
22
+ DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS,
23
+ normalizeAppearanceEditorFontSettings,
24
+ type AppearanceEditorFontSettings,
25
+ } from '@adea-ai/ui/lib/appearance-font-settings'
26
+ import { normalizeSurface as normalizeThemeSurface } from '@adea-ai/ui/lib/theme-surface'
27
+ import { isThemeAccentId } from '@adea-ai/ui/lib/themes'
28
+
29
+ /**
30
+ * The versioned client appearance preference (Dev Runtime spec,
31
+ * "Appearance and App Library"). Stored as one JSON document.
32
+ *
33
+ * The document is Adea's product schema. The shared ThemeProvider owns what a
34
+ * selection resolves to and paints; this module owns what is stored, under which
35
+ * keys, and how an unreadable or older record is corrected. The stored bytes are
36
+ * the same as they were before the provider was shared.
37
+ */
38
+ export type AppearancePreferencesV2 = Readonly<{
39
+ version: 2
40
+ mode: AppearanceMode
41
+ lightThemeId: string
42
+ darkThemeId: string
43
+ /**
44
+ * The terminal's palette: `'theme'` follows the resolved interface theme, a
45
+ * theme id pins that theme's terminal colours regardless of appearance.
46
+ */
47
+ terminalThemeId: 'theme' | string
48
+ /** A built-in preset id, a theme-carried `ansi-<slot>` id, or a validated `#rrggbb` color. `'theme'` normalizes to the default preset. */
49
+ accent: 'theme' | string
50
+ surface: SurfacePreference
51
+ reduceTransparency: boolean
52
+ /** Missing in older V2 documents; the shared font defaults recover each text role. */
53
+ fonts?: AppearanceEditorFontSettings
54
+ }>
55
+
56
+ export type AppearanceMode = 'system' | 'light' | 'dark'
57
+ export type ResolvedAppearance = 'light' | 'dark'
58
+ export type SurfacePreference = 'opaque' | 'frosted' | 'translucent'
59
+
60
+ export const APPEARANCE_STORAGE_KEY = 'appearance'
61
+ /**
62
+ * Recovery envelope for unread preference documents (Dev Runtime spec,
63
+ * "Compatibility, migrations, and waivers": a failed migration retains the
64
+ * original record; it never silently rewrites or deletes the input). A
65
+ * malformed or future-version document is quarantined here, before any write can
66
+ * touch the main key, so saving valid preferences later can never destroy the
67
+ * user's unread data.
68
+ */
69
+ export const APPEARANCE_RECOVERY_STORAGE_KEY = 'appearance.recovery'
70
+ /** The imported-theme library the boot script reads for a stored custom selection. */
71
+ export const APPEARANCE_LIBRARY_STORAGE_KEY = 'appearance.library'
72
+
73
+ /**
74
+ * The default accent is the catalogue's Violet brand preset, one of the six
75
+ * accents, not a separate "theme default" entry beside them. `'theme'` and any
76
+ * unknown value normalize to it.
77
+ */
78
+ export const DEFAULT_ACCENT_PRESET_ID = 'violet'
79
+
80
+ /**
81
+ * The contrast an accent is held to against any theme, the imported ones included.
82
+ * The catalogue's presets already clear it on the catalogue's own themes, so the
83
+ * floor changes no preset there; it exists for custom colours and imported themes.
84
+ */
85
+ export const APPEARANCE_ACCENT_CONTRAST_FLOOR = 3
86
+
87
+ export const defaultAppearancePreferences: AppearancePreferencesV2 = Object.freeze({
88
+ version: 2,
89
+ mode: 'system',
90
+ lightThemeId: 'adea-light',
91
+ darkThemeId: 'adea-dark',
92
+ terminalThemeId: 'theme',
93
+ accent: DEFAULT_ACCENT_PRESET_ID,
94
+ surface: 'opaque',
95
+ reduceTransparency: false,
96
+ })
97
+
98
+ /*
99
+ * Preference storage: normalization.
100
+ */
101
+
102
+ function normalizeMode(value: unknown): AppearanceMode {
103
+ return value === 'light' || value === 'dark' || value === 'system' ? value : 'system'
104
+ }
105
+
106
+ function normalizeSurface(value: unknown): SurfacePreference {
107
+ return normalizeThemeSurface(value) ?? 'opaque'
108
+ }
109
+
110
+ function normalizeThemeId(value: unknown, fallback: string): string {
111
+ return typeof value === 'string' && value.trim().length > 0 ? value : fallback
112
+ }
113
+
114
+ function normalizeAccent(value: unknown): string {
115
+ // The provider's `'theme'` ("the variant's primary") is not a V2 choice.
116
+ if (value === 'theme' || typeof value !== 'string') return DEFAULT_ACCENT_PRESET_ID
117
+ if (getAccent(value) || isThemeAccentId(value)) return value
118
+ // A custom colour has one stored spelling, `#rrggbb`: the shared provider reads
119
+ // nothing else. Short forms expand and an alpha channel is dropped.
120
+ const parsed = parseColor(value)
121
+ return parsed ? colorToHex({ ...parsed, a: 255 }) : DEFAULT_ACCENT_PRESET_ID
122
+ }
123
+
124
+ export type NormalizedPreferences = Readonly<{
125
+ /** The strict v2 document, with every unknown field corrected to defaults. */
126
+ value: AppearancePreferencesV2
127
+ /**
128
+ * The raw stored document when it was not a valid v2 record. Retained so a
129
+ * future version (or a repaired write) never loses the user's data.
130
+ */
131
+ retainedRaw?: unknown
132
+ }>
133
+
134
+ /**
135
+ * Parse a stored appearance document. Anything that is not a strict version-2
136
+ * record falls back to the defaults and keeps the raw value for retention;
137
+ * individual unknown values inside a v2 record are corrected field by field.
138
+ */
139
+ export function normalizeAppearancePreferences(raw: unknown): NormalizedPreferences {
140
+ if (typeof raw !== 'object' || raw === null || (raw as { version?: unknown }).version !== 2) {
141
+ return { value: defaultAppearancePreferences, retainedRaw: raw }
142
+ }
143
+ const record = raw as Record<string, unknown>
144
+ return {
145
+ value: {
146
+ version: 2,
147
+ mode: normalizeMode(record.mode),
148
+ lightThemeId: normalizeThemeId(
149
+ record.lightThemeId,
150
+ defaultAppearancePreferences.lightThemeId
151
+ ),
152
+ darkThemeId: normalizeThemeId(record.darkThemeId, defaultAppearancePreferences.darkThemeId),
153
+ terminalThemeId: normalizeThemeId(record.terminalThemeId, 'theme'),
154
+ accent: normalizeAccent(record.accent),
155
+ surface: normalizeSurface(record.surface),
156
+ reduceTransparency: record.reduceTransparency === true,
157
+ ...(record.fonts === undefined
158
+ ? {}
159
+ : { fonts: normalizeAppearanceEditorFontSettings(record.fonts).settings }),
160
+ },
161
+ }
162
+ }
163
+
164
+ /*
165
+ * The shared provider's selection and the V2 document are two views of one
166
+ * preference. These two functions are the whole mapping between them.
167
+ */
168
+
169
+ /**
170
+ * A V2 preference, or a patch of one, as a selection patch. Only the fields present
171
+ * are returned: a patch key left `undefined` would overwrite the selection's value.
172
+ */
173
+ export function selectionFromPreferences(
174
+ preferences: Partial<AppearancePreferencesV2>
175
+ ): Partial<ThemeSelection> {
176
+ return {
177
+ ...(preferences.mode === undefined ? {} : { appearance: preferences.mode }),
178
+ ...(preferences.lightThemeId === undefined ? {} : { lightThemeId: preferences.lightThemeId }),
179
+ ...(preferences.darkThemeId === undefined ? {} : { darkThemeId: preferences.darkThemeId }),
180
+ ...(preferences.terminalThemeId === undefined
181
+ ? {}
182
+ : { terminalThemeId: preferences.terminalThemeId }),
183
+ // `'theme'` is the default preset everywhere a draft, a
184
+ // stored record or a direct update can reach: the provider's own `theme` means
185
+ // "the variant's primary", which no V2 preference can select.
186
+ ...(preferences.accent === undefined
187
+ ? {}
188
+ : {
189
+ accent: preferences.accent === 'theme' ? DEFAULT_ACCENT_PRESET_ID : preferences.accent,
190
+ }),
191
+ ...(preferences.surface === undefined ? {} : { surface: preferences.surface }),
192
+ ...(preferences.reduceTransparency === undefined
193
+ ? {}
194
+ : { reduceTransparency: preferences.reduceTransparency }),
195
+ ...(preferences.fonts === undefined ? {} : { fonts: preferences.fonts }),
196
+ }
197
+ }
198
+
199
+ /** The V2 view of the provider's committed selection. */
200
+ export function preferencesFromSelection(selection: ThemeSelection): AppearancePreferencesV2 {
201
+ return {
202
+ version: 2,
203
+ mode: selection.appearance,
204
+ lightThemeId: selection.lightThemeId,
205
+ darkThemeId: selection.darkThemeId,
206
+ terminalThemeId: selection.terminalThemeId ?? 'theme',
207
+ accent: selection.accent === 'theme' ? DEFAULT_ACCENT_PRESET_ID : selection.accent,
208
+ surface: selection.surface ?? 'opaque',
209
+ reduceTransparency: selection.reduceTransparency === true,
210
+ ...(selection.fonts === undefined ? {} : { fonts: selection.fonts }),
211
+ }
212
+ }
213
+
214
+ function sameFonts(left: AppearanceEditorFontSettings, right: AppearanceEditorFontSettings) {
215
+ return (['ui', 'content', 'code'] as const).every(
216
+ (axis) => left[axis].family === right[axis].family && left[axis].size === right[axis].size
217
+ )
218
+ }
219
+
220
+ /*
221
+ * The storage schema and codec.
222
+ */
223
+
224
+ /**
225
+ * Where the V2 document lives. One object feeds the persistence and the boot
226
+ * script, so the two cannot disagree about a key, a version or a field name.
227
+ */
228
+ export const appearanceSchema = {
229
+ key: APPEARANCE_STORAGE_KEY,
230
+ version: 2,
231
+ appearanceField: 'mode',
232
+ libraryKey: APPEARANCE_LIBRARY_STORAGE_KEY,
233
+ recoveryKey: APPEARANCE_RECOVERY_STORAGE_KEY,
234
+ } satisfies ThemeStorageSchema
235
+
236
+ /** What a store with nothing readable answers: Adea's fresh-install preference. */
237
+ function installDefaults(): Partial<ThemeSelection> {
238
+ return selectionFromPreferences(defaultAppearancePreferences)
239
+ }
240
+
241
+ /**
242
+ * The document written for a selection: exactly the V2 fields, in the order they
243
+ * have always been written. `fonts` is written when the record last read or written
244
+ * carried it, or when the text settings differ from the defaults, so a document
245
+ * whose text was never touched keeps the bytes it had.
246
+ */
247
+ export function appearanceDocument(
248
+ next: ThemeSelection,
249
+ previous?: Readonly<Record<string, unknown>>
250
+ ): AppearancePreferencesV2 {
251
+ const fonts = normalizeAppearanceEditorFontSettings(next.fonts, next.font).settings
252
+ const keepFonts =
253
+ previous?.fonts !== undefined || !sameFonts(fonts, DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS)
254
+ return {
255
+ ...preferencesFromSelection({ ...next, fonts: undefined }),
256
+ ...(keepFonts ? { fonts } : {}),
257
+ }
258
+ }
259
+
260
+ export const adeaV2Codec: VersionedCodec<AppearancePreferencesV2> = {
261
+ // The engine has already checked the shape and `version`, so every field here is
262
+ // corrected one by one: an unknown value inside a readable record is repaired, not
263
+ // fatal. A theme id the catalogue lacks is kept verbatim; the provider resolves it.
264
+ decode: (record) => selectionFromPreferences(normalizeAppearancePreferences(record).value),
265
+ defaults: installDefaults,
266
+ encode: appearanceDocument,
267
+ }
268
+
269
+ /** The provider's persistence over the V2 document. */
270
+ export function createAppearancePersistence(): ThemePersistence {
271
+ return createVersionedPersistence(appearanceSchema, adeaV2Codec)
272
+ }
273
+
274
+ /**
275
+ * The boot script rendered in the document head: the shared `themeScript` over this
276
+ * schema, so first paint and the mounted provider read one document. The default
277
+ * accent matches the codec's fresh-install accent, so a fresh page paints the
278
+ * accent the provider will keep.
279
+ */
280
+ export function appearanceThemeScript(): string {
281
+ return themeScript({
282
+ ...appearanceSchema,
283
+ defaultAccent: DEFAULT_ACCENT_PRESET_ID,
284
+ surface: true,
285
+ palette: 'stylesheet',
286
+ })
287
+ }
@@ -0,0 +1,29 @@
1
+ /*
2
+ * Copyright (c) 2026 Wing
3
+ * Licensed under the MIT License.
4
+ *
5
+ * Appearance preview composition retained for the Adea host adapter. The
6
+ * published AppearanceEditor owns mode, accent, surface, and row presentation;
7
+ * this module only resolves the live light/dark preview variants from Adea's
8
+ * accepted preference IDs.
9
+ * See NOTICE for source and license provenance.
10
+ */
11
+ import { resolveVariant, type ThemeVariant } from '@adea-ai/ui/lib/themes'
12
+ import { themeRegistry } from './theme-registry'
13
+ import type { AppearancePreferencesV2 } from './appearance-preferences'
14
+
15
+ /**
16
+ * The variants behind the mode miniatures: resolved per appearance from the
17
+ * draft so the System split, Light, and Dark cards track unsaved theme picks
18
+ * the same instant the real chrome does.
19
+ */
20
+ export function draftVariants(preferences: AppearancePreferencesV2): {
21
+ light: ThemeVariant
22
+ dark: ThemeVariant
23
+ } {
24
+ const registry = themeRegistry()
25
+ return {
26
+ light: resolveVariant(registry, preferences.lightThemeId, 'light'),
27
+ dark: resolveVariant(registry, preferences.darkThemeId, 'dark'),
28
+ }
29
+ }