@adea-ai/app-framework 0.0.0-stage → 0.24.1

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 (358) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +30 -0
  3. package/README.md +1009 -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 +127 -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 +306 -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/navigation-drawer.d.ts +12 -0
  236. package/dist/shell/navigation-drawer.js +42 -0
  237. package/dist/shell/settings-sections.d.ts +31 -0
  238. package/dist/shell/settings-sections.js +50 -0
  239. package/dist/shell/shortcut-platform.d.ts +17 -0
  240. package/dist/shell/shortcut-platform.js +25 -0
  241. package/dist/update-helper.bundle.js +260 -0
  242. package/dist/updates/channel-update-manager.d.ts +46 -0
  243. package/dist/updates/channel-update-manager.js +114 -0
  244. package/dist/updates/desktop-updater.d.ts +104 -0
  245. package/dist/updates/desktop-updater.js +345 -0
  246. package/dist/updates/release-feed.d.ts +61 -0
  247. package/dist/updates/release-feed.js +111 -0
  248. package/dist/updates/release-location.d.ts +9 -0
  249. package/dist/updates/release-location.js +80 -0
  250. package/dist/updates/release-version.d.ts +12 -0
  251. package/dist/updates/release-version.js +43 -0
  252. package/dist/updates/signed-release.d.ts +63 -0
  253. package/dist/updates/signed-release.js +162 -0
  254. package/dist/updates/stable-file.d.ts +10 -0
  255. package/dist/updates/stable-file.js +22 -0
  256. package/dist/updates/update-adapter.d.ts +57 -0
  257. package/dist/updates/update-adapter.js +72 -0
  258. package/dist/updates/update-arm.d.ts +24 -0
  259. package/dist/updates/update-arm.js +95 -0
  260. package/dist/updates/update-channel-store.d.ts +8 -0
  261. package/dist/updates/update-channel-store.js +72 -0
  262. package/dist/updates/update-discovery.d.ts +13 -0
  263. package/dist/updates/update-discovery.js +56 -0
  264. package/dist/updates/update-download.d.ts +14 -0
  265. package/dist/updates/update-download.js +67 -0
  266. package/dist/updates/update-exclusive-rename.d.ts +2 -0
  267. package/dist/updates/update-exclusive-rename.js +52 -0
  268. package/dist/updates/update-extraction.d.ts +18 -0
  269. package/dist/updates/update-extraction.js +183 -0
  270. package/dist/updates/update-handoff-plan.d.ts +22 -0
  271. package/dist/updates/update-handoff-plan.js +28 -0
  272. package/dist/updates/update-helper.d.ts +24 -0
  273. package/dist/updates/update-helper.js +56 -0
  274. package/dist/updates/update-launch.d.ts +5 -0
  275. package/dist/updates/update-launch.js +27 -0
  276. package/dist/updates/update-manager.d.ts +40 -0
  277. package/dist/updates/update-manager.js +83 -0
  278. package/dist/updates/update-process-fence.d.ts +10 -0
  279. package/dist/updates/update-process-fence.js +114 -0
  280. package/dist/updates/update-resume.d.ts +13 -0
  281. package/dist/updates/update-resume.js +34 -0
  282. package/dist/updates/update-shutdown.d.ts +15 -0
  283. package/dist/updates/update-shutdown.js +29 -0
  284. package/dist/updates/update-state.d.ts +30 -0
  285. package/dist/updates/update-state.js +18 -0
  286. package/dist/updates/update-swap-stage.d.ts +27 -0
  287. package/dist/updates/update-swap-stage.js +58 -0
  288. package/dist/updates/update-swap.d.ts +10 -0
  289. package/dist/updates/update-swap.js +30 -0
  290. package/dist/views/app-about.d.ts +22 -0
  291. package/dist/views/app-about.js +43 -0
  292. package/dist/views/app-appearance.d.ts +11 -0
  293. package/dist/views/app-appearance.js +42 -0
  294. package/dist/views/app-help.d.ts +17 -0
  295. package/dist/views/app-help.js +42 -0
  296. package/dist/views/app-settings.d.ts +26 -0
  297. package/dist/views/app-settings.js +97 -0
  298. package/dist/views/appearance-surface.d.ts +9 -0
  299. package/dist/views/appearance-surface.js +334 -0
  300. package/dist/views/update-surface.d.ts +34 -0
  301. package/dist/views/update-surface.js +64 -0
  302. package/package.json +374 -4
  303. package/src/app/application.tsx +138 -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/desktop/client-assets.ts +75 -0
  315. package/src/native/electrobun-cef-main-frame-bridges.patch +63 -0
  316. package/src/native/electrobun-windows-shortcut-com.patch +923 -0
  317. package/src/native/renderer-profile.ts +27 -0
  318. package/src/native/window-options.ts +24 -0
  319. package/src/shell/app-shell.tsx +294 -0
  320. package/src/shell/app-utilities.tsx +437 -0
  321. package/src/shell/help-shortcuts.ts +24 -0
  322. package/src/shell/navigation-drawer.tsx +36 -0
  323. package/src/shell/settings-sections.ts +74 -0
  324. package/src/shell/shortcut-platform.ts +35 -0
  325. package/src/updates/release-version.ts +57 -0
  326. package/src/updates/update-adapter.ts +129 -0
  327. package/src/updates/update-state.ts +34 -0
  328. package/src/views/app-about.tsx +44 -0
  329. package/src/views/app-appearance.tsx +32 -0
  330. package/src/views/app-help.tsx +43 -0
  331. package/src/views/app-settings.tsx +88 -0
  332. package/src/views/appearance-surface.tsx +427 -0
  333. package/src/views/update-surface.tsx +85 -0
  334. package/templates/application/.gitattributes +1 -0
  335. package/templates/application/.github/workflows/release-assets.yml +29 -0
  336. package/templates/application/.github/workflows/release-finalize.yml +29 -0
  337. package/templates/application/.github/workflows/release-please.yml +19 -0
  338. package/templates/application/.github/workflows/release.yml +29 -0
  339. package/templates/application/.github/workflows/validation.yml +28 -0
  340. package/templates/application/.oxfmtrc.json +6 -0
  341. package/templates/application/.oxlintrc.json +48 -0
  342. package/templates/application/.release-please-manifest.json +3 -0
  343. package/templates/application/README.md +47 -0
  344. package/templates/application/electrobun.config.ts +22 -0
  345. package/templates/application/release-please-config.json +12 -0
  346. package/templates/application/scripts/app-version.ts +9 -0
  347. package/templates/application/scripts/build-desktop.ts +34 -0
  348. package/templates/application/scripts/secure-build.ts +1 -0
  349. package/templates/application/scripts/stage-release.ts +21 -0
  350. package/templates/application/src/bun/index.ts +80 -0
  351. package/templates/application/src/electrobun.d.ts +27 -0
  352. package/templates/application/src/web/index.html +12 -0
  353. package/templates/application/src/web/main.tsx +97 -0
  354. package/templates/application/src/web/public/icon.svg +1 -0
  355. package/templates/application/src/web/style.css +3 -0
  356. package/templates/application/tests/app-config.test.ts +9 -0
  357. package/templates/application/tsconfig.json +15 -0
  358. package/templates/application/vite.config.ts +10 -0
@@ -0,0 +1,205 @@
1
+ /*
2
+ * Copyright (c) 2026 Wing
3
+ * Licensed under the MIT License.
4
+ *
5
+ * Adea's host adapter over the shared ThemeProvider. The shared provider owns what
6
+ * a selection resolves to and paints (Zeron's appearance semantics, ported there);
7
+ * Adea owns the stored V2 document (`appearance-codec.ts`), the imported-theme
8
+ * library (`custom-theme-library.ts`), the native translucency capability, and the
9
+ * V2 view of the context that the appearance editor and the shell consume. See
10
+ * NOTICE for source and license provenance.
11
+ */
12
+ import {
13
+ createContext,
14
+ createEffect,
15
+ createSignal,
16
+ useContext,
17
+ type Context,
18
+ type JSX,
19
+ type ParentProps,
20
+ } from 'solid-js'
21
+
22
+ import {
23
+ ThemeProvider as UiThemeProvider,
24
+ useOptionalTheme as useOptionalUiTheme,
25
+ type ThemeContextValue as UiThemeContextValue,
26
+ type ThemeProviderProps as UiThemeProviderProps,
27
+ } from '@adea-ai/ui/components/theme/lazy'
28
+ import { defaultPreferenceStorage } from '@adea-ai/ui/lib/preference-store'
29
+ import { tokensAsHex } from '@adea-ai/ui/lib/themes'
30
+
31
+ import {
32
+ APPEARANCE_ACCENT_CONTRAST_FLOOR,
33
+ appearanceThemeScript,
34
+ createAppearancePersistence,
35
+ selectionFromPreferences,
36
+ type AppearancePreferencesV2,
37
+ } from './appearance-preferences'
38
+ import {
39
+ customUiVariants,
40
+ readCustomThemeLibrary,
41
+ subscribeCustomThemes,
42
+ } from './custom-theme-library'
43
+
44
+ export type {
45
+ AppearanceMode,
46
+ AppearancePreferencesV2,
47
+ ResolvedAppearance,
48
+ } from './appearance-preferences'
49
+
50
+ /**
51
+ * The shared theme context plus the V2 document seam the appearance editor works
52
+ * in. Everything the shell reads (the selection, the resolved appearance, the
53
+ * variant, `accentRolesFor`) is the shared context itself; only a V2-shaped write
54
+ * and a V2-shaped draft preview are Adea's.
55
+ */
56
+ export type AppearanceContextValue = Omit<UiThemeContextValue, 'preview'> & {
57
+ /** Persist a field update immediately (Zeron's `SavePolicy::Immediate`). */
58
+ update: (patch: Partial<AppearancePreferencesV2>) => void
59
+ /**
60
+ * Apply a draft against the visible app without persisting it. A committed change
61
+ * while a draft is open (a zoom chord, the mode toggle) leaves the draft showing.
62
+ */
63
+ preview: (preferences: AppearancePreferencesV2 | undefined) => void
64
+ }
65
+
66
+ /*
67
+ * The imported themes as a reactive source for the provider's `themes` prop. The
68
+ * library lives on the host object; this signal is how a change to it reaches the
69
+ * provider's registry.
70
+ */
71
+ const [libraryRevision, setLibraryRevision] = createSignal(0)
72
+ let subscribedToLibrary = false
73
+
74
+ function libraryThemes() {
75
+ if (!subscribedToLibrary) {
76
+ subscribedToLibrary = true
77
+ subscribeCustomThemes(() => setLibraryRevision((revision) => revision + 1))
78
+ }
79
+ libraryRevision()
80
+ return customUiVariants()
81
+ }
82
+
83
+ /**
84
+ * Everything the shared provider is told about Adea: where the preference lives, the
85
+ * imported themes, and the policies that make Adea's document what it has always
86
+ * been. A function so a test and the component build the same provider.
87
+ */
88
+ export function appearanceProviderProps(
89
+ options: { nativeTranslucency?: () => boolean } = {}
90
+ ): Omit<UiThemeProviderProps, 'children'> {
91
+ return {
92
+ persistence: createAppearancePersistence(),
93
+ themes: libraryThemes,
94
+ // The web lane has no OS vibrancy and renders tokenized frosted surfaces instead
95
+ // of pretending to it; a desktop host passes its capability.
96
+ surface: { nativeTranslucency: options.nativeTranslucency ?? false },
97
+ // The catalogue palette is `theme-variants.css`; the provider writes only the
98
+ // accent, the terminal pin, the surface alpha, the fonts and imported themes.
99
+ palette: 'stylesheet',
100
+ accentContrastFloor: APPEARANCE_ACCENT_CONTRAST_FLOOR,
101
+ editorRoles: 'floor',
102
+ transformTokens: tokensAsHex,
103
+ disableTransitionOnChange: true,
104
+ fontZoom: true,
105
+ }
106
+ }
107
+
108
+ /**
109
+ * The V2 view of a shared theme context. Reads derive from the provider's selection;
110
+ * writes go through its `setSelection`, so the shared provider remains the only
111
+ * writer of the document and of storage.
112
+ */
113
+ export function createAppearanceContext(ui: UiThemeContextValue): AppearanceContextValue {
114
+ let draft: AppearancePreferencesV2 | undefined
115
+
116
+ const preview = (next: AppearancePreferencesV2 | undefined) => {
117
+ draft = next
118
+ ui.preview(next ? selectionFromPreferences(next) : undefined)
119
+ }
120
+
121
+ // The shared provider ends a preview when the selection is committed. The editor's
122
+ // draft is still open, though, so it keeps showing until the editor ends it.
123
+ createEffect(() => {
124
+ ui.selection()
125
+ if (draft !== undefined && !ui.previewing()) ui.preview(selectionFromPreferences(draft))
126
+ })
127
+
128
+ return {
129
+ ...ui,
130
+ update: (patch) => ui.setSelection(selectionFromPreferences(patch)),
131
+ preview,
132
+ }
133
+ }
134
+
135
+ /*
136
+ * The context lives on the global under a registered symbol, like the shared one:
137
+ * a bundle that loads this module twice would otherwise give a provider from one
138
+ * copy and a reader from the other two different context objects.
139
+ */
140
+ const CONTEXT_KEY = Symbol.for('adea.app.theme')
141
+ type ContextHost = { [CONTEXT_KEY]?: Context<AppearanceContextValue | undefined> }
142
+
143
+ function appearanceContext(): Context<AppearanceContextValue | undefined> {
144
+ const host = globalThis as ContextHost
145
+ return (host[CONTEXT_KEY] ??= createContext<AppearanceContextValue>())
146
+ }
147
+
148
+ function AppearanceBridge(props: ParentProps) {
149
+ const ui = useOptionalUiTheme()
150
+ if (!ui) throw new Error('The appearance bridge must render inside the shared ThemeProvider.')
151
+ const Context = appearanceContext()
152
+ return <Context.Provider value={createAppearanceContext(ui)}>{props.children}</Context.Provider>
153
+ }
154
+
155
+ type ThemeProviderProps = ParentProps<{
156
+ /**
157
+ * Whether the host window can render OS translucency. The web lane keeps
158
+ * the default `false` and renders tokenized frosted surfaces instead of
159
+ * pretending to OS vibrancy.
160
+ */
161
+ nativeTranslucency?: boolean
162
+ }>
163
+
164
+ /**
165
+ * Adea's appearance provider: the shared ThemeProvider configured for Adea's V2
166
+ * document, with the V2 context on top. It owns the versioned appearance preference
167
+ * (mode, independent light/dark themes, accent, surface) and applies it to the
168
+ * document.
169
+ */
170
+ export function ThemeProvider(props: ThemeProviderProps) {
171
+ // Imported themes must be in the registry before the first resolution, or a
172
+ // stored custom selection falls back to the default on mount.
173
+ readCustomThemeLibrary(defaultPreferenceStorage())
174
+ return (
175
+ <UiThemeProvider
176
+ {...appearanceProviderProps({ nativeTranslucency: () => props.nativeTranslucency ?? false })}
177
+ >
178
+ <AppearanceBridge>{props.children}</AppearanceBridge>
179
+ </UiThemeProvider>
180
+ )
181
+ }
182
+
183
+ /**
184
+ * The appearance editor's view of the context: the shared context with the V2
185
+ * `update` and `preview` seam. Shell code that only reads the theme (the selection,
186
+ * the variant, `accentRolesFor`) uses the shared `useOptionalTheme` of
187
+ * `@adea-ai/ui/components/theme` instead.
188
+ */
189
+ export function useTheme(): AppearanceContextValue {
190
+ const context = useContext(appearanceContext())
191
+ if (!context) {
192
+ throw new Error('useTheme must be used within a ThemeProvider.')
193
+ }
194
+ return context
195
+ }
196
+
197
+ /**
198
+ * Pre-paint appearance restore for server-rendered documents. Rendered in the
199
+ * document head, it resolves the stored preference against the OS
200
+ * and applies the document state before first paint so hydration never shows the
201
+ * wrong theme.
202
+ */
203
+ export function ThemeScript(): JSX.Element {
204
+ return <script innerHTML={appearanceThemeScript()} />
205
+ }
@@ -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
+ }