@firstpick/pi-package-webui 0.9.7 → 0.9.8

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 (55) hide show
  1. package/README.md +7 -3
  2. package/bin/pi-webui.mjs +114 -25
  3. package/index.ts +2 -1
  4. package/lib/optional-feature-catalog.mjs +1 -1
  5. package/package.json +1 -1
  6. package/public/app.js +629 -98
  7. package/public/guided-git-command-state.mjs +175 -1
  8. package/public/index.html +12 -9
  9. package/public/service-worker.js +1 -1
  10. package/public/styles.css +133 -31
  11. package/public/transcript-renderer.mjs +62 -0
  12. package/tests/boot-failure-diagnostics.test.mjs +3 -3
  13. package/tests/browser/footer-model-advanced-layout.spec.mjs +512 -0
  14. package/tests/browser/guided-git-extension-command.spec.mjs +180 -0
  15. package/tests/browser/guided-git-fallback.spec.mjs +68 -3
  16. package/tests/browser/interaction-continuity.spec.mjs +33 -0
  17. package/tests/codex-fast-mode-static.test.mjs +2 -2
  18. package/tests/compaction-static.test.mjs +1 -1
  19. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  20. package/tests/control-visibility-static.test.mjs +3 -3
  21. package/tests/controls-layout-static.test.mjs +3 -3
  22. package/tests/events-tree-context-menu-static.test.mjs +3 -3
  23. package/tests/fast-mode-client-static.test.mjs +1 -1
  24. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  25. package/tests/file-viewer-image-static.test.mjs +3 -3
  26. package/tests/fixtures/fake-pi.mjs +34 -3
  27. package/tests/git-footer-context-menu-static.test.mjs +103 -1
  28. package/tests/guided-git-activation-http.test.mjs +194 -0
  29. package/tests/guided-git-activation-static.test.mjs +80 -0
  30. package/tests/guided-git-activation.test.mjs +244 -0
  31. package/tests/guided-git-fallback-runtime.test.mjs +1 -0
  32. package/tests/guided-git-fallback-ui-static.test.mjs +2 -2
  33. package/tests/guided-git-message-reliability-static.test.mjs +2 -1
  34. package/tests/guided-git-optional-feature.test.mjs +31 -0
  35. package/tests/http-endpoints-harness.test.mjs +3 -0
  36. package/tests/interaction-state-stability-static.test.mjs +1 -1
  37. package/tests/intercom-conversation-viewer-static.test.mjs +3 -3
  38. package/tests/main-output-loading-static.test.mjs +11 -9
  39. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  40. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  41. package/tests/mobile-foundation-static.test.mjs +3 -3
  42. package/tests/mobile-phone-experience-static.test.mjs +1 -1
  43. package/tests/mobile-static.test.mjs +85 -4
  44. package/tests/open-issue-wizard-static.test.mjs +1 -1
  45. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  46. package/tests/prompt-input-vertical-scroll-static.test.mjs +6 -6
  47. package/tests/prompt-routing-input-clear-static.test.mjs +1 -1
  48. package/tests/questionnaire-dialog.test.mjs +3 -3
  49. package/tests/session-sampling-ui-static.test.mjs +3 -3
  50. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  51. package/tests/subagent-observability-static.test.mjs +2 -2
  52. package/tests/syntax-highlighting-static.test.mjs +3 -3
  53. package/tests/tab-close-continuity-static.test.mjs +2 -0
  54. package/tests/theme-customizer-static.test.mjs +1 -1
  55. package/tests/thinking-block-grouping.test.mjs +79 -0
@@ -0,0 +1,512 @@
1
+ import assert from "node:assert/strict";
2
+ import { spawn } from "node:child_process";
3
+ import { createServer } from "node:net";
4
+ import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
5
+ import { tmpdir } from "node:os";
6
+ import { dirname, join } from "node:path";
7
+ import { setTimeout as delay } from "node:timers/promises";
8
+ import { fileURLToPath } from "node:url";
9
+ import { expect, test } from "@playwright/test";
10
+
11
+ const root = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
12
+ const serverScript = join(root, "bin", "pi-webui.mjs");
13
+ const fakePi = join(root, "tests", "fixtures", "fake-pi.mjs");
14
+ const layoutKey = "pi-webui-footer-scoped-model-layout-v1";
15
+ const orderKey = "pi-webui-footer-scoped-model-order-v1";
16
+ const footerCacheKey = "pi-webui-git-footer-webui-payload-cache";
17
+ const scopedModels = [
18
+ { provider: "zeta", id: "z-one", name: "Zeta One" },
19
+ { provider: "alpha", id: "a-one", name: "Alpha One" },
20
+ { provider: "beta", id: "b-one", name: "Beta One" },
21
+ { provider: "alpha", id: "a-two", name: "Alpha Two" },
22
+ { provider: "zeta", id: "z-two", name: "Zeta Two" },
23
+ { provider: "alpha", id: "a-three", name: "Alpha Three" },
24
+ ];
25
+ const manyProviderModels = Array.from({ length: 10 }, (_, index) => ({
26
+ provider: `provider-${String(index + 1).padStart(2, "0")}`,
27
+ id: `model-${index + 1}`,
28
+ name: `Provider ${index + 1} Model`,
29
+ }));
30
+ const footerPayload = JSON.stringify({
31
+ type: "firstpick.git-footer-status.footer",
32
+ version: 1,
33
+ generatedAt: Date.now(),
34
+ main: [{ key: "tokens", label: "tokens", value: "0" }],
35
+ meta: [
36
+ { key: "cwd", label: "cwd", value: "fixture" },
37
+ { key: "model", label: "model", value: "fake/fake-model" },
38
+ { key: "thinking", label: "effort", value: "off" },
39
+ ],
40
+ visibility: {},
41
+ });
42
+
43
+ let child;
44
+ let baseURL;
45
+ let tempRoot;
46
+ let output = "";
47
+
48
+ async function freePort() {
49
+ const server = createServer();
50
+ await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
51
+ const { port } = server.address();
52
+ await new Promise((resolve) => server.close(resolve));
53
+ return port;
54
+ }
55
+
56
+ async function startServer() {
57
+ const port = await freePort();
58
+ tempRoot = await mkdtemp(join(tmpdir(), "pi-webui-footer-model-advanced-"));
59
+ await mkdir(join(tempRoot, "agent"), { recursive: true });
60
+ await writeFile(join(tempRoot, "settings.json"), "{}", "utf8");
61
+ baseURL = `http://127.0.0.1:${port}`;
62
+ child = spawn(process.execPath, [serverScript, "--cwd", tempRoot, "--host", "127.0.0.1", "--port", String(port), "--pi", fakePi], {
63
+ stdio: ["ignore", "pipe", "pipe"],
64
+ env: {
65
+ ...process.env,
66
+ PI_WEBUI_RPC_SUPERVISOR: "0",
67
+ PI_CODING_AGENT_DIR: join(tempRoot, "agent"),
68
+ PI_WEBUI_SETTINGS_FILE: join(tempRoot, "settings.json"),
69
+ },
70
+ });
71
+ child.stdout.on("data", (chunk) => { output += String(chunk); });
72
+ child.stderr.on("data", (chunk) => { output += String(chunk); });
73
+ for (let attempt = 0; attempt < 100; attempt += 1) {
74
+ if (child.exitCode !== null) break;
75
+ try {
76
+ const response = await fetch(`${baseURL}/api/health`, { signal: AbortSignal.timeout(500) });
77
+ if (response.ok) return;
78
+ } catch {
79
+ // Wait for the isolated fixture server.
80
+ }
81
+ await delay(100);
82
+ }
83
+ throw new Error(`Pi Web UI did not start:\n${output}`);
84
+ }
85
+
86
+ async function stopServer() {
87
+ if (!child || child.exitCode !== null) return;
88
+ const exited = new Promise((resolve) => child.once("exit", resolve));
89
+ child.kill("SIGTERM");
90
+ await Promise.race([
91
+ exited,
92
+ delay(5_000).then(() => {
93
+ if (child.exitCode === null) child.kill("SIGKILL");
94
+ return exited;
95
+ }),
96
+ ]);
97
+ }
98
+
99
+ async function installFixture(page, models = scopedModels) {
100
+ const modelCalls = [];
101
+ let selectedModel = null;
102
+ await page.addInitScript(({ cacheKey, raw }) => {
103
+ localStorage.setItem(cacheKey, JSON.stringify({ raw, cwd: "", savedAt: Date.now() }));
104
+ }, { cacheKey: footerCacheKey, raw: footerPayload });
105
+ await page.route("**/api/commands*", async (route) => {
106
+ await route.fulfill({
107
+ status: 200,
108
+ contentType: "application/json",
109
+ body: JSON.stringify({
110
+ ok: true,
111
+ data: { commands: [{ name: "git-footer-refresh", source: "extension", description: "Refresh Git footer" }] },
112
+ }),
113
+ });
114
+ });
115
+ await page.route("**/api/scoped-models*", async (route) => {
116
+ await route.fulfill({
117
+ status: 200,
118
+ contentType: "application/json",
119
+ body: JSON.stringify({ ok: true, data: { models, patterns: ["*"], source: "browser-fixture", rpcRunning: true } }),
120
+ });
121
+ });
122
+ await page.route("**/api/state*", async (route) => {
123
+ const response = await route.fetch();
124
+ const body = await response.json();
125
+ if (selectedModel && body?.data) body.data.model = selectedModel;
126
+ await route.fulfill({ response, json: body });
127
+ });
128
+ await page.route(/\/api\/model(?:\?.*)?$/, async (route) => {
129
+ const body = route.request().postDataJSON();
130
+ modelCalls.push(body);
131
+ selectedModel = { provider: body.provider, id: body.modelId };
132
+ await delay(120);
133
+ await route.fulfill({
134
+ status: 200,
135
+ contentType: "application/json",
136
+ body: JSON.stringify({ ok: true, data: { provider: body.provider, id: body.modelId } }),
137
+ });
138
+ });
139
+ return modelCalls;
140
+ }
141
+
142
+ async function preparePage(page) {
143
+ await Promise.all([
144
+ page.waitForResponse((response) => response.url().includes("/api/scoped-models") && response.ok()),
145
+ page.goto(baseURL, { waitUntil: "domcontentloaded" }),
146
+ ]);
147
+ await page.addStyleTag({ content: "#optionalFeatureMigrationSurface, #updateNotification { display: none !important; }" });
148
+ await expect(page.locator("#statusBar")).toHaveClass(/statusbar-git-footer/);
149
+ await expect(page.locator(".footer-model.footer-meta-action")).toBeVisible();
150
+ }
151
+
152
+ async function openModelMenu(page) {
153
+ const model = page.locator(".footer-model.footer-meta-action");
154
+ await model.click({ button: "right" });
155
+ const menu = page.locator("#gitFooterContextMenu");
156
+ await expect(menu).toBeVisible();
157
+ return { model, menu, toggle: menu.getByRole("menuitemcheckbox") };
158
+ }
159
+
160
+ async function openPicker(page, expectedClass = null, expectedModelCount = scopedModels.length) {
161
+ const model = page.locator(".footer-model.footer-meta-action");
162
+ await model.click();
163
+ const picker = page.locator(".footer-model-picker");
164
+ await expect(picker).toBeVisible();
165
+ await expect(picker.locator(".footer-model-option")).toHaveCount(expectedModelCount);
166
+ if (expectedClass) await expect(picker).toHaveClass(expectedClass);
167
+ return picker;
168
+ }
169
+
170
+ async function dragModelOption(page, source, target, { after = false } = {}) {
171
+ await source.scrollIntoViewIfNeeded();
172
+ await target.scrollIntoViewIfNeeded();
173
+ const sourceBox = await source.boundingBox();
174
+ const targetBox = await target.boundingBox();
175
+ assert.ok(sourceBox && targetBox, "drag source and target should have measurable bounds");
176
+ const sourceX = sourceBox.x + sourceBox.width / 2;
177
+ const sourceY = sourceBox.y + sourceBox.height / 2;
178
+ const targetX = targetBox.x + targetBox.width / 2;
179
+ const targetY = targetBox.y + (after ? targetBox.height - 3 : 3);
180
+ await page.mouse.move(sourceX, sourceY);
181
+ await page.mouse.down();
182
+ await page.mouse.move(sourceX, sourceY + 12, { steps: 2 });
183
+ await page.mouse.move(targetX, targetY, { steps: 6 });
184
+ await page.mouse.up();
185
+ }
186
+
187
+ test.describe.configure({ mode: "serial" });
188
+
189
+ test.beforeAll(startServer);
190
+
191
+ test.afterAll(async () => {
192
+ await stopServer();
193
+ await rm(tempRoot, { recursive: true, force: true });
194
+ });
195
+
196
+ test("many provider columns grow over side panels, stop at the viewport, and scroll internally", async ({ page }) => {
197
+ await page.setViewportSize({ width: 1440, height: 900 });
198
+ await installFixture(page, manyProviderModels);
199
+ await preparePage(page);
200
+
201
+ const sidePanel = page.locator(".side-panel-right");
202
+ await expect(sidePanel).toBeVisible();
203
+ const menu = await openModelMenu(page);
204
+ await menu.toggle.click();
205
+ const picker = await openPicker(page, /footer-model-picker-advanced/, manyProviderModels.length);
206
+ const geometry = await picker.evaluate((node) => {
207
+ const rect = node.getBoundingClientRect();
208
+ const columns = node.querySelector(".footer-model-provider-columns");
209
+ const sidePanel = document.querySelector(".side-panel-right");
210
+ const sideRect = sidePanel.getBoundingClientRect();
211
+ const overlapLeft = Math.max(rect.left, sideRect.left);
212
+ const overlapRight = Math.min(rect.right, sideRect.right);
213
+ const overlapTop = Math.max(rect.top, sideRect.top);
214
+ const overlapBottom = Math.min(rect.bottom, sideRect.bottom);
215
+ const probeX = Math.min(overlapRight - 2, overlapLeft + 16);
216
+ const probeY = Math.min(overlapBottom - 2, overlapTop + 16);
217
+ const topNode = overlapRight > overlapLeft && overlapBottom > overlapTop
218
+ ? document.elementFromPoint(probeX, probeY)
219
+ : null;
220
+ return {
221
+ left: rect.left,
222
+ right: rect.right,
223
+ top: rect.top,
224
+ bottom: rect.bottom,
225
+ width: rect.width,
226
+ viewportWidth: window.innerWidth,
227
+ viewportHeight: window.innerHeight,
228
+ documentWidth: document.documentElement.scrollWidth,
229
+ clientWidth: document.documentElement.clientWidth,
230
+ overlapsSidePanel: overlapRight > overlapLeft && overlapBottom > overlapTop,
231
+ paintsAboveSidePanel: topNode?.closest?.(".footer-model-picker") === node,
232
+ columnsClientWidth: columns.clientWidth,
233
+ columnsScrollWidth: columns.scrollWidth,
234
+ columnsOverflowX: getComputedStyle(columns).overflowX,
235
+ };
236
+ });
237
+ assert.ok(geometry.left >= 7 && geometry.right <= geometry.viewportWidth - 7, `picker should remain within viewport gutters: ${JSON.stringify(geometry)}`);
238
+ assert.ok(geometry.top >= 0 && geometry.bottom <= geometry.viewportHeight, `picker should remain vertically bounded: ${JSON.stringify(geometry)}`);
239
+ assert.ok(geometry.width >= geometry.viewportWidth - 20, `many providers should grow the picker to its viewport cap: ${JSON.stringify(geometry)}`);
240
+ assert.equal(geometry.documentWidth, geometry.clientWidth, "provider columns should not widen the document");
241
+ assert.equal(geometry.overlapsSidePanel, true, "the capped picker should use space above the visible side panel");
242
+ assert.equal(geometry.paintsAboveSidePanel, true, "the picker should paint above side-panel content in the overlap");
243
+ assert.ok(geometry.columnsScrollWidth > geometry.columnsClientWidth, `capped provider columns should overflow internally: ${JSON.stringify(geometry)}`);
244
+ assert.equal(geometry.columnsOverflowX, "auto");
245
+ const horizontalScroll = await picker.locator(".footer-model-provider-columns").evaluate((columns) => {
246
+ columns.scrollLeft = columns.scrollWidth;
247
+ return { scrollLeft: columns.scrollLeft, maxScroll: columns.scrollWidth - columns.clientWidth };
248
+ });
249
+ assert.ok(horizontalScroll.scrollLeft > 0 && horizontalScroll.maxScroll - horizontalScroll.scrollLeft <= 16, `provider overflow should scroll to its end accounting for scrollbar gutters: ${JSON.stringify(horizontalScroll)}`);
250
+ });
251
+
252
+ test("advanced footer model layout persists, groups providers, navigates, applies, closes, and preserves flat mode", async ({ page }) => {
253
+ await page.setViewportSize({ width: 1280, height: 800 });
254
+ const page1ModelCalls = await installFixture(page);
255
+ const page2 = await page.context().newPage();
256
+ const page2ModelCalls = await installFixture(page2);
257
+ try {
258
+ await preparePage(page);
259
+ await preparePage(page2);
260
+
261
+ // The checkbox is restricted to the Git footer Model box.
262
+ const cwd = page.locator(".footer-workspace.footer-meta-action");
263
+ await cwd.click({ button: "right" });
264
+ await expect(page.locator('#gitFooterContextMenu [data-git-footer-menu-action="toggle-advanced"]')).toBeHidden();
265
+ await page.keyboard.press("Escape");
266
+
267
+ const keyboardModel = page.locator(".footer-model.footer-meta-action");
268
+ await keyboardModel.focus();
269
+ await page.keyboard.press("Shift+F10");
270
+ await expect(page.getByRole("menuitemcheckbox", { name: "Toggle advanced" })).toBeVisible();
271
+ await page.keyboard.press("Escape");
272
+
273
+ const page2Menu = await openModelMenu(page2);
274
+ await expect(page2Menu.toggle).toHaveAttribute("aria-checked", "false");
275
+ await expect(page2Menu.toggle).toHaveText("Toggle advanced");
276
+
277
+ // Toggle in one tab and prove live menu state, local persistence, and
278
+ // same-origin adoption while the receiving menu remains open.
279
+ const page1Menu = await openModelMenu(page);
280
+ await expect(page1Menu.toggle).toHaveAttribute("aria-checked", "false");
281
+ await page1Menu.toggle.click();
282
+ await expect.poll(() => page.evaluate((key) => localStorage.getItem(key), layoutKey)).toBe("advanced");
283
+ await expect.poll(() => page2.evaluate((key) => localStorage.getItem(key), layoutKey)).toBe("advanced");
284
+ await expect(page2Menu.toggle).toHaveAttribute("aria-checked", "true");
285
+ await expect(page2Menu.toggle).toHaveText("Toggle Simple");
286
+ await expect(page1Menu.model).toBeFocused();
287
+ await page2.keyboard.press("Escape");
288
+
289
+ // An already-open receiving picker must rebuild in place on both remote
290
+ // transitions instead of retaining stale handlers from the old layout.
291
+ const adoptedPicker = await openPicker(page2, /footer-model-picker-advanced/);
292
+ const page1FlatMenu = await openModelMenu(page);
293
+ await expect(page1FlatMenu.toggle).toHaveText("Toggle Simple");
294
+ await page1FlatMenu.toggle.click();
295
+ await expect(adoptedPicker).not.toHaveClass(/footer-model-picker-advanced/);
296
+ await expect(adoptedPicker.locator(".footer-model-provider-column")).toHaveCount(0);
297
+ const page1AdvancedMenu = await openModelMenu(page);
298
+ await page1AdvancedMenu.toggle.click();
299
+ await expect(adoptedPicker).toHaveClass(/footer-model-picker-advanced/);
300
+ await expect(adoptedPicker.locator(".footer-model-provider-column")).toHaveCount(3);
301
+ await page2.keyboard.press("Escape");
302
+
303
+ // Reload keeps the browser-local choice.
304
+ await Promise.all([
305
+ page2.waitForResponse((response) => response.url().includes("/api/scoped-models") && response.ok()),
306
+ page2.reload({ waitUntil: "domcontentloaded" }),
307
+ ]);
308
+ await page2.bringToFront();
309
+ await page2.addStyleTag({ content: "#optionalFeatureMigrationSurface, #updateNotification { display: none !important; }" });
310
+ await expect.poll(() => page2.evaluate((key) => localStorage.getItem(key), layoutKey)).toBe("advanced");
311
+
312
+ await page2.addStyleTag({ content: ".footer-model-picker-advanced { width: 20rem !important; } .footer-model-provider-columns { max-width: 18rem; max-height: 7rem; }" });
313
+ const picker = await openPicker(page2, /footer-model-picker-advanced/);
314
+ await expect(picker).toHaveAttribute("aria-describedby", "footerModelPickerHelp");
315
+ await expect(picker.locator("#footerModelPickerHelp")).toContainText("Drag within provider");
316
+ await expect(picker.locator("#footerModelPickerHelp")).toContainText("Alt+Up/Down reorders");
317
+ await expect(picker.locator("#footerModelPickerHelp")).toContainText("Home/End");
318
+ await expect(picker.locator("#footerModelPickerHelp")).toContainText("Enter/Space");
319
+ const helpGeometry = await picker.evaluate((node) => {
320
+ const style = getComputedStyle(node);
321
+ const helpRect = node.querySelector("#footerModelPickerHelp").getBoundingClientRect();
322
+ return {
323
+ helpWidth: helpRect.width,
324
+ contentWidth: node.clientWidth - parseFloat(style.paddingLeft) - parseFloat(style.paddingRight),
325
+ };
326
+ });
327
+ assert.ok(Math.abs(helpGeometry.helpWidth - helpGeometry.contentWidth) <= 1, `advanced keybinding help should span the picker content width: ${JSON.stringify(helpGeometry)}`);
328
+ const columns = picker.locator(".footer-model-provider-column");
329
+ await expect(columns).toHaveCount(3);
330
+ assert.deepEqual(
331
+ await columns.locator(".footer-model-provider-title").allTextContents(),
332
+ ["alpha", "beta", "zeta"],
333
+ "provider columns should be alphabetically ordered",
334
+ );
335
+ assert.deepEqual(
336
+ await columns.evaluateAll((items) => items.map((column) => [...column.querySelectorAll(".footer-model-option")].map((option) => option.dataset.footerModelKey))),
337
+ [["alpha/a-one", "alpha/a-two", "alpha/a-three"], ["beta/b-one"], ["zeta/z-one", "zeta/z-two"]],
338
+ "each provider should preserve scoped/cycling order",
339
+ );
340
+
341
+ // Pointer dragging changes order only inside the source provider. The
342
+ // stored flat order keeps every other provider in its original slots.
343
+ const dragLayoutStyle = await page2.addStyleTag({ content: ".footer-model-picker-advanced { width: 47rem !important; } .footer-model-provider-columns { max-width: 45rem !important; max-height: 14rem !important; }" });
344
+ const alphaTwoForDrag = picker.locator('[data-footer-model-key="alpha/a-two"]');
345
+ const alphaOneForDrag = picker.locator('[data-footer-model-key="alpha/a-one"]');
346
+ const betaOneForDrag = picker.locator('[data-footer-model-key="beta/b-one"]');
347
+ await dragModelOption(page2, alphaTwoForDrag, alphaOneForDrag);
348
+ await expect(alphaTwoForDrag).toBeFocused();
349
+ assert.deepEqual(
350
+ await columns.nth(0).locator(".footer-model-option").evaluateAll((items) => items.map((option) => option.dataset.footerModelKey)),
351
+ ["alpha/a-two", "alpha/a-one", "alpha/a-three"],
352
+ "same-provider pointer drag should reorder the advanced column",
353
+ );
354
+ const providerLocalGlobalOrder = ["zeta/z-one", "alpha/a-two", "beta/b-one", "alpha/a-one", "zeta/z-two", "alpha/a-three"];
355
+ await expect.poll(() => page2.evaluate((key) => JSON.parse(localStorage.getItem(key) || "[]"), orderKey)).toEqual(providerLocalGlobalOrder);
356
+
357
+ await dragModelOption(page2, alphaTwoForDrag, betaOneForDrag);
358
+ assert.deepEqual(
359
+ await columns.evaluateAll((items) => items.map((column) => [...column.querySelectorAll(".footer-model-option")].map((option) => option.dataset.footerModelKey))),
360
+ [["alpha/a-two", "alpha/a-one", "alpha/a-three"], ["beta/b-one"], ["zeta/z-one", "zeta/z-two"]],
361
+ "dragging toward another provider should not move either model",
362
+ );
363
+ await expect.poll(() => page2.evaluate((key) => JSON.parse(localStorage.getItem(key) || "[]"), orderKey)).toEqual(providerLocalGlobalOrder);
364
+
365
+ await alphaTwoForDrag.focus();
366
+ await expect(alphaTwoForDrag).toBeFocused();
367
+ await page2.keyboard.press("Alt+ArrowDown");
368
+ await expect.poll(() => page2.evaluate((key) => JSON.parse(localStorage.getItem(key) || "[]"), orderKey)).toEqual(scopedModels.map((model) => `${model.provider}/${model.id}`));
369
+ await expect.poll(
370
+ () => columns.nth(0).locator(".footer-model-option").evaluateAll((items) => items.map((option) => option.dataset.footerModelKey)),
371
+ { message: "Alt+Down should reorder only within the focused provider and restore the original order" },
372
+ ).toEqual(["alpha/a-one", "alpha/a-two", "alpha/a-three"]);
373
+ assert.deepEqual(page2ModelCalls, [], "reordering should not apply a model");
374
+ await dragLayoutStyle.evaluate((node) => node.remove());
375
+
376
+ // Reordering retains focus on the moved model. Resume the existing
377
+ // provider-navigation checks from zeta's first model.
378
+ await expect(alphaTwoForDrag).toBeFocused();
379
+ await page2.keyboard.press("ArrowRight");
380
+ await page2.keyboard.press("ArrowRight");
381
+ const zetaOne = picker.locator('[data-footer-model-key="zeta/z-one"]');
382
+ await expect(zetaOne).toBeFocused();
383
+ const zetaGeometry = await zetaOne.evaluate((option) => {
384
+ const optionRect = option.getBoundingClientRect();
385
+ const scrollRect = option.closest(".footer-model-provider-columns").getBoundingClientRect();
386
+ return { optionLeft: optionRect.left, optionRight: optionRect.right, scrollLeft: scrollRect.left, scrollRight: scrollRect.right };
387
+ });
388
+ assert.ok(zetaGeometry.optionLeft >= zetaGeometry.scrollLeft && zetaGeometry.optionRight <= zetaGeometry.scrollRight, `initial focus should reveal its provider: ${JSON.stringify(zetaGeometry)}`);
389
+ await page2.keyboard.press("ArrowRight");
390
+ await expect(zetaOne).toBeFocused();
391
+ await page2.keyboard.press("ArrowLeft");
392
+ await expect(picker.locator('[data-footer-model-key="beta/b-one"]')).toBeFocused();
393
+ await page2.keyboard.press("ArrowLeft");
394
+ const alphaOne = picker.locator('[data-footer-model-key="alpha/a-one"]');
395
+ await expect(alphaOne).toBeFocused();
396
+ await page2.keyboard.press("ArrowLeft");
397
+ await expect(alphaOne).toBeFocused();
398
+ await page2.keyboard.press("End");
399
+ const alphaThree = picker.locator('[data-footer-model-key="alpha/a-three"]');
400
+ await expect(alphaThree).toBeFocused();
401
+ const alphaGeometry = await alphaThree.evaluate((option) => {
402
+ const optionRect = option.getBoundingClientRect();
403
+ const scrollRect = option.closest(".footer-model-provider-columns").getBoundingClientRect();
404
+ return { optionTop: optionRect.top, optionBottom: optionRect.bottom, scrollTop: scrollRect.top, scrollBottom: scrollRect.bottom };
405
+ });
406
+ assert.ok(alphaGeometry.optionTop >= alphaGeometry.scrollTop && alphaGeometry.optionBottom <= alphaGeometry.scrollBottom, `model navigation should reveal its row: ${JSON.stringify(alphaGeometry)}`);
407
+
408
+ // A model-order storage event forces a footer rebuild. Focus and the single
409
+ // roving tabindex must stay on the same non-initial option.
410
+ await page.evaluate(({ key, order }) => localStorage.setItem(key, JSON.stringify(order)), {
411
+ key: orderKey,
412
+ order: scopedModels.map((model) => `${model.provider}/${model.id}`),
413
+ });
414
+ await expect(alphaThree).toBeFocused();
415
+ await expect(alphaThree).toHaveAttribute("tabindex", "0");
416
+ await expect(picker.locator('.footer-model-option[tabindex="0"]')).toHaveCount(1);
417
+ await page2.keyboard.press("Home");
418
+ await expect(alphaOne).toBeFocused();
419
+ await page2.keyboard.press("End");
420
+ await expect(alphaThree).toBeFocused();
421
+ await page2.keyboard.press("ArrowRight");
422
+ await expect(picker.locator('[data-footer-model-key="beta/b-one"]')).toBeFocused();
423
+ await page2.keyboard.press("ArrowRight");
424
+ await expect(zetaOne).toBeFocused();
425
+ assert.deepEqual(page2ModelCalls, [], "arrow navigation should not apply a model");
426
+
427
+ await page2.keyboard.press("ArrowDown");
428
+ const zetaTwo = picker.locator('[data-footer-model-key="zeta/z-two"]');
429
+ await expect(zetaTwo).toBeFocused();
430
+ await page2.keyboard.press("Enter");
431
+ await expect(picker).toBeHidden();
432
+ await page2.keyboard.press("Enter");
433
+ await expect.poll(() => page2ModelCalls).toEqual([{ provider: "zeta", modelId: "z-two" }]);
434
+ await expect(page2.locator(".footer-model .footer-meta-value")).toContainText("z-two");
435
+
436
+ // Reopening focuses the now-active scoped model. Space applies once through
437
+ // the same guarded path.
438
+ const activePicker = await openPicker(page2, /footer-model-picker-advanced/);
439
+ await expect(activePicker.locator('[data-footer-model-key="zeta/z-two"]')).toBeFocused();
440
+ await page2.keyboard.press("Home");
441
+ await expect(activePicker.locator('[data-footer-model-key="zeta/z-one"]')).toBeFocused();
442
+ await page2.keyboard.press(" ");
443
+ await expect(activePicker).toBeHidden();
444
+ await expect.poll(() => page2ModelCalls).toEqual([
445
+ { provider: "zeta", modelId: "z-two" },
446
+ { provider: "zeta", modelId: "z-one" },
447
+ ]);
448
+
449
+ // Escape closes without applying and restores focus to the Model box.
450
+ await openPicker(page2, /footer-model-picker-advanced/);
451
+ await page2.keyboard.press("Escape");
452
+ await expect(page2.locator(".footer-model-picker")).toBeHidden();
453
+ await expect(page2.locator(".footer-model.footer-meta-action")).toBeFocused();
454
+ assert.deepEqual(page2ModelCalls, [
455
+ { provider: "zeta", modelId: "z-two" },
456
+ { provider: "zeta", modelId: "z-one" },
457
+ ]);
458
+
459
+ // Return to flat mode and retain its provider-qualified labels, pointer
460
+ // apply, and Alt+Arrow reorder contract.
461
+ const flatMenu = await openModelMenu(page2);
462
+ await expect(flatMenu.toggle).toHaveAttribute("aria-checked", "true");
463
+ await expect(flatMenu.toggle).toHaveText("Toggle Simple");
464
+ await flatMenu.toggle.click();
465
+ await expect.poll(() => page2.evaluate((key) => localStorage.getItem(key), layoutKey)).toBe("flat");
466
+ await expect.poll(() => page.evaluate((key) => localStorage.getItem(key), layoutKey)).toBe("flat");
467
+ const flatPicker = await openPicker(page2);
468
+ await expect(flatPicker).not.toHaveClass(/footer-model-picker-advanced/);
469
+ await expect(flatPicker.locator(".footer-model-provider-column")).toHaveCount(0);
470
+ await expect(flatPicker.locator('[data-footer-model-key="alpha/a-two"] .footer-model-option-main')).toHaveText("alpha/a-two");
471
+ const firstFlat = flatPicker.locator('[data-footer-model-key="zeta/z-one"]');
472
+ await firstFlat.focus();
473
+ await page2.keyboard.press("Alt+ArrowDown");
474
+ await expect.poll(() => page2.evaluate((key) => JSON.parse(localStorage.getItem(key) || "[]"), orderKey)).toEqual([
475
+ "alpha/a-one", "zeta/z-one", "beta/b-one", "alpha/a-two", "zeta/z-two", "alpha/a-three",
476
+ ]);
477
+ await flatPicker.locator('[data-footer-model-key="alpha/a-two"]').click();
478
+ await expect.poll(() => page2ModelCalls).toEqual([
479
+ { provider: "zeta", modelId: "z-two" },
480
+ { provider: "zeta", modelId: "z-one" },
481
+ { provider: "alpha", modelId: "a-two" },
482
+ ]);
483
+
484
+ // Narrow presentation stacks columns and remains inside the viewport.
485
+ const advancedMenu = await openModelMenu(page2);
486
+ await expect(advancedMenu.toggle).toHaveText("Toggle advanced");
487
+ await advancedMenu.toggle.click();
488
+ const narrowPicker = await openPicker(page2, /footer-model-picker-advanced/);
489
+ await page2.setViewportSize({ width: 390, height: 844 });
490
+ const geometry = await narrowPicker.evaluate((node) => {
491
+ const rect = node.getBoundingClientRect();
492
+ const columnsNode = node.querySelector(".footer-model-provider-columns");
493
+ return {
494
+ left: rect.left,
495
+ right: rect.right,
496
+ viewportWidth: window.innerWidth,
497
+ documentWidth: document.documentElement.scrollWidth,
498
+ clientWidth: document.documentElement.clientWidth,
499
+ gridAutoFlow: getComputedStyle(columnsNode).gridAutoFlow,
500
+ overflowX: getComputedStyle(columnsNode).overflowX,
501
+ };
502
+ });
503
+ assert.ok(geometry.left >= 0 && geometry.right <= geometry.viewportWidth, `picker should remain inside the narrow viewport: ${JSON.stringify(geometry)}`);
504
+ assert.equal(geometry.documentWidth, geometry.clientWidth, "advanced columns should not cause page-level horizontal overflow");
505
+ assert.equal(geometry.gridAutoFlow, "row");
506
+ assert.equal(geometry.overflowX, "hidden");
507
+ await expect(narrowPicker.locator(".footer-model-provider-title")).toHaveCount(3);
508
+ assert.deepEqual(page1ModelCalls, [], "the synchronization tab should not receive model changes");
509
+ } finally {
510
+ await page2.close();
511
+ }
512
+ });