@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,378 @@
1
+ import { quarantineRecord } from "@adea-ai/ui/lib/preference-store";
2
+ import { contrastRatio } from "@adea-ai/ui/lib/accent-roles";
3
+ import { defaultVariantFor } from "@adea-ai/ui/lib/theme-defaults";
4
+ import { variantFromRecord } from "@adea-ai/ui/lib/theme-records";
5
+ // src/appearance/custom-theme-library.ts
6
+ var CUSTOM_THEME_LIBRARY_STORAGE_KEY = "appearance.library";
7
+ /**
8
+ * Where an unreadable library is quarantined. It is its own key: the library and
9
+ * the appearance preference used to share `appearance.recovery`, so one could
10
+ * overwrite the other's capture.
11
+ */
12
+ var CUSTOM_THEME_LIBRARY_RECOVERY_KEY = "appearance.library.recovery";
13
+ var CUSTOM_THEME_LIBRARY_VERSION = 1;
14
+ var CUSTOM_THEME_ID_PREFIX = "custom-";
15
+ function validateThemeRegistry(registry) {
16
+ const issues = [];
17
+ const seen = /* @__PURE__ */ new Set();
18
+ for (const variant of registry) {
19
+ if (variant.id.trim().length === 0 || seen.has(variant.id)) issues.push({
20
+ variantId: variant.id,
21
+ severity: "error",
22
+ message: "variant id must be unique"
23
+ });
24
+ seen.add(variant.id);
25
+ const check = (role, foreground, background, minimum) => {
26
+ const actual = contrastRatio(foreground, background);
27
+ if (actual < minimum) issues.push({
28
+ variantId: variant.id,
29
+ severity: "error",
30
+ message: `${role} contrast is ${actual.toFixed(2)}:1; expected ${minimum.toFixed(1)}:1`
31
+ });
32
+ };
33
+ check("text", variant.colors.foreground, variant.colors.background, 4.5);
34
+ check("muted text", variant.colors.mutedForeground, variant.colors.background, 4.5);
35
+ check("primary", variant.colors.primary, variant.colors.background, 3);
36
+ check("on-primary", variant.colors.primaryForeground, variant.colors.primary, 4.5);
37
+ check("terminal foreground", variant.terminal.foreground, variant.terminal.background, 4.5);
38
+ for (const [index, color] of variant.terminal.ansi.entries()) {
39
+ if (index % 8 === 0) continue;
40
+ if (contrastRatio(color, variant.terminal.background) < 3) issues.push({
41
+ variantId: variant.id,
42
+ severity: "warning",
43
+ message: `terminal ANSI slot ${index} is below 3:1`
44
+ });
45
+ }
46
+ check("editor comment", variant.editor.comment, variant.colors.background, 4.5);
47
+ check("diff delete", variant.editor.diffDelete, variant.colors.background, 3);
48
+ check("diff add", variant.editor.diffAdd, variant.colors.background, 3);
49
+ }
50
+ return issues;
51
+ }
52
+ var ANSI_NAMES = [
53
+ "black",
54
+ "red",
55
+ "green",
56
+ "yellow",
57
+ "blue",
58
+ "magenta",
59
+ "cyan",
60
+ "white"
61
+ ];
62
+ function kebabCase(value) {
63
+ return value.replaceAll(/[A-Z]/g, (character) => `-${character.toLocaleLowerCase()}`);
64
+ }
65
+ function terminalTokens(palette) {
66
+ const tokens = {
67
+ "--terminal-background": palette.background,
68
+ "--terminal-foreground": palette.foreground,
69
+ "--terminal-cursor": palette.cursor,
70
+ "--terminal-selection": palette.selection
71
+ };
72
+ for (const [index, color] of palette.ansi.entries()) {
73
+ const name = ANSI_NAMES[index % 8];
74
+ tokens[index < 8 ? `--terminal-ansi-${name}` : `--terminal-ansi-bright-${name}`] = color;
75
+ }
76
+ return tokens;
77
+ }
78
+ /** The custom properties an imported variant owns, as a flat map. */
79
+ function flatVariantTokens(variant) {
80
+ const tokens = {};
81
+ for (const [role, value] of Object.entries(variant.colors)) tokens[`--${kebabCase(role)}`] = value;
82
+ Object.assign(tokens, terminalTokens(variant.terminal));
83
+ for (const [role, value] of Object.entries(variant.editor)) tokens[`--editor-${kebabCase(role)}`] = value;
84
+ for (const [index, value] of Object.values(variant.charts).entries()) tokens[`--chart-${index + 1}`] = value;
85
+ return tokens;
86
+ }
87
+ var IMPORTED_PROVENANCE = {
88
+ project: "Adea themes catalogue",
89
+ url: "https://github.com/adea-ai/themes",
90
+ license: "Apache-2.0"
91
+ };
92
+ function ansiRamp(variant) {
93
+ const [black, red, green, yellow, blue, magenta, cyan, white, brightBlack, brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan, brightWhite] = variant.terminal.ansi;
94
+ return {
95
+ black,
96
+ red,
97
+ green,
98
+ yellow,
99
+ blue,
100
+ magenta,
101
+ cyan,
102
+ white,
103
+ brightBlack,
104
+ brightRed,
105
+ brightGreen,
106
+ brightYellow,
107
+ brightBlue,
108
+ brightMagenta,
109
+ brightCyan,
110
+ brightWhite
111
+ };
112
+ }
113
+ /**
114
+ * The catalogue-shaped record for an imported variant. The editor reads only its
115
+ * surface, text, border and accent roles; warning and info are the ANSI yellow and
116
+ * blue because the stored variant has no such roles.
117
+ */
118
+ function storedVariantRecord(variant) {
119
+ const colors = variant.colors;
120
+ const ansi = ansiRamp(variant);
121
+ return {
122
+ id: variant.id,
123
+ name: variant.name,
124
+ appearance: variant.appearance,
125
+ colors: {
126
+ background: colors.background,
127
+ foreground: colors.foreground,
128
+ surface: colors.card,
129
+ surfaceElevated: colors.popover,
130
+ surfaceHover: colors.accent,
131
+ surfaceActive: colors.border,
132
+ border: colors.border,
133
+ borderMuted: colors.border,
134
+ text: colors.foreground,
135
+ textMuted: colors.mutedForeground,
136
+ textSubtle: colors.mutedForeground,
137
+ accent: colors.primary,
138
+ accentForeground: colors.primaryForeground,
139
+ success: colors.success,
140
+ warning: ansi.yellow,
141
+ error: colors.destructive,
142
+ info: ansi.blue
143
+ },
144
+ ansi,
145
+ cursor: variant.terminal.cursor,
146
+ selection: variant.terminal.selection,
147
+ family: variant.familyId,
148
+ familyLabel: variant.familyName,
149
+ label: variant.name,
150
+ description: `${variant.name}, imported into your library.`,
151
+ provenance: IMPORTED_PROVENANCE,
152
+ tags: ["imported", variant.appearance]
153
+ };
154
+ }
155
+ /**
156
+ * The shared-provider variant for a stored theme: derived roles from the
157
+ * reconstructed record, then `flatTokens` verbatim.
158
+ *
159
+ * A record the shared projection cannot map falls back to the default theme of the
160
+ * same appearance under the stored identity, so an import that the projection
161
+ * rejects still paints from its tokens instead of vanishing.
162
+ */
163
+ function toUiVariant(stored) {
164
+ const { variant } = stored;
165
+ let base;
166
+ try {
167
+ base = variantFromRecord(storedVariantRecord(variant));
168
+ } catch {
169
+ base = {
170
+ ...defaultVariantFor(variant.appearance),
171
+ id: variant.id,
172
+ family: variant.familyId,
173
+ familyLabel: variant.familyName,
174
+ label: variant.name,
175
+ description: `${variant.name}, imported into your library.`,
176
+ provenance: {
177
+ source: IMPORTED_PROVENANCE.project,
178
+ url: IMPORTED_PROVENANCE.url,
179
+ license: IMPORTED_PROVENANCE.license
180
+ }
181
+ };
182
+ }
183
+ return {
184
+ ...base,
185
+ tokens: stored.flatTokens
186
+ };
187
+ }
188
+ var libraryHost = globalThis;
189
+ function library() {
190
+ const existing = libraryHost.__ADEA_THEME_LIBRARY__;
191
+ if (existing && Array.isArray(existing.themes) && existing.listeners) return existing;
192
+ const created = {
193
+ themes: [],
194
+ listeners: existing?.listeners ?? /* @__PURE__ */ new Set()
195
+ };
196
+ libraryHost.__ADEA_THEME_LIBRARY__ = created;
197
+ return created;
198
+ }
199
+ function replaceThemes(themes) {
200
+ const state = library();
201
+ state.themes = Object.freeze([...themes]);
202
+ state.uiVariants = void 0;
203
+ }
204
+ /** The imported themes' stored variants, in import order. */
205
+ function customThemeVariants() {
206
+ return library().themes.map((theme) => theme.variant);
207
+ }
208
+ /** The imported themes as shared-provider variants: what the provider's `themes` takes. */
209
+ function customUiVariants() {
210
+ const state = library();
211
+ state.uiVariants ??= Object.freeze(state.themes.map(toUiVariant));
212
+ return state.uiVariants;
213
+ }
214
+ function subscribeCustomThemes(listener) {
215
+ const { listeners } = library();
216
+ listeners.add(listener);
217
+ return () => listeners.delete(listener);
218
+ }
219
+ function notifyCustomThemes() {
220
+ for (const listener of library().listeners) listener();
221
+ }
222
+ function isCustomThemeId(id) {
223
+ return id.startsWith(CUSTOM_THEME_ID_PREFIX);
224
+ }
225
+ /**
226
+ * Replace the imported-theme set, persist it, and tell subscribers. A theme whose id
227
+ * is not custom-namespaced is namespaced here, so a library file can never shadow a
228
+ * catalogue id.
229
+ */
230
+ function setCustomThemes(themes, storage) {
231
+ const safe = themes.map((theme) => {
232
+ if (isCustomThemeId(theme.id)) return theme;
233
+ const id = `${CUSTOM_THEME_ID_PREFIX}${theme.id}`;
234
+ return {
235
+ ...theme,
236
+ id,
237
+ variant: {
238
+ ...theme.variant,
239
+ id
240
+ }
241
+ };
242
+ });
243
+ try {
244
+ if (storage) {
245
+ const raw = storage.getItem(CUSTOM_THEME_LIBRARY_STORAGE_KEY);
246
+ if (raw) {
247
+ const result = parseLibrary(raw);
248
+ if (result.reason && !preserveLibrary(storage, raw, result.reason)) throw new Error("Library recovery unavailable");
249
+ }
250
+ }
251
+ storage?.setItem(CUSTOM_THEME_LIBRARY_STORAGE_KEY, JSON.stringify({
252
+ version: CUSTOM_THEME_LIBRARY_VERSION,
253
+ themes: safe
254
+ }));
255
+ } catch {
256
+ return false;
257
+ }
258
+ replaceThemes(safe);
259
+ notifyCustomThemes();
260
+ return true;
261
+ }
262
+ var object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
263
+ var fields = (value, names) => object(value) && names.every((name) => typeof value[name] === "string");
264
+ function isStoredTheme(entry) {
265
+ if (!object(entry) || !object(entry.variant)) return false;
266
+ const theme = entry;
267
+ const variant = entry.variant;
268
+ return typeof theme.id === "string" && typeof theme.name === "string" && (theme.appearance === "light" || theme.appearance === "dark") && typeof theme.importedAt === "string" && fields(variant, [
269
+ "id",
270
+ "familyId",
271
+ "familyName",
272
+ "name"
273
+ ]) && (variant.appearance === "light" || variant.appearance === "dark") && fields(variant.colors, [
274
+ "background",
275
+ "foreground",
276
+ "card",
277
+ "cardForeground",
278
+ "popover",
279
+ "popoverForeground",
280
+ "primary",
281
+ "primaryForeground",
282
+ "secondary",
283
+ "secondaryForeground",
284
+ "muted",
285
+ "mutedForeground",
286
+ "accent",
287
+ "accentForeground",
288
+ "destructive",
289
+ "destructiveAction",
290
+ "destructiveActionForeground",
291
+ "success",
292
+ "border",
293
+ "input",
294
+ "ring"
295
+ ]) && fields(variant.terminal, [
296
+ "background",
297
+ "foreground",
298
+ "cursor",
299
+ "selection"
300
+ ]) && object(variant.terminal) && Array.isArray(variant.terminal.ansi) && variant.terminal.ansi.length === 16 && variant.terminal.ansi.every((color) => typeof color === "string") && fields(variant.editor, [
301
+ "keyword",
302
+ "string",
303
+ "number",
304
+ "comment",
305
+ "function",
306
+ "variable",
307
+ "type",
308
+ "tag",
309
+ "attribute",
310
+ "operator",
311
+ "heading",
312
+ "link",
313
+ "diffAdd",
314
+ "diffDelete",
315
+ "diffHunk",
316
+ "searchMatch"
317
+ ]) && fields(variant.charts, [
318
+ "chart1",
319
+ "chart2",
320
+ "chart3",
321
+ "chart4",
322
+ "chart5",
323
+ "chart6"
324
+ ]) && object(theme.flatTokens) && Object.values(theme.flatTokens).every((value) => typeof value === "string") && Array.isArray(theme.notes) && theme.notes.every((note) => typeof note === "string");
325
+ }
326
+ function parseLibrary(raw) {
327
+ let value;
328
+ try {
329
+ value = JSON.parse(raw);
330
+ } catch {
331
+ return {
332
+ themes: [],
333
+ reason: "corrupt_json"
334
+ };
335
+ }
336
+ if (!object(value) || value.version !== CUSTOM_THEME_LIBRARY_VERSION || !Array.isArray(value.themes)) return {
337
+ themes: [],
338
+ reason: "unsupported_record"
339
+ };
340
+ const themes = value.themes.filter(isStoredTheme);
341
+ return themes.length === value.themes.length ? { themes } : {
342
+ themes,
343
+ reason: "unsupported_record"
344
+ };
345
+ }
346
+ function preserveLibrary(storage, raw, reason) {
347
+ if (!storage.getItem("appearance.library.recovery")) quarantineRecord(storage, CUSTOM_THEME_LIBRARY_RECOVERY_KEY, raw, reason);
348
+ const saved = storage.getItem(CUSTOM_THEME_LIBRARY_RECOVERY_KEY);
349
+ try {
350
+ const capture = saved && JSON.parse(saved);
351
+ return object(capture) && capture.schemaVersion === 1 && capture.raw === raw;
352
+ } catch {
353
+ return false;
354
+ }
355
+ }
356
+ /**
357
+ * Read the stored library. A malformed document starts an empty library and
358
+ * quarantines the raw bytes into the library's own recovery key, mirroring the
359
+ * appearance-preference recovery contract; individual invalid records are dropped,
360
+ * not fatal.
361
+ */
362
+ function readCustomThemeLibrary(storage) {
363
+ if (!storage) return [];
364
+ try {
365
+ const raw = storage.getItem(CUSTOM_THEME_LIBRARY_STORAGE_KEY);
366
+ if (!raw) return [];
367
+ const { themes, reason } = parseLibrary(raw);
368
+ if (reason) preserveLibrary(storage, raw, reason);
369
+ replaceThemes(themes);
370
+ return themes;
371
+ } catch {
372
+ return [];
373
+ }
374
+ }
375
+ function removeCustomTheme(id, storage) {
376
+ return setCustomThemes(readCustomThemeLibrary(storage).filter((theme) => theme.id !== id), storage);
377
+ }
378
+ export { CUSTOM_THEME_LIBRARY_RECOVERY_KEY, CUSTOM_THEME_LIBRARY_STORAGE_KEY, customThemeVariants, customUiVariants, flatVariantTokens, readCustomThemeLibrary, removeCustomTheme, setCustomThemes, storedVariantRecord, subscribeCustomThemes, toUiVariant, validateThemeRegistry };
@@ -0,0 +1,20 @@
1
+ import { type AppearancePreferencesV2 } from './appearance-preferences';
2
+ export type AppearanceEditor = Readonly<{
3
+ /** The edited draft, reactive so dialog UI tracks every change. */
4
+ draft: () => AppearancePreferencesV2;
5
+ /** True when the draft differs from the snapshot the editor opened with. */
6
+ dirty: () => boolean;
7
+ /** True when the draft differs from the shipped defaults. */
8
+ differsFromDefaults: () => boolean;
9
+ /** Begin editing: snapshot the committed preferences. */
10
+ open: (committed: AppearancePreferencesV2) => void;
11
+ /** Set one or more draft fields; unchanged values no-op like Zeron's setters. */
12
+ set: (patch: Partial<AppearancePreferencesV2>) => void;
13
+ /** Draft becomes the shipped defaults (still reversible until Save). */
14
+ reset: () => void;
15
+ /** Discard the draft; the committed snapshot is authoritative again. */
16
+ revert: () => AppearancePreferencesV2;
17
+ /** Commit the draft and clear the snapshot. */
18
+ save: () => AppearancePreferencesV2;
19
+ }>;
20
+ export declare function createAppearanceEditor(committed?: AppearancePreferencesV2): AppearanceEditor;
@@ -0,0 +1,47 @@
1
+ import { defaultAppearancePreferences, normalizeAppearancePreferences } from "./appearance-preferences.js";
2
+ import { createSignal } from "solid-js";
3
+ import { normalizeAppearanceEditorFontSettings } from "@adea-ai/ui/lib/appearance-font-settings";
4
+ // src/appearance/editor.ts
5
+ function samePreferences(left, right) {
6
+ const leftFonts = normalizeAppearanceEditorFontSettings(left.fonts).settings;
7
+ const rightFonts = normalizeAppearanceEditorFontSettings(right.fonts).settings;
8
+ return [
9
+ "ui",
10
+ "content",
11
+ "code"
12
+ ].every((axis) => leftFonts[axis].family === rightFonts[axis].family && leftFonts[axis].size === rightFonts[axis].size) && left.mode === right.mode && left.lightThemeId === right.lightThemeId && left.darkThemeId === right.darkThemeId && left.terminalThemeId === right.terminalThemeId && left.accent === right.accent && left.surface === right.surface && left.reduceTransparency === right.reduceTransparency;
13
+ }
14
+ function createAppearanceEditor(committed = defaultAppearancePreferences) {
15
+ const [draft, setDraft] = createSignal(committed);
16
+ const [snapshot, setSnapshot] = createSignal(committed);
17
+ return {
18
+ draft,
19
+ dirty: () => !samePreferences(draft(), snapshot()),
20
+ differsFromDefaults: () => !samePreferences(draft(), defaultAppearancePreferences),
21
+ open: (value) => {
22
+ const normalized = normalizeAppearancePreferences(value).value;
23
+ setSnapshot(normalized);
24
+ setDraft(normalized);
25
+ },
26
+ set: (patch) => {
27
+ const next = {
28
+ ...draft(),
29
+ ...patch
30
+ };
31
+ if (samePreferences(next, draft())) return;
32
+ setDraft(next);
33
+ },
34
+ reset: () => {
35
+ setDraft(defaultAppearancePreferences);
36
+ },
37
+ revert: () => {
38
+ setDraft(snapshot());
39
+ return snapshot();
40
+ },
41
+ save: () => {
42
+ setSnapshot(draft());
43
+ return draft();
44
+ }
45
+ };
46
+ }
47
+ export { createAppearanceEditor };
@@ -0,0 +1,23 @@
1
+ import type { CustomThemeStored } from './custom-theme-library';
2
+ import type { CustomThemeImportResult } from './custom-theme-import';
3
+ export type ThemeFileImporterHost = Readonly<{
4
+ /**
5
+ * Loads the importer and returns the function that imports one file's text.
6
+ * It runs after every await so the library it merges into is read fresh.
7
+ */
8
+ load: () => Promise<(text: string) => CustomThemeImportResult>;
9
+ onPending: (pending: boolean) => void;
10
+ onStatus: (message: string) => void;
11
+ onImported: (theme: CustomThemeStored) => void;
12
+ }>;
13
+ type ThemeFileImporter = Readonly<{
14
+ importFile: (file: Pick<File, 'text'>) => Promise<void>;
15
+ /** Drops the run in flight, if any, and clears its pending status. */
16
+ cancel: () => void;
17
+ }>;
18
+ export declare const THEME_IMPORT_PENDING = "Importing theme\u2026";
19
+ export declare const THEME_IMPORT_UNREADABLE = "That file could not be read.";
20
+ export declare const THEME_IMPORT_UNAVAILABLE = "The theme importer could not be loaded. Reload the app and try again.";
21
+ export declare const THEME_IMPORT_FAILED = "That theme could not be imported.";
22
+ export declare function createThemeFileImporter(host: ThemeFileImporterHost): ThemeFileImporter;
23
+ export {};
@@ -0,0 +1,66 @@
1
+ // src/appearance/theme-file-importer.ts
2
+ var THEME_IMPORT_PENDING = "Importing theme…";
3
+ var THEME_IMPORT_UNREADABLE = "That file could not be read.";
4
+ var THEME_IMPORT_UNAVAILABLE = "The theme importer could not be loaded. Reload the app and try again.";
5
+ var THEME_IMPORT_FAILED = "That theme could not be imported.";
6
+ function createThemeFileImporter(host) {
7
+ let latest = 0;
8
+ let pending = false;
9
+ const settle = () => {
10
+ if (!pending) return;
11
+ pending = false;
12
+ host.onPending(false);
13
+ };
14
+ return {
15
+ cancel() {
16
+ latest += 1;
17
+ if (!pending) return;
18
+ settle();
19
+ host.onStatus("");
20
+ },
21
+ async importFile(file) {
22
+ latest += 1;
23
+ const run = latest;
24
+ const current = () => run === latest;
25
+ pending = true;
26
+ host.onPending(true);
27
+ host.onStatus(THEME_IMPORT_PENDING);
28
+ let text;
29
+ try {
30
+ text = await file.text();
31
+ } catch {
32
+ if (!current()) return;
33
+ settle();
34
+ host.onStatus(THEME_IMPORT_UNREADABLE);
35
+ return;
36
+ }
37
+ if (!current()) return;
38
+ let importText;
39
+ try {
40
+ importText = await host.load();
41
+ } catch {
42
+ if (!current()) return;
43
+ settle();
44
+ host.onStatus(THEME_IMPORT_UNAVAILABLE);
45
+ return;
46
+ }
47
+ if (!current()) return;
48
+ let result;
49
+ try {
50
+ result = importText(text);
51
+ } catch {
52
+ settle();
53
+ host.onStatus(THEME_IMPORT_FAILED);
54
+ return;
55
+ }
56
+ settle();
57
+ if (!result.ok) {
58
+ host.onStatus(result.error);
59
+ return;
60
+ }
61
+ host.onStatus(`Imported “${result.theme.name}”.` + (result.theme.notes.length > 0 ? ` ${result.theme.notes.join(" ")}` : ""));
62
+ host.onImported(result.theme);
63
+ }
64
+ };
65
+ }
66
+ export { THEME_IMPORT_FAILED, THEME_IMPORT_PENDING, THEME_IMPORT_UNAVAILABLE, THEME_IMPORT_UNREADABLE, createThemeFileImporter };
@@ -0,0 +1,26 @@
1
+ import type { AdeaTheme, AdeaThemeRecord } from '@adea-ai/ui/lib/theme-records';
2
+ import { type ThemeVariant } from '@adea-ai/ui/lib/themes';
3
+ /** The published blue preset is the host's default custom accent. */
4
+ export declare const DEFAULT_CUSTOM_ACCENT: string;
5
+ /** Imported themes, re-projected on every registry change. */
6
+ export declare function customThemeRecords(): readonly AdeaThemeRecord[];
7
+ /** The built-in catalogue led by the published pair; import lives separately. */
8
+ export declare const appearanceThemeRecords: readonly AdeaThemeRecord[];
9
+ /** Every selectable record: built-ins first, then imported themes. */
10
+ export declare function allThemeRecords(): readonly AdeaThemeRecord[];
11
+ /**
12
+ * Resolve a selected local ID to the external editor's raw preview contract.
13
+ * `pair` is the draft's light/dark theme ids, which a theme-derived (`ansi-*`)
14
+ * accent is read from.
15
+ */
16
+ export declare function appearanceThemeForPreview(variant: ThemeVariant, accent: string, pair?: {
17
+ lightThemeId: string;
18
+ darkThemeId: string;
19
+ }): AdeaTheme;
20
+ type AccentDraftValidation = Readonly<{
21
+ value?: string;
22
+ error?: string;
23
+ }>;
24
+ /** Preserve the host's invalid-input behavior while feeding the pure editor. */
25
+ export declare function normalizeCustomAccent(value: string, background: string): AccentDraftValidation;
26
+ export {};
@@ -0,0 +1,64 @@
1
+ import "./appearance-preferences.js";
2
+ import { customThemeVariants, storedVariantRecord } from "./custom-theme-library.js";
3
+ import { themeRegistry } from "./theme-registry.js";
4
+ import { accentRolesForSelection, themeRecordById, themeRecords } from "@adea-ai/ui/lib/themes";
5
+ import { getAccent } from "@adea-ai/ui/lib/accent-presets";
6
+ import { colorToHex, normalizeAccentValue, parseColor } from "@adea-ai/ui/lib/accent-roles";
7
+ import { defaultThemeRecord } from "@adea-ai/ui/lib/theme-projection";
8
+ // src/appearance/theme-record-adapter.ts
9
+ var adeaLight = defaultThemeRecord("light");
10
+ var adeaDark = defaultThemeRecord("dark");
11
+ /** The published blue preset is the host's default custom accent. */
12
+ var DEFAULT_CUSTOM_ACCENT = getAccent("blue")?.light ?? adeaLight.colors.accent;
13
+ /** Imported themes, re-projected on every registry change. */
14
+ function customThemeRecords() {
15
+ return customThemeVariants().map(storedVariantRecord);
16
+ }
17
+ /** The built-in catalogue led by the published pair; import lives separately. */
18
+ var appearanceThemeRecords = Object.freeze([
19
+ adeaLight,
20
+ adeaDark,
21
+ ...themeRecords.filter((record) => record.id !== adeaLight.id && record.id !== adeaDark.id)
22
+ ]);
23
+ /** Every selectable record: built-ins first, then imported themes. */
24
+ function allThemeRecords() {
25
+ return [...appearanceThemeRecords, ...customThemeRecords()];
26
+ }
27
+ function withAccent(theme, accent, pair) {
28
+ if (accent === "theme") return theme;
29
+ const variant = themeRegistry().find((candidate) => candidate.id === theme.id);
30
+ if (!variant) return theme;
31
+ const roles = accentRolesForSelection(accent, theme.appearance, pair, {
32
+ background: variant.colors.background,
33
+ floor: 3,
34
+ variantId: variant.id
35
+ });
36
+ if (!roles) return theme;
37
+ return {
38
+ ...theme,
39
+ colors: {
40
+ ...theme.colors,
41
+ accent: roles.primary,
42
+ accentForeground: roles.primaryForeground
43
+ }
44
+ };
45
+ }
46
+ /**
47
+ * Resolve a selected local ID to the external editor's raw preview contract.
48
+ * `pair` is the draft's light/dark theme ids, which a theme-derived (`ansi-*`)
49
+ * accent is read from.
50
+ */
51
+ function appearanceThemeForPreview(variant, accent, pair) {
52
+ return withAccent(themeRecordById(variant.id) ?? customThemeRecords().find((candidate) => candidate.id === variant.id) ?? (variant.appearance === "dark" ? adeaDark : adeaLight), accent, pair);
53
+ }
54
+ /** Preserve the host's invalid-input behavior while feeding the pure editor. */
55
+ function normalizeCustomAccent(value, background) {
56
+ const normalized = normalizeAccentValue(value, background);
57
+ if (normalized === void 0) return { error: `“${value}” is not a hex color such as ${DEFAULT_CUSTOM_ACCENT}.` };
58
+ const parsed = parseColor(normalized);
59
+ return { value: parsed ? colorToHex({
60
+ ...parsed,
61
+ a: 255
62
+ }) : normalized };
63
+ }
64
+ export { DEFAULT_CUSTOM_ACCENT, allThemeRecords, appearanceThemeForPreview, appearanceThemeRecords, customThemeRecords, normalizeCustomAccent };
@@ -0,0 +1,10 @@
1
+ import { type ThemeVariant } from '@adea-ai/ui/lib/themes';
2
+ /**
3
+ * Every selectable theme: the catalogue first, then imported themes.
4
+ *
5
+ * This is the one place the app reads the whole catalogue (`builtinThemes`), and it
6
+ * is a module of its own on purpose: the appearance editor imports it from its lazy
7
+ * chunk. Left in `custom-theme-library.ts`, which the shell's provider imports at
8
+ * start-up, it would keep the 34-theme catalogue in the start-up closure (ADR 0014).
9
+ */
10
+ export declare function themeRegistry(): readonly ThemeVariant[];
@@ -0,0 +1,16 @@
1
+ import { customUiVariants } from "./custom-theme-library.js";
2
+ import { builtinThemes } from "@adea-ai/ui/lib/themes";
3
+ // src/appearance/theme-registry.ts
4
+ /**
5
+ * Every selectable theme: the catalogue first, then imported themes.
6
+ *
7
+ * This is the one place the app reads the whole catalogue (`builtinThemes`), and it
8
+ * is a module of its own on purpose: the appearance editor imports it from its lazy
9
+ * chunk. Left in `custom-theme-library.ts`, which the shell's provider imports at
10
+ * start-up, it would keep the 34-theme catalogue in the start-up closure (ADR 0014).
11
+ */
12
+ function themeRegistry() {
13
+ const custom = customUiVariants();
14
+ return custom.length > 0 ? [...builtinThemes, ...custom] : builtinThemes;
15
+ }
16
+ export { themeRegistry };
@@ -0,0 +1,5 @@
1
+ export type WindowSurface = 'theme' | 'frosted' | 'opaque';
2
+ type WindowSurfaceMirror = (surface: WindowSurface) => void;
3
+ export declare function registerWindowSurfaceMirror(next: WindowSurfaceMirror): void;
4
+ export declare function mirrorWindowSurface(surface: WindowSurface): void;
5
+ export {};
@@ -0,0 +1,9 @@
1
+ // src/appearance/window-surface.ts
2
+ var mirror;
3
+ function registerWindowSurfaceMirror(next) {
4
+ mirror = next;
5
+ }
6
+ function mirrorWindowSurface(surface) {
7
+ mirror?.(surface);
8
+ }
9
+ export { mirrorWindowSurface, registerWindowSurfaceMirror };