@firstpick/pi-package-webui 0.11.0 → 0.11.2

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 (318) hide show
  1. package/DEVELOPMENT.md +181 -12
  2. package/README.md +41 -9
  3. package/TECHNICAL.md +91 -8
  4. package/bin/pi-webui.mjs +5432 -11428
  5. package/index.ts +10 -3
  6. package/lib/codex-cli-usage.mjs +232 -0
  7. package/lib/codex-usage-auth.mjs +39 -3
  8. package/lib/codex-usage-source.mjs +36 -0
  9. package/lib/component-update-state.mjs +2 -2
  10. package/lib/git-workflow-preference-values.mjs +122 -0
  11. package/lib/git-workflow-preferences.mjs +35 -563
  12. package/lib/package-updates.mjs +260 -0
  13. package/lib/rpc-supervisor-client.mjs +8 -4
  14. package/lib/server/app-runners.mjs +1667 -0
  15. package/lib/server/codex-fast-mode.mjs +161 -0
  16. package/lib/server/conversation-mode.mjs +218 -0
  17. package/lib/server/conversation-voice.mjs +318 -0
  18. package/lib/server/extension-ui-requests.mjs +114 -0
  19. package/lib/server/git-generation.mjs +459 -0
  20. package/lib/server/git-mutations.mjs +1827 -0
  21. package/lib/server/git-reads.mjs +608 -0
  22. package/lib/server/git-worktree-sessions.mjs +408 -0
  23. package/lib/server/helper-requests.mjs +82 -0
  24. package/lib/server/no-project-workspaces.mjs +103 -0
  25. package/lib/server/rpc-transports.mjs +394 -0
  26. package/lib/server/settings-store.mjs +544 -0
  27. package/lib/server/sse-delivery.mjs +138 -0
  28. package/lib/server/workspace-files.mjs +563 -0
  29. package/lib/update/supervisor.mjs +4 -0
  30. package/lib/webui-workspaces.mjs +2 -0
  31. package/package.json +5 -5
  32. package/public/activity-agents-controller.mjs +269 -0
  33. package/public/activity-events-controller.mjs +236 -0
  34. package/public/activity-intercom-controller.mjs +627 -0
  35. package/public/activity-queue-controller.mjs +534 -0
  36. package/public/activity-todo-view.mjs +89 -0
  37. package/public/activity-usage-controller.mjs +589 -0
  38. package/public/app.js +3761 -3878
  39. package/public/conversation-overview.css +84 -0
  40. package/public/conversation-overview.mjs +193 -0
  41. package/public/draft-conversations.mjs +135 -0
  42. package/public/focused-composer-controls.css +111 -0
  43. package/public/focused-composer-controls.mjs +143 -0
  44. package/public/focused-composer-disclosure.mjs +223 -0
  45. package/public/focused-shell-adapter.css +264 -0
  46. package/public/focused-shell-adapter.mjs +257 -0
  47. package/public/index.html +137 -80
  48. package/public/model-catalog-order.mjs +63 -0
  49. package/public/platform-event-stream.mjs +64 -0
  50. package/public/project-artifact-controller.mjs +218 -0
  51. package/public/project-file-viewer-controller.mjs +383 -0
  52. package/public/project-git-tools-controller.mjs +181 -0
  53. package/public/project-runners-controller.mjs +220 -0
  54. package/public/service-worker.js +52 -1
  55. package/public/session-attention-scheduler.mjs +182 -0
  56. package/public/session-composer-store.mjs +56 -0
  57. package/public/session-context.mjs +51 -0
  58. package/public/session-extension-requests.mjs +63 -0
  59. package/public/session-shelf-state.mjs +151 -0
  60. package/public/session-shelves.css +171 -0
  61. package/public/session-shelves.mjs +95 -0
  62. package/public/settings-navigation-controller.mjs +249 -0
  63. package/public/settings-navigation.css +61 -0
  64. package/public/settings-resource-controller.mjs +232 -0
  65. package/public/settings-workspace.css +19 -0
  66. package/public/settings-workspace.mjs +175 -0
  67. package/public/shell-actions.mjs +87 -0
  68. package/public/shell-attention-inbox.css +72 -0
  69. package/public/shell-attention-inbox.mjs +198 -0
  70. package/public/shell-context-actions.css +61 -0
  71. package/public/shell-context-actions.mjs +168 -0
  72. package/public/shell-inspector-resize.mjs +124 -0
  73. package/public/shell-navigation-resize.mjs +107 -0
  74. package/public/shell-navigation.mjs +127 -0
  75. package/public/shell-preferences.mjs +108 -0
  76. package/public/shell-surfaces.mjs +99 -0
  77. package/public/shell-tools-launcher.css +97 -0
  78. package/public/shell-tools-launcher.mjs +222 -0
  79. package/public/shell-view-host.mjs +115 -0
  80. package/public/shell-workspace.css +266 -0
  81. package/public/shell-workspace.mjs +402 -0
  82. package/public/sidebar-update-menu.css +190 -0
  83. package/public/sidebar-update-menu.mjs +512 -0
  84. package/public/styles.css +320 -169
  85. package/public/subagent-launch-slot-state.mjs +2 -2
  86. package/public/theme-contract.mjs +1 -1
  87. package/public/themed-selects.css +156 -0
  88. package/public/workspace-choices.mjs +104 -0
  89. package/tests/activity-agents-controller.test.mjs +652 -0
  90. package/tests/activity-events-controller.test.mjs +511 -0
  91. package/tests/app-runner-terminal-static.test.mjs +3 -3
  92. package/tests/append-system-http.test.mjs +7 -6
  93. package/tests/append-system-selector-static.test.mjs +6 -6
  94. package/tests/aur-review-widget-static.test.mjs +11 -3
  95. package/tests/boot-failure-diagnostics.test.mjs +8 -3
  96. package/tests/browser/activity-intercom-controller.spec.mjs +457 -0
  97. package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
  98. package/tests/browser/activity-owner-integration.spec.mjs +201 -0
  99. package/tests/browser/activity-queue-controller.spec.mjs +405 -0
  100. package/tests/browser/activity-section-picker.spec.mjs +294 -0
  101. package/tests/browser/activity-todo-view.spec.mjs +60 -0
  102. package/tests/browser/activity-usage-controller.spec.mjs +416 -0
  103. package/tests/browser/compact-layout-integration.spec.mjs +58 -0
  104. package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
  105. package/tests/browser/composer-disclosure.spec.mjs +389 -0
  106. package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
  107. package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
  108. package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
  109. package/tests/browser/control-visibility.spec.mjs +5 -0
  110. package/tests/browser/controls-layout.spec.mjs +21 -2
  111. package/tests/browser/conversation-overview.spec.mjs +251 -0
  112. package/tests/browser/draft-conversations.spec.mjs +276 -0
  113. package/tests/browser/empty-startup-fixture.mjs +135 -0
  114. package/tests/browser/empty-startup.spec.mjs +282 -0
  115. package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
  116. package/tests/browser/focused-composer-more.spec.mjs +127 -0
  117. package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
  118. package/tests/browser/focused-navigation-fixture.mjs +32 -0
  119. package/tests/browser/focused-project-activity.spec.mjs +111 -0
  120. package/tests/browser/focused-shell-integration.spec.mjs +208 -0
  121. package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
  122. package/tests/browser/folder-picker-layout.spec.mjs +302 -0
  123. package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
  124. package/tests/browser/git-setup-cancel.spec.mjs +251 -0
  125. package/tests/browser/guided-git-fallback.spec.mjs +40 -21
  126. package/tests/browser/inspector-header.spec.mjs +221 -0
  127. package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
  128. package/tests/browser/inspector-resize.spec.mjs +227 -0
  129. package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
  130. package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
  131. package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
  132. package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
  133. package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
  134. package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
  135. package/tests/browser/interaction-continuity.spec.mjs +50 -26
  136. package/tests/browser/interaction-model-picker.spec.mjs +86 -0
  137. package/tests/browser/last-terminal-close.spec.mjs +280 -0
  138. package/tests/browser/mobile-foundation.spec.mjs +172 -20
  139. package/tests/browser/model-catalog-groups.spec.mjs +104 -0
  140. package/tests/browser/more-row-menus.spec.mjs +258 -0
  141. package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
  142. package/tests/browser/no-project-conversation.spec.mjs +113 -0
  143. package/tests/browser/optimistic-prompt.spec.mjs +3 -0
  144. package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
  145. package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
  146. package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
  147. package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
  148. package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
  149. package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
  150. package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
  151. package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
  152. package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
  153. package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
  154. package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
  155. package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
  156. package/tests/browser/project-artifact-controller.spec.mjs +324 -0
  157. package/tests/browser/project-artifact-integration.spec.mjs +103 -0
  158. package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
  159. package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
  160. package/tests/browser/session-fixture.mjs +118 -0
  161. package/tests/browser/session-ownership.spec.mjs +175 -0
  162. package/tests/browser/session-shelves-integration.spec.mjs +219 -0
  163. package/tests/browser/session-shelves.spec.mjs +340 -0
  164. package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
  165. package/tests/browser/session-summary.spec.mjs +17 -12
  166. package/tests/browser/settings-complete-home.spec.mjs +463 -0
  167. package/tests/browser/settings-entrypoint.spec.mjs +104 -0
  168. package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
  169. package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
  170. package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
  171. package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
  172. package/tests/browser/shell-ownership.spec.mjs +398 -0
  173. package/tests/browser/shell-rollout-fixture.mjs +259 -0
  174. package/tests/browser/shell-rollout.spec.mjs +357 -0
  175. package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
  176. package/tests/browser/shell-workspace.spec.mjs +433 -0
  177. package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
  178. package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
  179. package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
  180. package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
  181. package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
  182. package/tests/browser/stream-output-isolation.spec.mjs +6 -3
  183. package/tests/browser/themed-selects.spec.mjs +297 -0
  184. package/tests/browser/thread-start-flow.spec.mjs +481 -0
  185. package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
  186. package/tests/browser/ui-polish-features.spec.mjs +85 -0
  187. package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
  188. package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
  189. package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
  190. package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
  191. package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
  192. package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
  193. package/tests/browser/windows-drive-parent.spec.mjs +4 -2
  194. package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
  195. package/tests/codex-cli-usage.test.mjs +189 -0
  196. package/tests/codex-fast-mode-static.test.mjs +16 -11
  197. package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
  198. package/tests/codex-usage-auth.test.mjs +168 -9
  199. package/tests/codex-usage-http.test.mjs +124 -0
  200. package/tests/codex-usage-source.test.mjs +146 -0
  201. package/tests/component-update-api-static.test.mjs +2 -2
  202. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  203. package/tests/control-deck-component-updates-static.test.mjs +9 -4
  204. package/tests/control-visibility-static.test.mjs +3 -3
  205. package/tests/controls-layout-static.test.mjs +5 -5
  206. package/tests/conversation-overview-adapter.test.mjs +100 -0
  207. package/tests/document-artifact-static.test.mjs +2 -1
  208. package/tests/draft-conversations.test.mjs +205 -0
  209. package/tests/empty-startup-launcher.test.mjs +197 -0
  210. package/tests/events-tree-context-menu-static.test.mjs +22 -18
  211. package/tests/fake-pi-session-ownership.test.mjs +302 -0
  212. package/tests/fast-mode-client-static.test.mjs +1 -1
  213. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  214. package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
  215. package/tests/file-viewer-image-static.test.mjs +15 -11
  216. package/tests/file-viewer-search-static.test.mjs +5 -5
  217. package/tests/fixtures/fake-codex-app-server.mjs +61 -0
  218. package/tests/fixtures/fake-pi.mjs +41 -9
  219. package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
  220. package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
  221. package/tests/git-footer-context-menu-static.test.mjs +1 -1
  222. package/tests/git-panel-file-preview-static.test.mjs +41 -48
  223. package/tests/git-panel-live-updates-static.test.mjs +2 -1
  224. package/tests/git-workflow-dispatch.test.mjs +66 -0
  225. package/tests/git-workflow-preferences.test.mjs +9 -1
  226. package/tests/guided-git-activation-static.test.mjs +14 -11
  227. package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
  228. package/tests/guided-git-message-reliability-static.test.mjs +10 -6
  229. package/tests/guided-git-publication-backend-static.test.mjs +16 -11
  230. package/tests/http-endpoints-harness.test.mjs +29 -9
  231. package/tests/interaction-state-stability-static.test.mjs +4 -3
  232. package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
  233. package/tests/intercom-tag-layout-static.test.mjs +13 -12
  234. package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
  235. package/tests/main-output-loading-static.test.mjs +4 -4
  236. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  237. package/tests/mobile-compact-layout.test.mjs +2 -2
  238. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  239. package/tests/mobile-foundation-static.test.mjs +10 -7
  240. package/tests/mobile-phone-experience-static.test.mjs +3 -2
  241. package/tests/mobile-static.test.mjs +173 -135
  242. package/tests/model-catalog-order.test.mjs +103 -0
  243. package/tests/native-parity.test.mjs +6 -4
  244. package/tests/native-session-choice-owner.test.mjs +102 -0
  245. package/tests/native-update-lifecycle.test.mjs +10 -5
  246. package/tests/no-project-http-harness.test.mjs +328 -0
  247. package/tests/no-project-navigation.test.mjs +54 -0
  248. package/tests/no-project-workspaces.test.mjs +77 -0
  249. package/tests/open-issue-wizard-static.test.mjs +1 -1
  250. package/tests/optional-feature-migration-frontend.test.mjs +4 -4
  251. package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
  252. package/tests/package-updates.test.mjs +630 -0
  253. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  254. package/tests/platform-event-stream.test.mjs +253 -0
  255. package/tests/project-file-viewer-controller.test.mjs +652 -0
  256. package/tests/project-git-tools-adapter.test.mjs +103 -0
  257. package/tests/project-git-tools-controller.test.mjs +577 -0
  258. package/tests/project-runners-controller.test.mjs +453 -0
  259. package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
  260. package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
  261. package/tests/questionnaire-dialog.test.mjs +6 -6
  262. package/tests/queue-edit-reorder-static.test.mjs +48 -51
  263. package/tests/rpc-supervisor-host.test.mjs +4 -1
  264. package/tests/safety-guard-auto-review-static.test.mjs +1 -1
  265. package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
  266. package/tests/server-app-runners.test.mjs +536 -0
  267. package/tests/server-codex-fast-mode.test.mjs +346 -0
  268. package/tests/server-conversation-mode.test.mjs +386 -0
  269. package/tests/server-conversation-voice.test.mjs +426 -0
  270. package/tests/server-extension-ui-requests.test.mjs +357 -0
  271. package/tests/server-git-generation.test.mjs +558 -0
  272. package/tests/server-git-mutations.test.mjs +729 -0
  273. package/tests/server-git-reads.test.mjs +381 -0
  274. package/tests/server-git-worktree-sessions.test.mjs +502 -0
  275. package/tests/server-helper-requests.test.mjs +364 -0
  276. package/tests/server-rpc-transports.test.mjs +553 -0
  277. package/tests/server-settings-store.test.mjs +132 -0
  278. package/tests/server-shell-rollout.test.mjs +478 -0
  279. package/tests/server-sse-delivery.test.mjs +410 -0
  280. package/tests/server-workspace-files.test.mjs +546 -0
  281. package/tests/session-attention-scheduler.test.mjs +514 -0
  282. package/tests/session-composer-store.test.mjs +153 -0
  283. package/tests/session-context.test.mjs +134 -0
  284. package/tests/session-extension-requests.test.mjs +193 -0
  285. package/tests/session-ownership-adapter.test.mjs +130 -0
  286. package/tests/session-sampling-ui-static.test.mjs +10 -4
  287. package/tests/session-send-lifetime.test.mjs +140 -0
  288. package/tests/session-shelf-state.test.mjs +348 -0
  289. package/tests/session-shelves-adapter.test.mjs +79 -0
  290. package/tests/session-summary-lifetime.test.mjs +54 -0
  291. package/tests/settings-resource-controller.test.mjs +548 -0
  292. package/tests/shell-action-adapter.test.mjs +169 -0
  293. package/tests/shell-actions.test.mjs +182 -0
  294. package/tests/shell-navigation.test.mjs +348 -0
  295. package/tests/shell-preferences.test.mjs +367 -0
  296. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  297. package/tests/stream-output-isolation-static.test.mjs +1 -1
  298. package/tests/subagent-gate-visibility.test.mjs +1 -1
  299. package/tests/subagent-launch-slot-state.test.mjs +2 -2
  300. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  301. package/tests/subagent-observability-static.test.mjs +2 -2
  302. package/tests/subagent-reliability-integration.test.mjs +13 -30
  303. package/tests/syntax-highlighting-static.test.mjs +3 -3
  304. package/tests/tab-close-continuity-static.test.mjs +1 -1
  305. package/tests/tab-metadata-ordering.test.mjs +99 -0
  306. package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
  307. package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
  308. package/tests/terminal-tab-workspace-static.test.mjs +5 -4
  309. package/tests/terminal-tabs-resize-static.test.mjs +1 -1
  310. package/tests/theme-contract.test.mjs +10 -3
  311. package/tests/theme-customizer-static.test.mjs +1 -1
  312. package/tests/thread-display-title.test.mjs +44 -0
  313. package/tests/update-api-harness.test.mjs +15 -14
  314. package/tests/update-tab-restore-harness.test.mjs +3 -0
  315. package/tests/webui-settings-locking.test.mjs +2 -2
  316. package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
  317. package/tests/workspace-choices.test.mjs +114 -0
  318. package/tests/workspace-save-load-static.test.mjs +7 -4
@@ -0,0 +1,383 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { expect, test } from '@playwright/test';
3
+ import AxeBuilder from '@axe-core/playwright';
4
+
5
+ test.use({ video: 'off', launchOptions: { executablePath: '/usr/bin/chromium' } });
6
+
7
+ const sources = new Map(await Promise.all([
8
+ 'settings-navigation-controller.mjs', 'settings-navigation.css', 'styles.css',
9
+ ].map(async (name) => [`/${name}`, await readFile(new URL(`../../public/${name}`, import.meta.url), 'utf8')])));
10
+
11
+ const fixture = `<!doctype html><html lang="en"><head><meta charset="utf-8">
12
+ <meta name="viewport" content="width=device-width,initial-scale=1"><title>Settings navigation fixture</title>
13
+ <link rel="stylesheet" href="/styles.css"><link rel="stylesheet" href="/settings-navigation.css">
14
+ <style>
15
+ html,body{height:auto;min-height:100%;overflow:auto}body{padding:16px;background:var(--ctp-base)}
16
+ body::before,body::after{display:none}main{position:relative;max-width:960px;margin:auto}
17
+ h1{font-size:var(--text-xl);margin:0 0 16px}#native-row{display:grid;gap:8px;padding:12px;border:1px solid var(--border);border-radius:8px}
18
+ #native-row p{margin:0;color:var(--muted)}#native-row input{min-width:0;width:100%;padding:8px}
19
+ :root[data-fixture-theme="light"]{color-scheme:light;--ctp-base:#eff1f5;--ctp-mantle:#e6e9ef;--ctp-crust:#dce0e8;
20
+ --ctp-text:#4c4f69;--ctp-subtext:#5c5f77;--ctp-surface:#ccd0da;--text:#4c4f69;--muted:#5c5f77;
21
+ --accent:#8839ef;--accent-2:#179299;--border:#9ca0b0;--panel-2:#e6e9ef;--panel-3:#eff1f5}
22
+ </style></head><body><main><h1>Settings</h1><div id="host"></div></main>
23
+ <dialog aria-label="Native confirmation"><label>Confirmation note<input id="modal-note"></label><button id="modal-close">Close</button></dialog>
24
+ <script type="module">
25
+ import {createSettingsNavigator} from '/settings-navigation-controller.mjs';
26
+ window.categories=[['appearance','Appearance'],['resources','Models and resources'],['features','Features'],['accounts','Accounts'],
27
+ ['voice','Voice'],['connection','Connection'],['system','System'],['help','Help']].map(([id,label])=>({id,label}));
28
+ window.entries=[
29
+ {id:'theme',category:'appearance',label:'Theme',description:'Choose Pi colors and appearance.',aliases:['palette','colors'],scopeLabel:'Browser',available:true,reason:''},
30
+ {id:'models',category:'resources',label:'Model selection',description:'Choose the model for this session.',aliases:['provider'],scopeLabel:'Session',available:true,reason:''},
31
+ {id:'voice',category:'voice',label:'Voice input',description:'Speak to Pi with your microphone.',aliases:['dictation','audio'],scopeLabel:'Browser',available:false,reason:'Voice companion is not configured.',setupActionId:'setup:voice'},
32
+ {id:'remote',category:'connection',label:'Remote access',description:'Connect to this server.',aliases:['network'],scopeLabel:'Server',available:false,reason:'Remote access is disabled on this server.'}
33
+ ];
34
+ window.target={tabId:'source-tab',generation:3,lifetime:'source-life'};
35
+ window.calls=[];
36
+ window.navigatorController=createSettingsNavigator({document,
37
+ onNavigate(category,id,captured){calls.push({kind:'navigate',category,id,target:captured,sameTarget:captured===target});},
38
+ onInvoke(actionId,captured){calls.push({kind:'invoke',actionId,target:captured,sameTarget:captured===target});}});
39
+ host.append(navigatorController.element);
40
+ window.nativeRow=document.createElement('div');nativeRow.id='native-row';
41
+ const nativeLabel=document.createElement('label');nativeLabel.textContent='Theme name';
42
+ window.draft=document.createElement('input');draft.value='Keep my custom Pi theme';nativeLabel.append(draft);
43
+ const note=document.createElement('p');note.textContent='Your existing appearance controls stay here.';
44
+ nativeRow.append(nativeLabel,note);navigatorController.slots.content.append(nativeRow);
45
+ window.render=(patch={})=>{window.state={category:'appearance',categories,entries,target,...window.state,...patch};navigatorController.update(state);};
46
+ render();
47
+ document.getElementById('modal-close').onclick=()=>document.querySelector('dialog').close();
48
+ window.ready=true;
49
+ </script></body></html>`;
50
+
51
+ test.beforeEach(async ({ page }) => {
52
+ page.__settingsErrors = [];
53
+ page.on('pageerror', (error) => page.__settingsErrors.push(error.message));
54
+ await page.route('http://settings.test/**', async (route) => {
55
+ const pathname = new URL(route.request().url()).pathname;
56
+ if (pathname === '/') return route.fulfill({ contentType: 'text/html', body: fixture });
57
+ const source = sources.get(pathname);
58
+ if (source === undefined) throw new Error(`Unexpected fixture request: ${pathname}`);
59
+ await route.fulfill({ contentType: pathname.endsWith('.css') ? 'text/css' : 'text/javascript', body: source });
60
+ });
61
+ await page.goto('http://settings.test/');
62
+ await page.waitForFunction(() => window.ready);
63
+ });
64
+
65
+ test.afterEach(async ({ page }) => {
66
+ expect(page.__settingsErrors).toEqual([]);
67
+ });
68
+
69
+ const search = (page) => page.getByRole('searchbox', { name: 'Search settings', exact: true });
70
+ const category = (page, name) => page.getByRole('navigation', { name: 'Settings categories' }).getByRole('button', { name, exact: true });
71
+ const results = (page) => page.getByRole('list', { name: 'Settings search results' });
72
+
73
+ test('mount and updates never dispatch; category navigation keeps the exact parent target', async ({ page }) => {
74
+ await expect(category(page, 'Appearance')).toHaveAttribute('aria-current', 'page');
75
+ await expect(page.getByRole('heading', { name: 'Appearance', exact: true })).toBeVisible();
76
+ expect(await page.evaluate(() => calls)).toEqual([]);
77
+ await category(page, 'Accounts').click();
78
+ expect(await page.evaluate(() => calls)).toEqual([{
79
+ kind: 'navigate', category: 'accounts', id: null,
80
+ target: { tabId: 'source-tab', generation: 3, lifetime: 'source-life' }, sameTarget: true,
81
+ }]);
82
+ await page.evaluate(() => render({ category: 'accounts' }));
83
+ await expect(category(page, 'Accounts')).toHaveAttribute('aria-current', 'page');
84
+ await expect(page.getByRole('heading', { name: 'Accounts', exact: true })).toBeVisible();
85
+ expect(await page.evaluate(() => calls.length)).toBe(1);
86
+ });
87
+
88
+ test('search trims and matches labels, descriptions and aliases across categories', async ({ page }) => {
89
+ await search(page).fill(' PaLeTtE ');
90
+ await expect(results(page).getByRole('listitem')).toHaveCount(1);
91
+ await results(page).getByRole('button').click();
92
+ expect(await page.evaluate(() => calls[0])).toMatchObject({ category: 'appearance', id: 'theme', sameTarget: true });
93
+ await search(page).fill('this session');
94
+ await expect(results(page).getByRole('button')).toContainText('Model selection');
95
+ await search(page).fill('model');
96
+ await search(page).press('Enter');
97
+ expect(await page.evaluate(() => calls[1])).toMatchObject({ category: 'resources', id: 'models', sameTarget: true });
98
+ await search(page).fill('no such setting');
99
+ await expect(page.getByRole('status')).toHaveText('No matching settings. Try another name or purpose.');
100
+ await expect(results(page).getByRole('listitem')).toHaveCount(0);
101
+ await search(page).press('Enter');
102
+ expect(await page.evaluate(() => calls.length)).toBe(2);
103
+ });
104
+
105
+ test('caps queries and results with an honest count and a bounded scroll container', async ({ page }) => {
106
+ await page.evaluate(() => render({ entries: Array.from({ length: 137 }, (_, i) => ({
107
+ id: `entry-${i}`, category: 'system', label: `Setting ${i}`, description: 'Bounded fixture', aliases: [],
108
+ scopeLabel: 'Global', available: true, reason: '',
109
+ })) }));
110
+ await search(page).fill('setting');
111
+ await expect(results(page).getByRole('listitem')).toHaveCount(100);
112
+ await expect(page.getByRole('status')).toHaveText('137 results. Showing the first 100; 37 more results. Refine your search.');
113
+ expect(await results(page).evaluate((list) => list.scrollHeight > list.clientHeight && list.clientHeight <= 512)).toBe(true);
114
+ await search(page).evaluate((input) => {
115
+ input.value = 'x'.repeat(400);
116
+ input.dispatchEvent(new Event('input', { bubbles: true }));
117
+ });
118
+ await expect(search(page)).toHaveValue('x'.repeat(256));
119
+ await expect(search(page)).toHaveAttribute('maxlength', '256');
120
+ });
121
+
122
+ test('unavailable entries retain scope and reasons; only explicit Setup invokes', async ({ page }) => {
123
+ await search(page).fill('audio');
124
+ const voice = results(page).getByRole('listitem');
125
+ await expect(voice.getByRole('button', { name: /Voice input Browser/ })).toBeDisabled();
126
+ await expect(voice).toContainText('Voice companion is not configured.');
127
+ await expect(voice).toContainText('Browser');
128
+ await search(page).press('Enter');
129
+ expect(await page.evaluate(() => calls)).toEqual([]);
130
+ const reasonId = await voice.getByRole('button', { name: /Voice input Browser/ }).getAttribute('aria-describedby');
131
+ await expect(page.locator(`[id="${reasonId}"]`)).toHaveText('Voice companion is not configured.');
132
+ await voice.getByRole('button', { name: 'Setup Voice input', exact: true }).click();
133
+ expect(await page.evaluate(() => calls)).toEqual([{
134
+ kind: 'invoke', actionId: 'setup:voice', target: { tabId: 'source-tab', generation: 3, lifetime: 'source-life' }, sameTarget: true,
135
+ }]);
136
+ await search(page).fill('remote');
137
+ await expect(results(page)).toContainText('Server');
138
+ await expect(results(page)).toContainText('Remote access is disabled on this server.');
139
+ await expect(results(page).getByRole('button', { name: /Setup/ })).toHaveCount(0);
140
+ await search(page).press('Enter');
141
+ expect(await page.evaluate(() => calls.length)).toBe(1);
142
+ });
143
+
144
+ test('ordinary updates preserve search, content typing, selection and keyed button identity', async ({ page }) => {
145
+ await page.getByLabel('Theme name').focus();
146
+ await page.evaluate(() => { draft.setSelectionRange(5, 12, 'backward'); render(); });
147
+ expect(await page.evaluate(() => [document.activeElement === draft, draft.selectionStart, draft.selectionEnd, draft.selectionDirection,
148
+ navigatorController.slots.content.firstChild === nativeRow])).toEqual([true, 5, 12, 'backward', true]);
149
+ await search(page).fill('palette');
150
+ await page.evaluate(() => {
151
+ const input = document.querySelector('input[type="search"]');
152
+ input.setSelectionRange(1, 4, 'backward');
153
+ window.savedResult = document.querySelector('.settings-navigation-open');
154
+ window.savedCategory = document.querySelector('.settings-navigation-category');
155
+ for (let i = 0; i < 20; i++) render();
156
+ });
157
+ expect(await search(page).evaluate((input) => [document.activeElement === input, input.selectionStart, input.selectionEnd, input.selectionDirection])).toEqual([true, 1, 4, 'backward']);
158
+ expect(await page.evaluate(() => savedResult === document.querySelector('.settings-navigation-open') &&
159
+ savedCategory === document.querySelector('.settings-navigation-category') && nativeRow.parentNode === navigatorController.slots.content)).toBe(true);
160
+ await results(page).getByRole('button').focus();
161
+ await page.evaluate(() => render());
162
+ await expect(results(page).getByRole('button')).toBeFocused();
163
+ await page.evaluate(() => navigatorController.clearSearch());
164
+ await expect(search(page)).toBeFocused();
165
+ await expect(page.getByLabel('Theme name')).toHaveValue('Keep my custom Pi theme');
166
+ expect(await page.evaluate(() => [draft.selectionStart, draft.selectionEnd])).toEqual([5, 12]);
167
+ expect(await page.evaluate(() => calls)).toEqual([]);
168
+ });
169
+
170
+ test('keyed reordering and removed focus stay usable without replacing controls', async ({ page }) => {
171
+ await category(page, 'Models and resources').focus();
172
+ await page.evaluate(() => { window.saved = document.activeElement; render({ categories: [...categories].reverse() }); });
173
+ expect(await page.evaluate(() => document.activeElement === saved)).toBe(true);
174
+ await search(page).fill('pi');
175
+ await results(page).getByRole('button', { name: /Theme Browser/ }).focus();
176
+ await page.evaluate(() => { window.saved = document.activeElement; render({ entries: [...entries].reverse() }); });
177
+ expect(await page.evaluate(() => document.activeElement === saved)).toBe(true);
178
+ await page.evaluate(() => render({ entries: [] }));
179
+ await expect(search(page)).toBeFocused();
180
+ });
181
+
182
+ test('old handlers cannot retarget changed entries, actions or parent lifetimes', async ({ page }) => {
183
+ await search(page).fill('palette');
184
+ await page.evaluate(() => {
185
+ window.oldCategory = document.querySelector('.settings-navigation-category').onclick;
186
+ window.oldResult = document.querySelector('.settings-navigation-open').onclick;
187
+ window.target = { tabId: 'replacement', generation: 4, lifetime: 'replacement-life' };
188
+ render({ target, entries: entries.map((entry) => entry.id === 'theme' ? { ...entry, category: 'system' } : entry) });
189
+ oldCategory(); oldResult();
190
+ });
191
+ expect(await page.evaluate(() => calls)).toEqual([]);
192
+ await results(page).getByRole('button').click();
193
+ expect(await page.evaluate(() => calls[0])).toEqual({
194
+ kind: 'navigate', category: 'system', id: 'theme',
195
+ target: { tabId: 'replacement', generation: 4, lifetime: 'replacement-life' }, sameTarget: true,
196
+ });
197
+ await search(page).fill('audio');
198
+ await page.evaluate(() => {
199
+ window.oldSetup = document.querySelector('.settings-navigation-setup').onclick;
200
+ render({ entries: entries.map((entry) => entry.id === 'voice' ? { ...entry, setupActionId: 'setup:replacement' } : entry) });
201
+ oldSetup();
202
+ });
203
+ expect(await page.evaluate(() => calls.length)).toBe(1);
204
+ await results(page).getByRole('button', { name: 'Setup Voice input', exact: true }).click();
205
+ expect(await page.evaluate(() => calls[1])).toMatchObject({ kind: 'invoke', actionId: 'setup:replacement', sameTarget: true });
206
+ });
207
+
208
+ test('removed and hidden retained controls cannot dispatch, even when reattached', async ({ page }) => {
209
+ await search(page).fill('palette');
210
+ await page.evaluate(() => {
211
+ const chrome = navigatorController.element;
212
+ host.removeChild(chrome);
213
+ document.activeElement?.blur();
214
+ chrome.querySelector('.settings-navigation-open').click();
215
+ chrome.querySelector('.settings-navigation-category').onclick();
216
+ host.append(chrome);
217
+ window.oldButton = document.querySelector('.settings-navigation-open'); window.oldClick = oldButton.onclick;
218
+ window.oldCategoryNode = document.querySelector('.settings-navigation-category'); window.oldCategoryClick = oldCategoryNode.onclick;
219
+ render({ entries: [], categories: [] });
220
+ navigatorController.element.append(oldButton, oldCategoryNode);
221
+ oldClick(); oldCategoryClick(); oldButton.click(); oldCategoryNode.click();
222
+ });
223
+ expect(await page.evaluate(() => calls)).toEqual([]);
224
+ await page.evaluate(() => {
225
+ oldButton.remove(); oldCategoryNode.remove(); render({ categories, entries });
226
+ window.hiddenClick = document.querySelector('.settings-navigation-open').onclick;
227
+ navigatorController.slots.content.hidden = true;
228
+ navigatorController.element.hidden = true;
229
+ hiddenClick();
230
+ navigatorController.element.hidden = false;
231
+ navigatorController.clearSearch(); hiddenClick();
232
+ });
233
+ expect(await page.evaluate(() => calls)).toEqual([]);
234
+ });
235
+
236
+ test('live availability, reasons and Setup updates retain keyed rows and correct focus', async ({ page }) => {
237
+ await search(page).fill('audio');
238
+ await results(page).getByRole('button', { name: 'Setup Voice input', exact: true }).focus();
239
+ await page.evaluate(() => {
240
+ window.rowBefore = document.querySelector('.settings-navigation-result');
241
+ render({ entries: entries.map((entry) => entry.id === 'voice' ? { ...entry, reason: 'Microphone permission is missing.' } : entry) });
242
+ });
243
+ await expect(results(page)).toContainText('Microphone permission is missing.');
244
+ await expect(results(page).getByRole('button', { name: 'Setup Voice input', exact: true })).toBeFocused();
245
+ await page.evaluate(() => render({ entries: entries.map((entry) => ({ ...entry, available: true })) }));
246
+ expect(await page.evaluate(() => rowBefore === document.querySelector('.settings-navigation-result'))).toBe(true);
247
+ await expect(search(page)).toBeFocused();
248
+ await expect(results(page).getByRole('button', { name: /Voice input Browser/ })).toBeEnabled();
249
+ await expect(results(page)).not.toContainText('Microphone permission is missing.');
250
+ await expect(results(page).getByRole('button', { name: 'Setup Voice input', exact: true })).toHaveCount(0);
251
+ });
252
+
253
+ test('keyboard supports categories and result actions while search keeps native caret keys', async ({ page }) => {
254
+ await category(page, 'Appearance').focus();
255
+ await page.keyboard.press('End');
256
+ await expect(category(page, 'Help')).toBeFocused();
257
+ await page.keyboard.press('Home');
258
+ await page.keyboard.press('ArrowRight');
259
+ await expect(category(page, 'Models and resources')).toBeFocused();
260
+ await page.keyboard.press('Enter');
261
+ expect(await page.evaluate(() => calls[0].category)).toBe('resources');
262
+ await search(page).fill('pi');
263
+ await search(page).press('Home');
264
+ await expect(search(page)).toBeFocused();
265
+ await search(page).press('ArrowDown');
266
+ await expect(results(page).getByRole('button', { name: /Theme Browser/ })).toBeFocused();
267
+ await page.keyboard.press('End');
268
+ await expect(results(page).getByRole('button', { name: 'Setup Voice input', exact: true })).toBeFocused();
269
+ await page.keyboard.press('Home');
270
+ await expect(results(page).getByRole('button', { name: /Theme Browser/ })).toBeFocused();
271
+ await page.keyboard.press('ArrowUp');
272
+ await expect(results(page).getByRole('button', { name: 'Setup Voice input', exact: true })).toBeFocused();
273
+ await page.keyboard.press('Escape');
274
+ await expect(search(page)).toHaveValue('');
275
+ await expect(search(page)).toBeFocused();
276
+ await expect(page.getByLabel('Theme name')).toBeVisible();
277
+ await search(page).fill('pi');
278
+ await search(page).press('ArrowUp');
279
+ await expect(results(page).getByRole('button', { name: 'Setup Voice input', exact: true })).toBeFocused();
280
+ expect(await page.evaluate(() => calls.length)).toBe(1);
281
+ });
282
+
283
+ test('Escape and arrow keys leave native modal keyboard ownership intact', async ({ page }) => {
284
+ await search(page).fill('palette');
285
+ await page.evaluate(() => document.querySelector('dialog').showModal());
286
+ await page.getByLabel('Confirmation note').fill('keep this modal draft');
287
+ expect(await search(page).evaluate((input) => {
288
+ const event = new KeyboardEvent('keydown', { key: 'Escape', bubbles: true, cancelable: true });
289
+ input.dispatchEvent(event); return event.defaultPrevented;
290
+ })).toBe(false);
291
+ await expect(search(page)).toHaveValue('palette');
292
+ await page.getByLabel('Confirmation note').press('ArrowDown');
293
+ await expect(page.getByLabel('Confirmation note')).toBeFocused();
294
+ await page.getByLabel('Confirmation note').press('Escape');
295
+ await expect(page.getByRole('dialog')).not.toBeVisible();
296
+ await expect(search(page)).toHaveValue('palette');
297
+ expect(await page.evaluate(() => calls)).toEqual([]);
298
+ });
299
+
300
+ test('safe text and instance-scoped labels cannot create markup or duplicate IDs', async ({ page }) => {
301
+ await page.evaluate(async () => {
302
+ const unsafe = '<img src=x onerror="window.injected=true">';
303
+ render({ categories: [{ id: 'appearance', label: unsafe }], entries: [{ id: 'unsafe', category: 'appearance',
304
+ label: unsafe, description: unsafe, aliases: ['unsafe'], scopeLabel: unsafe, available: false, reason: unsafe, setupActionId: 'setup:unsafe' }] });
305
+ const { createSettingsNavigator } = await import('/settings-navigation-controller.mjs');
306
+ window.second = createSettingsNavigator({ document, onNavigate() {}, onInvoke() {} });
307
+ host.append(second.element); second.update(state);
308
+ });
309
+ await search(page).first().fill('unsafe');
310
+ await expect(page.locator('.settings-navigation img')).toHaveCount(0);
311
+ expect(await page.evaluate(() => window.injected)).toBeUndefined();
312
+ expect(await page.evaluate(() => {
313
+ const ids = [...document.querySelectorAll('[id]')].map((node) => node.id);
314
+ return ids.length === new Set(ids).size && [...document.querySelectorAll('.settings-navigation label')]
315
+ .every((label) => label.control?.closest('.settings-navigation') === label.closest('.settings-navigation'));
316
+ })).toBe(true);
317
+ await expect(page.locator('.settings-navigation-reason').first()).toHaveText('<img src=x onerror="window.injected=true">');
318
+ await page.evaluate(() => second.dispose());
319
+ });
320
+
321
+ test('clear and disposal preserve caller nodes and resources and silence retained handlers', async ({ page }) => {
322
+ await search(page).fill('audio');
323
+ await page.getByRole('button', { name: 'Clear settings search', exact: true }).click();
324
+ await expect(search(page)).toHaveValue('');
325
+ await expect(search(page)).toBeFocused();
326
+ await expect(page.getByLabel('Theme name')).toBeVisible();
327
+ await search(page).fill('palette');
328
+ await page.evaluate(() => {
329
+ window.oldSearch = document.querySelector('input[type="search"]');
330
+ window.oldKeyHandlerEvent = new KeyboardEvent('keydown', { key: 'Escape', bubbles: true, cancelable: true });
331
+ window.oldAction = document.querySelector('.settings-navigation-open').onclick;
332
+ window.oldCategory = document.querySelector('.settings-navigation-category').onclick;
333
+ window.nativeClicks = 0; nativeRow.addEventListener('click', () => nativeClicks++);
334
+ navigatorController.clearSearch(); navigatorController.clearSearch();
335
+ });
336
+ await expect(search(page)).toHaveValue('');
337
+ await expect(page.getByLabel('Theme name')).toBeVisible();
338
+ expect(await page.evaluate(() => calls)).toEqual([]);
339
+ await page.evaluate(() => {
340
+ navigatorController.dispose(); navigatorController.dispose();
341
+ oldAction(); oldCategory(); render(); navigatorController.clearSearch();
342
+ oldSearch.value = 'ignored'; oldSearch.dispatchEvent(new Event('input', { bubbles: true }));
343
+ navigatorController.element.dispatchEvent(oldKeyHandlerEvent);
344
+ host.append(navigatorController.slots.content);
345
+ nativeRow.click();
346
+ });
347
+ await expect(page.getByLabel('Theme name')).toHaveValue('Keep my custom Pi theme');
348
+ expect(await page.evaluate(() => ({ calls, nativeClicks, same: nativeRow.parentNode === navigatorController.slots.content,
349
+ chromeChildren: navigatorController.element.childElementCount, keyPrevented: oldKeyHandlerEvent.defaultPrevented })))
350
+ .toEqual({ calls: [], nativeClicks: 1, same: true, chromeChildren: 0, keyPrevented: false });
351
+ });
352
+
353
+ for (const theme of ['dark', 'light']) {
354
+ for (const width of [390, 1200]) {
355
+ test(`${theme} ${width}px compact fixture fits content and unavailable search`, async ({ page }, testInfo) => {
356
+ await page.setViewportSize({ width, height: 900 });
357
+ await page.evaluate((theme) => { document.documentElement.dataset.fixtureTheme = theme; }, theme);
358
+ await expect(page.getByLabel('Theme name')).toBeVisible();
359
+ const positions = await page.evaluate(() => {
360
+ const nav = document.querySelector('.settings-navigation-categories').getBoundingClientRect();
361
+ const main = document.querySelector('.settings-navigation-main').getBoundingClientRect();
362
+ return { nav: { right: nav.right, bottom: nav.bottom }, main: { x: main.x, y: main.y } };
363
+ });
364
+ if (width > 640) expect(positions.main.x).toBeGreaterThan(positions.nav.right);
365
+ else expect(positions.main.y).toBeGreaterThan(positions.nav.bottom);
366
+ if ((theme === 'dark' && width === 1200) || (theme === 'light' && width === 390)) {
367
+ await page.screenshot({ path: testInfo.outputPath(`settings-content-${theme}-${width}.png`), fullPage: true, animations: 'disabled' });
368
+ }
369
+ await search(page).fill('pi');
370
+ await expect(results(page)).toContainText('Voice companion is not configured.');
371
+ await expect(results(page).getByRole('button', { name: 'Setup Voice input', exact: true })).toBeVisible();
372
+ expect(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth)).toBe(true);
373
+ for (const control of await page.locator('.settings-navigation button:visible, .settings-navigation input:visible').all()) {
374
+ const bounds = await control.boundingBox();
375
+ expect(bounds.x).toBeGreaterThanOrEqual(0);
376
+ expect(bounds.x + bounds.width).toBeLessThanOrEqual(width);
377
+ }
378
+ await page.screenshot({ path: testInfo.outputPath(`settings-search-${theme}-${width}.png`), fullPage: true, animations: 'disabled' });
379
+ const accessibility = await new AxeBuilder({ page }).include('.settings-navigation').analyze();
380
+ expect(accessibility.violations).toEqual([]);
381
+ });
382
+ }
383
+ }